leto 2.1.0 → 2.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0ed0d190b234b4976a219ba5b50a3e9cb4f394be7b1a27aa2f1d7bdfe93887b0
-  data.tar.gz: eafafd24510514cf7ba4e59cdf1a967c7464d175b8ceed1f3cafa2e78fffcc1e
+  metadata.gz: 7a4c2fdd688142eb3f9db1a5d0d10cad624225413f6892a65eeef1a0aec3df00
+  data.tar.gz: 7ee194719f3912044b675f874f60d42bf4c6e7c60be5e83318cf3f2aaeca6225
 SHA512:
-  metadata.gz: 79b0be7884c86be4a14977e5aaae6147da85b857f632013bd82f9fe95addf28a4014ea7adeba1c75dfc63b9988ab7426c622cb79bc2c2886dca04be246ee2db5
-  data.tar.gz: 961a19be85b69aac0763828648c09100af4a9f84eff07a45e2b9c0c247c84e5b7ae9647a9bd4a7de791eb7cd0f0342b91f82d2cd50a85286425e4a8f915bd2fe
+  metadata.gz: 4edd7d0d8677b548585517b499a57ae630b5326053192f7b10b6de101c8899aab46d956de787df0a480cf66f73fd34c5da3518db2f1c61abc82b7758cdef7cbe
+  data.tar.gz: c3678597e116adf629f4229193c921a003e1f270030c2d076464af427806b76ce1560f6726a231eca7507af334be457e91f2c286d1bc2d0349d66696f73c25d8

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 ## [Unreleased]
 
+## [2.3.0] - 2026-09-29
+
+### Added
+
+- support for Ruby 4's native `Set` class
+
+## [2.2.0] - 2026-09-03
+
+### Added
+
+- support for varargs in `::shared_mutable_state?`
+
 ## [2.1.0] - 2023-05-20
 
 ### 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"
 ```
 
@@ -82,7 +98,7 @@ Leto.dig(object, [[:[], 0], [:[], :a], [:[], 1], [:end]]) # => "d"
   - stricter version of `#eql?` that takes all ivars into consideration
 - [`Leto.deep_dup(obj)`](https://github.com/search?q=deep_dup+repo%3Ajaynetics%2Fleto+path%3Alib%2Fleto%2Futils.rb&type=code)
   - more thorough than [`active_support`](https://www.rubydoc.info/search/gems/activesupport?q=deep_dup) or [`deep_dup`](https://github.com/ollie/deep_dup) gems, e.g. dups ivars
-- [`Leto.shared_mutable_state?(obj1, obj2)`](https://github.com/search?q=shared_mutable_state+repo%3Ajaynetics%2Fleto+path%3Alib%2Fleto%2Futils.rb&type=code)
+- [`Leto.shared_mutable_state?(obj1, obj2, ...)`](https://github.com/search?q=shared_mutable_state+repo%3Ajaynetics%2Fleto+path%3Alib%2Fleto%2Futils.rb&type=code)
   - useful for debugging or verifying that a `#dup` implementation is sane
 - [`Leto.shared_mutables(obj1, obj2)`](https://github.com/search?q=shared_mutables+repo%3Ajaynetics%2Fleto+path%3Alib%2Fleto%2Futils.rb&type=code)
   - useful for debugging or verifying that a `#dup` implementation is sane

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

@@ -10,8 +10,7 @@ module Leto
   def self.deep_print(obj, print_method: :inspect, indent: 4, show_path: true)
     trace(obj) do |el, path|
       puts "#{' ' * path.count * indent}#{el.send(print_method)}" \
-           "#{"  @ #{path.inspect}" if show_path}" \
-           [0..78]
+           "#{"  @ #{path.inspect}" if show_path}"[0..78]
     end
     nil
   end
@@ -35,16 +34,24 @@ 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
 
     copy
   end
 
-  def self.shared_mutable_state?(obj1, obj2)
-    each_shared_object(obj1, obj2, filter: method(:mutable?)).any?
+  def self.shared_mutable_state?(*objects)
+    objects.combination(2).any? do |obj1, obj2|
+      each_shared_object(obj1, obj2, filter: method(:mutable?)).any?
+    end
   end
 
   # returns [[shared_object, path1, path2], ...], e.g.:
@@ -87,7 +94,7 @@ module Leto
     if defined?(Integer)
       Integer
     else
-      Fixnum # rubocop:disable Lint/UnifiedInteger for Ruby < 2.4
+      Fixnum # rubocop:disable Lint/UnifiedInteger -- for Ruby < 2.4
     end,
     NilClass,
     Symbol,

data/lib/leto/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Leto
-  VERSION = "2.1.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,16 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: leto
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 2.3.0
 platform: ruby
 authors:
 - Janosch Müller
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-05-20 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
-description:
 email:
 - janosch84@gmail.com
 executables: []
@@ -29,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
@@ -38,7 +37,6 @@ licenses:
 metadata:
   changelog_uri: https://github.com/jaynetics/leto/blob/main/CHANGELOG.md
   homepage_uri: https://github.com/jaynetics/leto
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -53,8 +51,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.13
-signing_key:
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Generic object traverser
 test_files: []