samovar 2.1.4 → 2.2.0

data/{README.md → readme.md}

@@ -4,41 +4,39 @@
 
 Samovar is a modern framework for building command-line tools and applications. It provides a declarative class-based DSL for building command-line parsers that include automatic documentation generation. It helps you keep your functionality clean and isolated where possible.
 
-[![Build Status](https://secure.travis-ci.org/ioquatix/samovar.svg)](http://travis-ci.org/ioquatix/samovar)
-[![Code Climate](https://codeclimate.com/github/ioquatix/samovar.svg)](https://codeclimate.com/github/ioquatix/samovar)
-[![Coverage Status](https://coveralls.io/repos/ioquatix/samovar/badge.svg)](https://coveralls.io/r/ioquatix/samovar)
+[![Development Status](https://github.com/ioquatix/samovar/workflows/Test/badge.svg)](https://github.com/ioquatix/samovar/actions?workflow=Test)
 
 ## Motivation
 
-I've been using [Trollop](https://github.com/ManageIQ/trollop) and while it's not bad, it's hard to use for sub-commands in a way that generates nice documentation. It also has pretty limited support for complex command lines (e.g. nested commands, splits, matching tokens, etc). Samovar is a high level bridge between the command line and your code: it generates decent documentation, maps nicely between the command line syntax and your functions, and supports sub-commands using classes which are easy to compose.
+I've been using [Optimist](https://github.com/ManageIQ/optimist) and while it's not bad, it's hard to use for sub-commands in a way that generates nice documentation. It also has pretty limited support for complex command lines (e.g. nested commands, splits, matching tokens, etc). Samovar is a high level bridge between the command line and your code: it generates decent documentation, maps nicely between the command line syntax and your functions, and supports sub-commands using classes which are easy to compose.
 
 One of the other issues I had with existing frameworks is testability. Most frameworks expect to have some pretty heavy logic directly in the binary executable, or at least don't structure your code in a way which makes testing easy. Samovar structures your command processing logic into classes which can be easily tested in isolation, which means that you can mock up and [spec your command-line executables easily](https://github.com/ioquatix/teapot/blob/master/spec/teapot/command_spec.rb).
 
 ## Examples
 
-- [Teapot](https://github.com/ioquatix/teapot/blob/master/lib/teapot/command.rb) is a build system and uses multiple top-level commands.
-- [Utopia](https://github.com/ioquatix/utopia/blob/master/lib/utopia/command.rb) is a web application platform and uses nested commands.
-- [Synco](https://github.com/ioquatix/synco/blob/master/lib/synco/command.rb) is a backup tool and sends commands across the network and has lots of options with default values.
+  - [Teapot](https://github.com/ioquatix/teapot/blob/master/lib/teapot/command.rb) is a build system and uses multiple top-level commands.
+  - [Utopia](https://github.com/ioquatix/utopia/blob/master/lib/utopia/command.rb) is a web application platform and uses nested commands.
+  - [Synco](https://github.com/ioquatix/synco/blob/master/lib/synco/command.rb) is a backup tool and sends commands across the network and has lots of options with default values.
 
 ## Installation
 
 Add this line to your application's Gemfile:
 
-	gem 'samovar'
+    gem 'samovar'
 
 And then execute:
 
-	$ bundle
+    $ bundle
 
 Or install it yourself as:
 
-	$ gem install samovar
+    $ gem install samovar
 
 ## Usage
 
 Generally speaking, you should create `Command` classes that represent specific functions in your program. The top level command might look something like this:
 
-```ruby
+``` ruby
 require 'samovar'
 
 class List < Samovar::Command
@@ -72,7 +70,7 @@ Application.call # Defaults to ARGV.
 
 ### Basic Options
 
-```ruby
+``` ruby
 require 'samovar'
 
 class Application < Samovar::Command
@@ -101,7 +99,7 @@ application.options[:things] # ['x', 'y', 'z']
 
 ### Nested Commands
 
-```ruby
+``` ruby
 require 'samovar'
 
 class Create < Samovar::Command
@@ -128,7 +126,7 @@ Application.new(['create']).invoke
 
 ### ARGV Splits
 
-```ruby
+``` ruby
 require 'samovar'
 
 class Application < Samovar::Command
@@ -143,7 +141,7 @@ application.argv # ['apples', 'oranges', 'feijoas']
 
 ### Parsing Tokens
 
-```ruby
+``` ruby
 require 'samovar'
 
 class Application < Samovar::Command
@@ -162,13 +160,13 @@ application.cakes # ['chocolate cake', 'fruit cake']
 
 Given a custom `Samovar::Command` subclass, you can instantiate it with options:
 
-```ruby
+``` ruby
 application = Application['--root', path]
 ```
 
 You can also duplicate an existing command instance with additions/changes:
 
-```ruby
+``` ruby
 concurrent_application = application['--threads', 12]
 ```
 
@@ -176,64 +174,50 @@ These forms can be useful when invoking one command from another, or in unit tes
 
 ## Contributing
 
-1. Fork it
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create new Pull Request
+We welcome contributions to this project.
 
-### Future Work
+1.  Fork it.
+2.  Create your feature branch (`git checkout -b my-new-feature`).
+3.  Commit your changes (`git commit -am 'Add some feature'`).
+4.  Push to the branch (`git push origin my-new-feature`).
+5.  Create new Pull Request.
 
-#### Multi-value Options
+### Developer Certificate of Origin
+
+This project uses the [Developer Certificate of Origin](https://developercertificate.org/). All contributors to this project must agree to this document to have their contributions accepted.
+
+### Contributor Covenant
+
+This project is governed by [Contributor Covenant](https://www.contributor-covenant.org/). All contributors and participants agree to abide by its terms.
+
+## Future Work
+
+### Multi-value Options
 
 Right now, options can take a single argument, e.g. `--count <int>`. Ideally, we support a specific sub-parser defined by the option, e.g. `--count <int...>` or `--tag <section> <tags...>`. These would map to specific parsers using `Samovar::One` and `Samovar::Many` internally.
 
-#### Global Options
+### Global Options
 
 Options can only be parsed at the place they are explicitly mentioned, e.g. a command with sub-commands won't parse an option added to the end of the command:
 
-```ruby
+``` ruby
 command list --help
 ```
 
 One might reasonably expect this to parse but it isn't so easy to generalize this:
 
-```ruby
+``` ruby
 command list -- --help
 ```
 
 In this case, do we show help? Some effort is required to disambiguate this. Initially, it makes sense to keep things as simple as possible. But, it might make sense for some options to be declared in a global scope, which are extracted before parsing begins. I'm not sure if this is really a good idea. It might just be better to give good error output in this case (you specified an option but it was in the wrong place).
 
-#### Shell Auto-completion
+### Shell Auto-completion
 
 Because of the structure of the Samovar command parser, it should be possible to generate a list of all possible tokens at each point. Therefore, semantically correct tab completion should be possible.
 
 As a secondary to this, it would be nice if `Samovar::One` and `Samovar::Many` could take a list of potential tokens so that auto-completion could give meaningful suggestions, and possibly improved validation.
 
-#### Short/Long Help
+### Short/Long Help
 
 It might be interesting to explore whether it's possible to have `-h` and `--help` do different things. This could include command specific help output, more detailed help output (similar to a man page), and other useful help related tasks.
-
-## License
-
-Released under the MIT license.
-
-Copyright, 2016, by [Samuel G. D. Williams](http://www.codeotaku.com/samuel-williams).
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.

metadata

@@ -1,17 +1,47 @@
 --- !ruby/object:Gem::Specification
 name: samovar
 version: !ruby/object:Gem::Version
-  version: 2.1.4
+  version: 2.2.0
 platform: ruby
 authors:
 - Samuel Williams
-autorequire: 
+- Gabriel Mazetto
+autorequire:
 bindir: bin
-cert_chain: []
-date: 2020-01-26 00:00:00.000000000 Z
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIE2DCCA0CgAwIBAgIBATANBgkqhkiG9w0BAQsFADBhMRgwFgYDVQQDDA9zYW11
+  ZWwud2lsbGlhbXMxHTAbBgoJkiaJk/IsZAEZFg1vcmlvbnRyYW5zZmVyMRIwEAYK
+  CZImiZPyLGQBGRYCY28xEjAQBgoJkiaJk/IsZAEZFgJuejAeFw0yMjA4MDYwNDUz
+  MjRaFw0zMjA4MDMwNDUzMjRaMGExGDAWBgNVBAMMD3NhbXVlbC53aWxsaWFtczEd
+  MBsGCgmSJomT8ixkARkWDW9yaW9udHJhbnNmZXIxEjAQBgoJkiaJk/IsZAEZFgJj
+  bzESMBAGCgmSJomT8ixkARkWAm56MIIBojANBgkqhkiG9w0BAQEFAAOCAY8AMIIB
+  igKCAYEAomvSopQXQ24+9DBB6I6jxRI2auu3VVb4nOjmmHq7XWM4u3HL+pni63X2
+  9qZdoq9xt7H+RPbwL28LDpDNflYQXoOhoVhQ37Pjn9YDjl8/4/9xa9+NUpl9XDIW
+  sGkaOY0eqsQm1pEWkHJr3zn/fxoKPZPfaJOglovdxf7dgsHz67Xgd/ka+Wo1YqoE
+  e5AUKRwUuvaUaumAKgPH+4E4oiLXI4T1Ff5Q7xxv6yXvHuYtlMHhYfgNn8iiW8WN
+  XibYXPNP7NtieSQqwR/xM6IRSoyXKuS+ZNGDPUUGk8RoiV/xvVN4LrVm9upSc0ss
+  RZ6qwOQmXCo/lLcDUxJAgG95cPw//sI00tZan75VgsGzSWAOdjQpFM0l4dxvKwHn
+  tUeT3ZsAgt0JnGqNm2Bkz81kG4A2hSyFZTFA8vZGhp+hz+8Q573tAR89y9YJBdYM
+  zp0FM4zwMNEUwgfRzv1tEVVUEXmoFCyhzonUUw4nE4CFu/sE3ffhjKcXcY//qiSW
+  xm4erY3XAgMBAAGjgZowgZcwCQYDVR0TBAIwADALBgNVHQ8EBAMCBLAwHQYDVR0O
+  BBYEFO9t7XWuFf2SKLmuijgqR4sGDlRsMC4GA1UdEQQnMCWBI3NhbXVlbC53aWxs
+  aWFtc0BvcmlvbnRyYW5zZmVyLmNvLm56MC4GA1UdEgQnMCWBI3NhbXVlbC53aWxs
+  aWFtc0BvcmlvbnRyYW5zZmVyLmNvLm56MA0GCSqGSIb3DQEBCwUAA4IBgQB5sxkE
+  cBsSYwK6fYpM+hA5B5yZY2+L0Z+27jF1pWGgbhPH8/FjjBLVn+VFok3CDpRqwXCl
+  xCO40JEkKdznNy2avOMra6PFiQyOE74kCtv7P+Fdc+FhgqI5lMon6tt9rNeXmnW/
+  c1NaMRdxy999hmRGzUSFjozcCwxpy/LwabxtdXwXgSay4mQ32EDjqR1TixS1+smp
+  8C/NCWgpIfzpHGJsjvmH2wAfKtTTqB9CVKLCWEnCHyCaRVuKkrKjqhYCdmMBqCws
+  JkxfQWC+jBVeG9ZtPhQgZpfhvh+6hMhraUYRQ6XGyvBqEUe+yo6DKIT3MtGE2+CP
+  eX9i9ZWBydWb8/rvmwmX2kkcBbX0hZS1rcR593hGc61JR6lvkGYQ2MYskBveyaxt
+  Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
+  voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
+  -----END CERTIFICATE-----
+date: 2023-06-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: mapping
+  name: console
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
@@ -25,7 +55,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '1.0'
 - !ruby/object:Gem::Dependency
-  name: console
+  name: mapping
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
@@ -39,7 +69,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '1.0'
 - !ruby/object:Gem::Dependency
-  name: covered
+  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -53,7 +83,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: bundler
+  name: covered
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -67,46 +97,25 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: sus
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '10.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '10.0'
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.6'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.6'
-description: 
+        version: '0'
+description:
 email:
-- samuel.williams@oriontransfer.co.nz
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- ".rspec"
-- ".travis.yml"
-- Gemfile
-- README.md
-- Rakefile
 - lib/samovar.rb
 - lib/samovar/command.rb
 - lib/samovar/error.rb
@@ -126,22 +135,14 @@ files:
 - lib/samovar/split.rb
 - lib/samovar/table.rb
 - lib/samovar/version.rb
-- samovar.gemspec
-- spec/samovar/coerce_spec.rb
-- spec/samovar/command_spec.rb
-- spec/samovar/many_spec.rb
-- spec/samovar/nested_spec.rb
-- spec/samovar/one_spec.rb
-- spec/samovar/options_spec.rb
-- spec/samovar/split_spec.rb
-- spec/samovar/table_spec.rb
-- spec/spec_helper.rb
-- teapot.png
+- license.md
+- readme.md
 homepage: https://github.com/ioquatix/samovar
 licenses:
 - MIT
-metadata: {}
-post_install_message: 
+metadata:
+  funding_uri: https://github.com/sponsors/ioquatix/
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -156,18 +157,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
-signing_key: 
+rubygems_version: 3.4.7
+signing_key:
 specification_version: 4
 summary: Samovar is a flexible option parser excellent support for sub-commands and
   help documentation.
-test_files:
-- spec/samovar/coerce_spec.rb
-- spec/samovar/command_spec.rb
-- spec/samovar/many_spec.rb
-- spec/samovar/nested_spec.rb
-- spec/samovar/one_spec.rb
-- spec/samovar/options_spec.rb
-- spec/samovar/split_spec.rb
-- spec/samovar/table_spec.rb
-- spec/spec_helper.rb
+test_files: []

metadata.gz.sig

@@ -0,0 +1,2 @@
+���S�O˳=�eƗ��Mo�֔4�����BS�}�Z��>iS���D���m�;m����n�O���Va��dmU#��/�������=��>�]D r៌~K���=�pkГL.U��R��<G�
+x����q�6:A�~�l�=U�#3lb�7�hqj�X@��_D��� 3�M1�)V���4�;���������t9g��ǜv��H��p�`��wta��ܪK�

data/.gitignore

@@ -1,11 +0,0 @@
-/.bundle/
-/.yardoc
-/Gemfile.lock
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/tmp/
-.rspec_status
-.tags

data/.rspec

@@ -1,4 +0,0 @@
---format documentation
---backtrace
---warnings
---require spec_helper

data/.travis.yml

@@ -1,20 +0,0 @@
-language: ruby
-dist: xenial
-cache: bundler
-
-matrix:
-  include:
-    - rvm: 2.3
-    - rvm: 2.4
-    - rvm: 2.5
-    - rvm: 2.6
-    - rvm: 2.6
-      env: COVERAGE=BriefSummary,Coveralls
-    - rvm: truffleruby
-    - rvm: jruby-head
-      env: JRUBY_OPTS="--debug -X+O"
-    - rvm: ruby-head
-  allow_failures:
-    - rvm: ruby-head
-    - rvm: truffleruby
-    - rvm: jruby-head

data/Gemfile

@@ -1,8 +0,0 @@
-source 'https://rubygems.org'
-
-# Specify your gem's dependencies in samovar.gemspec
-gemspec
-
-group :test do
-	gem 'pry'
-end

data/Rakefile

@@ -1,9 +0,0 @@
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
-
-# Load all rake tasks:
-import(*Dir.glob('tasks/**/*.rake'))
-
-RSpec::Core::RakeTask.new(:test)
-
-task :default => :test

data/samovar.gemspec

@@ -1,28 +0,0 @@
-# coding: utf-8
-lib = File.expand_path('../lib', __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'samovar/version'
-
-Gem::Specification.new do |spec|
-	spec.name          = "samovar"
-	spec.version       = Samovar::VERSION
-	spec.authors       = ["Samuel Williams"]
-	spec.email         = ["samuel.williams@oriontransfer.co.nz"]
-
-	spec.summary       = %q{Samovar is a flexible option parser excellent support for sub-commands and help documentation.}
-	spec.homepage      = "https://github.com/ioquatix/samovar"
-	spec.license       = "MIT"
-
-	spec.files         = `git ls-files`.split($/)
-	spec.executables   = spec.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
-	spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
-	spec.require_paths = ["lib"]
-	
-	spec.add_dependency "mapping", "~> 1.0"
-	spec.add_dependency "console", "~> 1.0"
-
-	spec.add_development_dependency "covered"
-	spec.add_development_dependency "bundler"
-	spec.add_development_dependency "rake", "~> 10.0"
-	spec.add_development_dependency "rspec", "~> 3.6"
-end

data/spec/samovar/coerce_spec.rb

@@ -1,45 +0,0 @@
-# Copyright, 2019, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-# 
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-# 
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-
-require 'samovar'
-
-module Samovar::CoerceSpec
-	class Coerce < Samovar::Command
-		options do
-			option '--things <array>', "A list of things" do |input|
-				input.split(/\s*,\s*/)
-			end
-			
-			option '--count <integer>', "A number to count", type: Integer
-		end
-	end
-
-	RSpec.describe Samovar::Command do
-		it "should coerce to array" do
-			top = Coerce['--things', 'a,b,c']
-			expect(top.options[:things]).to be == ['a', 'b', 'c']
-		end
-		
-		it "should coerce to integer" do
-			top = Coerce['--count', '10']
-			expect(top.options[:count]).to be == 10
-		end
-	end
-end

data/spec/samovar/command_spec.rb

@@ -1,91 +0,0 @@
-# Copyright, 2019, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-# 
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-# 
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-
-require 'samovar'
-
-module Samovar::CommandSpec
-	class Bottom < Samovar::Command
-		self.description = "Create a new teapot package using the specified repository."
-		
-		one :project_name, "The name of the new project in title-case, e.g. 'My Project'."
-		many :packages, "Any additional packages you'd like to include in the project."
-		split :argv, "Additional arguments to be passed to the sub-process."
-	end
-
-	class Top < Samovar::Command
-		self.description = "A decentralised package manager and build tool."
-		
-		options do
-			option '-c/--configuration <name>', "Specify a specific build configuration.", default: 'TEAPOT_CONFIGURATION'
-			option '-i/--in/--root <path>', "Work in the given root directory."
-			option '--verbose | --quiet', "Verbosity of output for debugging.", key: :logging
-			option '-h/--help', "Print out help information."
-			option '-v/--version', "Print out the application version."
-		end
-		
-		nested :command, {
-			'bottom' => Bottom
-		}
-	end
-
-	RSpec.describe Samovar::Command do
-		it "should invoke call" do
-			expect(Top).to receive(:new).and_wrap_original do |original_method, *arguments, &block|
-				original_method.call(*arguments, &block).tap do |instance|
-					expect(instance).to receive(:call)
-				end
-			end
-			
-			Top.call([])
-		end
-		
-		it "should use default value" do
-			top = Top[]
-			expect(top.options[:configuration]).to be == 'TEAPOT_CONFIGURATION'
-		end
-		
-		it "can update options" do
-			top = Top[]
-			expect(top.options[:configuration]).to be == 'TEAPOT_CONFIGURATION'
-			
-			top = top['--verbose']
-			expect(top.options[:configuration]).to be == 'TEAPOT_CONFIGURATION'
-			expect(top.options[:logging]).to be == :verbose
-		end
-		
-		it "should parse a simple command" do
-			top = Top["-c", "path", "bottom", "foobar", "A", "B", "--", "args", "args"]
-			
-			expect(top.options[:configuration]).to be == 'path'
-			expect(top.command.class).to be == Bottom
-			expect(top.command.project_name).to be == 'foobar'
-			expect(top.command.packages).to be == ['A', 'B']
-			expect(top.command.argv).to be == ["args", "args"]
-		end
-		
-		it "should generate documentation" do
-			top = Top[]
-			buffer = StringIO.new
-			top.print_usage(output: buffer)
-			
-			expect(buffer.string).to be_include(Top.description)
-		end
-	end
-end

data/spec/samovar/many_spec.rb

@@ -1,49 +0,0 @@
-# Copyright, 2019, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-# 
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-# 
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-
-require 'samovar/many'
-
-RSpec.describe Samovar::Many do
-	let(:default) {["1", "2", "3"]}
-	let(:input) {["2", "3", "--else"]}
-	
-	subject{described_class.new(:items, "some items", default: default)}
-	
-	it "has string representation" do
-		expect(subject.to_s).to be == "<items...>"
-	end
-	
-	it "should have default" do
-		expect(subject.default).to be == default
-	end
-	
-	it "should use default" do
-		expect(subject.parse([])).to be == default
-	end
-	
-	it "should use specified default" do
-		expect(subject.parse([], nil, ["2"])).to be == ["2"]
-	end
-	
-	it "should not use default if input specified" do
-		expect(subject.parse(input)).to be == ["2", "3"]
-		expect(input).to be == ["--else"]
-	end
-end