refinements 13.2.0 → 13.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9fcffd7f711955f3562fb913b93cc020d4107dd63d5346ffee76ff11bac0e1a7
-  data.tar.gz: 4b55c942fe38a0052aed210375a98786e86147e7889c58e8921cf88763f26bd7
+  metadata.gz: 3b9653414033e7e566848bb9457c1642c047eed1f21d1dd2518f24cf4d3f366d
+  data.tar.gz: 858ad0585193b6e65db26c71e8e7bd203838441820e44127f0787e4a75406c72
 SHA512:
-  metadata.gz: b48fff7c3b82ad993dc260a8070e45e2859d461b9df33ec5d30f8b0749bb5e15e0710f57685490a1e5d2bf723aae4a074d823e02e5a007d36645d243a85749e1
-  data.tar.gz: cbe1a06501060662dc5c950f5da9c10cd8abfbf83f7379bbf59a2ec7dfad34fd199e0540eb83693439a38b138b1cc3bf11c0eba055996bb60606570265e107c0
+  metadata.gz: c5a07a0139c13fbd31c08a72d1905703db130f0bb0fb30c27ee938266146d0273c29b5cec6543520a11c5f244ad525a8dc9448c65ecac8ec1d650426430f7c4f
+  data.tar.gz: 2c97c94497dd0827239452ad1c936290ee2fb77587426b5d23c47557d7c1ae1dc69e7a36d3c63548d99669f920d35d3b0a4233ef4b9cc5754cd66dd56b76eecd

data/README.adoc

@@ -1292,6 +1292,22 @@ Answers string with only first letter down cased.
 "EXAMPLE".down  # "eXAMPLE"
 ----
 
+===== #falsey?
+
+Answers if string is falsey.
+
+[source,ruby]
+----
+"false".falsey?    # true
+"0".falsey?        # true
+"no".falsey?       # true
+"".falsey?         # true
+"example".falsey?  # true
+"true".falsey?     # false
+"yes".falsey?      # false
+"1".falsey?        # false
+----
+
 ===== #first
 
 Answers first character of a string or first set of characters if given a number.
@@ -1394,6 +1410,19 @@ Answers a title string with proper capitalization of each word.
 "ThisIsAnExample".titleize  # "This Is An Example"
 ----
 
+===== #truthy?
+
+Answers if string is truthy.
+
+[source,ruby]
+----
+"true".truthy?     # true
+"yes".truthy?      # true
+"1".truthy?        # true
+"".truthy?         # false
+"example".truthy?  # false
+----
+
 ===== #truncate
 
 Answers a truncated, non-mutated, string for given length with optional delimiter and/or overflow.
@@ -1420,6 +1449,8 @@ demo.truncate 16, trailer: "... (more)"  # "It was... (more)"
 
 ===== #to_bool
 
+⚠️ This method is deprecated and will be removed in Version 14.0.0. Please use `#truthy?` or `#falsey?` instead.
+
 Answers string as a boolean.
 
 [source,ruby]

data/lib/refinements/string.rb

@@ -18,6 +18,8 @@ module Refinements
 
       def down = empty? ? self : first.downcase + self[1, size]
 
+      def falsey? = !truthy?
+
       def first maximum = 0
         return self if empty?
         return self[0] if maximum.zero?
@@ -60,6 +62,8 @@ module Refinements
                                               .then { |parts| combine parts, :up, "/" }
       end
 
+      def truthy? = %w[true yes on t y 1].include? downcase.strip
+
       def truncate to, delimiter = nil, trailer: "..."
         return dup if length <= to
 
@@ -68,7 +72,13 @@ module Refinements
         "#{self[...maximum]}#{trailer}"
       end
 
-      def to_bool = %w[true yes on t y 1].include? downcase.strip
+      # rubocop:disable Naming/PredicateMethod
+      def to_bool
+        warn "`#{self.class}##{__method__}` is deprecated, use `#truthy?` or `#falsey?` instead.",
+             category: :deprecated
+        truthy?
+      end
+      # rubocop:enable Naming/PredicateMethod
 
       def up = empty? ? self : first.upcase + self[1, size]
 

data/refinements.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name = "refinements"
-  spec.version = "13.2.0"
+  spec.version = "13.3.0"
   spec.authors = ["Brooke Kuhlmann"]
   spec.email = ["brooke@alchemists.io"]
   spec.homepage = "https://alchemists.io/projects/refinements"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: refinements
 version: !ruby/object:Gem::Version
-  version: 13.2.0
+  version: 13.3.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -88,7 +88,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.8
+rubygems_version: 3.6.9
 specification_version: 4
 summary: A collection of core object refinements.
 test_files: []