juham-core 0.2.2__tar.gz → 0.2.4__tar.gz

{juham_core-0.2.2/juham_core.egg-info → juham_core-0.2.4}/PKG-INFO

@@ -1,35 +1,10 @@
 Metadata-Version: 2.4
 Name: juham-core
-Version: 0.2.2
+Version: 0.2.4
 Summary: Juha's Ultimate Home Automation Core
 Author-email: J Meskanen <juham.api@gmail.com>
 Maintainer-email: "J. Meskanen" <juham.api@gmail.com>
-License: LICENSE
-        =======
-        
-        Copyright (c) 2024, Juha Meskanen
-        
-        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. **
-        
-        
+License-Expression: MIT
 Project-URL: Homepage, https://gitlab.com/juham/juham/juham_core
 Project-URL: Bug Reports, https://gitlab.com/juham/juham/juham_core
 Project-URL: Funding, https://meskanen.com
@@ -39,12 +14,11 @@ Keywords: home,automation,juham
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Topic :: Software Development
-Classifier: License :: Public Domain
 Classifier: Programming Language :: Python :: 3.8
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE.rst
-Requires-Dist: masterpiece>=0.1.48
+Requires-Dist: masterpiece>=0.1.51
 Requires-Dist: masterpiece_influx>=0.1.9
 Requires-Dist: masterpiece_pahomqtt>=0.1.5
 Requires-Dist: requests>=2.31

juham_core-0.2.4/docs/source/CHANGELOG.rst

@@ -0,0 +1,78 @@
+Changelog
+=========
+
+
+[0.2.3] - November, 26 2025
+---------------------------
+
+- Logging improved: if mqtt topic of the incoming message is not recongized then log the topic and the message.
+
+
+
+[0.2.1] - November, 22 2025
+---------------------------
+
+- Support for supervisor thread added. The thread listens thread crash reports,
+  logs them and restarts the crashed threads.
+
+
+[0.1.7] - November, 15 2025
+---------------------------
+
+- Package version number and dependencies updated, no functional changes.
+
+
+[0.1.6] - October, 31 2025
+--------------------------
+
+- Added `elapsed_seconds_in_interval()` to `timeutils`.
+- Generalized `elapsed_seconds_in_hour()` and `elapsed_seconds_in_day()` to use the new method.
+
+
+
+[0.1.4] - March, 09 2025
+------------------------
+
+- ``pyproject.toml`` - dependencies updated
+
+
+[0.1.1] - March, 03 2025
+------------------------
+
+- Redundancy eliminated from the bloated Sphinx conf.py.
+
+
+[0.0.8] - March, 02 2025
+------------------------
+
+- Documentation refactored.
+
+
+[0.0.5, 0.0.6] - February, 16 2025
+----------------------------------
+
+- References to optional plugins removed from the example application ``examples/myapp.py``. 
+
+- Version of the ``masterpiece`` dependency updated.
+
+- ``README.rst`` updated.
+
+
+
+[0.0.4] - February, 14 2025
+---------------------------
+
+- Time zone bug in timeutils.py fixed.
+  
+
+[0.0.3] - January, 25 2025
+--------------------------
+
+- **Refactorization:** Class names renamed for consistency.
+
+
+[0.0.1] - January, 25 2025
+--------------------------
+
+- **Initial release:** ``Juham`` base class with MQTT and Timeseries abstraction.
+

juham_core-0.2.4/docs/source/CONTRIBUTING.rst

@@ -0,0 +1,44 @@
+Contributing to Juham™ - Juha's Ultimate Home Automation Masterpiece
+====================================================================
+
+Thank You!
+----------
+
+Thank you in advance for your forthcoming contributions, whether they are bug fixes, 
+documentation improvements, entirely new features, or simply feedback. Your efforts 
+will be highly appreciated and will help turn this project from its current mission 
+state into an actual masterpiece.
+
+
+Design Patterns
+---------------
+
+Please read the developer documentation and understand the few design patterns behind Juham™ before contributing. 
+This will help ensure that your contributions align with the project's design and goals.
+.. todo:: (okay, the documentation is currently lacking many essential chapters, add.)
+
+
+Code Formatting
+---------------
+
+To help maintain consistent code formatting across different developers, we use 'black' python formatter, by Microsoft.
+
+Strange, the formatter doesn't seem to format that much, it doesn't organize imports, 
+doesn't adjust docstring lenghts
+.. todo:: most likely I don't know how to use it properly, read the docs.
+
+
+Using Emacs and Makefile
+------------------------
+
+Despite my attempts to fall in love with Eclipse, VSCode and other IDEs, I still find Emacs and Makefile the best
+tools for many workflows. 
+So there is a Makefile in the root folder. For those old dogs who are like me
+::
+    
+    make help
+
+More Stuff
+----------
+.. todo:: TBA
+

juham_core-0.2.4/docs/source/LICENSE.rst

@@ -0,0 +1,25 @@
+LICENSE
+=======
+
+Copyright (c) 2024, Juha Meskanen
+
+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. **
+

juham_core-0.2.4/docs/source/README.rst

@@ -0,0 +1,38 @@
+Welcome to Juham™ - Juha's Ultimate Home Automation Core
+========================================================
+
+Description
+-----------
+
+``juham-core`` extends the functionality of ``Masterpiece`` object by adding capabilities for MQTT
+communication and integration with time series databases. The base class provides only a minimal
+set of interfaces. Actual features, such as MQTT and time series database implementations — along with home
+automation-specific functionalities — are provided through separate plugin modules built on ``juham-core`` class.
+
+
+Project Status and Goals
+------------------------
+
+**Current State**: **Beta (Status 4)**  
+
+The aim of Juham™ is to have fun learning Python and the GitLab ecosystem while developing a home automation framework capable of controlling all devices in Juha's home, with the potential to be adapted for other homes as well.
+
+In its current form, Juham™ no longer stands for a “mess,” though it isn’t quite a “masterpiece” yet either. Still working hard to turn it into a masterpiece!
+
+
+
+Special Thanks
+--------------
+
+This project would not have been possible without the generous support of two exceptional individuals: Teppo K. and Mahi.
+
+Teppo K. provided the initial spark for this project by donating a Raspberry Pi, a temperature sensor, and giving an inspiring
+demonstration of his own home automation system—effectively dragging me down the rabbit hole of endless tinkering.
+
+Mahi has been instrumental in translating my half-baked ideas into Python code, offering invaluable support and
+encouragement—while also ensuring that every time I thought I was done, I wasn’t.
+
+Because of these two gentlemen, my already minimal spare time dropped into the negatives as I desperately tried to push the
+system to some semblance of professionalism.
+
+I’m truly grateful to both—really. 😅

{juham_core-0.2.2 → juham_core-0.2.4}/juham_core/juham.py

@@ -161,12 +161,19 @@ class Juham(MasterPiece):
 
         m = json.loads(msg.payload)
         if msg.topic == self.mqtt_topic_control:
-            if m["command"] == "shutdown" and self.mqtt_client:
-                self.info(f"{self.name} shutting down on command")
-                self.mqtt_client.disconnect()
-                self.mqtt_client.loop_stop()
+            if m["command"] == "shutdown":
+                if self.mqtt_client:
+                    self.info(f"{self.name} shutting down on command")
+                    self.mqtt_client.disconnect()
+                    self.mqtt_client.loop_stop()
+                else:
+                    self.warning(f"No mqtt client {msg.topic}", m)
+            else:
+                self.error(f"Unknown command {msg.topic}", m)
         else:
-            self.warning(f"{self.name}  unknown topic {msg.topic}, {m} ")
+            self.warning(f"Unknown topic {msg.topic}",m)
+
+
 
 
     def on_connect(self, client: object, userdata: Any, flags: int, rc: int) -> None:

{juham_core-0.2.2 → juham_core-0.2.4}/juham_core/juham_thread.py

@@ -33,7 +33,7 @@ class JuhamThread(JuhamTs):
 
     """
 
-    _systemstatus_topic : str = "status"
+    _systemstatus_topic : str = "status" # TODO: design bug: should not be here
     _error_queue : Queue = Queue()
     _supervisor: Optional["SupervisorThread"] = None
 

{juham_core-0.2.2 → juham_core-0.2.4/juham_core.egg-info}/PKG-INFO

@@ -1,35 +1,10 @@
 Metadata-Version: 2.4
 Name: juham-core
-Version: 0.2.2
+Version: 0.2.4
 Summary: Juha's Ultimate Home Automation Core
 Author-email: J Meskanen <juham.api@gmail.com>
 Maintainer-email: "J. Meskanen" <juham.api@gmail.com>
-License: LICENSE
-        =======
-        
-        Copyright (c) 2024, Juha Meskanen
-        
-        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. **
-        
-        
+License-Expression: MIT
 Project-URL: Homepage, https://gitlab.com/juham/juham/juham_core
 Project-URL: Bug Reports, https://gitlab.com/juham/juham/juham_core
 Project-URL: Funding, https://meskanen.com
@@ -39,12 +14,11 @@ Keywords: home,automation,juham
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Topic :: Software Development
-Classifier: License :: Public Domain
 Classifier: Programming Language :: Python :: 3.8
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE.rst
-Requires-Dist: masterpiece>=0.1.48
+Requires-Dist: masterpiece>=0.1.51
 Requires-Dist: masterpiece_influx>=0.1.9
 Requires-Dist: masterpiece_pahomqtt>=0.1.5
 Requires-Dist: requests>=2.31

juham_core-0.2.4/juham_core.egg-info/SOURCES.txt

@@ -0,0 +1,32 @@
+LICENSE.rst
+MANIFEST.in
+README.rst
+pyproject.toml
+docs/source/CHANGELOG.rst
+docs/source/CONTRIBUTING.rst
+docs/source/LICENSE.rst
+docs/source/README.rst
+examples/myapp.py
+juham_core/__init__.py
+juham_core/juham.py
+juham_core/juham_cloud.py
+juham_core/juham_thread.py
+juham_core/juham_ts.py
+juham_core/py.typed
+juham_core/timeutils.py
+juham_core.egg-info/PKG-INFO
+juham_core.egg-info/SOURCES.txt
+juham_core.egg-info/dependency_links.txt
+juham_core.egg-info/requires.txt
+juham_core.egg-info/top_level.txt
+tests/__init__.py
+tests/test_juham.py
+tests/test_juham_ts.py
+tests/test_timeutils.py
+tests/__pycache__/__init__.cpython-312.pyc
+tests/__pycache__/test_juham.cpython-312-pytest-9.0.1.pyc
+tests/__pycache__/test_juham.cpython-312.pyc
+tests/__pycache__/test_juham_ts.cpython-312-pytest-9.0.1.pyc
+tests/__pycache__/test_juham_ts.cpython-312.pyc
+tests/__pycache__/test_timeutils.cpython-312-pytest-9.0.1.pyc
+tests/__pycache__/test_timeutils.cpython-312.pyc

{juham_core-0.2.2 → juham_core-0.2.4}/juham_core.egg-info/requires.txt

@@ -1,4 +1,4 @@
-masterpiece>=0.1.48
+masterpiece>=0.1.51
 masterpiece_influx>=0.1.9
 masterpiece_pahomqtt>=0.1.5
 requests>=2.31

{juham_core-0.2.2 → juham_core-0.2.4}/pyproject.toml

@@ -7,11 +7,11 @@ include-package-data = true
 
 [project]
 name = "juham-core"
-version = "0.2.2"
+version = "0.2.4"
 description = "Juha's Ultimate Home Automation Core"
 readme = {file = "README.rst", content-type = "text/markdown"}
 requires-python = ">=3.8"
-license = {file = "LICENSE.rst", content-type = "text/markdown"}
+license = "MIT"
 keywords = ["home", "automation", "juham"]
 authors = [
   {name = "J Meskanen", email = "juham.api@gmail.com" }
@@ -24,12 +24,11 @@ classifiers = [
   "Development Status :: 4 - Beta",
   "Intended Audience :: Developers",
   "Topic :: Software Development",
-  "License :: Public Domain",
   "Programming Language :: Python :: 3.8",
 ]
 
 dependencies = [
-  "masterpiece >= 0.1.48",
+  "masterpiece >= 0.1.51",
   "masterpiece_influx >= 0.1.9",
   "masterpiece_pahomqtt >= 0.1.5",
   "requests >= 2.31",

juham_core-0.2.2/juham_core.egg-info/SOURCES.txt

@@ -1,21 +0,0 @@
-LICENSE.rst
-MANIFEST.in
-README.rst
-pyproject.toml
-examples/myapp.py
-juham_core/__init__.py
-juham_core/juham.py
-juham_core/juham_cloud.py
-juham_core/juham_thread.py
-juham_core/juham_ts.py
-juham_core/py.typed
-juham_core/timeutils.py
-juham_core.egg-info/PKG-INFO
-juham_core.egg-info/SOURCES.txt
-juham_core.egg-info/dependency_links.txt
-juham_core.egg-info/requires.txt
-juham_core.egg-info/top_level.txt
-tests/__init__.py
-tests/test_juham.py
-tests/test_juham_ts.py
-tests/test_timeutils.py