wave reader utils

このパッケージは現在メンテナンスモードです。新しいプロジェクトには、Airthings-bleを使用してください。

Wave Readerユーティリティ

Airthings Waveは、家庭内のラドンレベルを追跡する一連のデバイスです。ラドンは、土壌と岩のウランの分解から生じる放射性ガスです。目に見えず、無臭で無味です。

これは、デバイスとWeb通信にユーティリティを提供するように設計された非公式のAirthings Waveコミュニティライブラリです。

特徴

• プラットフォームの相互互換性と非同期操作のサポートの依存関係としてbleakを使用します。
• 主要なモデルのサポート：Wave+、Wave、Wave（バージョン2）およびWave Miniデバイス。ビュープラスは、BTLEではなくWiFiを介してデータを送信するため、サポートされていません。
• コードテスト、カバレッジレポート、糸くず、タイプのヒント、フォーマット。
• 開発者オーディエンスに、より包括的なプログラミングインターフェイスを提供します。
• AirThings APIおよびOAUTH2認証にWebクライアントを提供する補助モジュール。

要件

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 ... 

Web APIクライアントモジュール

このライブラリのwave_reader/webモジュールは、Airthings Web APIのクライアントを提供します。詳細については、このページを参照してください。

貢献

バグを特定した場合は、チケットを開いてください。プルリクエストはいつでも大歓迎です。

テスト

toxを実行して、テストスイート全体を実行できます。 flake8 、 isort 、 pytestを実行します。ユニットテストを実行したい場合は、 pytest ./testsを実行するだけで十分です。