Skip to main content

Async Python wrapper for the Rituals Perfume Genie API

Project description

PyRituals package

PyPI PyPI - Downloads PyPI - License

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 Diffusers.

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

pyrituals-0.0.6.tar.gz (17.1 kB view details)

Uploaded Source

Built Distribution

pyrituals-0.0.6-py3-none-any.whl (17.4 kB view details)

Uploaded Python 3

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

Hashes for pyrituals-0.0.6.tar.gz
Algorithm Hash digest
SHA256 cde3e2cbf18595599fa9c70b29e00242cdc2a1e5806e9f93864cebb8bf710907
MD5 02a91c20c071068c0768447c64839c35
BLAKE2b-256 8d971364136ac7b9668f28def833beffcdbf1cee6adf9bc827934cf941fb3ebf

See more details on using hashes here.

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

Hashes for pyrituals-0.0.6-py3-none-any.whl
Algorithm Hash digest
SHA256 e596ad5fbcd562ce7245551379c861fe5c026410e324ddaa8a6752b989a62bfa
MD5 404290df201151ee419ecb02e36866d4
BLAKE2b-256 cca4553dc0b023cd869e5f9a9e88d59d0581a8c2518b837a08d10495eb94d6d1

See more details on using hashes here.

Supported by

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