aws-annoying

Utilities to handle annoying AWS tasks.

✨ Features

• CLI application: Command-line interface for handling common, annoying AWS tasks
• Python library: Reusable utility functions for AWS operations
• Console enhancements: Browser user scripts to improve the AWS Console experience
• Dev Container Features: Reusable Dev Container Features for development environments

🚀 Quick start

It is recommended to use uvx (alias for uv tool run) to run aws-annoying CLI (you can also use pipx run if you prefer):

$ export TYPER_USE_RICH=0 # Disable Rich to simplify output. Ignore this
$ uvx "aws-annoying[cli]" --help
Usage: aws-annoying [OPTIONS] COMMAND [ARGS]...

Options:
  --version                 Show the version and exit.
  --quiet / --no-quiet      Disable outputs.  [default: no-quiet]
  --verbose / --no-verbose  Enable verbose outputs.  [default: no-verbose]
  --install-completion      Install completion for the current shell.
  --show-completion         Show completion for the current shell, to copy it
                            or customize the installation.
  --help                    Show this message and exit.

Commands:
  load-variables   Wrapper command to run command with variables from AWS...
  ecs              ECS (Elastic Container Service) utility commands.
  mfa              Commands to manage MFA authentication.
  session-manager  AWS Session Manager CLI utilities.

Or install the package via uv to install only the library then import it in your code (aws_annoying package) without CLI dependencies:

$ uv add aws-annoying

Please refer to the documentation for more information on how to use the application and package.

🐒 Browser User Scripts

To use browser user scripts to improve your AWS Console experience, download the scripts from the console directory and install them in your browser.

Note that these scripts are provided "as is" and may not work in all cases.

🐳 Dev Container Features

You can use the Dev Container Features provided in devcontainer-features directory to help set up development containers. For example, add it in your devcontainer.json file:

{
  "features": {
    "ghcr.io/lasuillard-s/aws-annoying/session-manager-plugin:0": {}
  }
}

💖 Contributing

Please refer to CONTRIBUTING.md for more information on how to contribute to this project.

📜 License

This project is licensed under the MIT License.