azure-functions-langgraph 0.5.0__tar.gz

azure_functions_langgraph-0.5.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_langgraph-0.5.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_langgraph-0.5.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Documentation
+    url: https://yeongseon.github.io/azure-functions-langgraph/
+    about: Check our documentation for usage guides and examples

azure_functions_langgraph-0.5.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_langgraph-0.5.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_langgraph-0.5.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,41 @@
+## 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
+
+## Version Management
+
+- [ ] If adding new features, I have bumped the version in `src/azure_functions_langgraph/__init__.py`
+- [ ] I have updated `PRD.md` if product scope or goals changed
+- [ ] I have updated `CHANGELOG.md` with detailed changes
+
+**Note:** See `CONTRIBUTING.md` for version management guidelines.
+
+## Related Issues
+
+<!-- Link to related issues: Closes #123, Fixes #456 -->

azure_functions_langgraph-0.5.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_langgraph-0.5.0/.github/workflows/ci-test.yml

@@ -0,0 +1,48 @@
+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.10", "3.11", "3.12", "3.13", "3.14"]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6
+        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.10' && github.actor != 'dependabot[bot]'
+        uses: codecov/codecov-action@57e3a136b779b570ffcdbf80b3bdc90e7fab3de2 # v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: ./coverage.xml
+          verbose: true
+          fail_ci_if_error: false
+        env:
+          CODECOV_RETRIES: 3

azure_functions_langgraph-0.5.0/.github/workflows/codeql.yml

@@ -0,0 +1,33 @@
+name: CodeQL Security Analysis
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  schedule:
+    - cron: "0 0 * * 1"
+
+permissions:
+  contents: read
+  security-events: write
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@c10b8064de6f491fea524254123dbe5e09572f13 # v4
+        with:
+          languages: python
+          queries: security-extended
+
+      - name: Perform CodeQL Analysis
+        uses: github/codeql-action/analyze@c10b8064de6f491fea524254123dbe5e09572f13 # v4
+        with:
+          category: "/language:python"

azure_functions_langgraph-0.5.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 # v6
+
+      - name: Set up Python
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6
+        with:
+          python-version: "3.10"
+
+      - 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_langgraph-0.5.0/.github/workflows/maintenance.yml

@@ -0,0 +1,35 @@
+name: Maintenance Checks
+
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: "0 4 * * 1"
+
+permissions:
+  contents: read
+
+jobs:
+  maintenance:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+
+      - name: Set up Python
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6
+        with:
+          python-version: "3.12"
+
+      - name: Install Hatch and dependencies via Makefile
+        run: |
+          pip install hatch
+          make install
+
+      - name: Run lint and type checks
+        run: |
+          hatch run lint
+          hatch run typecheck
+
+      - name: Run security scan (Bandit)
+        run: make security

azure_functions_langgraph-0.5.0/.github/workflows/performance.yml

@@ -0,0 +1,35 @@
+name: Performance Tests
+
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: "0 3 * * 1"
+
+permissions:
+  contents: read
+
+jobs:
+  performance:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+
+      - name: Set up Python
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6
+        with:
+          python-version: "3.12"
+
+      - name: Install Hatch and dependencies via Makefile
+        run: |
+          pip install hatch
+          make install
+
+      - name: Run performance regression tests (if present)
+        run: |
+          if [ -d tests/performance ]; then
+            hatch run python -m pytest tests/performance -v
+          else
+            echo "No performance tests found; skipping."
+          fi

azure_functions_langgraph-0.5.0/.github/workflows/publish-pypi.yml

@@ -0,0 +1,57 @@
+name: Publish to PyPI
+
+on:
+  push:
+    # Trigger the workflow on tag pushes matching v* (e.g., v1.0.0)
+    tags:
+      - 'v*'
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: Git tag to publish (for example v0.3.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_langgraph/__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_langgraph-0.5.0/.github/workflows/release.yml

@@ -0,0 +1,38 @@
+name: Create GitHub Release
+
+on:
+  push:
+    # Trigger the workflow on tag pushes matching v* (e.g., v1.0.0)
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6
+        with:
+          python-version: "3.12"
+
+      - name: Install git-cliff
+        run: pip install "git-cliff>=2.12,<3"
+
+      - name: Generate changelog
+        run: git-cliff --latest --strip header -o RELEASE_NOTES.md
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          body_path: RELEASE_NOTES.md
+          prerelease: ${{ contains(github.ref_name, 'alpha') || contains(github.ref_name, 'beta') || contains(github.ref_name, 'rc') }}
+          generate_release_notes: false

azure_functions_langgraph-0.5.0/.github/workflows/sbom.yml

@@ -0,0 +1,28 @@
+name: Generate SBOM
+
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: "0 1 * * 1"
+
+permissions:
+  contents: read
+
+jobs:
+  sbom:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+
+      - name: Generate SBOM
+        uses: anchore/sbom-action@e22c389904149dbc22b58101806040fa8d37a610 # v0.24.0
+        with:
+          format: spdx-json
+          output-file: sbom.spdx.json
+
+      - name: Upload SBOM artifact
+        uses: actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f # v7.0.0
+        with:
+          name: sbom
+          path: sbom.spdx.json

azure_functions_langgraph-0.5.0/.github/workflows/security.yml

@@ -0,0 +1,43 @@
+name: Security Scans
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+  push:
+    branches: [main]
+  schedule:
+    - cron: "0 2 * * 1"
+
+permissions:
+  contents: read
+
+jobs:
+  bandit:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+
+      - name: Set up Python
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6
+        with:
+          python-version: "3.12"
+
+      - name: Install Hatch and dependencies via Makefile
+        run: |
+          pip install hatch
+          make install
+
+      - name: Run Bandit
+        run: make security
+
+  semgrep:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+
+      - name: Run Semgrep
+        uses: semgrep/semgrep-action@713efdd345f3035192eaa63f56867b88e63e4e5d # v1
+        with:
+          config: p/python