mcli 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3ddfcf04bb4cb996fc21aeea2dca7ef2792d568d565beb63fba843e0aeffa29f
-  data.tar.gz: f98c3c1b08f48e47178315b9fc7ae5bac4ab31ddf5bf667889a7d0db38cf0e4f
+  metadata.gz: 0011cb49282f8d026747d15ceaff822cedafb0e56920a0dcc952d35bc3d44c5e
+  data.tar.gz: 744d35d6c593b620a5fd8aa996abb789af17411116560b136a3c824aba37cd84
 SHA512:
-  metadata.gz: d8901533c3bc6ec5db845560e1730815908b56ffc1b6d8bc63b00db7dd672b6a55e5b9f2ad9a1dcaea037acc42f3890a52b7326b38f8d089e0e5c7a252b505e3
-  data.tar.gz: cf8d25519029d0d1c8c5d2b133664839f8996a2e7b5985e60db4488f16071d0354493c4755be8cbc6f16f0e89cdc936a83ca0024622746d8eaf5daae4af5c361
+  metadata.gz: 1acacb7282ef455e98d85caaa33e1396c79fb388962fc247df65d371b5efcf3ac7e74d061e146ae021ae9243970b54acb19053f4f600ffd0078df474b73e2446
+  data.tar.gz: 3c74baee24bcf1d03761877cd1b3b2e2d88357220f273cfc682631f8a2a6e326975ed5df5f194bc303481cbba94c29a8f8294287eee04d326997b5086c4da4d4

data/README.md

@@ -200,7 +200,7 @@ Heads: false
 #!/usr/bin/env ruby
 require 'mcli'
 
-class Options < MCLI::Command
+class Capture < MCLI::Command
   register_as :capture
   capture_all!
 
@@ -217,6 +217,70 @@ $ ./capture.rb capture --toast=cool one two -a ok three
 ["--toast=cool", "one", "two", "-a", "ok", "three"]
 ```
 
+##### Register a command as the root command
+```ruby
+#root.rb
+```
+```ruby
+#!/usr/bin/env ruby
+require 'mcli'
+
+class Root < MCLI::Command
+  register_as_root
+  option 'option'
+
+  def run
+    puts "#{arg.inspect}"
+    puts "#{options[:root]}"
+  end
+end
+
+MCLI.run
+```
+
+```bash
+$ ./root.rb arg --option opt
+[arg]
+opt
+```
+
+##### Register nested commands
+```ruby
+#nestable.rb
+```
+```ruby
+#!/usr/bin/env ruby
+require 'mcli'
+
+class Nestable < MCLI::Command
+  register_as :nestable
+  capture_all!
+
+  def run
+    NestedGroup.call(args)
+  end
+
+  class NestedGroup < MCLI::CommandGroup
+  end
+end
+
+class NestedCommand < MCLI::Command
+  register_as :command, to: Nestable::Group
+  capture_all!
+
+  def run
+    puts args.inspect
+  end
+end
+
+MCLI.run
+```
+
+```bash
+$ ./nestable.rb nestable command --toast=cool one two -a ok three
+["--toast=cool", "one", "two", "-a", "ok", "three"]
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/mcli.rb

@@ -9,12 +9,7 @@ require 'mcli/null_command'
 module MCLI
   class << self
     def run
-      command = ARGV.shift
-
-      CommandGroup.commands.fetch(command.to_s.to_sym) do |command|
-        ARGV.unshift(command)
-        CommandGroup.root_command || NullCommand
-      end.call
+      CommandGroup.call(ARGV.dup)
     end
   end
 end

data/lib/mcli/command.rb

@@ -16,7 +16,7 @@ class MCLI::Command
       end
     end
 
-    parser.parse!
+    parser.parse!(@args)
 
     self.class.options
       .select { |option| option.required == true }
@@ -59,9 +59,9 @@ class MCLI::Command
       @options ||= []
     end
 
-    def register_as(command_name)
+    def register_as(command_name, to: default_command_group)
       @command_name = command_name
-      MCLI::CommandGroup.register(command_name, self)
+      to.register(command_name, self)
     end
 
     def register_as_root
@@ -80,8 +80,12 @@ class MCLI::Command
       @command_name
     end
 
-    def call
-      new(ARGV).tap do |command|
+    def default_command_group
+      MCLI::CommandGroup
+    end
+
+    def call(args)
+      new(args).tap do |command|
         begin
           command.parse unless capture_all?
           command.run

data/lib/mcli/command_group.rb

@@ -19,6 +19,15 @@ class MCLI::CommandGroup
     def root_command
       @root_command
     end
+
+    def call(args)
+      command = args.shift
+
+      commands.fetch(command.to_s.to_sym) do |command|
+        args.unshift(command)
+        root_command || MCLI::NullCommand
+      end.call(args)
+    end
   end
 end
 

data/lib/mcli/version.rb

@@ -1,3 +1,3 @@
 module MCLI
-  VERSION = "0.7.0"
+  VERSION = "0.8.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mcli
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - John Thomas
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-01-16 00:00:00.000000000 Z
+date: 2021-01-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler