Initial commit: TSignal - Python Signal/Slot Implementation

A Python implementation of the signal-slot pattern inspired by Qt,
featuring:
- Easy-to-use signal-slot mechanism with decorators
- Support for both synchronous and asynchronous slots
- Thread-safe signal emissions
- Automatic connection type detection
- Comprehensive test suite
- Full documentation

Project structure:
- src/tsignal: Core implementation
- tests: Unit and integration tests
- examples: Usage examples
- docs: Detailed documentation

Documentation includes:
- API reference
- Usage guide
- Example patterns
- Testing guide
- Logging guidelines
- Contributing guide

Author: san-tekart

.gitattribuites

@@ -0,0 +1,26 @@
+# Auto detect text files and perform LF normalization
+* text=auto
+
+# Python files
+*.py text diff=python eol=lf
+*.pyi text diff=python eol=lf
+
+# Documentation
+*.md text eol=lf
+*.rst text eol=lf
+docs/* text eol=lf
+
+# Scripts
+*.sh text eol=lf
+*.bat text eol=crlf
+*.cmd text eol=crlf
+*.ps1 text eol=crlf
+
+# Configuration
+*.yml text eol=lf
+*.yaml text eol=lf
+*.json text eol=lf
+*.toml text eol=lf
+.gitattributes text eol=lf
+.gitignore text eol=lf
+requirements.txt text eol=lf

.github/workflows/tests.yml

@@ -0,0 +1,32 @@
+name: Tests
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12']
+
+    steps:
+    - uses: actions/checkout@v2
+    
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v2
+      with:
+        python-version: ${{ matrix.python-version }}
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        python -m pip install pytest pytest-cov pytest-asyncio
+        pip install -e ".[dev]"
+    
+    - name: Run tests
+      run: |
+        pytest --cov=tsignal

.gitignore

@@ -0,0 +1,50 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+
+# Distribution / packaging
+dist/
+build/
+*.egg-info/
+*.egg
+
+# Virtual environments
+venv/
+env/
+.env/
+.venv/
+ENV/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# IDE settings
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Logs
+*.log
+
+# Environment variables
+.env
+.env.local
+
+# macOS
+.DS_Store
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# mypy
+.mypy_cache/
+
+# Documentation builds
+docs/_build/

CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2024-01-26
+
+### Added
+- Initial release
+- Basic signal-slot mechanism with decorators
+- Support for both synchronous and asynchronous slots
+- Thread-safe signal emissions
+- Automatic connection type detection
+- Comprehensive test suite
+- Full documentation

CONTRIBUTING.md

@@ -0,0 +1,125 @@
+# Contributing to TSignal
+
+Thank you for your interest in contributing to TSignal! This document provides guidelines and instructions for contributing to the project.
+
+## Development Setup
+
+1. Fork and clone the repository:
+```bash
+git clone https://github.com/TSignalDev/tsignal-python.git
+cd tsignal-python
+```
+
+2. Create a virtual environment and install development dependencies:
+```bash
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+pip install -e ".[dev]"
+```
+
+## Code Style
+
+We follow these coding conventions:
+- PEP 8 style guide
+- Maximum line length of 88 characters (Black default)
+- Type hints for function arguments and return values
+- Docstrings for all public modules, functions, classes, and methods
+
+## Testing
+
+Run the test suite before submitting changes:
+```bash
+# Run all tests
+pytest
+
+# Run with coverage
+pytest --cov=tsignal
+
+# Run specific test file
+pytest tests/unit/test_signal.py
+
+# Enable debug logging during tests
+TSIGNAL_DEBUG=1 pytest
+```
+
+## Pull Request Process
+
+1. Create a new branch for your feature or bugfix:
+```bash
+git checkout -b feature-name
+```
+
+2. Make your changes and commit them:
+```bash
+git add .
+git commit -m "Description of changes"
+```
+
+3. Ensure your changes include:
+   - Tests for any new functionality
+   - Documentation updates if needed
+   - No unnecessary debug prints or commented code
+   - Type hints for new functions/methods
+
+4. Push your changes and create a pull request:
+```bash
+git push origin feature-name
+```
+
+5. In your pull request description:
+   - Describe what the changes do
+   - Reference any related issues
+   - Note any breaking changes
+   - Include examples if applicable
+
+## Development Guidelines
+
+### Adding New Features
+
+1. Start with tests
+2. Implement the feature
+3. Update documentation
+4. Add examples if applicable
+
+### Debug Logging
+
+Use appropriate log levels:
+```python
+import logging
+
+logger = logging.getLogger(__name__)
+
+# Debug information
+logger.debug("Detailed connection info")
+
+# Important state changes
+logger.info("Signal connected successfully")
+
+# Warning conditions
+logger.warning("Multiple connections detected")
+
+# Errors
+logger.error("Failed to emit signal", exc_info=True)
+```
+
+## Code of Conduct
+
+### Our Standards
+
+- Be respectful and inclusive
+- Focus on constructive criticism
+- Accept feedback gracefully
+- Put the project's best interests first
+
+### Enforcement
+
+Violations of the code of conduct may result in:
+1. Warning
+2. Temporary ban
+3. Permanent ban
+
+Report issues to project maintainers via email.
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the same license as the project (MIT License).

LICENCSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 San Kim
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.