Metadata-Version: 2.1
Name: aws-coco
Version: 0.1.3
Summary: A utility for managing AWS Console Sessions with Firefox Containers
Home-page: https://github.com/wulfmann/aws-coco
License: MIT
Keywords: aws,firefox containers,aws console,console container
Author: Joe Snell
Author-email: joepsnell@gmail.com
Requires-Python: >=3.8,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Requires-Dist: boto3 (>=1.15.10,<2.0.0)
Requires-Dist: requests (>=2.24.0,<3.0.0)
Project-URL: Documentation, https://github.com/wulfmann/aws-coco/README.md
Project-URL: Repository, https://github.com/wulfmann/aws-coco
Project-URL: issues, https://github.com/wulfmann/aws-coco/issues
Description-Content-Type: text/markdown

# AWS coco (console container)

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

## Quickstart

Ensure you've  met the [requirements](#requirements).

```bash
$ pip install aws-coco
```

Usage

```bash
$ 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.

## Requirements

- [Firefox](https://www.mozilla.org/en-US/firefox/new/)
- [Firefox Multi-Account Containers](https://addons.mozilla.org/en-US/firefox/addon/multi-account-containers/)
- [Open URL in Container Extension](https://addons.mozilla.org/en-US/firefox/addon/open-url-in-container/)
- [Python >= 3.7](http://python.org/)

If you don't wish to install the extension through the marketplace, the source for the extension can be found [here](https://github.com/honsiorovskyi/open-url-in-container).

## Installation

```bash
$ pip install aws_coco
```

## Usage

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

### Basic Usage

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

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

### Credential Resolution

This project uses [boto3](https://github.com/boto/boto3). You can learn more about how `boto3` resolves credentials [here](https://boto3.amazonaws.com/v1/documentation/api/1.9.42/guide/configuration.html#configuring-credentials).

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

```bash
$ git clone https://github.com/wulfmann/aws-coco.git
$ git clone git@github.com:wulfmann/aws-coco.git
```

Install Dependencies

```bash
$ poetry install
```

Run the command

```bash
$ poetry run coco -c green -i fingerprint
```

Run tests

```bash
$ poetry run pytest
```

