python-openevse-http 0.3.0b0__py3-none-any.whl → 0.3.2__py3-none-any.whl

openevsehttp/commands.py

@@ -491,3 +491,35 @@ class CommandsMixin:
         if not success:
             _LOGGER.error("Problem issuing command: %s", response)
             raise UnknownError
+
+    async def set_shaper(self, enable: bool = True) -> None:
+        """Set shaper mode."""
+        if not self._version_check("4.0.0"):
+            _LOGGER.debug("Feature not supported for older firmware.")
+            raise UnsupportedFeature
+
+        url = f"{self.url}shaper"
+        mode = 1 if enable else 0
+        data = {"mode": mode}
+
+        _LOGGER.debug("Setting shaper to %s", mode)
+        response = await self.process_request(url=url, method="post", data=data)
+        response = self._normalize_response(response)
+        msg = response.get("msg") if isinstance(response, Mapping) else None
+        if msg not in ["OK", "done", "no change", "Current Shaper state changed"]:
+            _LOGGER.error("Problem issuing command: %s", response)
+            raise UnknownError
+
+    async def toggle_shaper(self) -> None:
+        """Toggle shaper mode."""
+        shaper_active = self._status.get("shaper")
+        if shaper_active is None:
+            await self.update()
+            shaper_active = self._status.get("shaper")
+
+        if shaper_active is None:
+            _LOGGER.error("Cannot toggle shaper: unknown shaper state.")
+            raise RuntimeError("Cannot toggle shaper: unknown shaper state.")
+
+        new_state = not bool(shaper_active)
+        await self.set_shaper(new_state)

python_openevse_http-0.3.2.dist-info/METADATA

@@ -0,0 +1,121 @@
+Metadata-Version: 2.4
+Name: python_openevse_http
+Version: 0.3.2
+Summary: Python wrapper for OpenEVSE HTTP API
+Home-page: https://github.com/firstof9/python-openevse-http
+Download-URL: https://github.com/firstof9/python-openevse-http
+Author: firstof9
+Author-email: firstof9@gmail.com
+License: Apache-2.0
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: License :: OSI Approved :: Apache Software License
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: download-url
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+![Codecov branch](https://img.shields.io/codecov/c/github/firstof9/python-openevse-http/main?style=flat-square)
+![GitHub commit activity (branch)](https://img.shields.io/github/commit-activity/m/firstof9/python-openevse-http?style=flat-square)
+![GitHub last commit](https://img.shields.io/github/last-commit/firstof9/python-openevse-http?style=flat-square)
+![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/firstof9/python-openevse-http?style=flat-square)
+
+# python-openevse-http
+
+A Python library for communicating with [OpenEVSE](https://www.openevse.com/) chargers via the HTTP API on ESP8266 and ESP32-based WiFi modules.
+
+## Features
+
+- **Asynchronous**: Built on `aiohttp` for non-blocking I/O.
+- **WebSocket Support**: Real-time updates for charger status.
+- **Firmware Support**: Compatible with ESP8266 (2.x) and ESP32 (4.x+) WiFi firmware.
+- **Comprehensive API**:
+    - Query status and configuration.
+    - Manage manual overrides.
+    - Control charging claims and limits.
+    - Handle schedules.
+    - **Shaper Toggle**: Enable or disable the grid shaper feature (requires firmware 4.0.0+).
+
+## Installation
+
+```bash
+pip install python_openevse_http
+```
+
+## Quick Start
+
+```python
+import asyncio
+from openevsehttp import OpenEVSE
+
+async def main():
+    # Initialize the charger
+    charger = OpenEVSE("192.168.1.30")
+
+    # Update state
+    await charger.update()
+
+    print(f"Charger State: {charger.status}")
+    print(f"Current Charge: {charger.charge_current}A")
+
+    # Toggle the Shaper feature
+    if charger.shaper_active:
+        print("Shaper is active, disabling...")
+    else:
+        print("Shaper is inactive, enabling...")
+
+    await charger.toggle_shaper()
+
+    # Clean up
+    await charger.close()
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## API Support Matrix
+
+| Endpoint | Methods | Supported | Description |
+| :--- | :--- | :---: | :--- |
+| `/status` | GET, POST | ✅ | Real-time status, sensors, and **Vehicle SoC** pushing |
+| `/config` | GET, POST | ✅ | System and WiFi configuration |
+| `/override` | GET, POST, PATCH, DELETE | ✅ | Manual charging overrides & current limits |
+| `/claims` | GET, POST, DELETE | ✅ | Client-based charging claims |
+| `/schedule` | GET, POST | ✅ | Charging schedule management |
+| `/limit` | GET, POST, DELETE | ✅ | Charge limits (Time, Energy, SoC) |
+| `/shaper` | POST | ✅ | Grid shaper control (v4.0.0+) |
+| `/restart` | POST | ✅ | Reboot WiFi gateway or EVSE module |
+| `/divertmode` | POST | ✅ | Solar divert mode control |
+| `/r` (RAPI) | POST | ✅ | Direct RAPI command interface |
+| `/ws` | GET | ✅ | WebSocket real-time updates |
+| `/time` | GET, POST | ❌ | RTC and NTP time settings |
+| `/logs` | GET | ❌ | System and debug event logs |
+| `/emeter` | DELETE | ❌ | Energy meter reset |
+| `/wifi` | GET, POST | ❌ | Network scanning and AP configuration |
+| `/tesla` | GET | ❌ | Tesla vehicle integration |
+| `/certificates`| GET, POST, DELETE | ❌ | SSL/TLS certificate management |
+| `/schedule/plan`| GET | ❌ | Schedule planning and optimization |
+| `/update` | POST | ❌ | Firmware update interface |
+| `/rfid/add` | POST | ❌ | RFID tag management |
+
+✅ = Fully Supported \| ⚠️ = Partial Support \| ❌ = Not yet implemented
+
+## License
+
+This project is licensed under the Apache-2.0 License.

{python_openevse_http-0.3.0b0.dist-info → python_openevse_http-0.3.2.dist-info}/RECORD

@@ -1,15 +1,15 @@
 openevsehttp/__init__.py,sha256=I6a1mjOZHYiWb_qfCuDuFLOOncrkkB_7uwybtOIujfY,1165
 openevsehttp/__main__.py,sha256=EHmSdT7GjAVvHQxvLBTjZXsj_V5SB6B2_kpgUAT7mPM,146
 openevsehttp/client.py,sha256=rdUZn6HdJgUj5vZDin2PL8DyCBRK5_81YR5XJeGI6B0,18210
-openevsehttp/commands.py,sha256=PpqbqSD4TawJW8wMnStGUt11ce2vy6LQiE5kzONf-9o,19708
+openevsehttp/commands.py,sha256=UghodbIq7mF1HDI-o0BpcKcRQm7fgcz_pCqPBOtZPns,21021
 openevsehttp/const.py,sha256=VSc5Xt-KFenft0rT6ql9whCD7J9g_YvjLYU_PX706eE,1360
 openevsehttp/exceptions.py,sha256=bqz-tHTW1AYJMKcm0s5M6z5tA6XZgjnCiBLW1XrZ_70,672
 openevsehttp/managers.py,sha256=kEX1ZD9u-FY0UEZJsxeFEGBSGzSlkbBc0kmxCiMJtJw,5373
 openevsehttp/properties.py,sha256=Lo2p6WfPuhpaEcIZ0OeAxinHSa0G8Sv2wLZ-dPe7rjo,17181
 openevsehttp/sensors.py,sha256=sJP2FPnU1Lk5S3VUyFT14JM1nKEBQPsjl-DiZI-pZrs,4673
 openevsehttp/websocket.py,sha256=Mi_WFmlT3-9i6bbHIN6ua09SD8CpIle2vRXB3HyWzmM,10066
-python_openevse_http-0.3.0b0.dist-info/licenses/LICENSE,sha256=hSB6TOQ7rmwSGb6XzqRjDGMvmUj5_GlacqQin3tegtA,11341
-python_openevse_http-0.3.0b0.dist-info/METADATA,sha256=2f6l6UhX4hUyFTBR6Rz4v0WMknrH4fczMn6wa-Jo-f8,1902
-python_openevse_http-0.3.0b0.dist-info/WHEEL,sha256=SmOxYU7pzNKBqASvQJ7DjX3XGUF92lrGhMb3R6_iiqI,91
-python_openevse_http-0.3.0b0.dist-info/top_level.txt,sha256=u8RUkoEIE33Cjn6gmqiEoVpZ0VZ59WJ3FXBwwOg0CPE,13
-python_openevse_http-0.3.0b0.dist-info/RECORD,,
+python_openevse_http-0.3.2.dist-info/licenses/LICENSE,sha256=hSB6TOQ7rmwSGb6XzqRjDGMvmUj5_GlacqQin3tegtA,11341
+python_openevse_http-0.3.2.dist-info/METADATA,sha256=owAAfc5N-66JfgL2DjzWeeM94vf3lESDwmFTitwzQQ0,4363
+python_openevse_http-0.3.2.dist-info/WHEEL,sha256=SmOxYU7pzNKBqASvQJ7DjX3XGUF92lrGhMb3R6_iiqI,91
+python_openevse_http-0.3.2.dist-info/top_level.txt,sha256=u8RUkoEIE33Cjn6gmqiEoVpZ0VZ59WJ3FXBwwOg0CPE,13
+python_openevse_http-0.3.2.dist-info/RECORD,,

python_openevse_http-0.3.0b0.dist-info/METADATA

@@ -1,48 +0,0 @@
-Metadata-Version: 2.4
-Name: python_openevse_http
-Version: 0.3.0b0
-Summary: Python wrapper for OpenEVSE HTTP API
-Home-page: https://github.com/firstof9/python-openevse-http
-Download-URL: https://github.com/firstof9/python-openevse-http
-Author: firstof9
-Author-email: firstof9@gmail.com
-License: Apache-2.0
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Natural Language :: English
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Classifier: License :: OSI Approved :: Apache Software License
-Requires-Python: >=3.13
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: aiohttp
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: download-url
-Dynamic: home-page
-Dynamic: license
-Dynamic: license-file
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
-![Codecov branch](https://img.shields.io/codecov/c/github/firstof9/python-openevse-http/main?style=flat-square)
-![GitHub commit activity (branch)](https://img.shields.io/github/commit-activity/m/firstof9/python-openevse-http?style=flat-square)
-![GitHub last commit](https://img.shields.io/github/last-commit/firstof9/python-openevse-http?style=flat-square)
-![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/firstof9/python-openevse-http?style=flat-square)
-# python-openevse-http
-Python Library for OpenEVSE HTTP API
-
-A python library for communicating with the ESP8266- and ESP32-based wifi module from OpenEVSE. This library uses the HTTP API commands to query the OpenEVSE charger.
-
-TODO:
-- [ ] Finish tests
-- [ ] Finish HTTP API functions
-- [X] Setup webosocket listener for value updates
-- [X] Convert to aiohttp from requests
-- [X] Expose values as properties