unifig 0.3.2 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 89378b794de9cdd9511c52a145c4458317713e357634690201b3af379fd19e23
-  data.tar.gz: 51642a4f0f6e7bf60fbc6715427678344b81b21c8b3cbe8bbd51d392169c0413
+  metadata.gz: 5a663a7911df321fea42c56973ea1d194c678e3fa54c7856decaec28df550619
+  data.tar.gz: ada57aa2f5292246c16498218e869be155532dcbd9ab72544abbd06b5d9692b4
 SHA512:
-  metadata.gz: 5c0ff6dd223e7999c825c2f63894ade93b687927b3473b277a65f382526cb811f8588726b530ec7d5ed4dda8fc33d2b849453b17edf562a6c8850e828d60b1f3
-  data.tar.gz: fed3b1b88b3f3e2b8397e29d6cd191047e8239a63983e34fb5b34d61b3eee7f1c65906fbcd0ab6e32fb1f19f83a5badfeafc3f9ee6cc05c074e5c0877eae1b37
+  metadata.gz: 1dd696cd7f734a3fc9e041d61291f2d70796e00ceb069ed5697dca7d1f8f29856ebb6b0c17722e04b2a198fd89aa3e6b7edca635c0e3abb04f256195cc684fc1
+  data.tar.gz: c9f9728f4ebca40748944c096a87f2e2f2bf0fe4aad4ca5706757cbedb45bd24c2dc571124460893b96d4ecee9d3b2238c56fe2cddb0536f73be516e7759f99c

data/CHANGELOG.md

@@ -1,3 +1,15 @@
+# [0.4.0][] (2022-09-01)
+
+## Changed
+
+- All values are strings by default regardless of how they arrived.
+- The `config` key is now `unifig`.
+
+## Added
+
+- Values can now be converted to built-in or custom types.
+- Providers can now be configured.
+
 # [0.3.2][] (2022-08-01)
 
 ## Fixed
@@ -34,6 +46,7 @@
 
 Initial release.
 
+[0.4.0]: https://github.com/AaronLasseigne/unifig/compare/v0.3.2...v0.4.0
 [0.3.2]: https://github.com/AaronLasseigne/unifig/compare/v0.3.1...v0.3.2
 [0.3.1]: https://github.com/AaronLasseigne/unifig/compare/v0.3.0...v0.3.1
 [0.3.0]: https://github.com/AaronLasseigne/unifig/compare/v0.2.0...v0.3.0

data/README.md

@@ -18,13 +18,13 @@ If you want to use Unifig outside of a framework listed above you can manually a
 Add it to your Gemfile:
 
 ``` rb
-gem 'unifig', '~> 0.3.2'
+gem 'unifig', '~> 0.4.0'
 ```
 
 Or install it manually:
 
 ``` sh
-$ gem install unifig --version '~> 0.3.2'
+$ gem install unifig --version '~> 0.4.0'
 ```
 
 This project uses [Semantic Versioning][].
@@ -32,44 +32,146 @@ Check out [GitHub releases][] for a detailed list of changes.
 
 ## Usage
 
-### Basics
+### Basic
 
-Unifig loads a [YAML configuration][] that instructs it on how to retrieve various external variables.
-These variable values come from providers.
+Unifig works by loading a YAML configuration that instructs it on how to retrieve and treat external variables.
+Variable values are retrieved from an ordered list of providers.
+
+A provider is any source where you would retrieve variable values.
 Unifig comes with a `local` provider which reads values straight from the configuration file.
-Additional providers may be installed.
+Additional providers may be installed:
+
+| Provider | Gem            |
+| -------- | -------------- |
+| local    | Built-in       |
+| env      | [unifig-env][] |
+
+Providers are checked in order to find the variable values.
+If a variable is not found in the first provider, it will be requested from the second provider and so on until it is found.
+
+The YAML configuration should begin with a `unifig` key which lists the providers in the order you would like them checked:
+
+```yml
+unifig:
+  providers: [local, env]
+```
 
-The most minimal configuration would be:
+You can list a single provider or an ordered array to check.
+
+Variables should be listed after the `unifig` key as their own keys.
+Here's a mininal example YAML:
 
 ```yml
-config:
+unifig:
   providers: local
 
+HELLO: "world"
+```
+
+When this YAML is loaded, Unifig will add two methods to it's core `Unifig` class.
+The first, `Unifig.hello` will return `"hello"` as the value it found from the `local` provider.
+The second method, `Unifig.hello?` allow you to check to see if the value was able to be retrived at all.
+
+```yml
+> Unifig.hello?
+# true
+> Unifig.hello
+# => "world"
+```
+
+Each variable listed in the YAML configuration will receive its own pair of methods on `Unifig`.
+
+Variables can be listed with the `local` value immediately following as seen above.
+They can also be defined with no `local` value:
+
+```yml
+HELLO:
+```
+
+Or they can be declared with the verbose syntax:
+
+```yaml
 HELLO:
   value: "world"
 ```
 
-Given that configuration, Unifig will attach two new methods to the `Unifig` class.
-From in your code you can call `Unifig.hello` to get the value of the variable and `Unifig.hello?` to see if the value was retrieved (for optional values).
+The verbose syntax is useful when additional configration is need as seen in the [Advanced](#advanced) section.
+
+Loading a YAML configuration can be accomplished using the `Unifig::Init` class.
+From `Unifig::Init` you can load the YAML as a string with `.load` or as a file with `.load_file`.
+
+*NOTE: If you're using one of the framework gems, loading may be handled for you.*
+
+Loading from a string:
+
+```rb
+Unifig::Init.load(<<~YML)
+  unifig:
+    providers: local
+
+  HELLO: "world"
+YML
+```
+
+Loading from a file:
+
+```rb
+Unifig::Init.load_file('unifig.yml')
+```
+
+### Advanced
+
+#### Environments
+
+Different working environments may require different setups.
+This can be accomplished in the `unifig` key or within variable keys with the `envs` key.
 
-Unifig also allows you to override the overall configuration or the individual configuration by using environments.
-Here is an example where the `production` environment only pull from the `env` provider and in the `test` environment `Unifig.hello` will return `dlrow`:
+Assuming two environments, `developement` and `production`, let's say we want to use different providers for each.
+Whatever we set at the top level will operate as the default.
+From there we can use the `envs` key to override that behavior:
 
 ```yml
-config:
-  providers: [local, env]
+unifig:
+  providers: local
+  envs:
+    production:
+      providers: env
+
+HELLO: "world"
+```
+
+In the `development` environment we'll check the `local` provider but in `production` we'll use `env`.
+This will result with `Unifig.hello` returning `"world"` in `development` and whatever the value of the `HELLO` environment variable is in `production`.
+To select an environment, add it to `Unifig::Init.load` or `Unifig::Init.load_file`:
+
+```rb
+Unifig::Init.load(<<~YML, env: :development)
+  unifig:
+    providers: local
     envs:
       production:
         providers: env
 
+  HELLO: "world"
+YML
+```
+
+*NOTE: If you're using one of the framework gems, environments may be loaded automatically depending on the framework.*
+
+In addition to changing `unifig`, `envs` may be used inside variables.
+Any variable configuration may be overridden using `envs`:
+
+```yml
 HELLO:
   value: "world"
   envs:
-    test:
-      value: "dlrow"
+    production:
+      value: "universe"
 ```
 
-### Variable Substitutions
+Here we've set the `local` provider value to `"world"` for all environments with an override setting it to `"universe"` in the `production` environment.
+
+#### Variable Substitutions
 
 Variables can be used in other variables with `${VAR}`.
 
@@ -80,86 +182,71 @@ SERVICE_USERNAME: "${USER}_at_service"
 
 Order of the variables does not matter but cyclical dependencies will throw an error.
 
-### Loading
+#### Type Conversion
 
-Loading a configuration is handled through the `Unifig::Init` class.
-From `Unifig::Init` you can load the YAML as a string with `.load` or a file with `.load_file`.
+By default, all values are converted to strings.
+If you want the value to be something other than a string you can assign a specific conversion.
+Unifig comes with some basic built-in conversions or you can convert to any class available.
 
-All variables are assumed to be required (not `nil` or a blank string).
-Variables can be made optional by using the `:optional` setting.
-If there is a required variable without a value, Unifig will throw an error when loading.
-
-```rb
-Unifig::Init.load(<<~YAML, env: :production)
-  config:
-    providers: local
-
-  HOST:
-    value: github.com
-    envs:
-      development:
-        value: localhost
-  PORT:
-    optional: true
-    envs:
-      development:
-        value: 8080
-YAML
+In order to convert a value you can provide a type to `convert`:
 
-> Unifig.host?
-# true
-> Unifig.host
-# => "localhost"
-> Unifig.port?
-# true
-> Unifig.port
-# => 8080
+```yml
+THREADS:
+  value: 5
+  convert: integer
 ```
 
-If we replaced `:development` with `:production` inside the `load` call we'd get:
+Conversion works regardless of the provider of the value.
 
-```rb
-> Unifig.host?
-# true
-> Unifig.host
-# => "github.com"
-> Unifig.port?
-# false
-> Unifig.port
-# => nil
-```
+##### Built-in
 
-You can load from a configuration file by using `load_file`.
+There are a number of built-in types available.
+Basic types that have no additional options include `string` (the default), `symbol`, `float`, and `decimal` (i.e. `BigDecimal`).
 
-```rb
-Unifig::Init.load_file('unifig.yml', env: :production)
-```
+The `integer` type assumes base 10.
+This can be overridden by providing a `base` option:
 
-[API Documentation][]
+```yml
+BINARY_INPUT:
+  convert:
+    type: integer
+    base: 2
+```
 
-### YAML Configuration
+Unifig also provides `date`, `date_time`, and `time` all of which use `parse` by default.
+Any of them can be provided with a `format` option if you want to specify the format of the input.
+The `format` option uses `strptime` for the conversion.
+You can find all valid formats by looking at the standard Ruby documentation.
 
-The configuration YAML must contain a `config` key.
-A list of one or more providers must be given.
-They are are checked in order to find the value for each variable.
-Variables are then listed by name.
+```yml
+STARTS_ON:
+  convert:
+    type: date
+    format: %Y-%m-%d
+```
 
-The first level of configurations apply to all environments.
-These can be overridden by setting the `envs` key and a key with the name of then environment and then redefining any settings.
-This is the case for the overall configuration as well as any variable configurations.
+##### Custom
 
-### Providers
+Any available class can be used as a converter by providing the class name as the `converter`.
+By default, `new` will be called on the class with the value passed in.
+To use a different method provide it via the `method` option.
 
-| Provider | Gem            |
-| -------- | -------------- |
-| Local    | Built-in       |
-| ENV      | [unifig-env][] |
+```yml
+IP_ADDRESS:
+  convert: IPAddr
+ENCODING:
+  convert:
+    type: Encoding
+    method: find
+```
 
-### Unifig::Vars
+#### Unifig::Vars
 
 After loading the configuration you can use `Unifig::Vars` to check on what happened.
 It will return a list of `Unifig::Var`s with information such as which provider supplied the value.
 
+[API Documentation][]
+
 ## Contributing
 
 If you want to contribute to Unifig, please read [our contribution guidelines][].
@@ -173,7 +260,6 @@ Unifig is licensed under [the MIT License][].
 [unifig-rails]: https://github.com/AaronLasseigne/unifig-rails
 [Semantic Versioning]: http://semver.org/spec/v2.0.0.html
 [GitHub releases]: https://github.com/AaronLasseigne/unifig/releases
-[YAML configuration]: #yaml-configuration
 [API Documentation]: http://rubydoc.info/github/AaronLasseigne/unifig
 [our contribution guidelines]: CONTRIBUTING.md
 [unifig-env]: https://github.com/AaronLasseigne/unifig-env

data/lib/unifig/config.rb

@@ -14,7 +14,22 @@ module Unifig
     end
 
     def providers
-      @providers ||= Array(@env_config[:providers]).map(&:to_sym).freeze
+      return @providers if defined?(@providers)
+
+      providers =
+        if @env_config[:providers].is_a?(Hash)
+          @env_config.dig(:providers, :list)
+        else
+          @env_config[:providers]
+        end
+
+      @providers = Array(providers).map(&:to_sym).freeze
+    end
+
+    def provider_config(name)
+      return {} unless @env_config[:providers].is_a?(Hash)
+
+      @env_config.dig(:providers, :config, name) || {}
     end
   end
 end

data/lib/unifig/errors.rb

@@ -24,4 +24,7 @@ module Unifig
 
   # Raised if a substitution does not exist.
   MissingSubstitutionError = Class.new(Error)
+
+  # Raised if a type does not exist.
+  InvalidTypeError = Class.new(Error)
 end

data/lib/unifig/init.rb

@@ -10,7 +10,7 @@ module Unifig
       #
       # @example
       #   Unifig::Init.load(<<~YML, env: :development)
-      #     config:
+      #     unifig:
       #       envs:
       #         development:
       #           providers: local
@@ -54,14 +54,14 @@ module Unifig
       # @raise (see Unifig::Var.load!)
       # @raise (see .complete_substitutions!)
       def exec!(yml, env: nil)
-        config = Config.new(yml.delete(:config), env: env)
+        config = Config.new(yml.delete(:unifig), env: env)
 
         providers = Providers.list(config.providers)
         return if providers.empty?
 
         Vars.load!(yml, env)
 
-        fetch_from_providers!(providers)
+        fetch_from_providers!(providers, config)
 
         check_required_vars
 
@@ -72,10 +72,10 @@ module Unifig
         attach_missing_optional_methods!(missing_vars)
       end
 
-      def fetch_from_providers!(providers)
+      def fetch_from_providers!(providers, config)
         providers.each do |provider|
           remaining_vars = Vars.list.filter_map { |var| var.name if var.value.nil? }
-          result = provider.retrieve(remaining_vars)
+          result = provider.retrieve(remaining_vars, config.provider_config(provider.name))
 
           Vars.write_results!(result, provider.name)
         end
@@ -92,6 +92,7 @@ module Unifig
 
       # @raise [CyclicalSubstitutionError] - Subtitutions resulted in a cyclical dependency.
       # @raise [MissingSubstitutionError] - A substitution does not exist.
+      # @raise (see Unifig::Var#value=)
       def complete_substitutions!
         Vars.tsort.each do |name|
           var = Vars[name]

data/lib/unifig/providers/local.rb

@@ -8,7 +8,7 @@ module Unifig
         :local
       end
 
-      def self.retrieve(var_names)
+      def self.retrieve(var_names, _config)
         var_names.to_h do |name|
           [name, Vars[name].local_value]
         end

data/lib/unifig/var.rb

@@ -1,8 +1,15 @@
 # frozen_string_literal: true
 
+require 'bigdecimal'
+require 'date'
+require 'time'
+
 module Unifig
   # A variable created after loading a configuration.
   class Var
+    DEFAULT_INTEGER_BASE = 10
+    private_constant :DEFAULT_INTEGER_BASE
+
     # @private
     def initialize(name, config, env)
       @name = name
@@ -31,9 +38,10 @@ module Unifig
     attr_reader :value
 
     # @private
+    # @raise (see #convert)
     def value=(obj)
-      value = blank?(obj) ? nil : obj
-      value = value.dup.freeze unless value.frozen?
+      value = blank?(obj) ? nil : obj.dup
+      value = convert(value).freeze unless value.nil?
       @value = value
     end
 
@@ -46,7 +54,7 @@ module Unifig
 
     # @private
     def local_value
-      @local_value ||= env_config(:value) || @config[:value]
+      @local_value ||= config(:value)
     end
 
     # Returns whether or not this is a required variable.
@@ -55,7 +63,7 @@ module Unifig
     def required?
       return @required if defined?(@required)
 
-      optional = env_config(:optional)
+      optional = config(:optional)
       optional = @config[:optional] if optional.nil?
       optional = false if optional.nil?
       @required = !optional
@@ -63,8 +71,81 @@ module Unifig
 
     private
 
-    def env_config(key)
-      @config.dig(:envs, @env, key)
+    # @raise [InvalidTypeError] - A type does not exist.
+    def convert(value)
+      convert = config(:convert)
+      type, options =
+        if convert.is_a?(Hash)
+          [convert[:type], convert.slice(*(convert.keys - [:type]))]
+        else
+          [convert, nil]
+        end
+      type = 'string' if type.nil?
+      options = {} if options.nil?
+
+      if built_in?(type)
+        convert_built_in(type, options, value)
+      else
+        convert_custom_type(type, options, value)
+      end
+    end
+
+    def convert_built_in(type, options, value) # rubocop:disable Metrics
+      case type
+      when 'date'
+        time_convert(Date, options, value)
+      when 'date_time'
+        time_convert(DateTime, options, value)
+      when 'decimal'
+        BigDecimal(value)
+      when 'integer'
+        base = options.fetch(:base, DEFAULT_INTEGER_BASE)
+        Integer(value, base)
+      when 'float'
+        Float(value)
+      when 'string'
+        String(value)
+      when 'symbol'
+        String(value).to_sym
+      when 'time'
+        time_convert(Time, options, value)
+      else
+        raise InvalidTypeError, %(unknown built-in type "#{type}")
+      end
+    end
+
+    def convert_custom_type(type, options, value)
+      klass =
+        begin
+          Kernel.const_get(type)
+        rescue NameError
+          raise InvalidTypeError, %(unknown custom type "#{type}")
+        end
+
+      klass.public_send(options.fetch(:method, :new), value)
+    end
+
+    def integer(value)
+      Integer(value, DEFAULT_INTEGER_BASE)
+    rescue ArgumentError
+      nil
+    end
+
+    def built_in?(type)
+      /\A\p{Ll}/.match?(type) # \p{Ll} = unicode lowercase
+    end
+
+    def time_convert(klass, options, value)
+      return klass.strptime(value, options[:format]) if options[:format]
+
+      klass.parse(value)
+    end
+
+    def config(key)
+      env_conf = @config.dig(:envs, @env, key)
+      return env_conf unless env_conf.nil?
+
+      @config[key]
     end
 
     def blank?(value)

data/lib/unifig/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Unifig
-  VERSION = '0.3.2'
+  VERSION = '0.4.0'
 end

data/spec/spec_helper.rb

@@ -41,9 +41,11 @@ RSpec.configure do |config|
             :forty_two
           end
 
-          def self.retrieve(var_names)
+          def self.retrieve(var_names, config)
+            num = config.fetch(:num, 42).to_s.freeze
+
             var_names.to_h do |var_name|
-              [var_name, '42'.freeze]
+              [var_name, num]
             end
           end
         end

data/spec/unifig/config_spec.rb

@@ -24,7 +24,7 @@ RSpec.describe Unifig::Config do
   end
 
   describe '#providers' do
-    it 'returns a list of providers for the selected env' do
+    it 'returns a list of providers' do
       expect(config.providers).to eql %i[local]
     end
 
@@ -35,5 +35,47 @@ RSpec.describe Unifig::Config do
         expect(config.providers).to eql %i[local forty_two]
       end
     end
+
+    context 'with a :list' do
+      let(:config_hash) do
+        {
+          providers: {
+            list: 'local'
+          }
+        }
+      end
+
+      it 'returns a list of providers' do
+        expect(config.providers).to eql %i[local]
+      end
+    end
+  end
+
+  describe '#provider_config' do
+    it 'returns an empty config if none is provided' do
+      expect(config.provider_config(:local)).to eql({})
+    end
+
+    context 'with a configuration' do
+      let(:local_config) do
+        {
+          here: true
+        }
+      end
+      let(:config_hash) do
+        {
+          providers: {
+            list: 'local',
+            config: {
+              local: local_config
+            }
+          }
+        }
+      end
+
+      it 'returns the config info' do
+        expect(config.provider_config(:local)).to eql(local_config)
+      end
+    end
   end
 end

data/spec/unifig/init_spec.rb

@@ -20,7 +20,7 @@ RSpec.shared_examples 'basic load tests' do
   context 'with a valid config' do
     let(:str) do
       <<~YML
-        config:
+        unifig:
           providers: local
 
         ONE:
@@ -32,7 +32,7 @@ RSpec.shared_examples 'basic load tests' do
       subject
 
       expect(Unifig).to respond_to(:one)
-      expect(Unifig.one).to be 1
+      expect(Unifig.one).to eql '1'
     end
   end
 end
@@ -48,7 +48,7 @@ RSpec.describe Unifig::Init do
     context 'from multiple providers' do
       let(:str) do
         <<~YML
-          config:
+          unifig:
             providers: [local, forty_two]
 
           ONE:
@@ -61,7 +61,31 @@ RSpec.describe Unifig::Init do
         load
 
         expect(Unifig.one).to eql '42'
-        expect(Unifig.two).to be 2
+        expect(Unifig.two).to eql '2'
+      end
+    end
+
+    context 'with provider configuration' do
+      let(:str) do
+        <<~YML
+          unifig:
+            providers:
+              list: [local, forty_two]
+              config:
+                forty_two:
+                  num: 24
+
+          ONE:
+          TWO:
+            value: 2
+        YML
+      end
+
+      it 'returns the values from the providers in order' do
+        load
+
+        expect(Unifig.one).to eql '24'
+        expect(Unifig.two).to eql '2'
       end
     end
 
@@ -71,7 +95,7 @@ RSpec.describe Unifig::Init do
       context 'that is available' do
         let(:str) do
           <<~YML
-            config:
+            unifig:
               providers: local
 
             ONE:
@@ -81,7 +105,7 @@ RSpec.describe Unifig::Init do
         end
 
         it 'loads the var' do
-          expect(Unifig.one).to be 1
+          expect(Unifig.one).to eql '1'
         end
 
         it 'sets the predicate to true' do
@@ -92,7 +116,7 @@ RSpec.describe Unifig::Init do
       context 'that is not available' do
         let(:str) do
           <<~YML
-            config:
+            unifig:
               providers: local
 
             ONE:
@@ -112,7 +136,7 @@ RSpec.describe Unifig::Init do
       context 'that is not blank' do
         let(:str) do
           <<~YML
-            config:
+            unifig:
               providers: local
 
             ONE:
@@ -137,7 +161,7 @@ RSpec.describe Unifig::Init do
 
         let(:str) do
           <<~YML
-            config:
+            unifig:
               providers: local
 
             ONE:
@@ -146,7 +170,7 @@ RSpec.describe Unifig::Init do
         end
 
         it 'loads the var' do
-          expect(Unifig.one).to be 1
+          expect(Unifig.one).to eql '1'
         end
 
         it 'sets the predicate to true' do
@@ -157,7 +181,7 @@ RSpec.describe Unifig::Init do
       context 'that is not available' do
         let(:str) do
           <<~YML
-            config:
+            unifig:
               providers: local
 
             ONE:
@@ -173,7 +197,7 @@ RSpec.describe Unifig::Init do
       context 'that is blank' do
         let(:str) do
           <<~YML
-            config:
+            unifig:
               providers: local
 
             ONE:
@@ -190,7 +214,7 @@ RSpec.describe Unifig::Init do
     context 'with substitutions' do
       let(:str) do
         <<~YML
-          config:
+          unifig:
             providers: local
 
           NAME:
@@ -209,7 +233,7 @@ RSpec.describe Unifig::Init do
       context 'when they are out of order' do
         let(:str) do
           <<~YML
-            config:
+            unifig:
               providers: local
 
             GREETING:
@@ -229,7 +253,7 @@ RSpec.describe Unifig::Init do
       context 'when they chain' do
         let(:str) do
           <<~YML
-            config:
+            unifig:
               providers: local
 
             INTRO:
@@ -251,7 +275,7 @@ RSpec.describe Unifig::Init do
       context 'when they cause a cycle' do
         let(:str) do
           <<~YML
-            config:
+            unifig:
               providers: local
 
             A:
@@ -271,7 +295,7 @@ RSpec.describe Unifig::Init do
       context 'when they do not exist' do
         let(:str) do
           <<~YML
-            config:
+            unifig:
               providers: local
 
             A:

data/spec/unifig/var_spec.rb

@@ -1,3 +1,5 @@
+require 'ipaddr'
+
 RSpec.describe Unifig::Var do
   subject(:var) { described_class.new(name, config, env) }
 
@@ -32,6 +34,263 @@ RSpec.describe Unifig::Var do
       expect(var.value).to eql 'a'
       expect(var.value).to be_frozen
     end
+
+    context 'without a type' do
+      it 'defaults to string' do
+        var.value = 1
+
+        expect(var.value).to eql '1'
+      end
+    end
+
+    context 'with a type of' do
+      context 'string' do
+        before do
+          config.merge!(convert: 'string')
+        end
+
+        it 'converts to a String' do
+          var.value = 1
+
+          expect(var.value).to eql '1'
+        end
+      end
+
+      context 'integer' do
+        before do
+          config.merge!(convert: 'integer')
+        end
+
+        it 'converts to an Integer' do
+          var.value = '01'
+
+          expect(var.value).to be 1
+        end
+
+        context 'with option' do
+          context 'base' do
+            before do
+              config.merge!(convert: { type: 'integer', base: 2 })
+            end
+
+            it 'converts it using the specified base' do
+              var.value = '11'
+
+              expect(var.value).to be 3
+            end
+          end
+        end
+      end
+
+      context 'float' do
+        before do
+          config.merge!(convert: 'float')
+        end
+
+        it 'converts to a Float' do
+          var.value = '01.1'
+
+          expect(var.value).to be 1.1
+        end
+      end
+
+      context 'decimal' do
+        before do
+          config.merge!(convert: 'decimal')
+        end
+
+        it 'converts to a BigDecimal' do
+          var.value = '01.1'
+
+          expect(var.value).to eql BigDecimal('01.1')
+        end
+      end
+
+      context 'symbol' do
+        before do
+          config.merge!(convert: 'symbol')
+        end
+
+        it 'converts to a Symbol' do
+          var.value = 'one'
+
+          expect(var.value).to be :one
+        end
+      end
+
+      context 'date' do
+        before do
+          config.merge!(convert: 'date')
+        end
+
+        it 'converts to a Date' do
+          var.value = '2022-01-02'
+
+          value = var.value
+          expect(value).to be_an_instance_of Date
+          expect(value.year).to be 2022
+          expect(value.month).to be 1
+          expect(value.day).to be 2
+        end
+
+        context 'with option' do
+          context 'format' do
+            before do
+              config.merge!(convert: { type: 'date', format: '%Y-%m-%d' })
+            end
+
+            it 'converts it using the specified format' do
+              var.value = '2022-01-02'
+
+              value = var.value
+              expect(value).to be_an_instance_of Date
+              expect(value.year).to be 2022
+              expect(value.month).to be 1
+              expect(value.day).to be 2
+            end
+
+            it 'throws an error on the wrong input' do
+              expect { var.value = '2022-01' }.to raise_error Date::Error
+            end
+          end
+        end
+      end
+
+      context 'date_time' do
+        before do
+          config.merge!(convert: 'date_time')
+        end
+
+        it 'converts to a DateTime' do
+          var.value = '2022-01-02T03:04:05'
+
+          value = var.value
+          expect(value).to be_an_instance_of DateTime
+          expect(value.year).to be 2022
+          expect(value.month).to be 1
+          expect(value.day).to be 2
+          expect(value.hour).to be 3
+          expect(value.minute).to be 4
+          expect(value.second).to be 5
+        end
+
+        context 'with option' do
+          context 'format' do
+            before do
+              config.merge!(convert: { type: 'date_time', format: '%Y-%m-%dT%H:%M:%S' })
+            end
+
+            it 'converts it using the specified format' do
+              var.value = '2022-01-02T03:04:05'
+
+              value = var.value
+              expect(value).to be_an_instance_of DateTime
+              expect(value.year).to be 2022
+              expect(value.month).to be 1
+              expect(value.day).to be 2
+              expect(value.hour).to be 3
+              expect(value.minute).to be 4
+              expect(value.second).to be 5
+            end
+
+            it 'throws an error on the wrong input' do
+              expect { var.value = '2022-01' }.to raise_error DateTime::Error
+            end
+          end
+        end
+      end
+
+      context 'time' do
+        before do
+          config.merge!(convert: 'time')
+        end
+
+        it 'converts to a Time' do
+          var.value = '2022-01-02T03:04:05'
+
+          value = var.value
+          expect(value).to be_an_instance_of Time
+          expect(value.year).to be 2022
+          expect(value.month).to be 1
+          expect(value.day).to be 2
+          expect(value.hour).to be 3
+          expect(value.min).to be 4
+          expect(value.sec).to be 5
+        end
+
+        context 'with option' do
+          context 'format' do
+            before do
+              config.merge!(convert: { type: 'time', format: '%Y-%m-%dT%H:%M:%S' })
+            end
+
+            it 'converts it using the specified format' do
+              var.value = '2022-01-02T03:04:05'
+
+              value = var.value
+              expect(value).to be_an_instance_of Time
+              expect(value.year).to be 2022
+              expect(value.month).to be 1
+              expect(value.day).to be 2
+              expect(value.hour).to be 3
+              expect(value.min).to be 4
+              expect(value.sec).to be 5
+            end
+
+            it 'throws an error on the wrong input' do
+              expect { var.value = '2022-01' }.to raise_error ArgumentError
+            end
+          end
+        end
+      end
+
+      context 'invalid' do
+        before do
+          config.merge!(convert: 'invalid')
+        end
+
+        it 'throws an error' do
+          expect { var.value = 1 }.to raise_error Unifig::InvalidTypeError
+        end
+      end
+
+      context 'custom' do
+        before do
+          config.merge!(convert: 'IPAddr')
+        end
+
+        it 'converts to the class provided using .new' do
+          var.value = '127.0.0.1'
+
+          value = var.value
+          expect(value).to be_an_instance_of IPAddr
+          expect(value).to be_ipv4
+          expect(value.to_s).to eql '127.0.0.1'
+        end
+
+        context 'with a custom method' do
+          before do
+            config.merge!(convert: { type: 'Encoding', method: 'find' })
+          end
+
+          it 'uses the method provided' do
+            var.value = 'ascii'
+
+            expect(var.value).to be Encoding::US_ASCII
+          end
+        end
+
+        context 'with an invalid class' do
+          before do
+            config.merge!(convert: 'Invalid')
+          end
+
+          it 'throws an error' do
+            expect { var.value = 'invalid' }.to raise_error Unifig::InvalidTypeError
+          end
+        end
+      end
+    end
   end
 
   describe '#local_value' do

data/spec/unifig/vars_spec.rb

@@ -24,7 +24,7 @@ RSpec.describe Unifig::Vars do
       expect(vars.size).to be 2
       vars.each.with_index(1) do |var, value|
         expect(var).to be_an_instance_of Unifig::Var
-        expect(var.value).to be value
+        expect(var.value).to eql String(value)
         expect(var.provider).to be :local
       end
     end
@@ -35,7 +35,7 @@ RSpec.describe Unifig::Vars do
       var = described_class[:one]
 
       expect(var).to be_an_instance_of Unifig::Var
-      expect(var.value).to be 1
+      expect(var.value).to eql '1'
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unifig
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.4.0
 platform: ruby
 authors:
 - Aaron Lasseigne
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-08-01 00:00:00.000000000 Z
+date: 2022-09-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tsort