commands-lite 0.0.1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: afab1688081598840aee3d5bb9868d07975b20c6
-  data.tar.gz: 6ab92e22ae2bdcf9303c09560d1fc50b0632972c
+  metadata.gz: 693a3892801a9f29d308e2bbd6886525d9303b51
+  data.tar.gz: acfebd670a7edd788d13be8793e1a1cb555bb399
 SHA512:
-  metadata.gz: fcc60f1b92f4d56989ce3d351c7f08c41989edb6c3059c3eb99edd53549c16803c9e121d1a065c460a66703cc54b9cfeff3e749ee1ce9e848076515eedc95980
-  data.tar.gz: fbc2e50b756ba87c9875ce4110bef7312ab892a95653800511645e7f695145b2eaa866ce88d10527e53635e150986dfa8a3155eec863687cbcb467190784ad30
+  metadata.gz: b2f82d4b9e01c7277c354d1d6f574934bede60a868f17c44b2c77a6fa434187a606e3703115347b31f7df2643d8ba1ba8a20461c3e10a9e2931462049e57dfa8
+  data.tar.gz: e57c909ce8dd6c7f302023cbd4f981d006f3ce0021c074d974a064637fbec43b7c7766b3f6c55f4c1be1cd2d9c2006276ed9c354d6dde187106c2d9b03794fb0

data/Manifest.txt

@@ -3,4 +3,5 @@ Manifest.txt
 README.md
 Rakefile
 lib/commands-lite.rb
+lib/commands-lite/base.rb
 lib/commands-lite/version.rb

data/lib/commands-lite.rb

@@ -1,3 +1,19 @@
+require 'pp'
+require 'time'
+require 'date'         ## e.g. Date.today etc.
+require 'yaml'
+require 'json'
+require 'fileutils'    ## e.g. FileUtils.mkdir_p etc.
+require 'optparse'
+
+
+
 #####################
 # our own code
 require 'commands-lite/version'   # note: let version always go first
+require 'commands-lite/base'
+
+
+
+# say hello
+puts CommandsLite.banner

data/lib/commands-lite/base.rb

@@ -0,0 +1,129 @@
+class Command
+
+def self.option_defs
+  @option_defs ||= {}
+end
+
+def self.option( key, *args )
+  option_defs[ key ] = args
+end
+
+
+
+def options
+  @options ||= {}
+end
+
+def parse!( args )
+  ### todo/check - cache option parser!!!! - why? why not?
+  OptionParser.new do |parser|
+    ## add default banner - overwrite if needed/to customize
+    parser.banner = <<TXT
+
+Usage: #{name} [OPTIONS] ARGUMENTS
+
+TXT
+
+    self.class.option_defs.each do | key, on_args|
+      parser.on( *on_args ) do |value|
+        options[ key ] = value
+      end
+    end
+  end.parse!( args )
+end
+
+
+
+def self.run( args=[] )
+  command      = new
+
+  puts "--> (#{command.name})  #{args.join('·')}"
+
+  ## check for options
+  command.parse!( args )
+
+  puts "     #{command.options.size} opt(s): #{command.options.pretty_inspect}"
+  puts "     #{args.size} arg(s):"
+  args.each_with_index do |arg,i|
+    puts "            #{[i]} >#{arg}<"
+  end
+
+
+  if args.size > 0
+    ## todo/check: check/verify arity of run - why? why not?
+    command.call( *args )   ## use run - why? why not?
+  else
+    command.call
+  end
+end
+
+
+def self.command_name
+  ## note: cut-off leading Yorobot:: for now in class name!!!
+  ## note: always remove _ for now too!!!
+  ## note: do NOT use @@name!!! - one instance variable per class needed!!
+  @name ||= self.name.downcase
+                     .sub( /^yorobot::/, '' )   ## todo/fix: make "exclude" list configure-able  why? why not?
+                     .gsub( /[_-]/, '' )
+  @name
+end
+
+def name() self.class.command_name; end
+
+
+
+
+
+def self.inherited( klass )
+  # puts  klass.class.name  #=> Class
+  ## auto-register commands for now - why? why not?
+  Commands.register( klass )
+end
+
+end  # class Command
+
+
+############################
+#  Commands/Commander registry
+class Commands   ## todo/check: use Commander/Command{Index,Registry,...} or such - why? why not?
+
+def self.commands  ## todo/check: change to registry or such - why? why not?
+  @@register ||= {}
+end
+
+def self.register( klass )
+  raise ArgumentError, "class MUST be a Command"   unless klass.ancestors.include?( Command )
+
+  h = commands
+  h[ klass.command_name] = klass
+  h
+end
+
+
+def self.run( args=[] )
+  command_name = args.shift
+
+  ## 1) downcase  e.g. GithubStats
+  ## 2) remove - to _   ## treat them the same e.g. github-stats => github_stats
+  command_name = command_name
+                   .gsub( /[_-]/, '' )
+                   .downcase
+
+  command = commands[ command_name ]
+  if command.nil?
+    puts "!! ERROR: no command definition found for >#{command_name}<; known commands include:"
+    pp commands
+    exit 1
+  end
+
+  command.run( args )
+end
+
+end # class Commands
+
+
+###########################
+## add a alias / alternative name - why? why not
+Commander = Commands
+
+

data/lib/commands-lite/version.rb

@@ -1,5 +1,20 @@
 module CommandsLite
-  VERSION='0.0.1'
-end
 
+  MAJOR = 0    ## todo: namespace inside version or something - why? why not??
+  MINOR = 1
+  PATCH = 0
+  VERSION = [MAJOR,MINOR,PATCH].join('.')
 
+  def self.version
+    VERSION
+  end
+
+  def self.banner
+    "commands-lite/#{VERSION} on Ruby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE}) [#{RUBY_PLATFORM}]"
+  end
+
+  def self.root
+    File.expand_path( File.dirname(File.dirname(File.dirname(__FILE__))) )
+  end
+
+end # module CommandsLite

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: commands-lite
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
 platform: ruby
 authors:
 - Gerald Bauer
@@ -59,6 +59,7 @@ files:
 - README.md
 - Rakefile
 - lib/commands-lite.rb
+- lib/commands-lite/base.rb
 - lib/commands-lite/version.rb
 homepage: https://github.com/rubycoco/git
 licenses: