mysh 0.6.6 → 0.6.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 36d1e9cb65e8e404c9e85ab77e29e1201a2df5f6
-  data.tar.gz: 3e5f058a9f2a8ebbe313fff8983aa328b016652f
+  metadata.gz: 8403491794cc9b50c4dc0bed451e056885cc71d0
+  data.tar.gz: 72acbb99d7324a29ba47507c011497355fd61069
 SHA512:
-  metadata.gz: 5d9ba17eb0a81ebc7b291767f03f9d56b077b8b82e89593b090fd689eae5acfdce02554b7b8ab0eff9a0359506328bb7a28f49101ac0b9847980d5dec10b075c
-  data.tar.gz: fbb691b11d8daf992f152412bd4dae5b3ebe958c73abfc1f2c759ba0c757443c8bacf19174914057cb95639dcac5c8a417973ff0e02e5bd87ee2ff495b8e872a
+  metadata.gz: f82fd9fc077c6f6b3e205eae6cbadba360ef37c98a3a25364c8fd9ba4b6aa7ffbdeaf18fd8be0271bff3f760bdabc7c87cf7f74163c55c3464f1441ca576069d
+  data.tar.gz: 5ac0b97c97351f5234c4da238869682dd3dcbac81318876cc20f04d4cf97c590caca373caccfc5221f358fd7dff2fdd1593687ad830849dc31c0088c5f687b25

data/README.md

@@ -371,8 +371,11 @@ The processing of input continues (looping) until it doesn't. This occurs when
 a command to stop looping is entered or the mini_readline gem signals
 end-of-input condition. The (internal) commands that do this are:
 
-* exit - exit the current mysh level.
-* quit - terminate the mysh program.
+* cancel - exit the current mysh file/level.
+* exit - terminate the mysh program.
+
+The cancel and exit commands are also available, with the same names and
+behavior, to Ruby code.
 
 An end-of-input condition is signaled by the user by entering Ctrl-z (in
 windows) or Alt-z (in Linux/Mac). See the mini_readline gem (link above) for
@@ -592,8 +595,8 @@ none       | General help on mysh.
 =          | Help on ruby expressions.
 ?          | This help on the help command.
 @          | Help on the show command.
-args       | Help on mysh command arguments.
 env        | Help on the show env command.
+gem        | Help on the show gem command.
 gls        | Help on gls internal mysh command.
 help       | This help on the help command.
 history    | Help on the history command.
@@ -605,6 +608,7 @@ quick      | Help on quick commands.
 ruby       | Help on the show ruby command.
 set        | Help on mysh variables.
 show       | Help on the show command.
+term       | Help on the show term command.
 types      | Help on mysh file types.
 usage      | Help on mysh usage options.
 {{         | Help on mysh handlebars.
@@ -629,19 +633,18 @@ Topic    | Description
 ---------|----------------------------------------------------
 about    | A brief description of the mysh shell program.
 version  | The version of mysh in use.
+installed| All installed versions of mysh.
+latest   | The latest version of mysh.
 init file| The init file in use or <none found> or <none>.
 user     | The current user name.
 home     | The current home directory.
 name     | The path/name of the mysh program currently executing.
-shell    | The path/name of the system command shell.
+os shell | The path/name of the system command shell.
 host     | The name of the host computer.
 os       | The current operating system.
 platform | The operating platform detected by the low-level terminal gem.
 java     | Is the current platform powered by Java?
-code page| In Windows, what code page is active?
-term     | What terminal is defined by the system, if one is defined.
-disp     | What display is defined by the system, if one is defined.
-edit     | What editor is defined by the system, if one is defined.
+PID      | The process ID of the mysh program.
 path     | An easy-to-read, formatted version of the current search path.
 
 
@@ -667,6 +670,68 @@ host os     | The current operating system.
 host vendor | The current environment vendor/genre.
 $:          | An easy-to-read, formatted version of $: or the ruby search path.
 
+##### Gem (@gem)
+
+The show gem (or @gem) command is used to display useful information about
+the current gem system. There are two distinct ways to use this command.
+
+The first is without any arguments. This displays general information about the
+gem subsystem. This includes:
+
+Topic         | Description
+--------------|----------------------------------------------------
+about         | About rubygems.
+version       | The current version of rubygems.
+latest        | The latest version of rubygems available.
+marshal       | The version of the marshal format for your Ruby.
+host          | Get the default RubyGems API host. This is normally https://rubygems.org.
+sources       | Returns an Array of sources to fetch remote gems from.
+gem folder    | The path where gems are to be installed.
+bin folder    | The path where gem executables are to be installed.
+config path   | The path to standard location of the user's .gemrc file.
+cert path     | The default signing certificate chain path
+key path      | The default signing key path
+spec cache    | The path to where specs are cached.
+file suffixes | Suffixes for require-able paths.
+gem dep files | The files where dependencies may be specified. Use Gemfile
+gem platforms | Array of platforms this RubyGems supports.
+gem path      | The folders searched when looking for a gem locally.
+
+The alternative is to specify a list of gems of interest. For each gem in the
+list, the program will list all installed versions of that gem and the latest
+version of that gem on the rubygems host. For example:
+
+    8 mysh>@gem rails gosu
+    Info on specified gems.
+
+    rails  4.2.0, 5.1.3, 5.1.6
+    latest 5.2.2
+
+    gosu   0.13.3
+    latest 0.14.4
+
+##### Term (@term)
+
+This command displays useful information about the console.
+
+Topic         | Description
+--------------|----------------------------------------------------
+about         | About the mini_readline gem.
+version       | The installed version of mini_readline.
+installed     | All installed versions of mini_readline.
+latest        | The latest version of mini_readline available.
+about         | About the mini_term gem.
+version       | The installed version of mini_term.
+installed     | All installed versions of mini_term.
+latest        | The latest version of mini_term available.
+platform      | The operating platform detected by mini_term.
+columns       | The number of columns in the console.
+rows          | The number of rows in the console.
+code page     | For Windows, what is the current code page?
+term          | What terminal is defined by the system, if one is defined.
+disp          | What display is defined by the system, if one is defined.
+edit          | What editor is defined by the system, if one is defined.
+
 
 ### Internal Shell Commands:
 

data/lib/mysh/globalize.rb

@@ -33,9 +33,16 @@ class Object
     $stdout = saved
   end
 
-  #Unwrap one mysh layer.
+  # Unwrap one mysh layer.
   def cancel
     raise MyshExit
   end
 
+  # Run some code with no wuccas.
+  def insouciant
+    yield
+  rescue => err
+    err.to_s
+  end
+
 end

data/lib/mysh/internal/actions/help/env.txt

@@ -3,18 +3,19 @@ Help: mysh show env command summary:
 The show env (or @env) command is used to display useful information about the
 current execution environment. This includes:
 
+about     - About mysh.
+version   - The current version of mysh.
+installed - All installed versions of mysh.
+latest    - The latest version of mysh.
+init file - The location of the mysh init file.
 user      - The current user name.
 home      - The current home directory.
 name      - The path/name of the mysh program currently executing.
-shell     - The path/name of the system command shell.
+os shell  - The path/name of the system command shell.
 host      - The name of the host computer.
 os        - The current operating system.
 platform  - The operating platform detected by the low-level terminal gem.
 java      - Is the current platform powered by Java?
-code page - For Windows, what is the current code page?
-term      - What terminal is defined by the system, if one is defined.
-disp      - What display is defined by the system, if one is defined.
-edit      - What editor is defined by the system, if one is defined.
 PID       - The process ID of the mysh program.
 
 path      - An easy-to-read, formatted version of the current search path.

data/lib/mysh/internal/actions/help/gem.txt

@@ -0,0 +1,39 @@
+Help: mysh show gem command summary:
+
+The show gem (or @gem) command is used to display useful information about
+the current gem system. There are two distinct ways to use this command.
+
+The first is without any arguments. This displays general information about the
+gem subsystem. This includes:
+
+about         - About rubygems.
+version       - The current version of rubygems.
+latest        - The latest version of rubygems available.
+marshal       - The version of the marshal format for your ruby.
+host          - Get the default RubyGems API host.
+                This is normally https://rubygems.org.
+sources       - Returns an Array of sources to fetch remote gems from.
+gem folder    - The path where gems are to be installed.
+bin folder    - The path where gem executables are to be installed.
+config path   - The path to standard location of the user's .gemrc file.
+cert path     - The default signing certificate chain path
+key path      - The default signing key path
+spec cache    - The path to where specs are cached.
+file suffixes - Suffixes for require-able paths.
+gem dep files - The files where dependencies may be specified. Use Gemfile
+gem platforms - Array of platforms this RubyGems supports.
+gem path      - The folders searched when looking for a gem locally.
+
+The alternative is to specify a list of gems of interest. For each gem in the
+list, the program will list all installed versions of that gem and the latest
+version of that gem on the rubygems host. For example:
+
+    8 mysh>@gem rails gosu
+    Info on specified gems.
+
+    rails  4.2.0, 5.1.3, 5.1.6
+    latest 5.2.2
+
+    gosu   0.13.3
+    latest 0.14.4
+

data/lib/mysh/internal/actions/help/sub_help.rb

@@ -28,6 +28,8 @@ module Mysh
           ['%',       'Help on timed command execution.',    'timed.txt'  ],
           ['env',     'Help on the show env command.',       'env.txt'    ],
           ['ruby',    'Help on the show ruby command.',      'ruby.txt'   ],
+          ['gem',     'Help on the show gem command.',       'gem.txt'    ],
+          ['term',    'Help on the show term command.',      'term.txt'   ],
           ['math',    'Help on math functions.',             'math.txt'   ],
           ['usage',   'Help on mysh usage.',                 'usage.txt'  ],
           ['=',       'Help on ruby expressions.',           'expr.txt'   ],

data/lib/mysh/internal/actions/help/term.txt

@@ -0,0 +1,21 @@
+Help: mysh show term command summary:
+
+The show term (or @term) command is used to display useful information about
+the current console. This includes:
+
+about         - About the mini_readline gem.
+version       - The installed version of mini_readline.
+installed     - All installed versions of mini_readline.
+latest        - The latest version of mini_readline available.
+about         - About the mini_term gem.
+version       - The installed version of mini_term.
+installed     - All installed versions of mini_term.
+latest        - The latest version of mini_term available.
+platform      - The operating platform detected by mini_term.
+columns       - The number of columns in the console.
+rows          - The number of rows in the console.
+code page     - For Windows, what is the current code page?
+term          - What terminal is defined by the system, if one is defined.
+disp          - What display is defined by the system, if one is defined.
+edit          - What editor is defined by the system, if one is defined.
+

data/lib/mysh/internal/actions/show.rb

@@ -3,6 +3,9 @@
 #* mysh/internal/actions/show.rb -- The mysh internal show command.
 module Mysh
 
+  # The working message for long duration processing.
+  WORKING = "Working...\r"
+
   #Show items.
   default = Action.new do |input|
     puts "No show data found for #{input.raw.inspect}. See ?@ for more."

data/lib/mysh/internal/actions/show/env.rb

@@ -1,26 +1,33 @@
 # coding: utf-8
 
-#* mysh/internal/actions/show/env.rb -- Get help on the mysh environment.
+# Get info on the mysh environment.
 module Mysh
 
-  #* mysh/internal/actions/show/env.rb -- Get help on the mysh environment.
+  # Get info on the mysh environment.
   class EnvInfoCommand < Action
 
-    #Execute the ? shell command.
+    # Execute the @env shell command.
     def process_command(_args)
-      puts "Key mysh environment information.", ""
-      puts info.format_mysh_bullets, "",
+      print WORKING unless @ran_once
+
+      puts "Key mysh environment information.", "",
+           info.format_mysh_bullets, "",
            path.format_mysh_bullets, ""
+
+      @ran_once = true
     end
 
     private
 
-    #Get the info
-    #<br>Endemic Code Smells
-    #* :reek:UtilityFunction
+    # Get the info
+    # Endemic Code Smells :reek:UtilityFunction
     def info
       [["about",     Mysh::SUMMARY],
        ["version",   Mysh::VERSION],
+       ["installed", Gem::Specification.find_all_by_name("mysh")
+                                       .map{|s| s.version.to_s}
+                                       .join(", ")],
+       ["latest",    insouciant {Gem.latest_version_for("mysh").to_s}],
        ["init file", $mysh_init_file.to_host_spec],
        ["user",      ENV['USER']],
        ["home",      (ENV['HOME'] || "").to_host_spec],
@@ -30,17 +37,12 @@ module Mysh
        ["os",        ENV['OS']],
        ["platform",  MiniTerm::TERM_PLATFORM],
        ["java?",     MiniTerm.java? ? true : false],
-       ["code page", if MiniTerm.windows?; (`chcp`); end],
-       ["term",      ENV['TERM']],
-       ["disp",      ENV['DISPLAY']],
-       ["edit",      ENV['EDITOR']],
        ["PID",       $PROCESS_ID]
       ]
     end
 
-    #Get the path.
-    #<br>Endemic Code Smells
-    #* :reek:UtilityFunction
+    # Get the path.
+    # Endemic Code Smells :reek:UtilityFunction
     def path
       [["path"].concat(ENV['PATH'].split(File::PATH_SEPARATOR))]
     end

data/lib/mysh/internal/actions/show/gem.rb

@@ -0,0 +1,93 @@
+# coding: utf-8
+
+# Get help on the gem environment.
+module Mysh
+
+  # Get help on the gem environment.
+  class GemInfoCommand < Action
+
+    #Execute the @gem shell command.
+    def process_command(input)
+      print WORKING unless @ran_once
+
+      args = input.cooked_body.split(" ")[1..-1]
+
+      if args.empty?
+        general
+      else
+        specific(args)
+      end
+
+      @ran_once = true
+    end
+
+    private
+
+    # A general info request
+    def general
+      puts "Key gem system information.", "",
+           info.format_mysh_bullets, "",
+           path.format_mysh_bullets, ""
+    end
+
+    # Get the info
+    # Endemic Code Smells :reek:UtilityFunction
+    def info
+      [["about",         "RubyGems is the ruby standard for publishing and " +
+                         "managing third party libraries."],
+       ["version",       Gem.rubygems_version.to_s],
+       ["latest",        insouciant {Gem.latest_rubygems_version.to_s}],
+       ["marshal",       Gem.marshal_version],
+       ["host",          Gem.host],
+       ["sources",       Gem.sources.map(&:to_s)],
+       ["gem folder",    Gem.dir.to_host_spec],
+       ["bin folder",    Gem.bindir.to_host_spec],
+       ["config path",   Gem.config_file.to_host_spec],
+       ["cert path",     Gem.default_cert_path.to_host_spec],
+       ["key path",      Gem.default_key_path.to_host_spec],
+       ["spec cache",    Gem.spec_cache_dir.to_host_spec],
+       ["file suffixes", Gem.suffixes.map{|sfx| '"'+sfx+'"'}.join(", ")],
+       ["gem dep files", Gem::GEM_DEP_FILES.map{|sfx| '"'+sfx+'"'}.join(", ")],
+       ["gem platforms", Gem.platforms.map{|sfx| '"'+sfx.to_s+'"'}.join(", ")]
+      ]
+    end
+
+    # Get the Gem path.
+    # Endemic Code Smells :reek:UtilityFunction
+    def path
+      [["gem path"].concat(Gem.path)]
+    end
+
+    # Get gem info on the specified gems
+    def specific(args)
+      details = []
+
+      args.each do |gem|
+        version_list = Gem::Specification.find_all_by_name(gem)
+                                         .map{|s| s.version.to_s}
+                                         .join(", ")
+        details << [gem, version_list]
+
+        latest = insouciant {latest_version_for(gem).to_s}
+        details << ["latest", latest]
+        details << [" ", " "]
+      end
+
+      puts "Info on specified gems.", "",
+           details.format_mysh_bullets
+    end
+
+    # Get the latest version for the named gem. Patched code.
+    def latest_version_for(name)
+      dependency = Gem::Dependency.new(name)
+      fetcher = Gem::SpecFetcher.fetcher
+      spec = fetcher.spec_for_dependency(dependency)[0][-1][0]
+      spec && spec.version
+    end
+
+  end
+
+  desc = 'Get information about the current gem support or ' +
+         'the specified list of gems. See ?gem for more.'
+  SHOW.add_action(GemInfoCommand.new('gem <gems>', desc))
+end

data/lib/mysh/internal/actions/show/ruby.rb

@@ -1,12 +1,12 @@
 # coding: utf-8
 
-#* mysh/internal/actions/show/ruby.rb -- Get help on the ruby environment.
+# Get info on the ruby environment.
 module Mysh
 
-  #* mysh/internal/actions/show/ruby.rb -- Get help on the ruby environment.
+  # Get info on the ruby environment.
   class RubyInfoCommand < Action
 
-    #Execute the ? shell command.
+    #Execute the @ruby shell command.
     def process_command(_input)
       puts "Key ruby environment information.", ""
       puts info.format_mysh_bullets, "",
@@ -15,9 +15,8 @@ module Mysh
 
     private
 
-    #Get the info
-    #<br>Endemic Code Smells
-    #* :reek:UtilityFunction
+    # Get the info
+    # Endemic Code Smells :reek:UtilityFunction
     def info
       [["location",    RbConfig.ruby.to_host_spec],
        ["description", RUBY_DESCRIPTION],
@@ -36,9 +35,8 @@ module Mysh
       ]
     end
 
-    #Get the path.
-    #<br>Endemic Code Smells
-    #* :reek:UtilityFunction
+    # Get the path.
+    # Endemic Code Smells :reek:UtilityFunction
     def path
       [["$:"].concat($:)]
     end

data/lib/mysh/internal/actions/show/term.rb

@@ -0,0 +1,53 @@
+# coding: utf-8
+
+# Get help on the term environment.
+module Mysh
+
+  # Get help on the term environment.
+  class TermInfoCommand < Action
+
+    #Execute the @term shell command.
+    def process_command(_args)
+      print WORKING unless @ran_once
+
+      puts "Key term information.", "",
+           info.format_mysh_bullets, ""
+
+      @ran_once = true
+    end
+
+    private
+
+    # Get the info
+    # Endemic Code Smells :reek:UtilityFunction
+    def info
+      [["about",     MiniReadline::DESCRIPTION],
+       ["version",   MiniReadline::VERSION],
+       ["installed", Gem::Specification.find_all_by_name("mini_readline")
+                                       .map{|s| s.version.to_s}
+                                       .join(", ")],
+       ["latest",    insouciant {Gem.latest_version_for("mini_readline").to_s}],
+       ["about",     MiniTerm::DESCRIPTION],
+       ["version",   MiniTerm::VERSION],
+       ["installed", Gem::Specification.find_all_by_name("mini_term")
+                                       .map{|s| s.version.to_s}
+                                       .join(", ")],
+       ["latest",    insouciant {Gem.latest_version_for("mini_term").to_s}],
+       ["platform",  MiniTerm::TERM_PLATFORM.inspect],
+       ["term type", MiniTerm::TERM_TYPE.inspect],
+       ["columns",   MiniTerm.width.to_s],
+       ["rows",      MiniTerm.height.to_s],
+       ["code page", if MiniTerm.windows?; (`chcp`); end],
+       ["term",      ENV['TERM']],
+       ["disp",      ENV['DISPLAY']],
+       ["edit",      ENV['EDITOR']]
+      ]
+    end
+
+
+
+  end
+
+  desc = 'Get information about the console. See ?term for more.'
+  SHOW.add_action(TermInfoCommand.new('term', desc))
+end

data/lib/mysh/version.rb

@@ -2,7 +2,7 @@
 
 module Mysh
   #The version string of MY SHell.
-  VERSION = "0.6.6"
+  VERSION = "0.6.8"
 
   #A brief summary of this gem.
   SUMMARY = "mysh -- a Ruby inspired command line shell."

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mysh
 version: !ruby/object:Gem::Version
-  version: 0.6.6
+  version: 0.6.8
 platform: ruby
 authors:
 - Peter Camilleri
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-12-03 00:00:00.000000000 Z
+date: 2018-12-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -184,6 +184,7 @@ files:
 - lib/mysh/internal/actions/help.rb
 - lib/mysh/internal/actions/help/env.txt
 - lib/mysh/internal/actions/help/expr.txt
+- lib/mysh/internal/actions/help/gem.txt
 - lib/mysh/internal/actions/help/gls.txt
 - lib/mysh/internal/actions/help/h_o_h.txt
 - lib/mysh/internal/actions/help/hbar.txt
@@ -197,6 +198,7 @@ files:
 - lib/mysh/internal/actions/help/ruby.txt
 - lib/mysh/internal/actions/help/show.txt
 - lib/mysh/internal/actions/help/sub_help.rb
+- lib/mysh/internal/actions/help/term.txt
 - lib/mysh/internal/actions/help/timed.txt
 - lib/mysh/internal/actions/help/types.txt
 - lib/mysh/internal/actions/help/usage.txt
@@ -208,7 +210,9 @@ files:
 - lib/mysh/internal/actions/say.rb
 - lib/mysh/internal/actions/show.rb
 - lib/mysh/internal/actions/show/env.rb
+- lib/mysh/internal/actions/show/gem.rb
 - lib/mysh/internal/actions/show/ruby.rb
+- lib/mysh/internal/actions/show/term.rb
 - lib/mysh/internal/actions/type.rb
 - lib/mysh/internal/actions/vars.rb
 - lib/mysh/internal/format.rb