rspec-signal 0.2.0 → 0.3.0

data/lib/rspec/signal/writer.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "fileutils"
+require "tempfile"
 
 module RSpec
   module Signal
@@ -26,17 +27,21 @@ module RSpec
       end
 
       def write(report)
-        return clean if report.failures.empty? && report.errors_outside_examples.zero?
+        return clean unless report.reportable?
 
         FileUtils.mkdir_p(dir)
         write_gitignore
 
-        markdown = Reporters::Markdown.new(report, @config).render
-        written = [write_file(SIGNAL, markdown)]
-        written.concat(optional_artifacts(report))
+        rendered = render_artifacts(report)
+        publish(rendered)
+      end
 
-        stale = MANAGED - written.map { |path| File.basename(path) }
-        Result.new(summary_path: File.join(dir, SIGNAL), written: written, cleaned: remove(stale))
+      # Invalidating is deliberately separate from rendering. Callers do this
+      # at the beginning of a run, so an abort before #write cannot make the
+      # preceding run look current. History uses different names and is never
+      # included in MANAGED.
+      def invalidate_current!
+        remove(MANAGED)
       end
 
       # Relative to the project root when possible, because that is what you
@@ -48,15 +53,53 @@ module RSpec
 
       private
 
-      def optional_artifacts(report)
-        written = []
-        written << write_file(JSON, Reporters::JsonReport.new(report, @config).render) if @config.write_json
-        written << write_file(FULL, Reporters::FullOutput.new(report, @config).render) if @config.write_full
-        written
+      def render_artifacts(report)
+        artifacts = { SIGNAL => Reporters::Markdown.new(report, @config).render }
+        artifacts[JSON] = Reporters::JsonReport.new(report, @config).render if @config.write_json
+        artifacts[FULL] = Reporters::FullOutput.new(report, @config).render if @config.write_full
+        artifacts
+      end
+
+      # signal.md is the publication marker. Supporting artifacts are moved
+      # first and the marker last, so its presence always identifies a fully
+      # published generation. All content is staged beside its destination so
+      # rename remains on the same filesystem.
+      def publish(rendered)
+        staged = stage(rendered)
+        cleaned = invalidate_current!
+        published = []
+        publication_order(rendered.keys).each do |name|
+          File.rename(staged.fetch(name).path, File.join(dir, name))
+          published << File.join(dir, name)
+        end
+        Result.new(summary_path: File.join(dir, SIGNAL), written: published, cleaned: cleaned)
+      ensure
+        staged&.each_value(&:close!)
+      end
+
+      def stage(rendered)
+        staged = {}
+        rendered.each do |name, contents|
+          temporary = Tempfile.new([".#{name}", ".tmp"], dir)
+          temporary.binmode
+          temporary.write(contents)
+          temporary.flush
+          temporary.fsync
+          staged[name] = temporary
+        end
+        staged
+      rescue StandardError
+        temporary&.close!
+        staged&.each_value(&:close!)
+        raise
+      end
+
+      def publication_order(names)
+        names.reject { |name| name == SIGNAL } + [SIGNAL]
       end
 
       def clean
-        Result.new(summary_path: nil, written: [], cleaned: remove(MANAGED))
+        Result.new(summary_path: nil, written: [], cleaned: invalidate_current!)
       end
 
       def remove(names)
@@ -69,12 +112,6 @@ module RSpec
         end
       end
 
-      def write_file(name, contents)
-        path = File.join(dir, name)
-        File.write(path, contents)
-        path
-      end
-
       # Failure artifacts routinely contain application data. Keeping them out of
       # version control by default is cheap insurance.
       def write_gitignore

data/lib/rspec/signal.rb

@@ -12,19 +12,37 @@ require_relative "signal/redactor"
 require_relative "signal/html_summary"
 require_relative "signal/message"
 require_relative "signal/fingerprint"
+require_relative "signal/rerun"
 require_relative "signal/symptom"
 require_relative "signal/symptoms"
 require_relative "signal/failure"
+require_relative "signal/outside_example"
 require_relative "signal/group"
 require_relative "signal/grouper"
 require_relative "signal/cluster"
 require_relative "signal/clusterer"
+require_relative "signal/code_paths"
+require_relative "signal/comparison"
+require_relative "signal/selection"
+require_relative "signal/causal/evidence"
+require_relative "signal/causal/phase"
+require_relative "signal/causal/entities"
+require_relative "signal/causal/census"
+require_relative "signal/causal/scope_analysis"
+require_relative "signal/causal/analysis"
+require_relative "signal/history"
+require_relative "signal/run_status"
 require_relative "signal/report"
 require_relative "signal/configuration"
 require_relative "signal/reporters/related_failures"
+require_relative "signal/reporters/outside_examples"
+require_relative "signal/reporters/shared_code_paths"
+require_relative "signal/reporters/relationships"
 require_relative "signal/reporters/markdown"
 require_relative "signal/reporters/json_report"
 require_relative "signal/reporters/full_output"
+require_relative "signal/progress_bar"
+require_relative "signal/terminal_summary"
 require_relative "signal/writer"
 require_relative "signal/parallel_run"
 require_relative "signal/parallel_merger"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rspec-signal
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Chad Snow
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2026-08-27 00:00:00.000000000 Z
+date: 2026-10-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec-core
@@ -55,8 +55,16 @@ files:
 - lib/rspec/signal/backtrace/frame.rb
 - lib/rspec/signal/backtrace/parser.rb
 - lib/rspec/signal/backtrace/reducer.rb
+- lib/rspec/signal/causal/analysis.rb
+- lib/rspec/signal/causal/census.rb
+- lib/rspec/signal/causal/entities.rb
+- lib/rspec/signal/causal/evidence.rb
+- lib/rspec/signal/causal/phase.rb
+- lib/rspec/signal/causal/scope_analysis.rb
 - lib/rspec/signal/cluster.rb
 - lib/rspec/signal/clusterer.rb
+- lib/rspec/signal/code_paths.rb
+- lib/rspec/signal/comparison.rb
 - lib/rspec/signal/configuration.rb
 - lib/rspec/signal/failure.rb
 - lib/rspec/signal/failure_builder.rb
@@ -64,18 +72,27 @@ files:
 - lib/rspec/signal/formatter.rb
 - lib/rspec/signal/group.rb
 - lib/rspec/signal/grouper.rb
+- lib/rspec/signal/history.rb
 - lib/rspec/signal/html_summary.rb
 - lib/rspec/signal/integrations/capybara.rb
 - lib/rspec/signal/message.rb
+- lib/rspec/signal/outside_example.rb
 - lib/rspec/signal/parallel_merger.rb
 - lib/rspec/signal/parallel_run.rb
+- lib/rspec/signal/progress_bar.rb
 - lib/rspec/signal/project.rb
 - lib/rspec/signal/redactor.rb
 - lib/rspec/signal/report.rb
 - lib/rspec/signal/reporters/full_output.rb
 - lib/rspec/signal/reporters/json_report.rb
 - lib/rspec/signal/reporters/markdown.rb
+- lib/rspec/signal/reporters/outside_examples.rb
 - lib/rspec/signal/reporters/related_failures.rb
+- lib/rspec/signal/reporters/relationships.rb
+- lib/rspec/signal/reporters/shared_code_paths.rb
+- lib/rspec/signal/rerun.rb
+- lib/rspec/signal/run_status.rb
+- lib/rspec/signal/selection.rb
 - lib/rspec/signal/symptom.rb
 - lib/rspec/signal/symptoms.rb
 - lib/rspec/signal/symptoms/exception_class.rb
@@ -84,6 +101,7 @@ files:
 - lib/rspec/signal/symptoms/route.rb
 - lib/rspec/signal/symptoms/ruby_error.rb
 - lib/rspec/signal/symptoms/selector.rb
+- lib/rspec/signal/terminal_summary.rb
 - lib/rspec/signal/version.rb
 - lib/rspec/signal/writer.rb
 homepage: https://github.com/SilenceDogood1984/rspec-signal