ultra_settings 2.2.0 → 2.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a34c970ed06134a778e29f09ef7640a255a82f45bbf74e703963a7d9b911b598
-  data.tar.gz: 8065a6941af25b2d18b0e6617af074443c4de7da24541fad0d062f562a640c4d
+  metadata.gz: 2a9fddef64ed0564d8ead06ae79465a37fdb50a55407139cacc121714475ac6f
+  data.tar.gz: a26020c7d81154d3e000bba327e3a6cb53ab00ae9847ed2f96999ff18d431241
 SHA512:
-  metadata.gz: d740cea45e6d52bf0392f9c867661b24b55f01ed0b3bb557f9730876af973d08036a47197539cee655a584a11b07b3ecb7ffcbd51cf4a6032605c9ab59b9277b
-  data.tar.gz: f11544c978f8b17790d9fe50b5fb03338a680da9dd4e045cc6e45cad2ab5e6910b51c737fd2735052eb835232023707dbd93bb6460627376765c01779c1f099f
+  metadata.gz: 066b922fcc7232a33eee6e6b52924d1efc51d3a4e500f4680f8e03a1feb7a6414a22b55f9b5672e35db7aeb958566fc1685ba39fed8a9f568840af2b60a7b3e2
+  data.tar.gz: b95942f92c5010decb55da413fdd2c9f070ebafef2815ab5bd4f781f803b744c502b98598fc14b4e5338ec7026fd7a1c5b11011136afe4507a0eeb436dac632b

data/CHANGELOG.md

@@ -4,6 +4,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 2.3.0
+
+### Added
+
+- Added logic for parsing arrays from environment variables. Array fields can now be set as comma delimited strings in an environment variable.
+
+### Fixed
+
+- Mixed case boolean values are now handled properly so that "False" is interpreted as `false` and "True" is interpreted as `true`.
+
 ## 2.2.0
 
 ### Added

data/README.md

@@ -100,13 +100,13 @@ You can customize the behavior of each field using various options:
 
 - `:type` -  Specifies the type of the field. The value of the setting will be cast to this type. If the value in the data source cannot be cast to the data type, then it will not be used. Supported types are:
 
-  - `:string` (the default)
+  - `:string` - This is the default type.
   - `:integer`
   - `:float`
-  - `:boolean` (will accept case insensitive strings "true", "false", "1", "0", "t", "f", "yes", "no", "y", "n")
-  - `:datetime`
+  - `:boolean` - Will accept case insensitive strings "true", "false", "1", "0", "t", "f", "yes", "no", "y", "n".
+  - `:datetime` - Values should be specified in ISO 8601 format.
   - `:symbol`
-  - `:array` (of strings)
+  - `:array` - The array type will return an array of strings. If the raw value is a string (i.e. from an environment variable), it will be iterpreted as a comma separated list of values. You can use double quotes to group values that contain commas and backslashes to escape values. Leading and trailing whitespace will be stripped from each value.
 
 - `:description` - Provides a description of the field. This is used for documentation purposes.
 

data/VERSION

@@ -1 +1 @@
-2.2.0
+2.3.0

data/lib/ultra_settings/coerce.rb

@@ -10,11 +10,8 @@ module UltraSettings
       false, 0,
       "0", :"0",
       "f", :f,
-      "F", :F,
       "false", :false,
-      "FALSE", :FALSE,
-      "off", :off,
-      "OFF", :OFF
+      "off", :off
     ]).freeze
     # rubocop:enable Lint/BooleanSymbol
 
@@ -39,7 +36,7 @@ module UltraSettings
         when :datetime
           time(value)
         when :array
-          Array(value).map(&:to_s)
+          array(value).map(&:to_s)
         when :symbol
           value.to_s.to_sym
         when :rollout
@@ -53,14 +50,26 @@ module UltraSettings
         end
       end
 
+      # Cast value of array
+      #
+      # @param value [Object]
+      # @return [Array]
+      def array(value)
+        return [] if blank?(value)
+        return value.collect(&:to_s) if value.is_a?(Array)
+
+        parse_csv_line(value.to_s)
+      end
+
       # Cast variations of booleans (i.e. "true", "false", 1, 0, etc.) to actual boolean objects.
       #
       # @param value [Object]
       # @return [Boolean]
       def boolean(value)
         return nil if blank?(value)
+        return false if value == false
 
-        !FALSE_VALUES.include?(value)
+        !FALSE_VALUES.include?(value.to_s.downcase)
       end
 
       # Cast a value to a Time object.
@@ -104,6 +113,43 @@ module UltraSettings
       def present?(value)
         !blank?(value)
       end
+
+      private
+
+      # Parse a line of CSV data to an array of strings. Elements are separated by commas and
+      # characters can be escaped with a backslash.
+      def parse_csv_line(line)
+        values = []
+        current_value = +""
+        in_quotes = false
+
+        i = 0
+        while i < line.length
+          char = line[i]
+
+          if char == "\\"
+            if i + 1 < line.length
+              current_value << line[i + 1]
+              i += 1
+            else
+              current_value << "\\"
+            end
+          elsif char == '"'
+            in_quotes = !in_quotes
+          elsif char == "," && !in_quotes
+            values << current_value.strip
+            current_value = +""
+          else
+            current_value << char
+          end
+
+          i += 1
+        end
+
+        values << current_value.strip unless current_value.empty?
+
+        values
+      end
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ultra_settings
 version: !ruby/object:Gem::Version
-  version: 2.2.0
+  version: 2.3.0
 platform: ruby
 authors:
 - Brian Durand
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-10-28 00:00:00.000000000 Z
+date: 2024-11-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler