cl 0.0.4 → 0.1.0

metadata

@@ -1,46 +1,69 @@
 --- !ruby/object:Gem::Specification
 name: cl
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.1.0
 platform: ruby
 authors:
 - Sven Fuchs
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-08-02 00:00:00.000000000 Z
-dependencies: []
+date: 2019-05-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: regstry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.3
 description: OptionParser based CLI support.
 email: 
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
 - Gemfile
 - Gemfile.lock
 - MIT_LICENSE.md
 - NOTES.md
 - README.md
-- examples/args/cast.rb
-- examples/args/opts.rb
-- examples/args/required.rb
-- examples/args/splat.rb
-- examples/gem.rb
-- examples/heroku.rb
-- examples/multi.rb
+- examples/args/cast
+- examples/args/opts
+- examples/args/required
+- examples/args/splat
+- examples/gem
+- examples/heroku
+- examples/rakeish
 - lib/cl.rb
 - lib/cl/arg.rb
 - lib/cl/args.rb
+- lib/cl/cast.rb
 - lib/cl/cmd.rb
-- lib/cl/format/cmd.rb
-- lib/cl/format/list.rb
-- lib/cl/format/table.rb
-- lib/cl/format/usage.rb
+- lib/cl/config.rb
+- lib/cl/config/env.rb
+- lib/cl/config/files.rb
+- lib/cl/ctx.rb
 - lib/cl/help.rb
-- lib/cl/options.rb
-- lib/cl/registry.rb
+- lib/cl/help/cmd.rb
+- lib/cl/help/cmds.rb
+- lib/cl/help/table.rb
+- lib/cl/help/usage.rb
+- lib/cl/helper.rb
+- lib/cl/opt.rb
+- lib/cl/opts.rb
+- lib/cl/parser.rb
 - lib/cl/runner/default.rb
 - lib/cl/runner/multi.rb
+- lib/cl/ui.rb
 - lib/cl/version.rb
 homepage: https://github.com/svenfuchs/cl
 licenses:
@@ -61,8 +84,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.11
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: OptionParser based CLI support

data/examples/args/cast.rb

@@ -1,63 +0,0 @@
-require 'cl'
-
-class Bool < Cl::Cmd
-  arg :bool, type: :bool
-
-  def run
-    [self.registry_key, bool: bool]
-  end
-end
-
-class Types < Cl::Cmd
-  arg :a, type: :bool
-  arg :b, type: :int
-  arg :c, type: :float
-  arg :d
-
-  def run
-    [self.registry_key, a: a, b: b, c: c, d: d]
-  end
-end
-
-def output(cmd, args)
-  args = args.map { |key, value| "#{key}=#{value.inspect}" }.join(' ')
-  puts "Called #{cmd} with #{args}"
-end
-
-output *Cl.run(*%w(bool on))
-# Output:
-# Called bool with bool=true
-
-output *Cl.run(*%w(bool on))
-# Output:
-# Called bool with bool=true
-
-output *Cl.run(*%w(bool on))
-# Output:
-# Called bool with bool=true
-
-output *Cl.run(*%w(bool on))
-# Output:
-# Called bool with bool=true
-
-output *Cl.run(*%w(types true 1 1.2 foo))
-# Output:
-# Called types with a=true b=1 c=1.2 d="foo"
-
-output *Cl.run(*%w(types true 1 1.2))
-# Output:
-# Too many arguments (given: 5, allowed: 4)
-#
-# Usage: cast.rb types [a (bool)] [b (int)] [c (float)] [d]
-
-output *Cl.run(*%w(types true one 1.2))
-# Output:
-# Wrong argument type (given: "one", expected: int)
-#
-# Usage: cast.rb types [a (bool)] [b (int)] [c (float)] [d]
-
-output *Cl.run(*%w(types true 1 one))
-# Output:
-# Wrong argument type (given: "one", expected: float)
-#
-# Usage: cast.rb types [a (bool)] [b (int)] [c (float)] [d]

data/examples/args/opts.rb

@@ -1,32 +0,0 @@
-require 'cl'
-
-class Opts < Cl::Cmd
-  opt '-p', '--path PATH' do |value|
-    opts[:path] = value
-  end
-
-  opt '-v', '--verbose' do
-    opts[:verbose] = true
-  end
-
-  def run
-    [self.registry_key, args, opts]
-  end
-end
-
-def output(cmd, args, opts)
-  puts "Called #{cmd} with args=#{args} opts=#{opts}"
-end
-
-output *Cl.run(*%w(opts -p path -v))
-# Output:
-# Called cast with args=[] opts={:path=>"path", :verbose=>true}
-
-output *Cl.run(*%w(opts --path path --verbose))
-# Output:
-# Called cast with args=[] opts={:path=>"path", :verbose=>true}
-
-output *Cl.run(*%w(opts one -p path two -v three))
-# Output:
-# Called cast with args=["one", "two", "three"] opts={:path=>"path", :verbose=>true}
-

data/examples/args/required.rb

@@ -1,35 +0,0 @@
-require 'cl'
-
-class Required < Cl::Cmd
-  arg :one, required: true
-  arg :two
-
-  def run
-    [self.registry_key, one: one, two: two]
-  end
-end
-
-def output(cmd, args)
-  args = args.map { |key, value| "#{key}=#{value.inspect}" }.join(' ')
-  puts "Called #{cmd} with #{args}"
-end
-
-output *Cl.run(*%w(required one two))
-# Output:
-# Called required with one="one" two="two"
-
-output *Cl.run(*%w(required one))
-# Output:
-# Called required with one="one" two=nil
-
-output *Cl.run(*%w(required))
-# Output:
-# Missing arguments (given: 0, required: 1)
-#
-# Usage: args.rb required one [two]
-
-output *Cl.run(*%w(required one two three))
-# Output:
-# Too many arguments (given: 3, allowed: 2)
-#
-# Usage: args.rb required one [two]

data/examples/args/splat.rb

@@ -1,52 +0,0 @@
-require 'cl'
-
-class SplatLeft < Cl::Cmd
-  register 'splat:left'
-
-  arg :one, type: :array
-  args :two, :three
-
-  def run
-    [self.registry_key, one: one, two: two, three: three]
-  end
-end
-
-class SplatMiddle < Cl::Cmd
-  register 'splat:middle'
-
-  arg :one
-  arg :two, type: :array
-  arg :three
-
-  def run
-    [self.registry_key, one: one, two: two, three: three]
-  end
-end
-
-class SplatRight < Cl::Cmd
-  register 'splat:right'
-
-  args :one, :two
-  arg :three, type: :array
-
-  def run
-    [self.registry_key, one: one, two: two, three: three]
-  end
-end
-
-def output(cmd, args)
-  args = args.map { |key, value| "#{key}=#{value.inspect}" }.join(' ')
-  puts "Called #{cmd} with #{args}"
-end
-
-output *Cl.run(*%w(splat left foo bar baz buz))
-# Output:
-# Called splat:left with one=["foo", "bar"] two="baz" three="buz"
-
-output *Cl.run(*%w(splat middle foo bar baz buz))
-# Output:
-# Called splat:middle with one="foo" two=["bar", "baz"] three="buz"
-
-output *Cl.run(*%w(splat right foo bar baz buz))
-# Output:
-# Called splat:middle with one="foo" two="bar" three=["baz", "buz"]

data/examples/gem.rb

@@ -1,81 +0,0 @@
-require 'cl'
-
-module Gem
-  module Release
-    module Cmds
-      class Release < Cl::Cmd
-        arg :gemspec
-
-        opt '-h', '--host HOST' do |value|
-          opts[:host] = value
-        end
-
-        opt '-k', '--key KEY' do |value|
-          opts[:key] = value
-        end
-
-        opt '-q', '--quiet' do
-          opts[:version] = true
-        end
-
-        def run
-          [self.registry_key, args, opts]
-        end
-      end
-
-      class Bump < Cl::Cmd
-        OPTS = {
-          commit: true
-        }
-
-        opt '-v', '--version VERSION', 'the version to bump to [1.1.1|major|minor|patch|pre|rc|release]' do  |value|
-          opts[:version] = value
-        end
-
-        opt '--no-commit', 'bump the version, but do not commit' do
-          opts[:commit] = false
-        end
-
-        def run
-          [self.registry_key, args, opts]
-        end
-      end
-    end
-  end
-end
-
-Cl.runner = :multi
-Cl.run(*%w(help))
-puts
-
-# Type "gem.rb help COMMAND [SUBCOMMAND]" for more details:
-#
-# gem.rb release [gemspec] [options]
-# gem.rb bump [options]
-
-Cl.run(*%w(help release))
-puts
-
-# Usage: gem.rb release [gemspec] [options]
-#
-# -h --host HOST
-# -k --key KEY
-# -q --quiet
-
-Cl.run(*%w(help bump))
-puts
-
-# Usage: gem.rb bump [options]
-#
-# -v --version VERSION # the version to bump to [1.1.1|major|minor|patch|pre|rc|release]
-# --no-commit          # bump the version, but do not commit
-
-cmds = Cl.run(*%w(bump -v 1.1.1 release foo.gemspec -h host -k key -q))
-puts 'Commands run:'
-cmds.each do |(cmd, args, opts)|
-  puts "#{cmd} with args=#{args} opts=#{opts}"
-end
-
-# Commands run:
-# bump with args=[] opts={:version=>"1.1.1"}
-# release with args=["foo.gemspec"] opts={:host=>"host", :key=>"key", :version=>true}

data/examples/heroku.rb

@@ -1,41 +0,0 @@
-require 'cl'
-
-module Heroku
-  module Apps
-    class Create < Cl::Cmd
-      register 'apps:create'
-
-      arg :name, required: true
-
-      opt '-o', '--org ORG' do |value|
-        opts[:org] = value
-      end
-
-      def run; [registry_key, args, opts] end
-    end
-
-    class List < Cl::Cmd
-      register 'apps:info'
-
-      opt '-a', '--app APP' do |value|
-        opts[:app] = value
-      end
-
-      def run; [registry_key, args, opts] end
-    end
-  end
-end
-
-def output(cmd, args, opts)
-  puts "Called #{cmd} with args=#{args} opts=#{opts}"
-end
-
-output *Cl.run(*%w(apps:create name -o org))
-# Called apps:create with args=["name"] opts={:org=>"org"}
-
-output *Cl.run(*%w(apps create name -o org))
-# Called apps:create with args=["name"] opts={:org=>"org"}
-
-output *Cl.run(*%w(apps:info -a app))
-# Called apps:create with args=["app"] opts={}
-

data/lib/cl/format/cmd.rb

@@ -1,31 +0,0 @@
-require 'cl/format/table'
-require 'cl/format/usage'
-
-module Cl
-  class Format
-    class Cmd < Struct.new(:cmd)
-      def format
-        [banner, Table.new(opts).format].join("\n")
-      end
-
-      def banner
-        banner = []
-        banner << "#{cmd.purpose}\n" if cmd.purpose
-        banner << "Usage: #{Usage.new(cmd).format}\n"
-        banner
-      end
-
-      def opts
-        cmd.opts.map do |opts, block|
-          comment = opts.detect { |opt| !opt?(opt) }
-          opts = opts.select { |opt| opt?(opt) }
-          [opts.sort_by(&:size).join(' '), comment]
-        end
-      end
-
-      def opt?(str)
-        str.start_with?('-')
-      end
-    end
-  end
-end

data/lib/cl/format/list.rb

@@ -1,22 +0,0 @@
-require 'cl/format/table'
-require 'cl/format/usage'
-
-module Cl
-  class Format
-    class List < Struct.new(:cmds)
-      HEAD = %(Type "#{$0.split('/').last} help COMMAND [SUBCOMMAND]" for more details:\n)
-
-      def format
-        [HEAD, Format::Table.new(list).format].join("\n")
-      end
-
-      def list
-        cmds.map { |cmd| format_cmd(cmd) }
-      end
-
-      def format_cmd(cmd)
-        ["#{Usage.new(cmd).format}", cmd.purpose]
-      end
-    end
-  end
-end

data/lib/cl/format/table.rb

@@ -1,19 +0,0 @@
-module Cl
-  class Format
-    class Table < Struct.new(:data, :separator)
-      def format
-        rows.join("\n")
-      end
-
-      def rows
-        rows = data.map { |lft, rgt| [lft.ljust(width), rgt] }
-        rows = rows.map { |lft, rgt| "#{lft} #{"# #{rgt}" if rgt}".strip }
-        rows.map(&:strip)
-      end
-
-      def width
-        @width ||= data.map(&:first).max_by(&:size).size
-      end
-    end
-  end
-end

data/lib/cl/options.rb

@@ -1,13 +0,0 @@
-require 'optparse'
-
-module Cl
-  class Options < OptionParser
-    attr_reader :opts
-
-    def initialize(opts, args)
-      @opts = {}
-      super { opts.each { |args, block| on(*args) { |*args| instance_exec(*args, &block) } } }
-      parse!(args)
-    end
-  end
-end

data/lib/cl/registry.rb

@@ -1,53 +0,0 @@
-module Cl
-  class << self
-    def []=(key, object)
-      registry[key.to_sym] = object
-    end
-
-    def [](key)
-      key && registry[key.to_sym]
-    end
-
-    def cmds
-      registry.values
-    end
-
-    def registry
-      @registry ||= {}
-    end
-  end
-
-  module Registry
-    class << self
-      def included(const)
-        const.send(:extend, ClassMethods)
-        const.send(:include, InstanceMethods)
-      end
-    end
-
-    module ClassMethods
-      attr_reader :registry_key
-
-      def [](key)
-        Cl[key.to_sym]
-      end
-
-      def register(key)
-        Cl[key] = self
-        @registry_key = key.to_sym
-      end
-
-      def underscore(string)
-        string.gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2').
-        gsub(/([a-z\d])([A-Z])/,'\1_\2').
-        downcase
-      end
-    end
-
-    module InstanceMethods
-      def registry_key
-        self.class.registry_key
-      end
-    end
-  end
-end