everythingrb 0.2.4 → 0.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a31c21db03be7c59f60dacc8136cea0d28e0298f4b53cb7a89c0934d1d7617f0
-  data.tar.gz: 3ba88a496f226383284c234892c49fc976e7bc695489e1bef0ff3512bb7b2c16
+  metadata.gz: 330f80c66964fd22cd85850c251963ea372957a2b3190f4abcb5d0f3346989f7
+  data.tar.gz: f28ebe4ab45e0bb7f1e68f2553af302d6ab2dfaa0509bc3d73615a84330b6d1e
 SHA512:
-  metadata.gz: fa926d8fb5e356bb3ea0c6bf87ad2bbe847897a042075166a78d0dea39e27015cf35d49570a7db79fe489be2bb0dd324c5383412f5b1d60d06e1e60722c5e969
-  data.tar.gz: 04cea9d92d4f851c2eb3d0a928319c583cc55c2c5376177371c5da0d70ab41d5dbd9c8a7dc70e2c113f20e41ae216c46bcd74d5e6b56a51913d5aa1842177ee6
+  metadata.gz: ae50b585bb625724ca3e7ae917074fef6ceb25278818c88965aa10ccfae42e067b2716fc36b2f4da0d2cd4b4228b764166c12a43c212c7b44b3874ebe00aa071
+  data.tar.gz: 5558f7dfe032d20489d7accf298eb889ffb22cd4a215509e4d2fd90fa35c23eebefa95ca2170695d4b82a637eb2583daa5a3b11b1660b9a9ccb1fa3b9dc5dcf9

data/CHANGELOG.md

@@ -23,6 +23,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Removed
 
+## [0.2.5] - 12025-03-29
+
+### Added
+
+- New array trimming methods that preserve internal structure:
+  - `compact_prefix` - Removes nil values from the beginning of an array
+  - `compact_suffix` - Removes nil values from the end of an array
+  - `trim_nils` - Removes nil values from both ends of an array
+  - ActiveSupport integration with blank-aware versions:
+    - `compact_blank_prefix` - Removes blank values from the beginning
+    - `compact_blank_suffix` - Removes blank values from the end
+    - `trim_blanks` - Removes blank values from both ends
+
 ## [0.2.4] - 12025-03-20
 
 ### Changed
@@ -111,8 +124,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Added alias `each` to `each_pair` in OpenStruct for better enumerable compatibility
 
-[unreleased]: https://github.com/itsthedevman/everythingrb/compare/v0.2.4...HEAD
-[0.2.3]: https://github.com/itsthedevman/everythingrb/compare/v0.2.3...v0.2.4
+[unreleased]: https://github.com/itsthedevman/everythingrb/compare/v0.2.5...HEAD
+[0.2.5]: https://github.com/itsthedevman/everythingrb/compare/v0.2.4...v0.2.5
+[0.2.4]: https://github.com/itsthedevman/everythingrb/compare/v0.2.3...v0.2.4
 [0.2.3]: https://github.com/itsthedevman/everythingrb/compare/v0.2.2...v0.2.3
 [0.2.2]: https://github.com/itsthedevman/everythingrb/compare/v0.2.1...v0.2.2
 [0.2.1]: https://github.com/itsthedevman/everythingrb/compare/v0.2.0...v0.2.1

data/README.md

@@ -22,6 +22,7 @@ I'm currently looking for opportunities where I can tackle meaningful problems a
   - [Collection Processing](#collection-processing)
   - [JSON & String Handling](#json--string-handling)
   - [Object Freezing](#object-freezing)
+  - [Array Trimming](#array-trimming)
   - [Predicate Methods](#predicate-methods)
 - [Core Extensions](#core-extensions)
   - [Array](#array)
@@ -138,6 +139,22 @@ config[:api][:endpoints].frozen?  # => true
 config[:api][:endpoints][0].frozen?  # => true
 ```
 
+### Array Trimming
+
+Clean up array boundaries without losing internal structure:
+
+```ruby
+# Remove nil values from the beginning or end
+[nil, nil, 1, nil, 2, nil, nil].trim_nils  # => [1, nil, 2]
+
+# With ActiveSupport, remove any blank values (nil, "", etc.)
+[nil, "", 1, "", 2, nil, ""].trim_blanks  # => [1, "", 2]
+
+# Only trim from one end if needed
+[nil, nil, 1, 2, 3].compact_prefix  # => [1, 2, 3]
+[1, 2, 3, nil, nil].compact_suffix  # => [1, 2, 3]
+```
+
 ### Predicate Methods
 
 Create boolean accessors with minimal code:
@@ -228,6 +245,34 @@ data.dig_map(:user, :profile, :name)
 # => ["Alice", "Bob"]
 ```
 
+#### `compact_prefix` / `compact_suffix` / `trim_nils`
+Remove nil values from the beginning, end, or both ends of an array without touching interior nil values.
+
+```ruby
+[nil, nil, 1, nil, 2, nil, nil].compact_prefix
+# => [1, nil, 2, nil, nil]
+
+[1, nil, 2, nil, nil].compact_suffix
+# => [1, nil, 2]
+
+[nil, nil, 1, nil, 2, nil, nil].trim_nils
+# => [1, nil, 2]
+```
+
+#### `compact_blank_prefix` / `compact_blank_suffix` / `trim_blanks` (with ActiveSupport)
+Remove blank values (nil, empty strings, etc.) from the beginning, end, or both ends of an array.
+
+```ruby
+[nil, "", 1, "", 2, nil, ""].compact_blank_prefix
+# => [1, "", 2, nil, ""]
+
+[nil, "", 1, "", 2, nil, ""].compact_blank_suffix
+# => [nil, "", 1, "", 2]
+
+[nil, "", 1, "", 2, nil, ""].trim_blanks
+# => [1, "", 2]
+```
+
 #### `deep_freeze`
 Recursively freezes an array and all of its nested elements.
 

data/lib/everythingrb/core/array.rb

@@ -97,4 +97,85 @@ class Array
     each { |v| v.respond_to?(:deep_freeze) ? v.deep_freeze : v.freeze }
     freeze
   end
+
+  #
+  # Removes nil values from the beginning of an array
+  #
+  # @return [Array] Array with leading nil values removed
+  #
+  # @example
+  #   [nil, nil, 1, 2, nil, 3].compact_prefix
+  #   # => [1, 2, nil, 3]
+  #
+  def compact_prefix
+    drop_while(&:nil?)
+  end
+
+  #
+  # Removes nil values from the end of an array
+  #
+  # @return [Array] Array with trailing nil values removed
+  #
+  # @example
+  #   [1, 2, nil, 3, nil, nil].compact_suffix
+  #   # => [1, 2, nil, 3]
+  #
+  def compact_suffix
+    reverse.drop_while(&:nil?).reverse
+  end
+
+  #
+  # Removes nil values from both the beginning and end of an array
+  #
+  # @return [Array] Array with leading and trailing nil values removed
+  #
+  # @example
+  #   [nil, nil, 1, 2, nil, 3, nil, nil].trim_nils
+  #   # => [1, 2, nil, 3]
+  #
+  def trim_nils
+    compact_prefix.compact_suffix
+  end
+
+  # ActiveSupport integrations
+  if defined?(ActiveSupport)
+    #
+    # Removes blank values from the beginning of an array
+    #
+    # @return [Array] Array with leading blank values removed
+    #
+    # @example With ActiveSupport loaded
+    #   [nil, "", 1, 2, "", 3].compact_blank_prefix
+    #   # => [1, 2, "", 3]
+    #
+    def compact_blank_prefix
+      drop_while(&:blank?)
+    end
+
+    #
+    # Removes blank values from the end of an array
+    #
+    # @return [Array] Array with trailing blank values removed
+    #
+    # @example With ActiveSupport loaded
+    #   [1, 2, "", 3, nil, ""].compact_blank_suffix
+    #   # => [1, 2, "", 3]
+    #
+    def compact_blank_suffix
+      reverse.drop_while(&:blank?).reverse
+    end
+
+    #
+    # Removes blank values from both the beginning and end of an array
+    #
+    # @return [Array] Array with leading and trailing blank values removed
+    #
+    # @example With ActiveSupport loaded
+    #   [nil, "", 1, 2, "", 3, nil, ""].trim_blanks
+    #   # => [1, 2, "", 3]
+    #
+    def trim_blanks
+      compact_blank_prefix.compact_blank_suffix
+    end
+  end
 end

data/lib/everythingrb/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: everythingrb
 version: !ruby/object:Gem::Version
-  version: 0.2.4
+  version: 0.2.5
 platform: ruby
 authors:
 - Bryan
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-03-21 00:00:00.000000000 Z
+date: 2025-03-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ostruct