python-kasa/docs/source/codeinfo.md

:::{note} The library is fully async and methods that perform IO need to be run inside an async coroutine.

The main entry point for the API is {meth}~kasa.Discover.discover and {meth}~kasa.Discover.discover_single which return Device objects. Most newer devices require your TP-Link cloud username and password, but this can be omitted for older devices.

:::{important} All of your code needs to run inside the same event loop so only call asyncio.run once. :::

Code examples assume you are following them inside asyncio REPL:

    $ python -m asyncio

Or the code is running inside an async function:

import asyncio
from kasa import Discover

async def main():
    dev = await Discover.discover_single("127.0.0.1", username="un@example.com", password="pw")
    await dev.turn_on()
    await dev.update()

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

::::{include} ../creds_hashing.md

:::