https://github.com/devndive/zsh-saml2aws-auto

A zsh plugin for saml2aws-auto with autocomplete and profile status
https://github.com/devndive/zsh-saml2aws-auto

saml2aws-auto zsh

Last synced: about 2 months ago
JSON representation

A zsh plugin for saml2aws-auto with autocomplete and profile status

• Host: GitHub
• URL: https://github.com/devndive/zsh-saml2aws-auto
• Owner: devndive
• License: mit
• Created: 2019-11-03T11:51:18.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2020-06-27T12:49:43.000Z (almost 4 years ago)
• Last Synced: 2024-01-25T13:03:53.091Z (4 months ago)
• Topics: saml2aws-auto, zsh
• Language: Shell
• Size: 549 KB
• Stars: 5
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-zsh-plugins - saml2aws-auto - When using multiple AWS profiles, e.g. different accounts for your stages (development, pre-prod, prod), can be used to determine which profile is currently exported and if the token is still valid. (Plugins / ZSH on Windows)
• fucking-awesome-zsh-plugins - saml2aws-auto - When using multiple AWS profiles, e.g. different accounts for your stages (development, pre-prod, prod), can be used to determine which profile is currently exported and if the token is still valid. (Plugins / ZSH on Windows)
• awesome-zsh-plugins - saml2aws-auto - When using multiple AWS profiles, e.g. different accounts for your stages (development, pre-prod, prod), can be used to determine which profile is currently exported and if the token is still valid. (Plugins / ZSH on Windows)
• awesome-zsh-plugins - saml2aws-auto - When using multiple AWS profiles, e.g. different accounts for your stages (development, pre-prod, prod), can be used to determine which profile is currently exported and if the token is still valid. (Plugins / Zinit (née zplugin))

README

        
# zsh-saml2aws-auto

ZSH plugin for [saml2aws-auto](https://github.com/Rukenshia/saml2aws-auto)

## Prerequisites

* Oh my zsh

* [A font with icons - I use FiraCode](https://github.com/ryanoasis/nerd-fonts/tree/master/patched-fonts/FiraCode)

## Installation

`git clone https://github.com/devndive/zsh-saml2aws-auto.git $ZSH_CUSTOM/plugins/zsh-saml2aws-auto`

Enable the plugin in your `~/.zshrc` by adding `zsh-saml2aws-auto` to your plugins.

To get the indicators in your prompt add

`RPROMPT='$(aws_profile)'`

## Features

When using multiple AWS profiles, e.g. different accounts for your stages (development, pre-prod, prod), I like to see which profile is currently exported and if the token is still valid.

### An alias s2a

The plugin will export an alias for you:

`alias s2a="saml2aws-auto"`

### Basic autocompletion for saml2aws-auto

Completing commands

![Completing commands](imgs/autocomplete-commands.png)

Completing groups

![Completing groups](imgs/autocomplete-groups.png)

### Which profile is currently exported?

Image you have a group configured with the following entries:

* yann-duval-dev

* yann-duval-pre-prod

Now you would export the pre-prod profile

`export AWS_PROFILE=yann-duval-pre-prod`

![Expired profile](imgs/expired-session.png)

To easily identify typos the indicator will be red

![Invalid profile](imgs/invalid-profile.png)

### How long is the session valid for?

If you are running a command that might take sometime, eg. deleting a CloudFront distribution, it helps to know how long your session is valid for

![Valid session](imgs/valid-session.png)