cl 1.2.2 → 1.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 310fdefbe025481f507f96657b81c0b0d4b975fe
-  data.tar.gz: b62a11830d34ae171e26eec7782b9da20f0cf87c
+  metadata.gz: 78ff40e295fbf8f2e46de7150e9e769c9d27311e
+  data.tar.gz: 230752a72d84226fe9c9dce2153e5eee317e5039
 SHA512:
-  metadata.gz: 4c277d6d56b2728232bb4fafa0ca368af36fef798811c34406667f0e3d4236ea00af6b3a77fd55b4809e96486f07a81272f58effd8a35e86ae2825579758c054
-  data.tar.gz: 6b646a6350c91b113ae88e4e0474bbedeb3e57b6281dd06c70d512b332263fcc3f9e68287238d66a627aea587683f174160c7e3e923c9c5b84f38431a26a1769
+  metadata.gz: 0dd2f41a992417486b560bacd083effdbc985a997ed136c2e0cf9d63467e3a4c997bcdfcfa19b2fdbef17a4223f16f919be305022a370929b00ce7258d8afbbb
+  data.tar.gz: 4ff8c46ee20c9a5e06f74c44e152aba5323ee24b12b7d3e1620362fc295cb1bc4b330b03e5088eb3bc379c4ae7e0f073ec1d7cdee3c034c3c0f58d4fad56767b

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    cl (1.2.1)
+    cl (1.2.2)
       regstry (~> 1.0.3)
 
 GEM

data/README.md

@@ -53,6 +53,8 @@ on CI.
 ```ruby
 module Owners
   class Add < Cl::Cmd
+    register :add
+
     summary 'Add one or more owners to an existing owner group'
 
     description <<~str
@@ -128,9 +130,11 @@ For example:
 ```ruby
 module Cmd
   class One < Cl::Cmd
+    register :one
   end
 
   class Two < Cl::Cmd
+    register :two
   end
 end
 
@@ -139,9 +143,7 @@ p Cl::Cmd[:two] # => Cmd::Two
 
 ```
 
-Commands auto register themselves with the underscored name of the last part of
-their class name (as seen in the example above). It is possible to ovewrite this
-key by manually registering the class, like so:
+Commands can be registered like so:
 
 ```ruby
 module One
@@ -151,13 +153,6 @@ module One
 end
 ```
 
-Be aware that if you derive a common base command class from `Cl::Cmd` it
-should be declared as `abstract` in order to unregister itself from the command
-registry.
-
-This will prevent the runner to consider it as a runnable command, and omit it
-from help output. See [abstract](#abstract) for details.
-
 ### Runners
 
 Runners lookup the command to execute from the registry, by checking the
@@ -269,6 +264,8 @@ The description, summary, and examples are used in the help output.
 ```ruby
 module Owners
   class Add < Cl::Cmd
+    register :add
+
     summary 'Add one or more owners to an existing owner group'
 
     description <<~str
@@ -333,6 +330,8 @@ class Base < Cl::Cmd
 end
 
 class Add < Base
+  register :add
+
   def run
     puts 'Success'
   end
@@ -365,6 +364,8 @@ example the method `ownsers` will be available on the `Cmd` instance:
 
 ```ruby
 class Add < Cl::Cmd
+  register :add
+
   arg :owner
 
   def run
@@ -393,6 +394,8 @@ using this separator.
 
 ```ruby
 class Add < Cl::Cmd
+  register :add
+
   arg :owners, type: :array, sep: ','
 
   def run
@@ -412,6 +415,8 @@ Other types cast the given argument to the expected Ruby type.
 
 ```ruby
 class Cmd < Cl::Cmd
+  register :cmd
+
   arg :one, type: :integer
   arg :two, type: :float
   arg :three, type: :boolean
@@ -437,6 +442,8 @@ For example:
 
 ```ruby
 class Lft < Cl::Cmd
+  register :lft
+
   arg :a, type: :array, splat: true
   arg :b
   arg :c
@@ -447,6 +454,8 @@ class Lft < Cl::Cmd
 end
 
 class Mid < Cl::Cmd
+  register :mid
+
   arg :a
   arg :b, type: :array, splat: true
   arg :c
@@ -457,6 +466,8 @@ class Mid < Cl::Cmd
 end
 
 class Rgt < Cl::Cmd
+  register :rgt
+
   arg :a
   arg :b
   arg :c, type: :array, splat: true
@@ -498,6 +509,8 @@ For example:
 
 ```ruby
 class Add < Cl::Cmd
+  register :add
+
   opt '--to GROUP', 'Target group to add owners to'
 
   def run
@@ -532,6 +545,8 @@ the command.
 
 ```ruby
 class Add < Cl::Cmd
+  register :add
+
   # depending on its arity the block can receive:
   #
   # * value
@@ -562,6 +577,8 @@ Options can have one or many alias names, given as a Symbol or Array of Symbols:
 
 ```ruby
 class Add < Cl::Cmd
+  register :add
+
   opt '--to GROUP', alias: :group
 
   def run
@@ -586,6 +603,8 @@ I.e. this value is going to be used if the user does not provide the option:
 
 ```ruby
 class Add < Cl::Cmd
+  register :add
+
   opt '--to GROUP', default: 'default'
 
   def run
@@ -609,6 +628,8 @@ For a deprecated option:
 
 ```ruby
 class Add < Cl::Cmd
+  register :add
+
   opt '--target GROUP', deprecated: 'Deprecated.'
 
   def run
@@ -628,6 +649,8 @@ For a deprecated option alias name:
 
 ```ruby
 class Add < Cl::Cmd
+  register :add
+
   opt '--to GROUP', alias: :target, deprecated: :target
 
   def run
@@ -651,6 +674,8 @@ For example:
 
 ```ruby
 class Add < Cl::Cmd
+  register :add
+
   opt '--to GROUP', downcase: true
 
   def run
@@ -677,6 +702,8 @@ For example:
 
 ```ruby
 class Add < Cl::Cmd
+  register :add
+
   opt '--to GROUP', enum: %w(one two)
 
   def run
@@ -711,6 +738,8 @@ Options can have examples that will be printed in the help output.
 
 ```ruby
 class Add < Cl::Cmd
+  register :add
+
   opt '--to GROUP', example: 'group-one'
 end
 
@@ -738,6 +767,8 @@ For example:
 
 ```ruby
 class Add < Cl::Cmd
+  register :add
+
   opt '--to GROUP', format: /^\w+$/
 
   def run
@@ -774,6 +805,8 @@ For example:
 
 ```ruby
 class Add < Cl::Cmd
+  register :add
+
   opt '--to GROUP'
   opt '--hidden', internal: true
 end
@@ -803,6 +836,8 @@ For example:
 
 ```ruby
 class Add < Cl::Cmd
+  register :add
+
   opt '--retries COUNT', type: :integer, min: 1, max: 5
 
   def run
@@ -840,6 +875,8 @@ an option `negate` like so:
 
 ```ruby
 class Add < Cl::Cmd
+  register :add
+
   opt '--notifications', 'Send out notifications to the team', negate: %w(skip)
 
   def run
@@ -885,6 +922,8 @@ Options can have a note that will be printed in the help output.
 
 ```ruby
 class Add < Cl::Cmd
+  register :add
+
   opt '--to GROUP', note: 'needs to be a group'
 end
 
@@ -911,6 +950,8 @@ on this in order to, for example, obfuscate values from log output.
 
 ```ruby
 class Add < Cl::Cmd
+  register :add
+
   opt '--pass PASS', secret: true
 
   def run
@@ -938,6 +979,8 @@ For example:
 
 ```ruby
 class Add < Cl::Cmd
+  register :add
+
   opt '--to GROUP', see: 'https://docs.io/cli/owners/add'
 end
 
@@ -965,6 +1008,8 @@ only supports arrays of strings).
 
 ```ruby
 class Add < Cl::Cmd
+  register :add
+
   opt '--to GROUP', type: :array
 
   def run
@@ -984,6 +1029,8 @@ Other types cast the given value to the expected Ruby type.
 
 ```ruby
 class Add < Cl::Cmd
+  register :add
+
   opt '--active BOOL', type: :boolean
   opt '--retries INT', type: :integer
   opt '--sleep FLOAT', type: :float
@@ -1013,6 +1060,8 @@ For example, this simply requires the option `--to`:
 
 ```ruby
 class Add < Cl::Cmd
+  register :add
+
   opt '--to GROUP', required: true
 
   def run
@@ -1045,6 +1094,8 @@ This will make the option `--retries` depend on the option `--to`:
 
 ```ruby
 class Add < Cl::Cmd
+  register :add
+
   opt '--to GROUP'
   opt '--other GROUP', requires: :to
 
@@ -1080,6 +1131,8 @@ This requires either the option `--api_key` or both options `--username` and
 
 ```ruby
 class Add < Cl::Cmd
+  register :add
+
   # read DNF, i.e. "token OR user AND pass
   required :token, [:user, :pass]
 

data/examples/_src/args/cast.erb.rb

@@ -6,6 +6,8 @@ $: << File.expand_path('lib')
 
     module Cast
       class Bool < Cl::Cmd
+        register :bool
+
         arg :bool, type: :bool
 
         def run
@@ -14,6 +16,8 @@ $: << File.expand_path('lib')
       end
 
       class Types < Cl::Cmd
+        register :types
+
         arg :a, type: :bool
         arg :b, type: :int
         arg :c, type: :float

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

@@ -6,6 +6,8 @@ $: << File.expand_path('lib')
 
     module Opts
       class Bool < Cl::Cmd
+        register :bool
+
         arg :bool, type: :bool
 
         def run
@@ -14,6 +16,8 @@ $: << File.expand_path('lib')
       end
 
       class Types < Cl::Cmd
+        register :types
+
         arg :a, type: :bool
         arg :b, type: :int
         arg :c, type: :float

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

@@ -5,6 +5,8 @@ $: << File.expand_path('lib')
     require 'cl'
 
     class Required < Cl::Cmd
+      register :required
+
       arg :one, required: true
       arg :two
 

data/examples/_src/gem.erb.rb

@@ -8,6 +8,8 @@ $: << File.expand_path('lib')
       module Release
         module Cmds
           class Release < Cl::Cmd
+            register 'release'
+
             arg :gemspec
 
             opt '-h', '--host HOST', 'Push to a compatible host other than rubygems.org'
@@ -20,6 +22,8 @@ $: << File.expand_path('lib')
           end
 
           class Bump < Cl::Cmd
+            register 'bump'
+
             opt '-v', '--version VERSION', 'The version to bump to [1.1.1|major|minor|patch|pre|rc|release]'
             opt '--[no-]commit',           'Bump the version, but do not commit'
 

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

@@ -9,6 +9,8 @@ require 'cl'
     end
 
     class Add < Base
+      register :add
+
       def run
         puts 'Success'
       end

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

@@ -5,6 +5,8 @@ $: << File.expand_path('lib')
     require 'cl'
 
     class Add < Cl::Cmd
+      register :add
+
       opt '--to GROUP', alias: :group
 
       def run

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

@@ -5,6 +5,8 @@ $: << File.expand_path('lib')
     require 'cl'
 
     class Add < Cl::Cmd
+      register :add
+
       arg :owner
 
       def run

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

@@ -5,6 +5,8 @@ $: << File.expand_path('lib')
     require 'cl'
 
     class Add < Cl::Cmd
+      register :add
+
       arg :owners, type: :array, sep: ','
 
       def run

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

@@ -5,6 +5,8 @@ $: << File.expand_path('lib')
     require 'cl'
 
     class Cmd < Cl::Cmd
+      register :cmd
+
       arg :one, type: :integer
       arg :two, type: :float
       arg :three, type: :boolean

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

@@ -5,6 +5,8 @@ $: << File.expand_path('lib')
     require 'cl'
 
     class Lft < Cl::Cmd
+      register :lft
+
       arg :a, type: :array, splat: true
       arg :b
       arg :c
@@ -15,6 +17,8 @@ $: << File.expand_path('lib')
     end
 
     class Mid < Cl::Cmd
+      register :mid
+
       arg :a
       arg :b, type: :array, splat: true
       arg :c
@@ -25,6 +29,8 @@ $: << File.expand_path('lib')
     end
 
     class Rgt < Cl::Cmd
+      register :rgt
+
       arg :a
       arg :b
       arg :c, type: :array, splat: true

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

@@ -5,6 +5,8 @@ $: << File.expand_path('lib')
     require 'cl'
 
     class Add < Cl::Cmd
+      register :add
+
       opt '--to GROUP', type: :array
 
       def run

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

@@ -4,6 +4,8 @@
   # 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

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

@@ -5,6 +5,8 @@ $: << File.expand_path('lib')
     require 'cl'
 
     class Add < Cl::Cmd
+      register :add
+
       opt '--to GROUP', default: 'default'
 
       def run

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

@@ -5,6 +5,8 @@ $: << File.expand_path('lib')
     require 'cl'
 
     class Add < Cl::Cmd
+      register :add
+
       opt '--target GROUP', deprecated: 'Deprecated.'
 
       def run

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

@@ -5,6 +5,8 @@ $: << File.expand_path('lib')
     require 'cl'
 
     class Add < Cl::Cmd
+      register :add
+
       opt '--to GROUP', alias: :target, deprecated: :target
 
       def run

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

@@ -6,6 +6,8 @@ $: << File.expand_path('lib')
 
   module Owners
     class Add < Cl::Cmd
+      register :add
+
       summary 'Add one or more owners to an existing owner group'
 
       description <<~str

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

@@ -5,6 +5,8 @@ $: << File.expand_path('lib')
     require 'cl'
 
     class Add < Cl::Cmd
+      register :add
+
       opt '--to GROUP', downcase: true
 
       def run

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

@@ -5,6 +5,8 @@ $: << File.expand_path('lib')
     require 'cl'
 
     class Add < Cl::Cmd
+      register :add
+
       opt '--to GROUP', enum: %w(one two)
 
       def run

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

@@ -5,6 +5,8 @@ $: << File.expand_path('lib')
     require 'cl'
 
     class Add < Cl::Cmd
+      register :add
+
       opt '--to GROUP', example: 'group-one'
     end
   rb

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

@@ -5,6 +5,8 @@ $: << File.expand_path('lib')
     require 'cl'
 
     class Add < Cl::Cmd
+      register :add
+
       opt '--to GROUP', format: /^\w+$/
 
       def run

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

@@ -7,6 +7,8 @@ require 'cl'
     require 'cl'
 
     class Add < Cl::Cmd
+      register :add
+
       opt '--to GROUP'
       opt '--hidden', internal: true
     end

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

@@ -5,6 +5,8 @@ $: << File.expand_path('lib')
     require 'cl'
 
     class Add < Cl::Cmd
+      register :add
+
       opt '--notifications', 'Send out notifications to the team', negate: %w(skip)
 
       def run

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

@@ -5,6 +5,8 @@ $: << File.expand_path('lib')
     require 'cl'
 
     class Add < Cl::Cmd
+      register :add
+
       opt '--to GROUP', note: 'needs to be a group'
     end
   rb

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

@@ -5,6 +5,8 @@ $: << File.expand_path('lib')
     require 'cl'
 
     class Add < Cl::Cmd
+      register :add
+
       opt '--to GROUP', 'Target group to add owners to'
 
       def run

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

@@ -5,6 +5,8 @@ $: << File.expand_path('lib')
     require 'cl'
 
     class Add < Cl::Cmd
+      register :add
+
       # depending on its arity the block can receive:
       #
       # * value

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

@@ -5,6 +5,8 @@ $: << File.expand_path('lib')
     require 'cl'
 
     class Add < Cl::Cmd
+      register :add
+
       opt '--retries COUNT', type: :integer, min: 1, max: 5
 
       def run

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

@@ -4,9 +4,11 @@ $: << 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

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

@@ -5,6 +5,8 @@ $: << File.expand_path('lib')
   require 'cl'
 
   class Add < Cl::Cmd
+    register :add
+
     opt '--to GROUP', required: true
 
     def run

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

@@ -3,6 +3,8 @@ $: << 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]
 

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

@@ -3,6 +3,8 @@ $: << File.expand_path('lib')
 
 <%= run sq(<<-'rb')
   class Add < Cl::Cmd
+    register :add
+
     opt '--to GROUP'
     opt '--other GROUP', requires: :to
 

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

@@ -3,6 +3,8 @@ $: << File.expand_path('lib')
 
 <%= run sq(<<-'rb')
   class Add < Cl::Cmd
+    register :add
+
     opt '--pass PASS', secret: true
 
     def run

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

@@ -5,6 +5,8 @@ $: << File.expand_path('lib')
   require 'cl'
 
   class Add < Cl::Cmd
+    register :add
+
     opt '--to GROUP', see: 'https://docs.io/cli/owners/add'
   end
   rb

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

@@ -3,6 +3,8 @@ $: << File.expand_path('lib')
 
 <%= run sq(<<-'rb')
   class Add < Cl::Cmd
+    register :add
+
     opt '--active BOOL', type: :boolean
     opt '--retries INT', type: :integer
     opt '--sleep FLOAT', type: :float

data/examples/args/cast

@@ -5,6 +5,8 @@ require 'cl'
 
 module Cast
   class Bool < Cl::Cmd
+    register :bool
+
     arg :bool, type: :bool
 
     def run
@@ -13,6 +15,8 @@ module Cast
   end
 
   class Types < Cl::Cmd
+    register :types
+
     arg :a, type: :bool
     arg :b, type: :int
     arg :c, type: :float

data/examples/args/opts

@@ -5,6 +5,8 @@ require 'cl'
 
 module Opts
   class Bool < Cl::Cmd
+    register :bool
+
     arg :bool, type: :bool
 
     def run
@@ -13,6 +15,8 @@ module Opts
   end
 
   class Types < Cl::Cmd
+    register :types
+
     arg :a, type: :bool
     arg :b, type: :int
     arg :c, type: :float

data/examples/args/required

@@ -4,6 +4,8 @@ $: << File.expand_path('lib')
 require 'cl'
 
 class Required < Cl::Cmd
+  register :required
+
   arg :one, required: true
   arg :two
 

data/examples/gem

@@ -7,6 +7,8 @@ module Gem
   module Release
     module Cmds
       class Release < Cl::Cmd
+        register 'release'
+
         arg :gemspec
 
         opt '-h', '--host HOST', 'Push to a compatible host other than rubygems.org'
@@ -19,6 +21,8 @@ module Gem
       end
 
       class Bump < Cl::Cmd
+        register 'bump'
+
         opt '-v', '--version VERSION', 'The version to bump to [1.1.1|major|minor|patch|pre|rc|release]'
         opt '--[no-]commit',           'Bump the version, but do not commit'
 

data/examples/readme/abstract

@@ -8,6 +8,8 @@ class Base < Cl::Cmd
 end
 
 class Add < Base
+  register :add
+
   def run
     puts 'Success'
   end

data/examples/readme/alias

@@ -4,6 +4,8 @@ $: << File.expand_path('lib')
 require 'cl'
 
 class Add < Cl::Cmd
+  register :add
+
   opt '--to GROUP', alias: :group
 
   def run

data/examples/readme/arg

@@ -4,6 +4,8 @@ $: << File.expand_path('lib')
 require 'cl'
 
 class Add < Cl::Cmd
+  register :add
+
   arg :owner
 
   def run

data/examples/readme/arg_array

@@ -4,6 +4,8 @@ $: << File.expand_path('lib')
 require 'cl'
 
 class Add < Cl::Cmd
+  register :add
+
   arg :owners, type: :array, sep: ','
 
   def run

data/examples/readme/arg_type

@@ -4,6 +4,8 @@ $: << File.expand_path('lib')
 require 'cl'
 
 class Cmd < Cl::Cmd
+  register :cmd
+
   arg :one, type: :integer
   arg :two, type: :float
   arg :three, type: :boolean

data/examples/readme/args_splat

@@ -4,6 +4,8 @@ $: << File.expand_path('lib')
 require 'cl'
 
 class Lft < Cl::Cmd
+  register :lft
+
   arg :a, type: :array, splat: true
   arg :b
   arg :c
@@ -14,6 +16,8 @@ class Lft < Cl::Cmd
 end
 
 class Mid < Cl::Cmd
+  register :mid
+
   arg :a
   arg :b, type: :array, splat: true
   arg :c
@@ -24,6 +28,8 @@ class Mid < Cl::Cmd
 end
 
 class Rgt < Cl::Cmd
+  register :rgt
+
   arg :a
   arg :b
   arg :c, type: :array, splat: true

data/examples/readme/array

@@ -4,6 +4,8 @@ $: << File.expand_path('lib')
 require 'cl'
 
 class Add < Cl::Cmd
+  register :add
+
   opt '--to GROUP', type: :array
 
   def run

data/examples/readme/basic

@@ -3,6 +3,8 @@ 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

data/examples/readme/default

@@ -4,6 +4,8 @@ $: << File.expand_path('lib')
 require 'cl'
 
 class Add < Cl::Cmd
+  register :add
+
   opt '--to GROUP', default: 'default'
 
   def run

data/examples/readme/deprecated

@@ -4,6 +4,8 @@ $: << File.expand_path('lib')
 require 'cl'
 
 class Add < Cl::Cmd
+  register :add
+
   opt '--target GROUP', deprecated: 'Deprecated.'
 
   def run

data/examples/readme/deprecated_alias

@@ -4,6 +4,8 @@ $: << File.expand_path('lib')
 require 'cl'
 
 class Add < Cl::Cmd
+  register :add
+
   opt '--to GROUP', alias: :target, deprecated: :target
 
   def run

data/examples/readme/description

@@ -5,6 +5,8 @@ require 'cl'
 
 module Owners
   class Add < Cl::Cmd
+    register :add
+
     summary 'Add one or more owners to an existing owner group'
 
     description <<~str

data/examples/readme/downcase

@@ -4,6 +4,8 @@ $: << File.expand_path('lib')
 require 'cl'
 
 class Add < Cl::Cmd
+  register :add
+
   opt '--to GROUP', downcase: true
 
   def run

data/examples/readme/enum

@@ -4,6 +4,8 @@ $: << File.expand_path('lib')
 require 'cl'
 
 class Add < Cl::Cmd
+  register :add
+
   opt '--to GROUP', enum: %w(one two)
 
   def run

data/examples/readme/example

@@ -4,6 +4,8 @@ $: << File.expand_path('lib')
 require 'cl'
 
 class Add < Cl::Cmd
+  register :add
+
   opt '--to GROUP', example: 'group-one'
 end
 

data/examples/readme/format

@@ -4,6 +4,8 @@ $: << File.expand_path('lib')
 require 'cl'
 
 class Add < Cl::Cmd
+  register :add
+
   opt '--to GROUP', format: /^\w+$/
 
   def run

data/examples/readme/internal

@@ -6,6 +6,8 @@ require 'cl'
 require 'cl'
 
 class Add < Cl::Cmd
+  register :add
+
   opt '--to GROUP'
   opt '--hidden', internal: true
 end

data/examples/readme/negate

@@ -4,6 +4,8 @@ $: << File.expand_path('lib')
 require 'cl'
 
 class Add < Cl::Cmd
+  register :add
+
   opt '--notifications', 'Send out notifications to the team', negate: %w(skip)
 
   def run

data/examples/readme/note

@@ -4,6 +4,8 @@ $: << File.expand_path('lib')
 require 'cl'
 
 class Add < Cl::Cmd
+  register :add
+
   opt '--to GROUP', note: 'needs to be a group'
 end
 

data/examples/readme/opts

@@ -4,6 +4,8 @@ $: << File.expand_path('lib')
 require 'cl'
 
 class Add < Cl::Cmd
+  register :add
+
   opt '--to GROUP', 'Target group to add owners to'
 
   def run

data/examples/readme/opts_block

@@ -4,6 +4,8 @@ $: << File.expand_path('lib')
 require 'cl'
 
 class Add < Cl::Cmd
+  register :add
+
   # depending on its arity the block can receive:
   #
   # * value

data/examples/readme/range

@@ -4,6 +4,8 @@ $: << File.expand_path('lib')
 require 'cl'
 
 class Add < Cl::Cmd
+  register :add
+
   opt '--retries COUNT', type: :integer, min: 1, max: 5
 
   def run

data/examples/readme/registry

@@ -3,9 +3,11 @@ $: << File.expand_path('lib')
 
 module Cmd
   class One < Cl::Cmd
+    register :one
   end
 
   class Two < Cl::Cmd
+    register :two
   end
 end
 

data/examples/readme/required

@@ -4,6 +4,8 @@ $: << File.expand_path('lib')
 require 'cl'
 
 class Add < Cl::Cmd
+  register :add
+
   opt '--to GROUP', required: true
 
   def run

data/examples/readme/requireds

@@ -2,6 +2,8 @@
 $: << File.expand_path('lib')
 
 class Add < Cl::Cmd
+  register :add
+
   # read DNF, i.e. "token OR user AND pass
   required :token, [:user, :pass]
 

data/examples/readme/requires

@@ -2,6 +2,8 @@
 $: << File.expand_path('lib')
 
 class Add < Cl::Cmd
+  register :add
+
   opt '--to GROUP'
   opt '--other GROUP', requires: :to
 

data/examples/readme/secret

@@ -2,6 +2,8 @@
 $: << File.expand_path('lib')
 
 class Add < Cl::Cmd
+  register :add
+
   opt '--pass PASS', secret: true
 
   def run

data/examples/readme/see

@@ -4,6 +4,8 @@ $: << File.expand_path('lib')
 require 'cl'
 
 class Add < Cl::Cmd
+  register :add
+
   opt '--to GROUP', see: 'https://docs.io/cli/owners/add'
 end
 

data/examples/readme/type

@@ -2,6 +2,8 @@
 $: << File.expand_path('lib')
 
 class Add < Cl::Cmd
+  register :add
+
   opt '--active BOOL', type: :boolean
   opt '--retries INT', type: :integer
   opt '--sleep FLOAT', type: :float

data/lib/cl/cmd.rb

@@ -7,6 +7,7 @@ require 'cl/parser'
 
 class Cl
   singleton_class.send(:attr_accessor, :auto_register) # remove unless anyone needs this
+  singleton_class.instance_variable_set(:@auto_register, true)
 
   # Base class for all command classes that can be run.
   #
@@ -23,7 +24,7 @@ class Cl
       include Merge, Suggest, Underscore
 
       inherited = ->(const) do
-        return unless Cl.auto_register
+        # return unless Cl.auto_register
         if const.name
           key = underscore(const.name.split('::').last)
           key = [registry_key, key].compact.join(':') unless abstract?

data/lib/cl/version.rb

@@ -1,3 +1,3 @@
 class Cl
-  VERSION = '1.2.2'
+  VERSION = '1.2.3'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cl
 version: !ruby/object:Gem::Version
-  version: 1.2.2
+  version: 1.2.3
 platform: ruby
 authors:
 - Sven Fuchs