leto 2.2.0 → 2.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b0362bb08490e1bd600bb8996a1be449584295433c047472864578b2d43a6cb5
-  data.tar.gz: de8244c6e7d6bd2a58453effbadf1e93f9956a0aace1fc0fcef1c97660e486f4
+  metadata.gz: 7a4c2fdd688142eb3f9db1a5d0d10cad624225413f6892a65eeef1a0aec3df00
+  data.tar.gz: 7ee194719f3912044b675f874f60d42bf4c6e7c60be5e83318cf3f2aaeca6225
 SHA512:
-  metadata.gz: a8a4a40c37e53158ce69775451a56a2b939cecb01df5c8441a0c7a18b9e4c88db68d350dd57abbc2d87fd03c770335f2e92344e2fba4370280796bb46fce1d6e
-  data.tar.gz: b73106dde5c5f19b65c6b95ac6f0fdf4039ab84eaf6dfb53abe705e54e4b7c2f8951fd3ebe205cf53ca46faaccf3812cc1fc2e534979a8adfd99df07bc0a66fb
+  metadata.gz: 4edd7d0d8677b548585517b499a57ae630b5326053192f7b10b6de101c8899aab46d956de787df0a480cf66f73fd34c5da3518db2f1c61abc82b7758cdef7cbe
+  data.tar.gz: c3678597e116adf629f4229193c921a003e1f270030c2d076464af427806b76ce1560f6726a231eca7507af334be457e91f2c286d1bc2d0349d66696f73c25d8

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 ## [Unreleased]
 
+## [2.3.0] - 2026-09-29
+
+### Added
+
+- support for Ruby 4's native `Set` class
+
 ## [2.2.0] - 2026-09-03
 
 ### Added

data/README.md

@@ -12,9 +12,10 @@ Takes an object and recursively yields:
 - instance variables, class variables, constants
 - Hash keys and values
 - Enumerable members
+- Range begins and ends
 - Struct members
 - [Data](https://docs.ruby-lang.org/en/3.2/Data.html) members
-- Range begins and ends
+- Set members (for [native Sets on Ruby >= 4.0](https://bugs.ruby-lang.org/issues/21216))
 
 This makes stuff like deep-freezing fairly easy to implement:
 
@@ -37,22 +38,29 @@ Basic example:
 ```ruby
 object = [{ a: ['b', 'c'..'d'] }]
 
-Leto.call(object) { |el| p el }
+Leto.call(object) { |el| puts "#{el.class}: #{el}" }
 # prints:
 #
-# [{:a=>["b", ["c".."d"]]}]
-# {:a=>["b", ["c".."d"]]}
-# :a
-# ["b", ["c".."d"]]
-# "b"
-# "c".."d"
-# "c"
-# "d"
+# Array: [{a: ["b", "c".."d"]}]
+# Hash: {a: ["b", "c".."d"]}
+# Symbol: a
+# Array: ["b", "c".."d"]
+# String: b
+# Range: c..d
+# String: c
+# String: d
+```
+
+Calls without a block return an `Enumerator`:
 
+```ruby
 Leto.call(object).to_a
 # => [[{:a=>["b", ["c".."d"]]}], {:a=>["b", ["c".."d"]]}, :a, ...]
+```
 
-# Leto::trace behaves like ::call, but also yields each (sub-)object's path:
+`Leto.trace` behaves like `.call`, but also yields each (sub-)object's `Path`:
+
+```ruby
 Leto.trace(object) { |el, path| puts "#{el.inspect.ljust(23)} @#{path}" }
 # prints:
 #
@@ -64,11 +72,19 @@ Leto.trace(object) { |el, path| puts "#{el.inspect.ljust(23)} @#{path}" }
 # "c".."d"                @#<Leto::Path [{:a=>["b", "c".."d"]}][0][:a][1]>
 # "c"                     @#<Leto::Path [{:a=>["b", "c".."d"]}][0][:a][1].begin>
 # "d"                     @#<Leto::Path [{:a=>["b", "c".."d"]}][0][:a][1].end>
+```
+
+Paths can be looked up with `Leto::Path#resolve` or `Leto.dig`:
 
-# paths can be looked up with Leto::Path#resolve or Leto::dig
+```ruby
 path = Leto.trace(object).map { |_el, path| path }.last # => #<Leto::Path...>
 path.resolve # => "d"
 Leto.dig(object, path) # => "d"
+```
+
+Arrays of Arrays, where the latter ones contain method names and arguments, are valid paths:
+
+```ruby
 Leto.dig(object, [[:[], 0], [:[], :a], [:[], 1], [:end]]) # => "d"
 ```
 

data/lib/leto/call.rb

@@ -60,12 +60,19 @@ module Leto
         obj.members.each do |member|
           traverse(obj[member], path&.+([[:[], member]]), depth, max_depth, seen, block)
         end
-      when Enumerable
-        obj.each_with_index do |el, idx|
-          traverse(el, path&.+([[:[], idx]]), depth, max_depth, seen, block)
-        end
       #{
-        defined?(Data) && Data.respond_to?(:define) && <<-DATA_FEATURE_RUBY
+        set_feature? && <<-SET_FEATURE_RUBY
+        when Set
+          obj.each_with_index do |el, idx|
+            traverse(
+              el, path&.+([[:to_a], [:[], idx]]),
+              depth, max_depth, seen, block
+            )
+          end
+        SET_FEATURE_RUBY
+      }
+      #{
+        data_feature? && <<-DATA_FEATURE_RUBY
         when Data
           obj.members.each do |member|
             traverse(
@@ -76,6 +83,10 @@ module Leto
           end
         DATA_FEATURE_RUBY
       }
+      when Enumerable
+        obj.each_with_index do |el, idx|
+          traverse(el, path&.+([[:[], idx]]), depth, max_depth, seen, block)
+        end
       end
     end
 

data/lib/leto/features.rb

@@ -0,0 +1,12 @@
+# feature detection code for ruby
+module Leto
+  def self.data_feature?
+    defined?(Data) && Data.respond_to?(:define)
+  end
+
+  # Pre-Ruby-4.0, Hash-backed Sets are traversed through their
+  # @hash instance variable and don't need custom handling.
+  def self.set_feature?
+    defined?(Set) && Set.respond_to?(:[]) && !Set[].instance_variable_defined?(:@hash)
+  end
+end

data/lib/leto/utils.rb

@@ -34,8 +34,14 @@ module Leto
         copy[*args] = deep_dup(el, include_modules: include_modules)
       when :send # Data
         copy = copy.with(args[0] => deep_dup(el, include_modules: include_modules))
+      when :to_a # Set
+        copy = (copy - [el]) + [deep_dup(el, include_modules: include_modules)]
       when :begin
-        return Range.new(deep_dup(obj.begin), deep_dup(obj.end), obj.exclude_end?)
+        return Range.new(
+          deep_dup(obj.begin, include_modules: include_modules),
+          deep_dup(obj.end, include_modules: include_modules),
+          obj.exclude_end?,
+        )
       end
     end
 

data/lib/leto/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Leto
-  VERSION = "2.2.0"
+  VERSION = "2.3.0"
 end

data/lib/leto.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require_relative 'leto/features'
 require_relative 'leto/call'
 require_relative 'leto/dig'
 require_relative 'leto/path'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: leto
 version: !ruby/object:Gem::Version
-  version: 2.2.0
+  version: 2.3.0
 platform: ruby
 authors:
 - Janosch Müller
@@ -27,6 +27,7 @@ files:
 - lib/leto.rb
 - lib/leto/call.rb
 - lib/leto/dig.rb
+- lib/leto/features.rb
 - lib/leto/path.rb
 - lib/leto/utils.rb
 - lib/leto/version.rb
@@ -50,7 +51,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Generic object traverser
 test_files: []