Metadata-Version: 2.4
Name: waterfurnace
Version: 1.2.0
Summary: Python interface for waterfurnace geothermal systems
Home-page: https://github.com/sdague/waterfurnace
Author: Sean Dague
Author-email: sean@dague.net
License: Apache Software License 2.0
Keywords: waterfurnace
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Description-Content-Type: text/x-rst
License-File: LICENSE
License-File: AUTHORS.rst
Requires-Dist: Click>=6.0
Requires-Dist: requests>=2.18
Requires-Dist: websocket-client>=0.47
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: summary

============
waterfurnace
============


.. image:: https://img.shields.io/pypi/v/waterfurnace.svg
   :target: https://pypi.python.org/pypi/waterfurnace

.. image:: https://img.shields.io/travis/sdague/waterfurnace.svg
   :target: https://travis-ci.org/sdague/waterfurnace

.. image:: https://readthedocs.org/projects/waterfurnace/badge/?version=latest
   :target: https://waterfurnace.readthedocs.io/en/latest/?badge=latest
   :alt: Documentation Status

.. image:: https://pyup.io/repos/github/sdague/waterfurnace/shield.svg
   :target: https://pyup.io/repos/github/sdague/waterfurnace/
   :alt: Updates


Python interface for waterfurnace and geostar geothermal systems.

This provides basic sensor readings for waterfurnace geothermal systems by
using the websocket interface that exists for the symphony website. This is not
a documented or stable interface, so don't use this for critical
systems. However, it is useful to record historical usage of your waterfurnace
system.

Usage
=====

.. code-block:: python

   from waterfurnace.waterfurnace import WaterFurnace
   wf = WaterFurnace(user, pass)
   wf.login()
   data = wf.read()

.. code-block:: python

   from waterfurnace.waterfurnace import GeoStar
   gs = GeoStar(user, pass)
   gs.login()
   data = gs.read()

The waterfurnace symphony service websocket monitors it's usage, so you need to
do a data reading at least every 30 seconds otherwise the websocket is closed
on the server side for resource constraints. The symphony website does a poll
on the websocket every 5 seconds.

The software now supports a CLI.  For details, use waterfurnace --help

Known Issues / limitations
==========================

* The python websocket code goes into a blocked state after long periods of
  usage (always takes days to get to this state). I've yet to discover
  why. Help welcome.
* If you have multiple waterfurnace units on one account, this will only use
  the first.


License
=======

* Free software: Apache Software License 2.0
* Documentation: https://waterfurnace.readthedocs.io.


Credits
=======

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage


History
=======

1.2.0 (2025-09-13)
------------------
* Add SSL legacy compatibility to connect with modern SSL. Addresses
  UNSAFE_LEGACY_RENEGOTIATION_DISABLED error.
* Add LeavingWaterTemp and WaterFlowRate sensors (Series 7 WF)
* Added features to CLI (for details see --help)
  * Added debug flag 
  * Added option sensor list specification 
  * Added continous reporting 
  * Added ability to specify furnace in a multi unit system

1.1.0 (2019-01-07)
------------------
* Fix retry logic

1.0.0 (2018-12-05)
------------------
* Detect unit automatically
* Add series 7 sensors

0.7.0 (2018-07-13)
------------------

* Add workaround timer to handle socket failures

0.6.0 (2018-02-21)
------------------

* Add timeout on socket

0.5.0 (2018-02-16)
------------------

* Update exception handling to be more Home Assistant friendly

0.4.0 (2018-02-05)
------------------

* More exceptions to distinguish errors we are expecting

0.3.0 (2018-01-23)
------------------

* Handle tid rollover

0.2.0 (2018-01-19)
------------------

* Library specific exceptions for login failures.

0.1.0 (2018-01-17)
------------------

* First release on PyPI.
