first commit

Author: Forence1999

.dockerignore

@@ -0,0 +1,88 @@
+# Git
+.git
+.gitignore
+.gitattributes
+
+# Python
+__pycache__
+*.py[cod]
+*$py.class
+*.so
+.Python
+*.egg
+*.egg-info
+dist
+build
+eggs
+.eggs
+lib
+lib64
+parts
+sdist
+var
+wheels
+pip-wheel-metadata
+share/python-wheels
+*.manifest
+*.spec
+
+# Virtual environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Testing and Coverage
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.hypothesis/
+coverage/
+*.cover
+.cache
+
+# Linting
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.ruff_cache/
+
+# Documentation
+docs/_build/
+site/
+
+# CI/CD
+.github/
+
+# Local development
+*.log
+logs/
+.env.local
+.env.*.local
+
+# Project specific
+temp/
+tmp/
+*.bak
+*.swp
+
+# Keep these files for Docker build
+!pyproject.toml
+!uv.lock
+!src/
+!tests/
+!README.md
+!LICENSE

.editorconfig

@@ -0,0 +1,36 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+# Unix-style newlines with a newline ending every file
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = tab
+indent_size = 4
+
+# JSON files use tab indentation
+[*.json]
+indent_style = tab
+indent_size = 4
+
+# YAML files use tab indentation
+[*.{yml,yaml}]
+indent_style = tab
+indent_size = 4
+
+# Matches multiple files with brace expansion notation
+[*.{vue,js,ts,mjs,mts}]
+indent_style = tab
+indent_size = 4
+
+# Markdown files
+[*.md]
+trim_trailing_whitespace = false
+
+# Makefile requires tabs
+[Makefile]
+indent_style = tab

.env.example

@@ -0,0 +1,17 @@
+# py_template Environment Variables Example
+# Copy this file to .env and fill in your actual values
+
+# Application Configuration
+APP_NAME=py_template
+ENVIRONMENT=development  # development, staging, production
+DEBUG=true
+LOG_LEVEL=INFO  # DEBUG, INFO, WARNING, ERROR, CRITICAL
+
+# Python Configuration
+PYTHONPATH=src
+
+# Add your custom environment variables below
+# Example:
+# API_KEY=your-api-key-here
+# DATABASE_URL=postgresql://user:password@localhost:5432/dbname
+# REDIS_URL=redis://localhost:6379/0

.github/workflows/ci.yml

@@ -0,0 +1,43 @@
+name: Continuous Integration
+
+on:
+    push:
+        branches: [main, dev]
+    pull_request:
+        branches: [main, dev]
+
+jobs:
+    test:
+        runs-on: ubuntu-latest
+        strategy:
+            matrix:
+                python-version: ['3.12']
+
+        steps:
+            - name: Checkout code
+              uses: actions/checkout@v4
+
+            - name: Install uv
+              uses: astral-sh/setup-uv@v2
+
+            - name: Set up Python
+              run: uv python install ${{ matrix.python-version }}
+
+            - name: Install dependencies
+              run: uv sync --extra dev
+
+            - name: Run ruff linting
+              run: uv run ruff check
+
+            - name: Run ruff formatting check
+              run: uv run ruff format --check
+
+            - name: Run tests
+              run: uv run pytest --cov=src --cov-report=xml --cov-report=term
+
+            - name: Upload coverage to Codecov
+              uses: codecov/codecov-action@v4
+              if: matrix.python-version == '3.12'
+              with:
+                  files: ./coverage.xml
+                  fail_ci_if_error: false

.github/workflows/code-quality.yml

@@ -0,0 +1,26 @@
+name: Code Quality
+
+on:
+    push:
+        branches: [main, dev]
+    pull_request:
+        branches: [main, dev]
+
+jobs:
+    code-quality:
+        runs-on: ubuntu-latest
+        steps:
+            - name: Checkout code
+              uses: actions/checkout@v4
+
+            - name: Run Ruff linting
+              uses: astral-sh/ruff-action@v3
+              with:
+                  version: "0.13.2"
+                  args: "check --output-format=github"
+
+            - name: Run Ruff formatting check
+              uses: astral-sh/ruff-action@v3
+              with:
+                  version: "0.13.2"
+                  args: "format --check --diff"