blank_empty_nil_filters 0.1.3 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 35a7e5e27066b542dc53c963f9f3769ea1a9da4667c69e5edad010158fe5717d
-  data.tar.gz: dad47bacd3d2f9adfc63d42ca24dcea0ede3bb87e97ffb18bd25a3d15c39720b
+  metadata.gz: 050ecf453b9f1337450920915eff6d0c33f228e12a41df2ab00d3d7ab14f9904
+  data.tar.gz: 691b76327aa76b7e61a1e521df5b4807a3ec117171480a9b375c142e7d051c7d
 SHA512:
-  metadata.gz: 141dae5987cfd3487d8c98977c1048036793ff8d2e2c49735ea630481aa23b5c6ee273325850f4351be126f11340f7045a1480606c264ecf2d57d0680781ed16
-  data.tar.gz: 102f2f9132840745ee8ac2ca5e40a2bfd9b2e460acb32e090cb876ae63434aa4eba2e668f1cfb2500b34dcb69818435b242d267e09cb0d9572e48558f8824a04
+  metadata.gz: 835e07d0ba6be825c8ea574427fbd0cd995e133bb8473345af404d0495ea44386274d2161b204bf1f6ef842c7312e0adc81692574f227cb58897c3599d30fc9b
+  data.tar.gz: 27e8e1c1c8fa33bc12b9aafac71179b69ef35e7b019e908ebca4b4eb4700b0da8cf1f4689229ca753c3b547f551136afd3ace1f1828287fad5fdd13d4f7e39d7

data/Gemfile.lock

@@ -1,35 +1,29 @@
 PATH
   remote: .
   specs:
-    blank_empty_nil_filters (0.1.3)
+    blank_empty_nil_filters (1.0.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (5.2.3)
-      concurrent-ruby (~> 1.0, >= 1.0.2)
-      i18n (>= 0.7, < 2)
-      minitest (~> 5.1)
-      tzinfo (~> 1.1)
-    ast (2.4.0)
-    builder (3.2.3)
-    byebug (11.0.1)
-    coderay (1.1.2)
-    concurrent-ruby (1.1.5)
-    diff-lcs (1.3)
-    docile (1.3.1)
-    ffi (1.10.0)
-    formatador (0.2.5)
-    fuubar (2.3.2)
+    ast (2.4.2)
+    builder (3.3.0)
+    byebug (11.1.3)
+    coderay (1.1.3)
+    diff-lcs (1.5.1)
+    docile (1.4.0)
+    ffi (1.17.0)
+    formatador (1.1.0)
+    fuubar (2.5.1)
       rspec-core (~> 3.0)
       ruby-progressbar (~> 1.4)
-    guard (2.15.0)
+    guard (2.18.1)
       formatador (>= 0.2.4)
       listen (>= 2.7, < 4.0)
       lumberjack (>= 1.0.12, < 2.0)
       nenv (~> 0.1)
       notiffany (~> 0.0)
-      pry (>= 0.9.12)
+      pry (>= 0.13.0)
       shellany (~> 0.0)
       thor (>= 0.18.1)
     guard-compat (1.2.1)
@@ -40,80 +34,82 @@ GEM
     guard-yard (2.2.1)
       guard (>= 1.1.0)
       yard (>= 0.7.0)
-    i18n (1.6.0)
-      concurrent-ruby (~> 1.0)
-    jaro_winkler (1.5.2)
-    json (2.2.0)
-    listen (3.1.5)
-      rb-fsevent (~> 0.9, >= 0.9.4)
-      rb-inotify (~> 0.9, >= 0.9.7)
-      ruby_dep (~> 1.2)
-    lumberjack (1.0.13)
-    method_source (0.9.2)
-    minitest (5.11.3)
+    json (2.7.2)
+    language_server-protocol (3.17.0.3)
+    listen (3.9.0)
+      rb-fsevent (~> 0.10, >= 0.10.3)
+      rb-inotify (~> 0.9, >= 0.9.10)
+    lumberjack (1.2.10)
+    method_source (1.1.0)
     nenv (0.3.0)
-    notiffany (0.1.1)
+    notiffany (0.1.3)
       nenv (~> 0.1)
       shellany (~> 0.0)
-    parallel (1.17.0)
-    parser (2.6.2.1)
-      ast (~> 2.4.0)
-    pry (0.12.2)
-      coderay (~> 1.1.0)
-      method_source (~> 0.9.0)
-    pry-byebug (3.7.0)
+    parallel (1.25.1)
+    parser (3.3.3.0)
+      ast (~> 2.4.1)
+      racc
+    pry (0.14.2)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    pry-byebug (3.10.1)
       byebug (~> 11.0)
-      pry (~> 0.10)
-    psych (3.1.0)
-    rainbow (3.0.0)
-    rake (12.3.2)
-    rb-fsevent (0.10.3)
-    rb-inotify (0.10.0)
+      pry (>= 0.13, < 0.15)
+    racc (1.8.0)
+    rainbow (3.1.1)
+    rake (13.2.1)
+    rb-fsevent (0.11.2)
+    rb-inotify (0.11.1)
       ffi (~> 1.0)
-    redcarpet (3.4.0)
-    rspec (3.8.0)
-      rspec-core (~> 3.8.0)
-      rspec-expectations (~> 3.8.0)
-      rspec-mocks (~> 3.8.0)
-    rspec-core (3.8.0)
-      rspec-support (~> 3.8.0)
-    rspec-expectations (3.8.2)
+    redcarpet (3.6.0)
+    regexp_parser (2.9.2)
+    rexml (3.3.1)
+      strscan
+    rspec (3.13.0)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.0)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.8.0)
-    rspec-mocks (3.8.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.8.0)
-    rspec-support (3.8.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.1)
     rspec_junit (4.0.4)
       builder (>= 3.2.2)
       rspec (>= 3.3.0)
-    rspec_junit_formatter (0.4.1)
+    rspec_junit_formatter (0.6.0)
       rspec-core (>= 2, < 4, != 2.12.0)
-    rubocop (0.67.2)
-      jaro_winkler (~> 1.5.1)
+    rubocop (1.64.1)
+      json (~> 2.3)
+      language_server-protocol (>= 3.17.0)
       parallel (~> 1.10)
-      parser (>= 2.5, != 2.5.1.1)
-      psych (>= 3.1.0)
+      parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml (>= 3.2.5, < 4.0)
+      rubocop-ast (>= 1.31.1, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 1.6)
-    ruby-progressbar (1.10.0)
-    ruby_dep (1.5.0)
+      unicode-display_width (>= 2.4.0, < 3.0)
+    rubocop-ast (1.31.3)
+      parser (>= 3.3.1.0)
+    ruby-progressbar (1.13.0)
     shellany (0.0.1)
-    simplecov (0.16.1)
+    simplecov (0.22.0)
       docile (~> 1.1)
-      json (>= 1.8, < 3)
-      simplecov-html (~> 0.10.0)
-    simplecov-html (0.10.2)
-    spring (2.0.2)
-      activesupport (>= 4.2)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.12.3)
+    simplecov_json_formatter (0.1.4)
+    spring (4.2.1)
+    strscan (3.1.0)
     terminal-notifier-guard (1.7.0)
-    thor (0.20.3)
-    thread_safe (0.3.6)
-    tzinfo (1.2.5)
-      thread_safe (~> 0.1)
-    unicode-display_width (1.5.0)
-    yard (0.9.19)
+    thor (1.3.1)
+    unicode-display_width (2.5.0)
+    yard (0.9.36)
 
 PLATFORMS
   ruby

data/README.md

@@ -6,10 +6,10 @@ Build status: [![CircleCI](https://circleci.com/gh/aks/blank_empty_nil_filters/t
 
 This module creates new methods to be prepended to the Array, Hash,
 String, and Object classes to implement recursive filters for _blank_,
-_empty_, and nil values.
+_empty_, and _nil_ values.
 
 The methods can select or reject values which are blank _(whitespace)_, 
-empty _(zero length)_, or nil, and do so recursively.
+empty _(zero length)_, or _nil_, and do so recursively.
 
 The default behavior is to filter recursively, without limit.
 However, optional arguments may be applied to any filter method to
@@ -20,7 +20,7 @@ level hashes can be completely removed if they are empty.
 
 Note: `ActiveSupport` provides _some_ of these methods, but in general
 is a *much* larger body of code.  This module are only those methods
-related to "blank", "empty" or nil. Also, `ActiveSupport` uses
+related to "blank", "empty" or `nil`. Also, `ActiveSupport` uses
 `Regexp` `match` to determine blankness, while this code uses a
 non-destructive `strip`, which is both faster and less sensitive to
 non-UTF8 string error conditions.
@@ -87,9 +87,9 @@ aoh.reject_blank_values     # aoh.no_blank_values
 aoh.reject_nil_values       # aoh.no_nil_values
 ```
 
-Any of the above methods can be provided optional arguments of _start_ and _depth_
-to indicate levels at which filter _(selecting or rejecting)_ should start and 
-stop.
+Any of the above methods can be provided optional arguments of _start_ and
+_depth_ to indicate levels at which filter _(selecting or rejecting)_ should
+start and stop.
 
 ```ruby
 aoh.no_empty_values(1)      # no empty items at level 1 or higher; leave level 0 alone
@@ -107,16 +107,27 @@ aoh.reject_values(:condition_method)  # reject items matching :condition_method
 aoh.select_values(:condition_method)  # select items matching :condition_method
 ```
 
-There are two `Object` instance methods of `no_empty_value` and `no_blank_value` that can be used as `String` or
-other class instance filters to return the instance or a nil.  This enables the use of `||` conditions to provide 
+There are two `Object` instance methods of `no_empty_value` and `no_blank_value`
+that can be used as `String` or other class instance filters to return the
+instance or a nil. This enables the use of `||` conditions to provide
 alternative values:
 
+These methods all return the non-empty value, or a nil.
 ```ruby
 obj.no_empty_value || 'default'
+obj.non_empty      || 'default'
+obj.no_empty       || 'default'
+````
+
+These methods all return the non-blank value, or a nil.
+```ruby
 obj.no_blank_value || 'default'
+obj.non_blank      || 'default'
+obj.no_blank       || 'default'
 ```
 
-These two methods are like `ActiveSupport`'s `presence` method but with finer-grain control.
+The `non_empty` are like `ActiveSupport`'s `presence` method but with 
+finer-grain control.
 
 ### Condition Methods
 
@@ -132,8 +143,8 @@ obj.non_blank?     # true if object is not nil and has non-zero size, and is not
 obj.non_nil?       # !object.nil?
 ```
 
-For _hash_ or _array_ objects, `is_empty?` and `is_blank?` work recursively on the object
-elements, and the result is true only if true at every level.
+For _hash_ or _array_ objects, `is_empty?` and `is_blank?` work recursively on
+the object elements, and the result is true only if true at every level.
 
 ### Hash key and value filters
 There are also convenience methods to select the keys from filtered hash items:
@@ -152,8 +163,9 @@ hash.non_blank_value_keys => hash.no_blank_values.keys
 
 ### Hash Filters
 
-The most common usage of `no_empty_values` is with hashes of parameters, which are formed from
-many variables, and then the empty or blank ones can be easily filtered out of the hash:
+The most common usage of `no_empty_values` is with hashes of parameters, which
+are formed from many variables, and then the empty or blank ones can be easily 
+filtered out of the hash:
 
 ```ruby
 { 'Input' => {
@@ -168,6 +180,9 @@ many variables, and then the empty or blank ones can be easily filtered out of t
 }.no_empty_values
 ```
 
+Ruby's `Hash` `compact` instance method can remove key-value pairs with nil 
+values, but does not filter for blank or empty values, or recurse.
+
 With `params` containing:
 
 ```ruby
@@ -197,9 +212,9 @@ params.no_blank_values => { type: :pdf }
 
 #### Finding keys with empty values
 
-Sometimes, it's not the key-value pairs that are non-empty that are desired; instead,
-the programmer often wants the keys with empty, blank, or nil values, _(e.g., so they can 
-be reported on)_.
+Sometimes, it's not the key-value pairs that are non-empty that are desired; 
+instead, the programmer often wants the keys with empty, blank, or nil values, 
+_(e.g., so they can be reported on)_.
 
 ```ruby
 params = { file: '   ', type: :pdf, pattern: nil, dest: ''}
@@ -218,7 +233,9 @@ To filter out empty (zero-length) values from an array:
 [:1 ['' :b] nil :2 ['' '']].no_empty_values => [:1 [:b] :2]
 ```
 
-Note that the filter is recursive, and if a sub-array is entirely empty, it is filtered out also _(because it also has zero length, after its items have been filtered)_.
+Note that the filter is recursive, and if a sub-array is entirely empty, it is
+filtered out also _(because it also has zero length, after its items have been
+filtered)_.
 
 The `nil` is considered an "empty" value.
 
@@ -230,7 +247,9 @@ To filter out _blank_ values from an array:
 
 ### String Filters
 
-The `no_empty_value` and `no_blank_value` methods on the `Object` class can be applied to any object that supports the `is_blank?` and `is_empty?` condition methods, including the `String` class.
+The `no_empty_value` and `no_blank_value` methods on the `Object` class can be
+applied to any object that supports the `is_blank?` and `is_empty?` condition
+methods, including the `String` class.
 
 ```ruby
 ' no fun '.no_empty_value || 'other' ==> ' no fun '
@@ -245,10 +264,12 @@ The `no_empty_value` and `no_blank_value` methods on the `Object` class can be a
 
 ## Testing
 
-There is an `rspec`-style test in the `spec` directory, the perusal of which will also provide some examples of usage.
+There is an `rspec`-style test in the `spec` directory, the perusal of which
+will also provide some examples of usage.
 
-The rspec-style tests are normally run under the `fuubar` formatter gem which shows an incremental summary on a single line.  The
-tests can be run with `rake` or with `rspec`:
+The rspec-style tests are normally run under the `fuubar` formatter gem which
+shows an incremental summary on a single line. The tests can be run with `rake`
+or with `rspec`:
 
     bundle exec rake spec
 
@@ -256,7 +277,8 @@ or
 
     bundle exec rspec
 
-However, if you wish to see all of the usual "documentation" style output, use the `-f doc` option on the `rspec` invocation:
+However, if you wish to see all of the usual "documentation" style output, use
+the `-f doc` option on the `rspec` invocation:
 
     bundle exec rspec -f doc
 
@@ -264,7 +286,11 @@ However, if you wish to see all of the usual "documentation" style output, use t
 
 After checking out the repo, run `rake spec` to run the tests.
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+To install this gem onto your local machine, run `bundle exec rake install`. To
+release a new version, update the version number in `version.rb`, and then
+run `bundle exec rake release`, which will create a git tag for the version,
+push git commits and tags, and push the `.gem` file
+to [rubygems.org](https://rubygems.org).
 
 
 ## Contributing

data/lib/blank_empty_nil_filters/version.rb

@@ -1,5 +1,11 @@
 # frozen_string_literal: true
 
 module BlankEmptyNilFilters
-  VERSION = '0.1.3'
+  RELEASES = [
+    ['1.0.0', '2025-01-21'],
+    ['0.2.0', '2020-08-28'],
+    ['0.1.1', '2019-05-23']
+  ].freeze
+
+  VERSION = RELEASES[0][0]
 end

data/lib/blank_empty_nil_filters.rb

@@ -37,6 +37,7 @@ module BlankEmptyNilFilters
     end
     alias reject_blank_values no_blank_values
 
+    # more capable than just ARRAY.compact
     def no_nil_values(start = 0, depth = nil, level = 0)
       reject_values(:nil?, start, depth, level)
     end
@@ -119,6 +120,7 @@ module BlankEmptyNilFilters
     end
     alias select_blank_values only_blank_values
 
+    # more capable than just HASH.compact
     def no_nil_values(start = 0, depth = nil, level = 0)
       reject_values(:nil?, start, depth, level)
     end
@@ -205,13 +207,15 @@ module BlankEmptyNilFilters
   end
 
   module ObjectExtensions
-    def no_blank_value
+    def non_blank
       is_blank? ? nil : self
     end
+    alias no_blank_value non_blank
 
-    def no_empty_value
+    def non_empty
       is_empty? ? nil : self
     end
+    alias no_empty_value non_empty
 
     def is_empty?
       if nil?

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: blank_empty_nil_filters
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 1.0.0
 platform: ruby
 authors:
 - Alan Stebbens
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-08-28 00:00:00.000000000 Z
+date: 2025-01-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -259,7 +259,7 @@ homepage: https://github.com/aks/blank_empty_nil_filters
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -274,8 +274,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
-signing_key: 
+rubygems_version: 3.4.19
+signing_key:
 specification_version: 4
 summary: '["Extensions for filtering empty, blank, and nil values from Hashes and
   Arrays", "Extentions for convenient filtering of blank, empty, and nil values from\nHash