ghome-local-api 0.1.0__tar.gz

ghome_local_api-0.1.0/.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+charset = utf-8
+indent_style = space
+indent_size = 4
+
+[*.{json,md,yaml,yml}]
+indent_size = 2

ghome_local_api-0.1.0/.github/actions/install-deps/action.yml

@@ -0,0 +1,24 @@
+name: "Common steps to install and cache dependencies"
+description: "Install uv, Python and the project dependencies"
+
+inputs:
+  python-version:
+    description: "Python version to set up"
+    required: true
+
+runs:
+  using: "composite"
+  steps:
+    - name: Install uv
+      uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+      # enable-cache stays at its default, "auto": the cache is on for CI and
+      # off for release events, so release builds don't restore a cache.
+      with:
+        python-version: ${{ inputs.python-version }}
+        # Different jobs on the same Python version still compute the
+        # same key and race to save it, so add the job name too.
+        cache-suffix: ${{ github.job }}
+
+    - name: Install dependencies with uv
+      shell: bash
+      run: uv sync

ghome_local_api-0.1.0/.github/dependabot.yml

@@ -0,0 +1,34 @@
+version: 2
+updates:
+  - package-ecosystem: uv
+    directory: "/"
+    # Never raise floors in pyproject.toml: the runtime floors follow Home
+    # Assistant's pins, and a newer floor would stop ghome-local-api installing there.
+    versioning-strategy: lockfile-only
+    schedule:
+      interval: weekly
+    # A release has a week to be yanked before it is proposed here.
+    cooldown:
+      default-days: 7
+    labels:
+      - "dependencies"
+  - package-ecosystem: pre-commit
+    directory: "/"
+    schedule:
+      interval: weekly
+    cooldown:
+      default-days: 7
+    labels:
+      - "dependencies"
+  - package-ecosystem: github-actions
+    directories:
+      # Workflows in .github/workflows
+      - "/"
+      # Composite actions are not covered by "/" and must be listed explicitly
+      - "/.github/actions/*"
+    schedule:
+      interval: weekly
+    cooldown:
+      default-days: 7
+    labels:
+      - "dependencies"

ghome_local_api-0.1.0/.github/labeler.yml

@@ -0,0 +1,40 @@
+# Schema reference: https://github.com/actions/labeler#match-object
+# Options inside `all` are AND-ed. The dependency rule needs every change to be
+# inside its listed files; the GitHub structure and documentation rules can
+# also match mixed changes. Pull requests touching Python source need a manual
+# type label. Dependabot labels its own pull requests, so its branches are
+# skipped here.
+
+dependencies:
+  - all:
+      - head-branch: ["^(?!dependabot/)"]
+      - changed-files:
+          # A dependency update only: nothing outside these files changed.
+          - any-glob-to-any-file: "uv.lock"
+          # One combined pattern: any-glob-to-all-files asks whether a
+          # single glob matches every changed file, so a list of two would
+          # never match the usual pair.
+          - any-glob-to-all-files: "{uv.lock,pyproject.toml}"
+
+github structure:
+  - all:
+      - head-branch: ["^(?!dependabot/)"]
+      - changed-files:
+          - any-glob-to-any-file: ".github/**/*"
+          - all-globs-to-all-files: "!**/*.py"
+
+documentation:
+  - all:
+      - head-branch: ["^(?!dependabot/)"]
+      - changed-files:
+          - any-glob-to-any-file: "**/*.md"
+          - all-globs-to-all-files:
+              - "!**/*.py"
+              - "!.github/**/*"
+
+test:
+  - all:
+      - head-branch: ["^(?!dependabot/)"]
+      - changed-files:
+          - any-glob-to-any-file: "tests/**/*"
+          - all-globs-to-all-files: "!ghome_local_api/**/*"

ghome_local_api-0.1.0/.github/labels.yml

@@ -0,0 +1,93 @@
+---
+# Labels names are important as they are used by Release Drafter to decide
+# regarding where to record them in changelog or if to skip them.
+#
+# The repository labels will be automatically configured using this file and
+# the GitHub Action https://github.com/marketplace/actions/github-labeler.
+- name: automerge
+  description: Automatically merge by Kodiak
+  color: d4c5f9
+
+- name: breaking
+  description: Breaking change. Used for major release bump
+  color: b60205
+
+- name: bug
+  description: Something isn't working
+  color: d73a4a
+
+- name: dependencies
+  description: Pull requests that update a dependency file
+  color: 0366d6
+
+- name: documentation
+  description: Improvements or additions to documentation
+  color: 0075ca
+
+- name: duplicate
+  description: This issue or pull request already exists
+  color: cfd3d7
+
+- name: feature
+  description: New feature or request
+  color: a2eeef
+
+- name: github structure
+  description: Pull requests that update Github actions/workflow code
+  color: "000000"
+
+- name: good first issue
+  description: Good for newcomers
+  color: 7057ff
+
+- name: help wanted
+  description: Extra attention is needed
+  color: 008672
+
+- name: invalid
+  description: This doesn't seem right
+  color: e4e669
+
+# major/minor/patch describe the dependency's version jump on Dependabot PRs.
+# They do not affect this project's version: release bumps are driven by the
+# "breaking" and "feature" labels, see release-drafter.yml.
+- name: major
+  description: Semver-major dependency update
+  color: 16970B
+
+- name: minor
+  description: Semver-minor dependency update
+  color: 16970B
+
+- name: patch
+  description: Semver-patch dependency update
+  color: 16970B
+
+- name: performance
+  description: Performance
+  color: "016175"
+
+# Leaves a pull request out of the release notes
+- name: skip-release
+  description: Skip release
+  color: "000000"
+
+- name: question
+  description: Further information is requested
+  color: d876e3
+
+- name: refactoring
+  description: Refactoring
+  color: ef67c4
+
+- name: removal
+  description: Removals and Deprecations
+  color: 9ae7ea
+
+- name: test
+  description: Changing tests
+  color: b1fc6f
+
+- name: wontfix
+  description: This will not be worked on
+  color: ffffff

ghome_local_api-0.1.0/.github/release-drafter.yml

@@ -0,0 +1,55 @@
+name-template: "v$RESOLVED_VERSION"
+tag-template: "v$RESOLVED_VERSION"
+categories:
+  # PRs with this label are left out of the release notes entirely.
+  - type: "pre-exclude"
+    when:
+      label: "skip-release"
+  # major/minor/patch labels are intentionally not used for version
+  # resolution: Dependabot applies them to describe the dependency's own
+  # version jump, which says nothing about this package.
+  - type: "version-resolver"
+    semver-increment: "major"
+    when:
+      label: "breaking"
+  - type: "version-resolver"
+    semver-increment: "minor"
+    when:
+      label: "feature"
+  # Keep this above the other headings: exclusive stops later headings from
+  # matching, so a breaking PR is listed only here, even with other labels.
+  - title: "💥 Breaking Changes"
+    exclusive: true
+    when:
+      label: "breaking"
+  - title: "🚀 Features"
+    when:
+      labels:
+        - "feature"
+        - "performance"
+  - title: "🐛 Bug Fixes"
+    when:
+      label: "bug"
+  - title: "📄 Documentation"
+    when:
+      label: "documentation"
+  - title: "🔧 Internal structure enhancement"
+    when:
+      labels:
+        - "github structure"
+        - "refactoring"
+        - "removal"
+  - title: "🧰 Maintenance"
+    when:
+      label: "test"
+  - title: "🧱 Dependency Updates"
+    when:
+      label: "dependencies"
+change-template: "- $TITLE @$AUTHOR (#$NUMBER)"
+change-title-escapes: '\<*_&' # You can add # and @ to disable mentions, and add ` to disable code blocks.
+version-resolver:
+  default: patch
+template: |
+  ## Changes
+
+  $CHANGES

ghome_local_api-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,111 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  checks:
+    name: Checks
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.14"]
+      fail-fast: false
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    permissions:
+      contents: read
+      id-token: write # The Codecov upload authenticates with GitHub OIDC
+    steps:
+      - name: Check out the repository
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - name: Prepare and install deps
+        uses: ./.github/actions/install-deps
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      # Hook environments (prek) and formatter plugins (dprint) are
+      # downloaded on first use; both only change with their config files.
+      - name: Cache prek hooks and dprint plugins
+        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
+        with:
+          path: |
+            ~/.cache/prek/
+            ~/.cache/dprint/
+          key: >
+            ${{ format('prek-{0}-{1}',
+            matrix.python-version,
+            hashFiles('.pre-commit-config.yaml', 'dprint.json')
+            ) }}
+          restore-keys: |
+            prek-${{ matrix.python-version }}-
+
+      - name: Run prek on all files
+        run: |
+          uvx prek run --all-files --show-diff-on-failure --color=always
+
+      - name: Run python-typing-update
+        run: |
+          uvx prek run --hook-stage manual python-typing-update --all-files --show-diff-on-failure --color=always
+
+      # The runtime floor follows Home Assistant's pin, so test it too. The
+      # test header shows the aiohttp version that was resolved.
+      - name: Run tests with the lowest allowed dependencies
+        run: |
+          uv run --isolated --resolution lowest-direct pytest --cov-report=xml
+
+      # Codecov merges the reports from both Python versions; after_n_builds
+      # in codecov.yml must match their number. With OIDC the repository needs
+      # no Codecov token secret. Pull requests from forks get no OIDC token and
+      # upload without one, which Codecov accepts for public repositories.
+      - name: Upload coverage to Codecov
+        # A failed upload leaves Codecov's report out of date and the commit
+        # without Codecov's statuses or an updated comment, but doesn't fail
+        # the checks.
+        continue-on-error: true
+        uses: codecov/codecov-action@303a32d7a59b442fa8d48b6a1cc6825c09c847a5 # v7.1.1
+        with:
+          name: Python ${{ matrix.python-version }}
+          files: coverage.xml
+          disable_search: true
+          use_oidc: true
+          # Without this, an uploader that fails its signature check still runs.
+          fail_ci_if_error: true
+          # Download the uploader outside the checkout, so the sdist built
+          # below doesn't pick it up.
+          cleanup: true
+
+      - name: Build the package
+        run: uv build
+
+      # Install the wheel into a new environment and import it with -I, so the
+      # source tree can't stand in for it. This catches a wrong package path, a
+      # missing typing marker or copyright notice and unexpected runtime
+      # dependencies.
+      - name: Check the built wheel
+        run: |
+          uv run --isolated --no-project --with dist/*.whl python -I -c '
+          import pathlib
+          import sys
+          from importlib import metadata
+
+          import ghome_local_api
+
+          dist = metadata.distribution("ghome-local-api")
+          assert pathlib.Path(ghome_local_api.__file__) == dist.locate_file("ghome_local_api/__init__.py")
+          assert "ghome_local_api/py.typed" in {str(path) for path in dist.files or ()}
+          assert dist.requires == ["aiohttp>=3.14.4"], dist.requires
+          assert dist.metadata["Requires-Python"] == ">=3.12"
+          license_text = dist.read_text("licenses/LICENSE") or ""
+          for notice in ("Copyright (c) 2020 Ilja Leiko", "Copyright (c) 2026 Ruslan Sayfutdinov"):
+              assert notice in license_text, notice
+          print(f"ghome-local-api {dist.version} on Python {sys.version}")
+          '

ghome_local_api-0.1.0/.github/workflows/labeler.yml

@@ -0,0 +1,22 @@
+name: Labeler
+
+on:
+  pull_request_target:
+    branches:
+      - main
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  triage:
+    name: Triage
+    if: github.repository_owner == 'KapJI'
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      - name: Run Pull Request Labeler
+        uses: actions/labeler@bf12e9b00b37c5c0ca2b87b79b2daf7891dbda13 # v7.0.0
+        with:
+          repo-token: "${{ secrets.GITHUB_TOKEN }}"

ghome_local_api-0.1.0/.github/workflows/manage-labels.yml

@@ -0,0 +1,25 @@
+name: Manage labels
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+  issues: write
+
+jobs:
+  labeler:
+    name: Update labels
+    if: github.repository_owner == 'KapJI'
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      - name: Check out the repository
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - name: Run Labeler
+        uses: crazy-max/ghaction-github-labeler@548a7c3603594ec17c819e1239f281a3b801ab4d # v6.0.0

ghome_local_api-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,68 @@
+# Publishing a GitHub release runs this workflow. It builds the wheel and sdist
+# once, then uploads exactly those files to PyPI through trusted publishing:
+# PyPI accepts the upload job's short-lived GitHub OIDC token, so the
+# repository keeps no PyPI token. The upload needs a PyPI trusted publisher for
+# this workflow file and the `release` environment, and it waits for that
+# environment's required reviewer.
+name: Publish
+
+concurrency: release
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+env:
+  PYTHON_VERSION: "3.14"
+
+jobs:
+  build:
+    name: Build
+    if: github.repository_owner == 'KapJI'
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - name: Check out the repository
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - name: Prepare and install deps
+        uses: ./.github/actions/install-deps
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+
+      - name: Build package
+        run: uv build
+
+      - name: Store the built files
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+        with:
+          name: dist
+          path: dist/
+          if-no-files-found: error
+
+  # Only this job can get an OIDC token, and it runs no code from the
+  # repository: it uploads the files that the build job stored.
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    environment: release
+    permissions:
+      id-token: write # Trusted publishing and PEP 740 attestations use GitHub OIDC tokens
+    steps:
+      - name: Download the built files
+        uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
+        with:
+          name: dist
+          path: dist/
+
+      # Unlike `uv publish`, the action also creates PEP 740 attestations,
+      # which PyPI shows as verified provenance for each file.
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086 # v1.14.3

ghome_local_api-0.1.0/.github/workflows/release-drafter.yml

@@ -0,0 +1,22 @@
+name: Draft a release note
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+  pull-requests: read
+
+jobs:
+  draft_release:
+    name: Release Drafter
+    if: github.repository_owner == 'KapJI'
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      - name: Run release-drafter
+        uses: release-drafter/release-drafter@978bb0b30c5ee8cdd332ced253758157150d43f0 # v7.10.0
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

ghome_local_api-0.1.0/.github/zizmor.yml

@@ -0,0 +1,4 @@
+rules:
+  # `./` paths to local actions are the long-standing form; keep them.
+  self-repository:
+    disable: true

ghome_local_api-0.1.0/.gitignore

@@ -0,0 +1,17 @@
+__pycache__/
+.tox/
+.DS_Store
+.env
+/.idea/
+*.pyc
+.ipynb_checkpoints
+.pytest_cache
+*.egg-info
+/build/
+/dist/
+/.venv/
+.mypy_cache/
+.ruff_cache/
+.coverage
+coverage.xml
+/AGENTS.md

ghome_local_api-0.1.0/.kodiak.toml

@@ -0,0 +1,11 @@
+version = 1
+
+[approve]
+auto_approve_usernames = ["dependabot"]
+
+[merge]
+method = "squash"
+
+[merge.automerge_dependencies]
+versions = ["minor", "patch"]
+usernames = ["dependabot"]

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

@@ -0,0 +1,80 @@
+default_stages: [pre-commit]
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: check-added-large-files
+      - id: check-case-conflict
+      - id: check-json
+      - id: check-merge-conflict
+      - id: check-toml
+      - id: check-yaml
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
+  - repo: https://github.com/python-jsonschema/check-jsonschema
+    rev: 0.39.0
+    hooks:
+      - id: check-dependabot
+      - id: check-github-actions
+      - id: check-github-workflows
+  - repo: https://github.com/zizmorcore/zizmor-pre-commit
+    rev: v1.31.1
+    hooks:
+      - id: zizmor
+  - repo: local
+    hooks:
+      - id: dprint
+        name: dprint format
+        entry: uv run dprint fmt
+        language: system
+        pass_filenames: false
+        types_or: [json, markdown, toml, yaml]
+      - id: ruff-format
+        name: ruff format
+        entry: uv run ruff format
+        language: system
+        types: [python]
+        require_serial: true
+      - id: ruff
+        name: ruff check
+        entry: uv run ruff check --fix
+        language: system
+        types: [python]
+        require_serial: true
+      - id: mypy
+        name: mypy
+        entry: uv run mypy
+        language: system
+        types: [python]
+        require_serial: true
+      - id: pylint
+        name: pylint
+        entry: uv run pylint
+        language: system
+        types: [python]
+        require_serial: true
+      - id: pytest
+        name: pytest
+        language: system
+        entry: uv run pytest
+        pass_filenames: false
+        always_run: true
+      - id: codespell
+        name: codespell
+        entry: uv run codespell
+        language: system
+        pass_filenames: false
+        always_run: true
+  - repo: https://github.com/cdce8p/python-typing-update
+    rev: v0.9.0
+    hooks:
+      # Run `python-typing-update` hook manually from time to time
+      # to update python typing syntax.
+      # Will require manual work, before submitting changes!
+      - id: python-typing-update
+        stages: [manual]
+        args:
+          - --py312-plus
+          - --force
+          - --keep-updates
+        files: ^.+\.py$