aioafero

Async Python library for the Afero IoT cloud API.

This package enables async access to Afero accounts. Credential login lives in Authentication; runtime access uses AferoBridgeV1 with a refresh token.

The library is library-only — Home Assistant integrations such as Hubspace-Homeassistant consume it from PyPI.

Documentation: https://aioafero.readthedocs.io/

Quick links

User guide

• Overview
  • What the library does
  • How it fits together
  • Typical session flow
  • Key bridge attributes
  • Next steps
• Installation
  • PyPI
  • From source (development)
  • Home Assistant
  • Next steps
• Authentication
  • Overview
  • HTTP session
  • Credential login
  • TokenData
  • Runtime tokens
  • Token refresh
  • Bridge integration
  • Local session cache (scripts)
  • Configuration
  • Errors
  • API reference
• Bridge configuration and lifecycle
  • Authentication
  • Construction
  • Lifecycle
  • Events
  • Manual API access
• Feature identity
  • Migrating to 8.0
• Conclave push channel
  • Debug frame logging
  • Buffered file capture
  • Enabling Conclave
  • Lifecycle
  • How pushes are applied
  • Library layout
  • Limitations
• Controllers
  • Dehumidifiers
  • Devices
  • Exhaust fans
  • Fans
  • Lights
  • Locks
  • Portable ACs
  • Switches
  • Thermostats
  • Security systems
  • Security keypads
  • Security sensors
  • Valves
• Examples
  • Interactive shell
  • Basic session
  • Subscribe to updates
  • Reuse a refresh token
  • Conclave push (optional)
• Troubleshooting
  • Device shows incorrect model
  • Slow or stale updates
  • No log output when debugging
  • Authentication failures
  • Incorrect split-device state
• Split devices
  • How splitting works
  • Dual-channel RGB+WW lights
  • Implementing a new split type
  • Existing split patterns

MITM capture setup

• MITM capture setup

Contributing

• Contributing
  • Getting started
  • Pull request checklist
  • Code layout
  • Documentation
• Testing and CI
  • Quick start (local)
  • Documentation
  • Tox environments
  • Coverage behavior
  • GitHub Actions
  • Maintenance
  • Security scanning

API reference

• API reference
  • All modules
  • Core entry points
  • Controllers and models
  • Utilities

Project info

• Changelog
• License
• Credits

Indices and tables

• Index

• Module Index

• Search Page