gshock-api 2.0.34__tar.gz → 2.0.35__tar.gz

{gshock_api-2.0.34 → gshock_api-2.0.35}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: gshock_api
-Version: 2.0.34
-Summary: Pythgon API for GShock Watches using BLE
-Home-page: https://github.com/pyscaffold/pyscaffold/
+Version: 2.0.35
+Summary: Python API for GShock Watches using BLE
+Home-page: https://github.com/izivkov/gshock_api/
 Author: Ivo Zivkov
 Author-email: Ivo Zivkov <izivkov@gmail.com>
 License-Expression: MIT
@@ -110,14 +110,14 @@ It is recommended that you create a virtual environment to run the tests:
 
    .. code-block:: sh
 
-      python3 src/examples/api_tests.py [--multi-watch]
+      uv run src/examples/api_tests.py
 
-The optional **`--multi-watch`** parameter forces the library to scan for watches every time it tries to connect to a watch. If not provided, 
-the library will try to connect to the last connected watch only. If you have multiple watches, you should use this parameter.
-      
-The optional **`--multi-watch`** parameter forces the library to scan for watches every time it tries to connect to a watch. If not provided, 
-the library will try to connect to the last connected watch only. If you have multiple watches, you should use this parameter.
+or activate `venv`` first and then run using python:
 
+   .. code-block:: sh
+      
+      source .venv/bin/activate
+      python src/examples/api_tests.py
 
 Installing the library for your project:
 ========================================
@@ -128,7 +128,7 @@ Installing the library for your project:
 
 See `this project <https://github.com/izivkov/GShockTimeServer>`_ using this library to run a time server for G-Shock watches.
 
-See also `this blog <https://digitalsober.wordpress.com/2025/05/05/g-shock-watch-integration-with-sxmo/>`_ for using the library in the `SXMO <https://sxmo.org/>`_ mobile environment.
+See also `this blog <https://digitalsober.wordpress.com/2024/05/05/g-shock-watch-integration-with-sxmo/>`_ for using the library in the `SXMO <https://sxmo.org/>`_ mobile environment.
 
 Troubleshooting:
 ================

{gshock_api-2.0.34 → gshock_api-2.0.35}/README.rst

@@ -81,14 +81,14 @@ It is recommended that you create a virtual environment to run the tests:
 
    .. code-block:: sh
 
-      python3 src/examples/api_tests.py [--multi-watch]
+      uv run src/examples/api_tests.py
 
-The optional **`--multi-watch`** parameter forces the library to scan for watches every time it tries to connect to a watch. If not provided, 
-the library will try to connect to the last connected watch only. If you have multiple watches, you should use this parameter.
-      
-The optional **`--multi-watch`** parameter forces the library to scan for watches every time it tries to connect to a watch. If not provided, 
-the library will try to connect to the last connected watch only. If you have multiple watches, you should use this parameter.
+or activate `venv`` first and then run using python:
 
+   .. code-block:: sh
+      
+      source .venv/bin/activate
+      python src/examples/api_tests.py
 
 Installing the library for your project:
 ========================================
@@ -99,7 +99,7 @@ Installing the library for your project:
 
 See `this project <https://github.com/izivkov/GShockTimeServer>`_ using this library to run a time server for G-Shock watches.
 
-See also `this blog <https://digitalsober.wordpress.com/2025/05/05/g-shock-watch-integration-with-sxmo/>`_ for using the library in the `SXMO <https://sxmo.org/>`_ mobile environment.
+See also `this blog <https://digitalsober.wordpress.com/2024/05/05/g-shock-watch-integration-with-sxmo/>`_ for using the library in the `SXMO <https://sxmo.org/>`_ mobile environment.
 
 Troubleshooting:
 ================

{gshock_api-2.0.34 → gshock_api-2.0.35}/pyproject.toml

@@ -11,8 +11,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gshock_api"  # Change to your project name
-version = "2.0.34"
-description = "Pythgon API for GShock Watches using BLE"
+version = "2.0.35"
+description = "Python API for GShock Watches using BLE"
 authors = [{ name = "Ivo Zivkov", email = "izivkov@gmail.com" }]
 
 license = "MIT"

{gshock_api-2.0.34 → gshock_api-2.0.35}/setup.cfg

@@ -6,10 +6,11 @@ author_email = izivkov@gmail.com
 license = MIT
 license_files = LICENSE.txt
 long_description = file: README.rst
-long_description_content_type = text/x-rst; charset=UTF-8
-url = https://github.com/pyscaffold/pyscaffold/
+long_description_content_type = text/x-rst
+url = https://github.com/izivkov/gshock_api/
 project_urls = 
-	Documentation = https://pyscaffold.org/
+	Documentation = https://github.com/izivkov/gshock_api/
+	Source = https://github.com/izivkov/gshock_api/
 platforms = any
 classifiers = 
 	Development Status :: 4 - Beta
@@ -63,7 +64,7 @@ exclude =
 
 [pyscaffold]
 version = 4.4
-package = gshocktimeserver
+package = gshock_api
 
 [egg_info]
 tag_build = 

{gshock_api-2.0.34 → gshock_api-2.0.35}/setup.py

@@ -2,7 +2,7 @@ from setuptools import find_packages, setup
 
 setup(
     name="gshock_api",
-    version="2.0.34",
+    version="2.0.35",
     package_dir={"": "src"},
     packages=find_packages(where="src"),
     install_requires=[

{gshock_api-2.0.34 → gshock_api-2.0.35}/src/examples/api_tests.py

@@ -5,7 +5,6 @@ import json
 from pprint import pformat
 import sys
 import time
-from typing import Optional
 
 import pytz
 
@@ -205,11 +204,10 @@ async def app_notifications(api: GshockAPI) -> None:
     await api.send_app_notification(email_notification2)
 
 
-def convert_time_string_to_epoch(time_string: str) -> Optional[float]:
+def convert_time_string_to_epoch(time_string: str) -> float | None:
     try:
         time_object = datetime.strptime(time_string, "%H:%M:%S")
-        timestamp = time_object.timestamp()
-        return timestamp
+        return time_object.timestamp()
     except ValueError:
         logger.info("Invalid time format. Please use the format HH:MM:SS.")
         return None

{gshock_api-2.0.34 → gshock_api-2.0.35}/src/gshock_api/connection.py

@@ -100,8 +100,7 @@ class Connection:
     def is_service_supported(self, handle: int) -> bool:
         """Checks if a characteristic UUID mapped to a handle is present in the discovered characteristics."""
         uuid: str | None = self.handles_map.get(handle)
-        
-        return uuid not in self.characteristics_map
+        return uuid is not None and uuid in self.characteristics_map
 
     async def write(self, handle: int, data: bytes) -> None:
         """Writes data to a characteristic identified by its handle."""
@@ -118,13 +117,14 @@ class Connection:
                     )
                 return
 
-            responseType: bool = handle == 0x0E  # noqa: N806, PLR2004
+            # 0x0E is CASIO_ALL_FEATURES_CHARACTERISTIC_UUID (requires response)
+            response_type: bool = handle == 0x0E
             
             cmd_data: bytes = to_casio_cmd(data)
 
             if self.client:
                 await self.client.write_gatt_char(
-                    uuid, cmd_data, response=responseType
+                    uuid, cmd_data, response=response_type
                 )
 
         except Exception as e:
@@ -155,6 +155,6 @@ class Connection:
         return handles_map
 
     # Replaced Any with TypeVar T
-    async def sendMessage(self, message: T) -> None:  # noqa: N802
+    async def send_message(self, message: T) -> None:
         """Sends a message to the watch using the message dispatcher."""
         await message_dispatcher.MessageDispatcher.send_to_watch(message)

{gshock_api-2.0.34 → gshock_api-2.0.35}/src/gshock_api/gshock_api.py

@@ -54,23 +54,23 @@ class GshockAPI:
         result: WatchButton = await message_dispatcher.ButtonPressedIO.request(self.connection)
         return result
 
-    async def get_world_cities(self, cityNumber: int) -> str:  # noqa: N803
+    async def get_world_cities(self, city_number: int) -> str:
         """Get the name for a particular World City set on the watch."""
-        return await self._get_world_cities(cityNumber)
+        return await self._get_world_cities(city_number)
 
-    async def _get_world_cities(self, key: int) -> str:
+    async def _get_world_cities(self, city_number: int) -> str:
         # Assuming WorldCitiesIO.request returns a string
-        result: str = await message_dispatcher.WorldCitiesIO.request(self.connection, key)
+        result: str = await message_dispatcher.WorldCitiesIO.request(self.connection, city_number)
         return result
 
-    async def get_dst_for_world_cities(self, cityNumber: int) -> str:  # noqa: N803
+    async def get_dst_for_world_cities(self, city_number: int) -> str:
         """Get the **Daylight Saving Time** for a particular World City set on the watch."""
-        return await self._get_dst_for_world_cities(cityNumber)
+        return await self._get_dst_for_world_cities(city_number)
 
-    async def _get_dst_for_world_cities(self, key: int) -> str:
+    async def _get_dst_for_world_cities(self, city_number: int) -> str:
         # Assuming DstForWorldCitiesIO.request returns a string
         result: str = await message_dispatcher.DstForWorldCitiesIO.request(
-            self.connection, key
+            self.connection, city_number
         )
         return result
 
@@ -169,8 +169,8 @@ class GshockAPI:
         # Assuming T objects are JSON serializable
         alarms_str: str = json.dumps(alarms)
         set_action_cmd: str = f'{{"action":"SET_ALARMS", "value":{alarms_str} }}'
-        # connection.sendMessage expects T, which must be convertible to a watch message
-        await self.connection.sendMessage(set_action_cmd)
+        # connection.send_message expects T, which must be convertible to a watch message
+        await self.connection.send_message(set_action_cmd)
 
     async def get_timer(self) -> int:
         """Get Timer value in seconds."""
@@ -181,10 +181,10 @@ class GshockAPI:
         result: int = await message_dispatcher.TimerIO.request(self.connection)
         return result
 
-    async def set_timer(self, timerValue: int) -> None:  # noqa: N803
+    async def set_timer(self, timer_value: int) -> None:
         """Set Timer value in seconds."""
-        message: str = f'{{"action": "SET_TIMER", "value": {timerValue} }}'
-        await self.connection.sendMessage(message)
+        message: str = f'{{"action": "SET_TIMER", "value": {timer_value} }}'
+        await self.connection.send_message(message)
 
     # Watch condition request returns an unknown object (object)
     async def get_watch_condition(self) -> object:
@@ -202,7 +202,7 @@ class GshockAPI:
     ) -> None:
         """Sets auto-tame adjustment for the watch"""
         message: str = f"""{{"action": "SET_TIME_ADJUSTMENT", "timeAdjustment": "{time_adjustement}", "minutesAfterHour": "{minutes_after_hour}" }}"""
-        await self.connection.sendMessage(message)
+        await self.connection.send_message(message)
 
     # SettingsIO returns a list of unknown Setting objects (list[T])
     async def get_basic_settings(self) -> list[T]:
@@ -215,7 +215,7 @@ class GshockAPI:
         """Set settings to the watch."""
         setting_json: str = json.dumps(settings)
         message: str = f'{{"action": "SET_SETTINGS", "value": {setting_json} }}'
-        await self.connection.sendMessage(message)
+        await self.connection.send_message(message)
 
     # get_reminders returns a list of unknown Event objects (list[T])
     async def get_reminders(self) -> list[T]:
@@ -253,7 +253,7 @@ class GshockAPI:
         events_as_json: list[Mapping[str, object]] = to_json(events)
         enabled: list[Mapping[str, object]] = get_enabled_events(events_as_json)
 
-        await self.connection.sendMessage(
+        await self.connection.send_message(
             f"""{{"action": "SET_REMINDERS", "value": {json.dumps(enabled)}}}"""
         )
 

{gshock_api-2.0.34 → gshock_api-2.0.35}/src/gshock_api/iolib/alarms_io.py

@@ -45,12 +45,13 @@ class AlarmsIO:
         AlarmsIO.connection = connection
         alarms_inst_typed.clear()
         await AlarmsIO._get_alarms(connection)
-        assert AlarmsIO.result is not None  # noqa: S101
+        if AlarmsIO.result is None:
+            raise RuntimeError("AlarmsIO.result must not be None after _get_alarms")
         return AlarmsIO.result
 
     @staticmethod
     async def _get_alarms(connection: ConnectionProtocol) -> CancelableResult[list[dict[str, object]]]:
-        await connection.sendMessage('{ "action": "GET_ALARMS"}')
+        await connection.send_message('{ "action": "GET_ALARMS"}')
         AlarmsIO.result = CancelableResult[list[dict[str, object]]]()
         return await AlarmsIO.result.get_result()
 

{gshock_api-2.0.34 → gshock_api-2.0.35}/src/gshock_api/iolib/events_io.py

@@ -1,5 +1,5 @@
 import json
-from typing import List, TypedDict  # noqa: UP035
+from typing import TypedDict
 
 from gshock_api.cancelable_result import CancelableResult
 from gshock_api.casio_constants import CasioConstants
@@ -45,7 +45,7 @@ class ReminderTimeDict(TypedDict):
     repeat_period: str
     start_date: DateDict
     end_date: DateDict
-    days_of_week: List[str]
+    days_of_week: list[str]
 
 
 class EventsIO:

{gshock_api-2.0.34 → gshock_api-2.0.35}/src/gshock_api/iolib/time_io.py

@@ -27,7 +27,7 @@ class TimeIO:
                 "offset": offset,  # must always be an integer
             },
         }
-        await connection.sendMessage(json.dumps(message))
+        await connection.send_message(json.dumps(message))
 
     @staticmethod
     async def send_to_watch_set(message: str) -> None:

{gshock_api-2.0.34 → gshock_api-2.0.35}/src/gshock_api/iolib/world_cities_io.py

@@ -10,9 +10,9 @@ class WorldCitiesIO:
     connection: ConnectionProtocol | None = None
 
     @staticmethod
-    async def request(connection: ConnectionProtocol, cityNumber: int) -> CancelableResult[bytes]:
+    async def request(connection: ConnectionProtocol, city_number: int) -> CancelableResult[bytes]:
         WorldCitiesIO.connection = connection
-        key = f"1f0{cityNumber}"
+        key = f"1f0{city_number}"
         await connection.request(key)
 
         WorldCitiesIO.result = CancelableResult[bytes]()

{gshock_api-2.0.34 → gshock_api-2.0.35}/src/gshock_api/scanner.py

@@ -24,10 +24,10 @@ MAX_SCAN_RETRIES: Final[int] = 60
 # --- Type Aliases ---
 
 # WatchFilter is a function that takes a BLEDevice name (str) and returns a boolean.
-WatchFilter: Final[Callable[[str], bool]] = Callable[[str], bool]
+type WatchFilter = Callable[[str], bool] | None
 
 # Type for the filter used in find_device_by_filter (takes device and ad data, returns bool)
-BleakDeviceFilter: Final[Callable[[BLEDevice, AdvertisementData], bool]] = Callable[[BLEDevice, AdvertisementData], bool]
+type BleakDeviceFilter = Callable[[BLEDevice, AdvertisementData], bool]
 
 
 class Scanner:
@@ -38,8 +38,7 @@ class Scanner:
     async def scan(
         self,
         device_address: str | None = None,
-        # Replaced the untyped watch_filter=None with a properly typed Callable or None
-        watch_filter: WatchFilter | None = None, # type: ignore
+        watch_filter: WatchFilter = None,
         max_retries: int = MAX_SCAN_RETRIES
     ) -> BLEDevice | None:
         

{gshock_api-2.0.34 → gshock_api-2.0.35}/src/gshock_api/watch_info.py

@@ -1,10 +1,10 @@
 from collections import ChainMap
 from dataclasses import dataclass, field
 from enum import IntEnum
-from typing import Any, Final, TypeAlias
+from typing import Any, Final
 
-ModelCapability: TypeAlias = dict[str, Any] # noqa: UP040
-ModelMap: TypeAlias = dict[Any, ChainMap]  # noqa: UP040
+type ModelCapability = dict[str, Any]
+type ModelMap = dict[Any, ChainMap]
 
 
 class WatchModel(IntEnum):

{gshock_api-2.0.34 → gshock_api-2.0.35}/src/gshock_api.egg-info/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: gshock_api
-Version: 2.0.34
-Summary: Pythgon API for GShock Watches using BLE
-Home-page: https://github.com/pyscaffold/pyscaffold/
+Version: 2.0.35
+Summary: Python API for GShock Watches using BLE
+Home-page: https://github.com/izivkov/gshock_api/
 Author: Ivo Zivkov
 Author-email: Ivo Zivkov <izivkov@gmail.com>
 License-Expression: MIT
@@ -110,14 +110,14 @@ It is recommended that you create a virtual environment to run the tests:
 
    .. code-block:: sh
 
-      python3 src/examples/api_tests.py [--multi-watch]
+      uv run src/examples/api_tests.py
 
-The optional **`--multi-watch`** parameter forces the library to scan for watches every time it tries to connect to a watch. If not provided, 
-the library will try to connect to the last connected watch only. If you have multiple watches, you should use this parameter.
-      
-The optional **`--multi-watch`** parameter forces the library to scan for watches every time it tries to connect to a watch. If not provided, 
-the library will try to connect to the last connected watch only. If you have multiple watches, you should use this parameter.
+or activate `venv`` first and then run using python:
 
+   .. code-block:: sh
+      
+      source .venv/bin/activate
+      python src/examples/api_tests.py
 
 Installing the library for your project:
 ========================================
@@ -128,7 +128,7 @@ Installing the library for your project:
 
 See `this project <https://github.com/izivkov/GShockTimeServer>`_ using this library to run a time server for G-Shock watches.
 
-See also `this blog <https://digitalsober.wordpress.com/2025/05/05/g-shock-watch-integration-with-sxmo/>`_ for using the library in the `SXMO <https://sxmo.org/>`_ mobile environment.
+See also `this blog <https://digitalsober.wordpress.com/2024/05/05/g-shock-watch-integration-with-sxmo/>`_ for using the library in the `SXMO <https://sxmo.org/>`_ mobile environment.
 
 Troubleshooting:
 ================