Async Python wrapper for the Rituals Perfume Genie API
Project description
PyRituals package
An async Python wrapper for the Rituals Perfume Genie API. It allows you to control the diffuser and retrieve its state. The package supports the first and second version.
Installation
pip install pyrituals
Usage
Import
from pyrituals import Account, Diffuser, AuthenticationException
Create a aiohttp.ClientSession
to make requests
from aiohttp import ClientSession
session = ClientSession()
Endpoints
Default endpoints:
AUTH_URL = "https://rituals.sense-company.com/ocapi/login" # Account.authenticate()
ACCOUNT_URL = "https://rituals.sense-company.com/api/account/hubs" # Account.get_devices()
HUB_URL = "https://rituals.sense-company.com/api/account/hub" # Diffuser.update_data()
UPDATE_URL = "https://rituals.sense-company.com/api/hub/update/attr" # Diffuser.turn_*(), Diffuser.set_*()
To change the used API endpoints add an url
parameter to the function. Example:
LOGIN_URL = "https://rituals.sense-company.com/ocapi/login"
account = Account("name@example.com", "passw0rd", session)
await account.authenticate(url=LOGIN_URL)
Account
Create an instance
email = "name@example.com"
password = "passw0rd"
account = Account(email, password, session)
Authenticate
try:
await account.authenticate()
except AuthenticationException as e:
print("Could not authenticate:", e)
Account data
The account data is only available after authentication.
account.data
Get linked devices
get_devices()
returns a list of Diffuser
s.
devices = await account.get_devices()
Diffuser
Diffuser data
The initial data and format is different from the data after executing update_data()
.
Some properties require data that is only available after executing update_data()
.
Therefore, it's required to execute update_data()
before using the diffuser properties.
diffuser.data
diffuser.battery_percentage
diffuser.charging
diffuser.has_battery
diffuser.has_cartridge
diffuser.hash
diffuser.hub_data
diffuser.hublot
diffuser.fill
diffuser.perfume
diffuser.perfume_amount
diffuser.room_size
diffuser.is_on
diffuser.is_online
diffuser.name
diffuser.version
diffuser.wifi_percentage
diffuser.room_size_square_meter
Get updated data
await diffuser.update_data()
Turn the diffuser on
await diffuser.turn_on()
Turn the diffuser off
await diffuser.turn_off()
Set the diffuser perfume amount
Amount must be an integer between 1 and 3, inclusive.
amount = 1
await diffuser.set_perfume_amount(amount)
Set the diffuser room size
Size must be an integer between 1 and 4, inclusive.
size = 2
await diffuser.set_room_size(size)
Set the diffuser room size in square meters
Size must be the integer 15, 30, 60 or 100.
size = 60
await diffuser.set_room_size_square_meter(size)
Example
from aiohttp import ClientSession
from asyncio import run
import pyrituals
async def main():
async with ClientSession() as session:
account = pyrituals.Account("name@example.com", "passw0rd", session)
try:
await account.authenticate()
except pyrituals.AuthenticationException as ex:
print("Could not authenticate:", ex)
return
print("Account data:", account.data)
devices = await account.get_devices()
for diffuser in devices:
print("Diffuser data:", diffuser.data)
await diffuser.turn_on()
await diffuser.set_perfume_amount(1)
await diffuser.set_room_size(4)
await diffuser.update_data()
print("Diffuser updated data:", diffuser.data)
if diffuser.has_battery:
print(f"Battery percentage: {diffuser.battery_percentage}%")
run(main())
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
Built Distribution
File details
Details for the file pyrituals-0.0.6.tar.gz
.
File metadata
- Download URL: pyrituals-0.0.6.tar.gz
- Upload date:
- Size: 17.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.1 importlib_metadata/4.5.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.1 CPython/3.9.5
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | cde3e2cbf18595599fa9c70b29e00242cdc2a1e5806e9f93864cebb8bf710907 |
|
MD5 | 02a91c20c071068c0768447c64839c35 |
|
BLAKE2b-256 | 8d971364136ac7b9668f28def833beffcdbf1cee6adf9bc827934cf941fb3ebf |
File details
Details for the file pyrituals-0.0.6-py3-none-any.whl
.
File metadata
- Download URL: pyrituals-0.0.6-py3-none-any.whl
- Upload date:
- Size: 17.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.1 importlib_metadata/4.5.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.1 CPython/3.9.5
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | e596ad5fbcd562ce7245551379c861fe5c026410e324ddaa8a6752b989a62bfa |
|
MD5 | 404290df201151ee419ecb02e36866d4 |
|
BLAKE2b-256 | cca4553dc0b023cd869e5f9a9e88d59d0581a8c2518b837a08d10495eb94d6d1 |