web47core 3.2.3.26 → 3.2.3.27

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 751e34226f9e73c0116cf5e6efaf5cb3347888652e4c9cc12ab11c2dfca77e1d
-  data.tar.gz: bddd2a674da0b40d964955f5dabdd42e7fb315491e9fda8aa9a2db366e4dfdb9
+  metadata.gz: 81b8ef76b5902c84baaf31f91abbc7580e89d6b7e858891996debdc5be285be9
+  data.tar.gz: cd2526dd341085fba1c0afe692ac48ae68d080003e144cd0965f95c17923cb9f
 SHA512:
-  metadata.gz: 8ee80510dc73c71e4476976f0a90784fade08f6d4b003e7fab97fb9c55a65f7a887de7f17d0570ec0af010a0598f714f082dcd493b899bf5b453e7018ec2d5c0
-  data.tar.gz: 5b814027d75d250b7a1b2b1ee5b1ce0cd9147ce1810b9a85bb0e39d873d8decd79aecb4b56cf38af6dff33bd330ceefa2607416d195828e760b0c422af568dbc
+  metadata.gz: 84e30c300ea6a6d2f47314ac71ea5099ce859ba078d24a8c9808cd8cd18a36e249eaf4db5238cf60205cf6385e0c4cab034507d6dba25cccca8e3086b96fda45
+  data.tar.gz: a85b4f138e901296b023d4977bc6f4d89d114c282e4c0ded09ef6e4e4b298d16a6b404e8d0f75c48daf5c133f8c82eb483accc9bfe28356ca024a1806cffe6ad

data/lib/web47core/boolean_flux_capacitor.rb

@@ -0,0 +1,81 @@
+#
+# Convert the thingy listed below to a true/false value
+#
+# BooleanFluxCapacitor
+#
+# Provides a common `to_bool` method for core Ruby types, similar in spirit
+# to `to_s` or `to_i`.
+#
+# The goal is to produce TOTAL boolean coercion:
+#   - Always returns `true` or `false`
+#   - Never raises
+#   - Never returns `nil`
+#
+# Conversion rules are explicit and deterministic.
+#
+module BooleanFluxCapacitor
+  # Truthy string values (case-insensitive, whitespace ignored)
+  TRUTHY = /\A(true|on|yes|y|1)\z/i
+
+  # Convert the receiver into a Boolean value.
+  #
+  # This method is intended for configuration, environment variables,
+  # and user-supplied input where values may arrive as different types.
+  #
+  # Conversion rules:
+  #
+  # * `true`  → `true`
+  # * `false` → `false`
+  # * `nil`   → `false`
+  #
+  # * Numeric values:
+  #   * `0`        → `false`
+  #   * non-zero   → `true`
+  #
+  # * String values:
+  #   * Case-insensitive match of:
+  #       "true", "on", "yes", "y", "1" → `true`
+  #   * All other strings → `false`
+  #
+  # * All other object types:
+  #   * Converted using `to_s` and evaluated using the same string rules
+  #
+  # Notes:
+  # * This method does NOT affect Ruby's native truthiness.
+  # * It exists solely for explicit boolean coercion.
+  #
+  # Examples:
+  #
+  #   true.to_bool            # => true
+  #   false.to_bool           # => false
+  #   nil.to_bool             # => false
+  #
+  #   0.to_bool               # => false
+  #   42.to_bool              # => true
+  #
+  #   "true".to_bool          # => true
+  #   " YES ".to_bool         # => true
+  #   "false".to_bool         # => false
+  #   "anything else".to_bool # => false
+  #
+  def to_bool
+    case self
+    when true
+      true
+    when false, nil
+      false
+    when Numeric
+      !zero?
+    else
+      to_s.strip.match?(TRUTHY)
+    end
+  end
+end
+
+# Extend core classes with `to_bool`
+NilClass.include(BooleanFluxCapacitor)
+TrueClass.include(BooleanFluxCapacitor)
+FalseClass.include(BooleanFluxCapacitor)
+Numeric.include(BooleanFluxCapacitor)
+String.include(BooleanFluxCapacitor)
+

data/lib/web47core/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Web47core
-  VERSION = '3.2.3.26'
+  VERSION = '3.2.3.27'
 end

data/lib/web47core.rb

@@ -1,4 +1,5 @@
 require 'web47core/config'
+require 'web47core/boolean_flux_capacitor'
 require 'app/models/concerns/app47_logger'
 require 'app/models/concerns/api_tokenable'
 require 'app/models/concerns/archive_able'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: web47core
 version: !ruby/object:Gem::Version
-  version: 3.2.3.26
+  version: 3.2.3.27
 platform: ruby
 authors:
 - Chris Schroeder
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-12-18 00:00:00.000000000 Z
+date: 2025-12-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel
@@ -6628,6 +6628,7 @@ files:
 - lib/templates/slack/failed_delayed_job.liquid
 - lib/update_icons.rb
 - lib/web47core.rb
+- lib/web47core/boolean_flux_capacitor.rb
 - lib/web47core/config.rb
 - lib/web47core/engine.rb
 - lib/web47core/version.rb