env_parser 0.1.0

data/env_parser.gemspec

@@ -0,0 +1,28 @@
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'env_parser/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'env_parser'
+  spec.version       = EnvParser::VERSION
+  spec.authors       = ['Nestor Custodio']
+  spec.email         = ['sakimorix@gmail.com']
+
+  spec.summary       = 'A tool for painless parsing and validation of environment variables.'
+  spec.homepage      = 'https://github.com/nestor-custodio/env_parser'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.16'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+
+  spec.add_dependency 'activesupport', '>= 5.0.0'
+end

data/lib/env_parser/version.rb

@@ -0,0 +1,3 @@
+class EnvParser
+  VERSION = '0.1.0'.freeze
+end

data/lib/env_parser.rb

@@ -0,0 +1,99 @@
+require 'env_parser/version'
+
+## The EnvParser class simplifies parsing of environment variables as different data types.
+##
+class EnvParser
+  class << self
+    ## Interprets the given value as the specified type.
+    ##
+    ## @param value [String, Symbol]
+    ##   The value to parse/interpret. If a String is given, the value will be used as-is. If a
+    ##   Symbol is given, the ENV value for the matching string key will be used.
+    ##
+    ## @param :as [Symbol]
+    ##   The expected return type. A best-effort attempt is made to convert the source String to the
+    ##   requested type. Valid "as" types are:
+    ##
+    ##   - `:string`
+    ##   - `:symbol`
+    ##   - `:boolean`
+    ##   - `:int` / `:integer`
+    ##   - `:float` / `:decimal` / `:number`
+    ##   - `:json`
+    ##   - `:array`
+    ##   - `:hash`
+    ##
+    def parse(value, as: nil)
+      value = if value.is_a? Symbol
+                ENV[value.to_s]
+              else
+                value.to_s
+              end
+
+      case as.to_sym
+      when :string then parse_string(value)
+      when :symbol then parse_symbol(value)
+      when :boolean then parse_boolean(value)
+      when :int, :integer then parse_integer(value)
+      when :float, :decimal, :number then parse_float(value)
+      when :json then parse_json(value)
+      when :array then parse_array(value)
+      when :hash then parse_hash(value)
+      else raise ArgumentError, "invalid `as` parameter: #{as.inspect}"
+      end
+    end
+
+    private
+
+    def parse_string(value)
+      value
+    end
+
+    def parse_symbol(value)
+      value.to_sym
+    end
+
+    def parse_boolean(value)
+      case value
+      when '', '0', 'f', 'false' then false
+      else true
+      end
+    end
+
+    def parse_integer(value)
+      value.to_i
+    end
+
+    def parse_float(value)
+      value.to_f
+    end
+
+    def parse_json(value)
+      require 'json'
+      require 'active_support/all'
+
+      return nil if value.nil? || (value == '')
+
+      decoded_json = JSON.parse(value, quirks_mode: true)
+      { decoded_json: decoded_json }.with_indifferent_access[:decoded_json]
+    end
+
+    def parse_array(value)
+      return [] if value.nil? || (value == '')
+
+      decoded_json = parse_json(value)
+      raise(ArgumentError, 'non-array value') unless decoded_json.is_a? Array
+
+      decoded_json
+    end
+
+    def parse_hash(value)
+      return {} if value.nil? || (value == '')
+
+      decoded_json = parse_json(value)
+      raise(ArgumentError, 'non-hash value') unless decoded_json.is_a? Hash
+
+      decoded_json
+    end
+  end
+end

metadata

@@ -0,0 +1,132 @@
+--- !ruby/object:Gem::Specification
+name: env_parser
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Nestor Custodio
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2017-11-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.0.0
+description: 
+email:
+- sakimorix@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".ruby-version"
+- ".travis.yml"
+- ".yardopts"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- docs/EnvParser.html
+- docs/_index.html
+- docs/class_list.html
+- docs/css/common.css
+- docs/css/full_list.css
+- docs/css/style.css
+- docs/file.README.html
+- docs/file_list.html
+- docs/frames.html
+- docs/index.html
+- docs/js/app.js
+- docs/js/full_list.js
+- docs/js/jquery.js
+- docs/method_list.html
+- docs/top-level-namespace.html
+- env_parser.gemspec
+- lib/env_parser.rb
+- lib/env_parser/version.rb
+homepage: https://github.com/nestor-custodio/env_parser
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.13
+signing_key: 
+specification_version: 4
+summary: A tool for painless parsing and validation of environment variables.
+test_files: []