{"id":25146583,"url":"https://github.com/wulfmann/aws-coco","last_synced_at":"2025-04-28T12:26:59.300Z","repository":{"id":57413204,"uuid":"300615434","full_name":"wulfmann/aws-coco","owner":"wulfmann","description":"Easily manage AWS Console Sessions","archived":false,"fork":false,"pushed_at":"2024-03-20T18:24:08.000Z","size":35,"stargazers_count":1,"open_issues_count":3,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-20T23:44:06.874Z","etag":null,"topics":["aws","aws-console","aws-credentials","firefox","firefox-containers"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/aws-coco/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wulfmann.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-10-02T12:59:23.000Z","updated_at":"2023-12-16T01:46:34.000Z","dependencies_parsed_at":"2022-08-29T15:22:44.354Z","dependency_job_id":null,"html_url":"https://github.com/wulfmann/aws-coco","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wulfmann%2Faws-coco","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wulfmann%2Faws-coco/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wulfmann%2Faws-coco/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wulfmann%2Faws-coco/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wulfmann","download_url":"https://codeload.github.com/wulfmann/aws-coco/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237864422,"owners_count":19378343,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","aws-console","aws-credentials","firefox","firefox-containers"],"created_at":"2025-02-08T20:19:36.111Z","updated_at":"2025-02-08T20:19:36.662Z","avatar_url":"https://github.com/wulfmann.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AWS coco (console container)\n\n![PyPI - Python Version](https://img.shields.io/pypi/pyversions/aws-coco)\n\nEasily manage AWS Console Sessions\n\n## Quickstart\n\nInstall\n\n```bash\n$ pip install aws-coco\n```\n\nUsage\n\n```bash\n$ coco\n```\n\nYou should now have a new browser tab with your aws session!\n\nContinue reading for a more in-depth walkthrough of the setup.\n\nIf `coco` is too generic, this package also exposes `aws_coco`.\n\n## Requirements\n\nThere are two different modes for `coco`. Normal and Firefox Containers.\n\n### Container Mode (default)\n\n- [Firefox](https://www.mozilla.org/en-US/firefox/new/)\n- [Firefox Multi-Account Containers](https://addons.mozilla.org/en-US/firefox/addon/multi-account-containers/)\n- [Open URL in Container Extension](https://addons.mozilla.org/en-US/firefox/addon/open-url-in-container/)\n\nIf you don't wish to install the extension through the marketplace, you can install from source [here](https://github.com/honsiorovskyi/open-url-in-container).\n\n### Normal Mode\n\n- Any browser supported by [webbrowser](https://docs.python.org/3.8/library/webbrowser.html#webbrowser.get)\n- [Python \u003e= 3.7](http://python.org/)\n\nIf you do not wish to use containers, make sure to specify the `--no-container` flag.\n\n## Installation\n\n```bash\n$ pip install aws-coco\n```\n\n## Usage\n\nThis section explains how to use `coco` and covers some of the options available to you.\n\n### Basic Usage\n\n#### Container Mode Example\n\n```bash\n$ coco --color green --icon fingerprint --name test\n```\n\nThis will open the url in a `green` firefox container tab named `test` with a `fingerprint` icon.\n\nThis can be annoying to type, so it's recommended to build aliases for your accounts.\n\nExample alias:\n\n```bash\nalias coco-test=coco --color green --icon fingerprint --name test\n```\n\nNow you can just run:\n\n```bash\n$ coco-test\n```\n\n#### Normal Mode Example\n\n```bash\n$ coco\n```\n\nThis will open your session in your default browser.\n\n### Credential Resolution\n\nThis 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).\n\nIf 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.\n\n### Options\n\nThis section contains a description of the various options available to you. You can also pass the `-h` flag to print the help.\n\n|Flag|Description|Default|Required|\n|----|-----------|-------|--------|\n|`--color`, `-c`|The container tab's color||false|\n|`--container`, `--no-container`|Determines if the url should be opened in a firefox container||true|\n|`--destination`, `-d`|The destination URL to open in the AWS console||false|\n|`--icon`, `-i`|The container tab's icon||false|\n|`--name`, `-n`|The container tab's name|The profile name if passed|false|\n|`--open`, `--no-open`|Determines if the url should be automatically opened in the browser||true|\n|`--profile`, `-p`|The AWS profile to use||false|\n\n### Available Colors\n\n|value|\n|-----|\n|blue|\n|turquoise|\n|green|\n|yellow|\n|orange|\n|red|\n|pink|\n|purple|\n\n### Available Icons\n\n|value|\n|-----|\n|fingerprint|\n|briefcase|\n|dollar|\n|cart|\n|vacation|\n|gift|\n|food|\n|fruit|\n|pet|\n|tree|\n|chill|\n|circle|\n|fence|\n\n## Contributing\n\nFor more information on contributing, check out the [doc](/CONTRIBUTING.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwulfmann%2Faws-coco","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwulfmann%2Faws-coco","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwulfmann%2Faws-coco/lists"}