### Example Script: Show Usage Help

Source: https://github.com/home-assistant-libs/aioshelly/blob/main/README.md

Display the help message for the example script, showing available command-line options.

```bash
python3 tools/example.py -h

```

--------------------------------

### Install aioshelly

Source: https://github.com/home-assistant-libs/aioshelly/blob/main/README.md

Install the aioshelly library using pip.

```bash
pip install aioshelly
```

--------------------------------

### Install aioshelly from Source

Source: https://github.com/home-assistant-libs/aioshelly/blob/main/README.md

Install the aioshelly library from source by running the command inside the project folder.

```bash
pip install --upgrade .

```

--------------------------------

### Example Script: Connect to all devices

Source: https://github.com/home-assistant-libs/aioshelly/blob/main/README.md

Connect to all Shelly devices listed in `devices.json` simultaneously and print their status. Requires the `-d` flag.

```bash
python3 tools/example.py -d -i

```

--------------------------------

### Install Development Requirements

Source: https://github.com/home-assistant-libs/aioshelly/blob/main/README.md

Install development and linting requirements for aioshelly from source.

```bash
pip install .[dev] .[lint]

```

--------------------------------

### Example Script: Connect to a single device

Source: https://github.com/home-assistant-libs/aioshelly/blob/main/README.md

Connect to a single Shelly device and print its status upon state changes. Requires IP address, optionally username and password.

```bash
python3 tools/example.py -ip <ip> [-u <username>] [-p <password] -i

```

--------------------------------

### Gen1 Device (Block/CoAP) Example

Source: https://github.com/home-assistant-libs/aioshelly/blob/main/README.md

Connect to and retrieve information from a Gen1 Shelly device using CoAP. Handles authentication and connection errors.

```python
import asyncio
from pprint import pprint

import aiohttp

from aioshelly.block_device import COAP, BlockDevice
from aioshelly.common import ConnectionOptions
from aioshelly.exceptions import DeviceConnectionError, InvalidAuthError


async def test_block_device():
    """Test Gen1 Block (CoAP) based device."""
    options = ConnectionOptions("192.168.1.165", "username", "password")

    async with aiohttp.ClientSession() as aiohttp_session, COAP() as coap_context:
        try:
            device = await BlockDevice.create(aiohttp_session, coap_context, options)
        except InvalidAuthError as err:
            print(f"Invalid or missing authorization, error: {repr(err)}")
            return
        except DeviceConnectionError as err:
            print(f"Error connecting to {options.ip_address}, error: {repr(err)}")
            return

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


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

```

--------------------------------

### Gen2 and Gen3 Device (RPC/WebSocket) Example

Source: https://github.com/home-assistant-libs/aioshelly/blob/main/README.md

Connect to and retrieve status from a Gen2 or Gen3 Shelly device using RPC over WebSocket. Handles authentication and connection errors.

```python
import asyncio
from pprint import pprint

import aiohttp

from aioshelly.common import ConnectionOptions
from aioshelly.exceptions import DeviceConnectionError, InvalidAuthError
from aioshelly.rpc_device import RpcDevice, WsServer


async def test_rpc_device():
    """Test Gen2/Gen3 RPC (WebSocket) based device."""
    options = ConnectionOptions("192.168.1.188", "username", "password")
    ws_context = WsServer()
    await ws_context.initialize(8123)

    async with aiohttp.ClientSession() as aiohttp_session:
        try:
            device = await RpcDevice.create(aiohttp_session, ws_context, options)
        except InvalidAuthError as err:
            print(f"Invalid or missing authorization, error: {repr(err)}")
            return
        except DeviceConnectionError as err:
            print(f"Error connecting to {options.ip_address}, error: {repr(err)}")
            return

        pprint(device.status)


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

```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.