spgroup 1.0.3__tar.gz

spgroup-1.0.3/.gitattributes

@@ -0,0 +1,27 @@
+# Auto-detect text files and normalize line endings
+* text=auto
+
+# Python source
+*.py text diff=python
+
+# Markdown
+*.md text diff=markdown
+
+# YAML
+*.yml text
+*.yaml text
+
+# TOML
+*.toml text
+
+# JSON
+*.json text
+
+# Binary files — keep as-is
+*.png binary
+*.jpg binary
+*.ico binary
+*.apk binary
+*.keystore binary
+*.jar binary
+*.idsig binary

spgroup-1.0.3/.github/dependabot.yml

@@ -0,0 +1,19 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    open-pull-requests-limit: 5
+    labels:
+      - "dependencies"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    open-pull-requests-limit: 5
+    labels:
+      - "dependencies"

spgroup-1.0.3/.github/workflows/release.yml

@@ -0,0 +1,113 @@
+name: Publish spgroup to PyPI
+run-name: ${{ github.actor }} is publishing spgroup to PyPI
+
+on: [push]
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - name: Install build tools
+        run: |
+          python -m pip install build
+          python -m pip install -e . pytest
+      - name: Build a binary wheel and a source tarball
+        run: python -m build
+      - name: Verify wheel and sdist integrity
+        run: python -m pytest tests/test_sdk_packaging.py -v
+      - name: Store the distribution packages
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  publish-to-testpypi:
+    name: Publish to TestPyPI
+    if: github.ref_name == 'main' && !startsWith(github.ref, 'refs/tags/')
+    needs: [build]
+    runs-on: ubuntu-latest
+
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/spgroup
+
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download all the dists
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+      - name: Publish distribution to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+  publish-to-pypi:
+    name: Publish to PyPI
+    if: startsWith(github.ref, 'refs/tags/')
+    needs: [build]
+    runs-on: ubuntu-latest
+
+    environment:
+      name: pypi
+      url: https://pypi.org/p/spgroup
+
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download all the dists
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+      - name: Publish distribution to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  github-release:
+    name: Sign and upload to GitHub Release
+    if: startsWith(github.ref, 'refs/tags/')
+    needs: [publish-to-pypi]
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: write
+      id-token: write
+
+    steps:
+      - name: Download all the dists
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+      - name: Sign the dists with Sigstore
+        uses: sigstore/gh-action-sigstore-python@v2.1.1
+        with:
+          inputs: >-
+            ./dist/*.tar.gz
+            ./dist/*.whl
+      - name: Create GitHub Release
+        env:
+          GITHUB_TOKEN: ${{ github.token }}
+        run: >-
+          gh release create
+          '${{ github.ref_name }}'
+          --repo '${{ github.repository }}'
+          --notes ""
+      - name: Upload artifact signatures to GitHub Release
+        env:
+          GITHUB_TOKEN: ${{ github.token }}
+        run: >-
+          gh release upload
+          '${{ github.ref_name }}' dist/**
+          --repo '${{ github.repository }}'

spgroup-1.0.3/.github/workflows/semantic-release.yml

@@ -0,0 +1,37 @@
+name: Semantic Release
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    concurrency: release
+    permissions:
+      contents: write
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          # Use the PAT for checkout so git push triggers downstream workflows.
+          # GITHUB_TOKEN pushes are intentionally blocked from cascading.
+          token: ${{ secrets.SEMANTIC_RELEASE_TOKEN || secrets.GITHUB_TOKEN }}
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install python-semantic-release
+        run: python -m pip install python-semantic-release
+
+      - name: Run semantic release
+        env:
+          GH_TOKEN: ${{ secrets.SEMANTIC_RELEASE_TOKEN || secrets.GITHUB_TOKEN }}
+        run: |
+          git config user.name "semantic-release"
+          git config user.email "semantic-release"
+          semantic-release version
+          semantic-release publish

spgroup-1.0.3/.gitignore

@@ -0,0 +1,10 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.DS_Store
+node_modules/
+.runtime/
+.pytest_cache/
+prototype/

spgroup-1.0.3/.postman/resources.yaml

@@ -0,0 +1,7 @@
+workspace:
+  id: 030fd6da-c0cc-428e-8c68-0b63593aa702
+collections:
+  - path: postman/collections/energy-monitoring-api.json
+  - path: postman/collections/sp-mobile-api.json
+environments:
+  - path: postman/environments/local.json

spgroup-1.0.3/.pre-commit-config.yaml

@@ -0,0 +1,17 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.21
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: check-yaml
+      - id: check-toml
+      - id: check-added-large-files
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-merge-conflict

spgroup-1.0.3/AGENTS.md

@@ -0,0 +1,85 @@
+# spgroup SDK — Repository Guidelines
+
+Async Python SDK for SP Group mobile APIs, reverse-engineered from the
+Android app (v15.9.0). Published as `spgroup` on PyPI.
+
+Consumed by the HA integration in
+[energy-monitoring](../energy-monitoring/).
+
+---
+
+## Quick Start
+
+```bash
+git clone https://github.com/ashe0047/spgroup.git
+cd spgroup
+mise run python:install
+mise run python:test
+mise run python:lint
+```
+
+## Commands
+
+| Command | Purpose |
+|---|---|
+| `mise run python:install` | Editable install + pinned dev deps |
+| `mise run python:test` | Hermetic test suite (77 tests) |
+| `mise run python:test:e2e` | Opt-in live e2e tests (needs session) |
+| `mise run python:lint` | Ruff check + mypy |
+| `mise run python:build` | Build wheel + sdist |
+| `mise run python:publish:testpypi` | Upload to TestPyPI via twine |
+| `mise run python:publish` | Upload to production PyPI via twine |
+
+---
+
+## Key Docs
+
+| Doc | What it covers |
+|---|---|
+| [`docs/dev-workflow.md`](docs/dev-workflow.md) | Full dev-to-release process: setup, test strategy, CI/CD pipeline, environment gating, publishing, troubleshooting |
+| [`docs/sdk-parity-roadmap.md`](docs/sdk-parity-roadmap.md) | SDK coverage plan, APK parity milestones |
+| [`docs/context-tracker.md`](docs/context-tracker.md) | Decision log and discovery trail |
+| [`docs/api/`](docs/api/) | Reverse-engineered API reference |
+| [`.github/workflows/release.yml`](.github/workflows/release.yml) | CI/CD pipeline (4 jobs: Build, TestPyPI, PyPI, GitHub Release) |
+
+## Publishing
+
+**CI/CD (recommended):** Push a `vX.Y.Z` tag. The pipeline publishes via
+Trusted Publishing (OIDC) — no tokens needed. See
+[docs/dev-workflow.md](docs/dev-workflow.md) for the full walkthrough.
+
+**Local:** `mise run python:build` → `mise run python:publish:testpypi` →
+verify → `mise run python:publish`. Never run `twine upload` directly without
+first confirming via TestPyPI.
+
+## Project Structure
+
+| Path | Contents |
+|---|---|
+| `src/spgroup/` | SDK source (17 files, public API in `__init__.py`) |
+| `tests/` | Hermetic tests (3 test files) |
+| `tests/e2e/` | Opt-in live tests (9 tests, skipped by default) |
+| `docs/` | API reference, roadmaps, dev workflow guide |
+| `postman/` | Postman collections + environment |
+| `prototype/` | TypeScript harness (local only, not tracked) |
+
+## Conventions
+
+- Use `python`, not `python3`, when invoking Python directly.
+- All source files use `from __future__ import annotations`.
+- Follow [Conventional Commits](https://www.conventionalcommits.org/) for all
+  commit messages. See [`docs/dev-workflow.md`](docs/dev-workflow.md) for the
+  full type reference.
+- Do not hardcode credentials — use `transport.redact_json()` for safe output.
+- New sensitive response fields go in `SENSITIVE_KEYS` in
+  `src/spgroup/mobile/transport.py`.
+- Hermetic tests go in `tests/`, e2e tests in `tests/e2e/`.
+- Packaging changes require updating `tests/test_sdk_packaging.py`.
+- Pushing to `main` triggers automatic version bumping via
+  `python-semantic-release`. No manual tag creation is needed for releases.
+
+## Agent Instructions
+
+Append discoveries and decisions to `docs/context-tracker.md`. For detailed
+development workflow, CI/CD pipeline layout, and release steps, refer to
+`docs/dev-workflow.md`.

spgroup-1.0.3/CHANGELOG.md

@@ -0,0 +1,58 @@
+# CHANGELOG
+
+<!-- version list -->
+
+## v1.0.3 (2026-07-18)
+
+### Bug Fixes
+
+- Pass PAT as checkout token so git push triggers downstream workflows
+  ([`2b04bab`](https://github.com/ashe0047/spgroup/commit/2b04bab8dc2a7f0cc6a9ea893714ebb1ada323a0))
+
+
+## v1.0.2 (2026-07-18)
+
+### Bug Fixes
+
+- Verify PAT cascade for release pipeline
+  ([`90c4c05`](https://github.com/ashe0047/spgroup/commit/90c4c0501d76b2b1f65ef7f6b351c7dcec24cb46))
+
+
+## v1.0.1 (2026-07-18)
+
+### Bug Fixes
+
+- Correct version_variables format for semantic-release (needs :__version__)
+  ([`51e8b5b`](https://github.com/ashe0047/spgroup/commit/51e8b5b47cc84fce18ed93fc8a4e408a9ce9bcee))
+
+- Trigger full CI pipeline verify with PAT cascade
+  ([`579117a`](https://github.com/ashe0047/spgroup/commit/579117a4b2247e9e9ae1f44c5772a43b698b0ae9))
+
+### Chores
+
+- Add __version__, .gitattributes, fix lint issues, configure semantic-release version management
+  ([`0ade9c4`](https://github.com/ashe0047/spgroup/commit/0ade9c42c95be7cded641fa71433e05d5f4ddf48))
+
+- Add pre-commit hooks, dependabot config, register live pytest marker, document in dev-workflow
+  ([`8256df1`](https://github.com/ashe0047/spgroup/commit/8256df19ae7ff702a7ddb731c258af1866b525ef))
+
+- Remove root resources.yaml (duplicate of .postman/resources.yaml)
+  ([`1a16cbd`](https://github.com/ashe0047/spgroup/commit/1a16cbd733643410cedf698a9f55e2ea4dd416b7))
+
+### Documentation
+
+- Document devN pre-release versions in version management and TestPyPI sections
+  ([`c003c7b`](https://github.com/ashe0047/spgroup/commit/c003c7bf04f474e3d1dae7706a273a9e7e18a621))
+
+
+## v1.0.0 (2026-07-18)
+
+### Features
+
+- **ci**: Setup conventional commits and python-semantic-release for automatic version bumping
+  ([`b627880`](https://github.com/ashe0047/spgroup/commit/b627880f67ef3e89c0d124ec285b523b5ba1fa25))
+
+
+## v0.1.0 (2026-07-17)
+
+- Initial Release

spgroup-1.0.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Aw Sheng Xiang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

spgroup-1.0.3/MANIFEST.in

@@ -0,0 +1,2 @@
+exclude tests
+recursive-exclude tests *

spgroup-1.0.3/PKG-INFO

@@ -0,0 +1,52 @@
+Metadata-Version: 2.4
+Name: spgroup
+Version: 1.0.3
+Summary: Async Python SDK scaffold for SP Group APIs
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ashe0047/spgroup
+Project-URL: Source, https://github.com/ashe0047/spgroup
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.9
+Dynamic: license-file
+
+# spgroup
+
+Async Python SDK for SP Group (Singapore Power) utility APIs.
+
+Reverse-engineered from the SP Group Android mobile app (v15.9.0).
+
+## Installation
+
+```bash
+pip install spgroup
+```
+
+## Quick Start
+
+```python
+import asyncio
+from spgroup import MobileAuthClient, JarvisClient
+
+async def main():
+    auth = MobileAuthClient(session=None)
+    print(f"Client ID: {auth._client_id}")
+
+asyncio.run(main())
+```
+
+## Documentation
+
+API reference and usage guides are available on
+[GitHub](https://github.com/ashe0047/spgroup).
+
+For developers working on the SDK: see `docs/`, `prototype/`, and `postman/`
+in the [GitHub repository](https://github.com/ashe0047/spgroup).
+
+## License
+
+MIT

spgroup-1.0.3/README.md

@@ -0,0 +1,36 @@
+# spgroup
+
+Async Python SDK for SP Group (Singapore Power) utility APIs.
+
+Reverse-engineered from the SP Group Android mobile app (v15.9.0).
+
+## Installation
+
+```bash
+pip install spgroup
+```
+
+## Quick Start
+
+```python
+import asyncio
+from spgroup import MobileAuthClient, JarvisClient
+
+async def main():
+    auth = MobileAuthClient(session=None)
+    print(f"Client ID: {auth._client_id}")
+
+asyncio.run(main())
+```
+
+## Documentation
+
+API reference and usage guides are available on
+[GitHub](https://github.com/ashe0047/spgroup).
+
+For developers working on the SDK: see `docs/`, `prototype/`, and `postman/`
+in the [GitHub repository](https://github.com/ashe0047/spgroup).
+
+## License
+
+MIT