⚡ Brawser

What is Brawser?

The simplest browser opener with AWS management console from the command line interface.

By running this CLI command, you can open the console soon with your AWS account and the IAM role/user that you are using.

Note: the spelling of this tool is not br "o" wser, but br "aws" er.

How Brawser works?

The following steps are executed inside the Brawser.

1. Initialize a new session using the Boto3 library.
2. Prepare for session data.
3. Request a sign-in token.
4. Generate the federated URL.
5. Open your default browser with the URL

Prerequisite

• The IAM role/user which Brawser use with has the GetSessionToken priviledge at least.
• The URL is open with any default browser like Google Chrome, Safari or Edge. So any installed browser is needed.

🚀 Get Started

Install

$ pip install brawser

Usage

$ brawser

Uninstall

$ pip uninstall brawser

🌱 How to use

Features

• You can set a valid session time you want to set.
• You can display on the command line console the federated URL instead of opening the browser
• If you use macOS, you can copy the federated URL to the clipboard to paste your browser.

Options

  -p, --print-url       Print the federated URL (optional)
  -c, --copy-clipboard  Copy the federated URL when you use MacOS only
                        (optional)

Appendix

Software License

The MIT License

Copyright 2024 Itsuki Yutaka

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.