wave reader utils

Этот пакет в настоящее время находится в режиме обслуживания. Пожалуйста, используйте Airthings-Ble для новых проектов.

Утилиты для чтения волн

Airthings Wave - это серия устройств, которые отслеживают уровни радона в доме. Радон - это радиоактивный газ, который поступает от разбивки урана в почве и скале. Это невидимо, без запаха и безвкусно.

Это неофициальная библиотека сообщества Airthings Wave, предназначенная для предоставления утилит для устройств и веб -коммуникации.

Функции

• Использование bleak в качестве зависимости для перекрестной совместимости платформы и поддержки для асинхронной работы.
• Поддержка основных моделей: Wave+, Wave, Wave (версия 2) и Mini Wave Mini. View Plus не поддерживается, так как он отправляет данные через Wi -Fi, а не Btle.
• Тестирование кода, отчетность по покрытию, лининг, подсказка типа и форматирование.
• Предоставьте более комплексный интерфейс программирования для аудитории разработчика.
• Вседающий модуль, который предоставляет веб -клиент для API ARTHINGS API и аутентификации OAUTH2.

Требования

В Ubuntu/Debian убедитесь, что у вас установлены libglib2.0-dev и bluez :

sudo apt-get install libglib2.0-dev bluez -y

Другие распределения Linux должны иметь эквивалентные пакеты. Теоретически, другие платформы (Windows, Mac) поддерживаются с использованием bleak в качестве зависимости, но открывают билет, если вы столкнетесь с любыми проблемами.

Установка

Вы можете установить библиотеку, работая:

pip install wave-reader

Пример использования

В каталоге examples доступны различные конкретные примеры. Это включает в себя взаимодействие CLI и другие интересные сценарии, которые демонстрируют использование API.

 import asyncio
from wave_reader import wave

if __name__ == "__main__" :
    # Scan for BTLE Wave devices.
    devices = wave . scan ()
    # Event loop to run asynchronous tasks.
    loop = asyncio . new_event_loop ()
    # Get sensor readings from available wave devices.
    for d in devices :
        sensor_readings = loop . run_until_complete ( d . get_sensor_values ())
        print ( sensor_readings )

# >>> DeviceSensors (humidity: 32.5, radon_sta: 116, radon_lta: 113 ... 

Клиент -модуль веб -API

В этой библиотеке модуль wave_reader/web в этой библиотеке предоставляет клиент для веб -API Airthings. Смотрите эту страницу для более подробной информации.

Вклад

Если вы идентифицируете ошибку, откройте билет. Запросы на вытягивание всегда приветствуются.

Тестирование

Вы можете запустить весь тестовый набор, запустив tox . Он будет запускать flake8 , isort и pytest . Если вы хотите просто запустить модульные тесты, запуск pytest ./tests достаточно.