aiobmsble 0.1.0__py3-none-any.whl → 0.2.1__py3-none-any.whl

{aiobmsble-0.1.0.dist-info → aiobmsble-0.2.1.dist-info}/METADATA

@@ -1,12 +1,14 @@
 Metadata-Version: 2.4
 Name: aiobmsble
-Version: 0.1.0
+Version: 0.2.1
 Summary: Asynchronous Python library to query battery management systems via Bluetooth Low Energy.
 Author: Patrick Loschmidt
 Maintainer: Patrick Loschmidt
 License-Expression: Apache-2.0
 Project-URL: Homepage, https://github.com/patman15/aiobmsble/
-Project-URL: Documentation, https://github.com/patman15/aiobmsble/
+Project-URL: Documentation, https://github.com/patman15/aiobmsble/README
+Project-URL: Source Code, https://github.com/patman15/aiobmsble/
+Project-URL: Bug Reports, https://github.com/patman15/aiobmsble/issues
 Keywords: BMS,BLE,battery,bluetooth
 Classifier: Programming Language :: Python :: 3
 Classifier: Operating System :: OS Independent
@@ -16,8 +18,8 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: bleak~=0.22.3
-Requires-Dist: bleak-retry-connector~=3.8.1
+Requires-Dist: bleak~=1.1.0
+Requires-Dist: bleak-retry-connector~=4.0.2
 Requires-Dist: asyncio
 Requires-Dist: logging
 Requires-Dist: statistics
@@ -26,6 +28,8 @@ Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-asyncio; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: pytest-xdist; extra == "dev"
+Requires-Dist: hypothesis; extra == "dev"
 Requires-Dist: mypy; extra == "dev"
 Requires-Dist: ruff; extra == "dev"
 Dynamic: license-file
@@ -35,9 +39,8 @@ Dynamic: license-file
 # Aiobmsble
 Requires Python 3 and uses [asyncio](https://pypi.org/project/asyncio/) and [bleak](https://pypi.org/project/bleak/)
 > [!IMPORTANT]
-> At the moment the library is under development and not all BMS classes have been ported over from the [BMS_BLE-HA integration](https://github.com/patman15/BMS_BLE-HA/)!
+> At the moment the library is under development and there might be missing functionality compared to the [BMS_BLE-HA integration](https://github.com/patman15/BMS_BLE-HA/)!
 > Please do not (yet) report missing BMS support or bugs here. Instead please raise an issue at the integration till the library reached at least development status *beta*.
-> Plan is to support all BMSs that are listed [here](https://github.com/patman15/BMS_BLE-HA/edit/main/README.md#supported-devices).
 
 ## Asynchronous Library to Query Battery Management Systems via Bluetooth LE
 This library is intended to query data from battery management systems that use Bluetooth LE. It is developed to support [BMS_BLE-HA integration](https://github.com/patman15/BMS_BLE-HA/) that was written to make BMS data available to Home Assistant. While the integration depends on Home Assistant, this library can be used stand-alone in any Python environment (with necessary dependencies installed).
@@ -55,6 +58,7 @@ This example can also be found as an [example](/examples/minimal.py) in the resp
 """Example of using the aiobmsble library to find a BLE device by name and print its senosr data."""
 
 import asyncio
+import logging
 from typing import Final
 
 from bleak import BleakScanner
@@ -62,30 +66,35 @@ from bleak.backends.device import BLEDevice
 from bleak.exc import BleakError
 
 from aiobmsble import BMSsample
-from aiobmsble.bms.ogt_bms import BMS  # use the right BMS class for your device
+from aiobmsble.bms.dummy_bms import BMS  # use the right BMS class for your device
 
 NAME: Final[str] = "BT Device Name"  # Replace with the name of your BLE device
 
+# Configure logging
+logging.basicConfig(level=logging.INFO)
+logger: logging.Logger = logging.getLogger(__name__)
+
 
 async def main(dev_name) -> None:
-    """Main function to find a BLE device by name and update its sensor data."""
+    """Find a BLE device by name and update its sensor data."""
 
     device: BLEDevice | None = await BleakScanner.find_device_by_name(dev_name)
     if device is None:
-        print(f"Device '{dev_name}' not found.")
+        logger.error("Device '%s' not found.", dev_name)
         return
 
-    print(f"Found device: {device.name} ({device.address})")
+    logger.info("Found device: %s (%s)", device.name, device.address)
     bms = BMS(ble_device=device, reconnect=True)
     try:
-        print("Updating BMS data...")
+        logger.info("Updating BMS data...")
         data: BMSsample = await bms.async_update()
-        print("BMS data: ", repr(data).replace(", ", ",\n\t"))
+        logger.info("BMS data: %s", repr(data).replace(", ", ",\n\t"))
     except BleakError as ex:
-        print(f"Failed to update BMS: {ex}")
+        logger.error("Failed to update BMS: %s", type(ex).__name__)
 
 
-asyncio.run(main(NAME))
+if __name__ == "__main__":
+    asyncio.run(main(NAME))  # pragma: no cover
 ```
 
 ## Installation

aiobmsble-0.2.1.dist-info/RECORD

@@ -0,0 +1,36 @@
+aiobmsble/__init__.py,sha256=gwWO0ojesAR4aYsu5P4LZYlaQgkJpMkzg4Q27V3VOrg,2932
+aiobmsble/__main__.py,sha256=7h8ZnUlQ67IMjnRMJJt091ndGIrYuvd5i12OEMxy2j0,3000
+aiobmsble/basebms.py,sha256=bNik9TsHTlAqAR-RPxFFXy6qD1E7l7f53u8wffMgQyU,18556
+aiobmsble/utils.py,sha256=sXAiXncVWLdO-7q9tbwaEbCKf4ciNrRQZEExbxFqwkk,5518
+aiobmsble/bms/__init__.py,sha256=YAtb8MKhgbZP528ISmxwfXtDix7G_3xuREdcDPvDvqo,60
+aiobmsble/bms/abc_bms.py,sha256=1EISRUQ_owkgMAjuX8nGZav7cGdE3IFSpQXVndN8ZdA,5887
+aiobmsble/bms/ant_bms.py,sha256=vb7886qYPU1Rpr-lkGfcMwybySz1bLgAnDGrfnU498U,7054
+aiobmsble/bms/braunpwr_bms.py,sha256=yI82UqJHgS_yKycbTLyBArQo7e8HjFwCnMZG-OlUcHE,5871
+aiobmsble/bms/cbtpwr_bms.py,sha256=d5rTZwZNkhB4Lx2qlilPFPLITweBOGwCyzfwKeXBw-I,6171
+aiobmsble/bms/cbtpwr_vb_bms.py,sha256=2NpwkyUueORVijhywYG_RTRbX_EbLHChS8vPCTLzPo0,6520
+aiobmsble/bms/daly_bms.py,sha256=ebOTBiC9PQNEs7RRw8pyNnWW4zE0rgGK_WD0IOVjvt8,5744
+aiobmsble/bms/dpwrcore_bms.py,sha256=Mt5ZyucPCvn-lWAilKsDxjvrkT123t_cSQ9M8jMEFyo,6560
+aiobmsble/bms/dummy_bms.py,sha256=M6H0o2h2g3LHW-e2JmMMH2RwvviLWu2OuVTAjCd1Nxc,3399
+aiobmsble/bms/ecoworthy_bms.py,sha256=u0ysJmRAVEkNwVFG4jzl2yoA4JuRjGgDN-G84rVrjw4,5304
+aiobmsble/bms/ective_bms.py,sha256=wDwV8EBRFD8s4819d0fxBZ0jUgT1T7Edgn7TmhDCk4M,5745
+aiobmsble/bms/ej_bms.py,sha256=Nu8R-SaqYhM57y2qCJ-ryQfJ9OZTCj7NriiJXBuJWDc,7923
+aiobmsble/bms/felicity_bms.py,sha256=RNNTxJmpj-oqi_-ec2BV82I5Yw5olvnO5KMO6ssrOXU,4632
+aiobmsble/bms/jbd_bms.py,sha256=3W2AFwnRZQ1IT5BFeWOJDQ3ZsXaxquABw34g3pBTGAc,7061
+aiobmsble/bms/jikong_bms.py,sha256=4-xqd3AxmsDYwHDNtKADi-d2lU9ZiHtcvWpSBE1rlOE,11047
+aiobmsble/bms/neey_bms.py,sha256=NU8qDaPO90hQD3kC9w-xoc1v0eLzLM_g-OfeI4bzwxw,7560
+aiobmsble/bms/ogt_bms.py,sha256=k-3FlBMeEZInUqYrAFfI38t9VuKsn7k64etlvyjtIoo,7882
+aiobmsble/bms/pro_bms.py,sha256=64tnmZYxz6fK1fUg6A9x3yNjeYTwEpOQL6Zi-w4bbqU,4973
+aiobmsble/bms/redodo_bms.py,sha256=qxPDCPNiDl_Iq1MDMiG3ZzoAxRHqPXkydzt4DpPLvAs,4264
+aiobmsble/bms/renogy_bms.py,sha256=ua_1mEJANyy4qJIo53Upaa47_soL4WrmeRHErG5eaZU,5027
+aiobmsble/bms/renogy_pro_bms.py,sha256=jTxmeAkSjbJjuhtwB1AFZp_dxDCs8ofCJZlBMwMcLUw,3863
+aiobmsble/bms/roypow_bms.py,sha256=3JGIUY91wzBroS_f0NhBF3jj9XJTniENFcSOaGmMipQ,6063
+aiobmsble/bms/seplos_bms.py,sha256=BLKna81ocFGoJ2E2nfMU7NGvJXSICapggk_fjS_vKBw,9412
+aiobmsble/bms/seplos_v2_bms.py,sha256=3bkZce8wxxG-0InOIPPa-1y6fR2GuZomNQI65ypyJ_s,7388
+aiobmsble/bms/tdt_bms.py,sha256=4P52WRikQLqu6mN40I_upVpmEDKA5gS472EbjhJ7n-Q,6927
+aiobmsble/bms/tianpwr_bms.py,sha256=SKS31KOHVXnvXbPtSAWPUdiI4j8bV7Y9bwRkrpKWZDw,4841
+aiobmsble-0.2.1.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+aiobmsble-0.2.1.dist-info/METADATA,sha256=Q3p5fiUxVeWt7z2XjztBI--mTbkhCa7ip3W7c-dv2pI,4711
+aiobmsble-0.2.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+aiobmsble-0.2.1.dist-info/entry_points.txt,sha256=HSC_C3nQikc3nk0a6mcG92RuIM7wAzozjBVfDojJceo,54
+aiobmsble-0.2.1.dist-info/top_level.txt,sha256=YHBVzg45mJ3vPz0sl_TpMB0edMqqhD61kwJj4EPAk9g,10
+aiobmsble-0.2.1.dist-info/RECORD,,

{aiobmsble-0.1.0.dist-info → aiobmsble-0.2.1.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.4.0)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

aiobmsble-0.1.0.dist-info/RECORD

@@ -1,10 +0,0 @@
-aiobmsble/__init__.py,sha256=qEmiX9i7aKK7lYl7zrTgNFblb3-WJYTG22tTmAO_uC4,1541
-aiobmsble/__main__.py,sha256=ycvwDkcph4M1UzsBGJzkQWkLS6CW5sPfEG9QK-Q691I,2102
-aiobmsble/basebms.py,sha256=ZHG34fmDQ5wz58GpS7yI09ICdot7iyvdhPg6zt9U6vw,10699
-aiobmsble/utils.py,sha256=BGcwcfOpS5KW942J7uHRrBkmh9rdMW64OvDRyHIP9lQ,2535
-aiobmsble-0.1.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-aiobmsble-0.1.0.dist-info/METADATA,sha256=THqATDPH5bBlgIb363ZpqCkOh5S4FPYkQSPnPDW4xdE,4395
-aiobmsble-0.1.0.dist-info/WHEEL,sha256=DnLRTWE75wApRYVsjgc6wsVswC54sMSJhAEd4xhDpBk,91
-aiobmsble-0.1.0.dist-info/entry_points.txt,sha256=HSC_C3nQikc3nk0a6mcG92RuIM7wAzozjBVfDojJceo,54
-aiobmsble-0.1.0.dist-info/top_level.txt,sha256=YHBVzg45mJ3vPz0sl_TpMB0edMqqhD61kwJj4EPAk9g,10
-aiobmsble-0.1.0.dist-info/RECORD,,