{"id":16241372,"url":"https://github.com/miaucl/cookidoo-api","last_synced_at":"2025-04-03T15:30:30.663Z","repository":{"id":257820410,"uuid":"857677488","full_name":"miaucl/cookidoo-api","owner":"miaucl","description":"An unofficial package to access Cookidoo.","archived":false,"fork":false,"pushed_at":"2025-03-31T14:01:54.000Z","size":333,"stargazers_count":21,"open_issues_count":5,"forks_count":5,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-03T11:44:05.625Z","etag":null,"topics":["asyncio","cookidoo","home-assistant","python","reverse-engineering"],"latest_commit_sha":null,"homepage":"https://miaucl.github.io/cookidoo-api/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/miaucl.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"miaucl","patreon":"miaucl","buy_me_a_coffee":"miaucl","custom":"https://paypal.me/sponsormiaucl"}},"created_at":"2024-09-15T10:05:26.000Z","updated_at":"2025-03-30T08:01:10.000Z","dependencies_parsed_at":null,"dependency_job_id":"9959ee52-6e3a-459d-b2da-8238ba873b2f","html_url":"https://github.com/miaucl/cookidoo-api","commit_stats":{"total_commits":47,"total_committers":4,"mean_commits":11.75,"dds":"0.42553191489361697","last_synced_commit":"8b764e86a33e05fced8acaf7b16ccf64bc8c8c7d"},"previous_names":["miaucl/cookidoo-api"],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miaucl%2Fcookidoo-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miaucl%2Fcookidoo-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miaucl%2Fcookidoo-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miaucl%2Fcookidoo-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/miaucl","download_url":"https://codeload.github.com/miaucl/cookidoo-api/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247005397,"owners_count":20868019,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["asyncio","cookidoo","home-assistant","python","reverse-engineering"],"created_at":"2024-10-10T14:07:23.245Z","updated_at":"2025-04-03T15:30:30.631Z","avatar_url":"https://github.com/miaucl.png","language":"Python","funding_links":["https://github.com/sponsors/miaucl","https://patreon.com/miaucl","https://buymeacoffee.com/miaucl","https://paypal.me/sponsormiaucl"],"categories":[],"sub_categories":[],"readme":"# Cookidoo API\r\n\r\n[![PyPI version](https://badge.fury.io/py/cookidoo-api.svg)](https://pypi.org/p/cookidoo-api)\r\n\r\nAn unofficial python package to access Cookidoo.\r\n\r\n[![Unit tests](https://github.com/miaucl/cookidoo-api/actions/workflows/unit-tests.yaml/badge.svg)](https://github.com/miaucl/cookidoo-api/actions/workflows/unit-tests.yaml)\r\n[![Smoke test](https://github.com/miaucl/cookidoo-api/actions/workflows/smoke-test.yaml/badge.svg)](https://github.com/miaucl/cookidoo-api/actions/workflows/smoke-test.yaml)\r\n[![codecov](https://codecov.io/gh/miaucl/cookidoo-api/graph/badge.svg?token=743ZRO8FRT)](https://codecov.io/gh/miaucl/cookidoo-api)\r\n[![Ruff](https://github.com/miaucl/cookidoo-api/actions/workflows/ruff.yml/badge.svg)](https://github.com/miaucl/cookidoo-api/actions/workflows/ruff.yml)\r\n[![Mypy](https://github.com/miaucl/cookidoo-api/actions/workflows/mypy.yaml/badge.svg)](https://github.com/miaucl/cookidoo-api/actions/workflows/mypy.yaml)\r\n[![Markdownlint](https://github.com/miaucl/cookidoo-api/actions/workflows/markdownlint.yml/badge.svg)](https://github.com/miaucl/cookidoo-api/actions/workflows/markdownlint.yml)\r\n\r\n[![GitHub](https://img.shields.io/badge/sponsor-30363D?style=for-the-badge\u0026logo=GitHub-Sponsors\u0026logoColor=#EA4AAA)](https://github.com/sponsors/miaucl)\r\n[![Patreon](https://img.shields.io/badge/Patreon-F96854?style=for-the-badge\u0026logo=patreon\u0026logoColor=white)](https://patreon.com/miaucl)\r\n[![BuyMeACoffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-ffdd00?style=for-the-badge\u0026logo=buy-me-a-coffee\u0026logoColor=black)](https://buymeacoffee.com/miaucl)\r\n[![PayPal](https://img.shields.io/badge/PayPal-00457C?style=for-the-badge\u0026logo=paypal\u0026logoColor=white)](https://paypal.me/sponsormiaucl)\r\n\r\n## Disclaimer\r\n\r\nThe developers of this module are in no way endorsed by or affiliated with Cookidoo or Vorwerk, or any associated subsidiaries, logos or trademarks.\r\n\r\n## Installation\r\n\r\n`pip install cookidoo-api`\r\n\r\n## Documentation\r\n\r\nSee below for usage examples.\r\n\r\n## Usage Example\r\n\r\nThe API is based on the `aiohttp` library.\r\n\r\nMake sure to have stored your credentials in the top-level file `.env` as such, to loaded by `dotenv`. Alternatively, provide the environment variables by any other `dotenv` compatible means.\r\n\r\n```text\r\nEMAIL=your@mail.com\r\nPASSWORD=password\r\n```\r\n\r\nRun the [example script](https://github.com/miaucl/cookidoo-api/blob/master/example.py) and have a look at the inline comments for more explanation.\r\n\r\n## Exceptions\r\n\r\nIn case something goes wrong during a request, several [exceptions](https://github.com/miaucl/cookidoo/blob/master/cookidoo_api/exceptions.py) can be thrown, all inheriting from `CookidooException`.\r\n\r\n### Another asyncio event loop is\r\n\r\nWith the async calls, you might encounter an error that another asyncio event loop is already running on the same thread. This is expected behavior according to the asyncio.run() [documentation](https://docs.python.org/3/library/asyncio-runner.html#asyncio.run). You cannot use more than one aiohttp session per thread, reuse the existing one!\r\n\r\n### Exception ignored: RuntimeError: Event loop is closed\r\n\r\nDue to a known issue in some versions of aiohttp when using Windows, you might encounter a similar error to this:\r\n\r\n```python\r\nException ignored in: \u003cfunction _ProactorBasePipeTransport.__del__ at 0x00000000\u003e\r\nTraceback (most recent call last):\r\n  File \"C:\\...\\py38\\lib\\asyncio\\proactor_events.py\", line 116, in __del__\r\n    self.close()\r\n  File \"C:\\...\\py38\\lib\\asyncio\\proactor_events.py\", line 108, in close\r\n    self._loop.call_soon(self._call_connection_lost, None)\r\n  File \"C:\\...\\py38\\lib\\asyncio\\base_events.py\", line 719, in call_soon\r\n    self._check_closed()\r\n  File \"C:\\...\\py38\\lib\\asyncio\\base_events.py\", line 508, in _check_closed\r\n    raise RuntimeError('Event loop is closed')\r\nRuntimeError: Event loop is closed\r\n```\r\n\r\nYou can fix this according to [this](https://stackoverflow.com/questions/68123296/asyncio-throws-runtime-error-with-exception-ignored) StackOverflow answer by adding the following line of code before executing the library:\r\n\r\n```python\r\nasyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())\r\n```\r\n\r\n## Dev\r\n\r\nSetup the dev environment using VSCode, it is highly recommended.\r\n\r\n```bash\r\npython -m venv .venv\r\nsource .venv/bin/activate\r\npip install -r requirements_dev.txt\r\n```\r\n\r\nInstall [pre-commit](https://pre-commit.com)\r\n\r\n```bash\r\npre-commit install\r\n\r\n# Run the commit hooks manually\r\npre-commit run --all-files\r\n```\r\n\r\nFollowing VSCode integrations may be helpful:\r\n\r\n- [ruff](https://marketplace.visualstudio.com/items?itemName=charliermarsh.ruff)\r\n- [mypy](https://marketplace.visualstudio.com/items?itemName=matangover.mypy)\r\n- [markdownlint](https://marketplace.visualstudio.com/items?itemName=DavidAnson.vscode-markdownlint)\r\n\r\n### Raw API Requests\r\n\r\nThe raw requests intercepted between the Cookidoo Android App and the backend can be found here `./docs/raw-api-requests`. They have been used to reconstruct the API which is implemented in this library.\r\n\r\n### Releasing\r\n\r\nA _final version_ can only be released from the `master` branch. To pass the gates of the `publish` workflow, the version must match in both the `tag` and `cookidoo_api/__init__.py`.\r\n\r\nrelease a prerelease version, it must be done from a feature branch (**not** `master`). Prerelease versions are explicitly marked as such on the GitHub release page.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmiaucl%2Fcookidoo-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmiaucl%2Fcookidoo-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmiaucl%2Fcookidoo-api/lists"}