optimist 3.0.1 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1cab432ee3e689f1cfbb1a53a0ef94e3c912cdc54fca85e5c92b2cd0a9b82561
-  data.tar.gz: 67ec3054aa363ece24f9d0f57f03414581a1d11558c2df913a42ba1394db932f
+  metadata.gz: 87e142709336212fa484755022a85b8d833de889579b69a1b2fc35933bac88fd
+  data.tar.gz: 4ac2b33acae583f3ce444c105112c144a32affc52a8ab52980ab9772a107f8c3
 SHA512:
-  metadata.gz: 1abab08da653806a765f24afc1c838eddefe7461a12a0e75505ddfa6eb86cc9d2f85205d407f71f420ebd61c64600c27159b4b1915d51ba36d02099b7163ce65
-  data.tar.gz: a3f5fffb9d1e5ee2d479cd66ff8ecfaf2af34e41776be4b135abfb8281f54adcdcf6e23c98e834cf9b8f207c7141d67a3fe1ef2ce50274930a9200da796262a3
+  metadata.gz: 7ccadd2b388b3877e3a075e224b7b9f1ed3b48a4dd68a72a6ca7f8ca9120c999a366d0619bf1cfcec0018fd80baeab83fd8e686e35f91109668c4d0210e08ddd
+  data.tar.gz: '0312801235dc1952812a79d01d68b71cff4db8187040cbc74f299bb519d926dc01fed15f0c656ca7d09e18dcd18289b1d951917cc31c8a8e1bfaa1377cbcde99'

data/.codeclimate.yml

@@ -0,0 +1,16 @@
+prepare:
+  fetch:
+  - url: https://raw.githubusercontent.com/ManageIQ/manageiq-style/master/.rubocop_base.yml
+    path: ".rubocop_base.yml"
+  - url: https://raw.githubusercontent.com/ManageIQ/manageiq-style/master/.rubocop_cc_base.yml
+    path: ".rubocop_cc_base.yml"
+  - url: https://raw.githubusercontent.com/ManageIQ/manageiq-style/master/styles/base.yml
+    path: styles/base.yml
+  - url: https://raw.githubusercontent.com/ManageIQ/manageiq-style/master/styles/cc_base.yml
+    path: styles/cc_base.yml
+plugins:
+  rubocop:
+    enabled: true
+    config: ".rubocop_cc.yml"
+    channel: rubocop-0-82
+version: '2'

data/.github/workflows/ci.yaml

@@ -0,0 +1,34 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+  schedule:
+  - cron: '0 0 * * 0'
+
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby-version:
+        - '2.4'
+        - '2.5'
+        - '2.6'
+        - '2.7'
+        - '3.0'
+        - '3.1'
+        - '3.2'
+        - jruby-9.3
+        - ruby-head
+        - jruby-head
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby-version }}
+        bundler-cache: true
+    - name: Run tests
+      run: bundle exec rake

data/.rubocop.yml

@@ -0,0 +1,4 @@
+inherit_gem:
+  manageiq-style: ".rubocop_base.yml"
+inherit_from:
+- ".rubocop_local.yml"

data/.rubocop_cc.yml

@@ -0,0 +1,4 @@
+inherit_from:
+- ".rubocop_base.yml"
+- ".rubocop_cc_base.yml"
+- ".rubocop_local.yml"

data/.whitesource

@@ -0,0 +1,3 @@
+{
+  "settingsInheritedFrom": "ManageIQ/whitesource-config@master"
+}

data/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Change Log
+All notable changes to this project will be documented in this file.
+This project adheres to [Semantic Versioning](http://semver.org/).
+
+## [Unreleased]
+
+## [3.1.0] - 2023-07-24
+### Added
+- Implement `either` command ([#130](https://github.com/ManageIQ/optimist/pull/130))
+
+[Unreleased]: https://github.com/ManageIQ/optimist/compare/v3.1.0...HEAD
+[3.1.0]: https://github.com/ManageIQ/optimist/compare/v3.0.1...v3.1.0

data/README.md

@@ -3,10 +3,9 @@
 http://manageiq.github.io/optimist/
 
 [![Gem Version](https://badge.fury.io/rb/optimist.svg)](http://badge.fury.io/rb/optimist)
-[![Build Status](https://travis-ci.org/ManageIQ/optimist.svg)](https://travis-ci.org/ManageIQ/optimist)
-[![Code Climate](https://codeclimate.com/github/ManageIQ/optimist/badges/gpa.svg)](https://codeclimate.com/github/ManageIQ/optimist)
+[![CI](https://github.com/ManageIQ/optimist/actions/workflows/ci.yaml/badge.svg)](https://github.com/ManageIQ/optimist/actions/workflows/ci.yaml)
+[![Code Climate](https://codeclimate.com/github/ManageIQ/optimist.svg)](https://codeclimate.com/github/ManageIQ/optimist)
 [![Coverage Status](http://img.shields.io/coveralls/ManageIQ/optimist.svg)](https://coveralls.io/r/ManageIQ/optimist)
-[![Dependency Status](https://gemnasium.com/ManageIQ/optimist.svg)](https://gemnasium.com/ManageIQ/optimist)
 
 ## Documentation
 

data/lib/optimist.rb

@@ -6,9 +6,7 @@
 require 'date'
 
 module Optimist
-  # note: this is duplicated in gemspec
-  # please change over there too
-VERSION = "3.0.1"
+VERSION = "3.1.0"
 
 ## Thrown by Parser in the event of a commandline error. Not needed if
 ## you're using the Optimist::options entry.
@@ -199,6 +197,13 @@ class Parser
     @constraints << [:conflicts, syms]
   end
 
+  ## Marks two (or more!) options as required but mutually exclusive.
+  def either(*syms)
+    syms.each { |sym| raise ArgumentError, "unknown option '#{sym}'" unless @specs[sym] }
+    @constraints << [:conflicts, syms]
+    @constraints << [:either, syms]
+  end
+
   ## Defines a set of words which cause parsing to terminate when
   ## encountered, such that any options to the left of the word are
   ## parsed as usual, and options to the right of the word are left
@@ -298,13 +303,16 @@ class Parser
     ## check constraint satisfaction
     @constraints.each do |type, syms|
       constraint_sym = syms.find { |sym| given_args[sym] }
-      next unless constraint_sym
 
       case type
       when :depends
+        next unless constraint_sym
         syms.each { |sym| raise CommandlineError, "--#{@specs[constraint_sym].long} requires --#{@specs[sym].long}" unless given_args.include? sym }
       when :conflicts
+        next unless constraint_sym
         syms.each { |sym| raise CommandlineError, "--#{@specs[constraint_sym].long} conflicts with --#{@specs[sym].long}" if given_args.include?(sym) && (sym != constraint_sym) }
+      when :either
+        raise CommandlineError, "one of #{syms.map { |sym| "--#{@specs[sym].long}" }.join(', ') } is required" if (syms & given_args.keys).size != 1
       end
     end
 

data/optimist.gemspec

@@ -29,7 +29,8 @@ specify."
 
   spec.require_paths = ["lib"]
 
-  spec.add_development_dependency "minitest", "~> 5.4.3"
-  spec.add_development_dependency "rake", "~> 10.0"
   spec.add_development_dependency "chronic"
+  spec.add_development_dependency "manageiq-style"
+  spec.add_development_dependency "minitest",      "~> 5.4.3"
+  spec.add_development_dependency "rake",          ">= 10.0"
 end

data/test/optimist/parser_test.rb

@@ -253,6 +253,8 @@ class ParserTest < ::MiniTest::Test
   def test_long_detects_bad_names
     @p.opt "goodarg", "desc", :long => "none"
     @p.opt "goodarg2", "desc", :long => "--two"
+    @p.opt "goodarg3", "desc", :long => "arg-3"
+    @p.opt "goodarg4", "desc", :long => "--good-arg-four"
     assert_raises(ArgumentError) { @p.opt "badarg", "desc", :long => "" }
     assert_raises(ArgumentError) { @p.opt "badarg2", "desc", :long => "--" }
     assert_raises(ArgumentError) { @p.opt "badarg3", "desc", :long => "-one" }
@@ -347,6 +349,14 @@ class ParserTest < ::MiniTest::Test
     assert_equal true, opts[:defaultfalse]
     assert_equal true, opts[:defaulttrue]
 
+    ## using short form turns them all on, regardless of default
+    #
+    # (matches positve "non-no" long form)
+    opts = @p.parse %w(-d -e -f)
+    assert_equal true, opts[:defaultnone]
+    assert_equal true, opts[:defaultfalse]
+    assert_equal true, opts[:defaulttrue]
+
     ## using --no- form turns them off, regardless of default
     opts = @p.parse %w(--no-defaultfalse --no-defaulttrue --no-defaultnone)
     assert_equal false, opts[:defaultnone]
@@ -378,6 +388,14 @@ class ParserTest < ::MiniTest::Test
     assert_equal false, opts[:no_default_false]
     assert_equal false, opts[:no_default_true]
 
+    ## using short form turns them all off, regardless of default
+    #
+    # (matches positve "non-no" long form)
+    opts = @p.parse %w(-n -o -d)
+    assert_equal false, opts[:no_default_none]
+    assert_equal false, opts[:no_default_false]
+    assert_equal false, opts[:no_default_true]
+
     ## disallow double negatives for reasons of sanity preservation
     assert_raises(CommandlineError) { @p.parse %w(--no-no-default-true) }
   end
@@ -745,6 +763,34 @@ Options:
     assert_raises(CommandlineError) { @p.parse %w(--one --mellow --two --jello) }
   end
 
+  def test_either
+    @p.opt :one
+    assert_raises(ArgumentError) { @p.either :one, :two }
+    @p.opt :two
+    @p.either :one, :two
+    @p.parse %w(--one)
+    @p.parse %w(--two)
+    assert_raises(CommandlineError) { @p.parse %w(--one --two) }
+    assert_raises(CommandlineError) { @p.parse %w() }
+
+    @p.opt :hello
+    @p.opt :yellow
+    @p.opt :mellow
+    @p.opt :jello
+    @p.either :hello, :yellow, :mellow, :jello
+    assert_raises(CommandlineError) { @p.parse %w(--hello --yellow --mellow --jello) }
+    assert_raises(CommandlineError) { @p.parse %w(--hello --mellow --jello) }
+    assert_raises(CommandlineError) { @p.parse %w(--hello --jello) }
+
+    @p.parse %w(--hello --one)
+    @p.parse %w(--jello --two)
+    @p.parse %w(--mellow --one)
+    @p.parse %w(--mellow --two)
+
+    assert_raises(CommandlineError) { @p.parse %w(--mellow --two --jello) }
+    assert_raises(CommandlineError) { @p.parse %w(--one --mellow --two --jello) }
+  end
+
   def test_conflict_error_messages
     @p.opt :one
     @p.opt "two"

metadata

@@ -1,59 +1,73 @@
 --- !ruby/object:Gem::Specification
 name: optimist
 version: !ruby/object:Gem::Version
-  version: 3.0.1
+  version: 3.1.0
 platform: ruby
 authors:
 - William Morgan
 - Keenan Brock
 - Jason Frey
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-04-20 00:00:00.000000000 Z
+date: 2023-07-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: minitest
+  name: chronic
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 5.4.3
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 5.4.3
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: manageiq-style
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: 5.4.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: 5.4.3
 - !ruby/object:Gem::Dependency
-  name: chronic
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '10.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '10.0'
 description: |-
   Optimist is a commandline option parser for Ruby that just
   gets out of your way. One line of code per option is all you need to write.
@@ -65,8 +79,14 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".codeclimate.yml"
+- ".github/workflows/ci.yaml"
 - ".gitignore"
-- ".travis.yml"
+- ".rubocop.yml"
+- ".rubocop_cc.yml"
+- ".rubocop_local.yml"
+- ".whitesource"
+- CHANGELOG.md
 - FAQ.txt
 - Gemfile
 - History.txt
@@ -92,7 +112,7 @@ metadata:
   changelog_uri: https://github.com/ManageIQ/optimist/blob/master/History.txt
   source_code_uri: https://github.com/ManageIQ/optimist/
   bug_tracker_uri: https://github.com/ManageIQ/optimist/issues
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -107,8 +127,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
-signing_key: 
+rubygems_version: 3.2.33
+signing_key:
 specification_version: 4
 summary: Optimist is a commandline option parser for Ruby that just gets out of your
   way.

data/.travis.yml

@@ -1,14 +0,0 @@
-language: ruby
-cache: bundler
-rvm:
-  - 2.2
-  - 2.3
-  - 2.4
-  - 2.5
-  - 2.6
-  - 2.7
-  - jruby-head
-matrix:
-  allow_failures:
-    - rvm: jruby-head
-  fast_finish: true