awskeyring 1.5.0 → 1.8.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e56bbd10b469c722c15eaca7729bf39eac3aa3bde760c6faa44fd891200c7e2d
-  data.tar.gz: f1381f0d3e9c9f69c5404cae3a12499d94bfc003999fc96f3eabc2fe98218852
+  metadata.gz: 821682d536efc3d5785f862fb8e1a53fda4107eb18020bc6b3796a1d3654ee7d
+  data.tar.gz: 79bda10be2bfdabb9142e9798cfcdd47a20eba1b1cc4186526ca2f2860253514
 SHA512:
-  metadata.gz: b1fcf72a9fded0b2464f5f12bdcba598928400bb9b7c25bc586deb28f244d8044514433e596d758e1a54121c24c56972e2e137cc6803cca545dfb0486bc45a3e
-  data.tar.gz: 46a6c39a038ca5258a84cda96f12a3e8c6b7cea655f918476aef5b0ecc70c032cf02162eefc47ed4ed498e5234a4eb2637ec958309d8b23461b3306013a8a6b0
+  metadata.gz: a84c3ef0c53bdf13a5740e1231494700bd40b91acda358c27c99de2eb8170c8073d98536c3fdfd6973a8f80cf2c3b362b101de83a5415eebada7b3a7f391053c
+  data.tar.gz: 728d2d23bd55a416d39bb94dbc5f7445941a15a64a18ef6f2a070ac6a21a6c9d4b14f3e0f210e6b85a964c08070c5435fc301665d4d6fd4989fe411dfed29efd

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-2021 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.com/servian/awskeyring.svg?branch=main)](https://travis-ci.com/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/Rakefile

@@ -59,4 +59,5 @@ YARD::Rake::YardocTask.new do |t|
   t.stats_options = ['--list-undoc']
 end
 
+desc 'Run Linting, Tests and Documetation tasks'
 task default: %i[filemode rubocop spec ronn yard]

data/awskeyring.gemspec

@@ -15,14 +15,16 @@ Gem::Specification.new do |spec|
   spec.homepage      = Awskeyring::HOMEPAGE
   spec.licenses      = ['MIT']
 
-  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^spec/|^\..*|^.*\.png}) }
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^spec/|^\..*|C.*\.md|.*\.ronn|.*\.png}) }
   spec.bindir        = 'exe'
   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

@@ -49,6 +49,7 @@ en:
     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.'
@@ -75,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.5.0'
+  VERSION = '1.8.2'
   # The Gem's homepage
   HOMEPAGE = 'https://github.com/servian/awskeyring'
 

data/lib/awskeyring_command.rb

@@ -16,17 +16,17 @@ class AwskeyringCommand < Thor # rubocop:disable Metrics/ClassLength
 
   map %w[--version -v] => :__version
   map %w[--help -h] => :help
-  map ['init'] => :initialise
-  map ['adr'] => :add_role
-  map ['con'] => :console
-  map ['ls'] => :list
-  map ['lsr'] => :list_role
-  map ['rm'] => :remove
-  map ['rmr'] => :remove_role
-  map ['rmt'] => :remove_token
-  map ['rot'] => :rotate
-  map ['tok'] => :token
-  map ['up'] => :update
+  map 'init' => :initialise
+  map 'adr' => :add_role
+  map 'con' => :console
+  map 'ls' => :list
+  map 'lsr' => :list_role
+  map 'rm' => :remove
+  map 'rmr' => :remove_role
+  map 'rmt' => :remove_token
+  map 'rot' => :rotate
+  map 'tok' => :token
+  map 'up' => :update
 
   # default to returning an error on failure.
   def self.exit_on_failure?
@@ -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(
@@ -201,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,
@@ -379,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
@@ -409,14 +418,16 @@ 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
 
   desc 'awskeyring CURR PREV', I18n.t('awskeyring.desc'), hide: true
+  map File.basename($PROGRAM_NAME) => :autocomplete
   # autocomplete
-  def awskeyring(curr, prev)
+  def autocomplete(curr, prev)
     comp_line = ENV['COMP_LINE']
     unless comp_line
       exec_name = File.basename($PROGRAM_NAME)
@@ -452,9 +463,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]
@@ -479,12 +492,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
@@ -492,7 +507,7 @@ class AwskeyringCommand < Thor # rubocop:disable Metrics/ClassLength
   end
 
   def list_commands
-    self.class.all_commands.keys.map { |elem| elem.tr('_', '-') }.reject! { |elem| elem == 'awskeyring' }
+    self.class.all_commands.keys.map { |elem| elem.tr('_', '-') }.reject! { |elem| elem == 'autocomplete' }
   end
 
   def list_arguments(command:)
@@ -539,23 +554,23 @@ 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)..-1] }
+    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_'
+      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)

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" "March 2021" "" ""
 .
 .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"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: awskeyring
 version: !ruby/object:Gem::Version
-  version: 1.5.0
+  version: 1.8.2
 platform: ruby
 authors:
 - Tristan Morgan
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-07-08 00:00:00.000000000 Z
+date: 2021-03-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-iam
@@ -73,9 +73,6 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- CHANGELOG.md
-- CODE_OF_CONDUCT.md
-- CONTRIBUTING.md
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -90,15 +87,14 @@ files:
 - lib/awskeyring/version.rb
 - lib/awskeyring_command.rb
 - man/awskeyring.5
-- man/awskeyring.5.ronn
 homepage: https://github.com/servian/awskeyring
 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.5.0
-  source_code_uri: https://github.com/servian/awskeyring/tree/v1.5.0
+  changelog_uri: https://github.com/servian/awskeyring/blob/main/CHANGELOG.md
+  documentation_uri: https://rubydoc.info/gems/awskeyring/1.8.2
+  source_code_uri: https://github.com/servian/awskeyring/tree/v1.8.2
   wiki_uri: https://github.com/servian/awskeyring/wiki
 post_install_message: 
 rdoc_options: []
@@ -108,7 +104,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:
   - - ">="

data/CHANGELOG.md

@@ -1,121 +0,0 @@
-# Changelog
-
-## [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)
-
-**Implemented enhancements:**
-
-- Import Keys and Tokens from shared credentials files. [\#65](https://github.com/servian/awskeyring/pull/65) ([tristanmorgan](https://github.com/tristanmorgan))
-
-## [v1.3.3](https://github.com/servian/awskeyring/tree/v1.3.3) (2020-06-04)
-
-[Full Changelog](https://github.com/servian/awskeyring/compare/v1.3.2...v1.3.3)
-
-**Implemented enhancements:**
-
-- Change email references from Vibrato to Servian [\#64](https://github.com/servian/awskeyring/pull/64) ([tristanmorgan](https://github.com/tristanmorgan))
-
-## [v1.3.2](https://github.com/servian/awskeyring/tree/v1.3.2) (2020-04-27)
-
-[Full Changelog](https://github.com/servian/awskeyring/compare/v1.3.1...v1.3.2)
-
-**Fixed bugs:**
-
-- Fix I18n message load when used as a library. [\#63](https://github.com/servian/awskeyring/pull/63) ([tristanmorgan](https://github.com/tristanmorgan))
-
-## [v1.3.1](https://github.com/servian/awskeyring/tree/v1.3.1) (2020-03-19)
-
-[Full Changelog](https://github.com/servian/awskeyring/compare/v1.3.0...v1.3.1)
-
-**Implemented enhancements:**
-
-- Markdown linting changes and removed Rubocop-MD. [\#61](https://github.com/servian/awskeyring/pull/61) ([tristanmorgan](https://github.com/tristanmorgan))
-- Removed some redundant code. [\#60](https://github.com/servian/awskeyring/pull/60) ([tristanmorgan](https://github.com/tristanmorgan))
-
-**Merged pull requests:**
-
-- Update Ronn code and PR template. [\#59](https://github.com/servian/awskeyring/pull/59) ([tristanmorgan](https://github.com/tristanmorgan))
-
-## [v1.3.0](https://github.com/servian/awskeyring/tree/v1.3.0) (2020-02-19)
-
-[Full Changelog](https://github.com/servian/awskeyring/compare/v1.2.0...v1.3.0)
-
-**Implemented enhancements:**
-
-- Add a man-page and tweak README. [\#58](https://github.com/servian/awskeyring/pull/58) ([tristanmorgan](https://github.com/tristanmorgan))
-- Enhanced version [\#57](https://github.com/servian/awskeyring/pull/57) ([AzySir](https://github.com/AzySir))
-
-## [v1.2.0](https://github.com/servian/awskeyring/tree/v1.2.0) (2020-01-20)
-
-[Full Changelog](https://github.com/servian/awskeyring/compare/v1.1.2...v1.2.0)
-
-**Implemented enhancements:**
-
-- Check for existing account keys and role arns [\#56](https://github.com/servian/awskeyring/pull/56) ([tristanmorgan](https://github.com/tristanmorgan))
-
-## [v1.1.2](https://github.com/servian/awskeyring/tree/v1.1.2) (2020-01-06)
-
-[Full Changelog](https://github.com/servian/awskeyring/compare/v1.1.1...v1.1.2)
-
-**Fixed bugs:**
-
-- Deprecation warning for exit\_on\_failure [\#55](https://github.com/servian/awskeyring/pull/55) ([tristanmorgan](https://github.com/tristanmorgan))
-
-## [v1.1.1](https://github.com/servian/awskeyring/tree/v1.1.1) (2019-11-27)
-
-[Full Changelog](https://github.com/servian/awskeyring/compare/v1.1.0...v1.1.1)
-
-**Implemented enhancements:**
-
-- Add --detail flag for roles. [\#54](https://github.com/servian/awskeyring/pull/54) ([tristanmorgan](https://github.com/tristanmorgan))
-
-## [v1.1.0](https://github.com/servian/awskeyring/tree/v1.1.0) (2019-11-06)
-
-[Full Changelog](https://github.com/servian/awskeyring/compare/v1.0.2...v1.1.0)
-
-**Implemented enhancements:**
-
-- Add completion to input prompts [\#53](https://github.com/servian/awskeyring/pull/53) ([tristanmorgan](https://github.com/tristanmorgan))
-- Check for existing \(or not\) role names [\#52](https://github.com/servian/awskeyring/pull/52) ([tristanmorgan](https://github.com/tristanmorgan))
-
-## [v1.0.2](https://github.com/servian/awskeyring/tree/v1.0.2) (2019-10-18)
-
-[Full Changelog](https://github.com/servian/awskeyring/compare/v1.0.1...v1.0.2)
-
-**Implemented enhancements:**
-
-- Move to a new home, Servian. [\#51](https://github.com/servian/awskeyring/pull/51) ([tristanmorgan](https://github.com/tristanmorgan))
-- Use RuboCop-RSpec too and expect\(\) more. [\#48](https://github.com/servian/awskeyring/pull/48) ([tristanmorgan](https://github.com/tristanmorgan))
-
-## [v1.0.1](https://github.com/servian/awskeyring/tree/v1.0.1) (2019-05-23)
-
-[Full Changelog](https://github.com/servian/awskeyring/compare/v1.0.0...v1.0.1)
-
-**Implemented enhancements:**
-
-- auto-complete the --version [\#47](https://github.com/servian/awskeyring/pull/47) ([tristanmorgan](https://github.com/tristanmorgan))
-
-**Fixed bugs:**
-
-- Unfreeze secret strings. [\#46](https://github.com/servian/awskeyring/pull/46) ([tristanmorgan](https://github.com/tristanmorgan))
-
-## [v1.0.0](https://github.com/servian/awskeyring/tree/v1.0.0) (2019-05-19)
-
-[Full Changelog](https://github.com/servian/awskeyring/compare/v0.10.0...v1.0.0)
-
-**Implemented enhancements:**
-
-- More RuboCop changes and tweaked version string. [\#45](https://github.com/servian/awskeyring/pull/45) ([tristanmorgan](https://github.com/tristanmorgan))
-
-
-
-\* *This Changelog was automatically generated by [github_changelog_generator](https://github.com/github-changelog-generator/github-changelog-generator)*

data/CODE_OF_CONDUCT.md

@@ -1,73 +0,0 @@
-# Contributor Covenant Code of Conduct
-
-## Our Pledge
-
-In the interest of fostering an open and welcoming environment, we as
-contributors and maintainers pledge to making participation in our project and
-our community a harassment-free experience for everyone, regardless of age, body
-size, disability, ethnicity, gender identity and expression, level of experience,
-education, socio-economic status, nationality, personal appearance, race,
-religion, or sexual identity and orientation.
-
-## Our Standards
-
-Examples of behavior that contributes to creating a positive environment
-include:
-
-* Using welcoming and inclusive language
-* Being respectful of differing viewpoints and experiences
-* Gracefully accepting constructive criticism
-* Focusing on what is best for the community
-* Showing empathy towards other community members
-
-Examples of unacceptable behavior by participants include:
-
-* The use of sexualized language or imagery and unwelcome sexual attention or
-  advances
-* Trolling, insulting/derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or electronic
-  address, without explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
-  professional setting
-
-## Our Responsibilities
-
-Project maintainers are responsible for clarifying the standards of acceptable
-behavior and are expected to take appropriate and fair corrective action in
-response to any instances of unacceptable behavior.
-
-Project maintainers have the right and responsibility to remove, edit, or
-reject comments, commits, code, wiki edits, issues, and other contributions
-that are not aligned to this Code of Conduct, or to ban temporarily or
-permanently any contributor for other behaviors that they deem inappropriate,
-threatening, offensive, or harmful.
-
-## Scope
-
-This Code of Conduct applies both within project spaces and in public spaces
-when an individual is representing the project or its community. Examples of
-representing a project or community include using an official project e-mail
-address, posting via an official social media account, or acting as an appointed
-representative at an online or offline event. Representation of a project may be
-further defined and clarified by project maintainers.
-
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by contacting the project team at [tristan.morgan@servian.com](mailto:tristan.morgan@servian.com). All
-complaints will be reviewed and investigated and will result in a response that
-is deemed necessary and appropriate to the circumstances. The project team is
-obligated to maintain confidentiality with regard to the reporter of an incident.
-Further details of specific enforcement policies may be posted separately.
-
-Project maintainers who do not follow or enforce the Code of Conduct in good
-faith may face temporary or permanent repercussions as determined by other
-members of the project's leadership.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
-available [here](https://www.contributor-covenant.org/version/1/4/code-of-conduct.html)
-
-[homepage]: https://www.contributor-covenant.org

data/CONTRIBUTING.md

@@ -1,48 +0,0 @@
-# How to contribute
-
-Bug reports and pull requests from users are what keep this project working.
-
-## Basics
-
-1. Create an issue and describe your idea
-2. [Fork it](https://github.com/servian/awskeyring/fork)
-3. Create your feature branch (`git checkout -b my-new-feature`)
-4. Commit your changes (`git commit -am 'Add some feature'`)
-5. Publish the branch (`git push origin my-new-feature`)
-6. Create a new Pull Request
-
-## Checking your work
-
-You can run the test suite.
-
-You can run [RuboCop] to check code style.
-
-You can run [RSpec] to see if anything broke.
-
-You can run [YARD] to see of your code is documented.
-
-The default Rake task, runnable using `rake`.
-
-## Write documentation
-
-This project has documentation in a few places:
-
-### Introduction and usage
-
-A friendly `README.md` written for many audiences.
-
-### Examples and advanced usage
-
-The [wiki].
-
-### API documentation
-
-API documentation is written as [YARD] docblocks in the Ruby code.
-
-This is rendered as Web pages on [Rubydoc.info][awskeyring on Rubydoc.info].
-
-[wiki]: https://github.com/servian/awskeyring/wiki
-[YARD]: https://yardoc.org/
-[awskeyring on Rubydoc.info]: https://www.rubydoc.info/gems/awskeyring
-[RuboCop]: https://rubocop.readthedocs.io/en/latest/
-[Rspec]: https://rspec.info

data/man/awskeyring.5.ronn

@@ -1,138 +0,0 @@
-# Awskeyring -- is a small tool to manage AWS account keys in the macOS Keychain
-
-## SYNOPSIS
-
-awskeyring COMMAND [ACCOUNT|ROLE] [OPTIONS]
-
-awskeyring help COMMAND
-
-## DESCRIPTION
-
-The Awskeyring utility stores and manages AWS access keys and provides the facility to generate access tokens with
-combinations of assumed roles and multi-factor-authentication codes. It includes autocompletion features and multiple
-validation checks for input parsing. It also includes the ability for the AWS CLI to call it directly to provide authentication.
-
-The commands are as follows:
-
-* --version, -v:
-
-    Prints the version
-
-* add ACCOUNT:
-
-    Adds an ACCOUNT to the keyring
-
-* add-role ROLE:
-
-    Adds a ROLE to the keyring
-
-* console ACCOUNT:
-
-    Open the AWS Console for the ACCOUNT
-
-* env ACCOUNT:
-
-    Outputs bourne shell environment exports for an ACCOUNT
-
-* exec ACCOUNT command...:
-
-    Execute a COMMAND with the environment set for an ACCOUNT
-
-* help [COMMAND]:
-
-    Describe available commands or one specific command
-
-* import:
-
-    Import an ACCOUNT to the keyring from ~/.aws/credentials
-
-* initialise:
-
-    Initialises a new KEYCHAIN
-
-* json ACCOUNT:
-
-    Outputs AWS CLI compatible JSON for an ACCOUNT
-
-* list:
-
-    Prints a list of accounts in the keyring
-
-* list-role:
-
-    Prints a list of roles in the keyring
-
-* remove ACCOUNT:
-
-    Removes an ACCOUNT from the keyring
-
-* remove-role ROLE:
-
-    Removes a ROLE from the keyring
-
-* remove-token ACCOUNT:
-
-    Removes a token for ACCOUNT from the keyring
-
-* rotate ACCOUNT:
-
-    Rotate access keys for an ACCOUNT
-
-* token ACCOUNT [ROLE] [MFA]:
-
-    Create an STS Token from a ROLE or an MFA code
-
-* update ACCOUNT:
-
-    Updates an ACCOUNT in the keyring
-
-## 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.
-
-## EXIT STATUS
-
-The Awskeyring utility exits 0 on success, and >0 if an error occurs.
-
-## EXAMPLES
-
-First you need to initialise your keychain to hold your AWS credentials.
-
-    awskeyring initialise
-
-Then add your keys to it.
-
-    awskeyring add personal-aws
-
-Now your keys are stored safely in the macOS keychain. To print environment variables run...
-
-    awskeyring env personal-aws
-
-## HISTORY
-
-The motivation of this application is to provide a local secure store of AWS
-credentials using specifically in the macOS Keychain, to have them easily accessed
-from the Terminal, and to provide useful functions like assuming roles and opening
-the AWS Console from the cli.
-For Enterprise environments there are better suited tools to use
-like [HashiCorp Vault](https://vaultproject.io/).
-
-## SECURITY
-
-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). Awskeyring is a Ruby script and as such Ruby is whitelisted to
-access your "awskeyring" keychain. Use a strong password and keep the unlock time short.
-
-## AUTHOR
-
-Tristan Morgan <tristan.morgan@servian.com> is the maintainer of Awskeyring.
-
-## CONTRIBUTORS
-
-* Tristan [tristanmorgan](https://github.com/tristanmorgan)
-* Adam Sir [AzySir](https://github.com/AzySir)
-
-## LICENSE
-
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).