env_control 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 54ba47c111ff32909e22570a446fce080e3bb125e79b4f169d43356d5d386017
+  data.tar.gz: d8c92caccb90d4bfb6761355a96a6d302216284828e275c26c0d023641ee65ae
+SHA512:
+  metadata.gz: afecf900b23cf3660dbd9734f6f6dbf2430010ca65198fc4324e89918175156563561e4a5431985777fb39b614eae590ef3ff7be626f5f3ea3a39ab7d2781dc0
+  data.tar.gz: '09696d656df4a917f9ec29f3f1ca0dbc5221d9e91fb18bfff6fd692bb6b548941547893fb73e9df1cbb77c6a84a1a8e5c102c34223bf653013c1fa11f5d3ce49'

data/Gemfile

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+gem "rspec"

data/Gemfile.lock

@@ -0,0 +1,27 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    diff-lcs (1.5.0)
+    rspec (3.11.0)
+      rspec-core (~> 3.11.0)
+      rspec-expectations (~> 3.11.0)
+      rspec-mocks (~> 3.11.0)
+    rspec-core (3.11.0)
+      rspec-support (~> 3.11.0)
+    rspec-expectations (3.11.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.11.0)
+    rspec-mocks (3.11.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.11.0)
+    rspec-support (3.11.0)
+
+PLATFORMS
+  x86_64-darwin-18
+  x86_64-darwin-21
+
+DEPENDENCIES
+  rspec
+
+BUNDLED WITH
+   2.3.7

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 V.G.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,230 @@
+# ENV variables contract
+
+> Keywords: #p20220707a #env #variable #contract #ruby #gem
+
+Ruby approach in creating contracts for ENV variables.
+
+## Why are contracts necessary?
+
+Having a contract for ENV vars gives you a number of new benefits:
+
+- You explicitly list all useful variables along with their requirements, so both your developers and devops know exactly which values are acceptable and which are not.
+- You prevent your app from starting if there is something wrong with the ENV variables. E.g., you never misuse a production adapter or database in a staging environment (see [best practices](#best-practices)).
+- You bring out the implicitly used ENV variables, revealing the hidden expectations of third-party gems. (As we often cannot change the logic of third-party gems, we're supposed to put up with inconsistency assigning, say, `"on"`/`"off"` to some ENV variables they require, `"true"`/`"false"` or `"true"`/`nil` to others, which makes working with ENV vars a poorly documented mess unless we have exposed it all in our contract).
+- You explicitly declare unused variables as `:deprecated`, `:irrelevant` or `:ignore`, leaving developers no question about the applicability of a particular variable.
+
+The larger your application, the more useful the ENV contract gets.
+
+## How to use
+
+After [installing](#how-to-install) this gem, define your contract:
+
+```ruby
+EnvControl.configuration.contract = {
+  MY_UUID_VAR: :uuid,
+  ...
+}
+```
+
+Then validate the ENV variables only *after* they are all set (manually or by [dotenv](https://github.com/bkeepers/dotenv) / [Figaro](https://github.com/laserlemon/figaro)):
+
+```ruby
+EnvControl.validate(ENV)
+```
+
+If the contract has been breached, the `#validate` method raises `EnvControl::BreachOfContractError` exception. This behavior can be [customized](#custom-validation-error-handler) to suit your needs.
+
+
+## Contract format explained
+
+Consider the following example:
+
+```ruby
+EnvControl.configuration.contract = {
+  ADMIN_EMAIL: :email,
+  DEBUG: ["true", nil],
+  LC_CTYPE: "UTF-8",
+  MY_VAR1: :string,
+  MY_VAR2: :bool,
+  MYSQL_DEBUG: :not_set, # same as nil
+  MYSQL_PWD: :deprecated,
+  RAILS_ENV: ["production", "development", "test"],
+  TMPDIR: :existing_file_path,
+}
+```
+
+The contract is a list of ENV variables and validators you have attached to them.
+
+Validators can be:
+- Symbols, that are essentially names of [built-in validators](#built-in-validators).
+- String literals that are exact values to compare the value with.
+- `nil`, which literally means "we expect this variable to be unset".
+- Custom callables (procs, lambdas, any objects that respond to `#call` method)
+- a combination of the above as an Array. In this case, the contract will be considered satisfied if *at least one* of the listed validators is satisfied.
+- [environment-specific](#environment-specific-contracts) contracts.
+
+
+It is allowed to mix validators of different types:
+
+```ruby
+EnvControl.configuration.contract = {
+  # Allowed values: "true" OR "false" OR "weekly" OR "daily" OR "hourly" OR nil
+  MY_RETRY: [:bool, "weekly", "daily", "hourly", nil],
+}
+```
+
+## Built-in validators
+
+The EnvControl gem contains several built-in validators that you can use in your contracts.
+
+Built-in validators are simply method names specified as symbols, e.g. `:string`, `:uuid`, `:email` etc.
+
+These methods take ENV variable as input argument and return 'true' or 'false' depending on its value.
+
+
+List of built-in validators:
+
+| Validator               | Acceptable values     | Comments                 |
+|-------------------------|-----------------------|--------------------------|
+| `:bool`                 | `"true"`, `"false"`   |                          |
+| `:string`               | any non-empty string  | `" "` considered empty   |
+| `:email`                | any e-mail address    |                          |
+| `:integer`              | any integer string    |                          |
+| `:hex`                  | hexadecimal numbers   |                          |
+| `:ignore`               | `nil` / any string    | Allows empty `""` value  |
+| `:empty`                | `nil` or empty string | Same as `[:not_set, ""]` |
+| `:irrelevant`           | `nil` / any string    | Synonym for `:ignore`    |
+| `:deprecated`           | `nil` (not set)       | Synonym for `nil`        |
+| `:not_set`              | `nil` (not set)       | Synonym for `nil`        |
+| `:uri`                  | any uri               |                          |
+| `:https_uri`            | any secure http uri   |                          |
+| `:postgres_uri`         | any postgres uri      |                          |
+| `:uuid`                 | UUID string           |                          |
+| `:existing_path`        | file or folder path   | Both files and dirs      |
+| `:existing_file_path`   | full file path        |                          |
+| `:existing_folder_path` | full folder path      |                          |
+
+You can [create your own](#custom-validators) validators if needed.
+
+**Important:** Validators only work with non-nil ENV variables. If the variable is not set (nil), the validator won't be called.
+
+## Environment-specific contracts
+
+TODO
+## Custom validators
+
+You can create your own validators. There are two approaches available.
+
+1. Callable objects. Validators of this kind must respond to the `#call` method, so they can be `Proc`s, `Lambda`s or custom objects.
+
+    ```ruby
+    class StrongPasswordValidator
+      def self.call(string)
+        string.match? A_STRONG_PASSWORD_REGEX
+      end
+    end
+
+    EnvControl.configuration.contract = {
+      DB_PASSWORD: [StrongPasswordValidator, :not_set],
+    }
+    ```
+
+2. Custom methods to extend `EnvControl::Validators` module. These methods can reuse existing validators, making "AND" logic available to you:
+
+    ```ruby
+    module MyContractValidators
+      def irc_uri(string)
+        uri(string) && URI(string).scheme.eql?("irc")
+      end
+    end
+
+    EnvControl::Validators.extend(MyContractValidators)
+
+    EnvControl.configuration.contract = {
+      IRC_CHANNEL: :irc_uri,
+      ...
+    }
+    ```
+
+## How to install
+
+```bash
+gem install env_control
+```
+
+or add the gem to your Gemfile and then run `bundle install`:
+
+```ruby
+# Gemfile
+gem "env_control"
+```
+
+## Configuration
+
+`EnvControl.configuration` is a configuration object that contains the default settings. You can set its attributes directly or within a block:
+
+```ruby
+require "env_control"
+
+EnvControl.configuration do |config|
+  config.environment_name = ...
+  config.contract = {...}
+  config.on_validation_error = MyContractErrorHander.new
+end
+
+EnvControl.validate(ENV)
+```
+
+Alternatively, you can provide/override contract using keyword attributes in `#validate` method:
+
+```ruby
+EnvControl.validate(
+  ENV,
+  environment_name: "review",
+  contract: contract,
+  on_validation_error: MyContractErrorHander.new,
+)
+```
+
+### Custom validation error handler
+TODO
+
+### environment_name
+TODO
+### contract
+TODO
+### validators_allowing_nil
+TODO
+### on_validation_error
+TODO
+## Best practices
+
+1. Maintain the ENV contract up to date so that other developers can use it as a source of truth about the ENV variables requirements. Feel free to add comments to the contract.
+2. Keep the contract keys alphabetically sorted or group the keys by sub-systems of your application.
+3. Keep the contract as permissive as you can. Avoid putting sensitive string literals.
+4. Some validators like `:deprecated` are effectively equivalent to `nil`. Give them preference when you need to accompany a requirement to have a variable unset with an appropriate reason.
+5. Add `:deprecated` to existing validators before proceeding to remove code that uses the variable., e.g.:
+    ```ruby
+    MY_VAR: [:deprecated, :string]
+    ```
+
+6. Consider defining "virtual" environments via `environment_name=` without introducing them to the application. This may be useful if you, say, need to run your review app in "production" environment but with a more restricted ENV contract:
+
+    ```ruby
+      EnvControl.configuration do |config|
+        config.environment_name = \
+          if [ENV['RAILS_ENV'], ENV['REVIEW']] == ['production', 'true']
+            'review' # virtual production-like environment
+          else
+            ENV['RAILS_ENV']
+          end
+
+        config.contract = {
+          S3_BUCKET: {
+            "production" => :string,
+            "review" => "qa_bucket", # safe bucket
+            "default" => :not_set
+          }
+        }
+      end
+    ````

data/envcontrol.gemspec

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require_relative "lib/env_control/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "env_control"
+  spec.version       = EnvControl::VERSION
+  spec.authors       = ["Vladimir Gorodulin"]
+  spec.email         = ["ru.hostmaster@gmail.com"]
+  spec.description   = %q{Contract for ENV variables}
+  spec.summary       = %q{Contract for ENV variables}
+  spec.homepage      = "https://github.com/gorodulin/env_control"
+  spec.license       = "MIT"
+
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.7.0")
+
+  spec.metadata = {
+    "changelog_uri"     => "https://github.com/gorodulin/env_control/CHANGELOG.md",
+    "homepage_uri"      => spec.homepage,
+    "source_code_uri"   => "https://github.com/gorodulin/env_control",
+  }
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path("..", __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { _1.match(%r{^(bin/|spec/|config/|\.)}) }
+  end
+
+  spec.require_paths = ["lib"]
+  spec.add_development_dependency "rspec", "~> 3.2"
+  spec.add_development_dependency "pry"
+  spec.add_development_dependency "guard-rspec", "~> 4.7"
+end

data/lib/env_control/configuration.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require "singleton"
+
+module EnvControl
+  class Configuration
+    include Singleton
+
+    attr_accessor :on_validation_error, :validators_allowing_nil
+    attr_reader :contract, :environment_name
+
+    DEFAULT_BREACH_HANDLER = lambda do |report|
+      fail BreachOfContractError.new(context: { report: report })
+    end
+
+    def initialize
+      @contract = {}
+      @on_validation_error = DEFAULT_BREACH_HANDLER
+      @validators_allowing_nil = [:deprecated, :empty, :ignore, :irrelevant, :not_set]
+    end
+
+    def contract=(hash)
+      unless hash.respond_to?(:each_pair)
+        raise ArgumentError, "Argument (#{hash.inspect}) must respond to #each_pair"
+      end
+      @contract = hash
+    end
+
+    def environment_name=(name)
+      @environment_name = name.respond_to?(:call) ? name.call&.to_s : name&.to_s
+
+      raise ArgumentError, "Non-empty string or nil expected" if @environment_name == ""
+    end
+
+  end
+end

data/lib/env_control/errors.rb

@@ -0,0 +1,64 @@
+
+module EnvControl
+
+  class Error < StandardError
+    def initialize(msg = nil, context:)
+      super(details(context))
+    end
+  end
+
+  class BreachOfContractError < Error
+    MSG = "Some ENV variables breach the contract: %s"
+
+    def details(context)
+      MSG % [context[:report].inspect]
+    end
+  end
+
+  class EnvironmentNameNotConfiguredError < Error
+    MSG = "Can't pick environment-specific contract for %s variable. " +
+          "EnvControl.configuration.environment_name is not set."
+
+    def details(context)
+      MSG % [context[:env_var]]
+    end
+  end
+
+  class NonStringEnvironmentNameError < Error
+    MSG = "Not a String key %s (%s) for %s contract"
+
+    def details(context)
+      MSG % [
+        context[:environment_name].inspect,
+        context[:environment_name].class.inspect,
+        context[:env_var],
+      ]
+    end
+  end
+
+  class WrongValueError < Error
+    MSG = "Wrong value: %s (%s) for %s contract (%s environment)"
+
+    def details(context)
+      MSG % [
+        context[:value].inspect,
+        context[:value].class.inspect,
+        context[:env_var],
+        context[:environment_name] || "any"
+      ]
+    end
+  end
+
+  class NonSymbolicKeyError < Error
+    MSG = "Not a Symbol key %s (%s) for %s contract"
+
+    def details(context)
+      MSG % [
+        context[:key].inspect,
+        context[:key].class.inspect,
+        context[:env_var],
+      ]
+    end
+  end
+
+end

data/lib/env_control/get_environment_specific_contract.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module EnvControl
+  class GetEnvironmentSpecificContract
+
+    def call(env_var:, contracts:, environment_name:)
+      unless environment_name
+        raise EnvironmentNameNotConfiguredError.new(context: { env_var: env_var })
+      end
+
+      @contracts = contracts
+
+      contract_for(environment_name) || contract_for("default")
+    end
+
+    private
+
+    def contract_for(environment_name)
+      return nil unless @contracts.has_key?(environment_name)
+
+      contract = @contracts[environment_name]
+      contract.is_a?(Array) ? contract : [contract]
+    end
+
+  end
+end

data/lib/env_control/validate_env_contract.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module EnvControl
+  class ValidateEnvContract
+
+    def call(contract:)
+      contract.each_pair do |env_var_name, env_var_contract|
+        @env_var = env_var_name
+        validate_key!(env_var_name)
+        if env_var_contract.is_a?(Hash)
+          validate_environment_specific_contract!(env_var_contract)
+        else
+          validate_contract!(env_var_contract)
+        end
+      end
+    end
+
+    private
+
+    attr_reader :env_var, :environment_name
+
+    def validate_environment_specific_contract!(hash)
+      raise_wrong_value!(hash) if hash.empty?
+      hash.each_pair do |environment_name, contract|
+        unless environment_name.is_a?(String)
+          raise NonStringEnvironmentNameError.new(context: {environment_name: environment_name, env_var: env_var})
+        end
+        @environment_name = environment_name
+        validate_contract!(contract)
+      end
+      @environment = nil
+    end
+
+    def validate_contract!(value)
+      if value.is_a?(Array)
+        raise_wrong_value!(value) if value.empty?
+        value.each { |subvalue| validate_value!(subvalue) }
+      else
+        validate_value!(value)
+      end
+    end
+
+    def validate_key!(key)
+      return if key.is_a?(Symbol)
+
+      raise NonSymbolicKeyError.new(context: { key: key, env_var: env_var })
+    end
+
+    def validate_value!(value)
+      if [Symbol, String, NilClass].include?(value.class) || value.respond_to?(:call)
+        true
+      else
+        raise_wrong_value!(value)
+      end
+    end
+
+    def raise_wrong_value!(value)
+      raise WrongValueError.new context: { value: value, env_var: env_var, environment_name: environment_name }
+    end
+  end
+end

data/lib/env_control/validate_env_variable.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module EnvControl
+  class ValidateEnvVariable
+
+    def call(name, value, contract)
+      raise ArgumentError unless [String, NilClass].include?(value.class)
+
+      [contract].flatten.each do |validator|
+        return true if satisfies?(name, value, validator)
+      end
+      false
+    end
+
+    private
+
+    def satisfies?(name, value, validator)
+      case validator
+      when NilClass
+        value.nil?
+      when String
+        value == validator
+      when Symbol
+        run_validator(validator, name, value)
+      else
+        raise "unknown validator type: #{validator.inspect}" unless validator.respond_to?(:call)
+        run_callable_validator(validator, name, value)
+      end
+    end
+
+    def run_callable_validator(validator, name, value)
+      return false if value.nil?
+
+      validator.call(value)
+    end
+
+    def run_validator(validator, name, value)
+      unless library.respond_to?(validator)
+        raise "unknown validator #{validator.inspect} for #{name} variable"
+      end
+
+      if value.nil?
+        return EnvControl.configuration.validators_allowing_nil.include?(validator) ? true : false
+      end
+
+      library.send(validator, value)
+    end
+
+    def library
+      @library ||= EnvControl::Validators
+    end
+
+  end
+end

data/lib/env_control/validate_env_variables.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module EnvControl
+  class ValidateEnvVariables
+
+    def call(contract:, env:, environment_name:)
+      failures = {}
+      contract.each do |env_var, var_contracts|
+        if environment_specific?(var_contracts)
+          var_contract = GetEnvironmentSpecificContract.new.call(env_var: env_var, contracts: var_contracts, environment_name: environment_name)
+        else
+          var_contract = as_array(var_contracts)
+        end
+        next unless var_contract # No environment-specific contract found
+        var_value = env.fetch(env_var.to_s, nil)
+        next if contract_honoured?(env_var, var_value, var_contract)
+
+        failures[env_var] = var_contract
+      end
+      failures
+    end
+
+    private
+
+    def contract_honoured?(env_var, var_value, var_contract)
+      ValidateEnvVariable.new.call(env_var, var_value, var_contract)
+    end
+
+    def as_array(value)
+      value.is_a?(Array) ? value : [value] # Wraps nil (in contrast to Array.wrap)
+    end
+
+    def environment_specific?(var_contract)
+      var_contract.respond_to?(:has_key?)
+    end
+
+  end
+end

data/lib/env_control/validators.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module EnvControl
+  module Validators
+    class << self
+
+      def bool(val)
+        ["true", "false"].include?(val)
+      end
+
+      def email(string)
+        string.match?(URI::MailTo::EMAIL_REGEXP)
+      end
+
+      def empty(string)
+        string == ""
+      end
+
+      def existing_file_path(path)
+        File.file?(path)
+      end
+
+      def existing_folder_path(path)
+        Dir.exists?(path)
+      end
+
+      def existing_path(path)
+        File.exists?(path)
+      end
+
+      def https_uri(string)
+        uri(string) && URI(string).scheme.eql?("https")
+      end
+
+      def ignore(string)
+        true
+      end
+
+      def integer(string)
+        string.match?(/\A[-]{,1}\d+\z/)
+      end
+
+      def irrelevant(string)
+        true
+      end
+
+      def not_set(value)
+        false
+      end
+
+      alias_method :deprecated, :not_set
+
+      def postgres_uri(string)
+        uri(string) && URI(string).scheme.eql?("postgres")
+      end
+
+      def string(val)
+        val.strip.size > 0
+      end
+
+      def uri(string)
+        string.match?(/\A#{URI::regexp}\z/)
+      end
+
+      def uuid(string)
+        string.match?(/\A[0-9a-f]{8}-[0-9a-f]{4}-[0-5][0-9a-f]{3}-[089ab][0-9a-f]{3}-[0-9a-f]{12}\z/i)
+      end
+
+      def hex(string)
+        string.match?(/\A[a-f0-9]+\z/i)
+      end
+
+    end
+  end
+end

data/lib/env_control/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module EnvControl
+  VERSION = "0.1.0"
+end

data/lib/env_control.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require "forwardable"
+
+module EnvControl
+
+  autoload(:BreachOfContractError,              "env_control/errors.rb")
+  autoload(:Configuration,                      "env_control/configuration.rb")
+  autoload(:EnvironmentNameNotConfiguredError,  "env_control/errors.rb")
+  autoload(:GetEnvironmentSpecificContract,     "env_control/get_environment_specific_contract.rb")
+  autoload(:NonStringEnvironmentNameError,      "env_control/errors.rb")
+  autoload(:NonSymbolicKeyError,                "env_control/errors.rb")
+  autoload(:ValidateEnvContract,                "env_control/validate_env_contract.rb")
+  autoload(:ValidateEnvVariable,                "env_control/validate_env_variable.rb")
+  autoload(:ValidateEnvVariables,               "env_control/validate_env_variables.rb")
+  autoload(:Validators,                         "env_control/validators.rb")
+  autoload(:VERSION,                            "env_control/version.rb")
+  autoload(:WrongValueError,                    "env_control/errors.rb")
+
+  def self.configuration
+    yield Configuration.instance if block_given?
+    Configuration.instance
+  end
+
+  def self.validate(
+      env,
+      contract: configuration.contract,
+      environment_name: configuration.environment_name,
+      on_error: configuration.on_validation_error
+    )
+    ValidateEnvContract.new.call(contract: contract)
+    ValidateEnvVariables.new.call(env: env, contract: contract, environment_name: environment_name).tap do |report|
+      return on_error.call(report) if on_error && report.any?
+    end
+  end
+
+end

metadata

@@ -0,0 +1,102 @@
+--- !ruby/object:Gem::Specification
+name: env_control
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Vladimir Gorodulin
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2022-08-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: pry
+  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: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.7'
+description: Contract for ENV variables
+email:
+- ru.hostmaster@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- envcontrol.gemspec
+- lib/env_control.rb
+- lib/env_control/configuration.rb
+- lib/env_control/errors.rb
+- lib/env_control/get_environment_specific_contract.rb
+- lib/env_control/validate_env_contract.rb
+- lib/env_control/validate_env_variable.rb
+- lib/env_control/validate_env_variables.rb
+- lib/env_control/validators.rb
+- lib/env_control/version.rb
+homepage: https://github.com/gorodulin/env_control
+licenses:
+- MIT
+metadata:
+  changelog_uri: https://github.com/gorodulin/env_control/CHANGELOG.md
+  homepage_uri: https://github.com/gorodulin/env_control
+  source_code_uri: https://github.com/gorodulin/env_control
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.7
+signing_key:
+specification_version: 4
+summary: Contract for ENV variables
+test_files: []