python-myq 3.1.13

Description:

pythonmyq 3.1.13

Introduction
This is a Python 3.8+ module aiming to interact with the Chamberlain MyQ API.
Code is licensed under the MIT license.
It is recommended that you consider using an open-source solution instead of a myq such as Ratgdo
Homeassistant
Homeassistant has a core myQ component leveraging this package.
In addition, there is also a HACS myQ component available that can be added into HACS as a custom repository.
Getting Started
Installation
pip install pymyq

Usage
pymyq starts within an aiohttp
ClientSession:
import asyncio

from aiohttp import ClientSession


async def main() -> None:
"""Create the aiohttp session and run."""
async with ClientSession() as websession:
# YOUR CODE HERE


asyncio.get_event_loop().run_until_complete(main())

To get all MyQ devices associated with an account:
import asyncio

from aiohttp import ClientSession

import pymyq


async def main() -> None:
"""Create the aiohttp session and run."""
async with ClientSession() as websession:
myq = await pymyq.login('<EMAIL>', '<PASSWORD>', websession)

# Return only cover devices:
devices = myq.covers
# >>> {"serial_number123": <Device>}

# Return only lamps devices:
devices = myq.lamps
# >>> {"serial_number123": <Device>}

# Return only locks devices:
devices = myq.locks
# >>> {"serial_number123": <Device>}

# Return only gateway devices:
devices = myq.gateways
# >>> {"serial_number123": <Device>}

# Return *all* devices:
devices = myq.devices
# >>> {"serial_number123": <Device>, "serial_number456": <Device>}


asyncio.get_event_loop().run_until_complete(main())

API Properties

accounts: dictionary with all accounts (MyQAccount)
covers: dictionary with all covers (MyQGarageDoor)
devices: dictionary with all devices (MyQDevice)
gateways: dictionary with all gateways (MyQDevice)
lamps: dictionary with all lamps (MyQLamp)
locks: dictionary with all locks (MyQLock)
last_state_update: datetime (in UTC) last state update was retrieved for all items
password: password used for authentication. Can only be set, not retrieved
username: username for authentication.

Account Properties (MyQAccount)

api: Associated API object
id: ID for the account
name: Name of the account
covers: dictionary with all covers for account (MyQGarageDoor)
devices: dictionary with all devices for account (MyQDevice)
gateways: dictionary with all gateways for account (MyQDevice)
lamps: dictionary with all lamps for account (MyQLamp)
locks: dictionary with all locks for account (MyQLock)
account_json: Dictionary containing all account information as retrieved from MyQ
last_state_update: datetime (in UTC) last state update was retrieved for all devices within this account

Device Properties

account: Return account associated with device (MyQAccount)
close_allowed: Return whether the device can be closed unattended.
device_family: Return the family in which this device lives.
device_id: Return the device ID (serial number).
device_json: Dictionary containing all device information as retrieved from MyQ
device_platform: Return the device platform.
device_type: Return the device type.
firmware_version: Return the family in which this device lives.
href: URI for device
name: Return the device name.
online: Return whether the device is online.
open_allowed: Return whether the device can be opened unattended.
parent_device_id: Return the device ID (serial number) of this device's parent.
state: Return the current state of the device.
state_update: Returns datetime when device was last updated
low_battery: Returns if the garage has a low battery or not.

API Methods
These are coroutines and need to be awaited – see example.py for examples.

authenticate: Authenticate (or re-authenticate) to MyQ. Call this to
re-authenticate immediately after changing username and/or password otherwise
new username/password will only be used when token has to be refreshed.
update_device_info: Retrieve info and status for all accounts and devices

Account Methods
All of the routines on the MyQAccount class are coroutines and need to be
awaited – see example.py for examples.

update: get the latest device info (state, etc.) for all devices associated with this account.

Device Methods
All of the routines on the MyQDevice class are coroutines and need to be
awaited – see example.py for examples.

update: get the latest device info (state, etc.). Note that
this runs MyQAccount.update and thus all devices within account will be updated

Cover Methods
All Device methods in addition to:

close: close the cover
open: open the cover

Lamp Methods
All Device methods in addition to:

turnon: turn lamp on
turnoff: turn lamp off

Acknowledgement
Huge thank you to hjdhjd for figuring out the updated V6 API and
sharing his work with us.
Disclaimer
The code here is based off of an unsupported API from
Chamberlain and is subject to change without
notice. The authors claim no responsibility for damages to your garage door or
property by use of the code within.