alexapy-secure

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.

About This Fork

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.

alexapy (upstream)

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.

Credits

Originally inspired by this blog (GitHub). Additional scaffolding from simplisafe-python

Contributing

1. Check for open features/bugs or initiate a discussion on one.
2. Fork the repository.
3. Install the dev environment: make init.
4. Enter the virtual environment: pipenv shell
5. Code your new feature or bug fix.
6. Write a test that covers your new functionality.
7. Update README.md with any new documentation.
8. Run tests and ensure 100% code coverage for your contribution: make coverage
9. Ensure you have no linting errors: make lint
10. Ensure you have typed your code correctly: make typing
11. Add yourself to AUTHORS.md.
12. Submit a pull request!

License

Apache-2.0. By providing a contribution, you agree the contribution is licensed under Apache-2.0.

API Reference

See the docs 📚.