probatio 1.6.1 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 392bd12c1d87f8e30b750cf32f99fd2d6264af68b9fcfe00f5d6a0e25343381b
-  data.tar.gz: 4d4d31f7a4a87725fc1e4f1bcde2670fd9a70382754aa7e4dda3bfc920693402
+  metadata.gz: ca8587e9a4b21f857e2a8a50603deff772d78e68ce320ad581a16dd1ba11dc89
+  data.tar.gz: 86b7da1f6f31f7cf16a7b2b2cb4c0fbb4f845496095168fbbc94c6b88a8ae40d
 SHA512:
-  metadata.gz: b11ce6b831b9c0dedb78d552329e8aec1366768e24e2b19a7d2e7e852833fe1aeb57119c3701d6ac89760eead1b9472c797a328098c85f9e92c7fad816106eed
-  data.tar.gz: 8879952a689f3718038407a1788a1cabd34ac0ddc9d385a8dad47f8159c5fe7275ab24495342b40bbef7f5568f0c629c22018408167aa7f4e5a2fd8c58eda32e
+  metadata.gz: a21ac68e3447c28f534127dfd34631f71c9e29cdb612ac62b73b136978e52d997eb62d5c1fd0084fdf941eb18b0bfed5ee0ba59471b35e64c238651785cc68c9
+  data.tar.gz: b98452d3e87e06790cdd3a79d1c60704a43b208d87330a01943d8d5f50126856cf989315eec9ba6608a6a044a52270c4d7c48fcf4cffd26bfef7453878a81c1b

data/CHANGELOG.md

@@ -2,6 +2,21 @@
 # CHANGELOG.md
 
 
+## probatio 1.7.0 released 2026-10-14
+
+* Introduce `park(*args, &block)` to "park" groups and tests
+* Log seed: and aseed: in .probatio-output.rb
+* Introduce Probatio::Tracer
+
+
+## probatio 1.6.2 released 2026-07-29
+
+* Introduce `refute` as counterpart to `assert` jack of some trades
+* Introduce `assert_not`
+* Indicate choke point on `before :each do`
+* Introduce bxp.fish, fish bxp completion
+
+
 ## probatio 1.6.1 released 2026-03-15
 
 * Fix issue with `assert_no_error`

data/README.md

@@ -106,7 +106,7 @@ group 'core' do
   setup do
     # occurs once before tests and sub-groups in group 'core'
   end
-  teadowm do
+  teardowm do
     # occurs once after tests and sub-groups in group 'core'
   end
 
@@ -126,6 +126,8 @@ group 'core' do
       assert_nil nil
       assert_not_nil [], 1
 
+      assert_not answers.include?('no')
+
       assert_true true
       assert_false 1 > 2
 
@@ -199,11 +201,25 @@ group 'core' do
         # assert equality between key and value
       assert 'one' => 'on' + 'e', 'two' => :two.to_s
         # assert equality between keys and values
+
+      refute 'one', /two/
+        # refute is the counter-part to assert...
     end
   end
 
   group 'bravo' do
   end
+
+  park 'not now' do
+    #
+    # everything within a `park` will be silently discarded
+
+    group 'coco' do
+      test 'this or that' do
+        assert false
+      end
+    end
+  end
 end
 
 group 'core' do

data/exe/proba

@@ -208,8 +208,12 @@ test_dir =
   is_directory_with_tests?('spec') ? 'spec' :
   'test'
 
-prev = Kernel.eval(File.read(Probatio.opath)) rescue { failures: [] }
-fails = prev[:failures].collect { |f| "#{f[:p]}:#{f[:l]}" }
+prev =
+  begin; Kernel.eval(File.read(Probatio.opath))
+  rescue Exception; { failures: [] }; end
+fails =
+  prev[:failures].collect { |f| "#{f[:p]}:#{f[:l]}" }
+
 #print 'fails:'; pp fails
   #
 tpoint = File.exist?(Probatio.tpath) ? File.read(Probatio.tpath).strip : nil

data/lib/probatio/assertions.rb

@@ -39,6 +39,11 @@ class Probatio::Context
     do_assert(as, 'false') { |a| a == false }
   end
 
+  def assert_not(*as)
+
+    do_assert(as, 'not') { |a| ! a }
+  end
+
   def assert_any(*as)
 
     do_assert(as, 'any') { |a| a.respond_to?(:size) && a.size > 0 }
@@ -62,6 +67,14 @@ class Probatio::Context
     do_assert(strings, 'matched') { |s| s.match?(rex) }
   end
 
+  def refute_match(*as)
+
+    strings, others = as.partition { |a| a.is_a?(String) }
+    rex = others.find { |o| o.is_a?(Regexp) } || strings.pop
+
+    do_assert(strings, 'not matched') { |s| ! s.match?(rex) }
+  end
+
   def assert_start_with(*as)
 
     fail ArgumentError.new(
@@ -124,6 +137,11 @@ class Probatio::Context
     do_assert(as[0].to_a, 'hashy equal') { |k, v| k == v }
   end
 
+  def refute_hashy(*as)
+
+    do_assert(as[0].to_a, 'hashy not equal') { |k, v| k != v }
+  end
+
   def assert_instance_of(*as)
 
     moc = as.find { |a| a.is_a?(Module) }
@@ -206,7 +224,15 @@ class Probatio::Context
 
   # Jack of all trade assert
   #
-  def assert(*as)
+  def assert(*as); jack(:assert, as); end
+
+  # Jack of all trade refute
+  #
+  def refute(*as); jack(:refute, as); end
+
+  protected
+
+  def jack(dir, as)
 
     count = {
       rexes: 0, hashes: 0, arrays: 0, strings: 0, scalars: 0, others: 0 }
@@ -224,27 +250,25 @@ class Probatio::Context
 
     if as.length == 1 && count[:hashes] == 1
 
-      assert_hashy(*as)
+      dir == :assert ? assert_hashy(*as) : refute_hashy(*as)
 
     elsif as.length == 1
 
-      assert_truthy(*as)
+      dir == :assert ? assert_truthy(*as) : assert_falsey(*as)
 
     elsif count[:rexes] == 1 && count[:strings] == as.length - 1
 
-      assert_match(*as)
+      dir == :assert ? assert_match(*as) : refute_match(*as)
 
     #elsif count[:arrays] > 0
-    #  assert_include(*as)
+    #  dir == :assert ? assert_include(*as) : refute_include(*as)
 
     else
 
-      assert_equal(*as)
+      dir == :assert ? assert_equal(*as) : assert_not(*as)
     end
   end
 
-  protected
-
   def do_assert(as, msg, &block)
 
     do_assert_(as) do
@@ -259,14 +283,18 @@ class Probatio::Context
 
   def do_assert_(as, &block)
 
-    Probatio.despatch(:assertion_enter, self, @__child)
+    ameloc = [
+      extract_assert_method(caller),
+      extract_file_and_line(caller) ]
+
+    Probatio.despatch(:assertion_enter, self, @__child, ameloc)
 
     case r =
       begin; block.call; rescue => err; err; end
 
     when StandardError, Hash, String
 
-      aerr = make_assertion_error(as, r)
+      aerr = Probatio::AssertionError.new(ameloc, as, r, @__child)
 
       Probatio.despatch(:test_fail, self, @__child, aerr)
 
@@ -274,7 +302,7 @@ class Probatio::Context
 
     when Exception
 
-      Probatio.despatch(:test_exception, self, @__child, r)
+      Probatio.despatch(:test_exception, self, @__child, r, ameloc)
 
       raise r
 
@@ -289,19 +317,7 @@ class Probatio::Context
 
   ensure
 
-    #Probatio.despatch(:test_succeed, self, @__child)
-    Probatio.despatch(:assertion_leave, self, @__child)
-  end
-
-  def make_assertion_error(arguments, result)
-
-    Probatio::AssertionError
-      .new(
-        extract_assert_method(caller),
-        arguments,
-        result,
-        @__child,
-        *extract_file_and_line(caller))
+    Probatio.despatch(:assertion_leave, self, @__child, ameloc)
   end
 
   def extract_file_and_line(backtrace)

data/lib/probatio/errors.rb

@@ -11,15 +11,15 @@ module Probatio
 
     alias path file
 
-    def initialize(assertion, arguments, error_or_message, test, file, line)
+    def initialize(ameloc, arguments, error_or_message, test)
+
+      @assertion = ameloc[0]
+      @file, @line = ameloc[1]
 
-      @assertion = assertion
       @arguments = arguments
 
       @test = test
 
-      @file = file
-      @line = line
 
       if error_or_message.is_a?(String)
         @msg = error_or_message
@@ -35,6 +35,7 @@ module Probatio
 
       [ @file, @line ]
     end
+    alias loca location
 
     def loc
 

data/lib/probatio/plugins.rb

@@ -218,9 +218,12 @@ class Probatio::ProbaOutputter
       '  ')
 
     File.open(Probatio.opath, 'wb') do |o|
+
       o << '# ' << Probatio.opath << "\n"
       o << "{\n"
-      o << "argv: " << Cerata.horizontal_a_to_s(ARGV) << ",\n"
+      o << 'argv: ' << Cerata.horizontal_a_to_s(ARGV) << ",\n"
+      o << 'seed:           ' << Probatio.seed.to_s << ",\n"
+      o << 'aseed: " --seed ' << Probatio.seed.to_s << " \",\n"
       o << "failures:\n"
       #o << "  [\n"
       #fls.each { |fl| o << '  ' << fl << ",\n" }
@@ -267,6 +270,28 @@ class Probatio::Exitter
   end
 end
 
+class Probatio::Tracer
+
+  def initialize
+
+    File.open(Probatio.cpath, 'wb') do |f|
+      f.puts("aa Probatio #{Probatio::VERSION} Tracer")
+      f.puts("aa ARGV #{ARGV.inspect}")
+    end
+  end
+
+  def on_pre(ev)
+
+    File.open(Probatio.cpath, 'ab') { |f| f.puts "PP --seed #{Probatio.seed}" }
+  end
+
+  def record(ev)
+
+    File.open(Probatio.cpath, 'ab') { |f| ev.trace(f) }
+#puts; puts File.read(Probatio.cpath)
+  end
+end
+
 Probatio.plug(Probatio::Recorder.new)
 Probatio.plug(Probatio::Chronometer.new)
 Probatio.plug(Probatio::DotReporter.new)
@@ -274,4 +299,5 @@ Probatio.plug(Probatio::VanillaSummarizer.new)
 Probatio.plug(Probatio::ProbaOutputter.new)
 Probatio.plug(Probatio::Beeper.new)
 Probatio.plug(Probatio::Exitter.new)
+Probatio.plug(Probatio::Tracer.new)
 

data/lib/probatio.rb

@@ -18,7 +18,7 @@ require 'probatio/more'
 
 module Probatio
 
-  VERSION = '1.6.1'
+  VERSION = '1.7.0'
 
   class << self
 
@@ -173,6 +173,7 @@ module Probatio
 
     def epath; '.probatio-environments.rb'; end
     def opath; '.probatio-output.rb'; end
+    def cpath; '.probatio-trace.log'; end
     def tpath; '.test-point'; end
 
     protected
@@ -323,6 +324,11 @@ module Probatio
       "#{@path}:#{line}"
     end
 
+    def loca
+
+      [ @path, line ]
+    end
+
     def to_s(opts={})
 
       col = Probatio.c
@@ -617,6 +623,11 @@ module Probatio
 
       @children << Probatio::Test.new(self, @path, name.to_s, opts, block)
     end
+
+    def park(*args)
+
+      # simply ignore...
+    end
   end
 
   class Leaf < Node
@@ -741,8 +752,11 @@ module Probatio
 
     def do_run(child, run_opts, &block)
 
-      fail ArgumentError.new("invalid child opts #{child.opts.inspect}") \
-        unless child.opts.is_a?(Hash)
+      fail ArgumentError.new(
+        "invalid opts #{child.opts.inspect} " +
+        "for child #{child.class} " +
+        "at #{child.path_and_line}"
+      ) unless child.opts.is_a?(Hash)
 
       return Probatio.despatch("#{child.type}_pending", self, child, run_opts) \
         if child.opts[:pending] || child.block.nil?
@@ -794,12 +808,13 @@ module Probatio
 
   class Event
 
-    attr_reader :tstamp, :delta
-    attr_reader :name, :opts, :context, :group, :leaf, :error
+    attr_reader :wstamp, :tstamp, :delta
+    attr_reader :name, :opts, :context, :group, :leaf, :ameloc, :error
     attr_accessor :leave_delta
 
     def initialize(name, details)
 
+      @wstamp = Time.now
       @tstamp, @delta = Probatio.monow_and_delta
 
       @name = name.to_s
@@ -807,6 +822,7 @@ module Probatio
       details.each do |d|
         case d
         when Hash then @opts = d
+        when Array then @ameloc = d
         when Exception then @error = d
         when Probatio::Leaf then @leaf = d
         when Probatio::Group then @group = d
@@ -824,6 +840,20 @@ module Probatio
       #
       # which, in the case of assertion != self.node.type ...
 
+    def typ
+
+      case type
+      when 'test' then 'tst'
+      when 'group' then 'grp'
+      when 'setup' then 'sup'
+      when 'before' then 'bfr'
+      when 'teardown' then 'tdo'
+      when 'assertion' then 'ast'
+      when 'start' then 'STA'
+      when 'over' then 'OVR'
+      else @name[0, 3]; end
+    end
+
     def node_full_name; node && node.full_name; end
 
     def enter?; direction == :enter; end
@@ -844,13 +874,28 @@ module Probatio
 
     def location
 
-      (error && error.respond_to?(:location) && error.location) ||
-      (node && node.location)
+      (error && error.loca) ||
+      (ameloc && ameloc[1]) ||
+      (node && node.loca) ||
+      [ '', -1 ]
     end
+    alias loca location
 
     def path
 
-      node && node.path
+      #node && node.path
+      loca[0]
+    end
+
+    def na
+
+      n = @name.split('_').map { |e| e[0, 1] }.join('').upcase
+      n.length > 1 ? n : n * 2
+    end
+
+    def wstamp_s
+
+      '%s.%03d' % [ @wstamp.strftime('%Y%m%d %H:%M:%S'), @wstamp.usec / 1000 ]
     end
 
     def to_s
@@ -863,7 +908,8 @@ module Probatio
       o << "\n  node=#{node.full_name.inspect}" if node
       o << "\n  node_type=#{node.type.inspect}" if node
       o << "\n  error=#{error.to_s.inspect}" if error
-      o << "\n  location=#{location.map(&:to_s).join(':').inspect}" if node
+      o << "\n  location=#{loca.map(&:to_s).join(':').inspect}" if node
+      o << "\n  wstamp=\"#{wstamp.iso8601(3)}\""
       o << "\n  delta=\"#{Probatio.to_time_s(delta)}\"" if delta
       o << "\n  leave_delta=\"#{Probatio.to_time_s(led)}\"" if led
       o << " />"
@@ -873,7 +919,28 @@ module Probatio
 
     def to_h
 
-      { n: name, p: location[0], l: location[1], t: delta_s }
+      { n: name, p: loca[0], l: loca[1], t: delta_s, w: wstamp_s }
+    end
+
+    def trace(out)
+
+      out << na << ' ' << wstamp_s << ' '
+      out << typ << ' ' if node
+      out << loca[0] << ':' << loca[1] << ' '
+
+      out << ameloc[0] << ' ' if ameloc
+      out << node.full_name.inspect << ' ' if node && ! ameloc
+
+      out << 'ERROR:' << error.to_s.inspect << ' ' if error
+
+      out << 'd:' << Probatio.to_time_s(delta) << ' ' if delta
+
+      led = determine_leave_delta
+      out << 'ld:' << Probatio.to_time_s(led) << ' ' if led
+
+      out << "\n"
+
+      out
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: probatio
 version: !ruby/object:Gem::Version
-  version: 1.6.1
+  version: 1.7.0
 platform: ruby
 authors:
 - John Mettraux
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-03-15 00:00:00.000000000 Z
+date: 2026-10-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: stringio