oselvar-var-minitest 0.3.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 483abcb713540c6e06ddb44fa204f76e4bb9c045c3852c2682ccaaa22888d4ac
+  data.tar.gz: fed806038d77a49855edf2f9b9253542d40fba505496012b59f312a09a6fe074
+SHA512:
+  metadata.gz: 8704386cf14dddc281a7c1fa8528f75c340189414cce480ffa36240971ad54266b1e0f0d51448ae858b7dbdf23dc3f9284f086fb5b3e8056c1597014e631b809
+  data.tar.gz: cb0dd65bad769b889ea6471fd6bea47ec0e56da9c05bbeec571def66963c2871980d0269a724cee869e74be4019526b7b084e3f01119bbe383129645a3e9b674

data/lib/oselvar/var/minitest.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+require 'minitest'
+require 'oselvar/var/runner'
+
+module Oselvar
+  module Var
+    # Minitest adapter. One call turns every spec matched by var.config.json into
+    # a generated Minitest::Test subclass — one class per spec file, one test
+    # method per example. Mirrors var-unittest.
+    #
+    #   # test/var_test.rb
+    #   require "oselvar/var/minitest"
+    #   Oselvar::Var::Minitest.generate_tests
+    module Minitest
+      VERSION = '0.3.2'
+
+      module_function
+
+      def generate_tests(namespace = Object, root: nil)
+        root ||= File.dirname(caller_locations(1, 1).first.path)
+        root = File.expand_path(root)
+        cfg = Config.read_var_config(root)
+        loaded = Runner.load_steps(cfg.steps, root)
+        store = Runner.create_file_baseline_store(root)
+        update = %w[1 true].include?(ENV.fetch('VAR_UPDATE', nil))
+
+        Runner.find_specs(cfg.docs_include, cfg.docs_exclude, root).each do |spec_path|
+          klass = build_test_case(spec_path, root, loaded, store, update)
+          namespace.const_set("Var_#{identifier(Runner.rel_posix(spec_path, root))}", klass)
+        end
+      end
+
+      def build_test_case(spec_path, root, loaded, store, update)
+        rel = Runner.rel_posix(spec_path, root)
+        source = File.read(spec_path, encoding: 'UTF-8')
+        plan = Runner.plan_spec(File.basename(spec_path), source, loaded.registry)
+        pairs = Runner.examples_with_runs(plan, loaded.create_context, Runner::RecordingReporter.new)
+
+        klass = Class.new(::Minitest::Test)
+        seen = Hash.new(0)
+        pairs.each do |example, run|
+          base = example.scope_stack.last || example.name
+          stem = identifier(base)
+          idx = seen[stem]
+          seen[stem] += 1
+          method_name = idx.zero? ? "test_#{stem}" : "test_#{stem}_#{idx}"
+          klass.define_method(method_name) do
+            run.call
+          rescue StandardError => e
+            raise ::Minitest::Assertion, Runner.render_failure(e, source, rel) if Minitest.var_diff_error?(e)
+
+            raise
+          end
+        end
+
+        Core::Drifts.reconcile_drift(store, rel, source, plan.var_doc, plan, update: update).each do |drift|
+          message = Core::Diagnostics.drift_detected(drift.name, drift.span).message
+          klass.define_method("test_var_drift_#{drift.line}") { raise ::Minitest::Assertion, message }
+        end
+
+        klass
+      end
+
+      # A markdown/return mismatch is a test failure (Minitest::Assertion); any
+      # other exception propagates as an error.
+      def var_diff_error?(error)
+        error.is_a?(Core::CellMismatchError) || error.is_a?(Core::DocStringMismatchError) ||
+          error.is_a?(Core::ReturnShapeError) || error.is_a?(Core::UnexpectedPassError)
+      end
+
+      # Project arbitrary text onto a valid identifier fragment.
+      def identifier(text)
+        ident = text.gsub(/\W+/, '_').gsub(/\A_+|_+\z/, '')
+        ident = 'example' if ident.empty?
+        ident = "_#{ident}" if ident.match?(/\A\d/)
+        ident
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification
+name: oselvar-var-minitest
+version: !ruby/object:Gem::Version
+  version: 0.3.2
+platform: ruby
+authors:
+- Aslak Hellesøy
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-07-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.20'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.20'
+- !ruby/object:Gem::Dependency
+  name: oselvar-var-runner
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.3.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.3.2
+description: 'Minitest adapter: one selectable test per Markdown example, with a drift
+  gate.'
+email:
+- aslak@oselvar.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/oselvar/var/minitest.rb
+homepage: https://var.oselvar.com
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.10
+signing_key:
+specification_version: 4
+summary: Markdown-native BDD — run Markdown specs as Minitest tests
+test_files: []