figjam 2.2.0 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eb55c0209ee029e45d1868e1eb32d159ac3b50b6bdbc8ba469a818c1058c4f00
-  data.tar.gz: 3c7febb9ba1368b82458221f2914348a344474cf50c5ef1bbbfd4247d853d18d
+  metadata.gz: f35d4e26ae4c3164769faf39273f258a55dcfee745eedf07923c6af345bee8fc
+  data.tar.gz: f8201735431e49c46eebd988e048684cd0d2f98f15c841c8e12696176fd88248
 SHA512:
-  metadata.gz: 1ba7fd124b00dcaa9f789a43556ab4725d1f7a8f0ed4b4112eafe6dfad72fefb583f4779df2a5a7fed1b8062764a149890ae952d16c7dcb03680a4531d13a390
-  data.tar.gz: b18b0f948baf4005b858cf38c162d66fd9620c62992f52a738c682be1b3abc7548529e03de36114123ebf89d060ccd3cba11877e11c8655bf33c461d342de79e
+  metadata.gz: adea20bf2faf8f66087f76b9e746bb0537e56221a2e4361136cae4b1fbf53841e3817d31ccfad89597e4dbfb5065bd72d96598c92570d29aee07a4c17145e237
+  data.tar.gz: 9a0b6469cc6278164d2bc07875c178fcc50629b0cb7af37326cebe12230707dabb0163e2173f3ebc522d2829c75185b6437af777a33c1346491e6a807f4126cc

data/README.md

@@ -62,15 +62,13 @@ they can be loaded independently or in addition of the main application. To do t
 you can create a `config/application.yml` file in your engine, and add this to the `Rails::Engine`:
 
 ```ruby
-module MyEngine
-  class Engine < ::Rails::Engine
-    Figjam::Rails::Engine.configure(self)
-  end
-end
+require "figjam/rails/engine"
 
-# Or if you wish to pass in a specific value for the environment:
 module MyEngine
   class Engine < ::Rails::Engine
+    Figjam::Rails::Engine.configure(self)
+    
+    # Or if you wish to pass in a specific value for the environment:
     Figjam::Rails::Engine.configure(self, "my_engine_environment")
   end
 end
@@ -86,6 +84,8 @@ do this as many times as you like. If you have multiple internal gems, they can
 all use `figjam` to load their own configuration independently.
 
 ```ruby
+require "figjam/application"
+
 Figjam::Application.new(
   environment: "some_environment_key",
   path: "#{__dir__}/application.yml"
@@ -131,7 +131,7 @@ Note, secrets are not to be provided by figjam, so do not add them to your `appl
 
 Deeply nested configuration structures are not possible.
 
-## Silencing type conversion warnings
+## Debugging Figjam
 
 Remember that `ENV` in ruby is a simple key/value store. All values will always be strings.
 This means that the following code will produce string values:
@@ -142,21 +142,18 @@ SOME_BOOLEAN: true
 ```
 
 ```ruby
-# WARNING: Use strings for Figjam configuration. 3 was converted to "3"
-# WARNING: Use strings for Figjam configuration. true was converted to "true"
-
 ENV["SOME_NUMBER"] == 3 # => false
 ENV["SOME_NUMBER"] == "3" # => true
 ENV["SOME_BOOLEAN"] == true # => false
 ENV["SOME_BOOLEAN"] == "true" # => true
 ```
 
-Because this is a possible cause of sleeper bugs, Figjam emits a warning when it does this
-conversion to a string. If you are confident in your abilities, you can silence it by adding this
-to the top of your `application.yml`:
+If you are unsure about how figjam is loading your configuration, you can enable warnings
+about type conversion and pre-existing ENV by setting the `FIGJAM_DEBUG` environment variable
+to `true`.
 
 ```yaml
-FIGJAM_SILENCE_STRING_WARNINGS: true
+FIGJAM_DEBUG: true
 ```
 
 ### Using `Figjam.env`

data/lib/figjam/application.rb

@@ -8,11 +8,6 @@ module Figjam
   # :reek:TooManyMethods
   class Application
     FIGARO_ENV_PREFIX = "_FIGARO_".freeze
-    SILENCE_STRING_WARNINGS_KEYS = %i[
-      FIGARO_SILENCE_STRING_WARNINGS
-      FIGJAM_SILENCE_STRING_WARNINGS
-    ].freeze
-
     include Enumerable
 
     def initialize(options = {})
@@ -93,10 +88,8 @@ module Figjam
     end
 
     private def set(key, value)
-      unless non_string_warnings_silenced?
-        non_string_configuration(key) unless key.is_a?(String)
-        non_string_configuration(value) unless value.is_a?(String) || value.nil?
-      end
+      non_string_configuration(key) unless key.is_a?(String)
+      non_string_configuration(value) unless value.is_a?(String) || value.nil?
 
       ::ENV[key.to_s] = value&.to_s
       ::ENV[FIGARO_ENV_PREFIX + key.to_s] = value&.to_s
@@ -106,19 +99,16 @@ module Figjam
       ::ENV.key?(key.to_s) && !::ENV.key?(FIGARO_ENV_PREFIX + key.to_s)
     end
 
-    private def non_string_warnings_silenced?
-      SILENCE_STRING_WARNINGS_KEYS.any? { |key|
-        # Allow the silence configuration itself to use non-string keys/values.
-        configuration.values_at(key.to_s, key).any? { |cv| cv.to_s == "true" }
-      }
-    end
-
     private def non_string_configuration(value)
-      warn "WARNING: Use strings for Figjam configuration. #{value.inspect} was converted to #{value.to_s.inspect}." # rubocop:disable Layout/LineLength
+      return unless ::ENV["FIGJAM_DEBUG"] == "true"
+
+      warn "FIGJAM: Use strings for Figjam configuration. #{value.inspect} was converted to #{value.to_s.inspect}." # rubocop:disable Layout/LineLength
     end
 
     private def key_skipped(key)
-      puts "INFO: Skipping key #{key.inspect}. Already set in ENV."
+      return unless ::ENV["FIGJAM_DEBUG"] == "true"
+
+      puts "FIGJAM: Skipping key #{key.inspect}. Already set in ENV."
     end
 
     private def valid_key_name?(key)

data/lib/figjam/rails/engine.rb

@@ -1,3 +1,5 @@
+require_relative "../application"
+
 module Figjam
   module Rails
     module Engine

data/lib/figjam/version.rb

@@ -1,3 +1,3 @@
 module Figjam
-  VERSION = "2.2.0".freeze
+  VERSION = "3.0.0".freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: figjam
 version: !ruby/object:Gem::Version
-  version: 2.2.0
+  version: 3.0.0
 platform: ruby
 authors:
 - Harry Lascelles
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-07-16 00:00:00.000000000 Z
+date: 2025-09-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -86,6 +86,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: climate_control
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: combustion
   requirement: !ruby/object:Gem::Requirement