Pre-alpha warning: This is a work-in-progress fork of alexapy redesigned for secure authentication. The module imports as alexapy_secure to avoid site-packages collisions with upstream alexapy during side-by-side installation.
This is the library component of the alexa_media_player auth redesign. The redesign eliminates stored Alexa credentials in favor of refresh-token-only authentication, improving security for Home Assistant users.
Upstream credit: Originally created by Keaton Taylor and maintained by Alan Tse.
Python Package for controlling Alexa devices (echo dot, etc) programmatically. This was originally designed for alexa_media_player a custom_component for Home Assistant.
NOTE: Alexa has no official API; therefore, this library may stop working at any time without warning.
Originally inspired by this blog (GitHub). Additional scaffolding from simplisafe-python
- Check for open features/bugs or initiate a discussion on one.
- Fork the repository.
- Install the dev environment:
make init. - Enter the virtual environment:
pipenv shell - Code your new feature or bug fix.
- Write a test that covers your new functionality.
- Update
README.mdwith any new documentation. - Run tests and ensure 100% code coverage for your contribution:
make coverage - Ensure you have no linting errors:
make lint - Ensure you have typed your code correctly:
make typing - Add yourself to
AUTHORS.md. - Submit a pull request!
Apache-2.0. By providing a contribution, you agree the contribution is licensed under Apache-2.0.