python-rako-2025 0.3.11__tar.gz → 0.4.0__tar.gz

python_rako_2025-0.4.0/.claude/settings.local.json

@@ -0,0 +1,13 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(find:*)",
+      "Bash(ruff check:*)",
+      "mcp__ide__getDiagnostics",
+      "WebFetch(domain:docs.python.org)",
+      "Bash(python -m pytest tests/ -v)",
+      "Bash(pytest:*)"
+    ],
+    "deny": []
+  }
+}

python_rako_2025-0.4.0/.coveragerc

@@ -0,0 +1,22 @@
+[run]
+source = python_rako
+omit =
+    python_rako/__init__.py
+    python_rako/bridge.py
+
+
+[report]
+# Regexes for lines to exclude from consideration
+exclude_lines =
+    # Have to re-enable the standard pragma
+    pragma: no cover
+
+    # Don't complain about missing debug-only code:
+    def __repr__
+
+    # Don't complain if tests don't hit defensive assertion code:
+    raise AssertionError
+    raise NotImplementedError
+
+    # TYPE_CHECKING block is never executed during pytest run
+    if TYPE_CHECKING:

python_rako_2025-0.4.0/.editorconfig

@@ -0,0 +1,22 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+insert_final_newline = true
+trim_trailing_whitespace = true
+ident_size = 4
+
+[*.md]
+ident_size = 2
+trim_trailing_whitespace = false
+
+[*.json]
+ident_size = 2
+
+[{.gitignore,.gitkeep,.editorconfig}]
+ident_size = 2
+
+[Makefile]
+ident_style = tab

python_rako_2025-0.4.0/.flake8

@@ -0,0 +1,3 @@
+[flake8]
+max-line-length=88
+ignore=D100,D101,D102,D103,D104,D105,D106,D107,D400,D202,E203,E501,W503

python_rako_2025-0.4.0/.gitattributes

@@ -0,0 +1,2 @@
+*     text eol=lf
+*.py  whitespace=error

python_rako_2025-0.4.0/.github/dependabot.yml

@@ -0,0 +1,15 @@
+---
+version: 2
+updates:
+  - package-ecosystem: pip
+    directory: "/"
+    schedule:
+      interval: daily
+      time: "06:00"
+    open-pull-requests-limit: 10
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: daily
+      time: "06:00"
+    open-pull-requests-limit: 10

python_rako_2025-0.4.0/.github/workflows/ci.yml

@@ -0,0 +1,54 @@
+---
+name: Continuous Integration
+
+on: [push, pull_request]
+
+jobs:
+  linting:
+    name: Linting
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checking out code from GitHub
+        uses: actions/checkout@v4
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install .[dev]
+          pip list
+      - name: Run pre-commit on all files
+        run: |
+          pre-commit run --all-files --show-diff-on-failure
+
+  test:
+    name: Python ${{ matrix.python }} on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}-latest
+    strategy:
+      matrix:
+        os: [ubuntu]
+        python: ["3.12", "3.13"]
+    steps:
+      - name: Checking out code from GitHub
+        uses: actions/checkout@v4
+      - name: Set up Python ${{ matrix.python }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install .[test]
+          pip list
+      - name: Run tests with coverage
+        run: python -m pytest
+      - name: Upload coverage to Codecov
+        if: matrix.python == '3.12' && matrix.os == 'ubuntu'
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          file: ./coverage.xml
+          flags: unittests
+          name: codecov-umbrella

python_rako_2025-0.4.0/.github/workflows/release.yml

@@ -0,0 +1,50 @@
+---
+name: PyPi Release
+
+# https://help.github.com/en/actions/reference/events-that-trigger-workflows
+on:
+  release:
+    types:
+      - created
+
+# based on https://github.com/pypa/gh-action-pypi-publish
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checking out code from GitHub
+        uses: actions/checkout@v4
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v4
+        with:
+          python-version: 3.12
+      - name: generate version file
+        run: |
+          echo "$RELEASE_TAG" > python_rako/__version__.py
+          cat python_rako/__version__.py
+        env:
+          RELEASE_TAG: ${{ github.event.release.tag_name }}
+      - name: Install dependencies
+        run: |
+          python -m pip install --user --upgrade pip setuptools wheel build
+      - name: Build
+        run: >-
+          python -m build
+
+      # TEST
+      - name: Publish to Test PyPI
+        if: startsWith(github.event.ref, 'refs/tags') || github.event_name == 'release'
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          user: __token__
+          password: ${{ secrets.TEST_PYPI_TOKEN }}
+          repository_url: https://test.pypi.org/legacy/
+
+      # PROD
+      - name: Publish distribution 📦 to PyPI
+        if: startsWith(github.event.ref, 'refs/tags') || github.event_name == 'release'
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          user: __token__
+          password: ${{ secrets.PYPI_TOKEN }}

python_rako_2025-0.4.0/.gitignore

@@ -0,0 +1,140 @@
+config/*
+config2/*
+
+tests/testing_config/deps
+tests/testing_config/home-assistant.log
+
+# hass-release
+data/
+.token
+
+# Hide sublime text stuff
+*.sublime-project
+*.sublime-workspace
+
+# Hide some OS X stuff
+.DS_Store
+.AppleDouble
+.LSOverride
+Icon
+
+# Thumbnails
+._*
+
+# IntelliJ IDEA
+.idea
+*.iml
+
+# pytest
+.pytest_cache
+.cache
+
+# GITHUB Proposed Python stuff:
+*.py[cod]
+
+# C extensions
+*.so
+
+# Packages
+*.egg
+*.egg-info
+dist
+build
+eggs
+.eggs
+parts
+bin
+var
+sdist
+develop-eggs
+.installed.cfg
+lib
+lib64
+pip-wheel-metadata
+
+# Logs
+*.log
+pip-log.txt
+
+# Unit test / coverage reports
+.coverage
+.tox
+coverage.xml
+nosetests.xml
+htmlcov/
+test-reports/
+test-results.xml
+test-output.xml
+
+# Translations
+*.mo
+
+# Mr Developer
+.mr.developer.cfg
+.project
+.pydevproject
+
+.python-version
+
+# emacs auto backups
+*~
+*#
+*.orig
+
+# venv stuff
+pyvenv.cfg
+pip-selfcheck.json
+venv
+.venv
+Pipfile*
+share/*
+/Scripts/
+
+# vimmy stuff
+*.swp
+*.swo
+tags
+ctags.tmp
+
+# vagrant stuff
+virtualization/vagrant/setup_done
+virtualization/vagrant/.vagrant
+virtualization/vagrant/config
+
+# Visual Studio Code
+.vscode/*
+!.vscode/cSpell.json
+!.vscode/extensions.json
+!.vscode/tasks.json
+.env
+
+# Built docs
+docs/build
+
+# Windows Explorer
+desktop.ini
+/home-assistant.pyproj
+/home-assistant.sln
+/.vs/*
+
+# mypy
+/.mypy_cache/*
+/.dmypy.json
+
+# Secrets
+.lokalise_token
+
+# monkeytype
+monkeytype.sqlite3
+
+# This is left behind by Azure Restore Cache
+tmp_cache
+
+# python-language-server / Rope
+.ropeproject
+
+.idea
+*.iml
+examples/test_xml.py
+cov.xml
+tests/sample_rako.xml

python_rako_2025-0.4.0/.isort.cfg

@@ -0,0 +1,3 @@
+[settings]
+profile=black
+src_paths=python_rako,tests

python_rako_2025-0.4.0/.pre-commit-config.yaml

@@ -0,0 +1,35 @@
+---
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.1.15
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-merge-conflict
+      - id: debug-statements
+      - id: check-docstring-first
+      - id: check-json
+      - id: check-yaml
+      - id: check-byte-order-marker
+      - id: check-case-conflict
+      - id: check-executables-have-shebangs
+      - id: check-ast
+      - id: detect-private-key
+      - id: forbid-new-submodules
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.16.1
+    hooks:
+      - id: mypy
+        files: ^python_rako/.+\.py$
+        exclude: ^python_rako/__version__\.py$
+        additional_dependencies: [types-requests]
+  - repo: https://github.com/adrienverge/yamllint.git
+    rev: v1.37.1
+    hooks:
+      - id: yamllint

python_rako_2025-0.4.0/.yamllint

@@ -0,0 +1,63 @@
+---
+rules:
+  braces:
+    level: error
+    min-spaces-inside: 0
+    max-spaces-inside: 1
+    min-spaces-inside-empty: -1
+    max-spaces-inside-empty: -1
+  brackets:
+    level: error
+    min-spaces-inside: 0
+    max-spaces-inside: 0
+    min-spaces-inside-empty: -1
+    max-spaces-inside-empty: -1
+  colons:
+    level: error
+    max-spaces-before: 0
+    max-spaces-after: 1
+  commas:
+    level: error
+    max-spaces-before: 0
+    min-spaces-after: 1
+    max-spaces-after: 1
+  comments:
+    level: error
+    require-starting-space: true
+    min-spaces-from-content: 2
+  comments-indentation:
+    level: error
+  document-end:
+    level: error
+    present: false
+  document-start:
+    level: error
+    present: true
+  empty-lines:
+    level: error
+    max: 1
+    max-start: 0
+    max-end: 1
+  hyphens:
+    level: error
+    max-spaces-after: 1
+  indentation:
+    level: error
+    spaces: 2
+    indent-sequences: true
+    check-multi-line-strings: false
+  key-duplicates:
+    level: error
+  line-length:
+    level: warning
+    max: 120
+    allow-non-breakable-words: true
+    allow-non-breakable-inline-mappings: true
+  new-line-at-end-of-file:
+    level: error
+  new-lines:
+    level: error
+    type: unix
+  trailing-spaces:
+    level: error
+  truthy: disable

python_rako_2025-0.4.0/Makefile

@@ -0,0 +1,124 @@
+.DEFAULT_GOAL := help
+export VENV := $(abspath venv)
+export PATH := ${VENV}/bin:${PATH}
+
+define BROWSER_PYSCRIPT
+import os, webbrowser, sys
+
+try:
+	from urllib import pathname2url
+except:
+	from urllib.request import pathname2url
+
+webbrowser.open("file://" + pathname2url(os.path.abspath(sys.argv[1])))
+endef
+export BROWSER_PYSCRIPT
+
+BROWSER := python -c "$$BROWSER_PYSCRIPT"
+
+.PHONY: help
+help: ## Shows this message.
+	@echo "Asynchronous Python client for Rako Controls."; \
+	echo; \
+	echo "Usage:"; \
+	awk -F ':|##' '/^[^\t].+?:.*?##/ {\
+		printf "\033[36m  make %-30s\033[0m %s\n", $$1, $$NF \
+	}' $(MAKEFILE_LIST)
+
+.PHONY: dev
+dev: install-dev install ## Set up a development environment.
+
+.PHONY: lint
+lint: ## Run Ruff linting and formatting checks.
+	python -m ruff check
+	python -m ruff format --check
+
+.PHONY: format
+format: ## Format code with Ruff.
+	python -m ruff format
+	python -m ruff check --fix
+
+.PHONY: typecheck
+typecheck: ## Run type checking with MyPy.
+	python -m mypy python_rako/
+
+.PHONY: check
+check: lint typecheck ## Run all checks (linting, formatting, and type checking).
+
+.PHONY: test
+test: ## Run tests quickly with the default Python.
+	pytest --cov-report html --cov-report term --cov-report xml:cov.xml --cov=python_rako .;
+
+.PHONY: coverage
+coverage: test ## Check code coverage quickly with the default Python.
+	$(BROWSER) htmlcov/index.html
+
+.PHONY: install
+install: clean ## Install the package to the active Python's site-packages.
+	pip install -Ur requirements.txt; \
+	pip install -e .;
+
+.PHONY: clean clean-all
+clean: clean-build clean-pyc clean-test ## Removes build, test, coverage and Python artifacts.
+clean-all: clean-build clean-pyc clean-test clean-venv ## Removes all venv, build, test, coverage and Python artifacts.
+
+.PHONY: clean-build
+clean-build: ## Removes build artifacts.
+	rm -fr build/; \
+	rm -fr dist/; \
+	rm -fr .eggs/; \
+	find . -name '*.egg-info' -exec rm -fr {} +; \
+	find . -name '*.egg' -exec rm -fr {} +;
+
+.PHONY: clean-pyc
+clean-pyc: ## Removes Python file artifacts.
+	find . -name '*.pyc' -delete; \
+	find . -name '*.pyo' -delete; \
+	find . -name '*~' -delete; \
+	find . -name '__pycache__' -exec rm -fr {} +;
+
+.PHONY: clean-test
+clean-test: ## Removes test and coverage artifacts.
+	rm -f .coverage; \
+	rm -fr htmlcov/; \
+	rm -fr .pytest_cache;
+
+.PHONY: clean-venv
+clean-venv: ## Removes Python virtual environment artifacts.
+	rm -fr venv/;
+
+.PHONY: dist
+dist: clean ## Builds source and wheel package.
+	python -m build; \
+	ls -l dist;
+
+.PHONY: release
+release:  ## Release build on PyP
+	twine upload dist/*
+
+.PHONY: venv
+venv: clean-venv ## Create Python venv environment.
+	python3 -m venv venv;
+
+.PHONY: install-dev
+install-dev: clean
+	pip install -Ur requirements_dev.txt; \
+	pre-commit install;
+
+.PHONY: bump-patch
+bump-patch: ## Bump patch version (x.y.Z) and commit
+	@python -c "import re; content = open('python_rako/__version__.py').read().strip(); match = re.search(r'(\d+)\.(\d+)\.(\d+)', content); major, minor, patch = match.groups(); new_version = f'{major}.{minor}.{int(patch) + 1}'; open('python_rako/__version__.py', 'w').write(f'__version__ = \"{new_version}\"\n'); print(f'Bumped version to {new_version}')"
+	@git add python_rako/__version__.py
+	@git commit -m "Bump version to $$(python -c "import re; content = open('python_rako/__version__.py').read(); match = re.search(r'\"([^\"]+)\"', content); print(match.group(1))")"
+
+.PHONY: bump-minor
+bump-minor: ## Bump minor version (x.Y.z) and commit
+	@python -c "import re; content = open('python_rako/__version__.py').read().strip(); match = re.search(r'(\d+)\.(\d+)\.(\d+)', content); major, minor, patch = match.groups(); new_version = f'{major}.{int(minor) + 1}.0'; open('python_rako/__version__.py', 'w').write(f'__version__ = \"{new_version}\"\n'); print(f'Bumped version to {new_version}')"
+	@git add python_rako/__version__.py
+	@git commit -m "Bump version to $$(python -c "import re; content = open('python_rako/__version__.py').read(); match = re.search(r'\"([^\"]+)\"', content); print(match.group(1))")"
+
+.PHONY: bump-major
+bump-major: ## Bump major version (X.y.z) and commit
+	@python -c "import re; content = open('python_rako/__version__.py').read().strip(); match = re.search(r'(\d+)\.(\d+)\.(\d+)', content); major, minor, patch = match.groups(); new_version = f'{int(major) + 1}.0.0'; open('python_rako/__version__.py', 'w').write(f'__version__ = \"{new_version}\"\n'); print(f'Bumped version to {new_version}')"
+	@git add python_rako/__version__.py
+	@git commit -m "Bump version to $$(python -c "import re; content = open('python_rako/__version__.py').read(); match = re.search(r'\"([^\"]+)\"', content); print(match.group(1))")"

{python_rako_2025-0.3.11/python_rako_2025.egg-info → python_rako_2025-0.4.0}/PKG-INFO

@@ -1,31 +1,41 @@
 Metadata-Version: 2.4
 Name: python-rako-2025
-Version: 0.3.11
+Version: 0.4.0
 Summary: Asynchronous Python client for Rako Controls Lighting
-Author-email: Simon Leigh <simonleigh@users.noreply.github.com>
 Project-URL: Homepage, https://github.com/simonleigh/python-rako
 Project-URL: Repository, https://github.com/simonleigh/python-rako
 Project-URL: Issues, https://github.com/simonleigh/python-rako/issues
-Keywords: rako,controls,api,async,client
+Author-email: Simon Leigh <simonleigh@users.noreply.github.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: api,async,automation,client,controls,lighting,rako
 Classifier: Development Status :: 4 - Beta
 Classifier: Framework :: AsyncIO
 Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
 Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Home Automation
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: aiohttp>=3.10.0
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Requires-Dist: aiohttp>=3.12.0
 Requires-Dist: asyncio-dgram>=2.2.0
-Requires-Dist: xmltodict>=0.13.0
-Dynamic: license-file
+Requires-Dist: xmltodict>=0.14.0
+Provides-Extra: dev
+Requires-Dist: hatch>=1.9.0; extra == 'dev'
+Requires-Dist: pre-commit>=3.6.0; extra == 'dev'
+Provides-Extra: test
+Requires-Dist: aresponses>=3.0.0; extra == 'test'
+Requires-Dist: coverage[toml]>=7.9.0; extra == 'test'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'test'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'test'
+Requires-Dist: pytest>=8.4.0; extra == 'test'
+Description-Content-Type: text/markdown
 
 # Python: Rako Controls API Client
 

python_rako_2025-0.4.0/catalog-info.yaml

@@ -0,0 +1,18 @@
+---
+apiVersion: backstage.io/v1alpha1
+kind: Component
+metadata:
+  name: python-rako
+  description: Asynchronous Python client for Rako Controls Lighting
+  annotations:
+    github.com/project-slug: 'marengaz/python-rako'
+  tags:
+    - python3
+    - async
+  links:
+    - url: https://www.home-assistant.io/integrations/rako/
+      title: Home Assistant Rako Integration
+spec:
+  type: library
+  lifecycle: production
+  owner: user:guest

python_rako_2025-0.4.0/conftest.py

@@ -0,0 +1,29 @@
+from pathlib import Path
+
+import pytest
+
+RESOURCES = Path(__file__).parent / "tests/resources"
+
+
+@pytest.fixture
+def rako_xml() -> str:
+    with (RESOURCES / "rako.xml").open() as f:
+        xml = f.read()
+
+    return xml
+
+
+@pytest.fixture
+def rako_xml2() -> str:
+    with (RESOURCES / "rako2.xml").open() as f:
+        xml = f.read()
+
+    return xml
+
+
+@pytest.fixture
+def rako_xml3() -> str:
+    with (RESOURCES / "rako3.xml").open() as f:
+        xml = f.read()
+
+    return xml