paramesan 0.1.1 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 0bfb52b50a307d046717c886e122aa64c680768b
-  data.tar.gz: f0fdd9c4a90297441214fd2b751a95e508c7d90e
+SHA256:
+  metadata.gz: e00f05f91468e4240889bb7c976377cd0189a1892e4a5c7f0abfa9bc6abba7e1
+  data.tar.gz: 077f992190dc1ec5c72d70f0825df780c3e069a2116ab74856b4c3dcd7c8cf25
 SHA512:
-  metadata.gz: e8f0a813d29eb2f5ecdb4710d0a7f08a42853d8faadb1faf7929b841d3b1522f96def9b17ea44a25138f4b75e9c27615ceb9b79f78fd1659c5db236f34eabef0
-  data.tar.gz: acd88b9b4b37e7f510fbff09f498129124b44c3954d3efc5d870d25ae4214b6889939a749cf5ec8a9ba7dff57727cb035a7edefaeee73d77209c3e9f3444e29c
+  metadata.gz: 650e9a7d8d17e5304d4c6189e649c78e5d2fac4612a6db1d721fb600a23b56e6d9ba2cc487f4871163270cdfb858d5d9c477f827cfd77bffd273674d17dbf4bc
+  data.tar.gz: 12d4110cb1102045ec4d81a8a0cae71d24ff80debb1c7688252804026dba72ffc74e9844d32c48b5d3d4e890a12e337bad3cb21dcdc9a7c1fb316afa724dd1ca

data/README.md

@@ -13,58 +13,86 @@ unit tests, which initially focused on the behavior (the process or code), then
 and output as data that go through the process.
 
 I looked for the equivalent in Ruby, and the closest that I found was
-[param_test](https://www.ruby-toolbox.com/projects/param_test). That, however, uses activesupport,
-which is included in Rails, but I wanted a version that ran in a pure Ruby environment, using only
-Test::Unit, which I prefer over Minitest, mainly because the latter uses notifications that don't
-work especially well with Emacs, such as changing the mode line to show the success/failure status,
-but do not afterward change back to the default settings.
+[param_test](https://www.ruby-toolbox.com/projects/param_test). That uses activesupport, which is
+included in Rails, but I wanted a version that ran in a pure Ruby environment, using only the
+test-unit gem. I prefer that over Minitest, mainly because the latter uses notifications that don't
+work especially well with Emacs.
 
-Ergo, paramesan, which as of this writing, allows a very primitive set of options for parameterized
-tests.
+Ergo, Paramesan, which as of this writing, supports a set of options for parameterized tests.
 
 # Example
 
 ## Before
 
-31 lines.
+58 lines.
 
 ```ruby
 require 'pvn/log/options'
 require 'test/unit'
 
 class FormatOptionTest < Test::Unit::TestCase
-  def assert_formatter expected, *types
-    types.each do |type|
-      fmtr = Pvn::Log::FormatOption.new type
-      assert_kind_of expected, fmtr.formatter, "type: #{type}"
-    end
+  def assert_formatter expected, type
+    fmtr = Pvn2::Log::FormatOption.new type
+    assert_kind_of expected, fmtr.formatter, "type: #{type}"
   end
   
-  def test_oneline
-    assert_formatter Pvn::Log::FormatOneLine, "single", "single-line", "si", "oneline"
+  def test_oneline_single
+    assert_formatter Pvn2::Log::FormatOneLine, "single"
+  end
+
+  def test_oneline_si
+    assert_formatter Pvn2::Log::FormatOneLine, "si"
+  end
+
+  def test_oneline_oneline
+    assert_formatter Pvn2::Log::FormatOneLine, "oneline"
+  end
+
+  def test_summary_summary
+    assert_formatter Pvn2::Log::FormatSummary, "summary"
+  end
+
+  def test_summary_su
+    assert_formatter Pvn2::Log::FormatSummary, "su"
+  end
+
+  def test_revision_revision
+    assert_formatter Pvn2::Log::FormatRevision, "revision"
+  end
+
+  def test_revision_author_revauthor
+    assert_formatter Pvn2::Log::FormatRevisionAuthor, "revauthor"
   end
 
-  def test_summary
-    assert_formatter Pvn::Log::FormatSummary, "summary", "su"
+  def test_revision_author_revauth
+    assert_formatter Pvn2::Log::FormatRevisionAuthor, "revauth"
   end
 
-  def test_revision_only
-    assert_formatter Pvn::Log::FormatRevisionOnly, "revision", "rev", "revisiononly"
+  def test_revision_author_revisionauthor
+    assert_formatter Pvn2::Log::FormatRevisionAuthor, "revisionauthor"
   end
 
-  def test_revision_author
-    assert_formatter Pvn::Log::FormatRevisionAuthor, "revauthor", "revauth", "revisionauthor"
+  def test_colorized_color
+    assert_formatter Pvn2::Log::FormatColorized, "color"
   end
 
-  def test_colorized
-    assert_formatter Pvn::Log::FormatColorized, "color", "colorized"
+  def test_colorized_colorized
+    assert_formatter Pvn2::Log::FormatColorized, "colorized"
+  end
+
+  def test_tree_tree
+    assert_formatter Pvn2::Log::FormatTree, "tree"
+  end
+    
+  def test_tree_zzz
+    assert_formatter Pvn2::Log::FormatTree, "zzz"
   end
 end
 ```
 
 ## After
 
-20 lines, 35% fewer.
+17 lines.
 
 ```ruby
 require 'pvn/log/options'
@@ -73,19 +101,89 @@ require 'paramesan'
 
 class FormatOptionTest < Test::Unit::TestCase
   extend Paramesan
-  
+
   param_test [
-    [ Pvn::Log::FormatOneLine,        "single", "single-line", "si", "oneline" ],
-    [ Pvn::Log::FormatSummary,        "summary", "su" ],
-    [ Pvn::Log::FormatRevisionOnly,   "revision", "rev", "revisiononly" ],
-    [ Pvn::Log::FormatRevisionAuthor, "revauthor", "revauth", "revisionauthor" ],
-    [ Pvn::Log::FormatColorized,      "color", "colorized" ],
+    [ Pvn2::Log::FormatOneLine,        "oneline", "single", "si" ],
+    [ Pvn2::Log::FormatSummary,        "summary", "sum" ],
+    [ Pvn2::Log::FormatRevision,       "revision" ],
+    [ Pvn2::Log::FormatRevisionAuthor, "revisionauthor", "revauthor", "revauth" ],
+    [ Pvn2::Log::FormatColorized,      "colorized", "color", "full" ],
+    [ Pvn2::Log::FormatMessage,        "message" ],
+    [ Pvn2::Log::FormatTree,           "tree", "zzz" ],
   ] do |exp, *types|
-    fmts = Pvn::Log::Formats.new
+    types.each do |type|
+      assert_kind_of exp, Pvn2::Log::FormatOption.new(type).formatter, "type: #{type}"
+    end
+  end
+end
+```
+
+The Paramesan code generates a test method for each parameter set, as for example, with the last
+test case, which fails:
+
+```text
+Error: test__Pvn2_Log_FormatTree_tree_zzz_(FormatsTest): RuntimeError: invalid format zzz not one of: author colorized full message oneline revauthor revision revisionauthor single summary tree
+/opt/proj/pvn2/lib/pvn2/log/formats.rb:46:in `class_for'
+/opt/proj/pvn2/lib/pvn2/log/options.rb:19:in `initialize'
+/opt/proj/pvn2/test/pvn2/log/formats_test.rb:134:in `new'
+/opt/proj/pvn2/test/pvn2/log/formats_test.rb:134:in `block (2 levels) in <class:FormatsTest>'
+/opt/proj/pvn2/test/pvn2/log/formats_test.rb:133:in `each'
+/opt/proj/pvn2/test/pvn2/log/formats_test.rb:133:in `block in <class:FormatsTest>'
+/home/jpace/.rvm/gems/ruby-2.3.0/gems/paramesan-0.1.1/lib/paramesan.rb:19:in `instance_exec'
+/home/jpace/.rvm/gems/ruby-2.3.0/gems/paramesan-0.1.1/lib/paramesan.rb:19:in `block (2 levels) in param_test'
+```
+
+# Common Parameters
+
+Sometimes the same set of parameters is used in multiple tests. To do that with Paramesan, simply
+define a class method returning those parameters, and adjust the param_test blocks:
+
+```ruby
+class FormatsTest < Test::Unit::TestCase
+  include Paramesan
+
+  def self.build_class_types_params
+    [
+      [ Pvn2::Log::FormatOneLine,        "oneline", "single", "si" ],
+      [ Pvn2::Log::FormatSummary,        "summary", "sum" ],
+      [ Pvn2::Log::FormatRevision,       "revision" ],
+      [ Pvn2::Log::FormatRevisionAuthor, "revisionauthor", "revauthor", "revauth" ],
+      [ Pvn2::Log::FormatColorized,      "colorized", "color", "full" ],
+      [ Pvn2::Log::FormatMessage,        "message" ],
+      [ Pvn2::Log::FormatTree,           "tree", "zzz" ],
+    ]
+  end
+  
+  param_test build_class_types_params do |exp, *types|
+    fmts = Pvn2::Log::Formats.new
     types.each do |type|
       assert_equal exp, fmts.class_for(type), "type: #{type}"
     end
   end
+
+  param_test build_class_types_params do |exp, *types|
+    types.each do |type|
+      assert_kind_of exp, Pvn2::Log::FormatOption.new(type).formatter, "type: #{type}"
+    end
+  end
+end
+```
+
+# Non Arrays
+
+The set of parameters does not have to consist of arrays. For example, using strings:
+
+```ruby
+class FormatsTest < Test::Unit::TestCase
+  include Paramesan
+
+  param_test %w{ abc def } do |str|
+    fmts = Pvn2::Log::Formats.new
+    expfmts = "author colorized full message oneline revauthor revision revisionauthor single summary tree"
+    assert_raise(RuntimeError.new "invalid format #{str} not one of: #{expfmts}") do
+      fmts.class_for str
+    end
+  end
 end
 ```
 

data/lib/paramesan.rb

@@ -6,13 +6,15 @@ require "paramesan/version"
 module Paramesan
   module ClassMethods
     def param_test paramlist, &blk
-      paramlist.each do |params|
-        basename = "test_" + params.to_s.gsub(Regexp.new('[^\w]+'), '_')
-        mname = basename
+      count = paramlist.count
+      paramlist.each_with_index do |params, idx|
+        name = param_test_name params, idx, count
 
-        count = 1
+        mname = name.to_sym
+        i = 0
         while instance_methods.include? mname.to_sym
-          mname += "_#{count}"
+          i += 1
+          mname = name + "_#{i}"
         end
 
         define_method mname do
@@ -20,6 +22,12 @@ module Paramesan
         end
       end
     end
+
+    def param_test_name params, idx, count
+      nonword = Regexp.new '[^\w]+'
+      elements = params.collect { |param| param.to_s.gsub nonword, '_' }
+      "test_" + idx.to_s + "_of_" + count.to_s + "__" + elements.join('_')
+    end
   end
 
   extend ClassMethods

data/lib/paramesan/version.rb

@@ -4,5 +4,5 @@
 require 'pathname'
 
 module Paramesan
-  VERSION = "0.1.1"
+  VERSION = "1.0.0"
 end

data/paramesan.gemspec

@@ -27,7 +27,7 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_development_dependency "bundler", "~> 1.12"
-  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "bundler", ">= 2.0"
+  spec.add_development_dependency "rake", ">= 13.0"
   spec.add_development_dependency "test-unit", "~> 3.1.5"
 end

metadata

@@ -1,43 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: paramesan
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 1.0.0
 platform: ruby
 authors:
 - Jeff Pace
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-08-29 00:00:00.000000000 Z
+date: 2020-10-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.12'
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.12'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: test-unit
   requirement: !ruby/object:Gem::Requirement
@@ -90,8 +90,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.3
+rubygems_version: 3.0.8
 signing_key: 
 specification_version: 4
 summary: Parameterized tests