Metadata-Version: 2.4
Name: hiplis
Version: 0.1.4
Summary: Juha's summer cottage automation application
Author-email: J Meskanen <juham.api@gmail.com>
Maintainer-email: "J. Meskanen" <juham.api@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://gitlab.com/juham/hiplis
Project-URL: Bug Reports, https://gitlab.com/juham/hiplis
Project-URL: Funding, https://meskanen.com
Project-URL: Say Thanks!, http://meskanen.com
Project-URL: Source, https://gitlab.com/juham/hiplis
Keywords: home,automation,juham,masterpiece
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE.rst
Requires-Dist: juham-automation>=0.2.5
Requires-Dist: juham-visualcrossing>=0.1.9
Requires-Dist: juham-openweathermap>=0.1.10
Requires-Dist: juham-systemstatus>=0.1.13
Requires-Dist: juham-watermeter>=0.1.1
Requires-Dist: juham-shelly>=0.1.7
Requires-Dist: juham-homewizard>=0.1.0
Requires-Dist: juham-simulation>=0.1.1
Requires-Dist: importlib-metadata
Provides-Extra: dev
Requires-Dist: check-manifest; extra == "dev"
Dynamic: license-file

Hiplis
======

Hiplis™ is a home automation application built on top of the Juham™ framework.
One day, it will control Juha’s vacation home.
For now, it exists purely as a simulation test bed.


Motivation
----------

Yes, existing home automation solutions exist — for example, Home Assistant.
I decided not to use any of them, because that would be incredibly boring.
Instead, I chose to build one from scratch, because it seemed like a much more exciting way to learn Python and the GitLab ecosystem.

It hasn’t been all fun, though.

Sphinx and its extremely fragile .rst syntax have haunted me from day one.
Python has tried to drive me crazy too — with its indentation-based structure, endless deprecations, random bugs, and the limitations of its type annotation system.

At several points I seriously regretted not writing everything in C/C++.
But in the end, I don’t regret anything.
Despite all the ups and downs, this project has been exactly what I needed to avoid wasting my spare time on something even more pointless.



Project Status
--------------

**Current State**: **Alpha (Status 3)**  

Please check out the `CHANGELOG <CHANGELOG.rst>`_ file for changes in this release.


Installation
------------

The installation is two stage process

1. To install:

.. code-block:: python

    pip install hiplis


2. Configure

   OpenWeatherMap and various other services require you to register and obtain web keys and things like
   that. Most importantly, Influx DB and Graphana cloud accounts must be created for data visualization.
   Please consult 'juham' documentation for more information.



License
-------

This project is licensed under the MIT License - see the `LICENSE <LICENSE.rst>`_ file.

