trainsh 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6b809837d484a4a100b8d6b6d4718d623bb91990ea72d7181b5e70dbe265282a
-  data.tar.gz: 12a87fc192b92df5f3f0528c620d898c24dc5d7ec849b51081c7d996d57e51fa
+  metadata.gz: e16073675a7ba8bcf1dd7940f3437d724f294bcec683995064fa7d5b6ac09cf7
+  data.tar.gz: cfb59bdeb766c1c8c03313dc4745c55cb5579eef1e6687a8967491eb9c65f191
 SHA512:
-  metadata.gz: adef421ee124699ee90b841a57c0ef0653e7377a2d9cb6b3f6b0faa50948cc903e36fe38af4893ac8d60e8a9c94eb1adf3f8c66cd733c163700fac1480d148a4
-  data.tar.gz: 98947781c875c65f82563caeafba4637764c65758ebf8edf60fd16bf0765afe3a286032045957c20c0291248baf75f46dc165f25605492eb920b620a1d7737bc
+  metadata.gz: 2ea26ef8e8a52d8bf457a46b0ce39156fb81d47757ad6e9a90883bbd901fae275140d46e412b19638589b613be13746f6c83ec606533d707c4c1b8ad02df359c
+  data.tar.gz: 33ede37016876d9295bb8e75ef57aa577c8a569413728a040850842a9aae6cdbc924236c3e12d9ee643afc46a769b9475d81313825b494f248121284269d1430

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## Version 0.3.0
+
+- Add auto-detection of targets from environment (variable, test-kitchen)
+- Add `!copy` for cross-session copying
+- Add `!help` and `?` for usage in shell
+- Add detailed help for commands
+- Add output on copying files cross-session and editing/saving
+- Add devcontainer for VSCode
+- Change errors to be red, Shell built-in to yellow
+- Fix handling of URL encoded parameters
+- Fix `list-transports` to output all installed non-API transports
+- Fix crashes on unexpected input in shell
+- Fix exception handling in various places
+- Fix missing binary in Gem
+
 ## Version 0.2.0
 
 - Renamed to TrainSH

data/README.md

@@ -69,6 +69,9 @@ Clear your TrainSH history, for example to remove clutter or sensitive informati
 `!connect <uri>`
 Connect to another system. The URI needs to match the format of the used Train transport, which is usually `transportname://host` but varies. See the Train transport's documentation for details.
 
+`!copy @<session>:/<path> @<session>:/<path>`
+Copy a file between two established sessions.
+
 `!detect`
 Re-runs the OS detection which is running automatically on start. This will determine the OS, OS-family and general platform information via Train.
 
@@ -81,6 +84,9 @@ Downloads the remote file as temporary file and opens the system default editor
 `!env`
 Prints the environment variables of your remote shell. This will be filled on first command invocation to save IO. **Currently unsupported for Windows remote systems**
 
+`!help`
+Print out help
+
 `!history`
 Output your TrainSH command history. As this uses the popular Readline library, you can also navigate your history with the Up/Down arrows or use Ctrl-R for reverse search. You can do auto completion for built-in commands.
 
@@ -141,3 +147,15 @@ To make this easier, internal commands get attached to your input like this:
 - Postfix: Retrieve and save new environment variables
 
 Output of commands gets separated by outputting a highly random string between, which should not result in false positives. If a false positive occurs for some reason, TrainSH will fail and output an error.
+
+## Target Detection
+
+As providing target URLs to connect to can be tedious, TrainSH will detect targets to connect to via plugins. In these cases, `trainsh connect` does not need any parameters.
+
+### Environment Variables
+
+This will check the `TARGET` environment variable for a URL and use it to connect. Only one target is allowed.
+
+### Test Kitchen Configuration
+
+This will detect if the current directory has a Test Kitchen configuration and a created machine. If so, it will connect to the machine by parsing information in `.kitchen/` and the kitchen configuration file.

data/bin/trainsh

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+$LOAD_PATH.unshift File.expand_path('../lib', __dir__)
+require 'trainsh/cli'
+
+TrainSH::Cli.start

data/lib/trainsh/cli.rb

@@ -4,14 +4,12 @@ require_relative 'session'
 require_relative 'mixin/builtin_commands'
 require_relative 'mixin/file_helpers'
 require_relative 'mixin/sessions'
-
-# TODO
-# require_relative 'detectors/target/env.rb'
-# require_relative 'detectors/target/kitchen.rb'
+require_relative 'mixin/shell_output'
 
 require 'colored'
 require 'fileutils'
 require 'readline'
+require 'rubygems'
 require 'train'
 require 'thor'
 
@@ -19,7 +17,6 @@ module TrainSH
   class Cli < Thor
     include Thor::Actions
     check_unknown_options!
-    # add_runtime_options!
 
     def self.exit_on_failure?
       true
@@ -34,10 +31,14 @@ module TrainSH
     EXIT_COMMANDS = %w[!!! exit quit logout disconnect].freeze
     INTERACTIVE_COMMANDS = %w[more less vi vim nano].freeze
 
+    NON_OS_TRANSPORTS = %w[aws core kubernetes azure pgsql vsphere vault digitalocean rest].freeze
+    CORE_TRANSPORTS = %w[docker ssh].freeze
+
     no_commands do
       include TrainSH::Mixin::BuiltInCommands
       include TrainSH::Mixin::FileHelpers
       include TrainSH::Mixin::Sessions
+      include TrainSH::Mixin::ShellOutput
 
       def __disconnect
         session.close
@@ -70,12 +71,19 @@ module TrainSH
       end
 
       def target_detectors
-        Dir[File.join(__dir__, 'lib', '*.rb')].sort.each { |file| require file }
-
         TrainSH::Detectors::TargetDetector.descendants
       end
 
+      def detect_target
+        target_detectors.detect(&:url).url
+      end
+
       def execute(input)
+        if input == '?'
+          execute_builtin 'help'
+          return
+        end
+
         case input[0]
         when '.'
           execute_locally input[1..]
@@ -142,7 +150,7 @@ module TrainSH
       end
 
       def prompt
-        exitcode = current_session.exitcode
+        exitcode = current_session.exitcode || 0
         exitcode_prefix = exitcode.zero? ? 'OK '.green : format('E%02d ', exitcode).red
 
         format(::TrainSH::PROMPT,
@@ -159,7 +167,7 @@ module TrainSH
 
         choices.concat(builtin_commands.map { |cmd| "!#{cmd.tr('_', '-')}" })
         choices.concat(sessions.map { |session_id| "@#{session_id}" })
-        choices.concat %w[!!!]
+        choices.concat %w[!!! ?]
 
         choices.filter { |choice| choice.start_with? partial }
       end
@@ -175,14 +183,55 @@ module TrainSH
       #
       #   Logger.const_get(l.upcase)
       # end
+
+      def local_gems
+        Gem::Specification.sort_by { |g| [g.name.downcase, g.version] }.group_by(&:name)
+      end
     end
 
     # class_option :log_level, desc: "Log level", aliases: "-l", default: :info
     class_option :messy, desc: 'Skip deletion of temporary files for speedup', default: false, type: :boolean
 
     desc 'connect URL', 'Connect to a destination interactively'
+    long_desc <<-DESC
+      Create an interactive shell session with the remote system. The specified URL has to match the
+      chosen transport plugin.
+
+      If no URL was given, possible targets are detected from the environment variable TARGET or any
+      existing Test Kitchen instances (max: 1).
+
+      URL Examples:
+        docker://d9443b195d16
+        local://
+        ssh://user@remote.example.com
+        winrm://Administrator:PASSWORD@10.2.42.1
+
+      URL Examples from non-standard transports:
+        aws-ssm://i-1234567890ab
+        serial://dev/ttyUSB1/9600
+        telnet://127.0.0.1
+        vsphere-gom://Administrator@vcenter.server/virtual.machine
+
+      Every transport has its own, proprietary options which can currently only be added as URL
+      query parameters:
+        ssh://user@remote.example.com?key_files=/home/ubuntu/test.pem
+
+      Passwords currently have to be part of the URL.
+    DESC
+    def connect(url = nil)
+      # TODO: Pass options to `use_session`
+      unless url
+        show_message 'No URL given, trying to detect ...'
+        url = detect_target
+
+        show_message "Detected URL to be #{url}" if url
+      end
+
+      unless url
+        show_error 'No target could be detected'
+        exit
+      end
 
-    def connect(url)
       exit unless use_session(url)
 
       say format('Connected to %<url>s', url: session.url).bold
@@ -227,14 +276,19 @@ module TrainSH
 
         execute input
       end
+    rescue Interrupt
+      show_error 'Interrupted execution'
     end
 
     # desc 'copy FILE/DIR|URL FILE/DIR|URL', 'Copy files or directories'
     # def copy(url_or_file, url_or_file)
-    #   # TODO?
+    #   # TODO
     # end
 
     desc 'detect URL', 'Retrieve remote OS and platform information'
+    long_desc <<~DESC
+      Detect remote OS via Train. Uses the same schema as URLs for `connect`.
+    DESC
     def detect(url)
       exit unless use_session(url)
       __detect
@@ -249,13 +303,10 @@ module TrainSH
 
     desc 'list-transports', 'List available transports'
     def list_transports
-      # TODO: Train only lazy-loads and does not have a full registry
-      #       https://github.com/inspec/train/blob/be90ca53ea1c1e8aa7439c504fbee86f4b399d83/lib/train.rb#L38-L61
-
-      # TODO: Filter for only "OS" transports as well
-      transports = %w[local ssh winrm docker]
+      installed = local_gems.select { |name| name.start_with? 'train-' }.keys.map { |name| name.delete_prefix('train-') }
+      transports = installed - NON_OS_TRANSPORTS + CORE_TRANSPORTS
 
-      say "Available transports: #{transports.sort.join(', ')}"
+      say "Installed transports: #{transports.sort.join(', ')}"
     end
   end
 end

data/lib/trainsh/detectors/target/env.rb

@@ -3,8 +3,8 @@ require_relative '../target'
 module TrainSH
   module Detectors
     class EnvTarget < TargetDetector
-      def url
-        ENV['target']
+      def self.url
+        ENV['TARGET']
       end
     end
   end

data/lib/trainsh/detectors/target/kitchen.rb

@@ -1,44 +1,54 @@
 require_relative '../target'
 
+require 'yaml' unless defined?(YAML)
+
 module TrainSH
   module Detectors
     class KitchenTarget < TargetDetector
-      def url
-        # return unless kitchen_available?
-        # return unless kitchen_instance
-
-        # kitchen_config['transport']
+      def self.url
+        return unless kitchen_directory
+
+        files = Dir.glob("#{kitchen_directory}/*.yml")
+        return if files.empty?
+
+        # TODO: allow connecting to multiple instances
+        if files.count > 1
+          say "Found #{files.count} active kitchen instances, while only supporting 1"
+          exit
+        end
+
+        # Can get IP only from YAML files
+        instance_yaml = YAML.load_file(files.first)
+
+        # Can get user + protocol only from kitchen
+        instance_name = File.basename(files.first, '.yml')
+        env_prefix    = prefix_env_vars
+        cmd           = "#{env_prefix} kitchen diagnose #{instance_name}"
+        instance_data = YAML.safe_load(`#{cmd}`, [Symbol, Array, String])
+
+        transport = instance_data.dig('instances', instance_name, 'transport')
+
+        # TODO: Additional parameters like keypair etc
+        format('%<transport>s://%<user>s%<password>s@%<host>s',
+               transport: transport['name'],
+               user: transport['username'] || transport['user'],
+               password: transport['password'] ? ":#{transport['password']}" : '',
+               host: instance_yaml['hostname'] || instance_yaml['host']
+              )
       end
 
-      # private
-
-      # def kitchen_available?
-      #   `kitchen`
-      #   true
-      # rescue
-      #   false
-      # end
-
-      # attr_writer :kitchen_instances
-      # def kitchen_instances
-      #   return if @kitchen_instances
-
-      #   @kitchen_instances ||= YAML.load(`KITCHEN_LOCAL_YAML=".kitchen.ec2.yaml" kitchen list --json`)
-      # end
-
-      # def kitchen_config
-      #   return if @kitchen_config
-
-      #   parsed_output = YAML.load(`KITCHEN_LOCAL_YAML=".kitchen.ec2.yaml" kitchen diagnose customize-amazon2`)
-      #   @kitchen_config = kitchen_config['instances'].keys.first
-      # end
+      def self.kitchen_directory
+        # TODO: Recurse up
+        '.kitchen' if Dir.exist?('.kitchen')
+      end
 
-      # def kitchen_instance_name
-      #   kitchen_instances.select! { |instance| instance['last_action'] != nil }
+      def self.prefix_env_vars
+        kitchen_vars = ENV.select { |key, _value| key.start_with? 'KITCHEN_' }
 
-      #   return nil if kitchen_instances.count != 1
-      #   kitchen_instances.first['instance']
-      # end
+        # rubocop:disable Style/StringConcatenation
+        kitchen_vars.map { |key, value| "#{key}=\"#{value}\"" }.join(' ') + ' '
+        # rubocop:enable Style/StringConcatenation
+      end
     end
   end
 end

data/lib/trainsh/mixin/builtin_commands.rb

@@ -4,6 +4,7 @@ module TrainSH
   module Mixin
     module BuiltInCommands
       BUILTIN_PREFIX = 'builtincmd_'.freeze
+      SESSION_PATH_REGEX = %r{(/@(\d+):(/.*)$/)}.freeze
 
       def builtin_commands
         methods.sort.filter { |method| method.to_s.start_with? BUILTIN_PREFIX }.map { |method| method.to_s.delete_prefix BUILTIN_PREFIX }
@@ -15,16 +16,33 @@ module TrainSH
 
       def builtincmd_connect(url = nil)
         if url.nil? || url.strip.empty?
-          say 'Expecting session url, e.g. `!connect docker://123456789abcdef0`'.red
+          show_error 'Expecting session url, e.g. `!connect docker://123456789abcdef0`'
           return false
         end
 
         use_session(url)
       end
 
-      # def builtincmd_copy(source = nil, destination = nil)
-      #   # TODO: Copy files between sessions
-      # end
+      def builtincmd_copy(src = nil, dst = nil)
+        src_id, src_path = src&.match(SESSION_PATH_REGEX)&.captures
+        dst_id, dst_path = dst&.match(SESSION_PATH_REGEX)&.captures
+        unless src && dst && src_id && dst_id && src_path && dst_path
+          show_error 'Expecting source and destination, e.g. `!copy @0:/etc/hosts @1:/home/ubuntu/old_hosts'
+          return
+        end
+
+        src_session = session(src_id)
+        dst_session = session(dst_id)
+        unless src_session && dst_session
+          show_error 'Expecting valid session identifiers. Check available sessions via !sessions'
+          return
+        end
+
+        content = src_session.file(src_path)
+        dst_session.file(dst_path).content = content
+
+        show_message "Copied #{content.size} bytes successfully"
+      end
 
       def builtincmd_detect(_args = nil)
         __detect
@@ -32,45 +50,72 @@ module TrainSH
 
       def builtincmd_download(remote_path = nil, local_path = nil)
         if remote_path.nil? || local_path.nil?
-          say 'Expecting remote path and local path, e.g. `!download /etc/passwd /home/ubuntu`'
+          show_error 'Expecting remote path and local path, e.g. `!download /etc/passwd /home/ubuntu`'
           return false
         end
 
         return unless train_mutable?
 
         session.download(remote_path, local_path)
-      rescue ::Train::NotImplementedError
-        say 'Backend for session does not implement download operation'.red
+
+        show_message "Downloaded #{remote_path} successfully"
+      rescue NotImplementedError
+        show_error 'Backend for session does not implement file operations'
+      rescue StandardError => e
+        show_error "Error occured: #{e.message}"
       end
 
       def builtincmd_edit(path = nil)
         if path.nil? || path.strip.empty?
-          say 'Expecting remote path, e.g. `!less /tmp/somefile.txt`'.red
+          show_error 'Expecting remote path, e.g. `!less /tmp/somefile.txt`'
           return false
         end
 
         tempfile = read_file(path)
+        old_content = File.read(tempfile.path)
 
         localeditor = ENV['EDITOR'] || ENV['VISUAL'] || 'vi' # TODO: configuration, Windows, ...
-        say format('Using local editor `%<editor>s` for %<tempfile>s', editor: localeditor, tempfile: tempfile.path)
+        show_message format('Using local editor `%<editor>s` for %<tempfile>s', editor: localeditor, tempfile: tempfile.path)
 
         system("#{localeditor} #{tempfile.path}")
-
         new_content = File.read(tempfile.path)
 
-        write_file(path, new_content)
+        if new_content == old_content
+          show_message 'No changes detected'
+        else
+          write_file(path, new_content)
+
+          show_message "Wrote #{new_content.size} bytes successfully"
+        end
+
         tempfile.unlink
-      rescue ::Train::NotImplementedError
-        say 'Backend for session does not implement file operations'.red
+      rescue NotImplementedError
+        show_error 'Backend for session does not implement file operations'
+      rescue StandardError => e
+        show_error "Error occured: #{e.message}"
       end
 
       def builtincmd_env(_args = nil)
         puts session.env
       end
 
+      def builtincmd_help(_args = nil)
+        show_message <<~HELP
+          Unprefixed commands get sent to the remote host of the active session.
+
+          Commands with a prefix of `@n` with n being a number will be executed on the specified session. For a list of sessions check `!sessions`.
+
+          Commands with a prefix of `.` get executed locally.
+
+          Builtin commands are prefixed with `!`:
+        HELP
+
+        builtin_commands.each { |cmd| show_message " !#{cmd}" }
+      end
+
       def builtincmd_read(path = nil)
         if path.nil? || path.strip.empty?
-          say 'Expecting remote path, e.g. `!read /tmp/somefile.txt`'.red
+          show_error 'Expecting remote path, e.g. `!read /tmp/somefile.txt`'
           return false
         end
 
@@ -78,12 +123,14 @@ module TrainSH
         return false unless tempfile
 
         localpager = ENV['PAGER'] || 'less' # TODO: configuration, Windows, ...
-        say format('Using local pager `%<pager>s` for %<tempfile>s', pager: localpager, tempfile: tempfile.path)
+        show_message format('Using local pager `%<pager>s` for %<tempfile>s', pager: localpager, tempfile: tempfile.path)
         system("#{localpager} #{tempfile.path}")
 
         tempfile.unlink
-      rescue ::NotImplementedError
-        say 'Backend for session does not implement file operations'.red
+      rescue NotImplementedError
+        show_error 'Backend for session does not implement file operations'
+      rescue StandardError => e
+        show_error "Error occured: #{e.message}"
       end
 
       def builtincmd_history(_args = nil)
@@ -91,16 +138,24 @@ module TrainSH
       end
 
       def builtincmd_host(_args = nil)
-        say session.host
+        show_message session.host
       end
 
       def builtincmd_ping(_args = nil)
         session.run_idle
-        say format('Ping: %<ping>dms', ping: session.ping)
+
+        show_message format('Ping: %<ping>dms', ping: session.ping)
       end
 
+      # rubocop:disable Lint/Debugger
+      def builtincmd_pry(_args = nil)
+        require 'pry' unless defined?(binding.pry)
+        binding.pry
+      end
+      # rubocop:enable Lint/Debugger
+
       def builtincmd_pwd(_args = nil)
-        say session.pwd
+        show_message session.pwd
       end
 
       def builtincmd_reconnect(_args = nil)
@@ -108,20 +163,16 @@ module TrainSH
       end
 
       def builtincmd_sessions(_args = nil)
-        say 'Active sessions:'
+        show_message 'Active sessions:'
 
         @sessions.each_with_index do |session, idx|
-          say format('[%<idx>d] %<session>s', idx: idx, session: session.url)
+          show_message format('[%<idx>d] %<session>s', idx: idx, session: session.url)
         end
       end
 
       def builtincmd_session(session_id = nil)
         session_id = validate_session_id(session_id)
-
-        if session_id.nil?
-          say 'Expecting valid session id, e.g. `!session 2`'.red
-          return false
-        end
+        return if session_id.nil?
 
         # TODO: Make this more pretty
         session_url = @sessions[session_id].url
@@ -131,17 +182,21 @@ module TrainSH
 
       def builtincmd_upload(local_path = nil, remote_path = nil)
         if remote_path.nil? || local_path.nil?
-          say 'Expecting remote path and local path, e.g. `!download /home/ubuntu/passwd /etc`'
+          show_error 'Expecting remote path and local path, e.g. `!download /home/ubuntu/passwd /etc'
           return false
         end
 
         return unless train_mutable?
 
         session.upload(local_path, remote_path)
+
+        show_message "Uploaded to #{remote_path} successfully"
       rescue ::Errno::ENOENT
-        say "Local file/directory '#{local_path}' does not exist".red
-      rescue ::NotImplementedError
-        say 'Backend for session does not implement upload operation'.red
+        show_error "Local file/directory '#{local_path}' does not exist"
+      rescue NotImplementedError
+        show_error 'Backend for session does not implement upload operation'
+      rescue StandardError => e
+        show_error "Error occured: #{e.message}"
       end
 
       private
@@ -149,7 +204,7 @@ module TrainSH
       def train_mutable?
         return true if session.respond_to?(:upload)
 
-        say "Support for remote file modification needs at least Train #{::TrainSH::TRAIN_MUTABLE_VERSION} (is: #{::Train::VERSION})".red
+        show_error "Support for remote file modification needs at least Train #{::TrainSH::TRAIN_MUTABLE_VERSION} (is: #{::Train::VERSION})"
       end
     end
   end

data/lib/trainsh/mixin/sessions.rb

@@ -20,7 +20,9 @@ module TrainSH
       end
 
       def session(session_id = current_session_id)
-        @sessions[session_id]
+        id = validate_session_id(session_id)
+
+        @sessions[id] if id
       end
 
       # ?
@@ -37,13 +39,23 @@ module TrainSH
       end
 
       def validate_session_id(session_id)
-        unless session_id.match?(/^[0-9]+$/)
+        unless session_id
+          say 'Expecting valid session id, e.g. `!session 2`'.red
+          return
+        end
+
+        unless session_id.to_s.match?(/^[0-9]+$/)
           say 'Expected session id to be numeric'.red
           return
         end
 
         if @sessions[session_id.to_i].nil?
-          say format('No session id [%s] found', session_id).red
+          say 'Expecting valid session id, e.g. `!session 2`'.red
+
+          say "\nActive sessions:"
+          @sessions.each_with_index { |data, idx| say "[#{idx}] #{data.url}" }
+          say
+
           return
         end
 

data/lib/trainsh/mixin/shell_output.rb

@@ -0,0 +1,13 @@
+module TrainSH
+  module Mixin
+    module ShellOutput
+      def show_error(message)
+        say message.red
+      end
+
+      def show_message(message)
+        say message.yellow
+      end
+    end
+  end
+end

data/lib/trainsh/session.rb

@@ -1,10 +1,11 @@
 require 'benchmark'
 require 'forwardable'
-
+require 'cgi'
 require 'train'
 
 module TrainSH
   class Command
+    # Used for command separation, randomly generated
     MAGIC_STRING = 'mVDK6afaqa6fb7kcMqTpR2aoUFbYsRt889G4eGoI'.freeze
 
     attr_writer :connection
@@ -98,6 +99,7 @@ module TrainSH
       @url = url
 
       data = Train.unpack_target_from_uri(url)
+      data.transform_values! { |val| CGI.unescape(val) }
 
       # TODO: Wire up with "messy" parameter
       data[:cleanup] = false

data/lib/trainsh/version.rb

@@ -1,3 +1,3 @@
 module TrainSH
-  VERSION = '0.2.0'.freeze
+  VERSION = '0.3.0'.freeze
 end

data/lib/trainsh.rb

@@ -3,3 +3,6 @@ require_relative 'trainsh/constants'
 require_relative 'trainsh/errors'
 # require_relative 'trainsh/log'
 require_relative 'trainsh/version'
+
+require_relative 'trainsh/detectors/target/env'
+require_relative 'trainsh/detectors/target/kitchen'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: trainsh
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Thomas Heinen
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-02-25 00:00:00.000000000 Z
+date: 2021-11-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bump
@@ -168,12 +168,14 @@ description: Based on the Train ecosystem, provide a shell to manage systems via
   multitude of transports.
 email:
 - theinen@tecracer.de
-executables: []
+executables:
+- trainsh
 extensions: []
 extra_rdoc_files: []
 files:
 - CHANGELOG.md
 - README.md
+- bin/trainsh
 - lib/trainsh.rb
 - lib/trainsh/cli.rb
 - lib/trainsh/config.rb
@@ -186,6 +188,7 @@ files:
 - lib/trainsh/mixin/builtin_commands.rb
 - lib/trainsh/mixin/file_helpers.rb
 - lib/trainsh/mixin/sessions.rb
+- lib/trainsh/mixin/shell_output.rb
 - lib/trainsh/session.rb
 - lib/trainsh/version.rb
 homepage: https://github.com/tecracer-chef/trainsh