travis-cl 1.2.4

data/examples/_src/readme/args_splat.erb.rb

@@ -0,0 +1,55 @@
+#!/usr/bin/env ruby
+$: << File.expand_path('lib')
+
+<%= run sq(<<-'rb')
+    require 'cl'
+
+    class Lft < Cl::Cmd
+      register :lft
+
+      arg :a, type: :array, splat: true
+      arg :b
+      arg :c
+
+      def run
+        p [a, b, c]
+      end
+    end
+
+    class Mid < Cl::Cmd
+      register :mid
+
+      arg :a
+      arg :b, type: :array, splat: true
+      arg :c
+
+      def run
+        p [a, b, c]
+      end
+    end
+
+    class Rgt < Cl::Cmd
+      register :rgt
+
+      arg :a
+      arg :b
+      arg :c, type: :array, splat: true
+
+      def run
+        p [a, b, c]
+      end
+    end
+  rb
+-%>
+
+<%= run "Cl.new('splat').run(%w(lft 1 2 3 4 5))" %>
+
+<%= out '[["1", "2", "3"], "4", "5"]' %>
+
+<%= run "Cl.new('splat').run(%w(mid 1 2 3 4 5))" %>
+
+<%= out '["1", ["2", "3", "4"], "5"]' %>
+
+<%= run "Cl.new('splat').run(%w(rgt 1 2 3 4 5))" %>
+
+<%= out '["1", "2", ["3", "4", "5"]]' %>

data/examples/_src/readme/array.erb.rb

@@ -0,0 +1,21 @@
+#!/usr/bin/env ruby
+$: << File.expand_path('lib')
+
+<%= run sq(<<-'rb')
+    require 'cl'
+
+    class Add < Cl::Cmd
+      register :add
+
+      opt '--to GROUP', type: :array
+
+      def run
+        p to
+      end
+    end
+  rb
+-%>
+
+<%= run "Cl.new('owners').run(%w(add --to one --to two))" %>
+
+<%= out '["one", "two"]' %>

data/examples/_src/readme/basic.erb.rb

@@ -0,0 +1,72 @@
+<%= run sq(<<-'rb')
+  require 'cl'
+
+  # e.g. lib/owners/add.rb
+  module Owners
+    class Add < Cl::Cmd
+      register :add
+
+      summary 'Add one or more owners to an existing owner group'
+
+      description <<~str
+        Use this command to add one or more owners to an existing
+        owner group.
+
+        [...]
+      str
+
+      args :owner
+
+      opt '-t', '--to TO', 'An existing owner group'
+
+      def run
+        # implement adding the owner as given in `owner` (as well as `args`)
+        # to the group given in `to` (as well as `opts[:to]`).
+        p owner: owner, to: to, to?: to?, args: args, opts: opts
+      end
+    end
+  end
+  rb
+-%>
+
+# Running this, e.g. using `bin/owners add one,two --to group` will instantiate the
+# class `Owners::Add`, and call the method `run` on it.
+
+<%= run sq(<<-'rb')
+  # e.g. bin/owners
+  #
+  # args normally would be ARGV
+  args = %w(add one --to group)
+
+  Cl.new('owners').run(args)
+  rb
+-%>
+
+<%= out '{:owner=>"one", :to=>"group", :to?=>true, :args=>["one"], :opts=>{:to=>"group"}}' %>
+
+<%= run "Cl.new('owners').run(%w(add --help))" %>
+
+<%= out sq(<<-'str')
+  Usage: owners add [owner] [options]
+
+  Summary:
+
+    Add one or more owners to an existing owner group
+
+  Description:
+
+    Use this command to add one or more owners to an existing
+    owner group.
+
+    [...]
+
+  Arguments:
+
+    owner           type: string
+
+  Options:
+
+    -t --to TO      An existing owner group (type: string)
+       --help       Get help on this command
+  str
+%>

data/examples/_src/readme/default.erb.rb

@@ -0,0 +1,21 @@
+#!/usr/bin/env ruby
+$: << File.expand_path('lib')
+
+<%= run sq(<<-'rb')
+    require 'cl'
+
+    class Add < Cl::Cmd
+      register :add
+
+      opt '--to GROUP', default: 'default'
+
+      def run
+        p to: to
+      end
+    end
+  rb
+-%>
+
+<%= run "Cl.new('owners').run(%w(add))" %>
+
+<%= out '{:to=>"default"}' %>

data/examples/_src/readme/deprecated.erb.rb

@@ -0,0 +1,21 @@
+#!/usr/bin/env ruby
+$: << File.expand_path('lib')
+
+<%= run sq(<<-'rb')
+    require 'cl'
+
+    class Add < Cl::Cmd
+      register :add
+
+      opt '--target GROUP', deprecated: 'Deprecated.'
+
+      def run
+        p target: target, deprecations: deprecations
+      end
+    end
+  rb
+-%>
+
+<%= run "Cl.new('owners').run(%w(add --target one))" %>
+
+<%= out '{:target=>"one", :deprecations=>{:target=>"Deprecated."}}' %>

data/examples/_src/readme/deprecated_alias.erb.rb

@@ -0,0 +1,21 @@
+#!/usr/bin/env ruby
+$: << File.expand_path('lib')
+
+<%= run sq(<<-'rb')
+    require 'cl'
+
+    class Add < Cl::Cmd
+      register :add
+
+      opt '--to GROUP', alias: :target, deprecated: :target
+
+      def run
+        p to: to, deprecations: deprecations
+      end
+    end
+  rb
+-%>
+
+<%= run "Cl.new('owners').run(%w(add --target one))" %>
+
+<%= out '{:to=>"one", :deprecations=>{:target=>:to}}' %>

data/examples/_src/readme/description.erb.rb

@@ -0,0 +1,60 @@
+#!/usr/bin/env ruby
+$: << File.expand_path('lib')
+
+<%= run sq(<<-'rb')
+  require 'cl'
+
+  module Owners
+    class Add < Cl::Cmd
+      register :add
+
+      summary 'Add one or more owners to an existing owner group'
+
+      description <<~str
+        Use this command to add one or more owners to an existing
+        owner group.
+      str
+
+      examples <<~str
+        Adding a single user to the group admins:
+
+          owners add user --to admins
+
+        Adding a several users at once:
+
+          owners add one two three --to admins
+      str
+    end
+  end
+  rb
+-%>
+
+<%= run "Cl.new('owners').run(%w(add --help))" %>
+
+<%= out sq(<<-'str')
+  Usage: owners add [options]
+
+  Summary:
+
+    Add one or more owners to an existing owner group
+
+  Description:
+
+    Use this command to add one or more owners to an existing
+    owner group.
+
+  Options:
+
+    --help      Get help on this command
+
+  Examples:
+
+    Adding a single user to the group admins:
+
+      owners add user --to admins
+
+    Adding a several users at once:
+
+      owners add one two three --to admins
+  str
+%>

data/examples/_src/readme/downcase.erb.rb

@@ -0,0 +1,21 @@
+#!/usr/bin/env ruby
+$: << File.expand_path('lib')
+
+<%= run sq(<<-'rb')
+    require 'cl'
+
+    class Add < Cl::Cmd
+      register :add
+
+      opt '--to GROUP', downcase: true
+
+      def run
+        p to: to
+      end
+    end
+  rb
+-%>
+
+<%= run "Cl.new('owners').run(%w(add --to ONE))" %>
+
+<%= out '{:to=>"one"}' %>

data/examples/_src/readme/enum.erb.rb

@@ -0,0 +1,35 @@
+#!/usr/bin/env ruby
+$: << File.expand_path('lib')
+
+<%= run sq(<<-'rb')
+    require 'cl'
+
+    class Add < Cl::Cmd
+      register :add
+
+      opt '--to GROUP', enum: %w(one two)
+
+      def run
+        p to: to
+      end
+    end
+  rb
+-%>
+
+<%= run "Cl.new('owners').run(%w(add --to one))" %>
+
+<%= out '{:to=>"one"}' %>
+
+<%= run "Cl.new('owners').run(%w(add --to unknown))" %>
+
+<%= out sq(<<-'str')
+    Unknown value: to=unknown (known values: one, two)
+
+    Usage: owners add [options]
+
+    Options:
+
+      --to GROUP      type: string, known values: one, two
+      --help          Get help on this command
+  str
+%>

data/examples/_src/readme/example.erb.rb

@@ -0,0 +1,25 @@
+#!/usr/bin/env ruby
+$: << File.expand_path('lib')
+
+<%= run sq(<<-'rb')
+    require 'cl'
+
+    class Add < Cl::Cmd
+      register :add
+
+      opt '--to GROUP', example: 'group-one'
+    end
+  rb
+-%>
+
+<%= run "Cl.new('owners').run(%w(add --help))" %>
+
+<%= out sq(<<-'str')
+    Usage: owners add [options]
+
+    Options:
+
+      --to GROUP      type: string, e.g.: group-one
+      --help          Get help on this command
+  str
+%>

data/examples/_src/readme/format.erb.rb

@@ -0,0 +1,35 @@
+#!/usr/bin/env ruby
+$: << File.expand_path('lib')
+
+<%= run sq(<<-'rb')
+    require 'cl'
+
+    class Add < Cl::Cmd
+      register :add
+
+      opt '--to GROUP', format: /^\w+$/
+
+      def run
+        p to: to
+      end
+    end
+  rb
+-%>
+
+<%= run "Cl.new('owners').run(%w(add --to one))" %>
+
+<%= out '{:to=>"one"}' %>
+
+<%= run "Cl.new('owners').run(['add', '--to', 'does not match!'])" %>
+
+<%= out sq(<<-'str')
+    Invalid format: to (format: /^\w+$/)
+
+    Usage: owners add [options]
+
+    Options:
+
+      --to GROUP      type: string, format: /^\w+$/
+      --help          Get help on this command
+  str
+%>

data/examples/_src/readme/internal.erb.rb

@@ -0,0 +1,28 @@
+#!/usr/bin/env ruby
+$: << File.expand_path('lib')
+
+require 'cl'
+
+<%= run sq(<<-'rb')
+    require 'cl'
+
+    class Add < Cl::Cmd
+      register :add
+
+      opt '--to GROUP'
+      opt '--hidden', internal: true
+    end
+  rb
+-%>
+
+<%= run "Cl.new('owners').run(%w(add --help))" %>
+
+<%= out sq(<<-'str')
+    Usage: owners add [options]
+
+    Options:
+
+      --to GROUP      type: string
+      --help          Get help on this command
+  str
+%>

data/examples/_src/readme/negate.erb.rb

@@ -0,0 +1,37 @@
+#!/usr/bin/env ruby
+$: << File.expand_path('lib')
+
+<%= run sq(<<-'rb')
+    require 'cl'
+
+    class Add < Cl::Cmd
+      register :add
+
+      opt '--notifications', 'Send out notifications to the team', negate: %w(skip)
+
+      def run
+        p notifications?
+      end
+    end
+  rb
+-%>
+
+<%= run "Cl.new('owners').run(%w(add --notifications))" %>
+
+<%= out 'true' %>
+
+<%= run "Cl.new('owners').run(%w(add --no_notifications))" %>
+
+<%= out 'false' %>
+
+<%= run "Cl.new('owners').run(%w(add --no-notifications))" %>
+
+<%= out 'false' %>
+
+<%= run "Cl.new('owners').run(%w(add --skip_notifications))" %>
+
+<%= out 'false' %>
+
+<%= run "Cl.new('owners').run(%w(add --skip-notifications))" %>
+
+<%= out 'false' %>

data/examples/_src/readme/note.erb.rb

@@ -0,0 +1,25 @@
+#!/usr/bin/env ruby
+$: << File.expand_path('lib')
+
+<%= run sq(<<-'rb')
+    require 'cl'
+
+    class Add < Cl::Cmd
+      register :add
+
+      opt '--to GROUP', note: 'needs to be a group'
+    end
+  rb
+-%>
+
+<%= run "Cl.new('owners').run(%w(add --help))" %>
+
+<%= out sq(<<-'str')
+    Usage: owners add [options]
+
+    Options:
+
+      --to GROUP      type: string, note: needs to be a group
+      --help          Get help on this command
+  str
+%>

data/examples/_src/readme/opts.erb.rb

@@ -0,0 +1,33 @@
+#!/usr/bin/env ruby
+$: << File.expand_path('lib')
+
+<%= run sq(<<-'rb')
+    require 'cl'
+
+    class Add < Cl::Cmd
+      register :add
+
+      opt '--to GROUP', 'Target group to add owners to'
+
+      def run
+        p opts: opts, to: to, to?: to?
+      end
+    end
+  rb
+-%>
+
+<%= run "Cl.new('owners').run(%w(add --to one))" %>
+
+<%= out '{:opts=>{:to=>"one"}, :to=>"one", :to?=>true}' %>
+
+<%= run "Cl.new('owners').run(%w(add --help))" %>
+
+<%= out sq(<<-'str')
+    Usage: owners add [options]
+
+    Options:
+
+      --to GROUP      Target group to add owners to (type: string)
+      --help          Get help on this command
+  str
+%>

data/examples/_src/readme/opts_block.erb.rb

@@ -0,0 +1,30 @@
+#!/usr/bin/env ruby
+$: << File.expand_path('lib')
+
+<%= run sq(<<-'rb')
+    require 'cl'
+
+    class Add < Cl::Cmd
+      register :add
+
+      # depending on its arity the block can receive:
+      #
+      # * value
+      # * value, name
+      # * value, name, type
+      # * value, name, type, opts
+      opt '--to GROUP' do |value|
+        opts[:to] = "group-#{value}"
+      end
+
+      def run
+        p to: to
+      end
+    end
+  rb
+-%>
+
+<%= run "Cl.new('owners').run(%w(add --to one))" %>
+
+<%= out '{:to=>"group-one"}' %>
+

data/examples/_src/readme/range.erb.rb

@@ -0,0 +1,35 @@
+#!/usr/bin/env ruby
+$: << File.expand_path('lib')
+
+<%= run sq(<<-'rb')
+    require 'cl'
+
+    class Add < Cl::Cmd
+      register :add
+
+      opt '--retries COUNT', type: :integer, min: 1, max: 5
+
+      def run
+        p retries: retries
+      end
+    end
+  rb
+-%>
+
+<%= run "Cl.new('owners').run(%w(add --retries 1))" %>
+
+<%= out '{:retries=>1}' %>
+
+<%= run "Cl.new('owners').run(%w(add --retries 10))" %>
+
+<%= out sq(<<-'str')
+    Out of range: retries (min: 1, max: 5)
+
+    Usage: owners add [options]
+
+    Options:
+
+      --retries COUNT      type: integer, min: 1, max: 5
+      --help               Get help on this command
+  str
+%>

data/examples/_src/readme/registry.erb.rb

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+$: << File.expand_path('lib')
+
+<%= run sq(<<-'rb')
+  module Cmd
+    class One < Cl::Cmd
+      register :one
+    end
+
+    class Two < Cl::Cmd
+      register :two
+    end
+  end
+  rb
+-%>
+
+<%= run 'p Cl::Cmd[:one]' %> <%= out 'Cmd::One', short: true %>
+<%= run 'p Cl::Cmd[:two]' %> <%= out 'Cmd::Two', short: true %>

data/examples/_src/readme/required.erb.rb

@@ -0,0 +1,35 @@
+#!/usr/bin/env ruby
+$: << File.expand_path('lib')
+
+<%= run sq(<<-'rb')
+  require 'cl'
+
+  class Add < Cl::Cmd
+    register :add
+
+    opt '--to GROUP', required: true
+
+    def run
+      p to: to
+    end
+  end
+  rb
+-%>
+
+<%= run "Cl.new('owners').run(%w(add --to one))" %>
+
+<%= out '{:to=>"one"}' %>
+
+<%= run "Cl.new('owners').run(%w(add))" %>
+
+<%= out sq(<<-'str')
+  Missing required option: to
+
+  Usage: owners add [options]
+
+  Options:
+
+    --to GROUP      type: string, required
+    --help          Get help on this command
+  str
+%>

data/examples/_src/readme/requireds.erb.rb

@@ -0,0 +1,46 @@
+#!/usr/bin/env ruby
+$: << File.expand_path('lib')
+
+<%= run sq(<<-'rb')
+  class Add < Cl::Cmd
+    register :add
+
+    # read DNF, i.e. "token OR user AND pass
+    required :token, [:user, :pass]
+
+    opt '--token TOKEN'
+    opt '--user NAME'
+    opt '--pass PASS'
+
+    def run
+      p token: token, user: user, pass: pass
+    end
+  end
+  rb
+-%>
+
+<%= run "Cl.new('owners').run(%w(add --token token))" %>
+
+<%= out '{:token=>"token", :user=>nil, :pass=>nil}' %>
+
+<%= run "Cl.new('owners').run(%w(add --user user --pass pass))" %>
+
+<%= out '{:token=>nil, :user=>"user", :pass=>"pass"}' %>
+
+<%= run "Cl.new('owners').run(%w(add))" %>
+
+<%= out sq(<<-'str')
+  Missing options: token, or user and pass
+
+  Usage: owners add [options]
+
+  Options:
+
+    Either token, or user and pass are required.
+
+    --token TOKEN      type: string
+    --user NAME        type: string
+    --pass PASS        type: string
+    --help             Get help on this command
+  str
+%>