Metadata-Version: 2.1
Name: aioautomower
Version: 2024.4.1b0
Summary: MPython module to talk to Husqvarna Automower.
Author-email: Thomas Protzner <thomas.protzner@gmail.com>
License: Apache-2.0
Project-URL: Documentation, https://github.com/Thomas55555/aioautomower
Project-URL: Repository, https://github.com/Thomas55555/aioautomower
Project-URL: Issues, https://github.com/Thomas55555/aioautomower/issues
Platform: any
Classifier: Environment :: Console
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: aiohttp
Requires-Dist: mashumaro
Requires-Dist: PyJWT

# Aioautomower

Asynchronous library to communicate with the Automower Connect API
To use this library, you need to register on the [Husqvarna Developers Portal](https://developer.husqvarnagroup.cloud/).
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](https://developer.husqvarnagroup.cloud/apis/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.

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

- `git clone https://github.com/Thomas55555/aioautomower.git`
- `pip install -e ./`
- Enter your personal `client_id` and `client_secret` in the `example.py`
- Run with `python3 ./aioautomower/example.py`

## AutomowerCLI example

An AutomowerSession that provides you with the data in a CLI

`automower --client_secret 12312312-12ec-486b-a7a7-9d9b06644a14  --api-key 12312312-0126-6222-2662-3e6c49f0012c`
