lifx-async 1.0.0__tar.gz

lifx_async-1.0.0/.claude/settings.json

@@ -0,0 +1,3 @@
+{
+    "includeCoAuthoredBy": false
+}

lifx_async-1.0.0/.github/dependabot.yml

@@ -0,0 +1,62 @@
+# Dependabot configuration for automated dependency updates
+# Docs: https://docs.github.com/en/code-security/dependabot
+
+version: 2
+updates:
+  # Python dependencies (via pip)
+- package-ecosystem: pip
+  directory: /
+  schedule:
+    interval: weekly
+    day: monday
+    time: 09:00
+  open-pull-requests-limit: 5
+  labels:
+  - dependencies
+  - python
+  commit-message:
+    prefix: chore(deps)
+    include: scope
+    # Group updates for easier review
+  groups:
+    dev-dependencies:
+      patterns:
+      - pytest*
+      - ruff*
+      - pyright*
+      - mkdocs*
+      - hatchling*
+      - pyyaml*
+      update-types:
+      - minor
+      - patch
+
+  # GitHub Actions
+- package-ecosystem: github-actions
+  directory: /
+  schedule:
+    interval: weekly
+    day: monday
+    time: 09:00
+  open-pull-requests-limit: 3
+  labels:
+  - dependencies
+  - github-actions
+  commit-message:
+    prefix: ci
+    include: scope
+    # Auto-merge minor and patch updates for actions
+  groups:
+    github-actions:
+      patterns:
+      - '*'
+      update-types:
+      - minor
+      - patch
+
+# Dependabot will:
+# 1. Check for updates weekly on Monday at 9am
+# 2. Create PRs for outdated dependencies
+# 3. Group related updates together
+# 4. Auto-label PRs for easier triage
+# 5. Limit concurrent PRs to avoid overwhelming maintainers

lifx_async-1.0.0/.github/labeler.yml

@@ -0,0 +1,65 @@
+# Auto-labeling configuration for pull requests
+# See: https://github.com/actions/labeler
+
+# Source code categories
+devices:
+- changed-files:
+  - any-glob-to-any-file: src/lifx/devices/**
+
+network:
+- changed-files:
+  - any-glob-to-any-file: src/lifx/network/**
+
+protocol:
+- changed-files:
+  - any-glob-to-any-file:
+    - src/lifx/protocol/**
+    - protocol.yml
+
+api:
+- changed-files:
+  - any-glob-to-any-file: src/lifx/api.py
+
+# Testing
+tests:
+- changed-files:
+  - any-glob-to-any-file: tests/**
+
+# Documentation
+documentation:
+- changed-files:
+  - any-glob-to-any-file:
+    - '*.md'
+    - docs/**
+    - examples/**
+
+# Examples
+examples:
+- changed-files:
+  - any-glob-to-any-file: examples/**
+
+# CI/CD
+ci/cd:
+- changed-files:
+  - any-glob-to-any-file:
+    - .github/**
+    - scripts/**
+
+# Dependencies
+dependencies:
+- changed-files:
+  - any-glob-to-any-file:
+    - pyproject.toml
+    - requirements*.txt
+    - uv.lock
+
+# Configuration
+configuration:
+- changed-files:
+  - any-glob-to-any-file:
+    - .*rc
+    - .*rc.js
+    - .*rc.json
+    - .*.yml
+    - .*.yaml
+    - pyproject.toml

lifx_async-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,173 @@
+name: CI
+
+on:
+  push:
+    branches:
+    - main
+  pull_request:
+
+
+env:
+  PYTHON_VERSION: '3.11'
+  UV_VERSION: 0.9.4
+
+jobs:
+  # Code quality checks
+  quality:
+    name: Code Quality
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ env.PYTHON_VERSION }}
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v7
+      with:
+        version: ${{ env.UV_VERSION }}
+        python-version: ${{ env.PYTHON_VERSION }}
+
+    - name: Install dependencies
+      run: uv sync --frozen
+
+    - name: Run Ruff format check
+      run: uv run ruff format --check .
+
+    - name: Run Ruff linter
+      run: uv run ruff check .
+
+    - name: Run Pyright type checker
+      run: uv run pyright
+
+    - name: Check for security issues
+      run: |
+        uv pip install bandit
+        uv run bandit -r src/
+
+  # Testing matrix across Python versions and platforms
+  test:
+    name: Test (Python ${{ matrix.python-version }} on ${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ['3.11', '3.12', '3.13', '3.14']
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v7
+      with:
+        version: ${{ env.UV_VERSION }}
+        python-version: ${{ matrix.python-version }}
+        enable-cache: true
+
+    - name: Install dependencies
+      run: uv sync --frozen
+
+    - name: Run unit tests
+      run: uv run --frozen pytest
+
+    - name: Upload coverage to Codecov
+      if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.11'
+      uses: codecov/codecov-action@v5
+      with:
+        slug: Djelibeybi/lifx-async
+        token: ${{ secrets.CODECOV_TOKEN }}
+        fail_ci_if_error: false
+
+    - name: Upload test results to Codecov
+      if: ${{ !cancelled() }}
+      uses: codecov/test-results-action@v1
+      with:
+        fail_ci_if_error: false
+        token: ${{ secrets.CODECOV_TOKEN }}
+
+  release:
+    needs:
+    - quality
+    - test
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: write
+    concurrency:
+      group: ${{ github.workflow }}-release-${{ github.ref_name }}
+      cancel-in-progress: false
+
+    steps:
+    - name: Checkout repository on release branch
+      uses: actions/checkout@v4
+      with:
+        ref: ${{ github.head_ref || github.ref_name }}
+        fetch-depth: 0
+
+    - name: Test Python Semantic Release
+      id: test-release
+      uses: python-semantic-release/python-semantic-release@v10.4.1
+      if: github.ref_name != 'main'
+      with:
+        github_token: ${{ secrets.GITHUB_TOKEN }}
+        no_operation_mode: true
+
+    - name: Run Semantic Version Release
+      id: release
+      uses: python-semantic-release/python-semantic-release@v10.4.1
+      if: github.ref_name == 'main'
+      with:
+        github_token: ${{ secrets.GITHUB_TOKEN }}
+        git_committer_name: github-actions
+        git_committer_email: actions@users.noreply.github.com
+
+    - name: Upload to GitHub Release Assets
+      uses: python-semantic-release/publish-action@v10.4.1
+      if: steps.release.outputs.released == 'true'
+      with:
+        github_token: ${{ secrets.GITHUB_TOKEN }}
+        tag: ${{ steps.release.outputs.tag }}
+
+    - name: Upload Distribution Artifacts
+      uses: actions/upload-artifact@v4
+      with:
+        name: distribution-artifacts
+        path: dist
+
+    outputs:
+      released: ${{ steps.release.outputs.released || 'false' }}
+
+  deploy:
+    runs-on: ubuntu-latest
+    needs: release
+    if: ${{ needs.release.outputs.released == 'true' }}
+
+    permissions:
+      contents: read
+      id-token: write
+
+    environment:
+      name: pypi
+      url: https://pypi.org/p/lifx-async
+
+    steps:
+    - name: Download Build Artifacts
+      uses: actions/download-artifact@v4
+      id: artifact-download
+      with:
+        name: distribution-artifacts
+        path: dist
+
+    - name: Publish package distributions to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        packages-dir: dist
+        print-hash: true
+        verbose: true

lifx_async-1.0.0/.github/workflows/docs.yml

@@ -0,0 +1,111 @@
+name: Documentation
+
+on:
+  push:
+    branches:
+    - main
+    paths:
+    - docs/**
+    - src/lifx/**
+    - mkdocs.yml
+    - .github/workflows/docs.yml
+  pull_request:
+    paths:
+    - docs/**
+    - mkdocs.yml
+
+env:
+  PYTHON_VERSION: '3.11'
+  UV_VERSION: 0.9.4
+
+permissions:
+  contents: write
+
+jobs:
+  build-docs:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0    # Fetch all history for git-revision-date-localized
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ env.PYTHON_VERSION }}
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v7
+      with:
+        version: ${{ env.UV_VERSION }}
+        python-version: ${{ env.PYTHON_VERSION }}
+
+    - name: Install dependencies
+      run: |
+        uv sync --frozen
+
+    - name: Build documentation
+      run: uv run mkdocs build
+
+    - name: Upload docs artifact
+      if: github.event_name == 'pull_request'
+      uses: actions/upload-artifact@v4
+      with:
+        name: docs
+        path: site/
+
+  deploy-docs:
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
+    needs: build-docs
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ env.PYTHON_VERSION }}
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v7
+      with:
+        version: ${{ env.UV_VERSION }}
+        python-version: ${{ env.PYTHON_VERSION }}
+
+    - name: Install dependencies
+      run: |
+        uv sync --frozen
+
+    - name: Configure Git
+      run: |
+        git config user.name "github-actions[bot]"
+        git config user.email "github-actions[bot]@users.noreply.github.com"
+
+    - name: Deploy to GitHub Pages
+      run: uv run mkdocs gh-deploy --force
+
+  validate-links:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ env.PYTHON_VERSION }}
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v7
+      with:
+        version: ${{ env.UV_VERSION }}
+        python-version: ${{ env.PYTHON_VERSION }}
+
+    - name: Install dependencies
+      run: |
+        uv sync --frozen
+
+    - name: Build and check links
+      run: |
+        uv run mkdocs build

lifx_async-1.0.0/.github/workflows/pr-automation.yml

@@ -0,0 +1,156 @@
+name: PR Automation
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+
+permissions:
+  contents: read
+  pull-requests: write
+  issues: write
+
+jobs:
+  # Auto-label PRs based on files changed
+  auto-label:
+    name: Auto Label PR
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/labeler@v5
+      with:
+        repo-token: ${{ secrets.GITHUB_TOKEN }}
+        configuration-path: .github/labeler.yml
+
+  # Size label based on lines changed
+  size-label:
+    name: Add Size Label
+    runs-on: ubuntu-latest
+    steps:
+    - uses: codelytv/pr-size-labeler@v1
+      with:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        xs_label: size/xs
+        xs_max_size: '10'
+        s_label: size/s
+        s_max_size: '100'
+        m_label: size/m
+        m_max_size: '500'
+        l_label: size/l
+        l_max_size: '1000'
+        xl_label: size/xl
+        fail_if_xl: 'false'
+
+  # Validate PR title follows conventional commits
+  validate-title:
+    name: Validate PR Title
+    runs-on: ubuntu-latest
+    steps:
+    - uses: amannn/action-semantic-pull-request@v5
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      with:
+        types: |
+          feat
+          fix
+          docs
+          style
+          refactor
+          perf
+          test
+          build
+          ci
+          chore
+          revert
+        scopes: |
+          devices
+          discovery
+          network
+          protocol
+          api
+          examples
+          tests
+          docs
+          ci
+          deps
+        requireScope: false
+        subjectPattern: ^(?![A-Z]).+$
+        subjectPatternError: |
+          The subject "{subject}" found in the pull request title "{title}"
+          didn't match the configured pattern. Please ensure that the subject
+          does not start with an uppercase character.
+
+  # Comment on first-time contributors
+  welcome:
+    name: Welcome First-Time Contributors
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/first-interaction@v1
+      with:
+        repo-token: ${{ secrets.GITHUB_TOKEN }}
+        pr-message: |
+          👋 Thanks for opening your first pull request! We're excited to have you contributing to lifx-async.
+
+          Here are a few things to check:
+          - [ ] All tests are passing
+          - [ ] Code follows our style guide (Ruff + Pyright)
+          - [ ] Documentation is updated if needed
+          - [ ] Conventional commit format is used
+
+          A maintainer will review your PR soon. Feel free to ask questions!
+
+  # Check for breaking changes
+  breaking-changes:
+    name: Check for Breaking Changes
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+
+    - name: Check for breaking changes
+      uses: actions/github-script@v7
+      with:
+        script: |
+          const { data: files } = await github.rest.pulls.listFiles({
+            owner: context.repo.owner,
+            repo: context.repo.repo,
+            pull_number: context.issue.number
+          });
+
+          // Check for potential breaking changes
+          const breakingPatterns = [
+            /src\/lifx\/api\.py/,
+            /src\/lifx\/devices\/.*\.py/,
+            /src\/lifx\/protocol\/packets\.py/
+          ];
+
+          const breakingFiles = files.filter(file =>
+            breakingPatterns.some(pattern => pattern.test(file.filename))
+          );
+
+          if (breakingFiles.length > 0) {
+            const comment = `## ⚠️ Potential Breaking Changes Detected
+
+          This PR modifies public API files:
+          ${breakingFiles.map(f => `- \`${f.filename}\``).join('\n')}
+
+          **Please ensure:**
+          - [ ] Changes are backward compatible, OR
+          - [ ] This is a major version bump (v2.0.0, v3.0.0, etc.)
+          - [ ] Migration guide is provided
+          - [ ] Breaking changes are documented in PR description`;
+
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              body: comment
+            });
+
+            // Add label
+            await github.rest.issues.addLabels({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              labels: ['breaking-change']
+            });
+          }

lifx_async-1.0.0/.gitignore

@@ -0,0 +1,94 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+
+# Distribution / packaging
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+.python-version
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Testing
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.nox/
+coverage.xml
+*.cover
+.hypothesis/
+junit.xml
+
+# Type checking
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pytype/
+pyrightconfig.json
+
+# Ruff
+.ruff_cache/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+*.ipynb
+
+# Documentation
+docs/_build/
+site/
+
+# Build artifacts
+*.prof
+*.lprof
+
+# OS
+.DS_Store
+Thumbs.db
+.Spotlight-V100
+.Trashes
+
+# Temporary files
+*.tmp
+*.bak
+*.log
+.cache/
+
+# Local storage
+.notes/
+.claude/settings.local.json