aiocontrome 0.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (83) hide show
  1. aiocontrome-0.1.0/.gitignore +15 -0
  2. aiocontrome-0.1.0/CHANGELOG.md +38 -0
  3. aiocontrome-0.1.0/LICENSE +674 -0
  4. aiocontrome-0.1.0/PKG-INFO +98 -0
  5. aiocontrome-0.1.0/README.md +76 -0
  6. aiocontrome-0.1.0/pyproject.toml +49 -0
  7. aiocontrome-0.1.0/src/aiocontrome/__init__.py +86 -0
  8. aiocontrome-0.1.0/src/aiocontrome/client.py +386 -0
  9. aiocontrome-0.1.0/src/aiocontrome/errors.py +56 -0
  10. aiocontrome-0.1.0/src/aiocontrome/models.py +365 -0
  11. aiocontrome-0.1.0/src/aiocontrome/outputs.py +42 -0
  12. aiocontrome-0.1.0/src/aiocontrome/parsers/__init__.py +21 -0
  13. aiocontrome-0.1.0/src/aiocontrome/parsers/_common.py +137 -0
  14. aiocontrome-0.1.0/src/aiocontrome/parsers/fps.py +96 -0
  15. aiocontrome-0.1.0/src/aiocontrome/parsers/info.py +29 -0
  16. aiocontrome-0.1.0/src/aiocontrome/parsers/outs.py +43 -0
  17. aiocontrome-0.1.0/src/aiocontrome/parsers/passthrough.py +28 -0
  18. aiocontrome-0.1.0/src/aiocontrome/parsers/rltemps.py +29 -0
  19. aiocontrome-0.1.0/src/aiocontrome/parsers/room_details.py +135 -0
  20. aiocontrome-0.1.0/src/aiocontrome/parsers/temps.py +92 -0
  21. aiocontrome-0.1.0/src/aiocontrome/parsers/upcoming_offsets.py +57 -0
  22. aiocontrome-0.1.0/src/aiocontrome/py.typed +0 -0
  23. aiocontrome-0.1.0/src/aiocontrome/redact.py +82 -0
  24. aiocontrome-0.1.0/src/aiocontrome/sensors.py +106 -0
  25. aiocontrome-0.1.0/tests/conftest.py +208 -0
  26. aiocontrome-0.1.0/tests/fixtures/README.md +78 -0
  27. aiocontrome-0.1.0/tests/fixtures/apiv1_disabled.json +6 -0
  28. aiocontrome-0.1.0/tests/fixtures/fps.json +585 -0
  29. aiocontrome-0.1.0/tests/fixtures/info.json +11 -0
  30. aiocontrome-0.1.0/tests/fixtures/outs_pro_a.json +101 -0
  31. aiocontrome-0.1.0/tests/fixtures/outs_pro_b.json +101 -0
  32. aiocontrome-0.1.0/tests/fixtures/rltemps_1.json +18 -0
  33. aiocontrome-0.1.0/tests/fixtures/rltemps_14.json +10 -0
  34. aiocontrome-0.1.0/tests/fixtures/rltemps_15.json +10 -0
  35. aiocontrome-0.1.0/tests/fixtures/rltemps_16.json +10 -0
  36. aiocontrome-0.1.0/tests/fixtures/rltemps_17.json +10 -0
  37. aiocontrome-0.1.0/tests/fixtures/rltemps_18.json +10 -0
  38. aiocontrome-0.1.0/tests/fixtures/rltemps_19.json +18 -0
  39. aiocontrome-0.1.0/tests/fixtures/rltemps_20.json +10 -0
  40. aiocontrome-0.1.0/tests/fixtures/rltemps_23.json +10 -0
  41. aiocontrome-0.1.0/tests/fixtures/room_details_api_offset_active.json +1881 -0
  42. aiocontrome-0.1.0/tests/fixtures/room_details_morning.json +1870 -0
  43. aiocontrome-0.1.0/tests/fixtures/room_details_morning_skip_loops.json +1870 -0
  44. aiocontrome-0.1.0/tests/fixtures/room_details_own_schedule.json +1801 -0
  45. aiocontrome-0.1.0/tests/fixtures/room_details_own_schedule_skip_loops.json +1801 -0
  46. aiocontrome-0.1.0/tests/fixtures/room_details_temporary_mode.json +1878 -0
  47. aiocontrome-0.1.0/tests/fixtures/room_details_window_0_closed_pv_boost.json +1878 -0
  48. aiocontrome-0.1.0/tests/fixtures/room_details_window_1_open_10min.json +1878 -0
  49. aiocontrome-0.1.0/tests/fixtures/room_details_window_2_open_20min.json +1878 -0
  50. aiocontrome-0.1.0/tests/fixtures/room_details_window_3_closed_again.json +1878 -0
  51. aiocontrome-0.1.0/tests/fixtures/roomoffsets_after_house.json +1 -0
  52. aiocontrome-0.1.0/tests/fixtures/roomoffsets_api.json +1 -0
  53. aiocontrome-0.1.0/tests/fixtures/roomoffsets_empty.json +1 -0
  54. aiocontrome-0.1.0/tests/fixtures/synthetic_404_debug.html +37 -0
  55. aiocontrome-0.1.0/tests/fixtures/synthetic_outs_relay.json +23 -0
  56. aiocontrome-0.1.0/tests/fixtures/synthetic_roomoffsets_active.json +1 -0
  57. aiocontrome-0.1.0/tests/fixtures/temps.json +1119 -0
  58. aiocontrome-0.1.0/tests/fixtures/temps_temporary_mode.json +1123 -0
  59. aiocontrome-0.1.0/tests/fixtures/upcomingoffsets.json +219 -0
  60. aiocontrome-0.1.0/tests/fixtures/vtr_empty.json +1 -0
  61. aiocontrome-0.1.0/tests/fixtures/wetter_pro_empty.json +1 -0
  62. aiocontrome-0.1.0/tests/fixtures/write/houseoffset_ok.txt +9 -0
  63. aiocontrome-0.1.0/tests/fixtures/write/roomoffset_ok.txt +9 -0
  64. aiocontrome-0.1.0/tests/fixtures/write/soll_403.txt +9 -0
  65. aiocontrome-0.1.0/tests/fixtures/write/soll_ok.txt +9 -0
  66. aiocontrome-0.1.0/tests/fixtures/write/ziel_ok.txt +10 -0
  67. aiocontrome-0.1.0/tests/test_client.py +402 -0
  68. aiocontrome-0.1.0/tests/test_client_set.py +302 -0
  69. aiocontrome-0.1.0/tests/test_errors.py +44 -0
  70. aiocontrome-0.1.0/tests/test_models.py +120 -0
  71. aiocontrome-0.1.0/tests/test_outputs.py +92 -0
  72. aiocontrome-0.1.0/tests/test_package.py +20 -0
  73. aiocontrome-0.1.0/tests/test_parser_common.py +126 -0
  74. aiocontrome-0.1.0/tests/test_parser_fps.py +87 -0
  75. aiocontrome-0.1.0/tests/test_parser_info.py +37 -0
  76. aiocontrome-0.1.0/tests/test_parser_outs.py +69 -0
  77. aiocontrome-0.1.0/tests/test_parser_passthrough.py +38 -0
  78. aiocontrome-0.1.0/tests/test_parser_rltemps.py +44 -0
  79. aiocontrome-0.1.0/tests/test_parser_room_details.py +308 -0
  80. aiocontrome-0.1.0/tests/test_parser_temps.py +173 -0
  81. aiocontrome-0.1.0/tests/test_parser_upcoming_offsets.py +50 -0
  82. aiocontrome-0.1.0/tests/test_redact.py +139 -0
  83. aiocontrome-0.1.0/tests/test_sensors.py +136 -0
@@ -0,0 +1,15 @@
1
+ __pycache__/
2
+ *.py[cod]
3
+ .venv/
4
+ .pytest_cache/
5
+ .mypy_cache/
6
+ .ruff_cache/
7
+ .coverage
8
+ htmlcov/
9
+ dist/
10
+ build/
11
+ *.egg-info/
12
+ .env
13
+ .env.*
14
+ *.pem
15
+ .claude/settings.local.json
@@ -0,0 +1,38 @@
1
+ # Changelog
2
+
3
+ All notable changes to this project are documented in this file.
4
+
5
+ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project
6
+ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
+
8
+ ## [Unreleased]
9
+
10
+ ## [0.1.0] - 2026-11-17
11
+
12
+ First public release. Tested against fixtures recorded from a Controme Smart-Heat NOVA 27
13
+ system; the write endpoints `set_setpoint`, `set_target`, `set_room_offset` and
14
+ `set_house_offset` (with 0) were verified in a live test.
15
+
16
+ ### Added
17
+
18
+ - `ContromeClient` for the local JSON API (`get/json/v1`), with the session passed in, a
19
+ required `timezone` and automatic detection of the house ID.
20
+ - Read methods returning immutable, typed models: `get_info`, `get_house` (`temps/`),
21
+ `get_outputs` (`outs/`), `get_return_sensors` (`rltemps/`), `get_room_details` (Basic Auth),
22
+ `get_upcoming_offsets` and `get_fps`.
23
+ - Write methods (`set/json/v1`): `set_setpoint`, `set_target`, `set_scene`,
24
+ `set_default_duration`, `set_operating_mode`, `set_room_offset` and `set_house_offset`.
25
+ Credentials are never logged or included in errors.
26
+ - Output type per floor (relay or 0-10 V position) with automatic detection, plus
27
+ `Output.percent` and `Output.open_fraction`.
28
+ - Sensor connection type derived from the sensor ID (1-Wire, radio, virtual),
29
+ `LastSeenTracker` and `is_stale` for transmission monitoring.
30
+ - Window-open detection (`RoomDetails.window_open`) and per-source offsets, including the API
31
+ offset in `offsets["api"]`.
32
+ - `get_raw` for unparsed responses, `get_vtr` and `get_weather_pro` as read-only pass-through,
33
+ and `redact` to remove sensor IDs, MAC and IP addresses from data before sharing it.
34
+ - Error hierarchy based on `ContromeError` (`ContromeConnectionError`, `ContromeAuthError`,
35
+ `ContromeNotFoundError`, `ContromeResponseError`, `ContromeApiDisabledError`).
36
+
37
+ [Unreleased]: https://github.com/astrometeo84/aiocontrome/compare/v0.1.0...HEAD
38
+ [0.1.0]: https://github.com/astrometeo84/aiocontrome/releases/tag/v0.1.0