Library & CLI to interact with the Sure Petcare API. surepy lets you monitor and control the Pet Door/Cat Flap Connect ๐ช and the Pet Feeder Connect ๐ฝ by Sure Petcare.
surepy features
๐ get an api token with your account credentials
๐ช lock/unlock a door or flap
๐พ get the location of pets & devices
๐ get the state and more attributes of pets & devices
๐ฐ๏ธ get historic data & events of pets & devices
๐ฌ get a list of (past) notifications
surepy is available via pypi.org
python3 -m pip install --upgrade surepy
# or
pip install --upgrade surepy
there is also a small cli available
$ surepy --help
Usage: surepy [OPTIONS] COMMAND [ARGS]...
surepy cli ๐พ
https://github.com/benleb/surepy
Options:
--version show surepy version
-j, --json enable json api response output
-t, --token TEXT api token
--help Show this message and exit.
Commands:
devices get devices
locking lock control
notification get notifications
pets get pets
position set pet position
report get pet/household report
token get a token
the cli is mainly intended for developing & debugging purposes and probably has bugs - be careful ๐พ
import asyncio
from os import environ
from pprint import pprint
from typing import Dict, List
from surepy import Surepy
from surepy.entities import SurepyEntity
from surepy.entities.devices import SurepyDevice
from surepy.entities.pet import Pet
async def main():
# # user/password authentication (gets a token in background)
# surepy = Surepy(email=user, password=password)
# token authentication (token supplied via SUREPY_TOKEN env var)
token = environ.get("SUREPY_TOKEN")
surepy = Surepy(auth_token=token)
# list with all pets
pets: List[Pet] = await surepy.get_pets()
for pet in pets:
print(f"\n\n{pet.name}: {pet.state} | {pet.location}\n")
pprint(pet.raw_data())
print(f"\n\n - - - - - - - - - - - - - - - - - - - -\n\n")
# all entities as id-indexed dict
entities: Dict[int, SurepyEntity] = await surepy.get_entities()
# list with alldevices
devices: List[SurepyDevice] = await surepy.get_devices()
for device in devices:
print(f"{device.name = } | {device.serial = } | {device.battery_level = }")
print(f"{device.type = } | {device.unique_id = } | {device.id = }")
print(f"{entities[device.parent_id].full_name = } | {entities[device.parent_id] = }\n")
asyncio.run(main())
- Sure Petcare integration in Home Assistant
Feel free to add you project!
- Thanks to all the people who provided information about devices I do not own myself, thanks!
- Thanks to @rcastberg for hist previous work on the Sure Petcare API (github.com/rcastberg/sure_petcare)
- Thanks to @wei for the header image generator (github.com/wei/socialify)
Ben Lebherz: cat lover ๐พ developer & maintainer - @benleb | @ben_leb
This project is licensed under the MIT License - see the LICENSE file for details