mysh 0.6.7 → 0.6.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8ccc77021991eea710a4f18df07bcbc4299ac54f
-  data.tar.gz: b2b8547854f287ce68ae9c3f4040e9a350540a80
+  metadata.gz: 8403491794cc9b50c4dc0bed451e056885cc71d0
+  data.tar.gz: 72acbb99d7324a29ba47507c011497355fd61069
 SHA512:
-  metadata.gz: 46d4a07ecced86317296a1d1d2b61180eb10c33baec5c45395757f466834d207af16de8f209015321f2713797ed0678ef601cc0117505ccbe4d58e6fd3bfbcb0
-  data.tar.gz: 96c351932b68923ee8af8b75834dd8ce958b83c9e2c1c1c210abdbb16db8e720164d74568682291b031bb58915c8d0e33934fb66ff5e74d3df8379c36df531d1
+  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.
 
 
@@ -669,14 +672,18 @@ $:          | An easy-to-read, formatted version of $: or the ruby search path.
 
 ##### Gem (@gem)
 
-This command displays useful information about the current rubygems
-gem management system.
+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
 --------------|----------------------------------------------------
-rubygems vers | The installed version of rubygems.
-latest vers   | The latest version of rubygems available.
-marshal vers  | The version of the Marshal format for your Ruby.
+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.
@@ -690,6 +697,41 @@ 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

@@ -1,11 +1,15 @@
 Help: mysh show gem command summary:
 
 The show gem (or @gem) command is used to display useful information about
-the current gem system. This includes:
+the current gem system. There are two distinct ways to use this command.
 
-rubygems vers - The installed version of rubygems.
-latest vers   - The latest version of rubygems available.
-marshal vers  - The version of the Marshal format for your Ruby.
+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.
@@ -20,3 +24,16 @@ 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

@@ -29,6 +29,7 @@ module Mysh
           ['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

@@ -3,29 +3,41 @@
 # Get help on the gem environment.
 module Mysh
 
-  #* mysh/internal/actions/show/env.rb -- Get help on the mysh environment.
+  # Get help on the gem environment.
   class GemInfoCommand < Action
 
-    #Execute the ? shell command.
-    def process_command(_args)
-      print "Working...\r" unless @ran_once
+    #Execute the @gem shell command.
+    def process_command(input)
+      print WORKING unless @ran_once
 
-      puts "Key gem system information.", "",
-           info.format_mysh_bullets, "",
-           path.format_mysh_bullets, ""
+      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
-    #<br>Endemic Code Smells
-    #* :reek:UtilityFunction
+    # Endemic Code Smells :reek:UtilityFunction
     def info
-      [["rubygems vers", Gem.rubygems_version.to_s],
-       ["latest vers",   Gem.latest_rubygems_version.to_s],
-       ["marshal vers",  Gem.marshal_version],
+      [["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],
@@ -41,15 +53,41 @@ module Mysh
     end
 
     # Get the Gem path.
-    #<br>Endemic Code Smells
-    #* :reek:UtilityFunction
+    # 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. ' +
-         'See ?gem for more.'
-  SHOW.add_action(GemInfoCommand.new('gem', desc))
+  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.7"
+  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.7
+  version: 0.6.8
 platform: ruby
 authors:
 - Peter Camilleri
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-12-04 00:00:00.000000000 Z
+date: 2018-12-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -198,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
@@ -211,6 +212,7 @@ files:
 - 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