everythingrb 0.8.3 → 0.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6523ad82c57c693afadd2a17649c6628b49c0f775d0c3af09b5b207d8bace8a7
-  data.tar.gz: 8c0c363214cf537d6ada6ad78d0da899ddbfdc17066325774b9e8f6f97b9f6f1
+  metadata.gz: 7361ef45ed502564c8e27fd3b2173702320f2076665ae9f495f5645fc7b57587
+  data.tar.gz: 411dc777df9851c7204903dde8ce12ce6951cf2308d9c02e6184bf0fef67a056
 SHA512:
-  metadata.gz: 8a9f2620930ed9635287815679639cbd5403dc31b382717e107d8fbebf5fad0b6ba4be5398478f9b240141bbbbd2889cccbfc86d9330aeb1547386ab114bf034
-  data.tar.gz: 8b6f1facb28da84ad99d7e52d14196ae023521c8ea26c075e1649f02364a29595f424b8aa9719438742ae2f5cc8ce047336534e94357693c7a678f225fdbc353
+  metadata.gz: 548f88f645e3d1731ccbe258e9e8d4157003f9b5f584942f8a2b14657bab1c04de965c16bd2a7bb0f2305edfc92c3e73c5bcd7a07f9627cccd3eef46e5488076
+  data.tar.gz: fb00c066860dc38a4b8b1091978618af0d6ee06bc477dbdb9d2a8603e043e0de8b7b93aab09964035f13efae77e0ec0a05fa00ea6caa3a70ad9d1c32b577c8d4

data/CHANGELOG.md

@@ -15,6 +15,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Removed
 -->
 
+## [0.9.1] - 12026-01-22
+
+### Changed
+
+- **Deprecated `Hash.new_nested_hash`** - This method is now deprecated and will be removed in v1.0.0. Consider using `Hash.new { |h, k| h[k] = Hash.new(&h.default_proc) }` instead.
+
+## [0.9.0] - 12025-08-01
+
+### Added
+
+- **Added `Hash#compact_blank_merge` and `Hash#compact_blank_merge!`** - Merge only present (non-blank) values when ActiveSupport is loaded. Filters out nil, empty strings, empty arrays, false, and other blank values according to ActiveSupport's definition.
+- Added `with_index` parameter to `Hash#join_map` for API consistency with `Array#join_map`.
+
+### Changed
+
+- **BREAKING: Renamed `Hash#merge_compact` to `Hash#compact_merge`** - Updated method naming for consistency with other operation-first methods like `compact_prefix`, `trim_nils`, etc. The old method names will be removed in this version.
+- **BREAKING: Renamed `Hash#merge_compact!` to `Hash#compact_merge!`** - In-place version follows the same naming convention.
+
+### Removed
+
+- **BREAKING: Removed `Hash#merge_compact` and `Hash#merge_compact!`** - These methods have been renamed to `Hash#compact_merge` and `Hash#compact_merge!` respectively for naming consistency.
+- **Removed deprecated Hash value filtering methods** - `Hash#select_values`, `Hash#select_values!`, `Hash#reject_values`, `Hash#reject_values!`, and `Hash#filter_values`, `Hash#filter_values!` have been removed as planned. These methods were deprecated in v0.8.3. Use the standard Ruby alternatives instead:
+  - `hash.select_values { |v| condition }` → `hash.select { |k, v| condition }`
+  - `hash.reject_values { |v| condition }` → `hash.reject { |k, v| condition }`
+  - For blank filtering: `hash.reject_values(&:blank?)` → `hash.compact_blank` (with ActiveSupport)
+
 ## [0.8.3] - 12025-05-31
 
 ### Added
@@ -22,6 +48,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Changed
 
 - **Deprecated Hash value filtering methods** - `Hash#select_values`, `Hash#reject_values`, `Hash#select_values!` and `Hash#reject_values!` are now deprecated and will be removed in v0.9.0. These methods largely duplicate existing Ruby/ActiveSupport functionality:
+
   - `hash.reject_values(&:blank?)` → use `hash.compact_blank` instead
   - `hash.select_values { |v| condition }` → use `hash.select { |k, v| condition }`
   - `hash.reject_values { |v| condition }` → use `hash.reject { |k, v| condition }`
@@ -95,6 +122,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - `Hash#reject_values!` - Same as `reject_values` but modifies the hash in place
   - Added `filter_values` and `filter_values!` as aliases for `select_values` and `select_values!` respectively
 - Added `Kernel#morph` as an alias for `then` (and `yield_self`) that better communicates transformation intent:
+
   ```ruby
   # Instead of this:
   value.then { |v| transform_somehow(v) }
@@ -124,12 +152,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   The chainable `.with_key` method approach has been replaced with a more straightforward parameter-based approach.
 
   **Before:**
+
   ```ruby
   hash.transform_values.with_key { |value, key| "#{key}:#{value}" }
   hash.transform_values!.with_key { |value, key| "#{key}:#{value}" }
   ```
 
   **After:**
+
   ```ruby
   hash.transform_values(with_key: true) { |value, key| "#{key}:#{value}" }
   hash.transform_values!(with_key: true) { |value, key| "#{key}:#{value}" }
@@ -148,11 +178,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 The parameter order in `Hash#transform_values.with_key` has been changed to yield `|value, key|` instead of `|key, value|` to maintain consistency with Ruby's standard enumeration methods like `each_with_index`.
 
 **Before:**
+
 ```ruby
 hash.transform_values.with_key { |key, value| "#{key}: #{value}" }
 ```
 
 **After:**
+
 ```ruby
 hash.transform_values.with_key { |value, key| "#{key}: #{value}" }
 ```
@@ -164,11 +196,11 @@ This change aligns our method signatures with Ruby's conventions and matches our
 - Added `Hash#transform` and `Hash#transform!` for transforming a hash's keys and values at the same time.
 
 ### Changed
+
 - Changed parameter order in `Hash#transform_values.with_key` to yield `|value, key|` instead of `|key, value|` for consistency with Ruby conventions.
 
 ### Removed
 
-
 ## [0.4.0] - 12025-04-11
 
 ### Added
@@ -316,7 +348,10 @@ This change aligns our method signatures with Ruby's conventions and matches our
 
 - Added alias `each` to `each_pair` in OpenStruct for better enumerable compatibility
 
-[unreleased]: https://github.com/itsthedevman/everythingrb/compare/v0.8.3...HEAD
+[unreleased]: https://github.com/itsthedevman/everythingrb/compare/v0.9.1...HEAD
+[0.9.1]: https://github.com/itsthedevman/everythingrb/compare/v0.9.0...v0.9.1
+[0.9.0]: https://github.com/itsthedevman/everythingrb/compare/v0.8.3...v0.9.0
+[0.8.3]: https://github.com/itsthedevman/everythingrb/compare/v0.8.2...v0.8.3
 [0.8.3]: https://github.com/itsthedevman/everythingrb/compare/v0.8.2...v0.8.3
 [0.8.2]: https://github.com/itsthedevman/everythingrb/compare/v0.8.1...v0.8.2
 [0.8.1]: https://github.com/itsthedevman/everythingrb/compare/v0.8.0...v0.8.1

data/README.md

@@ -4,7 +4,7 @@
 ![Ruby Version](https://img.shields.io/badge/ruby-3.3.7-ruby)
 [![Tests](https://github.com/itsthedevman/everythingrb/actions/workflows/main.yml/badge.svg)](https://github.com/everythingrb/sortsmith/actions/workflows/main.yml)
 
-Super handy extensions to Ruby core classes that make your code more expressive, readable, and fun to write. Stop writing boilerplate and start writing code that *actually matters*!
+Super handy extensions to Ruby core classes that make your code more expressive, readable, and fun to write. Stop writing boilerplate and start writing code that _actually matters_!
 
 ## Express Your Intent, Not Your Logic
 
@@ -31,7 +31,7 @@ users.join_map(", ") { |u| u[:name] if u[:role] == "admin" }
 # => "Alice, Charlie"
 ```
 
-*Methods used: [`join_map`](https://itsthedevman.com/docs/everythingrb/Array.html#join_map-instance_method)*
+_Methods used: [`join_map`](https://itsthedevman.com/docs/everythingrb/Array.html#join_map-instance_method)_
 
 Because life's too short to write all that boilerplate!
 
@@ -84,6 +84,7 @@ require "everythingrb/string"   # Just String extensions
 ```
 
 Available modules:
+
 - `array`: Array extensions (join_map, key_map, etc.)
 - `boolean`: Boolean extensions (in_quotes, with_quotes)
 - `data`: Data extensions (to_deep_h, in_quotes)
@@ -143,7 +144,7 @@ With EverythingRB, it's one elegant step:
 '{"user":{"name":"Alice","roles":["admin"]}}'.to_ostruct.user.name  # => "Alice"
 ```
 
-*Methods used: [`to_ostruct`](https://itsthedevman.com/docs/everythingrb/String.html#to_ostruct-instance_method)*
+_Methods used: [`to_ostruct`](https://itsthedevman.com/docs/everythingrb/String.html#to_ostruct-instance_method)_
 
 Convert between data structures with ease:
 
@@ -161,7 +162,7 @@ config = { server: { host: "example.com", port: 443 } }.to_struct
 config.server.host  # => "example.com"
 ```
 
-*Methods used: [`to_struct`](https://itsthedevman.com/docs/everythingrb/Hash.html#to_struct-instance_method)*
+_Methods used: [`to_struct`](https://itsthedevman.com/docs/everythingrb/Hash.html#to_struct-instance_method)_
 
 Deep conversion to plain hashes is just as easy:
 
@@ -181,7 +182,7 @@ data = OpenStruct.new(user: Data.define(:name).new(name: "Bob"))
 data.to_deep_h  # => {user: {name: "Bob"}}
 ```
 
-*Methods used: [`to_deep_h`](https://itsthedevman.com/docs/everythingrb/OpenStruct.html#to_deep_h-instance_method)*
+_Methods used: [`to_deep_h`](https://itsthedevman.com/docs/everythingrb/OpenStruct.html#to_deep_h-instance_method)_
 
 **Extensions:** [`to_struct`](https://itsthedevman.com/docs/everythingrb/Hash.html#to_struct-instance_method), [`to_ostruct`](https://itsthedevman.com/docs/everythingrb/Hash.html#to_ostruct-instance_method), [`to_istruct`](https://itsthedevman.com/docs/everythingrb/Hash.html#to_istruct-instance_method), [`to_h`](https://itsthedevman.com/docs/everythingrb/String.html#to_h-instance_method), [`to_deep_h`](https://itsthedevman.com/docs/everythingrb/Hash.html#to_deep_h-instance_method)
 
@@ -191,7 +192,7 @@ Extract and transform data with elegant, expressive code:
 
 ```ruby
 # BEFORE
-users = [{ name: "Alice", roles: ["admin"] }, { name: "Bob", roles: ["user"] }]
+users = [{ name: "Alice", role: "admin" }, { name: "Bob", role: "user" }]
 names = users.map { |user| user[:name] }
 # => ["Alice", "Bob"]
 ```
@@ -201,7 +202,7 @@ names = users.map { |user| user[:name] }
 users.key_map(:name)  # => ["Alice", "Bob"]
 ```
 
-*Methods used: [`key_map`](https://itsthedevman.com/docs/everythingrb/Array.html#key_map-instance_method)*
+_Methods used: [`key_map`](https://itsthedevman.com/docs/everythingrb/Array.html#key_map-instance_method)_
 
 Simplify nested data extraction:
 
@@ -220,7 +221,7 @@ names = users.map { |u| u.dig(:user, :profile, :name) }
 users.dig_map(:user, :profile, :name)  # => ["Alice", "Bob"]
 ```
 
-*Methods used: [`dig_map`](https://itsthedevman.com/docs/everythingrb/Array.html#dig_map-instance_method)*
+_Methods used: [`dig_map`](https://itsthedevman.com/docs/everythingrb/Array.html#dig_map-instance_method)_
 
 Combine filter, map, and join operations in one step:
 
@@ -237,7 +238,24 @@ result = data.compact.filter_map { |n| "Item #{n}" if n.odd? }.join(" | ")
 # => "Item 1 | Item 3"
 ```
 
-*Methods used: [`join_map`](https://itsthedevman.com/docs/everythingrb/Array.html#join_map-instance_method)*
+_Methods used: [`join_map`](https://itsthedevman.com/docs/everythingrb/Array.html#join_map-instance_method)_
+
+Need position-aware processing? Both Array and Hash support `with_index`:
+
+```ruby
+# BEFORE
+users = {alice: "Alice", bob: "Bob", charlie: "Charlie"}
+users.filter_map.with_index { |(k, v), i| "#{i + 1}. #{v}" }.join(", ")
+# => "1. Alice, 2. Bob, 3. Charlie"
+```
+
+```ruby
+# AFTER
+users.join_map(", ", with_index: true) { |(k, v), i| "#{i + 1}. #{v}" }
+# => "1. Alice, 2. Bob, 3. Charlie"
+```
+
+_Methods used: [`join_map`](https://itsthedevman.com/docs/everythingrb/Hash.html#join_map-instance_method)_
 
 Group elements with natural syntax:
 
@@ -258,7 +276,7 @@ users.group_by_key(:department, :name)
 # => {"Engineering"=>[{name: "Alice",...}, {name: "Charlie",...}], "Sales"=>[{name: "Bob",...}]}
 ```
 
-*Methods used: [`group_by_key`](https://itsthedevman.com/docs/everythingrb/Enumerable.html#group_by_key-instance_method)*
+_Methods used: [`group_by_key`](https://itsthedevman.com/docs/everythingrb/Enumerable.html#group_by_key-instance_method)_
 
 Create natural language lists:
 
@@ -283,32 +301,13 @@ end
 ["red", "blue", "green"].to_or_sentence  # => "red, blue, or green"
 ```
 
-*Methods used: [`to_or_sentence`](https://itsthedevman.com/docs/everythingrb/Array.html#to_or_sentence-instance_method)*
+_Methods used: [`to_or_sentence`](https://itsthedevman.com/docs/everythingrb/Array.html#to_or_sentence-instance_method)_
 
 **Extensions:** [`join_map`](https://itsthedevman.com/docs/everythingrb/Array.html#join_map-instance_method), [`key_map`](https://itsthedevman.com/docs/everythingrb/Array.html#key_map-instance_method), [`dig_map`](https://itsthedevman.com/docs/everythingrb/Array.html#dig_map-instance_method), [`to_or_sentence`](https://itsthedevman.com/docs/everythingrb/Array.html#to_or_sentence-instance_method), [`group_by_key`](https://itsthedevman.com/docs/everythingrb/Enumerable.html#group_by_key-instance_method)
 
 ### Hash Convenience
 
-Work with hashes more intuitively:
-
-```ruby
-# BEFORE
-stats = {}
-stats[:server] ||= {}
-stats[:server][:region] ||= {}
-stats[:server][:region][:us_east] ||= {}
-stats[:server][:region][:us_east][:errors] ||= []
-stats[:server][:region][:us_east][:errors] << "Connection timeout"
-```
-
-```ruby
-# AFTER
-stats = Hash.new_nested_hash(depth: 3)
-(stats[:server][:region][:us_east][:errors] ||= []) << "Connection timeout"
-# No need to initialize each level first!
-```
-
-*Methods used: [`new_nested_hash`](https://itsthedevman.com/docs/everythingrb/Hash.html#new_nested_hash-class_method)*
+Work with hashes more intuitively.
 
 Transform values with access to their keys:
 
@@ -328,7 +327,7 @@ users.transform_values(with_key: true) { |v, k| "User #{k}: #{v[:name]}" }
 # => {alice: "User alice: Alice", bob: "User bob: Bob"}
 ```
 
-*Methods used: [`transform_values(with_key: true)`](https://itsthedevman.com/docs/everythingrb/Hash.html#transform_values-instance_method)*
+_Methods used: [`transform_values(with_key: true)`](https://itsthedevman.com/docs/everythingrb/Hash.html#transform_values-instance_method)_
 
 Find values based on conditions:
 
@@ -349,7 +348,7 @@ users.values_where { |_k, v| v[:role] == "admin" }
 # => [{name: "Alice", role: "admin"}, {name: "Charlie", role: "admin"}]
 ```
 
-*Methods used: [`values_where`](https://itsthedevman.com/docs/everythingrb/Hash.html#values_where-instance_method)*
+_Methods used: [`values_where`](https://itsthedevman.com/docs/everythingrb/Hash.html#values_where-instance_method)_
 
 Just want the first match? Even simpler:
 
@@ -365,7 +364,7 @@ users.value_where { |_k, v| v[:role] == "admin" }
 # => {name: "Alice", role: "admin"}
 ```
 
-*Methods used: [`value_where`](https://itsthedevman.com/docs/everythingrb/Hash.html#value_where-instance_method)*
+_Methods used: [`value_where`](https://itsthedevman.com/docs/everythingrb/Hash.html#value_where-instance_method)_
 
 Rename keys while preserving order:
 
@@ -395,23 +394,7 @@ config.rename_keys(api_key: :key, timeout: :request_timeout)
 # => {key: "secret", request_timeout: 30}
 ```
 
-*Methods used: [`rename_keys`](https://itsthedevman.com/docs/everythingrb/Hash.html#rename_keys-instance_method)*
-
-Filter hash by values:
-
-```ruby
-# BEFORE
-result = {a: 1, b: nil, c: 2}.select { |_k, v| v.is_a?(Integer) && v > 1 }
-# => {c: 2}
-```
-
-```ruby
-# AFTER
-{a: 1, b: nil, c: 2}.select_values { |v| v.is_a?(Integer) && v > 1 }
-# => {c: 2}
-```
-
-*Methods used: [`select_values`](https://itsthedevman.com/docs/everythingrb/Hash.html#select_values-instance_method)*
+_Methods used: [`rename_keys`](https://itsthedevman.com/docs/everythingrb/Hash.html#rename_keys-instance_method)_
 
 Conditionally merge hashes with clear intent:
 
@@ -430,7 +413,7 @@ user_params.merge_if(verified: true, admin: true) { |k, v| v == true && k == :ve
 # => {name: "Alice", role: "user", verified: true}
 ```
 
-*Methods used: [`merge_if`](https://itsthedevman.com/docs/everythingrb/Hash.html#merge_if-instance_method)*
+_Methods used: [`merge_if`](https://itsthedevman.com/docs/everythingrb/Hash.html#merge_if-instance_method)_
 
 The nil-filtering pattern we've all written dozens of times:
 
@@ -445,13 +428,33 @@ params.merge(filtered)
 ```ruby
 # AFTER
 params = {sort: "created_at"}
-params.merge_compact(filter: "active", search: nil)
+params.compact_merge(filter: "active", search: nil)
 # => {sort: "created_at", filter: "active"}
 ```
 
-*Methods used: [`merge_compact`](https://itsthedevman.com/docs/everythingrb/Hash.html#merge_compact-instance_method)*
+_Methods used: [`compact_merge`](https://itsthedevman.com/docs/everythingrb/Hash.html#compact_merge-instance_method)_
+
+Filter out blank values too when ActiveSupport is loaded:
+
+```ruby
+# BEFORE
+config = {api_key: "secret", timeout: 30}
+user_settings = {timeout: "", retries: nil, debug: true, tags: []}
+clean_settings = user_settings.reject { |k, v| v.blank? }
+config.merge(clean_settings)
+# => {api_key: "secret", timeout: 30, debug: true}
+```
+
+```ruby
+# AFTER
+config = {api_key: "secret", timeout: 30}
+config.compact_blank_merge(timeout: "", retries: nil, debug: true, tags: [])
+# => {api_key: "secret", timeout: 30, debug: true}
+```
+
+_Methods used: [`compact_blank_merge`](https://itsthedevman.com/docs/everythingrb/Hash.html#compact_blank_merge-instance_method)_
 
-**Extensions:** [`new_nested_hash`](https://itsthedevman.com/docs/everythingrb/Hash.html#new_nested_hash-class_method), [`transform_values(with_key: true)`](https://itsthedevman.com/docs/everythingrb/Hash.html#transform_values-instance_method), [`value_where`](https://itsthedevman.com/docs/everythingrb/Hash.html#value_where-instance_method), [`values_where`](https://itsthedevman.com/docs/everythingrb/Hash.html#values_where-instance_method), [`rename_key`](https://itsthedevman.com/docs/everythingrb/Hash.html#rename_key-instance_method), [`rename_keys`](https://itsthedevman.com/docs/everythingrb/Hash.html#rename_keys-instance_method), [`select_values`](https://itsthedevman.com/docs/everythingrb/Hash.html#select_values-instance_method), [`reject_values`](https://itsthedevman.com/docs/everythingrb/Hash.html#reject_values-instance_method), [`merge_if`](https://itsthedevman.com/docs/everythingrb/Hash.html#merge_if-instance_method), [`merge_if!`](https://itsthedevman.com/docs/everythingrb/Hash.html#merge_if%21-instance_method), [`merge_if_values`](https://itsthedevman.com/docs/everythingrb/Hash.html#merge_if_values-instance_method), [`merge_if_values!`](https://itsthedevman.com/docs/everythingrb/Hash.html#merge_if_values%21-instance_method), [`merge_compact`](https://itsthedevman.com/docs/everythingrb/Hash.html#merge_compact-instance_method), [`merge_compact!`](https://itsthedevman.com/docs/everythingrb/Hash.html#merge_compact%21-instance_method)
+**Extensions:** [`transform_values(with_key: true)`](https://itsthedevman.com/docs/everythingrb/Hash.html#transform_values-instance_method), [`value_where`](https://itsthedevman.com/docs/everythingrb/Hash.html#value_where-instance_method), [`values_where`](https://itsthedevman.com/docs/everythingrb/Hash.html#values_where-instance_method), [`rename_key`](https://itsthedevman.com/docs/everythingrb/Hash.html#rename_key-instance_method), [`rename_keys`](https://itsthedevman.com/docs/everythingrb/Hash.html#rename_keys-instance_method), [`merge_if`](https://itsthedevman.com/docs/everythingrb/Hash.html#merge_if-instance_method), [`merge_if!`](https://itsthedevman.com/docs/everythingrb/Hash.html#merge_if%21-instance_method), [`merge_if_values`](https://itsthedevman.com/docs/everythingrb/Hash.html#merge_if_values-instance_method), [`merge_if_values!`](https://itsthedevman.com/docs/everythingrb/Hash.html#merge_if_values%21-instance_method), [`compact_merge`](https://itsthedevman.com/docs/everythingrb/Hash.html#compact_merge-instance_method), [`compact_merge!`](https://itsthedevman.com/docs/everythingrb/Hash.html#compact_merge%21-instance_method), [`compact_blank_merge`](https://itsthedevman.com/docs/everythingrb/Hash.html#compact_blank_merge-instance_method), [`compact_blank_merge!`](https://itsthedevman.com/docs/everythingrb/Hash.html#compact_blank_merge%21-instance_method)
 
 ### Array Cleaning
 
@@ -469,7 +472,7 @@ data.drop_while(&:nil?).reverse.drop_while(&:nil?).reverse
 [nil, nil, 1, nil, 2, nil, nil].trim_nils  # => [1, nil, 2]
 ```
 
-*Methods used: [`trim_nils`](https://itsthedevman.com/docs/everythingrb/Array.html#trim_nils-instance_method)*
+_Methods used: [`trim_nils`](https://itsthedevman.com/docs/everythingrb/Array.html#trim_nils-instance_method)_
 
 With ActiveSupport, remove blank values too:
 
@@ -485,7 +488,7 @@ data.drop_while(&:blank?).reverse.drop_while(&:blank?).reverse
 [nil, "", 1, "", 2, nil, ""].trim_blanks  # => [1, "", 2]
 ```
 
-*Methods used: [`trim_blanks`](https://itsthedevman.com/docs/everythingrb/Array.html#trim_blanks-instance_method)*
+_Methods used: [`trim_blanks`](https://itsthedevman.com/docs/everythingrb/Array.html#trim_blanks-instance_method)_
 
 **Extensions:** [`trim_nils`](https://itsthedevman.com/docs/everythingrb/Array.html#trim_nils-instance_method), [`compact_prefix`](https://itsthedevman.com/docs/everythingrb/Array.html#compact_prefix-instance_method), [`compact_suffix`](https://itsthedevman.com/docs/everythingrb/Array.html#compact_suffix-instance_method), [`trim_blanks`](https://itsthedevman.com/docs/everythingrb/Array.html#trim_blanks-instance_method) (with ActiveSupport)
 
@@ -528,7 +531,7 @@ Time.now.in_quotes     # => "\"2025-05-04 12:34:56 +0000\""
 message = "You selected #{selection.in_quotes}"
 ```
 
-*Methods used: [`in_quotes`](https://itsthedevman.com/docs/everythingrb/Everythingrb/InspectQuotable.html#in_quotes-instance_method), [`with_quotes`](https://itsthedevman.com/docs/everythingrb/Everythingrb/InspectQuotable.html#with_quotes-instance_method)*
+_Methods used: [`in_quotes`](https://itsthedevman.com/docs/everythingrb/Everythingrb/InspectQuotable.html#in_quotes-instance_method), [`with_quotes`](https://itsthedevman.com/docs/everythingrb/Everythingrb/InspectQuotable.html#with_quotes-instance_method)_
 
 Convert strings to camelCase with ease:
 
@@ -555,7 +558,7 @@ camel_case
 "please-WAIT while_loading...".to_camelcase  # => "PleaseWaitWhileLoading"
 ```
 
-*Methods used: [`to_camelcase`](https://itsthedevman.com/docs/everythingrb/String.html#to_camelcase-instance_method)*
+_Methods used: [`to_camelcase`](https://itsthedevman.com/docs/everythingrb/String.html#to_camelcase-instance_method)_
 
 **Extensions:** [`in_quotes`](https://itsthedevman.com/docs/everythingrb/Everythingrb/InspectQuotable.html#in_quotes-instance_method), [`with_quotes`](https://itsthedevman.com/docs/everythingrb/Everythingrb/InspectQuotable.html#with_quotes-instance_method) (alias), [`to_camelcase`](https://itsthedevman.com/docs/everythingrb/String.html#to_camelcase-instance_method)
 
@@ -590,7 +593,7 @@ user.admin = true
 user.admin?  # => true
 ```
 
-*Methods used: [`attr_predicate`](https://itsthedevman.com/docs/everythingrb/Module.html#attr_predicate-instance_method)*
+_Methods used: [`attr_predicate`](https://itsthedevman.com/docs/everythingrb/Module.html#attr_predicate-instance_method)_
 
 Works with Data objects too:
 
@@ -610,7 +613,7 @@ person = Person.new(active: false)
 person.active? # => false
 ```
 
-*Methods used: [`attr_predicate`](https://itsthedevman.com/docs/everythingrb/Module.html#attr_predicate-instance_method)*
+_Methods used: [`attr_predicate`](https://itsthedevman.com/docs/everythingrb/Module.html#attr_predicate-instance_method)_
 
 **Extensions:** [`attr_predicate`](https://itsthedevman.com/docs/everythingrb/Module.html#attr_predicate-instance_method)
 
@@ -628,7 +631,7 @@ result = value.then { |v| transform_it(v) }
 result = value.morph { |v| transform_it(v) }
 ```
 
-*Methods used: [`morph`](https://itsthedevman.com/docs/everythingrb/Kernel.html#morph-instance_method)*
+_Methods used: [`morph`](https://itsthedevman.com/docs/everythingrb/Kernel.html#morph-instance_method)_
 
 **Extensions:** [`morph`](https://itsthedevman.com/docs/everythingrb/Kernel.html#morph-instance_method) (alias for `then`/`yield_self`)
 

data/flake.lock

@@ -20,11 +20,11 @@
     },
     "nixpkgs": {
       "locked": {
-        "lastModified": 1742422364,
-        "narHash": "sha256-mNqIplmEohk5jRkqYqG19GA8MbQ/D4gQSK0Mu4LvfRQ=",
+        "lastModified": 1750506804,
+        "narHash": "sha256-VLFNc4egNjovYVxDGyBYTrvVCgDYgENp5bVi9fPTDYc=",
         "owner": "NixOS",
         "repo": "nixpkgs",
-        "rev": "a84ebe20c6bc2ecbcfb000a50776219f48d134cc",
+        "rev": "4206c4cb56751df534751b058295ea61357bbbaa",
         "type": "github"
       },
       "original": {

data/flake.nix

@@ -21,7 +21,7 @@
         devShells.default = pkgs.mkShell {
           buildInputs = with pkgs; [
             (ruby_3_2.override {
-              jemallocSupport = true;
+              jemallocSupport = false;
               docSupport = false;
             })
 

data/lib/everythingrb/hash.rb

@@ -13,7 +13,8 @@
 # - ::new_nested_hash: Create automatically nesting hashes
 # - #merge_if, #merge_if!: Conditionally merge based on key-value pairs
 # - #merge_if_values, #merge_if_values!: Conditionally merge based on values
-# - #merge_compact, #merge_compact!: Merge only non-nil values
+# - #compact_merge, #compact_merge!: Merge only non-nil values
+# - #compact_blank_merge, #compact_blank_merge!: Merge only present values (ActiveSupport)
 #
 # @example
 #   require "everythingrb/hash"
@@ -77,6 +78,11 @@ class Hash
   #   parameter to control this behavior.
   #
   def self.new_nested_hash(depth: nil)
+    Everythingrb.deprecator.warn(
+      "Hash.new_nested_hash is deprecated and will be removed in v1.0.0. " \
+      "Consider using Hash.new { |h, k| h[k] = Hash.new(&h.default_proc) } instead."
+    )
+
     new do |hash, key|
       next if depth == 0
 
@@ -93,25 +99,37 @@ class Hash
   # Combines filter_map and join operations
   #
   # @param join_with [String] The delimiter to join elements with (defaults to empty string)
+  # @param with_index [Boolean] Whether to include the index in the block (defaults to false)
   #
-  # @yield [key, value] Block that filters and transforms hash entries
-  # @yieldparam key [Object] The current key
-  # @yieldparam value [Object] The current value
+  # @yield [key_value_pair, index] Block that filters and transforms hash entries
+  # @yieldparam key_value_pair [Array] Two-element array containing [key, value] (can be destructured as |key, value|)
+  # @yieldparam index [Integer] The index of the current entry (only if with_index: true)
   #
   # @return [String] Joined string of filtered and transformed entries
   #
-  # @example
+  # @example Basic usage without index
   #   { a: 1, b: nil, c: 2, d: nil, e: 3 }.join_map(", ") { |k, v| "#{k}-#{v}" if v }
   #   # => "a-1, c-2, e-3"
   #
-  # @example Without a block
+  # @example With index for position-aware formatting
+  #   users = {alice: "Alice", bob: "Bob", charlie: "Charlie"}
+  #   users.join_map(", ", with_index: true) do |(k, v), i|
+  #     "#{i + 1}. #{v}"
+  #   end
+  #   # => "1. Alice, 2. Bob, 3. Charlie"
+  #
+  # @example Without a block (default behavior)
   #   { a: 1, b: nil, c: 2 }.join_map(" ")
   #   # => "a 1 b c 2"
   #
-  def join_map(join_with = "", &block)
+  def join_map(join_with = "", with_index: false, &block)
     block = ->(kv_pair) { kv_pair.compact } if block.nil?
 
-    filter_map(&block).join(join_with)
+    if with_index
+      filter_map.with_index(&block).join(join_with)
+    else
+      filter_map(&block).join(join_with)
+    end
   end
 
   #
@@ -661,70 +679,6 @@ class Hash
     self
   end
 
-  #
-  # Selects hash entries based only on their values
-  #
-  # @deprecated Hash#select_values will be removed in 0.9.0. Please use `select { |k, v| condition }` instead.
-  #
-  def select_values(&block)
-    Everythingrb.deprecator.warn(
-      "Hash#select_values will be removed in 0.9.0. Please use `select { |k, v| condition }` instead."
-    )
-
-    return to_enum(:select_values) if block.nil?
-
-    select { |_k, v| block.call(v) }
-  end
-
-  alias_method :filter_values, :select_values
-
-  #
-  # Selects hash entries based only on their values, modifying the hash in place
-  #
-  # @deprecated Hash#select_values! will be removed in 0.9.0. Please use `select! { |k, v| condition }` instead.
-  #
-  def select_values!(&block)
-    Everythingrb.deprecator.warn(
-      "Hash#select_values! will be removed in 0.9.0. Please use `select! { |k, v| condition }` instead."
-    )
-
-    return to_enum(:select_values!) if block.nil?
-
-    select! { |_k, v| block.call(v) }
-  end
-
-  alias_method :filter_values!, :select_values!
-
-  #
-  # Rejects hash entries based only on their values
-  #
-  # @deprecated Hash#reject_values will be removed in 0.9.0. Please use `reject { |k, v| condition }` instead.
-  #
-  def reject_values(&block)
-    Everythingrb.deprecator.warn(
-      "Hash#reject_values will be removed in 0.9.0. Please use `reject { |k, v| condition }` instead."
-    )
-
-    return to_enum(:reject_values) if block.nil?
-
-    reject { |_k, v| block.call(v) }
-  end
-
-  #
-  # Rejects hash entries based only on their values, modifying the hash in place
-  #
-  # @deprecated Hash#reject_values! will be removed in 0.9.0. Please use `reject! { |k, v| condition }` instead.
-  #
-  def reject_values!(&block)
-    Everythingrb.deprecator.warn(
-      "Hash#reject_values! will be removed in 0.9.0. Please use `reject! { |k, v| condition }` instead."
-    )
-
-    return to_enum(:reject_values!) if block.nil?
-
-    reject! { |_k, v| block.call(v) }
-  end
-
   #
   # Conditionally merges key-value pairs from another hash based on a block
   #
@@ -828,15 +782,15 @@ class Hash
   #   email = nil
   #   name = "Alice"
   #
-  #   {}.merge_compact(
+  #   {}.compact_merge(
   #     id: user_id,
   #     email: email,
   #     name: name
   #   )
   #   # => {id: 42, name: "Alice"}
   #
-  def merge_compact(other = {})
-    merge_if_values(other, &:itself)
+  def compact_merge(other = {})
+    merge_if_values(other) { |i| i.itself }
   end
 
   #
@@ -851,14 +805,76 @@ class Hash
   #
   # @example Merge only non-nil values in place
   #   params = {format: "json"}
-  #   params.merge_compact!(
+  #   params.compact_merge!(
   #     page: 1,
   #     per_page: nil,
   #     sort: "created_at"
   #   )
   #   # => {format: "json", page: 1, sort: "created_at"}
   #
-  def merge_compact!(other = {})
-    merge_if_values!(other, &:itself)
+  def compact_merge!(other = {})
+    merge_if_values!(other) { |i| i.itself }
+  end
+
+  # ActiveSupport integrations
+  if defined?(ActiveSupport)
+    #
+    # Merges only present (non-blank) values from another hash
+    #
+    # This method merges key-value pairs from another hash, but only includes
+    # values that are present according to ActiveSupport's definition (not nil,
+    # not empty strings, not empty arrays, etc.).
+    #
+    # @param other [Hash] The hash to merge from
+    #
+    # @return [Hash] A new hash with present values merged
+    #
+    # @note Only available when ActiveSupport is loaded
+    #
+    # @example Building API responses without blank values
+    #   user_data = {name: "Alice", role: "admin"}
+    #   user_data.compact_blank_merge(
+    #     bio: "",           # excluded - blank string
+    #     tags: [],          # excluded - empty array
+    #     email: "a@example.com", # included - present
+    #     phone: nil         # excluded - nil
+    #   )
+    #   # => {name: "Alice", role: "admin", email: "a@example.com"}
+    #
+    # @example Configuration merging with blank filtering
+    #   defaults = {timeout: 30, retries: 3}
+    #   user_config = {timeout: "", retries: 5, debug: true}
+    #   defaults.compact_blank_merge(user_config)
+    #   # => {timeout: 30, retries: 5, debug: true}
+    #
+    def compact_blank_merge(other = {})
+      merge_if_values(other) { |i| i.present? }
+    end
+
+    #
+    # Merges only present (non-blank) values from another hash, in place
+    #
+    # This method merges key-value pairs from another hash into the current hash,
+    # but only includes values that are present according to ActiveSupport's
+    # definition (not nil, not empty strings, not empty arrays, etc.).
+    #
+    # @param other [Hash] The hash to merge from
+    #
+    # @return [self] The modified hash
+    #
+    # @note Only available when ActiveSupport is loaded
+    #
+    # @example Building parameters while excluding blanks
+    #   params = {action: "search", format: "json"}
+    #   params.compact_blank_merge!(
+    #     query: "",       # excluded - blank
+    #     page: 2,         # included - present
+    #     tags: []         # excluded - empty array
+    #   )
+    #   # => {action: "search", format: "json", page: 2}
+    #
+    def compact_blank_merge!(other = {})
+      merge_if_values!(other) { |i| i.present? }
+    end
   end
 end

data/lib/everythingrb/version.rb

@@ -7,5 +7,5 @@
 #
 module Everythingrb
   # Current version of the everythingrb gem
-  VERSION = "0.8.3"
+  VERSION = "0.9.1"
 end

data/lib/railtie.rb

@@ -21,9 +21,7 @@ module Everythingrb
     config.everythingrb.extensions = nil # Default to loading all
 
     initializer "everythingrb.initialize" do
-      # I learned that, whereas ActiveSupport is defined at this point, the core_ext files are
-      # required later down the line.
-      ActiveSupport.on_load(:active_record) do
+      ActiveSupport.on_load(:after_initialize) do
         require_relative "everythingrb/prelude"
 
         extensions = Rails.configuration.everythingrb.extensions

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: everythingrb
 version: !ruby/object:Gem::Version
-  version: 0.8.3
+  version: 0.9.1
 platform: ruby
 authors:
 - Bryan
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-06-01 00:00:00.000000000 Z
+date: 2026-01-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ostruct