Metadata-Version: 2.1
Name: knocki
Version: 0.4.2
Summary: Asynchronous Python client for Knocki.
Home-page: https://github.com/swan-solutions/knocki-homeassistant
License: MIT
Keywords: knocki,api,async,client
Author: Joost Lekkerkerker
Author-email: joostlek@outlook.com
Maintainer: Joost Lekkerkerker
Maintainer-email: joostlek@outlook.com
Requires-Python: >=3.11,<4.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: AsyncIO
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Home Automation
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: aiohttp (>=3.0.0)
Requires-Dist: mashumaro (>=3.11,<4.0)
Requires-Dist: orjson (>=3.9.0)
Requires-Dist: yarl (>=1.6.0)
Project-URL: Bug Tracker, https://github.com/swan-solutions/knocki-homeassistant/issues
Project-URL: Changelog, https://github.com/swan-solutions/knocki-homeassistant/releases
Project-URL: Documentation, https://github.com/swan-solutions/knocki-homeassistant
Project-URL: Repository, https://github.com/swan-solutions/knocki-homeassistant
Description-Content-Type: text/markdown

# Python: Knocki

[![GitHub Release][releases-shield]][releases]
[![Python Versions][python-versions-shield]][pypi]
![Project Stage][project-stage-shield]
![Project Maintenance][maintenance-shield]
[![License][license-shield]](LICENSE.md)

[![Build Status][build-shield]][build]
[![Code Coverage][codecov-shield]][codecov]

Asynchronous Python client for Knocki.

## About

This package is for connecting Knocki to Home Assistant.

## Installation

```bash
pip install knocki
```

## Changelog & Releases

This repository keeps a change log using [GitHub's releases][releases]
functionality. The format of the log is based on
[Keep a Changelog][keepchangelog].

Releases are based on [Semantic Versioning][semver], and use the format
of ``MAJOR.MINOR.PATCH``. In a nutshell, the version will be incremented
based on the following:

- ``MAJOR``: Incompatible or major changes.
- ``MINOR``: Backwards-compatible new features and enhancements.
- ``PATCH``: Backwards-compatible bugfixes and package updates.

## Contributing

This is an active open-source project. We are always open to people who want to
use the code or contribute to it.

We've set up a separate document for our
[contribution guidelines](.github/CONTRIBUTING.md).

Thank you for being involved! :heart_eyes:

## Setting up development environment

This Python project is fully managed using the [Poetry][poetry] dependency manager. But also relies on the use of NodeJS for certain checks during development.

You need at least:

- Python 3.11+
- [Poetry][poetry-install]
- NodeJS 12+ (including NPM)

To install all packages, including all development requirements:

```bash
npm install
poetry install
```

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

```bash
poetry run pre-commit run --all-files
```

To run just the Python tests:

```bash
poetry run pytest
```

[build-shield]: https://github.com/swan-solutions/knocki-homeassistant/actions/workflows/tests.yaml/badge.svg
[build]: https://github.com/swan-solutions/knocki-homeassistant/actions
[codecov-shield]: https://codecov.io/gh/swan-solutions/knocki-homeassistant/branch/master/graph/badge.svg
[codecov]: https://codecov.io/gh/swan-solutions/knocki-homeassistant
[commits-shield]: https://img.shields.io/github/commit-activity/y/swan-solutions/knocki-homeassistant.svg
[commits]: https://github.com/swan-solutions/knocki-homeassistant/commits/master
[contributors]: https://github.com/swan-solutions/knocki-homeassistant/graphs/contributors
[keepchangelog]: http://keepachangelog.com/en/1.0.0/
[license-shield]: https://img.shields.io/github/license/swan-solutions/knocki-homeassistant.svg
[maintenance-shield]: https://img.shields.io/maintenance/yes/2024.svg
[poetry-install]: https://python-poetry.org/docs/#installation
[poetry]: https://python-poetry.org
[pre-commit]: https://pre-commit.com/
[project-stage-shield]: https://img.shields.io/badge/project%20stage-stable-green.svg
[python-versions-shield]: https://img.shields.io/pypi/pyversions/knocki
[releases-shield]: https://img.shields.io/github/release/swan-solutions/knocki-homeassistant.svg
[releases]: https://github.com/swan-solutions/knocki-homeassistant/releases
[semver]: http://semver.org/spec/v2.0.0.html
[pypi]: https://pypi.org/project/knocki/