azure-functions-db 0.1.0__tar.gz

azure_functions_db-0.1.0/.editorconfig

@@ -0,0 +1,12 @@
+# This file sets code formatting rules that are respected by many editors and IDEs
+# It helps maintain consistent coding style across different environments
+
+root = true
+
+[*]
+charset = utf-8                  # Use UTF-8 encoding for all files
+end_of_line = lf                 # Use LF (Unix-style) line endings
+indent_style = space            # Use spaces instead of tabs
+indent_size = 4                 # Indent with 4 spaces
+trim_trailing_whitespace = true # Remove any whitespace characters at the end of lines
+insert_final_newline = true     # Ensure every file ends with a newline

azure_functions_db-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,69 @@
+name: Bug Report
+description: Report a bug or unexpected behavior
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug!
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: A clear description of the bug
+      placeholder: What happened? What did you expect to happen?
+    validations:
+      required: true
+
+  - type: textarea
+    id: current-state
+    attributes:
+      label: Current State
+      description: Describe the current behavior and any relevant context
+      placeholder: |
+        - What is happening now?
+        - Any error messages or logs?
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps-to-reproduce
+    attributes:
+      label: Steps to Reproduce
+      description: How can we reproduce this issue?
+      placeholder: |
+        1. Install package...
+        2. Run command...
+        3. See error...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected-outcome
+    attributes:
+      label: Expected Outcome
+      description: What should happen instead?
+    validations:
+      required: true
+
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: Your environment details
+      placeholder: |
+        - Python version:
+        - Package version:
+        - OS:
+    validations:
+      required: false
+
+  - type: textarea
+    id: references
+    attributes:
+      label: References
+      description: Any related files, links, or resources
+    validations:
+      required: false

azure_functions_db-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Security Advisories
+    url: https://github.com/yeongseon/azure-functions-dbtrigger/security/advisories/new
+    about: Report security issues privately via GitHub Security Advisories

azure_functions_db-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,65 @@
+name: Feature Request
+description: Suggest a new feature or enhancement
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a feature!
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What problem does this feature solve?
+      placeholder: Describe the problem or limitation you're facing
+    validations:
+      required: true
+
+  - type: textarea
+    id: current-state
+    attributes:
+      label: Current State
+      description: How does the project currently handle this (if at all)?
+      placeholder: |
+        - Current behavior
+        - Current limitations
+    validations:
+      required: false
+
+  - type: textarea
+    id: proposed-solution
+    attributes:
+      label: Proposed Solution
+      description: How would you like this to work?
+      placeholder: Describe your ideal solution
+    validations:
+      required: true
+
+  - type: textarea
+    id: tasks
+    attributes:
+      label: Tasks
+      description: Break down the implementation into tasks (if known)
+      placeholder: |
+        - [ ] Task 1
+        - [ ] Task 2
+    validations:
+      required: false
+
+  - type: textarea
+    id: expected-outcome
+    attributes:
+      label: Expected Outcome
+      description: What should be the end result?
+    validations:
+      required: true
+
+  - type: textarea
+    id: references
+    attributes:
+      label: References
+      description: Any related files, links, documentation, or examples
+    validations:
+      required: false

azure_functions_db-0.1.0/.github/ISSUE_TEMPLATE/task.yml

@@ -0,0 +1,56 @@
+name: Task
+description: A general task or chore (refactoring, maintenance, etc.)
+title: "[Task]: "
+labels: ["chore"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Use this template for maintenance tasks, refactoring, or other chores.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: Why is this task needed?
+      placeholder: Describe the motivation for this task
+    validations:
+      required: true
+
+  - type: textarea
+    id: current-state
+    attributes:
+      label: Current State
+      description: What is the current situation?
+      placeholder: |
+        - Current code/config state
+        - Any issues or limitations
+    validations:
+      required: true
+
+  - type: textarea
+    id: tasks
+    attributes:
+      label: Tasks
+      description: Break down the work into actionable items
+      placeholder: |
+        - [ ] Task 1
+        - [ ] Task 2
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected-outcome
+    attributes:
+      label: Expected Outcome
+      description: What should be the result when this is complete?
+    validations:
+      required: true
+
+  - type: textarea
+    id: references
+    attributes:
+      label: References
+      description: Any related files, documentation, or resources
+    validations:
+      required: false

azure_functions_db-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,33 @@
+## Summary
+
+<!-- Brief description of changes -->
+
+## Changes
+
+<!-- List the specific changes made -->
+
+-
+
+## Type of Change
+
+<!-- Check the relevant option -->
+
+- [ ] Bug fix (non-breaking change that fixes an issue)
+- [ ] New feature (non-breaking change that adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to change)
+- [ ] Documentation update
+- [ ] Refactoring (no functional changes)
+- [ ] Chore (maintenance, dependencies, CI, etc.)
+
+## Checklist
+
+- [ ] My code follows the project's code style
+- [ ] I have run `make check` (lint + typecheck)
+- [ ] I have run `make test` and all tests pass
+- [ ] I have added tests for new functionality (if applicable)
+- [ ] I have updated documentation (if applicable)
+- [ ] My changes do not introduce new warnings
+
+## Related Issues
+
+<!-- Link to related issues: Closes #123, Fixes #456 -->

azure_functions_db-0.1.0/.github/dependabot.yml

@@ -0,0 +1,22 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    commit-message:
+      prefix: "chore(deps)"
+    labels:
+      - "dependencies"
+    open-pull-requests-limit: 10
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    commit-message:
+      prefix: "chore(deps)"
+    labels:
+      - "dependencies"
+      - "github-actions"
+    open-pull-requests-limit: 10

azure_functions_db-0.1.0/.github/labels.yml

@@ -0,0 +1,47 @@
+- name: "dependencies"
+  color: "0075ca"
+  description: "Pull requests that update a dependency file"
+
+- name: "github-actions"
+  color: "e4e669"
+  description: "Pull requests that update GitHub Actions"
+
+- name: "bug"
+  color: "d73a4a"
+  description: "Something isn't working"
+
+- name: "enhancement"
+  color: "a2eeef"
+  description: "New feature or request"
+
+- name: "documentation"
+  color: "0075ca"
+  description: "Improvements or additions to documentation"
+
+- name: "question"
+  color: "d876e3"
+  description: "Further information is requested"
+
+- name: "good first issue"
+  color: "7057ff"
+  description: "Good for newcomers"
+
+- name: "help wanted"
+  color: "008672"
+  description: "Extra attention is needed"
+
+- name: "security"
+  color: "e11d48"
+  description: "Security-related issue or pull request"
+
+- name: "duplicate"
+  color: "cfd3d7"
+  description: "This issue or pull request already exists"
+
+- name: "wontfix"
+  color: "ffffff"
+  description: "This will not be worked on"
+
+- name: "invalid"
+  color: "e4e669"
+  description: "This doesn't seem right"

azure_functions_db-0.1.0/.github/workflows/ci-test.yml

@@ -0,0 +1,69 @@
+name: Test and Coverage
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+  push:
+    branches: [main, develop]
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install Hatch and dependencies via Makefile
+        run: |
+          pip install hatch
+          make install
+
+      - name: Run full quality checks
+        run: make check-all
+
+      - name: Verify coverage output
+        run: ls -lh coverage.xml
+
+      - name: Upload coverage to Codecov
+        if: matrix.python-version == '3.11' && github.actor != 'dependabot[bot]'
+        uses: codecov/codecov-action@1af58845a975a7985b0beb0cbe6fbbb71a41dbad
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: ./coverage.xml
+          verbose: true
+          fail_ci_if_error: false
+        env:
+          CODECOV_RETRIES: 3
+
+  benchmark:
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request' || github.ref == 'refs/heads/main'
+    continue-on-error: true
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+
+      - name: Set up Python 3.12
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: |
+          pip install hatch
+          pip install -e ".[all]"
+
+      - name: Run catch-up benchmark
+        run: python benchmarks/bench_catchup.py

azure_functions_db-0.1.0/.github/workflows/create-release.yml

@@ -0,0 +1,26 @@
+name: Create GitHub Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+jobs:
+  create-release:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@da05d552573ad5aba039eaac05058a918a7bf631 # v2
+        with:
+          tag_name: ${{ github.ref_name }}
+          name: ${{ github.ref_name }}
+          generate_release_notes: true
+          draft: false
+          prerelease: false

azure_functions_db-0.1.0/.github/workflows/docs.yml

@@ -0,0 +1,34 @@
+name: Deploy MkDocs to GitHub Pages
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
+
+      - name: Set up Python
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405
+        with:
+          python-version: "3.11"
+
+      - name: Install Hatch and docs dependencies
+        run: |
+          pip install hatch
+          make install
+
+      - name: Build docs (verify build before deploy)
+        run: hatch run mkdocs build --strict
+
+      - name: Deploy to GitHub Pages
+        run: hatch run mkdocs gh-deploy --force

azure_functions_db-0.1.0/.github/workflows/publish-pypi.yml

@@ -0,0 +1,56 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: Git tag to publish (for example v0.1.0)
+        required: true
+        type: string
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        with:
+          ref: ${{ github.event_name == 'workflow_dispatch' && inputs.tag || github.ref }}
+
+      - name: Set up Python
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6
+        with:
+          python-version: "3.12"
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build
+
+      - name: Check if tag matches __version__
+        run: |
+          TAG_NAME="${{ github.event_name == 'workflow_dispatch' && inputs.tag || github.ref_name }}"
+          VERSION_FROM_FILE=$(grep -Po '(?<=__version__ = ")[^"]*' src/azure_functions_db/__init__.py)
+          TAG_VERSION=${TAG_NAME#v}
+          echo "Version from file: $VERSION_FROM_FILE"
+          echo "Tag name: $TAG_NAME"
+          echo "Version from tag: $TAG_VERSION"
+          if [ "$VERSION_FROM_FILE" != "$TAG_VERSION" ]; then
+            echo "::error ::Version in __init__.py ($VERSION_FROM_FILE) does not match git tag ($TAG_VERSION)"
+            exit 1
+          fi
+
+      - name: Build distribution packages
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

azure_functions_db-0.1.0/.gitignore

@@ -0,0 +1,33 @@
+# Python
+__pycache__/
+*.py[cod]
+*.so
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Tool caches
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+coverage.xml
+htmlcov/
+
+# Build artifacts
+build/
+dist/
+*.egg-info/
+
+# IDE
+.vscode/
+.idea/
+
+# Docs
+site/
+
+# Review
+.venv-review/
+.venv-review-cli/

azure_functions_db-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,29 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.6
+    hooks:
+      - id: ruff-format
+      - id: ruff
+        args: ["--fix"]
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.19.1
+    hooks:
+      - id: mypy
+        language: python
+        files: "^src/"
+        pass_filenames: false
+        args:
+          [
+            "--config-file=pyproject.toml",
+            "--install-types",
+            "--non-interactive"
+          ]
+
+  - repo: https://github.com/PyCQA/bandit
+    rev: 1.9.4
+    hooks:
+      - id: bandit
+        args: ["-c", "pyproject.toml"]
+        additional_dependencies: ["bandit[toml]"]
+        files: "^src/"

azure_functions_db-0.1.0/AGENTS.md

@@ -0,0 +1,40 @@
+# AGENTS.md
+
+## Purpose
+`azure-functions-db` provides pseudo DB trigger functionality for Azure Functions Python v2 applications using SQLAlchemy.
+
+## Read First
+- `README.md`
+- `CONTRIBUTING.md`
+- `docs/02-architecture.md`
+- `docs/03-semantics.md`
+
+## Working Rules
+- Preserve the package's Python compatibility and public API behavior unless the change explicitly updates the contract.
+- Keep documentation, examples, and tests synchronized.
+- Semantics changes require ADR or design note.
+- Never suppress type errors.
+- Guarantee claims must be honest (pseudo trigger, at-least-once).
+
+## Validation
+- `make test`
+- `make lint`
+- `make typecheck`
+- `make build`
+
+## Release Process
+- Version is managed via `hatch` (dynamic from `src/azure_functions_db/__init__.py`).
+- **Do NOT manually edit version strings.** Use the Makefile targets below.
+- When bumping version, update `tests/test_public_api.py` to match the new version string.
+
+### Commands
+- `make release-patch` — bump patch version, update changelog, tag, and push
+- `make release-minor` — bump minor version, update changelog, tag, and push
+- `make release-major` — bump major version, update changelog, tag, and push
+- `make release VERSION=x.y.z` — set explicit version, update changelog, tag, and push
+- `make tag-release VERSION=x.y.z` — create and push an annotated tag (used internally by release targets)
+
+### Flow
+1. `make release-patch` (or `-minor` / `-major`) on `main`
+2. This runs: `hatch version` → `git commit` → `make changelog` → `git commit` → `git tag` → `git push`
+3. Tag push triggers **Publish to PyPI** GitHub Actions workflow automatically.

azure_functions_db-0.1.0/CHANGELOG.md

@@ -0,0 +1,42 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+### Bug Fixes
+
+- *(docs)* Replace relative parent links with GitHub URLs for strict mkdocs (#29) 
+- Add kw_only=True to RetryPolicy and create mkdocs.yml for docs workflow (#28) 
+
+### Documentation
+
+- Align documentation structure with sibling repos 
+- Update branding, reorder README, add lifecycle/thread-safety docs (#48) 
+
+### Features
+
+- Partial env var substitution, engine_kwargs passthrough (#49) 
+- Add OutputResult, async docs, decorator composition validation (#47) 
+- Pydantic model mapping, async proxy, cursor index warning (#32) 
+- *(decorator)* Redesign db_input/db_output to data injection bindings (#31) 
+- *(decorator)* Redesign API to DbFunctionApp with db_trigger, db_input, db_output (#30) 
+- *(binding)* Trigger+binding integration tests and example (Phase 11) 
+- *(binding)* Implement DbWriter output binding (Phase 10) (#26) 
+- *(binding)* Implement DbReader input binding (Phase 9) (#25) 
+- *(core)* Phase 8 — extract shared core (DbConfig, EngineProvider, serializers, types) (#24) 
+- *(hardening)* Phase 7 — crash recovery tests, benchmark, and duplicate docs (#23) 
+- *(observability)* Add MetricsCollector, structured logging, and lag calculation (#21) 
+- *(trigger)* Add PollTrigger, db.poll() decorator, and normalizers (#20) 
+- *(adapter)* Add SqlAlchemySource with cursor-based polling (#19) 
+- *(state)* Add BlobCheckpointStore with ETag-based CAS leasing (#18) 
+- Phase 1 - Core types, errors, trigger events, context, retry, and runner (#17) 
+- Initial project scaffold — unified DB integration framework for Azure Functions Python v2 
+
+### Miscellaneous Tasks
+
+- *(release)* Phase 6 release prep (#22) 
+- Translate docs to English and align README with series style (#16) 
+
+### Refactor
+
+- Rename DbFunctionApp to DbBindings, drop db_ method prefix, narrow exports (#46) 
+<!-- generated by git-cliff -->