awskeyring 1.4.0 → 1.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ae2606582cb2a9c079bf4ebcb6223570148954cf66fe9938c9b4d969c1312da6
-  data.tar.gz: d6b24f01901e6c3161e1874f9bd9d018f9b62e734d7d73f5ffaed78f0125ecb1
+  metadata.gz: 6f414457dbb053f2bbe8fde789ee2238ed11d3554576bfbd67ff52c84697eb5b
+  data.tar.gz: 70766a2e47f57dccd562a604d278bfa248b6133b7aa5f6f6a0c697bd2fd09cdc
 SHA512:
-  metadata.gz: d7704820e908585b67575c319e03493512917a9e5ea5db9620040402c49fbcd6466448e108949bcf32ea2d2f782e2ee8bf7e3e1bdd4e4138cb6d462c2c603635
-  data.tar.gz: 667e7d6d0417cda0a79c1d81680469f1ba2c7a03630bd8e7269e03f137ad669155126a927eb39542b1e9e0b07ee0f408678bb603bc77900cc7db9ff60e702c6b
+  metadata.gz: 6a14c818ec8f52ad3b0520d779c047eb2523252d9ebc032005571ed347fe3a66f3015e7cc5f7f64a0ff36845ea4c7232e5c70f64da171b5e489bc01b1be6b525
+  data.tar.gz: bbd9103d268378c1901097854df9880d6b5dc32843feb24e654faff26d8dfd8952862cfb48c492c290cd88b87ee6897c4ad8a8f1407dc0c22a8207b32f1c34d3

data/CHANGELOG.md

@@ -1,5 +1,56 @@
 # Changelog
 
+## [v1.8.1](https://github.com/servian/awskeyring/tree/v1.8.1) (2021-01-20)
+
+[Full Changelog](https://github.com/servian/awskeyring/compare/v1.8.0...v1.8.1)
+
+**Fixed bugs:**
+
+- Update command failed. [\#75](https://github.com/servian/awskeyring/issues/75)
+
+**Merged pull requests:**
+
+- Default nil token \(fix \#75\) [\#76](https://github.com/servian/awskeyring/pull/76) ([tristanmorgan](https://github.com/tristanmorgan))
+
+## [v1.8.0](https://github.com/servian/awskeyring/tree/v1.8.0) (2020-12-07)
+
+[Full Changelog](https://github.com/servian/awskeyring/compare/v1.7.0...v1.8.0)
+
+**Implemented enhancements:**
+
+- Include expiry time export, AWS\_CREDENTIAL\_EXPIRATION [\#74](https://github.com/servian/awskeyring/pull/74) ([tristanmorgan](https://github.com/tristanmorgan))
+
+## [v1.7.0](https://github.com/servian/awskeyring/tree/v1.7.0) (2020-11-18)
+
+[Full Changelog](https://github.com/servian/awskeyring/compare/v1.6.0...v1.7.0)
+
+**Implemented enhancements:**
+
+- Allow specifying a browser other than the default [\#71](https://github.com/servian/awskeyring/issues/71)
+- Autocomplete for Browsers [\#73](https://github.com/servian/awskeyring/pull/73) ([tristanmorgan](https://github.com/tristanmorgan))
+
+**Merged pull requests:**
+
+- Updates for added RuboCop checks. [\#70](https://github.com/servian/awskeyring/pull/70) ([tristanmorgan](https://github.com/tristanmorgan))
+
+## [v1.6.0](https://github.com/servian/awskeyring/tree/v1.6.0) (2020-08-11)
+
+[Full Changelog](https://github.com/servian/awskeyring/compare/v1.5.0...v1.6.0)
+
+**Implemented enhancements:**
+
+- Warn about missing accounts/roles [\#69](https://github.com/servian/awskeyring/pull/69) ([tristanmorgan](https://github.com/tristanmorgan))
+- RuboCop and Spec update [\#68](https://github.com/servian/awskeyring/pull/68) ([tristanmorgan](https://github.com/tristanmorgan))
+- Add SimpleCov reports. [\#67](https://github.com/servian/awskeyring/pull/67) ([tristanmorgan](https://github.com/tristanmorgan))
+
+## [v1.5.0](https://github.com/servian/awskeyring/tree/v1.5.0) (2020-07-08)
+
+[Full Changelog](https://github.com/servian/awskeyring/compare/v1.4.0...v1.5.0)
+
+**Implemented enhancements:**
+
+- No-Bundle env changes for exec. [\#66](https://github.com/servian/awskeyring/pull/66) ([tristanmorgan](https://github.com/tristanmorgan))
+
 ## [v1.4.0](https://github.com/servian/awskeyring/tree/v1.4.0) (2020-06-19)
 
 [Full Changelog](https://github.com/servian/awskeyring/compare/v1.3.3...v1.4.0)

data/Gemfile

@@ -15,5 +15,6 @@ group :development do
   gem 'rubocop-rake'
   gem 'rubocop-rspec'
   gem 'rubocop-rubycw'
+  gem 'simplecov'
   gem 'yard'
 end

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2017 Tristan Morgan
+Copyright (c) 2017-2020 Tristan Morgan
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,8 +1,8 @@
 # Awskeyring
 
-![Awskeyring](https://raw.githubusercontent.com/servian/awskeyring/master/awskeyring-144.png)
+![Awskeyring](https://raw.githubusercontent.com/servian/awskeyring/main/awskeyring-144.png)
 
-* [![Build Status](https://travis-ci.org/servian/awskeyring.svg?branch=master)](https://travis-ci.org/servian/awskeyring)
+* [![Build Status](https://travis-ci.org/servian/awskeyring.svg?branch=main)](https://travis-ci.org/servian/awskeyring)
 * [![Gem Version](https://badge.fury.io/rb/awskeyring.svg)](https://badge.fury.io/rb/awskeyring)
 * [![license MIT](https://img.shields.io/badge/license-MIT-brightgreen.svg)](https://opensource.org/licenses/MIT)
 * [![All Downloads](https://ruby-gem-downloads-badge.herokuapp.com/awskeyring?type=total)](https://rubygems.org/gems/awskeyring)
@@ -27,6 +27,10 @@ Install it with:
 
     $ gem install awskeyring --user-install
 
+or via [homebrew gem](https://github.com/sportngin/brew-gem):
+
+    $ brew gem install awskeyring
+
 ## Wiki
 
 Please see the [Wiki](https://github.com/servian/awskeyring/wiki) for full usage instructions and tips.
@@ -113,6 +117,7 @@ the [Contributor Covenant](https://contributor-covenant.org) code of conduct.
 
 * Tristan [tristanmorgan](https://github.com/tristanmorgan)
 * Adam Sir [AzySir](https://github.com/AzySir)
+* Vito Giarrusso [thtliife](https://github.com/thtliife)
 
 ## License
 

data/SECURITY.md

@@ -0,0 +1,4 @@
+# Security Policy
+
+If you believe you have found a security issue in Awskeyring, please responsibly disclose by contacting me at
+[tristan.morgan@servian.com](mailto:tristan.morgan@servian.com).

data/awskeyring.gemspec

@@ -20,9 +20,11 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
+  spec.required_ruby_version = '>= 2.6.0'
+
   spec.metadata = {
     'bug_tracker_uri' => "#{Awskeyring::HOMEPAGE}/issues",
-    'changelog_uri' => "#{Awskeyring::HOMEPAGE}/blob/master/CHANGELOG.md",
+    'changelog_uri' => "#{Awskeyring::HOMEPAGE}/blob/main/CHANGELOG.md",
     'documentation_uri' => "https://rubydoc.info/gems/#{spec.name}/#{Awskeyring::VERSION}",
     'source_code_uri' => "#{Awskeyring::HOMEPAGE}/tree/v#{Awskeyring::VERSION}",
     'wiki_uri' => "#{Awskeyring::HOMEPAGE}/wiki"

data/i18n/en.yml

@@ -44,10 +44,12 @@ en:
     key: 'AWS account key id.'
     keychain: 'Name of KEYCHAIN to initialise.'
     mfa: 'AWS virtual mfa arn.'
+    nobundle: 'Unset Bundler environment variables.'
     noopen: 'Do not open the url.'
     notoken: 'Do not use saved token.'
     noremote: 'Do not validate with remote api.'
     path: 'The service PATH to open.'
+    browser: 'Specify an alternative browser.'
     role: 'The ROLE to assume.'
     secret: 'AWS account secret.'
     unset: 'Unset environment variables.'
@@ -74,6 +76,8 @@ en:
     delexpired: '# Removing expired session credentials'
     exec: '# COMMAND not provided'
     missing: '# Config missing, run `%{bin} initialise` to recreate.'
+    missing_account: '# No accounts added, run `%{bin} add` to add.'
+    missing_role: '# No roles added, run `%{bin} add-role` to add.'
     rotate: '# You have two access keys for account %{account}'
     temporary: '# Using temporary session credentials.'
     timeout: '# It is STRONGLY recommended to set your keychain to lock in 5 minutes or less.'

data/lib/awskeyring.rb

@@ -27,6 +27,8 @@ module Awskeyring # rubocop:disable Metrics/ModuleLength
   DEFAULT_KEY_AGE = 90
   # Default Console Paths
   DEFAULT_CONSOLE_LIST = %w[cloudformation ec2/v2 iam rds route53 s3 sns sqs vpc].freeze
+  # Default Browsers
+  DEFAULT_BROWSER_LIST = %w[Brave FireFox Opera Safari Vivaldi].freeze
 
   # Retrieve the preferences
   #
@@ -174,26 +176,26 @@ module Awskeyring # rubocop:disable Metrics/ModuleLength
 
   # Return a list account item names
   def self.list_account_names
-    items = list_items.map { |elem| elem.attributes[:label][(ACCOUNT_PREFIX.length)..-1] }
+    items = list_items.map { |elem| elem.attributes[:label][(ACCOUNT_PREFIX.length)..] }
 
-    tokens = list_tokens.map { |elem| elem.attributes[:label][(SESSION_KEY_PREFIX.length)..-1] }
+    tokens = list_tokens.map { |elem| elem.attributes[:label][(SESSION_KEY_PREFIX.length)..] }
 
     (items + tokens).uniq.sort
   end
 
   # Return a list role item names
   def self.list_role_names
-    list_roles.map { |elem| elem.attributes[:label][(ROLE_PREFIX.length)..-1] }.sort
+    list_roles.map { |elem| elem.attributes[:label][(ROLE_PREFIX.length)..] }.sort
   end
 
   # Return a list token item names
   def self.list_token_names
-    list_tokens.map { |elem| elem.attributes[:label][(SESSION_KEY_PREFIX.length)..-1] }.sort
+    list_tokens.map { |elem| elem.attributes[:label][(SESSION_KEY_PREFIX.length)..] }.sort
   end
 
   # Return a list role item names and arns
   def self.list_role_names_plus
-    list_roles.map { |elem| "#{elem.attributes[:label][(ROLE_PREFIX.length)..-1]}\t#{elem.attributes[:account]}" }
+    list_roles.map { |elem| "#{elem.attributes[:label][(ROLE_PREFIX.length)..]}\t#{elem.attributes[:account]}" }
   end
 
   # Return a list of console paths
@@ -201,6 +203,11 @@ module Awskeyring # rubocop:disable Metrics/ModuleLength
     prefs.key?('console') ? prefs['console'] : DEFAULT_CONSOLE_LIST
   end
 
+  # Return a list of browserss
+  def self.list_browsers
+    prefs.key?('browser') ? prefs['browser'] : DEFAULT_BROWSER_LIST
+  end
+
   # Return Key age warning number
   def self.key_age
     prefs.key?('keyage') ? prefs['keyage'] : DEFAULT_KEY_AGE

data/lib/awskeyring/awsapi.rb

@@ -27,6 +27,7 @@ module Awskeyring
       AWS_ACCOUNT_NAME
       AWS_ACCESS_KEY_ID
       AWS_ACCESS_KEY
+      AWS_CREDENTIAL_EXPIRATION
       AWS_SECRET_ACCESS_KEY
       AWS_SECRET_KEY
       AWS_SECURITY_TOKEN
@@ -126,6 +127,8 @@ module Awskeyring
       env_var = {}
       env_var['AWS_DEFAULT_REGION'] = 'us-east-1' unless region
 
+      params[:expiration] = Time.at(params[:expiry]).iso8601 unless params[:expiry].nil?
+
       params.each_key do |param_name|
         AWS_ENV_VARS.each do |var_name|
           if var_name.include?(param_name.to_s.upcase) && !params[param_name].nil?
@@ -142,7 +145,7 @@ module Awskeyring
     # @param [String] key The aws_access_key_id
     # @param [String] secret The aws_secret_access_key
     # @param [String] token The aws_session_token
-    def self.verify_cred(key:, secret:, token:)
+    def self.verify_cred(key:, secret:, token: nil)
       begin
         ENV['AWS_DEFAULT_REGION'] = 'us-east-1' unless region
         sts = Aws::STS::Client.new(access_key_id: key, secret_access_key: secret, session_token: token)
@@ -198,9 +201,9 @@ module Awskeyring
         sessionToken: token
       }.to_json
 
-      destination_param = '&Destination=' + CGI.escape(console_url)
+      destination_param = "&Destination=#{CGI.escape(console_url)}"
 
-      AWS_SIGNIN_URL + '?Action=login' + token_param(session_json: session_json) + destination_param
+      "#{AWS_SIGNIN_URL}?Action=login#{token_param(session_json: session_json)}#{destination_param}"
     end
 
     # Get the signin token param
@@ -214,7 +217,7 @@ module Awskeyring
       returned_content = request.get(uri).body
 
       signin_token = JSON.parse(returned_content)['SigninToken']
-      '&SigninToken=' + CGI.escape(signin_token)
+      "&SigninToken=#{CGI.escape(signin_token)}"
     end
 
     # Get the current region

data/lib/awskeyring/input.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require 'io/console'
-
 # Awskeyring Module,
 module Awskeyring
   # Input methods for Awskeyring
@@ -15,18 +13,20 @@ module Awskeyring
     end
 
     private_class_method def self.hide_input # rubocop:disable Metrics/MethodLength
+      require 'io/console'
       password = +''
       loop do
         character = $stdin.getch
         break unless character
 
-        if ["\n", "\r"].include? character
+        case character
+        when "\n", "\r"
           puts ''
           break
-        elsif ["\b", "\u007f"].include? character
+        when "\b", "\u007f"
           password.chop!
           print "\b\e[P"
-        elsif character == "\u0003"
+        when "\u0003"
           exit 1
         else
           print '*'

data/lib/awskeyring/version.rb

@@ -6,7 +6,7 @@ require 'json'
 # Version const and query of latest.
 module Awskeyring
   # The Gem's version number
-  VERSION = '1.4.0'
+  VERSION = '1.8.1'
   # The Gem's homepage
   HOMEPAGE = 'https://github.com/servian/awskeyring'
 

data/lib/awskeyring_command.rb

@@ -72,6 +72,10 @@ class AwskeyringCommand < Thor # rubocop:disable Metrics/ClassLength
   desc 'list', I18n.t('list.desc')
   # list the accounts
   def list
+    if Awskeyring.list_account_names.empty?
+      warn I18n.t('message.missing_account', bin: File.basename($PROGRAM_NAME))
+      exit 1
+    end
     puts Awskeyring.list_account_names.join("\n")
   end
 
@@ -80,7 +84,11 @@ class AwskeyringCommand < Thor # rubocop:disable Metrics/ClassLength
   method_option 'detail', type: :boolean, aliases: '-d', desc: I18n.t('method_option.detail'), default: false
   # List roles
   def list_role
-    if options['detail']
+    if Awskeyring.list_role_names.empty?
+      warn I18n.t('message.missing_role', bin: File.basename($PROGRAM_NAME))
+      exit 1
+    end
+    if options[:detail]
       puts Awskeyring.list_role_names_plus.join("\n")
     else
       puts Awskeyring.list_role_names.join("\n")
@@ -92,7 +100,7 @@ class AwskeyringCommand < Thor # rubocop:disable Metrics/ClassLength
   method_option 'unset', type: :boolean, aliases: '-u', desc: I18n.t('method_option.unset'), default: false
   # Print Env vars
   def env(account = nil)
-    if options['unset']
+    if options[:unset]
       put_env_string(account: nil, key: nil, secret: nil, token: nil)
     else
       account = ask_check(
@@ -160,6 +168,7 @@ class AwskeyringCommand < Thor # rubocop:disable Metrics/ClassLength
 
   desc 'exec ACCOUNT command...', I18n.t('exec.desc')
   method_option 'no-token', type: :boolean, aliases: '-n', desc: I18n.t('method_option.notoken'), default: false
+  method_option 'no-bundle', type: :boolean, aliases: '-b', desc: I18n.t('method_option.nobundle'), default: false
   # execute an external command with env set
   def exec(account, *command)
     if command.empty?
@@ -168,6 +177,7 @@ class AwskeyringCommand < Thor # rubocop:disable Metrics/ClassLength
     end
     cred = age_check_and_get(account: account, no_token: options['no-token'])
     env_vars = Awskeyring::Awsapi.get_env_array(cred)
+    unbundle if options['no-bundle']
     begin
       pid = Process.spawn(env_vars, command.join(' '))
       Process.wait pid
@@ -199,7 +209,7 @@ class AwskeyringCommand < Thor # rubocop:disable Metrics/ClassLength
       existing: options[:mfa], message: I18n.t('message.mfa'),
       flags: 'optional', validator: Awskeyring::Validate.method(:mfa_arn)
     )
-    Awskeyring::Awsapi.verify_cred(key: key, secret: secret, token: nil) unless options['no-remote']
+    Awskeyring::Awsapi.verify_cred(key: key, secret: secret) unless options['no-remote']
     Awskeyring.add_account(
       account: account,
       key: key,
@@ -377,6 +387,7 @@ class AwskeyringCommand < Thor # rubocop:disable Metrics/ClassLength
 
   desc 'console ACCOUNT', I18n.t('console.desc')
   method_option :path, type: :string, aliases: '-p', desc: I18n.t('method_option.path')
+  method_option :browser, type: :string, aliases: '-b', desc: I18n.t('method_option.browser')
   method_option 'no-token', type: :boolean, aliases: '-n', desc: I18n.t('method_option.notoken'), default: false
   method_option 'no-open', type: :boolean, aliases: '-o', desc: I18n.t('method_option.noopen'), default: false
   # Open the AWS Console
@@ -407,7 +418,8 @@ class AwskeyringCommand < Thor # rubocop:disable Metrics/ClassLength
     if options['no-open']
       puts login_url
     else
-      pid = Process.spawn("open \"#{login_url}\"")
+      spawn_cmd = options[:browser] ? "open -a \"#{options[:browser]}\" \"#{login_url}\"" : "open \"#{login_url}\""
+      pid = Process.spawn(spawn_cmd)
       Process.wait pid
     end
   end
@@ -450,9 +462,11 @@ class AwskeyringCommand < Thor # rubocop:disable Metrics/ClassLength
     when 'remove-role', '-r', 'rmr'
       comp_len = 2
     when '--path', '-p'
-      comp_len = 4
+      comp_len = 40
     when 'remove-token', 'rmt'
-      comp_len = 5
+      comp_len = 50
+    when '--browser', '-b'
+      comp_len = 60
     end
 
     [curr, comp_len, sub_cmd]
@@ -477,12 +491,14 @@ class AwskeyringCommand < Thor # rubocop:disable Metrics/ClassLength
       list = Awskeyring.list_account_names
     when 2
       list = Awskeyring.list_role_names
-    when 3
+    when 3..10
       list = list_arguments(command: sub_cmd)
-    when 4
+    when 40
       list = Awskeyring.list_console_path
-    when 5
+    when 50
       list = Awskeyring.list_token_names
+    when 60
+      list = Awskeyring.list_browsers
     else
       exit 1
     end
@@ -537,13 +553,26 @@ class AwskeyringCommand < Thor # rubocop:disable Metrics/ClassLength
 
   def ask(message:, secure: false, optional: false, limited_to: nil)
     if secure
-      Awskeyring::Input.read_secret(message.rjust(20) + ': ')
+      Awskeyring::Input.read_secret("#{message.rjust(20)}: ")
     elsif optional
-      Thor::LineEditor.readline((message + ' (optional)').rjust(20) + ': ')
+      Thor::LineEditor.readline("#{"#{message} (optional)".rjust(20)}: ")
     elsif limited_to
-      Thor::LineEditor.readline(message.rjust(20) + ': ', limited_to: limited_to)
+      Thor::LineEditor.readline("#{message.rjust(20)}: ", limited_to: limited_to)
     else
-      Thor::LineEditor.readline(message.rjust(20) + ': ')
+      Thor::LineEditor.readline("#{message.rjust(20)}: ")
+    end
+  end
+
+  def unbundle
+    to_delete = ENV.keys.select { |elem| elem.start_with?('BUNDLER_ORIG_') }
+    bundled_env = to_delete.map { |elem| elem[('BUNDLER_ORIG_'.length)..] }
+    to_delete << 'BUNDLE_GEMFILE'
+    bundled_env.each do |env_name|
+      ENV[env_name] = ENV["BUNDLER_ORIG_#{env_name}"]
+      to_delete << env_name if ENV["BUNDLER_ORIG_#{env_name}"].start_with? 'BUNDLER_'
+    end
+    to_delete.each do |env_name|
+      ENV.delete(env_name)
     end
   end
 end

data/man/awskeyring.5

@@ -1,7 +1,7 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "AWSKEYRING" "5" "June 2020" "" ""
+.TH "AWSKEYRING" "5" "November 2020" "" ""
 .
 .SH "NAME"
 \fBAwskeyring\fR \- is a small tool to manage AWS account keys in the macOS Keychain
@@ -24,36 +24,90 @@ The commands are as follows:
 .IP
 Prints the version
 .
+.br
+.
+.IP
+\-r, \-\-no\-remote: Do not validate with remote api\.
+.
 .TP
 add ACCOUNT:
 .
 .IP
 Adds an ACCOUNT to the keyring
 .
+.br
+.
+.IP
+\-k, \-\-key=KEY: AWS account key id\.
+.
+.br
+\-s, \-\-secret=SECRET: AWS account secret\.
+.
+.br
+\-m, \-\-mfa=MFA: AWS virtual mfa arn\.
+.
+.br
+\-r, \-\-no\-remote: Do not validate with remote api\.
+.
 .TP
 add\-role ROLE:
 .
 .IP
 Adds a ROLE to the keyring
 .
+.br
+.
+.IP
+\-a, \-\-arn=ARN: AWS role arn\.
+.
 .TP
-console ACCOUNT:
+awskeyring console ACCOUNT:
 .
 .IP
 Open the AWS Console for the ACCOUNT
 .
+.br
+.
+.IP
+\-p, \-\-path=PATH: The service PATH to open\.
+.
+.br
+\-b, \-\-browser=BROWSER: Specify an alternative browser\.
+.
+.br
+\-n, \-\-no\-token: Do not use saved token\.
+.
+.br
+\-o, \-\-no\-open: Do not open the url\.
+.
 .TP
 env ACCOUNT:
 .
 .IP
 Outputs bourne shell environment exports for an ACCOUNT
 .
+.br
+.
+.IP
+\-n, \-\-no\-token: Do not use saved token\.
+.
+.br
+\-u, \-\-unset, \-\-no\-unset: Unset environment variables\.
+.
 .TP
 exec ACCOUNT command\.\.\.:
 .
 .IP
 Execute a COMMAND with the environment set for an ACCOUNT
 .
+.br
+.
+.IP
+\-n, \-\-no\-token: Do not use saved token\.
+.
+.br
+\-b, \-\-no\-bundle: Unset Bundler environment variables\.
+.
 .TP
 help [COMMAND]:
 .
@@ -66,18 +120,33 @@ import:
 .IP
 Import an ACCOUNT to the keyring from ~/\.aws/credentials
 .
+.br
+.
+.IP
+\-r, \-\-no\-remote: Do not validate with remote api\.
+.
 .TP
 initialise:
 .
 .IP
 Initialises a new KEYCHAIN
 .
+.br
+.
+.IP
+\-n, \-\-keychain=KEYCHAIN: Name of KEYCHAIN to initialise\.
+.
 .TP
 json ACCOUNT:
 .
 .IP
 Outputs AWS CLI compatible JSON for an ACCOUNT
 .
+.br
+.
+.IP
+\-n, \-\-no\-token: Do not use saved token\.
+.
 .TP
 list:
 .
@@ -90,6 +159,11 @@ list\-role:
 .IP
 Prints a list of roles in the keyring
 .
+.br
+.
+.IP
+\-d, \-\-detail, \-\-no\-detail: Show more detail\.
+.
 .TP
 remove ACCOUNT:
 .
@@ -120,12 +194,34 @@ token ACCOUNT [ROLE] [MFA]:
 .IP
 Create an STS Token from a ROLE or an MFA code
 .
+.br
+.
+.IP
+\-r, \-\-role=ROLE: The ROLE to assume\.
+.
+.br
+\-c, \-\-code=CODE: Virtual mfa CODE\.
+.
+.br
+\-d, \-\-duration=DURATION: Session DURATION in seconds\.
+.
 .TP
 update ACCOUNT:
 .
 .IP
 Updates an ACCOUNT in the keyring
 .
+.br
+.
+.IP
+\-k, \-\-key=KEY: AWS account key id\.
+.
+.br
+\-s, \-\-secret=SECRET: AWS account secret\.
+.
+.br
+\-r, \-\-no\-remote: Do not validate with remote api\.
+.
 .SH "ENVIRONMENT"
 The AWS_DEFAULT_REGION environment variable will be used for AWS API calls where specified or fall back to us\-east\-1 when not\.
 .
@@ -188,6 +284,9 @@ Tristan tristanmorgan \fIhttps://github\.com/tristanmorgan\fR
 .IP "\(bu" 4
 Adam Sir AzySir \fIhttps://github\.com/AzySir\fR
 .
+.IP "\(bu" 4
+Vito Giarrusso thtliife \fIhttps://github\.com/thtliife\fR
+.
 .IP "" 0
 .
 .SH "LICENSE"

data/man/awskeyring.5.ronn

@@ -16,27 +16,47 @@ The commands are as follows:
 
 * --version, -v:
 
-    Prints the version
+    Prints the version<br>
+
+    -r, --no-remote: Do not validate with remote api.
 
 * add ACCOUNT:
 
-    Adds an ACCOUNT to the keyring
+    Adds an ACCOUNT to the keyring<br>
+
+    -k, --key=KEY: AWS account key id.<br>
+    -s, --secret=SECRET: AWS account secret.<br>
+    -m, --mfa=MFA: AWS virtual mfa arn.<br>
+    -r, --no-remote: Do not validate with remote api.
 
 * add-role ROLE:
 
-    Adds a ROLE to the keyring
+    Adds a ROLE to the keyring<br>
+    
+    -a, --arn=ARN: AWS role arn.
+
+* awskeyring console ACCOUNT:
 
-* console ACCOUNT:
+    Open the AWS Console for the ACCOUNT<br>
 
-    Open the AWS Console for the ACCOUNT
+    -p, --path=PATH: The service PATH to open.<br>
+    -b, --browser=BROWSER: Specify an alternative browser.<br>
+    -n, --no-token: Do not use saved token.<br>
+    -o, --no-open: Do not open the url.
 
 * env ACCOUNT:
 
-    Outputs bourne shell environment exports for an ACCOUNT
+    Outputs bourne shell environment exports for an ACCOUNT<br>
+
+    -n, --no-token: Do not use saved token.<br>
+    -u, --unset, --no-unset: Unset environment variables.
 
 * exec ACCOUNT command...:
 
-    Execute a COMMAND with the environment set for an ACCOUNT
+    Execute a COMMAND with the environment set for an ACCOUNT<br>
+
+    -n, --no-token: Do not use saved token.<br>
+    -b, --no-bundle: Unset Bundler environment variables.
 
 * help [COMMAND]:
 
@@ -44,15 +64,21 @@ The commands are as follows:
 
 * import:
 
-    Import an ACCOUNT to the keyring from ~/.aws/credentials
+    Import an ACCOUNT to the keyring from ~/.aws/credentials<br>
+
+    -r, --no-remote: Do not validate with remote api.
 
 * initialise:
 
-    Initialises a new KEYCHAIN
+    Initialises a new KEYCHAIN<br>
+
+    -n, --keychain=KEYCHAIN: Name of KEYCHAIN to initialise.
 
 * json ACCOUNT:
 
-    Outputs AWS CLI compatible JSON for an ACCOUNT
+    Outputs AWS CLI compatible JSON for an ACCOUNT<br>
+
+    -n, --no-token: Do not use saved token.
 
 * list:
 
@@ -60,7 +86,9 @@ The commands are as follows:
 
 * list-role:
 
-    Prints a list of roles in the keyring
+    Prints a list of roles in the keyring<br>
+
+    -d, --detail, --no-detail: Show more detail.
 
 * remove ACCOUNT:
 
@@ -80,11 +108,19 @@ The commands are as follows:
 
 * token ACCOUNT [ROLE] [MFA]:
 
-    Create an STS Token from a ROLE or an MFA code
+    Create an STS Token from a ROLE or an MFA code<br>
+
+    -r, --role=ROLE: The ROLE to assume.<br>
+    -c, --code=CODE: Virtual mfa CODE.<br>
+    -d, --duration=DURATION: Session DURATION in seconds.
 
 * update ACCOUNT:
 
-    Updates an ACCOUNT in the keyring
+    Updates an ACCOUNT in the keyring<br>
+
+    -k, --key=KEY: AWS account key id.<br>
+    -s, --secret=SECRET: AWS account secret.<br>
+    -r, --no-remote: Do not validate with remote api.
 
 ## ENVIRONMENT
 
@@ -132,6 +168,7 @@ Tristan Morgan <tristan.morgan@servian.com> is the maintainer of Awskeyring.
 
 * Tristan [tristanmorgan](https://github.com/tristanmorgan)
 * Adam Sir [AzySir](https://github.com/AzySir)
+* Vito Giarrusso [thtliife](https://github.com/thtliife)
 
 ## LICENSE
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: awskeyring
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.8.1
 platform: ruby
 authors:
 - Tristan Morgan
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-06-19 00:00:00.000000000 Z
+date: 2021-01-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-iam
@@ -80,6 +80,7 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- SECURITY.md
 - awskeyring.gemspec
 - exe/awskeyring
 - i18n/en.yml
@@ -96,9 +97,9 @@ licenses:
 - MIT
 metadata:
   bug_tracker_uri: https://github.com/servian/awskeyring/issues
-  changelog_uri: https://github.com/servian/awskeyring/blob/master/CHANGELOG.md
-  documentation_uri: https://rubydoc.info/gems/awskeyring/1.4.0
-  source_code_uri: https://github.com/servian/awskeyring/tree/v1.4.0
+  changelog_uri: https://github.com/servian/awskeyring/blob/main/CHANGELOG.md
+  documentation_uri: https://rubydoc.info/gems/awskeyring/1.8.1
+  source_code_uri: https://github.com/servian/awskeyring/tree/v1.8.1
   wiki_uri: https://github.com/servian/awskeyring/wiki
 post_install_message: 
 rdoc_options: []
@@ -108,7 +109,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.6.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="