varar-minitest 0.5.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 73ed24f36695f4f1fa189c45bc6c159a237c3cf359b55432ec7073a59894d8da
+  data.tar.gz: 204bf6cd510b6ba61a3d31466e87d3d344236da9c0d16189d0611a215501ab1a
+SHA512:
+  metadata.gz: c1e50aee4e04f8863e08f8658d32c451df1846fd2fed24edfd840f48d04948fc413a12f6ceab66c6db259488dc354a071b1e7c598858382040f36f2181df1473
+  data.tar.gz: 1ebad856c3474628ae3bf257ca704ef9b4e643e727ec91eb05e925ac45aa2b56bcf0715b1e9975e11304600895c0d1f471a74cdf64a8384678b914a0af987a26

data/lib/varar/minitest.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+require 'minitest'
+require 'varar/runner'
+
+module Varar
+  # Minitest adapter. One call turns every spec matched by varar.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 "varar/minitest"
+  #   Varar::Minitest.generate_tests
+  module Minitest
+    VERSION = '0.5.0'
+
+    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

metadata

@@ -0,0 +1,71 @@
+--- !ruby/object:Gem::Specification
+name: varar-minitest
+version: !ruby/object:Gem::Version
+  version: 0.5.0
+platform: ruby
+authors:
+- Aslak Hellesøy
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: varar-runner
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.5.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.5.0
+description: 'Minitest adapter: one selectable test per Markdown example, with a drift
+  gate.'
+email:
+- aslak@oselvar.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/varar/minitest.rb
+homepage: https://varar.dev
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+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: 4.0.16
+specification_version: 4
+summary: Markdown-native BDD — run Markdown specs as Minitest tests
+test_files: []