blank_empty_nil_filters 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 64e75e1a9ee5dcae8ca6f3e8b538765f8350634b
-  data.tar.gz: 152de1254ee4cb1e9a5874e8d8f7203afa325539
+  metadata.gz: 31f1a60dad0e7ba230e21358acf7a044d79852ac
+  data.tar.gz: 7ace2d848b525742ba194b7300e21ef1716a6366
 SHA512:
-  metadata.gz: e3168af58aac78538ff99afad4d81e56ce78bcf6c23e2c3999d18a78971870512bb057cd2560972c6ddf4d0c6e3d1fc8e9577ff9cce21e4f6f110b883607673b
-  data.tar.gz: eccbcf9941d4a2f043503043e941094b08b3b960a28cf2c2073ac495b337a7fe65ff020a600a7281ce28a6624a36a0ab9f8dd0a2d8f67f210b44fd2d010c2fd8
+  metadata.gz: 99a10a6017b9dbbeafcff7acdd8ef9d15fca64dbc638dabbf479113017533fb3ca219351b47f2f38332deec2d16de6eea2f9b9ed822e5a86d8277925ad3c65fc
+  data.tar.gz: bf611e7b505e56e571e4bc78cd2ff61c48b49a23fe993db5773c5f46e5cb41bd16b9006f016f0d07daa6e6e6604afbb7057d02b6816935e0b00b2c799f71c0c1

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    blank_empty_nil_filters (0.1.0)
+    blank_empty_nil_filters (0.1.1)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -82,6 +82,18 @@ 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 
+alternative values:
+
+```ruby
+obj.no_empty_value || 'default'
+obj.no_blank_value || 'default'
+```
+
+These two methods are like `ActiveSupport`'s `presence` method but with finer-grain control.
+
+### Condition Methods
 
 The methods below are used with the general purpose methods to form the special-case filters.
 
@@ -98,6 +110,7 @@ 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.
 
+### Hash key and value filters
 There are also convenience methods to select the keys from filtered hash items:
 
 ```ruby
@@ -190,10 +203,24 @@ To filter out _blank_ values from an array:
 [:1 " " "    " nil ['' '    '] :2].no_blank_values => [:1 :2]
 ```
 
+### 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.
+
+```ruby
+' no fun '.no_empty_value || 'other' ==> ' no fun '
+''.        no_empty_value || 'other' ==> 'other'
+'  '.      no_empty_value || 'other' ==> '  '
+' answer '.no_blank_value || 'no'    ==> ' answer '
+'  '.      no_blank_value || 'no'    ==> 'no'
+'\n'.      no_blank_value || 'no'    ==> 'no'
+```
+
+
+
 ## 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`:

data/lib/blank_empty_nil_filters.rb

@@ -151,6 +151,14 @@ module BlankEmptyNilFilters
   end
 
   module ObjectExtensions
+    def no_blank_value
+      is_blank? ? nil : self
+    end
+
+    def no_empty_value
+      is_empty? ? nil : self
+    end
+
     def is_empty?
       if nil?
         true

data/lib/blank_empty_nil_filters/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BlankEmptyNilFilters
-  VERSION = '0.1.0'
+  VERSION = '0.1.1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: blank_empty_nil_filters
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Alan Stebbens
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-04-12 00:00:00.000000000 Z
+date: 2019-05-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler