Skip to content

Thomas55555/aioautomower

Repository files navigation

Aioautomower

codecov Python Versions License

Asynchronous library to communicate with the Automower Connect API To use this library, you need to register on the Husqvarna Developers Portal. And connect your account to the Authentication API and the Automower Connect API.

Quickstart

In order to use the library, you'll need to do some work yourself to get authentication credentials. This depends a lot on the context (e.g. redirecting to use OAuth via web) but should be easy to incorporate using Husqvarna's authentication examples. See Husqvarna's Authentication API for details.

You will implement AbstractAuth to provide an access token. Your implementation will handle any necessary refreshes. You can invoke the service with your auth implementation to access the API.

You need at least:

For a first start you can run the example.py, by doing the following steps

  • git clone https://github.com/Thomas55555/aioautomower.git
  • cd aioautomower
  • poetry install
  • Enter your personal client_id and client_secret in the _secrets.yaml and rename it to secrets.yaml
  • Run with poetry run ./example.py

Contributing

This is an active open-source project. We are always open to people who want to use the code or contribute to it. This Python project is fully managed using the Poetry dependency manager.

As this repository uses the pre-commit framework, all changes are linted and tested with each commit. You can run all checks and tests manually, using the following command:

poetry run pre-commit run --all-files

To run just the Python tests:

poetry run pytest

To update snapshots:

poetry run pytest --snapshot-update

Buying Equipment

Many mowers are available from your local garden dealer or major online retailers. Another like, the compact ideal for small and flat lawns, is available on Amazon. The links provided below are affiliate links, so if you prefer shopping on Amazon and decide to purchase something there, you’ll also be supporting me at no additional cost to you. Alternatively, if you'd like to support the project directly, consider contributing through GitHub sponsors. Here are some affiliate links to support my work: