rspec-debugging 0.0.2 → 0.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9d232979bdf2295fb58cec0c7295355366fb703f74e327d0d87d6d6febc35da9
-  data.tar.gz: 98d1146bb2abb4e83f4308f47f302d74755c1d5b1f2c622ef216390ec25c6496
+  metadata.gz: 18dc39f0ec372fefa54e665b0f8fa941ee58d2e5437d0f7baf165411a7ae3706
+  data.tar.gz: bd59263041e3197220b04c1cda058e1d57fe91eb86ed4a50d461c06c02620c98
 SHA512:
-  metadata.gz: b22241789c483ef578ef866f7262e263938629486ed90f931f0a09511d3b662b0818cbbccd7cb5f3df2c441be2decdadfd775c6e61c37fcf080b5a100d245bb6
-  data.tar.gz: d537656b7b9d64d8e572a2844e83dfd86450bb1a803a910f58322d5a14ec23d62a6b00e3958f27d5f9bd2ba2d50ab5292abf4a6fe97a7837e341a8c81d7db770
+  metadata.gz: f1a1432398be62a3f54c4c3b198b94b6a69ac9f1524a36f25026ff53bfd5af7ec17dcb0b64c2f01f6b3886492055121f961216f5a818cd37ca2bfbf831fed4cc
+  data.tar.gz: eda816fa9f998da2aaf4075010af9e06bafca4b2c308609a2285e0fc202c325284e77eefa5d39ddca787f4a18f7b4ada05265955c08caa2bdd5bc14969765f90

data/CHANGELOG.md

@@ -1,3 +1,13 @@
+###  0.0.4  (2025-02-08)
+- dependency fix
+- readme
+- inspired by
+
+###  0.0.3  (2025-01-21)
+- let_variable_reset
+- test coverage
+- readme
+
 ###  0.0.2  (2025-01-14)
 - dit - debugging examples
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    rspec-debugging (0.0.2)
+    rspec-debugging (0.0.4)
       rspec-expectations (>= 3)
 
 GEM

data/README.md

@@ -4,14 +4,90 @@ rspec-debugging
 [![codecov](https://codecov.io/gh/dpep/rspec-debugging/branch/main/graph/badge.svg)](https://codecov.io/gh/dpep/rspec-debugging)
 
 
-Tools to make debugging RSpec easier.
+Tools to make debugging RSpec tests easier.
+
+<br />
+
+Debug broken specs
+----
+Use `dit`, `dcontext`, or `ddescribe` to run a subset of examples and and start the debugger if anything breaks.
 
 ```ruby
 require "rspec/debugging"
 
+describe MySpec do
+  dit { is_expected.to ... }
+end
+```
+
+or set an environment variable to run and debug all specs:
+```
+RSPEC_DEBUGGING=true bundle exec rspec
+```
+
+<br />
+
+Stop and explore
+----
+Drop `dit` anywhere to start a debugger.
 
+```ruby
+describe MySpec do
+  dit
+end
 ```
 
+<br />
+
+Got let variables?
+----
+`let` variables are great, but complexity can obscure their value.
+
+```ruby
+describe RSpec::Debugging do
+  describe RSpec::Debugging::LetVariables do
+    subject { a }
+
+    let(:a) { "a" }
+    let!(:b) { "b" }
+
+    it { is_expected.to be ??? }
+
+    context "when we nest" do
+      let(:a) { "A" + b }
+
+      it { is_expected.to be ??? }
+
+      context "...and nest" do
+        let(:a) { super() * 2 }
+
+        it { is_expected.to be ??? }
+      end
+    end
+```
+
+...add a hundred lines of legacy code and then solve for `a`.  Or use tooling :)
+
+<br />
+
+----
+
+### let_variables
+* list of variables defined by RSpec `let`
+
+
+### let_variable_initialized?(name)
+* whether a specified let variable been initialized
+
+
+### let_variable_get(name)
+* the value of a let variable, if initialized
+
+### let_variable_values(name)
+* all locations where the specified variable has been defined or redefined, and it's value at each location
+
+
+<br />
 
 ----
 ## Contributing
@@ -24,3 +100,12 @@ Yes please  :)
 1. Commit your changes (`git commit -am 'awesome new feature'`)
 1. Push your branch (`git push origin my-feature`)
 1. Create a Pull Request
+
+
+<br />
+
+----
+### Inspired by
+
+- [@alexdean](https://github.com/alexdean)
+- [rspec-debug](https://github.com/ko1/rspec-debug)

data/lib/rspec/debugging/debug_it.rb

@@ -1,3 +1,4 @@
+require 'debug'
 require 'debug/session'
 
 module RSpec
@@ -17,7 +18,7 @@ module RSpec
             end
 
             if e
-              STDERR.puts <<~MSG
+              $stderr.puts <<~MSG
 
               Error:
               #{e.message}
@@ -32,15 +33,18 @@ module RSpec
           # called with no block
           user_metadata.delete(:skip)
 
-          file, line = caller[2].split(":")
+          location = RSpec::Core::Metadata.relative_path(caller[2].split(":in").first)
 
           example_block = Proc.new do
-            STDERR.puts <<~MSG
-            debugging: #{file}:#{line}
+            $stderr.puts <<~MSG
+            debugging: #{location}
 
             MSG
 
             debugger
+          end.tap do |block|
+            # redefine source_location to return the correct location
+            block.define_singleton_method(:source_location) { location.split(":") }
           end
         end
 

data/lib/rspec/debugging/let_variables.rb

@@ -13,6 +13,10 @@ module RSpec
         __memoized.instance_variable_get("@memoized")[name]
       end
 
+      def let_variable_reset(name)
+        __memoized.instance_variable_get("@memoized").delete(name)
+      end
+
       def let_variable_locations(name)
         let_variable_methods(self)[name].map do |fn|
           normalize_path(fn.source_location.join(":"))

data/lib/rspec/debugging/version.rb

@@ -1,5 +1,5 @@
 module RSpec
   module Debugging
-    VERSION = Gem.loaded_specs["rspec-debugging"].version.to_s
+    VERSION = "0.0.4"
   end
 end

data/rspec-debugging.gemspec

@@ -6,7 +6,7 @@ Gem::Specification.new do |s|
   s.license     = "MIT"
   s.name        = File.basename(__FILE__, ".gemspec")
   s.summary     = s.description
-  s.version     = "0.0.2"
+  s.version     = "0.0.4"
 
   s.required_ruby_version = ">= 3.1"
 

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: rspec-debugging
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.4
 platform: ruby
 authors:
 - Daniel Pepper
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-01-13 00:00:00.000000000 Z
+date: 2025-02-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec-expectations
@@ -67,7 +66,6 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 description: Tools to improve debugging in RSpec
-email:
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -87,7 +85,6 @@ homepage: https://github.com/dpep/rspec-debugging
 licenses:
 - MIT
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -102,8 +99,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.23
-signing_key:
+rubygems_version: 3.6.3
 specification_version: 4
 summary: Tools to improve debugging in RSpec
 test_files: []