Metadata-Version: 2.4
Name: bluetooth-mesh-bluez
Version: 0.9.3
Author-email: Michał Lowas-Rzechonek <michal.lowas-rzechonek@silvair.com>, Amadeusz Herzog <amadeusz.hercog@silvair.com>, Jakub Witowski <jakub.witowski@silvair.com>, Kamil Janowski <kamil.janowski@silvair.com>, Przemysław Fierek <przemyslaw.fierek@silvair.com>, Rafał Gajda <rafal.gajda@silvair.com>, Patryk Bieleń <patryk.bielen@silvair.com>
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: System :: Networking
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: bluetooth-mesh-messages<0.10,>=0.9
Requires-Dist: bluetooth-mesh-network<0.10,>=0.9
Requires-Dist: dbus-next>=0.2.1
Requires-Dist: pluggy>=0.13.1
Requires-Dist: marshmallow<4.0,>=3.0.1
Provides-Extra: test
Requires-Dist: asynctest; extra == "test"
Requires-Dist: black; extra == "test"
Requires-Dist: isort; extra == "test"
Requires-Dist: pytest; extra == "test"
Requires-Dist: pytest-asyncio; extra == "test"
Requires-Dist: ruff; extra == "test"
Provides-Extra: cli
Requires-Dist: prompt-toolkit==2.0.10; extra == "cli"
Dynamic: license-file

======================
bluetooth-mesh-bluez
======================

.. image:: https://img.shields.io/pypi/v/bluetooth-mesh-bluez.svg
   :target: https://pypi.org/project/bluetooth-mesh-bluez
   :alt: PyPI version

.. image:: https://img.shields.io/pypi/pyversions/bluetooth-mesh-bluez.svg
   :target: https://pypi.org/project/bluetooth-mesh-bluez
   :alt: Python versions

----

Bluetooth mesh SDK for Python allows developing applications communicating with
Bluetooth mesh network using BlueZ's bluetooth-meshd.

What is this thing?
--------------------

This library provides a high-level async API for interacting with BlueZ mesh stack
via D-Bus interface.

https://www.bluetooth.com/specifications/mesh-specifications

https://git.kernel.org/pub/scm/bluetooth/bluez.git/tree/doc/mesh-api.txt

Supported features include:

- **Application framework**: High-level API for creating mesh applications,
  elements, and models
- **D-Bus integration**: Async communication with bluetooth-meshd via dbus-next
- **Model support**: Config Client, and extensible model base classes
- **Provisioning**: Provisioner and Provision Agent interfaces
- **CLI tool**: ``meshcli`` command-line interface for mesh operations
- **Plugin system**: Extensible architecture using pluggy hooks

Installation
------------

You can install "bluetooth-mesh-bluez" via `pip`_ from `PyPI`_::

    $ pip install bluetooth-mesh-bluez

For CLI tool support::

    $ pip install bluetooth-mesh-bluez[cli]

Contributing
------------

Contributions are very welcome. Tests can be run with `pytest`_, please ensure
the coverage at least stays the same before you submit a pull request.

License
-------

Distributed under the terms of the `GPL-2.0`_ license, "bluetooth-mesh-bluez" is
free and open source software.

Issues
------

If you encounter any problems, please `file an issue`_ along with a detailed description.

.. _`GPL-2.0`: http://opensource.org/licenses/GPL-2.0
.. _`file an issue`: https://github.com/SilvairGit/python-bluetooth-mesh-bluez/issues
.. _`pytest`: https://github.com/pytest-dev/pytest
.. _`pip`: https://pypi.org/project/pip/
.. _`PyPI`: https://pypi.org/project
