everythingrb 0.8.2 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f1dea4517af697abde3f07ffb40d62a7ec40b3f8c0b91cc74eb93edde92e5aac
-  data.tar.gz: bb3888fac39b4d3138ddfb5f7d36504d3df28c274b4d9a950772aca0c5d5f0fc
+  metadata.gz: cd5be3e26181ed61cc29aee8e316f3fd10d3bc9f5ea1d424069c4aefdc1c8125
+  data.tar.gz: 86517a10235873c3075237ff7f774315dc390d68fe3cf23ee751f15ca750508f
 SHA512:
-  metadata.gz: 341bf18d8e774f882b01b5ab50a7d262d113ecdbefab288c4e373cc6bb89b9f86a3ddf8a67d7a842016e6f62d04816db136c658106cf11685c50bd7d35693264
-  data.tar.gz: d7d3f73c40cec2555958de71452af51945f681d7e9731edc477c6428e316e71c607e22d00abd9257a1b4dd6ee0be0ee33b067a745c996593109621251464c8ea
+  metadata.gz: 643b0c34ffa81f136d1abb91def2e6bdbb65a00888a735cdef95950db9877d3ea0d06c22119c36f3909283985711792bc0530944107ed76d744742daff40dd3c
+  data.tar.gz: 40db61bcf4b8c77a791b07fa30fcdd8e4d3b1f0054ff9124030d15b67ad8194db312cbb6f1ba2261499e5431132952746a5ef184ced15e212401207c15bf6dd6

data/CHANGELOG.md

@@ -15,6 +15,42 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Removed
 -->
 
+## [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
+
+### 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 }`
+
+  See [Issue #61](https://github.com/itsthedevman/everythingrb/issues/61) for full details.
+
+### Removed
+
 ## [0.8.2] - 12025-05-25
 
 ### Added
@@ -80,6 +116,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) }
@@ -109,12 +146,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}" }
@@ -133,11 +172,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}" }
 ```
@@ -149,11 +190,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
@@ -301,7 +342,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.2...HEAD
+[unreleased]: https://github.com/itsthedevman/everythingrb/compare/v0.9.0...HEAD
+[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
 [0.8.0]: https://github.com/itsthedevman/everythingrb/compare/v0.7.0...v0.8.0

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,7 +301,7 @@ 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)
 
@@ -308,7 +326,7 @@ stats = Hash.new_nested_hash(depth: 3)
 # No need to initialize each level first!
 ```
 
-*Methods used: [`new_nested_hash`](https://itsthedevman.com/docs/everythingrb/Hash.html#new_nested_hash-class_method)*
+_Methods used: [`new_nested_hash`](https://itsthedevman.com/docs/everythingrb/Hash.html#new_nested_hash-class_method)_
 
 Transform values with access to their keys:
 
@@ -328,7 +346,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 +367,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 +383,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 +413,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 +432,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 +447,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:** [`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), [`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 +491,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 +507,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 +550,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 +577,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 +612,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 +632,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 +650,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"
@@ -93,25 +94,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,102 +674,6 @@ class Hash
     self
   end
 
-  #
-  # Selects hash entries based only on their values
-  #
-  # @yield [value] Block that determines whether to include the entry
-  # @yieldparam value [Object] The current value
-  # @yieldreturn [Boolean] Whether to include this entry
-  #
-  # @return [Hash] A new hash including only entries where the block returned truthy
-  # @return [Enumerator] If no block is given
-  #
-  # @example Filter to include only present values (with ActiveSupport)
-  #   {name: "Alice", bio: nil, role: ""}.select_values(&:present?)
-  #   # => {name: "Alice"}
-  #
-  # @example Filter using more complex logic
-  #   {id: 1, count: 0, items: [1, 2, 3]}.select_values { |v| v.is_a?(Array) || v > 0 }
-  #   # => {id: 1, items: [1, 2, 3]}
-  #
-  def select_values(&block)
-    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
-  #
-  # @yield [value] Block that determines whether to keep the entry
-  # @yieldparam value [Object] The current value
-  # @yieldreturn [Boolean] Whether to keep this entry
-  #
-  # @return [self, nil] The modified hash, or nil if no changes were made
-  # @return [Enumerator] If no block is given
-  #
-  # @example Remove entries with empty values (with ActiveSupport)
-  #   hash = {name: "Alice", bio: nil, role: ""}
-  #   hash.select_values!(&:present?)
-  #   # => {name: "Alice"}
-  #   # hash is now {name: "Alice"}
-  #
-  def select_values!(&block)
-    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
-  #
-  # @yield [value] Block that determines whether to exclude the entry
-  # @yieldparam value [Object] The current value
-  # @yieldreturn [Boolean] Whether to exclude this entry
-  #
-  # @return [Hash] A new hash excluding entries where the block returned truthy
-  # @return [Enumerator] If no block is given
-  #
-  # @example Remove blank values (with ActiveSupport)
-  #   {name: "Alice", bio: nil, role: ""}.reject_values(&:blank?)
-  #   # => {name: "Alice"}
-  #
-  # @example Remove specific types of values
-  #   {id: 1, count: 0, items: [1, 2, 3]}.reject_values { |v| v.is_a?(Integer) && v == 0 }
-  #   # => {id: 1, items: [1, 2, 3]}
-  #
-  def reject_values(&block)
-    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
-  #
-  # @yield [value] Block that determines whether to remove the entry
-  # @yieldparam value [Object] The current value
-  # @yieldreturn [Boolean] Whether to remove this entry
-  #
-  # @return [self, nil] The modified hash, or nil if no changes were made
-  # @return [Enumerator] If no block is given
-  #
-  # @example Remove blank values in place (with ActiveSupport)
-  #   hash = {name: "Alice", bio: nil, role: ""}
-  #   hash.reject_values!(&:blank?)
-  #   # => {name: "Alice"}
-  #   # hash is now {name: "Alice"}
-  #
-  def reject_values!(&block)
-    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
   #
@@ -860,15 +777,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
 
   #
@@ -883,14 +800,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/prelude.rb

@@ -25,6 +25,15 @@ require "json"
 #   users.key_map(:name).join(", ")  # => "Alice, Bob"
 #
 module Everythingrb
+  def self.deprecator
+    @deprecator ||= if defined?(ActiveSupport)
+      ActiveSupport::Deprecation.new(VERSION, "everythingrb")
+    else
+      proxy = Data.define
+      proxy.define_method(:warn) { |message| puts "DEPRECATION WARNING: #{message}" }
+      proxy.new
+    end
+  end
 end
 
 require_relative "extensions"

data/lib/everythingrb/version.rb

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

data/lib/everythingrb.rb

@@ -1,9 +1,8 @@
 # frozen_string_literal: true
 
-require_relative "everythingrb/prelude"
-
 if defined?(Rails::Railtie)
   require_relative "railtie"
 else
+  require_relative "everythingrb/prelude"
   require_relative "everythingrb/all"
 end

data/lib/railtie.rb

@@ -21,9 +21,9 @@ 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
 
         if extensions.is_a?(Array)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: everythingrb
 version: !ruby/object:Gem::Version
-  version: 0.8.2
+  version: 0.9.0
 platform: ruby
 authors:
 - Bryan
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-05-26 00:00:00.000000000 Z
+date: 2025-08-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ostruct