Metadata-Version: 2.4
Name: roombapy
Version: 1.9.2
Summary: Python program and library to control Wi-Fi enabled iRobot Roombas
Author: Philipp Schmitt
Author-email: Philipp Schmitt <philipp@schmitt.co>
License-Expression: MIT
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Networking
Requires-Dist: orjson>=3.9.13
Requires-Dist: paho-mqtt>=1.6.1,<3.0.0
Requires-Dist: mashumaro>=3.12,<4.0
Requires-Dist: typing-extensions>=4.12.0
Requires-Dist: click>=8.1,<9.0 ; extra == 'cli'
Requires-Dist: tabulate>=0.9,<0.11 ; extra == 'cli'
Requires-Python: >=3.10
Project-URL: Repository, https://github.com/pschmitt/roombapy
Provides-Extra: cli
Description-Content-Type: text/markdown

# roombapy

[![CI](https://github.com/pschmitt/roombapy/actions/workflows/ci.yaml/badge.svg)](https://github.com/pschmitt/roombapy/actions/workflows/ci.yaml)
[![PyPI](https://img.shields.io/pypi/v/roombapy)](https://pypi.org/project/roombapy/)
[![PyPI - Downloads](https://img.shields.io/pypi/dm/roombapy)](https://pypi.org/project/roombapy/)
[![PyPI - License](https://img.shields.io/pypi/l/roombapy)](./LICENSE)

Unofficial iRobot Roomba python library (SDK).

Fork of [NickWaterton/Roomba980-Python](https://github.com/NickWaterton/Roomba980-Python)

This library was created for the [Home Assistant Roomba integration](https://www.home-assistant.io/integrations/roomba/).

## Installation

```shell
pip install roombapy[cli]
```

# Notes

This library is only for firmware 2.x.x [Check your robot version!](http://homesupport.irobot.com/app/answers/detail/a_id/529)

Only local connections are supported.

## How to discover your robots and obtain credentials

```shell
roombapy discover <optional ip address>
```
This will find your Roomba in local network, and obtain credentials _automagically_ whether possible.

## Event stream

To get event stream from iRobot, use:

```shell
roombapy connect <ip> -p <password>
```

Output is suitable for piping into tools like `jq`.

## Development

To improve your development experience, you can install pre-commit hooks via the following command.
With every commit it will run a set of checks, making sure it meets the quality standards.

```shell
pre-commit install
```
