span-panel-api 2.3.2__tar.gz → 2.4.1__tar.gz

span_panel_api-2.4.1/.codefactor

@@ -0,0 +1,29 @@
+{
+  "version": "1.0.0",
+  "exclude": [
+    "scripts/**/*",
+    "examples/**/*",
+    "tests/**/*",
+    "src/span_panel_api/generated_client/**/*",
+    "generate_client.py",
+    "*.pyc",
+    "__pycache__/**/*",
+    ".venv/**/*",
+    "venv/**/*",
+    "dist/**/*",
+    "build/**/*",
+    ".git/**/*",
+    ".mypy_cache/**/*",
+    ".pytest_cache/**/*",
+    ".ruff_cache/**/*"
+  ],
+  "rules": {
+    "ComplexMethod": {
+      "enabled": true,
+      "exclude": [
+        "scripts/**/*",
+        "examples/**/*"
+      ]
+    }
+  }
+}

span_panel_api-2.4.1/.codefactor.yml

@@ -0,0 +1,18 @@
+version: 1.0
+
+# Exclude noisy or generated directories from CodeFactor analysis
+exclude_patterns:
+  - scripts/**
+  - examples/**
+  - tests/**
+  - src/span_panel_api/generated_client/**
+  - generate_client.py
+  - __pycache__/**
+  - .venv/**
+  - venv/**
+  - dist/**
+  - build/**
+  - .git/**
+  - .mypy_cache/**
+  - .pytest_cache/**
+  - .ruff_cache/**

span_panel_api-2.4.1/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,37 @@
+# Bug Report
+
+---
+
+name: Bug report
+
+about: Create a report to help us improve
+
+title: ''
+
+labels: ''
+
+assignees: ''
+
+---
+
+## Python Version Used
+
+## Describe the bug
+
+A clear and concise description of what the bug is.
+
+## To Reproduce
+
+Steps to reproduce the behavior:
+
+## Expected behavior
+
+A clear and concise description of what you expected to happen.
+
+## Screenshots
+
+If applicable, add screenshots to help explain your problem.
+
+## Additional context
+
+Add any other context about the problem here.

span_panel_api-2.4.1/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,31 @@
+# Feature Request
+
+---
+
+name: Feature request
+
+about: Suggest an idea for this project
+
+title: ''
+
+labels: ''
+
+assignees: ''
+
+---
+
+## Is your feature request related to a problem? Please describe
+
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+## Describe the solution you'd like
+
+A clear and concise description of what you want to happen.
+
+## Describe alternatives you've considered
+
+A clear and concise description of any alternative solutions or features you've considered.
+
+## Additional context
+
+Add any other context or screenshots about the feature request here.

span_panel_api-2.4.1/.github/dependabot.yml

@@ -0,0 +1,62 @@
+version: 2
+updates:
+  # Enable version updates for Python dependencies
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 1
+    allow:
+      - dependency-type: "all"
+    groups:
+      # Group development dependencies together
+      dev-dependencies:
+        patterns:
+          - "pytest*"
+          - "mypy"
+          - "ruff"
+          - "bandit"
+          - "pre-commit"
+          - "twine"
+          - "*-cov"
+          - "types-*"
+      # Group documentation dependencies
+      docs-dependencies:
+        patterns:
+          - "mkdocs*"
+          - "mkdocstrings"
+      # Group core runtime dependencies for span-panel-api
+      runtime-dependencies:
+        patterns:
+          - "httpx"
+          - "attrs"
+          - "python-dateutil"
+          - "click"
+    reviewers:
+      - "cayossarian"
+    assignees:
+      - "cayossarian"
+
+  # Enable version updates for Python dependencies (generated client)
+  - package-ecosystem: "pip"
+    directory: "/generated_client"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5
+    allow:
+      - dependency-type: "all"
+    reviewers:
+      - "cayossarian"
+    assignees:
+      - "cayossarian"
+
+  # Enable version updates for GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5
+    reviewers:
+      - "cayossarian"
+    assignees:
+      - "cayossarian"

span_panel_api-2.4.1/.github/workflows/ci.yml

@@ -0,0 +1,102 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  lint-and-test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.13", "3.14"]
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v6
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v6
+      with:
+        python-version: ${{ matrix.python-version }}
+        allow-prereleases: true
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v5
+      with:
+        enable-cache: true
+
+    - name: Install dependencies
+      run: uv sync
+
+    - name: Run pre-commit hooks
+      run: |
+        uv run pre-commit run --all-files
+
+    - name: Run tests with pytest
+      run: |
+        uv run pytest tests/ -v --cov=src/span_panel_api --cov-report=xml --cov-report=term-missing
+
+
+
+  security-scan:
+    runs-on: ubuntu-latest
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v6
+
+    - name: Set up Python
+      uses: actions/setup-python@v6
+      with:
+        python-version: "3.13"
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v5
+      with:
+        enable-cache: true
+
+    - name: Install dependencies
+      run: uv sync
+
+    - name: Run Bandit security scan
+      run: |
+        uv run bandit -r src/ -f json -o bandit-report.json || true
+
+    - name: Upload Bandit scan results
+      uses: actions/upload-artifact@v7
+      with:
+        name: bandit-report
+        path: bandit-report.json
+
+  build-check:
+    runs-on: ubuntu-latest
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v6
+
+    - name: Set up Python
+      uses: actions/setup-python@v6
+      with:
+        python-version: "3.13"
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v5
+      with:
+        enable-cache: true
+
+    - name: Install dependencies
+      run: uv sync
+
+    - name: Build package
+      run: uv build
+
+    - name: Check package
+      run: uv run twine check dist/*
+
+    - name: Upload build artifacts
+      uses: actions/upload-artifact@v7
+      with:
+        name: dist
+        path: dist/

span_panel_api-2.4.1/.github/workflows/dependabot-auto-approve.yml

@@ -0,0 +1,38 @@
+name: Dependabot Auto-Approve
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  auto-approve:
+    runs-on: ubuntu-latest
+    if: github.actor == 'dependabot[bot]'
+    steps:
+      - name: Dependabot metadata
+        id: metadata
+        uses: dependabot/fetch-metadata@v2.5.0
+        with:
+          github-token: "${{ secrets.GITHUB_TOKEN }}"
+
+      - name: Auto-approve patch and minor updates
+        if: ${{ steps.metadata.outputs.update-type == 'version-update:semver-patch' || steps.metadata.outputs.update-type == 'version-update:semver-minor' }}
+        run: |
+          echo "Auto-approving ${{ steps.metadata.outputs.dependency-names }}"
+          gh pr review --approve "$PR_URL"
+        env:
+          PR_URL: ${{ github.event.pull_request.html_url }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Auto-approve GitHub Actions updates
+        if: ${{ steps.metadata.outputs.package-ecosystem == 'github_actions' }}
+        run: |
+          echo "Auto-approving GitHub Actions update for ${{ steps.metadata.outputs.dependency-names }}"
+          gh pr review --approve "$PR_URL"
+        env:
+          PR_URL: ${{ github.event.pull_request.html_url }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

span_panel_api-2.4.1/.github/workflows/dependabot-auto-merge.yml

@@ -0,0 +1,56 @@
+name: Dependabot Auto-Merge
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  auto-merge:
+    runs-on: ubuntu-latest
+    if: github.actor == 'dependabot[bot]'
+    steps:
+      - name: Dependabot metadata
+        id: metadata
+        uses: dependabot/fetch-metadata@v2.5.0
+        with:
+          github-token: "${{ secrets.GITHUB_TOKEN }}"
+
+      - name: Auto-merge for patch and minor updates
+        if: ${{ steps.metadata.outputs.update-type == 'version-update:semver-patch' || steps.metadata.outputs.update-type == 'version-update:semver-minor' }}
+        run: |
+          echo "Auto-merging ${{ steps.metadata.outputs.dependency-names }}"
+          gh pr merge --auto --merge "$PR_URL"
+        env:
+          PR_URL: ${{ github.event.pull_request.html_url }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Enable auto-merge for GitHub Actions updates
+        if: ${{ steps.metadata.outputs.package-ecosystem == 'github_actions' }}
+        run: |
+          echo "Auto-merging GitHub Actions update for ${{ steps.metadata.outputs.dependency-names }}"
+          gh pr merge --auto --merge "$PR_URL"
+        env:
+          PR_URL: ${{ github.event.pull_request.html_url }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Comment on major version updates
+        if: ${{ steps.metadata.outputs.update-type == 'version-update:semver-major' }}
+        run: |
+          gh pr comment "$PR_URL" --body "🚨 **Major version update detected!**
+
+          This PR contains major version updates that may include breaking changes:
+          - **${{ steps.metadata.outputs.dependency-names }}**
+
+          Please review carefully before merging. Consider:
+          - Reading the changelog/release notes
+          - Testing locally
+          - Checking for breaking changes
+
+          This PR will **NOT** be auto-merged due to the major version change."
+        env:
+          PR_URL: ${{ github.event.pull_request.html_url }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

span_panel_api-2.4.1/.github/workflows/release.yml

@@ -0,0 +1,42 @@
+name: Release
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      id-token: write  # For trusted publishing to PyPI
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v6
+
+    - name: Set up Python
+      uses: actions/setup-python@v6
+      with:
+        python-version: "3.13"
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v5
+      with:
+        enable-cache: true
+
+    - name: Update version from tag
+      run: |
+        # Extract version from git tag (remove 'v' prefix if present)
+        VERSION=${GITHUB_REF#refs/tags/}
+        VERSION=${VERSION#v}
+        echo "Setting version to $VERSION"
+        sed -i "s/^version = \".*\"/version = \"$VERSION\"/" pyproject.toml
+
+    - name: Build package
+      run: uv build
+
+    - name: Publish to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        print-hash: true

span_panel_api-2.4.1/.gitignore

@@ -0,0 +1,35 @@
+__pycache__/
+build/
+dist/
+*.egg-info/
+.pytest_cache/
+.cursor/
+.cursorignore
+.cursor
+.cursorindexingignore
+xnotes/*
+
+# pyenv
+.python-version
+
+# Environments
+.env
+.envrc
+.venv
+.vscode/settings.json
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# ruff
+.ruff_cache/
+
+# JetBrains
+.idea/
+
+/coverage.xml
+/.coverage
+**/.DS_Store
+.local_coverage_data

span_panel_api-2.4.1/.markdownlint-cli2.jsonc

@@ -0,0 +1,49 @@
+{
+  "config": {
+    "default": true,
+    "MD013": {
+      "line_length": 256,
+      "heading_line_length": 256,
+      "code_block_line_length": 256,
+      "tables": false
+    },
+    "MD025": false,
+    "MD033": {
+      "allowed_elements": ["br", "details", "summary"]
+    },
+    "MD046": {
+      "style": "fenced"
+    },
+    "MD024": {
+      "siblings_only": true
+    },
+    "MD022": {
+      "lines_above": 1,
+      "lines_below": 1
+    },
+    "MD026": {
+      "punctuation": ".,;:!"
+    },
+    "MD031": {
+      "list_items": true
+    },
+    "MD032": true,
+    "MD036": false,
+    "MD040": {
+      "allowed_languages": ["yaml", "python", "bash", "shell", "json", "toml", "markdown", "text", "console", "diff"],
+      "language_only": false
+    }
+  },
+  "globs": ["**/*.md"],
+  "ignores": [
+    ".venv/**",
+    "venv/**",
+    "node_modules/**",
+    "__pycache__/**",
+    "htmlcov/**",
+    ".mypy_cache/**",
+    ".pytest_cache/**",
+    "dist/**",
+    "build/**"
+  ]
+}

span_panel_api-2.4.1/.markdownlint.json

@@ -0,0 +1,11 @@
+{
+  "default": true,
+  "MD013": {
+    "line_length": 256
+  },
+  "MD024": {
+    "siblings_only": true
+  },
+  "MD033": false,
+  "MD041": false
+}

span_panel_api-2.4.1/.pre-commit-config.yaml

@@ -0,0 +1,136 @@
+repos:
+  # Pre-commit hooks for basic checks
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+        exclude: '^src/span_panel_api/generated_client/.*|\..*_cache/.*|dist/.*|venv/.*|\.venv/.*'
+      - id: end-of-file-fixer
+        exclude: '^src/span_panel_api/generated_client/.*|\..*_cache/.*|dist/.*|venv/.*|\.venv/.*'
+      - id: check-yaml
+        exclude: '^src/span_panel_api/generated_client/.*|\..*_cache/.*|dist/.*|venv/.*|\.venv/.*'
+      - id: check-toml
+        exclude: '^src/span_panel_api/generated_client/.*|\..*_cache/.*|dist/.*|venv/.*|\.venv/.*'
+      - id: check-json
+        exclude: '^src/span_panel_api/generated_client/.*|\..*_cache/.*|dist/.*|venv/.*|\.venv/.*'
+      - id: check-added-large-files
+      - id: check-merge-conflict
+        exclude: '^src/span_panel_api/generated_client/.*|\..*_cache/.*|dist/.*|venv/.*|\.venv/.*'
+      - id: debug-statements
+        exclude: '^src/span_panel_api/generated_client/.*|generate_client\.py|scripts/.*|tests/.*|\..*_cache/.*|dist/.*|venv/.*|\.venv/.*|^examples/.*'
+      - id: mixed-line-ending
+        args: ['--fix=lf']
+        exclude: '^src/span_panel_api/generated_client/.*|\..*_cache/.*|dist/.*|venv/.*|\.venv/.*'
+
+  # Ruff for formatting and linting
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.11.13
+    hooks:
+      # Run formatter first - exclude tests to avoid conflicts with black
+      - id: ruff-format
+        exclude: '^src/span_panel_api/generated_client/.*|generate_client\.py|scripts/.*|tests/.*|\..*_cache/.*|dist/.*|venv/.*|\.venv/.*|^examples/.*'
+      # Then linter - exclude tests and scripts from strict linting
+      - id: ruff-check
+        args: ['--fix']
+        exclude: '^src/span_panel_api/generated_client/.*|generate_client\.py|scripts/.*|tests/.*|\..*_cache/.*|dist/.*|venv/.*|\.venv/.*|^examples/.*'
+
+  # Black for line length handling and test file formatting
+  - repo: https://github.com/psf/black
+    rev: 25.1.0
+    hooks:
+      - id: black
+        language_version: python3
+        args: [
+          '--line-length=125',
+          '--skip-string-normalization',
+          '--target-version=py312',
+          '--extend-exclude=src/span_panel_api/generated_client|generate_client\.py|scripts|\.venv|venv'
+        ]
+        exclude: '^src/span_panel_api/generated_client/.*|generate_client\.py|scripts/.*|\..*_cache/.*|dist/.*|venv/.*|\.venv/.*|^examples/.*'
+
+  # Prettier for markdown formatting
+  - repo: https://github.com/pre-commit/mirrors-prettier
+    rev: v3.1.0
+    hooks:
+      - id: prettier
+        types: [markdown]
+        args: ['--config', '.prettierrc.json']
+        exclude: '^src/span_panel_api/generated_client/.*|\..*_cache/.*|dist/.*|venv/.*|\.venv/.*|node_modules/.*|htmlcov/.*'
+
+  # Markdownlint for markdown files (after Prettier formatting)
+  - repo: https://github.com/DavidAnson/markdownlint-cli2
+    rev: v0.15.0
+    hooks:
+      - id: markdownlint-cli2
+        args: ['--config', '.markdownlint-cli2.jsonc']
+        exclude: '^src/span_panel_api/generated_client/.*|\..*_cache/.*|dist/.*|venv/.*|\.venv/.*|node_modules/.*|htmlcov/.*'
+
+  # MyPy for type checking
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.16.0
+    hooks:
+      - id: mypy
+        additional_dependencies:
+          - httpx
+          - click
+          - typing-extensions
+          - pytest
+          - types-PyYAML
+          - paho-mqtt
+        args: ['--config-file=pyproject.toml']
+        exclude: '^src/span_panel_api/generated_client/.*|scripts/.*|tests/.*|docs/.*|examples/.*|\..*_cache/.*|dist/.*|venv/.*'
+
+  # Pylint for code quality
+  - repo: https://github.com/pycqa/pylint
+    rev: v3.3.3
+    hooks:
+      - id: pylint
+        additional_dependencies:
+          - httpx
+          - click
+          - typing-extensions
+          - pytest
+          - pyyaml
+          - paho-mqtt
+        exclude: '^src/span_panel_api/generated_client/.*|tests/.*|generate_client\.py|scripts/.*|\..*_cache/.*|dist/.*|venv/.*|\.venv/.*|^examples/.*'
+
+  # Check for common security issues
+  - repo: https://github.com/PyCQA/bandit
+    rev: 1.8.3
+    hooks:
+      - id: bandit
+        args: ['-c', 'pyproject.toml']
+        additional_dependencies: ['bandit[toml]']
+        exclude: '^tests/.*|^scripts/.*|^src/span_panel_api/generated_client/.*|\..*_cache/.*|dist/.*|venv/.*|\.venv/.*|^examples/.*'
+
+  # Vulture for dead code detection
+  - repo: local
+    hooks:
+      - id: vulture
+        name: vulture
+        entry: bash -c 'uv run vulture src/span_panel_api/ --min-confidence 80'
+        language: system
+        types: [python]
+        pass_filenames: false
+        exclude: '^src/span_panel_api/generated_client/.*|\..*_cache/.*|dist/.*|venv/.*|\.venv/.*|^examples/.*'
+
+  # uv lock check for lockfile validation
+  - repo: local
+    hooks:
+      - id: uv-lock-check
+        name: uv lock check
+        entry: uv lock --check
+        language: system
+        pass_filenames: false
+        files: ^pyproject\.toml$|^uv\.lock$
+
+  # Quick coverage check (total only, no details)
+  - repo: local
+    hooks:
+      - id: pytest-cov-summary
+        name: coverage summary
+        entry: bash
+        language: system
+        args: ['-c', 'output=$(uv run pytest tests/ --cov=src/span_panel_api --cov-config=pyproject.toml --cov-fail-under=85 -q 2>&1); status=$?; echo "$output"; exit "$status"']
+        pass_filenames: false
+        verbose: true

span_panel_api-2.4.1/.prettierrc.json

@@ -0,0 +1,25 @@
+{
+  "printWidth": 256,
+  "tabWidth": 2,
+  "useTabs": false,
+  "semi": true,
+  "singleQuote": false,
+  "quoteProps": "as-needed",
+  "jsxSingleQuote": false,
+  "trailingComma": "es5",
+  "bracketSpacing": true,
+  "bracketSameLine": false,
+  "arrowParens": "always",
+  "endOfLine": "lf",
+  "overrides": [
+    {
+      "files": "*.md",
+      "options": {
+        "printWidth": 256,
+        "proseWrap": "always",
+        "tabWidth": 2,
+        "useTabs": false
+      }
+    }
+  ]
+}

span_panel_api-2.4.1/.vscode/extensions.json

@@ -0,0 +1,5 @@
+{
+    "recommendations": [
+        "ms-python.vscode-pylance"
+    ]
+}