SurePetcare API Client

---

About

Python client for interacting with the SurePetcare API:

https://app-api.beta.surehub.io/index.html?urls.primaryName=V1

Includes:

• Core async IO client (surepcio)
• CLI tool (surepccli)

For Home Assistant integration see: https://github.com/FredrikM97/hass-surepetcare

CLI

This repo also support (to some extent) cli commands. The cli can be installed with uv sync --extra cli and is not included by default.

To see available commands use:

surepccli --help

However, most functionality requires login therefore use the

surepccli account login <email> 

It is possible to fetch available households with:

surepccli household

There is also support to store some properties in .env file. Check available properties to the household and device for more info.

Supported devices

• Hub
• Pet door
• Feeder Connect
• Dual Scan Connect
• Dual Scan Pet Door
• poseidon Connect
• No ID Dog Bowl Connect

Enjoy the integration?

Star ⭐ the repository to help others discover the integration.

Contributing

1. Before pushing validate the changes with: pre-commit run --all-files..
2. Run uv sync --all-extras --dev to install development dependencies from uv.lock.
3. Use uv lock when dependency constraints change and commit the updated uv.lock.
4. Run tests with uv run pytest tests and snapshot updates with uv run pytest --snapshot-update tests.
5. For a quick vulnerability check against the lockfile: uv export --frozen --all-extras --format requirements-txt --no-hashes -o requirements.lock.txt && uv tool run --from pip-audit pip-audit -r requirements.lock.txt.
6. Start application and enable debug. The debug logs contain request data that can be provided with an issue and for snapshot testing.