Merge upstream/master into feature/set-retry-status

Made-with: Cursor

Author: aravindhbalaji04

.code_quality/.flake8

@@ -0,0 +1,18 @@
+[flake8]
+extend-ignore = E203
+exclude =
+    .git,
+    __pycache__,
+    docs,
+    old,
+    build,
+    dist,
+    ./venv,
+    .venv,
+    migrations,
+    alembic
+max-complexity = 12
+show-source = True
+statistics = True
+count = True
+max-line-length = 79

.code_quality/.gitkeep

@@ -0,0 +1,22 @@
+[tool.black]
+line-length = 79
+target-version = ['py312']
+include = '\.pyi?$'
+extend-exclude = '''
+/(
+  # directories
+  \.eggs
+  | \.git
+  | \.hg
+  | \.mypy_cache
+  | \.tox
+  | \.venv
+  | venv
+  | _build
+  | buck-out
+  | build
+  | dist
+  | migrations
+  | alembic
+)/
+'''

.code_quality/black.toml

@@ -0,0 +1,21 @@
+[isort]
+profile = black
+line_length = 79
+multi_line_output = 3
+include_trailing_comma = True
+force_grid_wrap = 0
+use_parentheses = True
+ensure_newline_before_comments = True
+skip_gitignore = True
+
+known_first_party = app
+
+sections = FUTURE,STDLIB,THIRDPARTY,FIRSTPARTY,LOCALFOLDER
+
+skip_glob =
+    */migrations/*
+    */alembic/*
+    */build/*
+    */dist/*
+    */.venv/*
+    */venv/*

.code_quality/isort.cfg

@@ -0,0 +1,27 @@
+[mypy]
+python_version = 3.12
+
+warn_return_any = True
+warn_unused_configs = True
+disallow_untyped_defs = False
+disallow_incomplete_defs = False
+check_untyped_defs = True
+disallow_untyped_decorators = False
+no_implicit_optional = True
+warn_redundant_casts = True
+warn_unused_ignores = True
+warn_no_return = True
+warn_unreachable = True
+strict_equality = True
+show_error_codes = True
+
+exclude = build/,dist/,venv/,.venv/,migrations/,alembic/
+
+[mypy-mkdocs.*]
+ignore_missing_imports = True
+
+[mypy-mkdocs_simple_blog.*]
+disallow_untyped_defs = False
+
+[mypy-tests.*]
+disallow_untyped_defs = False

.code_quality/mypy.ini

@@ -0,0 +1,63 @@
+# Ruff configuration
+# Modern and fast Python linter
+
+# Line length
+line-length = 79
+
+# Target Python version
+target-version = "py312"
+
+# Exclude patterns
+exclude = [
+    ".git",
+    "__pycache__",
+    ".venv",
+    "venv",
+    "build",
+    "dist",
+    "migrations",
+    "alembic",
+    "*.egg-info",
+]
+
+# Lint configuration
+[lint]
+# Enable specific rule sets
+select = [
+    "E",   # pycodestyle errors
+    "W",   # pycodestyle warnings
+    "F",   # pyflakes
+    "I",   # isort
+    "B",   # flake8-bugbear
+    "C4",  # flake8-comprehensions
+    "UP",  # pyupgrade
+    "ARG", # flake8-unused-arguments
+    "SIM", # flake8-simplify
+]
+
+# Ignore specific rules
+ignore = [
+    "E501",   # Line too long (handled by formatter)
+    "B008",   # Do not perform function calls in argument defaults
+    "E203",   # Whitespace before ':' (flake8 compatibility - handled separately)
+    "B027",   # Empty method in ABC without abstractmethod (intentional in base providers)
+    "ARG001", # Unused function argument (intentional in interface implementations)
+    "ARG002", # Unused method argument (intentional in *args/**kwargs constructors and providers)
+    "UP007",  # Use X | Y for unions — incompatible with Pydantic v2 on Python 3.9
+]
+
+# Allowed configurations for specific rules
+[lint.per-file-ignores]
+"__init__.py" = ["F401"]  # Allow unused imports in __init__.py
+"tests/**" = ["ARG001", "S101"]  # Allow unused arguments and assert in tests
+
+# Import sorting (isort)
+[lint.isort]
+known-first-party = ["dotflow"]
+force-single-line = false
+
+# Formatting (alternative to black)
+[format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false

.code_quality/ruff.toml

@@ -0,0 +1,26 @@
+name: Build Package
+description: Build Python package using build
+
+inputs:
+  python-version:
+    description: Python version to use
+    required: true
+    default: "3.10"
+
+runs:
+  using: composite
+  steps:
+    - name: 🐍 Set up Python ${{ inputs.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ inputs.python-version }}
+
+    - name: ⚙️ Install dependencies
+      shell: bash
+      run: |
+        python -m pip install --upgrade pip
+        pip install build --no-cache-dir
+
+    - name: 📦 Build Package
+      shell: bash
+      run: python -m build

.github/actions/build-package/action.yml

@@ -0,0 +1,42 @@
+name: Commit and Push
+description: Commit and push changes to repository
+
+inputs:
+  message:
+    description: Commit message
+    required: true
+  files:
+    description: Files to commit (space-separated)
+    required: true
+  branch:
+    description: Branch to push to
+    required: false
+    default: ""
+
+runs:
+  using: composite
+  steps:
+    - name: 💾 Commit and push changes
+      shell: bash
+      run: |
+        git config --local user.email "action@github.com"
+        git config --local user.name "GitHub Action"
+        git add ${{ inputs.files }}
+
+        if git diff --staged --quiet; then
+          echo "No changes to commit"
+          exit 0
+        fi
+
+        git commit -m "${{ inputs.message }}"
+
+        if [ -z "${{ inputs.branch }}" ]; then
+          git push
+        else
+          CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)
+          if [ "$CURRENT_BRANCH" = "${{ inputs.branch }}" ]; then
+            git push origin "$CURRENT_BRANCH"
+          else
+            git push origin HEAD:${{ inputs.branch }}
+          fi
+        fi

.github/actions/commit-push/action.yml

@@ -0,0 +1,24 @@
+name: Extract Version
+description: Extract version from release tag
+
+inputs:
+  tag:
+    description: Release tag name
+    required: true
+
+outputs:
+  version:
+    description: Extracted version without 'v' prefix
+    value: ${{ steps.get_version.outputs.version }}
+
+runs:
+  using: composite
+  steps:
+    - name: 🔍 Extract version from tag
+      id: get_version
+      shell: bash
+      run: |
+        VERSION="${{ inputs.tag }}"
+        VERSION="${VERSION#v}"
+        echo "version=$VERSION" >> $GITHUB_OUTPUT
+        echo "Extracted version: $VERSION"

.github/actions/extract-version/action.yml

@@ -0,0 +1,52 @@
+name: Setup Poetry
+description: Setup Poetry with caching
+
+inputs:
+  python-version:
+    description: Python version to use
+    required: true
+  poetry-version:
+    description: Poetry version to install
+    required: false
+    default: 1.8.3
+  install-deps:
+    description: Dependencies groups to install (e.g., dev,code-quality)
+    required: false
+    default: ""
+
+runs:
+  using: composite
+  steps:
+    - name: 🐍 Set up Python ${{ inputs.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ inputs.python-version }}
+        allow-prereleases: true
+
+    - name: 📦 Install Poetry
+      uses: snok/install-poetry@v1
+      with:
+        version: ${{ inputs.poetry-version }}
+        virtualenvs-create: true
+        virtualenvs-in-project: true
+
+    - name: 💾 Cache Poetry dependencies
+      uses: actions/cache@v4
+      with:
+        path: |
+          .venv
+          ~/.cache/pypoetry
+        key: ${{ runner.os }}-poetry-${{ hashFiles('**/poetry.lock') }}
+        restore-keys: |
+          ${{ runner.os }}-poetry-
+
+    - name: 🔒 Update lock file if needed
+      shell: bash
+      run: |
+        poetry lock --no-update 2>/dev/null || poetry lock
+
+    - name: ⚙️ Install dependencies
+      if: inputs.install-deps != ''
+      shell: bash
+      run: |
+        poetry install --with ${{ inputs.install-deps }} --no-interaction --no-ansi