cliapp 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b398e8d768022a0d3ecaf12d9e63f1d5ada3a18e14f7fa0dcb737f2ec4b55aaf
-  data.tar.gz: d1ec659812a404e055a0b11b873d118012e4090cd51bffa0f3a9639c3f0478b4
+  metadata.gz: a908a368f333d3ad499d7439721fc9c08e9bf0eb7cbb2191acd415de76994b1b
+  data.tar.gz: '08a8841bd44f3a29124c7670079970e11ed23ca5cde7c947f9382178340d7980'
 SHA512:
-  metadata.gz: 98e18468f041be66b58e3ee92523a35b999dc9396fa4d60d6125a9007830dc410bc7cc1d2d3bae69992cc05de0ff7c2a24512ac3d52a642ef1abbacaf04b6a3e
-  data.tar.gz: 220c43cf0dbf9a2db65bdd5d48a0fd02d6f44c9a3379b05673c670d9116bba780f05ac73e06ef9ac1f883a598f417b2ad6f8450159070e627c7b1c4a5ef9f351
+  metadata.gz: '0192d3a964246c898d4fe7f44530fcbe647308ed32b83119e3335be593bd32c74e6dc81da761f4cd5a1d7412957350af5128a4bd189a61c071c4556ab3227009'
+  data.tar.gz: 8b529d1ba95f73939a68b7527a9d5c1ea1aca614d9dea673f24ec37c29741b2fe0271ab264f9529da9aa7e1174838639cb6525de6f55648b23738d5ff57e372d

data/CHANGES.md

@@ -0,0 +1,23 @@
+CHANGES
+=======
+
+
+Release 0.2.0 (2024-10-11)
+--------------------------
+
+* [change] Help message colorized.
+* [enhance] Define `CLIApp#main()`.
+* [change] Skeleton code changed to use `CLIApp#main()`.
+* [enhance] (internal) Define `Util::Color` class.
+
+
+Release 0.1.1 (2024-10-05)
+--------------------------
+
+* [change] Skeleton (example) code simplified.
+
+
+Release 0.1.0 (2024-10-05)
+--------------------------
+
+* First public release

data/README.md

@@ -1,7 +1,7 @@
 CLIApp
 ======
 
-($Version: 0.1.0 $)
+($Version: 0.2.0 $)
 
 CLIApp is a small framework for command-line application.
 If you need to create a CLI app such as Git or Docker, CLIApp is one of the solutions.
@@ -45,7 +45,6 @@ app.global_options({
   :version => [      "--version"   , "print version number"],
   :list    => ["-l", "--list"      , "list action names"],
 })
-APP = app
 
 ## 'hello' action
 app.action("hello", "greeting message", {
@@ -71,18 +70,16 @@ GARBAGE_FILES = []
 PRODUCT_FILES = []
 
 ## main
-def main(argv=ARGV)
-  APP.run(*argv)
-  return 0
-rescue OptionParser::ParseError, CLIApp::ActionError => exc
-  $stderr.puts "[ERROR] #{exc.message}"
-  return 1
-end
-
-if __FILE__ == $0
-  status_code = main(ARGV)
-  exit status_code
-end
+status_code = app.main(ARGV)
+exit status_code
+## or
+#begin
+#  app.run(*ARGV)
+#  exit 0
+#rescue OptionParser::ParseError, CLIApp::ActionError => exc
+#  $stderr.puts "[ERROR] #{exc.message}"
+#  exit 1
+#end
 ```
 
 Output example:

data/cliapp.gemspec

@@ -1,8 +1,9 @@
-# -*- coding: utf-8 -*-
+# encoding: utf-8
+# frozen_string_literal: true
 
 Gem::Specification.new do |spec|
   spec.name            = 'cliapp'
-  spec.version         = '$Version: 0.1.0 $'.split()[1]
+  spec.version         = '$Version: 0.2.0 $'.split()[1]
   spec.author          = 'kwatch'
   spec.email           = 'kwatch@gmail.com'
   spec.platform        = Gem::Platform::RUBY
@@ -12,18 +13,21 @@ Gem::Specification.new do |spec|
 A small framework for CLI Applications such as Git, Docker, NPM, etc.
 END
   spec.license         = 'MIT'
-  spec.files           = Dir[*%w[
-                           README.md MIT-LICENSE Rakefile.rb cliapp.gemspec
-                           lib/**/*.rb
-                           test/**/*.rb
-                           task/**/*.rb
-                         ]]
+  spec.files           = Dir[
+                           'README.md', 'MIT-LICENSE', 'CHANGES.md',
+                           "#{spec.name}.gemspec",
+                           #'Rakefile.rb',
+                           #'bin/*',
+                           'lib/**/*.rb',
+                           'test/**/*.rb',
+                           #'task/**/*.rb',
+                         ]
   spec.executables     = []
   spec.bindir          = 'bin'
   spec.require_path    = 'lib'
-  spec.test_files      = Dir['test/**/*_test.rb']
+  spec.test_files      = ['test/all.rb']   # or: Dir['test/**/*_test.rb']
   #spec.extra_rdoc_files = ['README.md', 'CHANGES.md']
 
-  spec.required_ruby_version = ">= 2.4"
+  spec.required_ruby_version = '>= 2.4'
   spec.add_development_dependency 'oktest', '~> 1.4'
 end

data/lib/cliapp.rb

@@ -1,11 +1,11 @@
-# -*- coding: utf-8 -*-
+# encoding: utf-8
 # frozen_string_literal: true
 
 ##
 ## Command-Line Application Framework
 ##
-## $Version: 0.1.0 $
-## $Copyright: copyright (c)2014 kwatch@gmail.com $
+## $Version: 0.2.0 $
+## $Copyright: copyright(c) 2024 kwatch@gmail.com $
 ## $License: MIT License $
 ##
 
@@ -65,7 +65,7 @@ module CLIApp
       @help_option_width  = help_option_width  || 22
       @help_action_width  = help_action_width  || 22
       @actionlist_width   = actionlist_width   || 16
-      @actionlist_format  = actionlist_format  || nil # ex: "%-#{@actionlist_width}s : %s"
+      @actionlist_format  = actionlist_format  || nil # ex: "%-16s : %s"
     end
 
     attr_accessor :name, :desc, :command, :version
@@ -128,6 +128,24 @@ module CLIApp
       nil
     end
 
+    def main(argv=ARGV, &error_handler)
+      #; [!hopc3] returns 0 if finished successfully.
+      run(*argv)
+      return 0
+    rescue OptionParser::ParseError, CLIApp::ActionError => exc
+      #; [!uwcq7] yields block with error object if error raised.
+      if block_given?()
+        yield exc
+      #; [!e0t6k] reports error into stderr if block not given.
+      else
+        s = "[ERROR]"
+        s = Util::Color.error(s) if $stderr.tty?
+        $stderr.puts "#{s} #{exc.message}"
+      end
+      #; [!d0g0w] returns 1 if error raised.
+      return 1
+    end
+
     def run(*args)
       #; [!qv5fz] parses global options (not parses action options).
       global_opts = parse_global_options(args)
@@ -147,7 +165,8 @@ module CLIApp
       action_opts = parse_action_options(action, args)
       #; [!ehshp] prints action help if action option contains help option.
       if action_opts[:help]
-        print action_help_message(action)
+        #; [!6vet4] decolorizes action help message when stdout is not a tty.
+        print decolorize(action_help_message(action))
         return
       end
       #; [!0nwwe] invokes an action with action args and options.
@@ -157,7 +176,8 @@ module CLIApp
     def handle_global_options(global_opts)
       #; [!6n0w0] when '-h' or '--help' specified, prints help message and returns true.
       if global_opts[:help]
-        print application_help_message()
+        #; [!fadq1] decolorizes app help message when stdout is not a tty.
+        print decolorize(application_help_message())
         return true
       end
       #; [!zii8c] when '-V' or '--version' specified, prints version number and returns true.
@@ -193,22 +213,23 @@ module CLIApp
       }.join()
       optstr = options_str.empty? ? "" : " [<options>]"
       actstr = actions_str.empty? ? "" : " <action> [<arguments>...]"
-      ver = c.version ? " (#{c.version})" : nil
+      cl = Util::Color
+      ver = c.version ? " " + cl.weak("(#{c.version})") : nil
       sb = []
       sb << <<"END"
-#{c.name}#{ver} --- #{c.desc}
+#{cl.strong(c.name)}#{ver} --- #{c.desc}
 
-Usage:
-#{indent}$ #{c.command}#{optstr}#{actstr}
+#{cl.header('Usage:')}
+#{indent}$ #{cl.strong(c.command)}#{optstr}#{actstr}
 END
       sb << (options_str.empty? ? "" : <<"END")
 
-Options:
+#{cl.header('Options:')}
 #{options_str.chomp()}
 END
       sb << (actions_str.empty? ? "" : <<"END")
 
-Actions:
+#{cl.header('Actions:')}
 #{actions_str.chomp()}
 END
       return sb.join()
@@ -221,17 +242,17 @@ END
       options_str = option_help_message(action.option_schema, width: width, indent: indent)
       optstr = options_str.empty? ? "" : " [<options>]"
       argstr = Util.argstr_of_proc(action.block)
-      c = @config
+      c = @config; cl = Util::Color
       sb = []
       sb << <<"END"
-#{c.command} #{action.name} --- #{action.desc}
+#{cl.strong(c.command + ' ' + action.name)} --- #{action.desc}
 
-Usage:
+#{cl.header('Usage:')}
 #{c.help_indent}$ #{c.command} #{action.name}#{optstr}#{argstr}
 END
       sb << (options_str.empty? ? "" : <<"END")
 
-Options:
+#{cl.header('Options:')}
 #{options_str.chomp()}
 END
       return sb.join()
@@ -300,11 +321,17 @@ END
 
     def do_when_action_not_specified(global_opts)
       #; [!w5lq9] prints application help message.
-      print application_help_message()
+      #; [!audam] decolorizes help message when stdout is not a tty.
+      print decolorize(application_help_message())
       #; [!txqnr] returns true which means 'done'.
       return true
     end
 
+    def decolorize(s)
+      #; [!es6ay] decolorizes str if stdout is not a tty.
+      return $stdout.tty? ? s : Util::Color.decolorize(s)
+    end
+
   end
 
 
@@ -362,6 +389,19 @@ END
       return name
     end
 
+
+    module Color
+      module_function
+      def strong(s) ; return "\e[1m#{s}\e[0m"  ; end
+      def weak(s)   ; return "\e[2m#{s}\e[0m"  ; end
+      def header(s) ; return "\e[36m#{s}\e[0m" ; end
+      def error(s)  ; return "\e[31m#{s}\e[0m" ; end
+      def decolorize(s)
+        return s.gsub(/\e\[.*?m/, '')
+      end
+    end
+
+
   end
 
 
@@ -376,7 +416,7 @@ end
 
 __END__
 #!/usr/bin/env ruby
-# coding: utf-8
+# encoding: utf-8
 # frozen_string_literal: true
 
 require 'cliapp'
@@ -390,7 +430,6 @@ app.global_options({
   :version => [      "--version"   , "print version number"],
   :list    => ["-l", "--list"      , "list action names"],
 })
-APP = app
 
 ## 'hello' action
 app.action("hello", "greeting message", {
@@ -416,15 +455,13 @@ GARBAGE_FILES = []
 PRODUCT_FILES = []
 
 ## main
-def main(argv=ARGV)
-  APP.run(*argv)
-  return 0
-rescue OptionParser::ParseError, CLIApp::ActionError => exc
-  $stderr.puts "[ERROR] #{exc.message}"
-  return 1
-end
-
-if __FILE__ == $0
-  status_code = main(ARGV)
-  exit status_code
-end
+status_code = app.main(ARGV)
+exit status_code
+## or
+#begin
+#  app.run(*ARGV)
+#  exit 0
+#rescue OptionParser::ParseError, CLIApp::ActionError => exc
+#  $stderr.puts "[ERROR] #{exc.message}"
+#  exit 1
+#end

data/test/action_test.rb

@@ -1,4 +1,4 @@
-# -*- coding: utf-8 -*-
+# encoding: utf-8
 # frozen_string_literal: true
 
 

data/test/all.rb

@@ -0,0 +1,23 @@
+# encoding: utf-8
+# frozen_string_literal: true
+
+require_relative './init'
+
+testdir = File.dirname(__FILE__)
+Dir.glob(testdir + "/**/*_test.rb").sort.each do |fpath|
+  #require File.absolute_path(fpath)
+  require_relative fpath.sub(testdir, '.')
+end
+
+
+if __FILE__ == $0
+  Oktest.module_eval do
+    ## change default reporting style from 'verbose' to 'plain'
+    if defined?(REPORTER_CLASS)       # Oktest < 1.5
+      remove_const :REPORTER_CLASS
+      const_set :REPORTER_CLASS, Oktest::PlainReporter
+    else                              # Oktst >= 1.5
+      self.DEFAULT_REPORTING_STYLE = "plain"
+    end
+  end
+end

data/test/application_test.rb

@@ -1,4 +1,4 @@
-# -*- coding: utf-8 -*-
+# encoding: utf-8
 # frozen_string_literal: true
 
 
@@ -48,20 +48,21 @@ Oktest.scope do
       app
     end
 
-    APP_HELP = <<'END'
-Sample (0.1.2) --- Sample Application
+    APP_HELP_COLOR = <<"END"
+\e[1mSample\e[0m \e[2m(0.1.2)\e[0m --- Sample Application
 
-Usage:
-  $ sample [<options>] <action> [<arguments>...]
+\e[36mUsage:\e[0m
+  $ \e[1msample\e[0m [<options>] <action> [<arguments>...]
 
-Options:
+\e[36mOptions:\e[0m
   -h, --help             print help message
   -V, --version          print version number
 
-Actions:
+\e[36mActions:\e[0m
   clean                  delete garbage files (& product files too if '-a')
   hello                  greeting message
 END
+    APP_HELP_MONO = APP_HELP_COLOR.gsub(/\e\[.*?m/, '')
 
 
     topic '#global_options()' do
@@ -146,6 +147,50 @@ END
     end
 
 
+    topic '#main()' do
+
+      spec "[!hopc3] returns 0 if finished successfully." do
+        |app|
+        ret = nil
+        capture_stdout do
+          ret = app.main(["hello"])
+        end
+        ok {ret} == 0
+      end
+
+      spec "[!uwcq7] yields block with error object if error raised." do
+        |app|
+        exc = nil
+        app.main(["helloxx"]) do |exc_|
+          exc = exc_
+        end
+        ok {exc}.is_a?(CLIApp::ActionNotFoundError)
+        ok {exc.message} == "helloxx: Action not found."
+      end
+
+      spec "[!e0t6k] reports error into stderr if block not given." do
+        |app|
+        serr = capture_stderr do
+          app.main(["helloxx"])
+        end
+        ok {serr} == "[ERROR] helloxx: Action not found.\n"
+      end
+
+      spec "[!d0g0w] returns 1 if error raised." do
+        |app|
+        ret = app.main(["helloxx"]) do end
+        ok {ret} == 1
+        #
+        ret = nil
+        capture_stderr do
+          ret = app.main(["helloxx"])
+        end
+        ok {ret} == 1
+      end
+
+    end
+
+
     topic '#run()' do
 
       spec "[!qv5fz] parses global options (not parses action options)." do
@@ -166,7 +211,7 @@ END
 
       spec "[!j029i] prints help message if no action name specified." do
         |app|
-        sout = capture_stdout { app.run() }
+        sout = capture_stdout(tty: false) { app.run() }
         ok {sout} =~ /^Sample \(0\.1\.2\) --- Sample Application$/
       end
 
@@ -187,7 +232,15 @@ END
 
       spec "[!ehshp] prints action help if action option contains help option." do
         |app|
-        sout = capture_stdout do
+        sout = capture_stdout(tty: true) do
+          app.run("hello", "Alice", "--help")
+        end
+        ok {sout} =~ /^\e\[1msample hello\e\[0m --- greeting message$/
+      end
+
+      spec "[!6vet4] decolorizes action help message when stdout is not a tty." do
+        |app|
+        sout = capture_stdout(tty: false) do
           app.run("hello", "Alice", "--help")
         end
         ok {sout} =~ /^sample hello --- greeting message$/
@@ -209,10 +262,20 @@ END
       spec "[!6n0w0] when '-h' or '--help' specified, prints help message and returns true." do
         |app|
         ret = nil
-        sout = capture_stdout do
+        sout = capture_stdout(tty: true) do
           ret = app.handle_global_options({help: true})
         end
-        ok {sout} =~ /^Sample \(0\.1\.2\) --- Sample Application$/
+        ok {sout} == APP_HELP_COLOR
+        ok {ret} == true
+      end
+
+      spec "[!fadq1] decolorizes app help message when stdout is not a tty." do
+        |app|
+        ret = nil
+        sout = capture_stdout(tty: false) do
+          ret = app.handle_global_options({help: true})
+        end
+        ok {sout} == APP_HELP_MONO
         ok {ret} == true
       end
 
@@ -271,35 +334,37 @@ END
 
       spec "[!p02s2] builds application help message." do
         |app|
-        ok {app.application_help_message()} == APP_HELP
+        ok {app.application_help_message()} == APP_HELP_COLOR
       end
 
       spec "[!41l2g] includes version number if it is specified." do
         |app|
         ok {app.config.version} == "0.1.2"
-        ok {app.application_help_message()} =~ /^Sample \(0\.1\.2\) ---/
+        ok {app.application_help_message()} =~ /^\e\[1mSample\e\[0m \e\[2m\(0\.1\.2\)\e\[0m ---/
         app2 = CLIApp.new("Sample", "Sample App", command: "sample", version: nil)
-        ok {app2.application_help_message()} =~ /^Sample ---/
+        ok {app2.application_help_message()} =~ /^\e\[1mSample\e\[0m ---/
       end
 
       spec "[!2eycw] includes 'Options:' section if any global options exist." do
         |app|
-        ok {app.application_help_message()} =~ /^Options:$/
-        ok {app.application_help_message()} =~ /^  \$ sample \[<options>\] <action> \[<arguments>\.\.\.\]$/
+        header_rexp = /^\e\[36mOptions:\e\[0m$/
+        ok {app.application_help_message()} =~ header_rexp
+        ok {app.application_help_message()} =~ /^  \$ \e\[1msample\e\[0m \[<options>\] <action> \[<arguments>\.\.\.\]$/
         app2 = CLIApp.new("Sample", "Sample App", command: "sample", version: nil)
         app2.action("hello", "Hello") do end
-        ok {app2.application_help_message()} !~ /^Options:$/
-        ok {app2.application_help_message()} =~ /^  \$ sample <action> \[<arguments>\.\.\.\]$/
+        ok {app2.application_help_message()} !~ header_rexp
+        ok {app2.application_help_message()} =~ /^  \$ \e\[1msample\e\[0m <action> \[<arguments>\.\.\.\]$/
       end
 
       spec "[!x3dim] includes 'Actions:' section if any actions defined." do
         |app|
-        ok {app.application_help_message()} =~ /^Actions:$/
-        ok {app.application_help_message()} =~ /^  \$ sample \[<options>\] <action> \[<arguments>\.\.\.\]$/
+        header_rexp = /^\e\[36mActions:\e\[0m$/
+        ok {app.application_help_message()} =~ header_rexp
+        ok {app.application_help_message()} =~ /^  \$ \e\[1msample\e\[0m \[<options>\] <action> \[<arguments>\.\.\.\]$/
         app2 = CLIApp.new("Sample", "Sample App", command: "sample", version: nil)
         app2.global_options({:version=>["-V", "version"]})
-        ok {app2.application_help_message()} !~ /^Actions:$/
-        ok {app2.application_help_message()} =~ /^  \$ sample \[<options>\]$/
+        ok {app2.application_help_message()} !~ header_rexp
+        ok {app2.application_help_message()} =~ /^  \$ \e\[1msample\e\[0m \[<options>\]$/
       end
 
       spec "[!vxcin] help message will be affcted by config." do
@@ -307,17 +372,17 @@ END
         app.config.help_indent = "  | "
         app.config.help_option_width = 14
         app.config.help_action_width = 6
-        ok {app.application_help_message()} == <<'END'
-Sample (0.1.2) --- Sample Application
+        ok {app.application_help_message()} == <<"END"
+\e[1mSample\e[0m \e[2m(0.1.2)\e[0m --- Sample Application
 
-Usage:
-  | $ sample [<options>] <action> [<arguments>...]
+\e[36mUsage:\e[0m
+  | $ \e[1msample\e[0m [<options>] <action> [<arguments>...]
 
-Options:
+\e[36mOptions:\e[0m
   | -h, --help     print help message
   | -V, --version  print version number
 
-Actions:
+\e[36mActions:\e[0m
   | clean  delete garbage files (& product files too if '-a')
   | hello  greeting message
 END
@@ -328,26 +393,27 @@ END
 
     topic '#action_help_message()' do
 
-      ACTION_HELP = <<'END'
-sample hello --- greeting message
+      ACTION_HELP_COLOR = <<"END"
+\e[1msample hello\e[0m --- greeting message
 
-Usage:
+\e[36mUsage:\e[0m
   $ sample hello [<options>] [<name>]
 
-Options:
+\e[36mOptions:\e[0m
   -l, --lang=<en|fr|it>  language
 END
+      ACTION_HELP_MONO = ACTION_HELP_COLOR.gsub(/\e\[.*?m/, '')
 
       spec "[!ny72g] build action help message." do
         |app|
         action = app.get_action(:hello)
-        ok {app.action_help_message(action)} == ACTION_HELP
+        ok {app.action_help_message(action)} == ACTION_HELP_COLOR
       end
 
       spec "[!pr2vy] includes 'Options:' section if any options exist." do
         |app|
         hello = app.get_action(:hello)
-        ok {app.action_help_message(hello)} =~ /^Options:$/
+        ok {app.action_help_message(hello)} =~ /^\e\[36mOptions:\e\[0m$/
         ok {app.action_help_message(hello)} =~ /^  \$ sample hello \[<options>\] \[<name>\]$/
         clean = app.get_action(:clean)
         ok {app.action_help_message(clean)} !~ /^Options:$/
@@ -359,13 +425,13 @@ END
         app.config.help_indent = " | "
         app.config.help_option_width = 25
         hello = app.get_action(:hello)
-        ok {app.action_help_message(hello)} == <<'END'
-sample hello --- greeting message
+        ok {app.action_help_message(hello)} == <<"END"
+\e[1msample hello\e[0m --- greeting message
 
-Usage:
+\e[36mUsage:\e[0m
  | $ sample hello [<options>] [<name>]
 
-Options:
+\e[36mOptions:\e[0m
  | -l, --lang=<en|fr|it>     language
 END
       end
@@ -519,12 +585,22 @@ END
 
       spec "[!w5lq9] prints application help message." do
         |app|
-        sout = capture_stdout() do
+        sout = capture_stdout(tty: true) do
           app.instance_eval do
             do_when_action_not_specified({})
           end
         end
-        ok {sout} == APP_HELP
+        ok {sout} == APP_HELP_COLOR
+      end
+
+      spec "[!audam] decolorizes help message when stdout is not a tty." do
+        |app|
+        sout = capture_stdout(tty: false) do
+          app.instance_eval do
+            do_when_action_not_specified({})
+          end
+        end
+        ok {sout} == APP_HELP_MONO
       end
 
       spec "[!txqnr] returns true which means 'done'." do
@@ -541,6 +617,24 @@ END
     end
 
 
+    topic '#decolorize()' do
+
+      spec "[!es6ay] decolorizes str if stdout is not a tty." do
+        |app|
+        str = "\e[36mABC\e[0mDEF\e[1mGHI\e[0m"
+        capture_stdout(tty: false)  do
+          s = app.instance_eval { decolorize(str) }
+          ok {s} == "ABCDEFGHI"
+        end
+        capture_stdout(tty: true)  do
+          s = app.instance_eval { decolorize(str) }
+          ok {s} == str
+        end
+      end
+
+    end
+
+
   end
 
 

data/test/init.rb

@@ -1,11 +1,17 @@
-# -*- coding: utf-8 -*-
+# encoding: utf-8
 # frozen_string_literal: true
 
 require 'oktest'
 
+testdir = File.dirname(__FILE__)
+libdir  = File.absolute_path(File.dirname(testdir) + "/lib")
+$LOAD_PATH << libdir unless $LOAD_PATH.include?(libdir)
+
 require 'cliapp'
 
 
 Oktest.global_scope do
 
+  ## define global fixtures here
+
 end

data/test/module_test.rb

@@ -1,4 +1,4 @@
-# -*- coding: utf-8 -*-
+# encoding: utf-8
 # frozen_string_literal: true
 
 
@@ -67,19 +67,20 @@ END
         ok {str}.is_a?(String)
         filename = "tmp.sample"
         dummy_file(filename, str)
+        ruby = "#{RbConfig.ruby} -Ilib"
         #
-        sout, serr = capture_command "ruby #{filename} --help"
+        sout, serr = capture_command "#{ruby} #{filename} --help"
         ok {serr} == ""
         ok {sout} == GLOBAL_HELP
         #
-        sout, serr = capture_command "ruby #{filename} hello --help"
+        sout, serr = capture_command "#{ruby} #{filename} hello --help"
         ok {serr} == ""
         ok {sout} == HELLO_HELP
         #
-        sout, serr = capture_command "ruby #{filename} hello"
+        sout, serr = capture_command "#{ruby} #{filename} hello"
         ok {serr} == ""
         ok {sout} == "Hello, world!\n"
-        sout, serr = capture_command "ruby #{filename} hello Alice --lang=fr"
+        sout, serr = capture_command "#{ruby} #{filename} hello Alice --lang=fr"
         ok {serr} == ""
         ok {sout} == "Bonjour, Alice!\n"
       end

data/test/util_test.rb

@@ -1,4 +1,4 @@
-# -*- coding: utf-8 -*-
+# encoding: utf-8
 # frozen_string_literal: true
 
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cliapp
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - kwatch
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-10-04 00:00:00.000000000 Z
+date: 2024-10-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: oktest
@@ -26,20 +26,19 @@ dependencies:
         version: '1.4'
 description: 'A small framework for CLI Applications such as Git, Docker, NPM, etc.
 
-  '
+'
 email: kwatch@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGES.md
 - MIT-LICENSE
 - README.md
-- Rakefile.rb
 - cliapp.gemspec
 - lib/cliapp.rb
-- task/common-task.rb
-- task/release-task.rb
 - test/action_test.rb
+- test/all.rb
 - test/application_test.rb
 - test/init.rb
 - test/module_test.rb
@@ -48,7 +47,7 @@ homepage: https://github.com/kwatch/cliapp-ruby
 licenses:
 - MIT
 metadata: {}
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -64,11 +63,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubygems_version: 3.0.3.1
-signing_key:
+signing_key: 
 specification_version: 4
 summary: CLI Application Framework
 test_files:
-- test/module_test.rb
-- test/util_test.rb
-- test/action_test.rb
-- test/application_test.rb
+- test/all.rb

data/Rakefile.rb

@@ -1,9 +0,0 @@
-# -*- coding: utf-8 -*-
-
-
-PROJECT  = "cliapp"
-SPECFILE = PROJECT + ".gemspec"
-
-RUBY_VERSIONS = %w[3.3 3.2 3.1 3.0 2.7 2.6 2.5 2.4]
-
-Dir.glob("./task/*-task.rb").each {|x| require x }

data/task/common-task.rb

@@ -1,67 +0,0 @@
-# -*- coding: utf-8 -*-
-
-
-task :default => :help    # or :test if you like
-
-
-desc "list task names"
-task :help do
-  system "rake -T"
-end
-
-
-desc "show how to release"
-task :howto, [:version] do |t, args|
-  ver = args[:version] || ENV['version'] || "0.0.0"
-  zero_p = ver.end_with?('.0')
-  opt_b = zero_p ? " -b" : ""
-  puts <<"END"
-How to release:
-
-  $ git diff            	# confirm that there is no changes
-  $ rake test
-  $ rake test:all       	# test on Ruby 2.x ~ 3.x
-  $ git checkout#{opt_b} rel-#{ver[0..-3]}	# create or switch to release branch
-  $ vi CHANGES.md       	# if necessary
-  $ git add CHANGES.md       	# if necessary
-  $ git commit -m "Update 'CHANGES.md'"	# if necessary
-  $ git log -1          	# if necessary
-  $ cid=$(git log -1 | awk 'NR==1{print $2}')	# if necessary
-  $ rake prepare[#{ver}] 	# update release number
-  $ git add -u .        	# add changes
-  $ git status -sb .    	# list files in staging area
-  $ git commit -m "Preparation for release #{ver}"
-  $ rake package        	# create a gem package
-  $ rake release[#{ver}]	# upload to rubygems.org
-  $ git push -u origin
-  $ git tag | fgrep #{ver}	# confirm release tag
-  $ git push --tags
-  $ git checkout -      	# back to main branch
-  $ git log -1 $cid     	# if necessary
-  $ git cherry-pick $cid	# if necessary
-
-END
-end
-
-
-desc "run test scripts"
-task :test do
-  $LOAD_PATH << File.join(File.dirname(__FILE__), "lib")
-  sh "oktest test -sp"
-end
-
-
-desc "run test scripts on Ruby 2.x and 3.x"
-task :'test:all' do
-  vs_home = ENV['VS_HOME']  or raise "$VS_HOME should be set."
-  defined?(RUBY_VERSIONS)  or raise "RUBY_VERSIONS should be defined."
-  $LOAD_PATH << File.join(File.dirname(__FILE__), "lib")
-  RUBY_VERSIONS.each do |ver|
-    path_pat = "#{vs_home}/ruby/#{ver}.*/bin/ruby"
-    ruby_path = Dir.glob(path_pat).sort.last()  or
-      raise "#{path_pat}: Not exist."
-    puts "\e[33m======== Ruby #{ver} ========\e[0m"
-    sh "#{ruby_path} -r oktest -e 'Oktest.main' -- test -sp" do end
-    puts ""
-  end
-end

data/task/release-task.rb

@@ -1,77 +0,0 @@
-# -*- coding: utf-8 -*-
-
-
-desc "update version number"
-task :prepare, [:version] do |t, args|
-  version = version_number_required(args, :prepare)
-  spec = load_gemspec_file(SPECFILE)
-  edit(spec.files) {|s|
-    s.gsub(/\$Version\:.*?\$/,   "$Version\: #{version} $") \
-     .gsub(/\$Version\$/,        version)
-  }
-end
-
-
-desc "create gem package"
-task :package do
-  sh "gem build #{SPECFILE}"
-end
-
-
-desc "upload gem to rubygems.org"
-task :release, [:version] => :package do |t, args|
-  version = version_number_required(args, :release)
-  spec = load_gemspec_file(SPECFILE)
-  version == spec.version.to_s  or
-    raise "Version in gemspec file (#{spec.version}) is different from #{version}"
-  gemfile = "#{PROJECT}-#{version}.gem"
-  print "*** Are you sure to upload #{gemfile}? [y/N]: "
-  answer = $stdin.gets().strip()
-  if answer =~ /\A[yY]/
-    sh "git tag v#{version}"
-    #sh "git tag rel-#{version}"
-    sh "gem push #{gemfile}"
-  end
-end
-
-
-##
-## helpers
-##
-
-def edit(*filepaths)
-  filepaths.flatten.each do |fpath|
-    next if ! File.file?(fpath)
-    File.open(fpath, 'r+b:utf-8') do |f|
-      s = f.read()
-      new_s = yield s
-      if new_s != s
-        f.rewind()
-        f.truncate(0)
-        f.write(new_s)
-        puts "[Change] #{fpath}"
-      end
-    end
-  end
-end
-
-def load_gemspec_file(gemspec_file)
-  require 'rubygems'
-  return Gem::Specification::load(gemspec_file)
-end
-
-def version_number_required(args, task_name)
-  version = args[:version] || ENV['version']
-  unless version
-    $stderr.puts <<"END"
-##
-## ERROR: rake #{task_name}: requires 'version=X.X.X' option.
-##        For example:
-##           $ rake #{task_name} version=1.0.0
-##
-END
-    errmsg = "rake #{task_name}: requires 'version=X.X.X' option."
-    raise ArgumentError.new(errmsg)
-  end
-  return version
-end