Skip to main content

Asynchronous library to control Shelly devices.

Project description

Aioshelly

Asynchronous library to control Shelly

This library is under development.

Requires Python 3 and uses asyncio, aiohttp and aiocoap.

import asyncio
from pprint import pprint
import aiohttp
import aioshelly

async def main():
    options = aioshelly.ConnectionOptions("192.168.1.165", "username", "password")

    async with aiohttp.ClientSession() as aiohttp_session, aioshelly.COAP() as coap_context:
        try:
            device = await asyncio.wait_for(
                aioshelly.Device.create(aiohttp_session, coap_context, options), 5
            )
        except asyncio.TimeoutError:
            print("Timeout connecting to", ip)
            return

        for block in device.blocks:
            print(block)
            pprint(block.current_values())
            print()


if __name__ == "__main__":
    asyncio.run(main())

Included examples

The repository includes two examples to quickly try it out.

Connect to a device and print its status whenever we receive a state change:

python3 example.py <ip> [<username> <password]

Connect to all the devices in devices.json at once and print their status:

python3 example.py

Contribution guidelines

Object hierarchy and property/method names should match the Shelly API.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aioshelly-0.5.0.tar.gz (10.9 kB view details)

Uploaded Source

Built Distribution

aioshelly-0.5.0-py3-none-any.whl (11.4 kB view details)

Uploaded Python 3

File details

Details for the file aioshelly-0.5.0.tar.gz.

File metadata

  • Download URL: aioshelly-0.5.0.tar.gz
  • Upload date:
  • Size: 10.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.24.0 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.9.0

File hashes

Hashes for aioshelly-0.5.0.tar.gz
Algorithm Hash digest
SHA256 0ae66c4c1477fd6354c98a4cbced0a99c1fda5216f3dfbf53a272cf26ce18fe1
MD5 ebb6bfbb50e14d3c440db46a420caa48
BLAKE2b-256 cc91a79b93201c39449bc480a9a77f2f8191ab14166bbf7754bae93519b47ca8

See more details on using hashes here.

File details

Details for the file aioshelly-0.5.0-py3-none-any.whl.

File metadata

  • Download URL: aioshelly-0.5.0-py3-none-any.whl
  • Upload date:
  • Size: 11.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.24.0 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.9.0

File hashes

Hashes for aioshelly-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3ed1d10c6ab89d0aaa6c934e1afa4c0066dc1359dd8575f89f87381996345446
MD5 fe0857e777bad626650b2c30a0a1fcfc
BLAKE2b-256 8ebb7f46c5d14140841a07d345895e6c26879c1f62f622a71e8a9517d9957223

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page