wave reader utils

Este pacote está atualmente no modo de manutenção. Por favor, use AirThings-BBE para novos projetos.

Utilitários do leitor de ondas

A Airthings Wave é uma série de dispositivos que rastreiam os níveis de radônio em casa. O radônio é um gás radioativo que vem da quebra do urânio no solo e na rocha. É invisível, inodoro e insípido.

Esta é uma biblioteca comunitária não oficial de ondas de aeronaves, projetada para fornecer utilitários para o dispositivo e a comunicação na Web.

Características

• Usando bleak como uma dependência para a plataforma com compatibilidade e suporte para operação assíncrona.
• Suporte para os principais modelos: Wave+, Wave, Wave (Versão 2) e Mini Dispositivos. O View Plus não é suportado, pois envia dados sobre Wi -Fi, não Btle.
• Teste de código, relatórios de cobertura, linha, tipo de sugestão e formatação.
• Forneça uma interface de programação mais abrangente para um público de desenvolvedor.
• Módulo Auxilar que fornece um cliente da Web para API AirThings e autenticação OAuth2.

Requisitos

No Ubuntu/Debian, verifique se você tem libglib2.0-dev e bluez instalados:

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

Outras distribuições Linux devem ter pacotes equivalentes. Em teoria, outras plataformas (Windows, Mac) são suportadas usando bleak como uma dependência, mas abrem um ticket se você tiver algum problema.

Instalação

Você pode instalar a biblioteca em execução:

pip install wave-reader

Exemplo de uso

Existem vários exemplos concretos disponíveis no diretório examples . Isso inclui a interação da CLI e outros cenários interessantes que demonstram o uso da 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 ... 

Módulo de cliente da API da web

O módulo wave_reader/web nesta biblioteca fornece um cliente para a API da Web AirThings. Veja esta página para obter mais detalhes.

Contribuição

Se você identificar um bug, abra um ingresso. Solicitações de tração são sempre bem -vindas.

Teste

Você pode executar o conjunto de testes inteiro executando tox . Ele vai executar flake8 , isort e pytest . Se você deseja executar testes de unidade, executando pytest ./tests é suficiente.