otty / dotfiles

All tools/AWSume

AWSume

awsume

Awsume is a convenient way to manage session tokens and assume role credentials.

Detected by awsume | macOS, Linux, Windows |awsu.me

Sync it awsume.toml

Sync rules

What travels, what stays, what never leaves

AWSume in your home directory Every rule on this page, by file

· config.yaml Sync

· cache/ Exclude

· logs/ Exclude

· ~/.local/state/awsume/logs/ Exclude

· ~/.config/awsume/config.yaml Sync

· ~/.cache/awsume/ Exclude

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/awsume.tomlThe file this page is generated from

id = "awsume"

name = "AWSume"

homepage = "https://awsu.me"

description = "Awsume is a convenient way to manage session tokens and assume role credentials."

# The logo awsu.me shows in its own header.

icon = "https://awsu.me/logo.png"

detect = ["awsume"]

# https://awsu.me/general/config.html: "Awsume's configuration file can be found

# at ~/.awsume/config.yaml by default. If the XDG_CONFIG_HOME environment

# variable is set then it can be found at: ${XDG_CONFIG_HOME}/awsume/config.yaml"

# — awsume/awsumepy/lib/constants.py picks between the same two. The second is

# the XDG config home itself, so it is written as [configHome] rather than as

# that variable's default.

paths = [

"~/.awsume/config.yaml",

"[configHome]/awsume/config.yaml",

]

# constants.py: AWSUME_CACHE_DIR holds cached session credentials and

# AWSUME_LOG_DIR holds the debug log. Both move under XDG_CACHE_HOME /

# XDG_STATE_HOME when those are set, so both spellings are carved out.

# Short-lived machine state, and the cache carries live AWS session tokens.

# The cache home is written [xdgCache] for the same reason config.yaml above is

# [configHome]: constants.py reads the variable itself

# (`AWSUME_CACHE_DIR = XDG_CACHE_HOME / 'awsume'`) on every platform and never

# touches ~/Library/Caches, so the XDG half of the pair is the one that names

# what awsume opens. Note that awsume branches on the variable being *set*, not

# on its default: with XDG_CACHE_HOME unset the cache is ~/.awsume/cache, listed

# above, and never ~/.cache/awsume. $XDG_STATE_HOME has no placeholder, so the

# log directory keeps its literal spelling.

exclude = [

"~/.awsume/cache/",

"~/.awsume/logs/",

"[xdgCache]/awsume/",

"~/.local/state/awsume/logs/",

]

# awsume reads the profiles it assumes from ~/.aws/config and ~/.aws/credentials

# (constants.py: DEFAULT_CONFIG_FILE / DEFAULT_CREDENTIALS_FILE), which are the

# aws entry's files. Its own config file holds preferences only.

secret = []

# Read once per invocation.

side_effect = false

# No machine_lines: colors, fuzzy matching, default region, role duration and

# session name are preferences that should follow the user.

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/awsume. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page.