probatio 1.6.2 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4228249f8fc1a787a594dc604462fef627c33ea693cd8fc1567b8bbd859d7ed3
-  data.tar.gz: 2eec405d2f2e77cd548e62343c92ab07c530b3aaabea4ce91044a8fbcf0effed
+  metadata.gz: ca8587e9a4b21f857e2a8a50603deff772d78e68ce320ad581a16dd1ba11dc89
+  data.tar.gz: 86b7da1f6f31f7cf16a7b2b2cb4c0fbb4f845496095168fbbc94c6b88a8ae40d
 SHA512:
-  metadata.gz: a3034d250e0189025c003f95b1f213c34ffc6ea5bdfc6da080c298029e8b419c56ce195566a3943f36a5c4db27e74bc7268473dade3e48ea4658e4ed79a1fd32
-  data.tar.gz: 9d5f1a38728c5a18162ec83782e818c9c9275368f4bdae18bbe4ad17bbb6a39bd4fed50556ddc03b5cb7819a689b8495b72a2c279728ef9d0fc995d04f6ca58e
+  metadata.gz: a21ac68e3447c28f534127dfd34631f71c9e29cdb612ac62b73b136978e52d997eb62d5c1fd0084fdf941eb18b0bfed5ee0ba59471b35e64c238651785cc68c9
+  data.tar.gz: b98452d3e87e06790cdd3a79d1c60704a43b208d87330a01943d8d5f50126856cf989315eec9ba6608a6a044a52270c4d7c48fcf4cffd26bfef7453878a81c1b

data/CHANGELOG.md

@@ -2,6 +2,13 @@
 # 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

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
 
@@ -209,6 +209,17 @@ group 'core' do
 
   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

@@ -283,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)
 
@@ -298,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
 
@@ -313,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.2'
+  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
@@ -797,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
@@ -810,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
@@ -827,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
@@ -847,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
@@ -866,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 << " />"
@@ -876,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.2
+  version: 1.7.0
 platform: ruby
 authors:
 - John Mettraux
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-07-29 00:00:00.000000000 Z
+date: 2026-10-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: stringio