oselvar-var-rspec 0.3.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: da1add0685800dbb76fd61693e66a8fed8f36f7ac7a5ed31456ff21140cc550c
+  data.tar.gz: 7886ee80bca5c9734505b93aba054ef5fa2e6c28bc8fd9dbf6cda453508458fe
+SHA512:
+  metadata.gz: c33709eda5f2e0b16ca0376cd6d96bc005e2161830cc5981997b32fc091f9c398c27b4125c6d00e40b4435d4df77ba80d602106199aa9068abd8e1d70f488801
+  data.tar.gz: f9a650736444fea8835e58fe03eb307be86d278b5e7dac89535ca18421c28f7684a912a059f81cb70eb9d7342d3fc91536307181f6cbf4e0bc399d8a878f7558

data/lib/oselvar/var/rspec.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require 'rspec/core'
+require 'oselvar/var/runner'
+
+module Oselvar
+  module Var
+    # RSpec adapter. One call defines an RSpec example group per spec matched by
+    # var.config.json, with one `it` per Markdown example (header-bound rows are
+    # separate examples) and a drift gate. See ADR 0005.
+    #
+    #   # spec/var_spec.rb
+    #   require "oselvar/var/rspec"
+    #   Oselvar::Var::RSpec.generate
+    module RSpec
+      VERSION = '0.3.2'
+
+      module_function
+
+      def generate(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|
+          define_group(spec_path, root, loaded, store, update)
+        end
+      end
+
+      def define_group(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)
+        drifts = Core::Drifts.reconcile_drift(store, rel, source, plan.var_doc, plan, update: update)
+
+        ::RSpec.describe(rel) do
+          pairs.each do |example, run|
+            # A var diff surfaces as a failure carrying the span-anchored render;
+            # any other exception propagates. RSpec reports both as failures.
+            it(example.name) do
+              run.call
+            rescue StandardError => e
+              raise Runner.render_failure(e, source, rel) if RSpec.var_diff_error?(e)
+
+              raise
+            end
+          end
+
+          drifts.each do |drift|
+            message = Core::Diagnostics.drift_detected(drift.name, drift.span).message
+            it("var drift at line #{drift.line}") { raise message }
+          end
+        end
+      end
+
+      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
+    end
+  end
+end

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification
+name: oselvar-var-rspec
+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: 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
+- !ruby/object:Gem::Dependency
+  name: rspec-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+description: 'RSpec adapter: one selectable example per Markdown example, with a drift
+  gate.'
+email:
+- aslak@oselvar.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/oselvar/var/rspec.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 RSpec examples
+test_files: []