Skip to main content

A utility for managing AWS Console Sessions with Firefox Containers

Project description

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:

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

If not:

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 git@github.com:wulfmann/aws-coco.git

Install Dependencies

$ poetry install

Run the command

$ poetry run coco -c green -i fingerprint

Run tests

$ poetry run pytest

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aws-coco-0.1.7.tar.gz (4.9 kB view hashes)

Uploaded Source

Built Distribution

aws_coco-0.1.7-py3-none-any.whl (5.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page