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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: juham-core
-Version: 0.2.2
+Version: 0.2.3
 Summary: Juha's Ultimate Home Automation Core
 Author-email: J Meskanen <juham.api@gmail.com>
 Maintainer-email: "J. Meskanen" <juham.api@gmail.com>

juham_core-0.2.3/docs/source/CHANGELOG.rst

@@ -0,0 +1,72 @@
+Changelog
+=========
+
+
+
+[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.3/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.3/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.3/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.3}/juham_core/juham.py

@@ -161,12 +161,17 @@ 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.3/juham_core.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: juham-core
-Version: 0.2.2
+Version: 0.2.3
 Summary: Juha's Ultimate Home Automation Core
 Author-email: J Meskanen <juham.api@gmail.com>
 Maintainer-email: "J. Meskanen" <juham.api@gmail.com>

{juham_core-0.2.2 → juham_core-0.2.3}/juham_core.egg-info/SOURCES.txt

@@ -2,6 +2,10 @@ 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
@@ -18,4 +22,8 @@ juham_core.egg-info/top_level.txt
 tests/__init__.py
 tests/test_juham.py
 tests/test_juham_ts.py
-tests/test_timeutils.py
+tests/test_timeutils.py
+tests/__pycache__/__init__.cpython-312.pyc
+tests/__pycache__/test_juham.cpython-312.pyc
+tests/__pycache__/test_juham_ts.cpython-312.pyc
+tests/__pycache__/test_timeutils.cpython-312.pyc

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

@@ -7,7 +7,7 @@ include-package-data = true
 
 [project]
 name = "juham-core"
-version = "0.2.2"
+version = "0.2.3"
 description = "Juha's Ultimate Home Automation Core"
 readme = {file = "README.rst", content-type = "text/markdown"}
 requires-python = ">=3.8"