aws-coco

AWS coco (console container)

This tool allows you to manage AWS Console Sessions with Firefox Containers

Quickstart

Ensure you've met the requirements.

$ pip install aws-coco

Usage

$ coco -c green -i fingerprint

You should now have a new browser tab with your aws session!

Continue reading for a more in-depth walkthrough of the setup.

If coco is too generic, this package also exposes aws_coco.

Requirements

If using containers:

• Firefox
• Firefox Multi-Account Containers
• Open URL in Container Extension

If you don't wish to install the extension through the marketplace, the source for the extension can be found here.

If not:

• Any browser supported by webbrowser
• Python >= 3.7

If you do not wish to use containers, make sure to specify the --no-container flag.

Installation

$ pip install aws-coco

Usage

This section explains how to use coco and covers some of the options available to you.

Basic Usage

$ coco --color green --icon fingerprint --name test

This will open the url in a green firefox container tab named test with a fingerprint icon.

This can be annoying to type, so it's recommended to build aliases for your accounts.

Example alias:

alias coco-test=coco --color green --icon fingerprint --name test

Now you can just run:

$ coco-test

Credential Resolution

This project uses boto3. You can learn more about how boto3 resolves credentials here.

If you specify the --profile flag, coco will pass that value into the boto3 session and it will attempt to use the corresponding section in the ~/.aws/credentials file for the session.

Options

This section contains a description of the various options available to you. You can also pass the -h flag to print the help.

Flag	Description	Default	Required
--color, -c	The container tab's color		false
--container, --no-container	Determines if the url should be opened in a firefox container		true
--destination, -d	The destination URL to open in the AWS console		false
--icon, -i	The container tab's icon		false
--name, -n	The container tab's name	The profile name if passed	false
--open, --no-open	Determines if the url should be automatically opened in the browser		true
--profile, -p	The AWS profile to use		false

Available Colors

value
blue
turquoise
green
yellow
orange
red
pink
purple

Available Icons

value
fingerprint
briefcase
dollar
cart
vacation
gift
food
fruit
pet
tree
chill
circle
fence

Development

$ git clone https://github.com/wulfmann/aws-coco.git
$ git clone [e-mail]:wulfmann/aws-coco.git

Install Dependencies

$ poetry install

Run the command

$ poetry run coco -c green -i fingerprint

Run tests

$ poetry run pytest