juham-visualcrossing 0.0.1__py3-none-any.whl → 0.0.3__py3-none-any.whl

juham_visualcrossing/py.typed

@@ -0,0 +1 @@
+

juham_visualcrossing/visualcrossing.py

@@ -1,8 +1,9 @@
 from datetime import datetime, timedelta, timezone
 import json
+from typing import Any, Dict, Optional, cast
+from typing_extensions import override  # for python 3.9 compatibility
 
-from typing import Any
-from juham.base import Base
+from juham.base import Base, MqttMsg, JMqtt
 from juham.web import RCloud, RCloudThread
 
 
@@ -11,13 +12,13 @@ class VisualCrossingThread(RCloudThread):
     site."""
 
     # class attributes
-    _forecast_topic = ""
-    _base_url = ""
-    _api_key = ""
-    _location = ""
+    _forecast_topic: str = ""
+    _base_url: str = ""
+    _api_key: str = ""
+    _location: str = ""
     _interval: float = 12 * 3600
 
-    def __init__(self, client=None):
+    def __init__(self, client: Optional[JMqtt] = None):
         """Construct with the given mqtt client. Acquires data from the visual
         crossing web service and publishes the forecast data to
         forecast_topic.
@@ -26,13 +27,14 @@ class VisualCrossingThread(RCloudThread):
             client (object, optional): MQTT client. Defaults to None.
         """
         super().__init__(client)
-        self.mqtt_client = client
+        self.mqtt_client: Optional[JMqtt] = client
 
+    @override
     def update_interval(self) -> float:
         return self._interval
 
-    # @override
-    def make_url(self) -> str:
+    @override
+    def make_weburl(self) -> str:
         if not self._api_key:
             self.error("Uninitialized api_key {self.get_class_id()}: {self._api_key}")
             return ""
@@ -63,8 +65,8 @@ class VisualCrossingThread(RCloudThread):
         self._api_key = api_key
         self._location = location
 
-    # @override
-    def process_data(self, data: Any):
+    @override
+    def process_data(self, data: Any) -> None:
         self.info("VisualCrossing process_data()")
         data = data.json()
         forecast = []
@@ -112,24 +114,35 @@ class VisualCrossing(RCloud):
     update_interval.
     """
 
-    workerThreadId = VisualCrossingThread.get_class_id()
-    forecast_topic = Base.mqtt_root_topic + "/forecast"
-    base_url = "https://weather.visualcrossing.com/VisualCrossingWebServices/rest/services/timeline/"
-    update_interval = 12 * 3600
-    api_key = "SE9W7EHP775N7NDNW8ANM2MZN"
-    location = "lahti,finland"
+    workerThreadId: str = VisualCrossingThread.get_class_id()
+    base_url: str = (
+        "https://weather.visualcrossing.com/VisualCrossingWebServices/rest/services/timeline/"
+    )
+    update_interval: float = 12 * 3600
+    api_key: str = "SE9W7EHP775N7NDNW8ANM2MZN"
+    location: str = "lahti,finland"
 
-    def __init__(self, name="visualcrossing"):
+    def __init__(self, name="visualcrossing") -> None:
+        """Constructs VisualCrossing automation object for acquiring and publishing
+        forecast data.
+
+        Args:
+            name (str, optional): name of the object. Defaults to "visualcrossing".
+        """
         super().__init__(name)
-        self.debug(f"VisualCrossing created")
+        self.worker: Optional[VisualCrossingThread] = None
+        self.forecast_topic: str = self.make_topic_name("forecast")
+        self.debug(f"VisualCrossing with name {name} created")
 
-    def on_connect(self, client, userdata, flags, rc):
+    @override
+    def on_connect(self, client: object, userdata: Any, flags: int, rc: int) -> None:
         super().on_connect(client, userdata, flags, rc)
         if rc == 0:
             self.subscribe(self.forecast_topic)
             self.debug(f"VisualCrossing subscribed to topic {self.forecast_topic}")
 
-    def on_message(self, client, userdata, msg):
+    @override
+    def on_message(self, client: object, userdata: Any, msg: MqttMsg) -> None:
         if msg.topic == self.forecast_topic:
             em = json.loads(msg.payload.decode())
             self.on_forecast(em)
@@ -144,10 +157,13 @@ class VisualCrossing(RCloud):
         """
         self.debug(f"VisualCrossing: got mqtt message {em}")
 
-    # @override
-    def run(self):
+    @override
+    def run(self) -> None:
         # create, initialize and start the asynchronous thread for acquiring forecast
-        self.worker = Base.instantiate(VisualCrossing.workerThreadId)
+
+        self.worker = cast(
+            VisualCrossingThread, Base.instantiate(VisualCrossing.workerThreadId)
+        )
         self.worker.init(
             self.forecast_topic,
             self.base_url,
@@ -155,14 +171,13 @@ class VisualCrossing(RCloud):
             self.api_key,
             self.location,
         )
-        self.debug(f"VisualCrossing.run(): base_url is {self.base_url}")
-        self.debug(f"VisualCrossing.run(): interval is {self.update_interval}")
-        self.debug(f"VisualCrossing.run(): api_key is {self.api_key}")
-        self.debug(f"VisualCrossing.run(): location is {self.location}")
+        self.debug(
+            f"VisualCrossing run: {self.base_url}, {self.update_interval}s, location is {self.location}"
+        )
         super().run()
 
-    # @override
-    def to_dict(self):
+    @override
+    def to_dict(self) -> dict:
         data = super().to_dict()
         data["_visualcrossing"] = {
             "topic": self.forecast_topic,
@@ -172,8 +187,8 @@ class VisualCrossing(RCloud):
         }
         return data
 
-    # @override
-    def from_dict(self, data):
+    @override
+    def from_dict(self, data) -> None:
         super().from_dict(data)
         if "_visualcrossing" in data:
             for key, value in data["_visualcrossing"].items():

{juham_visualcrossing-0.0.1.dist-info → juham_visualcrossing-0.0.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: juham_visualcrossing
-Version: 0.0.1
+Version: 0.0.3
 Summary: A Weather forecast  plugin extending `juham` applications
 Author-email: J Meskanen <juham.api@gmail.com>
 Maintainer-email: "J. Meskanen" <juham.api@gmail.com>
@@ -40,11 +40,11 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3.8
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
-Requires-Dist: juham >=0.0.7
-Requires-Dist: pytz >=2024.1
+Requires-Dist: juham>=0.0.12
+Requires-Dist: pytz>=2024.1
 Requires-Dist: importlib-metadata
 Provides-Extra: dev
-Requires-Dist: check-manifest ; extra == 'dev'
+Requires-Dist: check-manifest; extra == "dev"
 
 juham_visualcrossing
 ====================

juham_visualcrossing-0.0.3.dist-info/RECORD

@@ -0,0 +1,8 @@
+juham_visualcrossing/__init__.py,sha256=qsVRSTeJW8jgBtLviUjq5JiJ8Z6eYkBQn6zMWgS0okY,161
+juham_visualcrossing/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+juham_visualcrossing/visualcrossing.py,sha256=i-YPltSzG9oTrNSfNXVcQSmw5TGMzeVBy1O8DUwrHSo,7232
+juham_visualcrossing-0.0.3.dist-info/METADATA,sha256=PFAu6xjOyDX0fn2ATCRVYYOG91qkjun-fKTkbe72tys,3152
+juham_visualcrossing-0.0.3.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
+juham_visualcrossing-0.0.3.dist-info/entry_points.txt,sha256=A-NSi2RN5KSKwpbKG592v5qnWnGHmIjPktubd5PQ80M,76
+juham_visualcrossing-0.0.3.dist-info/top_level.txt,sha256=7yWaUHZo-Ng96VJBzUFhaFCBamL71PUjIxZISxMBjSM,21
+juham_visualcrossing-0.0.3.dist-info/RECORD,,

{juham_visualcrossing-0.0.1.dist-info → juham_visualcrossing-0.0.3.dist-info}/WHEEL

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

juham_visualcrossing-0.0.1.dist-info/RECORD

@@ -1,7 +0,0 @@
-juham_visualcrossing/__init__.py,sha256=qsVRSTeJW8jgBtLviUjq5JiJ8Z6eYkBQn6zMWgS0okY,161
-juham_visualcrossing/visualcrossing.py,sha256=W-FPKSJJ0IvxhKZhYOzmswbpu3Uuy6EZqE1r_Xjev14,6678
-juham_visualcrossing-0.0.1.dist-info/METADATA,sha256=865kbtRSCr1FqX-Tveq4kDyfZJchYhARu6bAyL6GFaM,3154
-juham_visualcrossing-0.0.1.dist-info/WHEEL,sha256=OVMc5UfuAQiSplgO0_WdW7vXVGAt9Hdd6qtN4HotdyA,91
-juham_visualcrossing-0.0.1.dist-info/entry_points.txt,sha256=A-NSi2RN5KSKwpbKG592v5qnWnGHmIjPktubd5PQ80M,76
-juham_visualcrossing-0.0.1.dist-info/top_level.txt,sha256=7yWaUHZo-Ng96VJBzUFhaFCBamL71PUjIxZISxMBjSM,21
-juham_visualcrossing-0.0.1.dist-info/RECORD,,