Skip to main content

A Python client for Themo smart thermostats

Project description

pythemo - Python Themo API Client

The pythemo repository provides a Python client for interacting with the Themo API. This library allows you to authenticate, fetch, and control devices associated with your Themo account.

Features

  • Authentication: Authenticate with the Themo API using your username and password.
  • Device Information: Fetch all devices associated with your account.
  • Control Devices: Control device attributes like lights, temperature, mode, and schedules.

File Descriptions

models.py

The models.py file contains the Device class which represents a Themo device. This class provides:

  • Initialization of the device with its ID and token.
  • Methods to fetch and update the device state and attributes.
  • Methods to control the device, including setting lights, temperature, mode, and schedules.

client.py

The client.py file contains the ThemoClient class which is responsible for:

  • Authenticating the user and obtaining the access token.
  • Fetching the client ID.
  • Fetching all devices associated with the user's account.
  • Closing the client session.

Usage

To use this library, you need to:

  1. Create an instance of the ThemoClient class using your Themo account credentials (username and password).
  2. Call the authenticate() method to obtain the access token.
  3. Fetch devices using the get_all_devices() method.
  4. For each device, you can fetch and update its state, control its attributes, and manage its schedules using methods provided in the Device class.

Dependencies

  • httpx: A fully featured HTTP client for Python 3.

Contributions

Contributions to the pythemo repository are welcome. Please ensure that you follow the coding conventions and write tests for any new features or changes.

License

This project is licensed under the MIT License. See the LICENSE file for more details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pythemo-0.2.2.tar.gz (5.2 kB view details)

Uploaded Source

Built Distribution

pythemo-0.2.2-py3-none-any.whl (6.1 kB view details)

Uploaded Python 3

File details

Details for the file pythemo-0.2.2.tar.gz.

File metadata

  • Download URL: pythemo-0.2.2.tar.gz
  • Upload date:
  • Size: 5.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.21

File hashes

Hashes for pythemo-0.2.2.tar.gz
Algorithm Hash digest
SHA256 a27b72f6fe232c43a5ba03e8556b8278b11f1ca6f76156a3f385950d5442bb58
MD5 0d21749134d9c878b88488b3c392393a
BLAKE2b-256 17270ba3b9eb7a83c51ddf580230ac6c0cd58fba835d387a12d51bbae5c4167e

See more details on using hashes here.

File details

Details for the file pythemo-0.2.2-py3-none-any.whl.

File metadata

  • Download URL: pythemo-0.2.2-py3-none-any.whl
  • Upload date:
  • Size: 6.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.21

File hashes

Hashes for pythemo-0.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 f0f579e66884fb9ad88d3c3bae3367e348cac097d888801e3a1a62490db0e0a1
MD5 761ff375bd06a388ccd9e09d440589a3
BLAKE2b-256 747ca220750f026f458a04d5de2a464073a4749b8a6f56c951531ba1447eca1d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page