petsafe-api 3.0.1__py3-none-any.whl

petsafe/general.py

@@ -0,0 +1,29 @@
+"""Helpers for miscellaneous PetSafe platform endpoints."""
+
+from __future__ import annotations
+
+import json
+from typing import TYPE_CHECKING, Any, Dict, List
+
+if TYPE_CHECKING:  # pragma: no cover - for type checking only
+    from .client import PetSafeClient
+
+
+async def list_product_sharing(client: "PetSafeClient") -> List[Dict[str, Any]]:
+    """Return product sharing relationships for the authenticated account."""
+
+    response = await client.api_get("directory/product-sharing")
+    payload = json.loads(response.content.decode("UTF-8"))
+    data = payload.get("data", payload)
+    return data if isinstance(data, list) else [data]
+
+
+async def get_account_details(client: "PetSafeClient") -> Dict[str, Any]:
+    """Return the account details for the authenticated PetSafe user."""
+
+    response = await client.api_get("directory/account")
+    payload = json.loads(response.content.decode("UTF-8"))
+    data = payload.get("data", payload)
+    if isinstance(data, dict):
+        return data
+    raise ValueError("Unexpected response payload for account details")

petsafe/pets.py

@@ -0,0 +1,35 @@
+"""Convenience helpers for PetSafe pet-related API endpoints."""
+
+from __future__ import annotations
+
+import json
+from typing import TYPE_CHECKING, Any, Dict, List
+
+if TYPE_CHECKING:  # pragma: no cover - for type checking only
+    from .client import PetSafeClient
+
+
+async def list_pets(client: "PetSafeClient") -> List[Dict[str, Any]]:
+    """Return all pets configured in the account."""
+
+    response = await client.api_get("pets/pets")
+    payload = json.loads(response.content.decode("UTF-8"))
+    data = payload.get("data", payload)
+    return data if isinstance(data, list) else [data]
+
+
+async def list_pet_products(
+    client: "PetSafeClient", pet_id: str
+) -> List[Dict[str, Any]]:
+    """Return all products associated with the provided pet identifier."""
+
+    if not pet_id:
+        raise ValueError("pet_id must be provided")
+
+    from urllib.parse import quote_plus
+
+    path = f"directory/petProduct?petId={quote_plus(pet_id)}"
+    response = await client.api_get(path)
+    payload = json.loads(response.content.decode("UTF-8"))
+    data = payload.get("data", payload)
+    return data if isinstance(data, list) else [data]

petsafe_api-3.0.1.dist-info/METADATA

@@ -0,0 +1,264 @@
+Metadata-Version: 2.4
+Name: petsafe-api
+Version: 3.0.1
+Summary: Provides ability to connect and control a PetSafe Smart Feed, Scoopfree, and Smart Door devices using the PetSafe API.
+Home-page: https://github.com/ThomasHFWright/petsafe-api
+Author: Jordan Stremming & Dominick Meglio & Thomas Wright
+Author-email: thomas.h.f.wright@gmail.com
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx
+Requires-Dist: botocore
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# petsafe-api
+Connect and control PetSafe Smart Feed, ScoopFree, and Smart Door devices using the PetSafe API.
+
+> **BREAKING CHANGE:** Version 2.0 uses the new PetSafe API.
+> You will need to request new tokens.
+
+> PetSafe will lock your account if you request data more often than once per 5 minutes.
+
+## Project rename
+This repository is now named **petsafe-api** and the published package name is **petsafe-api** on PyPI.
+
+> Import paths are unchanged: continue using `import petsafe` and `python -m petsafe`.
+
+## Acknowledgements
+This project builds on the excellent prior work from the original developers:
+- https://github.com/Techzune/petsafe_smartfeed
+- https://github.com/dcmeglio/petsafe
+
+Thank you to both projects for building the API integrations for existing feeder and ScoopFree functionality. This repository includes all of that previous work, with Smart Door API support added on top.
+
+## Installation
+`pip install petsafe-api`
+
+If installing from source code,
+`python setup.py install`
+
+## Login tokens
+You **must** use tokens to interact with the PetSafe Smart-Feed API.  
+There are two methods to retrieve tokens:
+
+#### Get tokens using command line
+1. Execute `python -m petsafe [email_address]` to request an email code.
+2. Check your email for an email code from PetSafe.
+3. Enter your code to generate tokens.
+
+#### Get tokens using Python
+```python
+import petsafe as sf
+
+
+# replace with your email address
+client = sf.PetSafeClient(email="email@example.com")
+client.request_code()
+
+# check your email for a code
+code = input("Enter email code: ")
+token = client.request_tokens_from_code(code)
+
+print("email:", client.email)
+print("id_token:", client.id_token)
+print("refresh_token:", client.refresh_token)
+print("access_token:", client.access_token)
+```
+
+
+## Example usage
+#### List feeders
+
+```python
+import petsafe as sf
+
+client = sf.PetSafeClient(email="email@example.com",
+                       id_token="YOUR_ID_TOKEN",
+                       refresh_token="YOUR_REFRESH_TOKEN",
+                       access_token="YOUR_ACCESS_TOKEN")
+devices = sf.devices.get_feeders(client)
+
+# print all feeders
+for device in devices:
+    print(device)
+
+```
+#### Feed 1/8 cup at normal speed
+```python
+import petsafe as sf
+
+client = sf.PetSafeClient(email="email@example.com",
+                       id_token="YOUR_ID_TOKEN",
+                       refresh_token="YOUR_REFRESH_TOKEN",
+                       access_token="YOUR_ACCESS_TOKEN")
+devices = sf.devices.get_feeders(client)
+
+# get the first feeder
+feeder = devices[0]
+feeder.feed(amount=1, slow_feed=False)
+
+```
+#### Get current battery level (0 - 100)
+```python
+import petsafe as sf
+
+client = sf.PetSafeClient(email="email@example.com",
+                       id_token="YOUR_ID_TOKEN",
+                       refresh_token="YOUR_REFRESH_TOKEN",
+                       access_token="YOUR_ACCESS_TOKEN")
+devices = sf.devices.get_feeders(client)
+
+# get the first feeder
+feeder = devices[0]
+print(feeder.battery_level)
+
+```
+#### Get current food level
+```python
+import petsafe as sf
+
+client = sf.PetSafeClient(email="email@example.com",
+                       id_token="YOUR_ID_TOKEN",
+                       refresh_token="YOUR_REFRESH_TOKEN",
+                       access_token="YOUR_ACCESS_TOKEN")
+devices = sf.devices.get_feeders(client)
+
+# get the first feeder
+feeder = devices[0]
+status = feeder.food_low_status
+
+if status == 0:
+    print("Feeder has food.")
+elif status == 1:
+    print("Feeder is low on food.")
+elif status == 2:
+    print("Feeder is out of food.")
+
+```
+
+## SmartDoor controls
+```python
+import asyncio
+
+import petsafe as sf
+
+
+async def main() -> None:
+    client = sf.PetSafeClient(
+        email="email@example.com",
+        id_token="YOUR_ID_TOKEN",
+        refresh_token="YOUR_REFRESH_TOKEN",
+        access_token="YOUR_ACCESS_TOKEN",
+    )
+
+    doors = await client.get_smartdoors()
+    door = doors[0]
+
+    # Manually lock the door and refresh its reported state
+    await door.lock()
+
+    # Switch back to Smart mode without forcing a refresh
+    await door.smart_mode(update_data=False)
+
+    # Or use the client helpers that return the updated door instance
+    updated = await client.manual_unlock_smartdoor(door.api_name)
+    print(updated.mode)
+
+
+asyncio.run(main())
+```
+
+# get litterboxes
+```python
+import petsafe as sf
+
+client = sf.PetSafeClient(email="email@example.com",
+                       id_token="YOUR_ID_TOKEN",
+                       refresh_token="YOUR_REFRESH_TOKEN",
+                       access_token="YOUR_ACCESS_TOKEN")
+devices = sf.devices.get_litterboxes(client)
+
+# print all litterboxes
+for device in devices:
+    print(device)
+
+```
+
+# get litterbox activity
+```python
+import petsafe as sf
+
+client = sf.PetSafeClient(email="email@example.com",
+                       id_token="YOUR_ID_TOKEN",
+                       refresh_token="YOUR_REFRESH_TOKEN",
+                       access_token="YOUR_ACCESS_TOKEN")
+devices = sf.devices.get_litterboxes(client)
+
+litterbox = devices[0]
+print(litterbox.get_schedule())
+
+```
+
+# rake the litterbox
+```python
+import petsafe as sf
+
+client = sf.PetSafeClient(email="email@example.com",
+                       id_token="YOUR_ID_TOKEN",
+                       refresh_token="YOUR_REFRESH_TOKEN",
+                       access_token="YOUR_ACCESS_TOKEN")
+devices = sf.devices.get_litterboxes(client)
+
+litterbox = devices[0]
+litterbox.rake()
+
+```
+
+# modify the litterbox rake timer
+```python
+import petsafe as sf
+
+client = sf.PetSafeClient(email="email@example.com",
+                       id_token="YOUR_ID_TOKEN",
+                       refresh_token="YOUR_REFRESH_TOKEN",
+                       access_token="YOUR_ACCESS_TOKEN")
+devices = sf.devices.get_litterboxes(client)
+
+litterbox = devices[0]
+litterbox.modify_timer(15)
+
+```
+
+# reset the litterbox rake count
+```python
+import petsafe as sf
+
+client = sf.PetSafeClient(email="email@example.com",
+                       id_token="YOUR_ID_TOKEN",
+                       refresh_token="YOUR_REFRESH_TOKEN",
+                       access_token="YOUR_ACCESS_TOKEN")
+devices = sf.devices.get_litterboxes(client)
+
+litterbox = devices[0]
+litterbox.reset()
+
+```
+
+## Contributing
+All contributions are welcome. 
+Please, feel free to create a pull request!

petsafe_api-3.0.1.dist-info/RECORD

@@ -0,0 +1,12 @@
+petsafe/__init__.py,sha256=gAqJipbqEVw490qLBunZjB7rhYArvykjxnr-6l2SNKs,71
+petsafe/__main__.py,sha256=Reh0jBps179FX5eFiRiZGHuvWR2KL583DATe_KhUL0I,762
+petsafe/client.py,sha256=xpVo6xRYsR9rIfWlrqiHk8k4GfdjRwf3ESZcuh4ey7s,11972
+petsafe/const.py,sha256=OXxo-GfU_VJJY8ldy15jgyatplyLq-to-Wmfx5EpIgQ,405
+petsafe/devices.py,sha256=YvM8b6jwrpEfwaMeBBboyIgQTDiB1TyDag6BEHUFrFY,29331
+petsafe/general.py,sha256=LIARBEiO8jnNLN_5bC6T1x5GrUHTLnTZNnNDayPCl_o,1070
+petsafe/pets.py,sha256=4ZyC0a15lf0Jy_O67Mq9RQZJynG_U4jipc8PLsCs8a8,1139
+petsafe_api-3.0.1.dist-info/licenses/LICENSE,sha256=3R2pheY3uCSdeAzg6Lr8KiAuqKwxo4UzGD2j-15G5w4,1059
+petsafe_api-3.0.1.dist-info/METADATA,sha256=H1aV5X7YQNjvYLrvAy2RItAmtqNTNjFWy7IhoS5mtnI,7132
+petsafe_api-3.0.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+petsafe_api-3.0.1.dist-info/top_level.txt,sha256=5D0ZgkQJjlXEEVOeHs3F3TGlSXJO_bR1TaoSuKkggZA,8
+petsafe_api-3.0.1.dist-info/RECORD,,

petsafe_api-3.0.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

petsafe_api-3.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2020 Jordan Stremming
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

petsafe_api-3.0.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+petsafe