crap4ruby 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e5227286a59e47edaf5fe8e20c8ce9c1abe6391b4f95304f8352c6b98fdf53dd
-  data.tar.gz: 2a569cea7aa8f9172d2ce2c854dec0d62c76ae3e73f1f3618f911b3d55c6deff
+  metadata.gz: b2e848e88bdf6cd4f6b2f0a5477aa3a9f3565651006864d7101ad13beab82c7c
+  data.tar.gz: cc9a67ce5aaea92c6d7311f00526900017df5904c157d16764b77cbd27a0a9e7
 SHA512:
-  metadata.gz: 25f98c5d9ca08faa51388483dc63735238f4dc0a20daf13a80ad104086e48c36d91fb2204a2d4e25a903ce17ccdd510cb8059be09b47ea4a582921fee1a5b649
-  data.tar.gz: b819b05ff07ec266c2316f77b317b2f45975e4ebd7ed2e4f325aea8553a2fa767033d4351086ab67979f9230523497f1d91aab3f49fad540ae911c529fd4dbce
+  metadata.gz: 546293a428b456b48c4c22b34fe09980a2c88f1c7af0d69f8aa24f598fa5441993e8c50f1dc29dc346c233e0a8ffada8106fc13894a15a6185b1877c9823840a
+  data.tar.gz: ed047a7174bcce565ff2b248729f4faa61208f8a20794a6903d0fe9cfca7e1381243bd12287502dd5cfdef1087153c0720b363e098e39e32364262ade1501ddf

data/CHANGELOG.md

@@ -5,6 +5,12 @@ Version numbers follow [Semantic Versioning 2.0.0](https://semver.org/spec/v2.0.
 
 ## [Unreleased]
 
+## [0.2.1] - 2026-10-29
+
+### Added
+
+- Add `--no-save` to print results and check thresholds without creating or replacing `.metrics/crap.edn`.
+
 ## [0.2.0] - 2026-10-28
 
 ### Changed
@@ -42,7 +48,8 @@ Version numbers follow [Semantic Versioning 2.0.0](https://semver.org/spec/v2.0.
 
 - Split CLI execution, AST discovery, and coverage loading into smaller methods without changing their behavior or scoring rules.
 
-[Unreleased]: https://github.com/svyatov/crap4ruby/compare/v0.2.0...HEAD
+[Unreleased]: https://github.com/svyatov/crap4ruby/compare/v0.2.1...HEAD
+[0.2.1]: https://github.com/svyatov/crap4ruby/compare/v0.2.0...v0.2.1
 [0.2.0]: https://github.com/svyatov/crap4ruby/compare/v0.1.1...v0.2.0
 [0.1.1]: https://github.com/svyatov/crap4ruby/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/svyatov/crap4ruby/releases/tag/v0.1.0

data/README.md

@@ -46,7 +46,7 @@ Run these commands from this checkout with Ruby 3.3 or newer:
 ```sh
 bundle install
 gem build crap4ruby.gemspec
-gem install ./crap4ruby-0.2.0.gem
+gem install ./crap4ruby-0.2.1.gem
 ```
 
 To use Bundler in the measured project, add this checkout to that project's `Gemfile`:
@@ -96,6 +96,7 @@ crap4ruby does not configure SimpleCov, delete reports, install dependencies, or
 | `--use-existing-coverage` | Explicitly select the default: read reports without running tests. |
 | `--coverage-command COMMAND` | Run a shell command that refreshes the selected report. |
 | `--no-coverage` | Report complexity with unknown coverage and CRAP. |
+| `--no-save` | Print results without creating or replacing `.metrics/crap.edn`. |
 | `--threshold NUMBER` | Check this finite, nonnegative limit; exit 2 for a measured violation, or 1 if an unknown score could exceed it. |
 | `-h`, `--help` | Print usage. |
 | `-v`, `--version` | Print the gem version. |
@@ -114,7 +115,16 @@ Exit 2 means a measured score exceeded the threshold. A measured violation takes
 Decimal thresholds are compared exactly with the computed scores, before display rounding.
 For unknown scores, the check uses the maximum possible score, `CC^2 + CC`, at zero coverage. If this maximum fits the threshold, the method passes; otherwise, the check returns exit 1 and names the method. Its displayed score remains N/A. This also applies with `--no-coverage`.
 For example, an unknown score at CC 2 passes a threshold of 6, but cannot pass a threshold of 5. Supply fresh, measurable coverage or adjust the limit to resolve uncertainty.
-Every completed analysis replaces the snapshot, including filtered analyses, empty selections, and failed threshold checks.
+By default, every completed analysis replaces the snapshot, including filtered analyses, empty selections, and failed threshold checks.
+
+For pre-commit or pre-push hooks that check complexity without tests or coverage, use:
+
+```sh
+bundle exec crap4ruby --no-coverage --no-save
+```
+
+`--no-save` preserves the terminal report and threshold exit codes while leaving the snapshot unchanged.
+It also works with coverage enabled.
 
 ## Complexity and coverage
 

data/lib/crap4ruby/cli.rb

@@ -14,7 +14,7 @@ module Crap4Ruby
       @stderr = stderr
     end
 
-    # Runs the requested analysis and replaces the snapshot after successful scoring.
+    # Runs the requested analysis and replaces the snapshot unless --no-save is set.
     # Help and version requests produce output without writing a snapshot.
     # Expected usage, input, filesystem, and command errors are printed to stderr.
     #
@@ -34,9 +34,11 @@ module Crap4Ruby
       files = Discovery.call(root: root, source_roots: options[:source_roots], paths: paths, changed: options[:changed])
       coverage = load_coverage(options, root) unless options[:no_coverage] || files.empty?
       entries = Report.sorted(analyze(files, coverage))
-      path = Report.write(entries, root: root)
+      unless options[:no_save]
+        path = Report.write(entries, root: root)
+        @stderr.puts("Wrote #{path}")
+      end
       @stdout.write(Report.table(entries))
-      @stderr.puts("Wrote #{path}")
       threshold_status(entries, options[:threshold])
     rescue Error, OptionParser::ParseError, SystemCallError => error
       @stderr.puts("crap4ruby: #{error.message}")
@@ -75,6 +77,7 @@ module Crap4Ruby
           options[:coverage] = path
         end
         cli.on("--no-coverage", "Complexity only; coverage and CRAP are N/A") { options[:no_coverage] = true }
+        cli.on("--no-save", "Print results without writing .metrics/crap.edn") { options[:no_save] = true }
         cli.on("--use-existing-coverage", "Read reports without running tests (the default)") do
           options[:existing] = true
         end

data/lib/crap4ruby/version.rb

@@ -2,5 +2,5 @@
 
 module Crap4Ruby
   # Gem version used by the CLI and release process.
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

data/sig/crap4ruby.rbs

@@ -95,7 +95,7 @@ module Crap4Ruby
 
   class CLI
     type options = { root: String, source_roots: Array[String], changed: bool, coverage: String,
-      ?help: bool, ?version: bool, ?no_coverage: bool, ?existing: bool, ?command: String, ?threshold: Rational }
+      ?help: bool, ?version: bool, ?no_coverage: bool, ?no_save: bool, ?existing: bool, ?command: String, ?threshold: Rational }
     @stdout: _Output
     @stderr: _Output
     def initialize: (?stdout: _Output, ?stderr: _Output) -> void

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: crap4ruby
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Leonid Svyatov