blueprint_config 1.4.0 → 1.5.0

data/spec/configuration_memory_methods_spec.rb

@@ -0,0 +1,145 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+require 'blueprint_config'
+
+describe BlueprintConfig::Configuration do
+  let(:config) { BlueprintConfig::Configuration.instance }
+  
+  before do
+    # Mock Rails test environment
+    unless defined?(Rails)
+      module Rails
+        def self.env
+          ActiveSupport::StringInquirer.new('test')
+        end
+        
+        def self.application
+          app = Object.new
+          credentials = {}
+          app.define_singleton_method(:credentials) { credentials }
+          app
+        end
+      end
+    end
+    
+    # Initialize with memory backend
+    config.instance_variable_set(:@backends, nil)
+    config.instance_variable_set(:@config, nil)
+    BlueprintConfig.before_initialize.call
+    BlueprintConfig.after_initialize.call
+  end
+  
+  after do
+    Object.send(:remove_const, :Rails) if defined?(Rails)
+    config.clear_memory! if config.backends[:memory]
+  end
+  
+  describe '#set' do
+    context 'in test environment' do
+      it 'sets a simple value' do
+        config.set('foo', 'bar')
+        expect(config[:foo]).to eq('bar')
+      end
+      
+      it 'sets a value with dotted key' do
+        config.set('smtp.server', 'test.example.com')
+        expect(config.dig(:smtp, :server)).to eq('test.example.com')
+      end
+      
+      it 'accepts hash argument to set multiple values' do
+        config.set(
+          foo: 'bar',
+          smtp: { server: 'localhost', port: 1025 }
+        )
+        
+        expect(config[:foo]).to eq('bar')
+        expect(config.dig(:smtp, :server)).to eq('localhost')
+        expect(config.dig(:smtp, :port)).to eq(1025)
+      end
+      
+      it 'converts keys to strings' do
+        config.set(:symbol_key, 'value')
+        expect(config[:symbol_key]).to eq('value')
+      end
+      
+      it 'triggers reload after setting' do
+        expect(config).to receive(:reload!).at_least(:once)
+        config.set('test', 'value')
+      end
+    end
+    
+    context 'without memory backend' do
+      before do
+        # Remove memory backend
+        backends = config.backends
+        memory = backends[:memory]
+        backends.delete(:memory) if memory
+      end
+      
+      it 'raises error when memory backend is not configured' do
+        expect { config.set('foo', 'bar') }.to raise_error(/Memory backend not configured/)
+      end
+    end
+  end
+  
+  describe '#clear_memory!' do
+    context 'with memory backend' do
+      before do
+        config.set('foo', 'bar')
+        config.set('nested.key', 'value')
+      end
+      
+      it 'clears all memory-stored values' do
+        expect(config[:foo]).to eq('bar')
+        config.clear_memory!
+        expect { config.fetch(:foo) }.to raise_error(KeyError)
+      end
+      
+      it 'triggers reload after clearing' do
+        expect(config).to receive(:reload!).at_least(:once)
+        config.clear_memory!
+      end
+      
+      it 'allows setting new values after clear' do
+        config.clear_memory!
+        config.set('new', 'value')
+        expect(config[:new]).to eq('value')
+      end
+    end
+    
+    context 'without memory backend' do
+      before do
+        # Remove memory backend
+        backends = config.backends
+        memory = backends[:memory]
+        backends.delete(:memory) if memory
+      end
+      
+      it 'does nothing when memory backend is not present' do
+        expect { config.clear_memory! }.not_to raise_error
+      end
+    end
+  end
+  
+  describe 'non-test environment behavior' do
+    before do
+      # Mock production environment
+      allow(Rails).to receive(:env).and_return(ActiveSupport::StringInquirer.new('production'))
+      
+      # Reinitialize without memory backend
+      config.instance_variable_set(:@backends, nil)
+      config.instance_variable_set(:@config, nil)
+      BlueprintConfig.before_initialize.call
+      BlueprintConfig.after_initialize.call
+    end
+    
+    it 'does not include memory backend in production' do
+      expect(config.backends[:memory]).to be_nil
+    end
+    
+    it 'raises error when trying to set in production' do
+      expect { config.set('foo', 'bar') }.to raise_error(/Memory backend not configured/)
+    end
+  end
+end

data/spec/memory_integration_spec.rb

@@ -0,0 +1,191 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+require 'blueprint_config'
+
+describe 'Memory backend integration' do
+  # Simulate Rails test environment
+  before(:all) do
+    unless defined?(Rails)
+      module Rails
+        def self.env
+          ActiveSupport::StringInquirer.new('test')
+        end
+        
+        def self.application
+          # Mock credentials
+          app = Object.new
+          credentials = {}
+          app.define_singleton_method(:credentials) { credentials }
+          app
+        end
+      end
+    end
+  end
+
+  before do
+    # Reset configuration
+    BlueprintConfig.instance.instance_variable_set(:@backends, nil)
+    BlueprintConfig.instance.instance_variable_set(:@config, nil)
+    
+    # Initialize with memory backend
+    BlueprintConfig.before_initialize.call
+    BlueprintConfig.after_initialize.call
+  end
+
+  after do
+    # Clean up memory after each test
+    BlueprintConfig.instance.clear_memory! if BlueprintConfig.instance.backends[:memory]
+  end
+
+  describe 'AppConfig.set' do
+    before do
+      BlueprintConfig.define_shortcut
+    end
+
+    context 'with simple values' do
+      it 'sets and retrieves string value' do
+        AppConfig.set('some.setting', 'value')
+        expect(AppConfig.some.setting).to eq('value')
+      end
+
+      it 'sets and retrieves numeric value' do
+        AppConfig.set('limit', 100)
+        expect(AppConfig.limit).to eq(100)
+      end
+
+      it 'sets and retrieves boolean value' do
+        AppConfig.set('enabled', true)
+        expect(AppConfig.enabled).to be true
+      end
+
+      it 'overwrites existing values' do
+        AppConfig.set('foo', 'bar')
+        AppConfig.set('foo', 'baz')
+        expect(AppConfig.foo).to eq('baz')
+      end
+    end
+
+    context 'with hash argument' do
+      it 'sets multiple values at once' do
+        AppConfig.set(
+          foo: 'bar',
+          baz: 'qux',
+          num: 42
+        )
+        expect(AppConfig.foo).to eq('bar')
+        expect(AppConfig.baz).to eq('qux')
+        expect(AppConfig.num).to eq(42)
+      end
+
+      it 'sets nested values' do
+        AppConfig.set(
+          smtp: {
+            server: 'localhost',
+            port: 1025
+          }
+        )
+        expect(AppConfig.smtp.server).to eq('localhost')
+        expect(AppConfig.smtp.port).to eq(1025)
+      end
+
+      it 'sets deeply nested values' do
+        AppConfig.set(
+          app: {
+            mail: {
+              smtp: {
+                settings: {
+                  address: '127.0.0.1',
+                  port: 587
+                }
+              }
+            }
+          }
+        )
+        expect(AppConfig.app.mail.smtp.settings.address).to eq('127.0.0.1')
+        expect(AppConfig.app.mail.smtp.settings.port).to eq(587)
+      end
+    end
+
+    context 'with dotted key and hash value' do
+      it 'combines key prefix with hash keys' do
+        AppConfig.set('mail.smtp', { server: 'localhost', port: 1025 })
+        expect(AppConfig.mail.smtp.server).to eq('localhost')
+        expect(AppConfig.mail.smtp.port).to eq(1025)
+      end
+    end
+
+    context 'memory backend priority' do
+      it 'overrides values from other backends' do
+        # Assuming there might be some default config
+        AppConfig.set('host', 'test.example.com')
+        expect(AppConfig.host).to eq('test.example.com')
+      end
+    end
+  end
+
+  describe 'AppConfig.clear_memory!' do
+    before do
+      BlueprintConfig.define_shortcut
+    end
+
+    it 'clears all memory-stored values' do
+      AppConfig.set('foo', 'bar')
+      AppConfig.set('baz', 'qux')
+      
+      AppConfig.clear_memory!
+      
+      # Values should revert to what's in other backends or nil
+      expect { AppConfig.foo! }.to raise_error(KeyError)
+      expect { AppConfig.baz! }.to raise_error(KeyError)
+    end
+
+    it 'can be used between test examples' do
+      AppConfig.set('test.value', 'first')
+      expect(AppConfig.test.value).to eq('first')
+      
+      AppConfig.clear_memory!
+      
+      AppConfig.set('test.value', 'second')
+      expect(AppConfig.test.value).to eq('second')
+    end
+  end
+
+  describe 'RSpec usage pattern' do
+    before do
+      BlueprintConfig.define_shortcut
+    end
+
+    context 'with some setting' do
+      before do
+        AppConfig.set('some.setting', 'value')
+      end
+
+      after do
+        AppConfig.clear_memory!
+      end
+
+      it 'works as expected' do
+        expect(AppConfig.some.setting).to eq('value')
+      end
+
+      it 'is isolated from other tests' do
+        expect(AppConfig.some.setting).to eq('value')
+      end
+    end
+
+    context 'with different setting' do
+      before do
+        AppConfig.set('some.setting', 'different')
+      end
+
+      after do
+        AppConfig.clear_memory!
+      end
+
+      it 'has its own value' do
+        expect(AppConfig.some.setting).to eq('different')
+      end
+    end
+  end
+end

data/spec/options_hash_with_sources_spec.rb

@@ -0,0 +1,132 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+require 'blueprint_config/options_hash'
+require 'blueprint_config/options_array'
+
+describe BlueprintConfig::OptionsHash do
+  describe '#with_sources' do
+    describe 'simple values' do
+    it 'returns hash with value and source for each key' do
+      hash = BlueprintConfig::OptionsHash.new(
+        { foo: 'bar', num: 42 },
+        source: 'TestBackend'
+      )
+
+      result = hash.with_sources
+      expect(result).to eq({
+        foo: { value: 'bar', source: 'TestBackend' },
+        num: { value: 42, source: 'TestBackend' }
+      })
+    end
+  end
+
+  describe 'nested hashes' do
+    it 'recursively includes sources for nested values' do
+      hash = BlueprintConfig::OptionsHash.new(
+        {
+          smtp: {
+            server: 'localhost',
+            port: 1025
+          },
+          features: {
+            enabled: true
+          }
+        },
+        source: 'ConfigFile'
+      )
+
+      result = hash.with_sources
+      expect(result[:smtp][:server]).to eq({ value: 'localhost', source: 'ConfigFile' })
+      expect(result[:smtp][:port]).to eq({ value: 1025, source: 'ConfigFile' })
+      expect(result[:features][:enabled]).to eq({ value: true, source: 'ConfigFile' })
+    end
+  end
+
+  describe 'arrays' do
+    it 'handles arrays properly' do
+      hash = BlueprintConfig::OptionsHash.new(
+        {
+          servers: ['web1', 'web2', 'web3'],
+          ports: [80, 443]
+        },
+        source: 'YAMLBackend'
+      )
+
+      result = hash.with_sources
+      expect(result[:servers]).to eq({
+        value: ['web1', 'web2', 'web3'],
+        source: 'YAMLBackend'
+      })
+      expect(result[:ports]).to eq({
+        value: [80, 443],
+        source: 'YAMLBackend'
+      })
+    end
+  end
+
+  describe 'mixed sources after merge' do
+    it 'preserves individual sources after deep merge' do
+      # First configuration from YAML
+      yaml_config = BlueprintConfig::OptionsHash.new(
+        {
+          smtp: { server: 'smtp.example.com', port: 587 },
+          app: { name: 'MyApp' }
+        },
+        source: 'YAML'
+      )
+
+      # Override some values from credentials
+      creds_config = BlueprintConfig::OptionsHash.new(
+        {
+          smtp: { username: 'user@example.com' },
+          database: { password: 'secret' }
+        },
+        source: 'Credentials'
+      )
+
+      # Merge configurations
+      yaml_config.deep_merge!(creds_config)
+
+      result = yaml_config.with_sources
+      
+      # Original YAML values
+      expect(result[:smtp][:server]).to eq({ value: 'smtp.example.com', source: 'YAML' })
+      expect(result[:smtp][:port]).to eq({ value: 587, source: 'YAML' })
+      expect(result[:app][:name]).to eq({ value: 'MyApp', source: 'YAML' })
+      
+      # Values from credentials
+      expect(result[:smtp][:username]).to eq({ value: 'user@example.com', source: 'Credentials' })
+      expect(result[:database][:password]).to eq({ value: 'secret', source: 'Credentials' })
+    end
+  end
+
+  describe 'deeply nested structures' do
+    it 'handles deeply nested structures' do
+      hash = BlueprintConfig::OptionsHash.new(
+        {
+          level1: {
+            level2: {
+              level3: {
+                value: 'deep',
+                array: [1, 2, 3]
+              }
+            }
+          }
+        },
+        source: 'DeepSource'
+      )
+
+      result = hash.with_sources
+      expect(result[:level1][:level2][:level3][:value]).to eq({
+        value: 'deep',
+        source: 'DeepSource'
+      })
+      expect(result[:level1][:level2][:level3][:array]).to eq({
+        value: [1, 2, 3],
+        source: 'DeepSource'
+      })
+    end
+  end
+  end
+end

data/spec/spec_helper.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+require 'active_support'
+require 'active_support/core_ext'
+require 'active_support/string_inquirer'
 require 'blueprint_config'
 
 BlueprintConfig.root = File.dirname(__FILE__)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: blueprint_config
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.5.0
 platform: ruby
 authors:
 - Vladimir Elchinov
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-08-13 00:00:00.000000000 Z
+date: 2025-07-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -108,6 +108,7 @@ files:
 - lib/blueprint_config/backend/base.rb
 - lib/blueprint_config/backend/credentials.rb
 - lib/blueprint_config/backend/env.rb
+- lib/blueprint_config/backend/memory.rb
 - lib/blueprint_config/backend/yaml.rb
 - lib/blueprint_config/backend_collection.rb
 - lib/blueprint_config/configuration.rb
@@ -120,13 +121,19 @@ files:
 - lib/generators/blueprint_config/install/install_generator.rb
 - lib/generators/blueprint_config/install/templates/migration.rb.erb
 - spec/backend_collection_spec.rb
+- spec/backend_source_tracking_spec.rb
 - spec/blueprint_config/backend/active_record_spec.rb
 - spec/blueprint_config/backend/env_spec.rb
+- spec/blueprint_config/backend/memory_spec.rb
 - spec/blueprint_config/backend/yaml_spec.rb
 - spec/blueprint_config/options_array_spec.rb
 - spec/blueprint_config/options_hash_spec.rb
 - spec/config/app.yml
+- spec/configuration_integration_spec.rb
+- spec/configuration_memory_methods_spec.rb
 - spec/configuration_spec.rb
+- spec/memory_integration_spec.rb
+- spec/options_hash_with_sources_spec.rb
 - spec/spec_helper.rb
 homepage: https://github.com/railsblueprint/blueprint_config
 licenses:
@@ -153,11 +160,17 @@ specification_version: 4
 summary: Congifure Ruby apps
 test_files:
 - spec/backend_collection_spec.rb
+- spec/backend_source_tracking_spec.rb
 - spec/blueprint_config/backend/active_record_spec.rb
 - spec/blueprint_config/backend/env_spec.rb
+- spec/blueprint_config/backend/memory_spec.rb
 - spec/blueprint_config/backend/yaml_spec.rb
 - spec/blueprint_config/options_array_spec.rb
 - spec/blueprint_config/options_hash_spec.rb
 - spec/config/app.yml
+- spec/configuration_integration_spec.rb
+- spec/configuration_memory_methods_spec.rb
 - spec/configuration_spec.rb
+- spec/memory_integration_spec.rb
+- spec/options_hash_with_sources_spec.rb
 - spec/spec_helper.rb