pynortecgo 0.1.0__tar.gz

pynortecgo-0.1.0/.gitignore

@@ -0,0 +1,30 @@
+# Secrets
+.env
+
+# Local capture data
+captures/
+local/
+*.har
+*.flows
+
+# Python
+__pycache__/
+*.pyc
+.venv/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# macOS
+.DS_Store
+
+# build
+*.egg-info/
+build/
+dist/
+
+# Local tool environments and artifacts
+.venv-tools/
+*.token
+.monta_token
+tools/**/*.apk

pynortecgo-0.1.0/CHANGELOG.md

@@ -0,0 +1,36 @@
+# Changelog
+
+All notable changes to `pynortecgo` are documented here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project uses
+[Semantic Versioning](https://semver.org/).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-09-26
+
+First release on PyPI.
+
+### Changed
+- Package renamed from `montaclient` to `pynortecgo`; `src/` layout; built with hatchling, managed with uv.
+- Requires Python 3.13+.
+- The client is rewritten: `NortecGoClient` replaces `MontaClient`, with new models, enums and exceptions.
+  The old methods and models are gone.
+
+### Added
+- `py.typed` marker (the package is fully typed and checked with `mypy --strict`).
+- `login()`, with token refresh on 401 (one refresh at a time; a rejected refresh isn't repeated) and an `on_tokens_refreshed` callback.
+- `get_charger()`: state and whether a cable is connected.
+- `get_vehicle()`: battery level, plugged in, charge limit, last seen.
+- `get_price_forecast()`: 15-minute price slots for about 7 days; the price zone defaults to the charger's.
+- Retries on rate limits, network errors and 502/503/504 (`RetryPolicy`); depends on `tenacity`.
+- `Charger.charge_state` and `Charger.charge_state_raw`, read from the charger's active charge; the new
+  `ChargeState` enum.
+- `ChargerState.BUSY`, `BUSY_CHARGING` and `BUSY_NON_RELEASED`.
+- `start_charge()` and `stop_charge()`, returning the new `Charge`; `Charger.charge_id` and
+  `Charger.can_stop`. Charge requests are never retried.
+- `ChargeStartError` (with `ChargeStartStep`), `ChargeAlreadyActiveError`, `CableNotConnectedError`,
+  `ChargerNotReleasedError`, `PaymentSourceNotFoundError`, `MultiplePaymentSourcesError`,
+  `NoActiveChargeError`, `ChargeNotStoppableError`.
+
+### Removed
+- `Charger.is_charging` and `Vehicle.is_charging`: use `Charger.charge_state`.

pynortecgo-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 thomas3650
+
+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.

pynortecgo-0.1.0/PKG-INFO

@@ -0,0 +1,123 @@
+Metadata-Version: 2.5
+Name: pynortecgo
+Version: 0.1.0
+Summary: Unofficial async client for the Monta API used by the Nortec Go app
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: AsyncIO
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Home Automation
+Classifier: Typing :: Typed
+Requires-Python: >=3.13
+Requires-Dist: aiohttp>=3.9
+Requires-Dist: tenacity>=8.2
+Description-Content-Type: text/markdown
+
+# pynortecgo
+
+Unofficial async Python client for the Monta API used by the **Nortec Go** app (a white-label Monta app).
+Built to power a Home Assistant integration, so a Nortec Go charger can be driven by tools such as
+[ev_smart_charging](https://github.com/jonasbkarlsson/ev_smart_charging).
+
+> **Unofficial.** Not affiliated with, endorsed by or supported by Nortec or Monta. It uses the same private
+> API as the app, which can change without notice.
+
+## Install
+
+```bash
+pip install pynortecgo
+```
+
+Requires Python 3.13+.
+
+## Usage
+
+```python
+import asyncio
+
+import aiohttp
+from pynortecgo import NortecGoClient
+
+
+async def main() -> None:
+    async with aiohttp.ClientSession() as session:
+        client = NortecGoClient(session)
+        tokens = await client.login("you@example.com", "password")  # store tokens and client.device_id
+        charger = await client.get_charger()
+        vehicle = await client.get_vehicle()
+        forecast = await client.get_price_forecast()
+        print(
+            charger.state,
+            charger.is_connected,
+            charger.charge_state,
+            vehicle.battery_level,
+            forecast.slots[0],
+        )
+
+
+asyncio.run(main())
+```
+
+- **Log in once.** Login is rate-limited. Store the returned `Tokens` and `client.device_id`, and pass them
+  to the next client: `NortecGoClient(session, tokens=tokens, device_id=device_id,
+  on_tokens_refreshed=save)`. The client refreshes the token on a 401 and calls `on_tokens_refreshed`.
+  `on_tokens_refreshed` must be an async function that takes the new `Tokens`, e.g.
+  `async def save(tokens: Tokens) -> None`. `on_tokens_refreshed` must not call the client.
+- **The session is yours.** The client never closes it, so Home Assistant can share its own.
+- **One charger and one car.** `get_charger()` and `get_vehicle()` raise if the account has none or more
+  than one.
+- **Car data can be old.** It comes from the car's own integration and can lag by hours; check
+  `Vehicle.last_seen`. `Charger.is_connected` comes from the charger and is live. For whether the car is
+  charging, read `Charger.charge_state`, which comes from the charger's open charge; the car's own
+  `power_delivery_state` can stay "stopped" during a charge. `ChargeState.CHARGING` is assumed to mean the
+  car is drawing power; whether the charge leaves that state when the car stops at its own limit hasn't
+  been seen yet.
+- **Charging states.** `Charger.charge_state` is the open charge's state (`ChargeState`), `None` when no
+  charge is open; `Charger.charge_id` and `Charger.can_stop` belong to that charge.
+  `ChargerState.BUSY_CHARGING` alone doesn't mean power is flowing.
+- **Starting and stopping.** `start_charge()` places a real card hold and starts a real charge on the
+  account's one charger, paid with the account's one saved card. It refuses when a charge is in progress, no
+  cable is connected, or the charger still holds the last charge (unplug and replug the cable first). Its
+  requests are never retried, and **you must not retry it automatically either**:
+  each attempt can place a new card hold. A failure after the first payment request raises
+  `ChargeStartError`, whose `step` and `hold_may_be_placed` say how far it got. `stop_charge()` stops the
+  charge in progress. Both return the charge as the API answered, before it has finished starting or
+  stopping, so read the charger to follow it.
+- **Prices** are 15-minute slots from the current hour to about 7 days ahead: the spot price incl. VAT per
+  kWh, without fees or grid tariff. `country_area_id` is the price zone (bidding area); `2` is DK East
+  (DK2), the only value observed so far. Omit it to use the price zone of the account's one charger (that
+  reads the charger, so it can raise the charger errors).
+- **Errors** are `NortecGoError` subclasses: `AuthError`, `RateLimitError`, `NortecGoConnectionError`,
+  `ApiError`, `UnexpectedResponseError` (the private API changed), `ChargerNotFoundError`,
+  `MultipleChargersError`, `VehicleNotFoundError`, `MultipleVehiclesError`, `ChargeAlreadyActiveError`,
+  `CableNotConnectedError`, `PaymentSourceNotFoundError`, `MultiplePaymentSourcesError`,
+  `ChargeStartError`, `NoActiveChargeError`, `ChargeNotStoppableError`, `ChargerNotReleasedError`.
+- **Retries** on rate limits, network errors and 502/503/504 are built in; tune them with the `retry=`
+  argument (`RetryPolicy`). Starting and stopping a charge is the exception: those requests are sent once.
+
+## Client status
+
+Alpha.
+
+| Feature | Status |
+|---|---|
+| Login, token refresh | done |
+| Charger: state, cable connected | done |
+| Charger: charging or not | done |
+| Car: battery, plugged in, last seen | done |
+| Price forecast in 15-minute slots | done |
+| Start / stop charging | done |
+
+## Development
+
+```bash
+uv sync && uv run pytest -q
+```
+
+## License
+
+MIT

pynortecgo-0.1.0/README.md

@@ -0,0 +1,104 @@
+# pynortecgo
+
+Unofficial async Python client for the Monta API used by the **Nortec Go** app (a white-label Monta app).
+Built to power a Home Assistant integration, so a Nortec Go charger can be driven by tools such as
+[ev_smart_charging](https://github.com/jonasbkarlsson/ev_smart_charging).
+
+> **Unofficial.** Not affiliated with, endorsed by or supported by Nortec or Monta. It uses the same private
+> API as the app, which can change without notice.
+
+## Install
+
+```bash
+pip install pynortecgo
+```
+
+Requires Python 3.13+.
+
+## Usage
+
+```python
+import asyncio
+
+import aiohttp
+from pynortecgo import NortecGoClient
+
+
+async def main() -> None:
+    async with aiohttp.ClientSession() as session:
+        client = NortecGoClient(session)
+        tokens = await client.login("you@example.com", "password")  # store tokens and client.device_id
+        charger = await client.get_charger()
+        vehicle = await client.get_vehicle()
+        forecast = await client.get_price_forecast()
+        print(
+            charger.state,
+            charger.is_connected,
+            charger.charge_state,
+            vehicle.battery_level,
+            forecast.slots[0],
+        )
+
+
+asyncio.run(main())
+```
+
+- **Log in once.** Login is rate-limited. Store the returned `Tokens` and `client.device_id`, and pass them
+  to the next client: `NortecGoClient(session, tokens=tokens, device_id=device_id,
+  on_tokens_refreshed=save)`. The client refreshes the token on a 401 and calls `on_tokens_refreshed`.
+  `on_tokens_refreshed` must be an async function that takes the new `Tokens`, e.g.
+  `async def save(tokens: Tokens) -> None`. `on_tokens_refreshed` must not call the client.
+- **The session is yours.** The client never closes it, so Home Assistant can share its own.
+- **One charger and one car.** `get_charger()` and `get_vehicle()` raise if the account has none or more
+  than one.
+- **Car data can be old.** It comes from the car's own integration and can lag by hours; check
+  `Vehicle.last_seen`. `Charger.is_connected` comes from the charger and is live. For whether the car is
+  charging, read `Charger.charge_state`, which comes from the charger's open charge; the car's own
+  `power_delivery_state` can stay "stopped" during a charge. `ChargeState.CHARGING` is assumed to mean the
+  car is drawing power; whether the charge leaves that state when the car stops at its own limit hasn't
+  been seen yet.
+- **Charging states.** `Charger.charge_state` is the open charge's state (`ChargeState`), `None` when no
+  charge is open; `Charger.charge_id` and `Charger.can_stop` belong to that charge.
+  `ChargerState.BUSY_CHARGING` alone doesn't mean power is flowing.
+- **Starting and stopping.** `start_charge()` places a real card hold and starts a real charge on the
+  account's one charger, paid with the account's one saved card. It refuses when a charge is in progress, no
+  cable is connected, or the charger still holds the last charge (unplug and replug the cable first). Its
+  requests are never retried, and **you must not retry it automatically either**:
+  each attempt can place a new card hold. A failure after the first payment request raises
+  `ChargeStartError`, whose `step` and `hold_may_be_placed` say how far it got. `stop_charge()` stops the
+  charge in progress. Both return the charge as the API answered, before it has finished starting or
+  stopping, so read the charger to follow it.
+- **Prices** are 15-minute slots from the current hour to about 7 days ahead: the spot price incl. VAT per
+  kWh, without fees or grid tariff. `country_area_id` is the price zone (bidding area); `2` is DK East
+  (DK2), the only value observed so far. Omit it to use the price zone of the account's one charger (that
+  reads the charger, so it can raise the charger errors).
+- **Errors** are `NortecGoError` subclasses: `AuthError`, `RateLimitError`, `NortecGoConnectionError`,
+  `ApiError`, `UnexpectedResponseError` (the private API changed), `ChargerNotFoundError`,
+  `MultipleChargersError`, `VehicleNotFoundError`, `MultipleVehiclesError`, `ChargeAlreadyActiveError`,
+  `CableNotConnectedError`, `PaymentSourceNotFoundError`, `MultiplePaymentSourcesError`,
+  `ChargeStartError`, `NoActiveChargeError`, `ChargeNotStoppableError`, `ChargerNotReleasedError`.
+- **Retries** on rate limits, network errors and 502/503/504 are built in; tune them with the `retry=`
+  argument (`RetryPolicy`). Starting and stopping a charge is the exception: those requests are sent once.
+
+## Client status
+
+Alpha.
+
+| Feature | Status |
+|---|---|
+| Login, token refresh | done |
+| Charger: state, cable connected | done |
+| Charger: charging or not | done |
+| Car: battery, plugged in, last seen | done |
+| Price forecast in 15-minute slots | done |
+| Start / stop charging | done |
+
+## Development
+
+```bash
+uv sync && uv run pytest -q
+```
+
+## License
+
+MIT

pynortecgo-0.1.0/pyproject.toml

@@ -0,0 +1,62 @@
+[project]
+name = "pynortecgo"
+version = "0.1.0"
+description = "Unofficial async client for the Monta API used by the Nortec Go app"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.13"
+dependencies = [
+    "aiohttp>=3.9",
+    "tenacity>=8.2",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Framework :: AsyncIO",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Home Automation",
+    "Typing :: Typed",
+]
+
+[dependency-groups]
+dev = [
+    "pytest>=8",
+    "pytest-asyncio>=0.23",
+    "ruff>=0.6",
+    "mypy>=1.11",
+    "pre-commit>=3.8",
+    "questionary>=2.1.1",
+    "rich>=15.0.0",
+]
+
+[build-system]
+requires = ["hatchling>=1.26"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/pynortecgo"]
+
+[tool.hatch.build.targets.sdist]
+only-include = ["src/pynortecgo", "README.md", "LICENSE", "CHANGELOG.md"]
+
+[tool.ruff]
+target-version = "py313"
+line-length = 100
+src = ["src", "tests"]
+extend-exclude = ["*.md"]
+per-file-target-version = {".claude/hooks/*.py" = "py39"}
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "UP", "B", "SIM", "RUF", "ASYNC", "PYI", "FURB", "FA"]
+ignore = ["E501"]  # the formatter owns line length; long strings/URLs are allowed
+
+[tool.mypy]
+strict = true
+files = ["src"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]

pynortecgo-0.1.0/src/pynortecgo/__init__.py

@@ -0,0 +1,73 @@
+"""pynortecgo — async client for the private Monta API used by the Nortec Go app."""
+
+from importlib.metadata import version as _version
+
+from ._http import RetryPolicy
+from .client import NortecGoClient
+from .exceptions import (
+    ApiError,
+    AuthError,
+    CableNotConnectedError,
+    ChargeAlreadyActiveError,
+    ChargeNotStoppableError,
+    ChargerNotFoundError,
+    ChargerNotReleasedError,
+    ChargeStartError,
+    ChargeStartStep,
+    MultipleChargersError,
+    MultiplePaymentSourcesError,
+    MultipleVehiclesError,
+    NoActiveChargeError,
+    NortecGoConnectionError,
+    NortecGoError,
+    PaymentSourceNotFoundError,
+    RateLimitError,
+    UnexpectedResponseError,
+    VehicleNotFoundError,
+)
+from .models import (
+    Charge,
+    Charger,
+    ChargerState,
+    ChargeState,
+    PowerDeliveryState,
+    PriceForecast,
+    PriceSlot,
+    Tokens,
+    Vehicle,
+)
+
+__all__ = [
+    "ApiError",
+    "AuthError",
+    "CableNotConnectedError",
+    "Charge",
+    "ChargeAlreadyActiveError",
+    "ChargeNotStoppableError",
+    "ChargeStartError",
+    "ChargeStartStep",
+    "ChargeState",
+    "Charger",
+    "ChargerNotFoundError",
+    "ChargerNotReleasedError",
+    "ChargerState",
+    "MultipleChargersError",
+    "MultiplePaymentSourcesError",
+    "MultipleVehiclesError",
+    "NoActiveChargeError",
+    "NortecGoClient",
+    "NortecGoConnectionError",
+    "NortecGoError",
+    "PaymentSourceNotFoundError",
+    "PowerDeliveryState",
+    "PriceForecast",
+    "PriceSlot",
+    "RateLimitError",
+    "RetryPolicy",
+    "Tokens",
+    "UnexpectedResponseError",
+    "Vehicle",
+    "VehicleNotFoundError",
+]
+
+__version__ = _version("pynortecgo")