petkitaio
| Name | petkitaio JSON |
| Version |
0.1.10
JSON |
| download | |
| home_page | https://github.com/RobertD502/petkitaio |
| Summary | Asynchronous Python library for PetKit's API |
| upload_time | 2023-09-23 16:50:56 |
| maintainer | |
| docs_url | None |
| author | Robert Drinovac |
| requires_python | >=3.7 |
| license | |
| keywords | petkit eversweet 3 pro feeder mini d4 petkit feeder petkit water fountain freshelement solo pura x pura max pura air |
| VCS |  |
| bugtrack_url | |
| requirements | No requirements were recorded. |
| Travis-CI | No Travis. |
| coveralls test coverage | No coveralls. |
# PetKitAIO
Asynchronous Python library for PetKit's API.
This is PetKit's undocumented API. With that said, future changes made by PetKit may break this library. The API endpoint used is determined based on the region your account is locked to. See the `Regions` section for available region values.
## **Currently Supported Devices**:
`Feeders`
- [Fresh Element](https://petkit.us/products/petkit-element-wi-fi-enabled-smart-pet-food-container-feeder)
- [D3 (Fresh Element Infinity)](https://www.amazon.com/PETKIT-Automatic-Stainless-Programmable-Dispenser/dp/B09JFK8BCQ)
- [D4 (Fresh Element Solo)](https://www.amazon.com/PETKIT-Automatic-Dispenser-Compatible-Freeze-Dried/dp/B09158J9PF/)
- [D4s (Fresh Element Gemini)](https://www.amazon.com/PETKIT-Automatic-Combination-Dispenser-Stainless/dp/B0BF56RTQH)
- [Mini Feeder](https://www.amazon.com/PETKIT-Automatic-Stainless-Indicator-Dispenser-2-8L/dp/B08GS1CPHH/)
`Litter Boxes`
- [T3 (Pura X)](https://www.amazon.com/PETKIT-Self-Cleaning-Scooping-Automatic-Multiple/dp/B08T9CCP1M)
- [T4 (Pura MAX) with/without Pura Air](https://www.amazon.com/PETKIT-Self-Cleaning-Capacity-Multiple-Automatic/dp/B09KC7Q4YF)
`Purifiers`
- [K2 (Air Magicube)](https://www.instachew.com/product-page/petkit-air-magicube-smart-odor-eliminator)
`Water Fountains`
- [W5 (Eversweet Solo 2)](https://www.amazon.com/PETKIT-EVERSWEET-Wireless-Visualization-Dispenser-2L/dp/B0B3RWF653)
- [W5 (Eversweet 3 Pro)](https://www.amazon.com/PETKIT-Wireless-Fountain-Stainless-Dispenser/dp/B09QRH6L3M/)
- [W5 (Eversweet 5 Mini)](https://www.petkit.nl/products/eversweet-5-mini-binnen-2-weken-geleverd)
## Important
PetKit accounts can only be logged in on one device at a time. Using this library will result in getting signed out of the mobile app. If you want to continue using the mobile app, use the family share feature to share devices to a secondary account. `Note`: The secondary account needs to be used with the mobile app while the primary account is used with this library as this library will not fetch devices that are part of family sharing.
This package depends on [aiohttp](https://docs.aiohttp.org/en/stable/) and [tzlocal](https://pypi.org/project/tzlocal/). `Python 3.7` or greater is required.
## Usage
### Regions
___
<details>
<summary> <b>See regions available</b> (<i>click to expand</i>)</summary>
<!---->
| Region |
|-------------------------------------------------------|
| Afghanistan |
| Aland Islands |
| Albania |
| Algeria |
| American Samoa |
| Andorra |
| Angola |
| Anguilla |
| Antarctica |
| Antigua and Barbuda |
| Argentina |
| Armenia |
| Aruba |
| Australia |
| Austria |
| Azerbaijan |
| Bahamas |
| Bahrain |
| Bangladesh |
| Barbados |
| Belarus |
| Belgium |
| Belize |
| Benin |
| Bermuda |
| Bhutan |
| Bolivia |
| Bosnia and Herzegovina |
| Botswana |
| Bouvet Island |
| Brazil |
| British Indian Ocean Territory |
| Brunei Darussalam |
| Bulgaria |
| Burkina Faso |
| Burundi |
| Cambodia |
| Cameroon |
| Canada |
| Cape Verde |
| Cayman Islands |
| Central African Republic |
| Chad |
| Chile |
| China |
| Christmas Island |
| Cocos (Keeling) Islands |
| Colombia |
| Comoros |
| Congo |
| Congo (the Democratic Republic of the Congo) |
| Cook Islands |
| Costa Rica |
| Côte d'Ivoire |
| Croatia |
| Cuba |
| Cyprus |
| Czech Republic |
| Denmark |
| Djibouti |
| Dominica |
| Dominican Republic |
| Ecuador |
| Egypt |
| El Salvador |
| Equatorial Guinea |
| Eritrea |
| Estonia |
| Ethiopia |
| Falkland Islands [Malvinas] |
| Faroe Islands |
| Fiji |
| Finland |
| France |
| French Guiana |
| French Polynesia |
| French Southern Territories |
| Gabon |
| Gambia |
| Georgia |
| Germany |
| Ghana |
| Gibraltar |
| Greece |
| Greenland |
| Grenada |
| Guadeloupe |
| Guam |
| Guatemala |
| Guernsey |
| Guinea |
| Guinea-Bissau |
| Guyana |
| Haiti |
| Heard Island and McDonald Islands |
| Holy See [Vatican City State] |
| Honduras |
| Hong Kong |
| Hungary |
| Iceland |
| India |
| Indonesia |
| Iran (the Islamic Republic of Iran) |
| Iraq |
| Ireland |
| Isle of Man |
| Israel |
| Italy |
| Jamaica |
| Japan |
| Jersey |
| Jordan |
| Kazakhstan |
| Kenya |
| Kiribati |
| Korea (the Democratic People's Republic of Korea) |
| Korea (the Republic of Korea) |
| Kuwait |
| Kyrgyzstan |
| Lao People's Democratic Republic |
| Latvia |
| Lebanon |
| Lesotho |
| Liberia |
| Libyan Arab Jamahiriya |
| Liechtenstein |
| Lithuania |
| Luxembourg |
| Macao |
| Macedonia (the former Yugoslav Republic of Macedonia) |
| Madagascar |
| Malawi |
| Malaysia |
| Maldives |
| Mali |
| Malta |
| Marshall Islands |
| Martinique |
| Mauritania |
| Mauritius |
| Mayotte |
| Mexico |
| Micronesia (the Federated States of Micronesia) |
| Moldova (the Republic of Moldova) |
| Monaco |
| Mongolia |
| Montenegro |
| Montserrat |
| Morocco |
| Mozambique |
| Myanmar |
| Namibia |
| Nauru |
| Nepal |
| Netherlands |
| Netherlands Antilles |
| New Caledonia |
| New Zealand |
| Nicaragua |
| Niger |
| Nigeria |
| Niue |
| Norfolk Island |
| Northern Mariana Islands |
| Norway |
| Oman |
| Pakistan |
| Palau |
| Palestinian Territory |
| Panama |
| Papua New Guinea |
| Paraguay |
| Peru |
| Philippines |
| Pitcairn |
| Poland |
| Portugal |
| Puerto Rico |
| Qatar |
| Réunion |
| Romania |
| Russian Federation |
| Rwanda |
| Saint Helena |
| Saint Kitts and Nevis |
| Saint Lucia |
| Saint Pierre and Miquelon |
| Saint Vincent and the Grenadines |
| Samoa |
| San Marino |
| Sao Tome and Principe |
| Saudi Arabia |
| Senegal |
| Serbia |
| Seychelles |
| Sierra Leone |
| Singapore |
| Slovakia |
| Slovenia |
| Solomon Islands |
| Somalia |
| South Africa |
| South Georgia and the South Sandwich Islands |
| Spain |
| Sri Lanka |
| Sudan |
| Suriname |
| Svalbard and Jan Mayen |
| Swaziland |
| Sweden |
| Switzerland |
| Syrian Arab Republic |
| Taiwan (Province of China) |
| Tajikistan |
| Tanzania,United Republic of |
| Thailand |
| Timor-Leste |
| Togo |
| Tokelau |
| Tonga |
| Trinidad and Tobago |
| Tunisia |
| Turkey |
| Turkmenistan |
| Turks and Caicos Islands |
| Tuvalu |
| Uganda |
| Ukraine |
| United Arab Emirates |
| United Kingdom |
| United States |
| United States Minor Outlying Islands |
| Uruguay |
| Uzbekistan |
| Vanuatu |
| Venezuela |
| Viet Nam |
| Virgin Islands (British) |
| Virgin Islands (U.S.) |
| Wallis and Futuna |
| Western Sahara |
| Yemen |
| Zambia |
| Zimbabwe |
</details>
### Creating Client
___
```python
import asyncio
from petkitaio import PetKitClient
from aiohttp import ClientSession
async def main():
async with ClientSession() as session:
# Create a client using PetKit account email, password, and region
client = PetKitClient('email', 'password', session, 'United States')
###################################################################################
Examples within the examples section utilize the PetKitClient instance created above
###################################################################################
loop = asyncio.get_event_loop()
loop.run_until_complete(main())
```
## Examples
### Retrieving all PetKit devices on account
```python
# See model.py for details regarding Data Classes created
devices = await client.get_petkit_data()
```
### Manual Feeding
```python
# See model.py for details regarding "Feeder" class
# Reusing retrieved devices from above. Note: A valid amount (in grams) will depend on the capabilities of the feeder.
await client.manual_feeding(feeder=devices.feeders[feederid], amount=10)
```
### Change Feeder Setting
```python
# See constants.py FeederSetting class for available settings
# Additional import needed:
from petkitaio.constants import FeederSetting
# Enabling child lock on a D4 feeder. Note: Mini Feeders use a different setting.
# Reusing retrieved devices from above.
await client.update_feeder_settings(feeder=devices.feeders[feederid], setting=FeederSetting.CHILD_LOCK, value=1)
```
### Reset Feeder Desiccant
```python
# Reusing retrieved devices from above.
await client.reset_feeder_desiccant(feeder=devices.feeders[feederid])
```
### Control Water Fountain via BLE Relay
```python
# A valid relay (set up through the PetKit app) is required in order to send commands to the Eversweet 3 Pro
# See constants.py W5Command class for available commands
# Additional import needed:
from petkitaio.constants import W5Command
# Set Water Fountain to Smart Mode. Reusing retrieved devices from above.
await client.control_water_fountain(water_fountain=devices.water_fountains[water_fountain_id], command=W5Command.SMART)
```
Raw data
{
"_id": null,
"home_page": "https://github.com/RobertD502/petkitaio",
"name": "petkitaio",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "petkit,eversweet 3 pro,feeder mini,d4,petkit feeder,petkit water fountain,freshelement solo,pura x,pura max,pura air",
"author": "Robert Drinovac",
"author_email": "unlisted@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/8e/47/f2810957a5371411b64cbd93294c18db510b65174371997f6a383f2fa445/petkitaio-0.1.10.tar.gz",
"platform": null,
"description": "# PetKitAIO\n\nAsynchronous Python library for PetKit's API.\n\nThis is PetKit's undocumented API. With that said, future changes made by PetKit may break this library. The API endpoint used is determined based on the region your account is locked to. See the `Regions` section for available region values.\n\n## **Currently Supported Devices**:\n\n`Feeders`\n- [Fresh Element](https://petkit.us/products/petkit-element-wi-fi-enabled-smart-pet-food-container-feeder)\n- [D3 (Fresh Element Infinity)](https://www.amazon.com/PETKIT-Automatic-Stainless-Programmable-Dispenser/dp/B09JFK8BCQ)\n- [D4 (Fresh Element Solo)](https://www.amazon.com/PETKIT-Automatic-Dispenser-Compatible-Freeze-Dried/dp/B09158J9PF/)\n- [D4s (Fresh Element Gemini)](https://www.amazon.com/PETKIT-Automatic-Combination-Dispenser-Stainless/dp/B0BF56RTQH)\n- [Mini Feeder](https://www.amazon.com/PETKIT-Automatic-Stainless-Indicator-Dispenser-2-8L/dp/B08GS1CPHH/)\n\n`Litter Boxes`\n- [T3 (Pura X)](https://www.amazon.com/PETKIT-Self-Cleaning-Scooping-Automatic-Multiple/dp/B08T9CCP1M)\n- [T4 (Pura MAX) with/without Pura Air](https://www.amazon.com/PETKIT-Self-Cleaning-Capacity-Multiple-Automatic/dp/B09KC7Q4YF)\n\n`Purifiers`\n- [K2 (Air Magicube)](https://www.instachew.com/product-page/petkit-air-magicube-smart-odor-eliminator)\n\n`Water Fountains`\n- [W5 (Eversweet Solo 2)](https://www.amazon.com/PETKIT-EVERSWEET-Wireless-Visualization-Dispenser-2L/dp/B0B3RWF653)\n- [W5 (Eversweet 3 Pro)](https://www.amazon.com/PETKIT-Wireless-Fountain-Stainless-Dispenser/dp/B09QRH6L3M/)\n- [W5 (Eversweet 5 Mini)](https://www.petkit.nl/products/eversweet-5-mini-binnen-2-weken-geleverd)\n\n\n## Important\n\nPetKit accounts can only be logged in on one device at a time. Using this library will result in getting signed out of the mobile app. If you want to continue using the mobile app, use the family share feature to share devices to a secondary account. `Note`: The secondary account needs to be used with the mobile app while the primary account is used with this library as this library will not fetch devices that are part of family sharing. \n\n\nThis package depends on [aiohttp](https://docs.aiohttp.org/en/stable/) and [tzlocal](https://pypi.org/project/tzlocal/). `Python 3.7` or greater is required.\n\n## Usage\n\n### Regions\n___\n\n<details>\n <summary> <b>See regions available</b> (<i>click to expand</i>)</summary>\n <!---->\n\n| Region |\n|-------------------------------------------------------|\n| Afghanistan |\n| Aland Islands |\n| Albania |\n| Algeria |\n| American Samoa |\n| Andorra |\n| Angola |\n| Anguilla |\n| Antarctica |\n| Antigua and Barbuda |\n| Argentina |\n| Armenia |\n| Aruba |\n| Australia |\n| Austria |\n| Azerbaijan |\n| Bahamas |\n| Bahrain |\n| Bangladesh |\n| Barbados |\n| Belarus |\n| Belgium |\n| Belize |\n| Benin |\n| Bermuda |\n| Bhutan |\n| Bolivia |\n| Bosnia and Herzegovina |\n| Botswana |\n| Bouvet Island |\n| Brazil |\n| British Indian Ocean Territory |\n| Brunei Darussalam |\n| Bulgaria |\n| Burkina Faso |\n| Burundi |\n| Cambodia |\n| Cameroon |\n| Canada |\n| Cape Verde |\n| Cayman Islands |\n| Central African Republic |\n| Chad |\n| Chile |\n| China |\n| Christmas Island |\n| Cocos (Keeling) Islands |\n| Colombia |\n| Comoros |\n| Congo |\n| Congo (the Democratic Republic of the Congo) |\n| Cook Islands |\n| Costa Rica |\n| C\u00f4te d'Ivoire |\n| Croatia |\n| Cuba |\n| Cyprus |\n| Czech Republic |\n| Denmark |\n| Djibouti |\n| Dominica |\n| Dominican Republic |\n| Ecuador |\n| Egypt |\n| El Salvador |\n| Equatorial Guinea |\n| Eritrea |\n| Estonia |\n| Ethiopia |\n| Falkland Islands [Malvinas] |\n| Faroe Islands |\n| Fiji |\n| Finland |\n| France |\n| French Guiana |\n| French Polynesia |\n| French Southern Territories |\n| Gabon |\n| Gambia |\n| Georgia |\n| Germany |\n| Ghana |\n| Gibraltar |\n| Greece |\n| Greenland |\n| Grenada |\n| Guadeloupe |\n| Guam |\n| Guatemala |\n| Guernsey |\n| Guinea |\n| Guinea-Bissau |\n| Guyana |\n| Haiti |\n| Heard Island and McDonald Islands |\n| Holy See [Vatican City State] |\n| Honduras |\n| Hong Kong |\n| Hungary |\n| Iceland |\n| India |\n| Indonesia |\n| Iran (the Islamic Republic of Iran) |\n| Iraq |\n| Ireland |\n| Isle of Man |\n| Israel |\n| Italy |\n| Jamaica |\n| Japan |\n| Jersey |\n| Jordan |\n| Kazakhstan |\n| Kenya |\n| Kiribati |\n| Korea (the Democratic People's Republic of Korea) |\n| Korea (the Republic of Korea) |\n| Kuwait |\n| Kyrgyzstan |\n| Lao People's Democratic Republic |\n| Latvia |\n| Lebanon |\n| Lesotho |\n| Liberia |\n| Libyan Arab Jamahiriya |\n| Liechtenstein |\n| Lithuania |\n| Luxembourg |\n| Macao |\n| Macedonia (the former Yugoslav Republic of Macedonia) |\n| Madagascar |\n| Malawi |\n| Malaysia |\n| Maldives |\n| Mali |\n| Malta |\n| Marshall Islands |\n| Martinique |\n| Mauritania |\n| Mauritius |\n| Mayotte |\n| Mexico |\n| Micronesia (the Federated States of Micronesia) |\n| Moldova (the Republic of Moldova) |\n| Monaco |\n| Mongolia |\n| Montenegro |\n| Montserrat |\n| Morocco |\n| Mozambique |\n| Myanmar |\n| Namibia |\n| Nauru |\n| Nepal |\n| Netherlands |\n| Netherlands Antilles |\n| New Caledonia |\n| New Zealand |\n| Nicaragua |\n| Niger |\n| Nigeria |\n| Niue |\n| Norfolk Island |\n| Northern Mariana Islands |\n| Norway |\n| Oman |\n| Pakistan |\n| Palau |\n| Palestinian Territory |\n| Panama |\n| Papua New Guinea |\n| Paraguay |\n| Peru |\n| Philippines |\n| Pitcairn |\n| Poland |\n| Portugal |\n| Puerto Rico |\n| Qatar |\n| R\u00e9union |\n| Romania |\n| Russian Federation |\n| Rwanda |\n| Saint Helena |\n| Saint Kitts and Nevis |\n| Saint Lucia |\n| Saint Pierre and Miquelon |\n| Saint Vincent and the Grenadines |\n| Samoa |\n| San Marino |\n| Sao Tome and Principe |\n| Saudi Arabia |\n| Senegal |\n| Serbia |\n| Seychelles |\n| Sierra Leone |\n| Singapore |\n| Slovakia |\n| Slovenia |\n| Solomon Islands |\n| Somalia |\n| South Africa |\n| South Georgia and the South Sandwich Islands |\n| Spain |\n| Sri Lanka |\n| Sudan |\n| Suriname |\n| Svalbard and Jan Mayen |\n| Swaziland |\n| Sweden |\n| Switzerland |\n| Syrian Arab Republic |\n| Taiwan (Province of China) |\n| Tajikistan |\n| Tanzania,United Republic of |\n| Thailand |\n| Timor-Leste |\n| Togo |\n| Tokelau |\n| Tonga |\n| Trinidad and Tobago |\n| Tunisia |\n| Turkey |\n| Turkmenistan |\n| Turks and Caicos Islands |\n| Tuvalu |\n| Uganda |\n| Ukraine |\n| United Arab Emirates |\n| United Kingdom |\n| United States |\n| United States Minor Outlying Islands |\n| Uruguay |\n| Uzbekistan |\n| Vanuatu |\n| Venezuela |\n| Viet Nam |\n| Virgin Islands (British) |\n| Virgin Islands (U.S.) |\n| Wallis and Futuna |\n| Western Sahara |\n| Yemen |\n| Zambia |\n| Zimbabwe |\n\n</details>\n\n### Creating Client\n___\n\n```python\nimport asyncio\nfrom petkitaio import PetKitClient\nfrom aiohttp import ClientSession\n\nasync def main():\n async with ClientSession() as session:\n\n # Create a client using PetKit account email, password, and region\n client = PetKitClient('email', 'password', session, 'United States')\n\n\n ###################################################################################\n Examples within the examples section utilize the PetKitClient instance created above\n ###################################################################################\n\n\n\nloop = asyncio.get_event_loop()\nloop.run_until_complete(main())\n```\n\n## Examples\n\n### Retrieving all PetKit devices on account\n\n```python\n# See model.py for details regarding Data Classes created\n\ndevices = await client.get_petkit_data()\n```\n\n### Manual Feeding\n```python\n# See model.py for details regarding \"Feeder\" class\n\n\n# Reusing retrieved devices from above. Note: A valid amount (in grams) will depend on the capabilities of the feeder.\nawait client.manual_feeding(feeder=devices.feeders[feederid], amount=10)\n```\n\n### Change Feeder Setting\n```python\n# See constants.py FeederSetting class for available settings\n# Additional import needed:\nfrom petkitaio.constants import FeederSetting\n\n\n# Enabling child lock on a D4 feeder. Note: Mini Feeders use a different setting.\n# Reusing retrieved devices from above.\nawait client.update_feeder_settings(feeder=devices.feeders[feederid], setting=FeederSetting.CHILD_LOCK, value=1)\n```\n\n### Reset Feeder Desiccant\n```python\n# Reusing retrieved devices from above.\nawait client.reset_feeder_desiccant(feeder=devices.feeders[feederid])\n```\n\n### Control Water Fountain via BLE Relay\n```python\n# A valid relay (set up through the PetKit app) is required in order to send commands to the Eversweet 3 Pro\n# See constants.py W5Command class for available commands\n# Additional import needed:\nfrom petkitaio.constants import W5Command\n\n# Set Water Fountain to Smart Mode. Reusing retrieved devices from above.\nawait client.control_water_fountain(water_fountain=devices.water_fountains[water_fountain_id], command=W5Command.SMART)\n```",
"bugtrack_url": null,
"license": "",
"summary": "Asynchronous Python library for PetKit's API",
"version": "0.1.10",
"project_urls": {
"Bug Reports": "https://github.com/RobertD502/petkitaio/issues",
"Homepage": "https://github.com/RobertD502/petkitaio",
"Source": "https://github.com/RobertD502/petkitaio/"
},
"split_keywords": [
"petkit",
"eversweet 3 pro",
"feeder mini",
"d4",
"petkit feeder",
"petkit water fountain",
"freshelement solo",
"pura x",
"pura max",
"pura air"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8e47f2810957a5371411b64cbd93294c18db510b65174371997f6a383f2fa445",
"md5": "9460d3f219bb545c4a2a5c273251e5f3",
"sha256": "a3eaa4f74a714687909e70c038144ff5bd5d2e9e4d50b53b1e6bfa6140e33a63"
},
"downloads": -1,
"filename": "petkitaio-0.1.10.tar.gz",
"has_sig": false,
"md5_digest": "9460d3f219bb545c4a2a5c273251e5f3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 24596,
"upload_time": "2023-09-23T16:50:56",
"upload_time_iso_8601": "2023-09-23T16:50:56.510443Z",
"url": "https://files.pythonhosted.org/packages/8e/47/f2810957a5371411b64cbd93294c18db510b65174371997f6a383f2fa445/petkitaio-0.1.10.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-23 16:50:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "RobertD502",
"github_project": "petkitaio",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "petkitaio"
}
