sym 2.0.3 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9d1c0e747eef0d680cc7a8f69f01173744c4e29d
-  data.tar.gz: 194dc2f5f74011848f9673bf2d4e5b018baa166f
+  metadata.gz: 36befc7ec0737c70c0744632ffd3d161797bf169
+  data.tar.gz: 060b3db5e9073057911ada5f5dedcc81ab40cab5
 SHA512:
-  metadata.gz: b7bb4fed47d8a416622963d25209033dcf444f505db8c16edd08be6ef8a16beee92762e678cfb6f75f0588c92c2b0ebdb1058e5dd9c96e4382c598cac6a28550
-  data.tar.gz: 3df569a2f8ea1995401c0e916dbfd34bcf8bcb41ca6747fe51918fbe7dc89e3025f8aa4c90dc05997676d5507ea4bba126c5c7e60ea870597d4a0fdd2819daa1
+  metadata.gz: 6b511d18b5cb0d30e57ee5636ba140910831dbe8d21bed29277d314c9d18807505140e7e298ef1da4fb03d0c5a7f9740dfacaab0e18404f05e510c5aafa1e8a8
+  data.tar.gz: f66653d1548d9e4daa92e8edd9f1efa081f840fb1b6fc6e51b7e93c4577d16ac5f3712b7773faeef232c1583f875b8d6aab266b22d4ba90227c10423ebc84e1c

data/.rspec

@@ -1,2 +1,3 @@
 --format progress
 --color
+--order rand

data/CHANGELOG.md

@@ -1,3 +1,17 @@
+**2.1.0** (January 22, 2017)
+
+* Added two sub-commands to handle updating and moving existing keys:
+  - adding a password to an existing key
+  - adding an existing key to the keychain.
+  
+To add a password to an existing key: 
+
+> `sym [ -k key | -K keyfile | -i | -x <name> ] -p `
+
+To add existing key to a keychain:  
+ 
+> `sym [ -k key | -K keyfile | -i ] -x <name> `
+
 **2.0.3** (January 22, 2017)
 
 * Removed clipboard copy functionality, as it's easy to achieve with `pbcopy`.

data/README.md

@@ -73,9 +73,7 @@ Or install it into the global namespace with `gem install` command:
 
 After gem installation, an message will tell you to install bash completion into to your `~/.bashrc` or equivalent:
 
-```bash
-sym --bash-completion ~/.bashrc
-```
+    sym --bash-completion ~/.bashrc
 
 Should you choose to install it (this part is optional), you will be able to use "tab-tab" after typing `sym` and you'll be able to choose from all supported flags.
 
@@ -119,7 +117,7 @@ Or save it to a file:
 
 Or create a password-protected key, and save it to a file:
 
-    sym -gcp -o ~/.secret
+    sym -gp -o ~/.secret
     # New Password:     ••••••••••
     # Confirm Password: ••••••••••
 
@@ -147,30 +145,43 @@ Now, whenever you need to encrypt something, in addition to the `-k` and `-K` yo
 
 Finally, you can delete a key from KeyChain access by running:
 
-    sym --keychain-del staging
+    keychain <name> delete
 
 #### KeyChain Key Management
 
-Another tiny executable supplied with this library is called `keychain`
+`keychain` is an additional script installed with the gem, that can be used to read (find), update (add), and delete keychain entries used by `sym`. 
 
-```bash
-Usage: keychain item [ add <contents> | find | delete ]
-```
-You can use this to add an existing key that can be used with the `sym` later. Of course you can also use the tool to find or delete it.
+It's help message is self-explanatory:
+
+    Usage: keychain <name> [ add <contents> | find | delete ]
+
+#### Moving a Key to Keychain
+
+You can easily move a key to a keychain by combinding -k or -K to read the key, and -x to write it.
+
+    sym -k $mykey -x mykey
+
+#### Adding Password to Existing Key
+
+You can add a password to a key by combining one of the key description flags (-k, -K, -i) and then also -p. 
+
+    sym -k $mykey -p -x moo
+    
+The above example will take an unencrypted key passed in $k, ask for a password and save password protected key into the keychain with name "moo".
 
 ####  Encryption and Decryption
 
 This may be a good time to take a look at the full help message for the `sym` tool, shown naturally with a `-h` or `--help` option.
 
 ```
-Sym (2.0.2) – encrypt/decrypt data with a private key
+Sym (2.0.0) – encrypt/decrypt data with a private key
 
 Usage:
    # Generate a new key:
    sym -g [ -c ] [ -p ] [ -x keychain ] [ -o keyfile | -q | ]  
 
    # Encrypt/Decrypt 
-   sym [ -d | -e ] [ -f <file> | -s <string> ] 
+   sym  [ -d | -e ] [ -f <file> | -s <string> ] 
         [ -k key | -K keyfile | -x keychain | -i ] 
         [ -o <output file> ] 
  
@@ -182,24 +193,28 @@ Modes:
   -d, --decrypt                       decrypt mode
   -t, --edit                          decrypt, open an encr. file in an $EDITOR
  
-Create a new private key:
+Create a private key:
   -g, --generate                      generate a new private key
   -p, --password                      encrypt the key with a password
+  -c, --copy                          copy the new key to the clipboard
   -x, --keychain           [key-name] add to (or read from) the OS-X Keychain
+ 
+Password Caching:
   -M, --password-timeout   [timeout]  when passwords expire (in seconds)
-  -P, --no-password-cache             disables caching of key passwords
+  -P, --no-password-cache             disables key password caching
  
-Read existing private key from:
+Provide a private key:
   -i, --interactive                   Paste or type the key interactively
   -k, --private-key        [key]      private key as a string
   -K, --keyfile            [key-file] private key from a file
  
-Data to Encrypt/Decrypt:
+Data:
   -s, --string             [string]   specify a string to encrypt/decrypt
   -f, --file               [file]     filename to read from
   -o, --output             [file]     filename to write to
  
 Flags:
+  --keychain-del           [key-name] delete keychain entry with that name
   -b, --backup                        create a backup file in the edit mode
   -v, --verbose                       show additional information
   -T, --trace                         print a backtrace of any errors
@@ -207,9 +222,6 @@ Flags:
   -V, --version                       print library version
   -N, --no-color                      disable color output
  
-Utility:
-  -a, --bash-completion    [file]     append shell completion to a file
- 
 Help & Examples:
   -E, --examples                      show several examples
   -L, --language                      natural language examples

data/lib/sym/app.rb

@@ -51,6 +51,11 @@ module Sym
   end
 end
 
-require 'sym/app/short_name'
 require 'sym/version'
-require_dir 'sym/app'
+require 'sym/app/short_name'
+
+require 'sym/app/args'
+require 'sym/app/cli'
+require 'sym/app/commands'
+require 'sym/app/keychain'
+require 'sym/app/output'

data/lib/sym/app/cli.rb

@@ -40,7 +40,7 @@ module Sym
     # instance. See there for more details.
     #
     # Subsequently, +#run+ method handles the finding of the appropriate
-    # {Sym::App::Commands::Command} subclass to respond to user's request.
+    # {Sym::App::Commands::BaseCommand} subclass to respond to user's request.
     # Command registry, sorting, command dependencies, and finding them is
     # done by the {Sym::App::Coommands} module.
     #
@@ -143,41 +143,42 @@ module Sym
           o.separator ' '
           o.separator 'Create a new private key:'.yellow
 
-          o.bool '-g', '--generate', '           generate a new private key'
-          o.bool '-p', '--password', '           encrypt the key with a password'
+          o.bool '-g', '--generate',              '           generate a new private key'
+          o.bool '-p', '--password',              '           encrypt the key with a password'
 
           if Sym::App.is_osx?
             o.string '-x', '--keychain', '[key-name] '.blue + 'add to (or read from) the OS-X Keychain'
           end
 
-          o.integer '-M', '--password-timeout', '[timeout]'.blue + '  when passwords expire (in seconds)'
-          o.bool    '-P', '--no-password-cache', '           disables caching of key passwords'
+          o.integer '-M', '--password-timeout',   '[timeout]'.blue + '  when passwords expire (in seconds)'
+          o.bool    '-P', '--no-password-cache',  '           disables caching of key passwords'
 
           o.separator ' '
           o.separator 'Read existing private key from:'.yellow
-          o.bool      '-i', '--interactive', '           Paste or type the key interactively'
-          o.string    '-k', '--private-key', '[key]   '.blue + '   private key as a string'
-          o.string    '-K', '--keyfile', '[key-file]'.blue + ' private key from a file'
+          o.bool      '-i', '--interactive',      '           Paste or type the key interactively'
+          o.string    '-k', '--private-key',      '[key]   '.blue + '   private key as a string'
+          o.string    '-K', '--keyfile',          '[key-file]'.blue + ' private key from a file'
           o.separator ' '
           o.separator 'Data to Encrypt/Decrypt:'.yellow
-          o.string '-s', '--string', '[string]'.blue + '   specify a string to encrypt/decrypt'
-          o.string '-f', '--file', '[file]  '.blue + '   filename to read from'
-          o.string '-o', '--output', '[file]  '.blue + '   filename to write to'
+          o.string    '-s', '--string',           '[string]'.blue + '   specify a string to encrypt/decrypt'
+          o.string    '-f', '--file',             '[file]  '.blue + '   filename to read from'
+          o.string    '-o', '--output',           '[file]  '.blue + '   filename to write to'
           o.separator ' '
           o.separator 'Flags:'.yellow
-          o.bool '-b', '--backup', '           create a backup file in the edit mode'
-          o.bool '-v', '--verbose', '           show additional information'
-          o.bool '-T', '--trace', '           print a backtrace of any errors'
-          o.bool '-q', '--quiet', '           silence all output'
-          o.bool '-V', '--version', '           print library version'
-          o.bool '-N', '--no-color', '           disable color output'
+          o.bool      '-b', '--backup',           '           create a backup file in the edit mode'
+          o.bool      '-v', '--verbose',          '           show additional information'
+          o.bool      '-T', '--trace',            '           print a backtrace of any errors'
+          o.bool      '-D', '--debug',            '           print debugging information'
+          o.bool      '-q', '--quiet',            '           silence all output'
+          o.bool      '-V', '--version',          '           print library version'
+          o.bool      '-N', '--no-color',         '           disable color output'
           o.separator ' '
           o.separator 'Utility:'.yellow
-          o.string '-a', '--bash-completion',    '[file]'.blue + '     append shell completion to a file'
+          o.string    '-a', '--bash-completion',  '[file]'.blue + '     append shell completion to a file'
           o.separator ' '
           o.separator 'Help & Examples:'.yellow
-          o.bool '-E', '--examples', '           show several examples'
-          o.bool '-h', '--help', '           show help'
+          o.bool      '-E', '--examples',         '           show several examples'
+          o.bool      '-h', '--help',             '           show help'
 
         end
       end

data/lib/sym/app/commands.rb

@@ -4,7 +4,6 @@ require 'pp'
 module Sym
   module App
     module Commands
-
       class DependencyResolver < Hash
         include TSort
         alias tsort_each_node each_key
@@ -53,4 +52,14 @@ module Sym
   end
 end
 
-require_dir 'sym/app/commands'
+require 'sym/app/commands/base_command'
+require 'sym/app/commands/bash_completion'
+require 'sym/app/commands/encrypt_decrypt'
+require 'sym/app/commands/generate_key'
+require 'sym/app/commands/keychain_add_key'
+require 'sym/app/commands/open_editor'
+require 'sym/app/commands/password_protect_key'
+require 'sym/app/commands/print_key'
+require 'sym/app/commands/show_examples'
+require 'sym/app/commands/show_help'
+require 'sym/app/commands/show_version'

data/lib/sym/app/commands/{command.rb → base_command.rb}

@@ -6,7 +6,7 @@ require 'active_support/inflector'
 module Sym
   module App
     module Commands
-      class Command
+      class BaseCommand
 
         def self.inherited(klass)
           klass.instance_eval do
@@ -46,6 +46,8 @@ module Sym
           end
         end
 
+        include Sym
+
         attr_accessor :application
 
         def initialize(application)
@@ -71,6 +73,25 @@ module Sym
           "#{self.class.short_name.to_s.bold.yellow}, with options: #{application.args.argv.join(' ').gsub(/--/, '').bold.green}"
         end
 
+        def create_key
+          self.class.create_private_key
+        end
+
+        def add_to_keychain_if_needed(key)
+          if opts[:keychain] && Sym::App.is_osx?
+            Sym::App::KeyChain.new(opts[:keychain], opts).add(key)
+          else
+            key
+          end
+        end
+
+        def encrypt_password_if_needed(key)
+          if opts[:password]
+            encr_password(key, application.input_handler.new_password)
+          else
+            key
+          end
+        end
       end
     end
   end

data/lib/sym/app/commands/bash_completion.rb

@@ -1,8 +1,8 @@
-require_relative 'command'
+require 'sym/app/commands/base_command'
 module Sym
   module App
     module Commands
-      class BashCompletion < Command
+      class BashCompletion < BaseCommand
 
         required_options [:bash_completion]
         try_after :generate_key, :open_editor, :encrypt_decrypt

data/lib/sym/app/commands/encrypt_decrypt.rb

@@ -1,8 +1,8 @@
-require_relative 'command'
+require 'sym/app/commands/base_command'
 module Sym
   module App
     module Commands
-      class EncryptDecrypt < Command
+      class EncryptDecrypt < BaseCommand
         include Sym
 
         required_options [ :private_key, :keyfile, :keychain, :interactive ],

data/lib/sym/app/commands/generate_key.rb

@@ -1,23 +1,20 @@
-require_relative 'command'
+require 'sym/app/commands/base_command'
 require 'sym/app/keychain'
 module Sym
   module App
     module Commands
-      class GenerateKey < Command
-        include Sym
+      class GenerateKey < BaseCommand
 
         required_options :generate
 
         def execute
-          retries         ||= 0
-          new_private_key = self.class.create_private_key
-          new_private_key = encr_password(new_private_key,
-                                          application.input_handler.new_password) if opts[:password]
+          retries ||= 0
 
-          Sym::App::KeyChain.new(opts[:keychain], opts).
-            add(new_private_key) if opts[:keychain] && Sym::App.is_osx?
+          the_key = create_key
+          the_key = encrypt_password_if_needed(the_key)
+          add_to_keychain_if_needed(the_key)
 
-          new_private_key
+          the_key
         rescue Sym::Errors::PasswordsDontMatch, Sym::Errors::PasswordTooShort => e
           STDERR.puts e.message.bold
           retry if (retries += 1) < 3

data/lib/sym/app/commands/keychain_add_key.rb

@@ -0,0 +1,19 @@
+require 'sym/app/commands/base_command'
+require 'sym/app/keychain'
+module Sym
+  module App
+    module Commands
+      class KeychainAddKey < BaseCommand
+
+        required_options [:private_key, :keyfile, :interactive],
+                         :keychain
+
+        try_after :generate_key, :encrypt_decrypt, :password_protect_key
+
+        def execute
+          add_to_keychain_if_needed(self.key)
+        end
+      end
+    end
+  end
+end

data/lib/sym/app/commands/open_editor.rb

@@ -3,11 +3,11 @@ require 'fileutils'
 require 'tempfile'
 require 'sym'
 require 'sym/errors'
-require_relative 'command'
+require 'sym/app/commands/base_command'
 module Sym
   module App
     module Commands
-      class OpenEditor < Command
+      class OpenEditor < BaseCommand
         include Sym
 
         required_options [ :private_key, :keyfile, :keychain, :interactive ],

data/lib/sym/app/commands/password_protect_key.rb

@@ -0,0 +1,29 @@
+require 'sym/app/commands/base_command'
+
+module Sym
+  module App
+    module Commands
+      class PasswordProtectKey < BaseCommand
+
+        required_options [:private_key, :keyfile, :keychain, :interactive],
+                         :password
+
+        try_after :generate_key, :encrypt_decrypt
+
+        def execute
+          retries ||= 0
+
+          the_key = self.key
+          the_key = encrypt_password_if_needed(the_key)
+          add_to_keychain_if_needed(the_key)
+
+          the_key
+        rescue Sym::Errors::PasswordsDontMatch, Sym::Errors::PasswordTooShort => e
+          STDERR.puts e.message.bold
+          retry if (retries += 1) < 3
+        end
+
+      end
+    end
+  end
+end

data/lib/sym/app/commands/print_key.rb

@@ -1,11 +1,13 @@
-require_relative 'command'
+require 'sym/app/commands/base_command'
 require 'sym/app/keychain'
 module Sym
   module App
     module Commands
-      class PrintKey < Command
+      class PrintKey < BaseCommand
         required_options [ :keychain, :keyfile ]
 
+        try_after :generate_key, :encrypt_decrypt, :password_protect_key, :keychain_add_key
+
         def execute
           self.key
         end

data/lib/sym/app/commands/show_examples.rb

@@ -1,9 +1,9 @@
 require 'colored2'
-require_relative 'command'
+require 'sym/app/commands/base_command'
 module Sym
   module App
     module Commands
-      class ShowExamples < Command
+      class ShowExamples < BaseCommand
         required_options :examples
         try_after :show_help
 
@@ -11,8 +11,8 @@ module Sym
           output = []
 
           output << example(comment: 'generate a new private key into an environment variable:',
-                            command: 'export KEY=$(sym -g)',
-                            echo:    'echo $KEY',
+                            command: 'export mykey=$(sym -g)',
+                            echo:    'echo $mykey',
                             result:  '75ngenJpB6zL47/8Wo7Ne6JN1pnOsqNEcIqblItpfg4='.green)
 
           output << example(comment: 'generate a new password-protected key & save to a file',
@@ -21,19 +21,19 @@ module Sym
                             result:  'Confirm Password : ' + '••••••••••'.green)
 
           output << example(comment: 'encrypt a plain text string with a key, and save the output to a file',
-                            command: 'sym -e -s ' + '"secret string"'.bold.yellow + ' -k $KEY -o file.enc',
+                            command: 'sym -e -s ' + '"secret string"'.bold.yellow + ' -k $mykey -o file.enc',
                             echo:    'cat file.enc',
                             result:  'Y09MNDUyczU1S0UvelgrLzV0RTYxZz09CkBDMEw4Q0R0TmpnTm9md1QwNUNy%T013PT0K'.green)
 
           output << example(comment: 'decrypt a previously encrypted string:',
-                            command: 'sym -d -s $(cat file.enc) -k $KEY',
+                            command: 'sym -d -s $(cat file.enc) -k $mykey',
                             result:  'secret string'.green)
 
           output << example(comment: 'encrypt sym.yml and save it to sym.enc:',
-                            command: 'sym -e -f sym.yml -o sym.enc -k $KEY')
+                            command: 'sym -e -f sym.yml -o sym.enc -k $mykey')
 
           output << example(comment: 'decrypt an encrypted file and print it to STDOUT:',
-                            command: 'sym -df sym.enc -k $KEY')
+                            command: 'sym -df sym.enc -k $mykey')
 
           output << example(comment: 'edit an encrypted file in $EDITOR, ask for key, create file backup',
                             command: 'sym -tibf ecrets.enc',

data/lib/sym/app/commands/show_help.rb

@@ -1,8 +1,8 @@
-require_relative 'command'
+require 'sym/app/commands/base_command'
 module Sym
   module App
     module Commands
-      class ShowHelp < Command
+      class ShowHelp < BaseCommand
 
         required_options :help, ->(opts) { opts.to_hash.keys.all? { |k| !opts[k] } }
         try_after :generate_key, :open_editor, :encrypt_decrypt

data/lib/sym/app/commands/show_version.rb

@@ -1,8 +1,8 @@
-require_relative 'command'
+require 'sym/app/commands/base_command'
 module Sym
   module App
     module Commands
-      class ShowVersion < Command
+      class ShowVersion < BaseCommand
         required_options :version
         try_after :show_help
         def execute

data/lib/sym/application.rb

@@ -1,6 +1,6 @@
 require 'colored2'
 require 'sym'
-require_dir 'sym/app'
+require 'sym/app'
 
 module Sym
   class Application
@@ -40,7 +40,6 @@ module Sym
         self.key = Sym::App::PrivateKey::Handler.new(opts, input_handler, password_cache).key
         raise Sym::Errors::NoPrivateKeyFound.new('Private key is required') unless self.key
       end
-
       unless command
         raise Sym::Errors::InsufficientOptionsError.new(
           'Can not determine what to do from the options ' + opts_hash.keys.reject { |k| !opts[k] }.to_s)

data/lib/sym/cipher_handler.rb

@@ -1,5 +1,5 @@
 require 'base64'
-require_relative 'configuration'
+require 'sym/configuration'
 
 module Sym
 

data/lib/sym/data.rb

@@ -1,10 +1,10 @@
-require_relative 'errors'
+require 'sym/errors'
 require 'base64'
 require 'zlib'
 
-require_relative 'data/wrapper_struct'
-require_relative 'data/encoder'
-require_relative 'data/decoder'
+require 'sym/data/wrapper_struct'
+require 'sym/data/encoder'
+require 'sym/data/decoder'
 
 module Sym
   # This module is responsible for taking arbitrary data of any format, and safely compressing

data/lib/sym/version.rb

@@ -1,3 +1,3 @@
 module Sym
-  VERSION = '2.0.3'
+  VERSION = '2.1.0'
 end

data/sym-3.0-cli.md

@@ -0,0 +1,113 @@
+## Sym 
+
+> Sym is a versatile encryption gem, based on the symmetric encryption cipher provided by the OpenSSL. It provides easy to remember commands to manage encryption key: you can generate a key, import an existing key, password protect an open key, store the key in OS-X KeyChain, and use it for encryption/decryption later. The key is used to encrypt, decrypt and edit any sensitive information, such application secrets.
+
+### Complete Usage
+
+    sym [ global options ] [ sub command ] [ command options ] 
+    
+##### Global Options
+    
+```bash
+-M, ——password-timeout   [timeout]  when passwords expire (in seconds)
+-P, ——no-password-cache             disables caching of key passwords   
+-v, ——verbose                       show additional information
+-T, ——trace                         print a backtrace of any errors
+-q, ——quiet                         silence all output
+-V, ——version                       print library version
+-N, ——no-color                      disable color output
+```
+
+##### Help & Examples:
+
+```bash
+-h, ——help                          show help
+-l, ——long                          show help and detailed examples
+```
+
+##### Commands
+
+    # Genereate new key
+    sym key ——save [ key-source ]
+   
+    # Copy existing key, optionally password-protected:
+    sym key ——save [ key-source ] ——key [ key-source ] [ -p ] 
+   
+    # Delete existing key:
+    sym key ——rm [ key-source ]
+
+    sym decrypt ——key  | -k   key-source 
+                ——data | -d   data-source
+                ——to   | -t   data-source | ——in-place
+ 
+    sym encrypt ——key  | -k   key-source 
+                ——data | -d   data-source
+                ——to   | -t   data-source | ——in-place
+   
+    sym edit    ——data | -d   data-source
+                ——key  | -k   key-source
+                ——bak  | -b   data-backup-source
+                
+    sym recrypt ——data | -d   data-source
+                ——key  | -k   key-source 
+                ——save | -s   key-source
+                 
+    sym install bash-completion
+
+    sym --help | -h
+    
+    sym command --help | -h
+    
+    sym examples
+
+
+##### Arguments via Environment
+
+    export SYM_ARGS_KEY='@file "~/.sym.key"'
+    export SYM_ARGS_DATA='@file "~/.sym.key"'
+
+##### Subcommands
+
+When loading the commands, we use the hierarchical loading:
+
+    require 'sym/app/cmd'
+    require 'sym/app/cmd/bash'
+    require 'sym/app/cmd/bash/completion'
+
+
+### Reading and Writing Data and Keys
+
+The new CLI for Sym uses a consistent naming for reading in the data and the key, and for writing out the key and/or data. The scheme is based on URI.
+
+Each URI type is supported by a corresponding plugin, and new ones can be easily defined.  
+
+Some examples:
+   
+```bash   
+   ——key-in string://234234234           # read from the literal data
+   ——key-out file://home/kig/.mykey      # read/write from/to file
+   ——key-in env://MY_VARIABLE            # read from environment variable
+   ——key-out stdio://                    # read/write using stdin/out
+   
+   --data-in  https://mysite.com/remote/secrets.json.enc
+   --data-out file:///usr/local/etc/secrets.json
+```
+
+Below is the list of supported types planned for 3.0:
+
+#### Supported Types
+
+```bash
+ URI:                                   Read? Write? Delete?
+ 
+ string://value                          yes      
+ env://variable                          yes    
+ stdio://                                yes
+ shell://command                         yes   yes   yes
+ file://filename                         yes   yes   yes
+ keychain://name                         yes   yes   yes
+ redis://127.0.0.1:6397/1/mykey          yes   yes   yes
+ memcached://127.0.0.1:11211/mykey       yes   yes   yes
+ scp://user@host/path/file               yes   yes   yes
+ http[s]://user@host/path/file           yes   yes   yes
+```

data/sym.gemspec

@@ -29,6 +29,7 @@ Gem::Specification.new do |spec|
   spec.required_ruby_version = '>= 2.2'
   spec.post_install_message = <<-EOF
 Thank you for installing this gem! 
+
 To enable bash command line completion, please run the following 
 command, which appends sym's shell completion to the specified file:
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sym
 version: !ruby/object:Gem::Version
-  version: 2.0.3
+  version: 2.1.0
 platform: ruby
 authors:
 - Konstantin Gredeskoul
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-01-22 00:00:00.000000000 Z
+date: 2017-01-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: colored2
@@ -216,11 +216,13 @@ files:
 - lib/sym/app/args.rb
 - lib/sym/app/cli.rb
 - lib/sym/app/commands.rb
+- lib/sym/app/commands/base_command.rb
 - lib/sym/app/commands/bash_completion.rb
-- lib/sym/app/commands/command.rb
 - lib/sym/app/commands/encrypt_decrypt.rb
 - lib/sym/app/commands/generate_key.rb
+- lib/sym/app/commands/keychain_add_key.rb
 - lib/sym/app/commands/open_editor.rb
+- lib/sym/app/commands/password_protect_key.rb
 - lib/sym/app/commands/print_key.rb
 - lib/sym/app/commands/show_examples.rb
 - lib/sym/app/commands/show_help.rb
@@ -250,11 +252,12 @@ files:
 - lib/sym/extensions/class_methods.rb
 - lib/sym/extensions/instance_methods.rb
 - lib/sym/version.rb
+- sym-3.0-cli.md
 - sym.gemspec
 homepage: https://github.com/kigster/sym
 licenses: []
 metadata: {}
-post_install_message: "Thank you for installing this gem! \nTo enable bash command
+post_install_message: "Thank you for installing this gem! \n\nTo enable bash command
   line completion, please run the following \ncommand, which appends sym's shell completion
   to the specified file:\n\n  sym --bash-completion ~/.bash_profile \n\n(or any other
   shell initialization file of your preference).\n\nThank you for checking out Sym
@@ -274,7 +277,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.2
+rubygems_version: 2.6.8
 signing_key: 
 specification_version: 4
 summary: Easy to use symmetric encryption library & CLI with a strong aes-256-cbc