envv 0.1.2 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 953e78210eb08257ab2065174ec9c946870786ad81e57326a90c2251c94109b1
-  data.tar.gz: fff4477832bba43454a33260009c54db61a28f2e1c69f896f587cba43f18c516
+  metadata.gz: 0a9575c3a4575817075da63460f3f825073b1cf60924bb15448b5942292aa5ee
+  data.tar.gz: 007112b9e413b0583ab1e62130c65d4901f3cf7aeecef643d85e5988714bb664
 SHA512:
-  metadata.gz: 88bad0d1f5902143100ca1ede91645dd2d1772f13553bc4861966a7c766e81cb55327551a4aaf7b88aa21252e47144940e2227562b49bbcc532767727ce81b43
-  data.tar.gz: 9b616de18bf3e179068dbc3104fad5b34252ab08ef2e938c2149c043c64f53759ba1e791a496dd219ca2437535751279859a9870b3bc18d08f6ac868239f617e
+  metadata.gz: 604ee5f6770bf4322c0a41dd835fdd7ac6d55cb7123624acf73ef8450e6a914a934c4cf0d5adfe6a49c9ba1c20fb7bbd7e6961994efedc359d43a38a84c1b9d0
+  data.tar.gz: d623fcec7868d59d7736cfe68222d6dcd40a132f4daf75e7dc8f993cb7017c5718fd8ba2390548f7dabd82aa53a046875993f4a37afa16cc659c97e1b3a11660

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [Unreleased]
 
+## [0.2.0] - 2023-09-25
+
+- Refactoring with a ENVV::Base module to allow writing custom wrappers  
+
+## [0.1.2] - 2023-09-19
+
+- Fix (again…) changelog_uri in gemspec
+
 ## [0.1.1] - 2023-09-19
 
 - Fix changelog_uri in gemspec

data/README.md

@@ -1,3 +1,5 @@
+[![Gem Version](https://badge.fury.io/rb/envv.svg)](https://badge.fury.io/rb/envv)
+
 ![ENVV banner](doc/banner.svg)
 
 # ENVV
@@ -53,6 +55,49 @@ ENVV.fetch("MY_INT_VAR") # ⇒ 4000
 ENVV.fetch("MY_BOOLEAN_VAR") # ⇒ true
 ```
 
+### Adding extra features with your own ENVV wrapper
+
+You can include [ENVV::Base](lib/envv/base.rb) in your own class or module and thus provide extra features.
+
+With a module
+
+```ruby
+module MyAppEnv
+  extend ENVV::Base
+
+  def is_dark?
+    fetch("IS_DARK")
+  end
+end
+
+MyAppEnv.build! do
+  required(:IS_DARK).filled(:bool)
+end
+
+# IS_DARK=True
+
+MyAppEnv.is_dark? # => true
+```
+
+With a class
+
+```ruby
+class MyAppEnv
+  include ENVV::Base
+
+  def [](key)
+    fetch(key)
+  end
+end
+
+e = MyAppEnv.new.build! do
+  required(:IS_DARK).filled(:bool)
+end
+e["IS_DARK"] # => true
+```
+
+Be creative !
+
 
 ## Development
 

data/lib/envv/base.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module ENVV
+  module Base
+    # Validates ENV vars with schema rules and store coerced values in ENVV registry
+    # @param [Proc] A block with Dry::Schema.Params rules
+    # @raise [ENVV::InvalidSchemaError] if env vars requirements are not validated
+    # @return [ENVV]
+    def build!(&rules)
+      rules or raise ArgumentError, <<~MESSAGE
+        A block of schema rules is required to build ENVV.
+            Example:
+
+              ENVV.build! do
+                required(:MY_STRING_VAR).filled(:string)
+                required(:MY_INT_VAR).filled(:integer, gt?: 3000)
+                required(:MY_BOOLEAN_VAR).filled(:bool)
+              end
+
+            More info:
+
+            - https://dry-rb.org/gems/dry-schema
+            - https://github.com/16/envv
+
+      MESSAGE
+
+      @schema = ::Dry::Schema.Params(&rules)
+      @registry = Builder.call(ENV, @schema)
+      freeze
+    end
+
+    # @raise [ENVV::NotBuilt] error if called before ENVV built (see #build!)
+    # @return [Dry::Schema.Params] used to validate environment variables
+    def schema
+      @schema
+    end
+
+    # @raise [ENVV::NotBuilt] error if called before ENVV built (see #build!)
+    # @return [ENVV::Registry] Hash-like instance created at build
+    def registry
+      @registry or raise(NotBuilt)
+    end
+
+    # Fetch a coerced environment variable.
+    #   This method use the same signature as Hash#fetch.
+    # @raise [KeyError] if `key` is not found and neither `default_value` nor a block was given.
+    # @overload fetch(key)
+    #   @param key [String, Symbol]
+    #   @return the value of the given `key` if found.
+    # @overload fetch(key, default_value)
+    #   @param key [String, Symbol]
+    #   @param default_value
+    #   @return `default_value` if `key` is not found and no block was given
+    # @overload fetch(key, &block)
+    #   @yields `key` to the block if `key` is not found and a block was given
+    #   @return the block's return value.
+    def fetch(key, default_value = nil, &block)
+      registry.fetch(key.to_s, default_value, &block)
+    end
+  end
+end

data/lib/envv/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ENVV
-  VERSION = "0.1.2"
+  VERSION = "0.2.0"
 end

data/lib/envv.rb

@@ -1,70 +1,12 @@
 # frozen_string_literal: true
 
-require "singleton"
 require "dry/schema"
 require_relative "envv/version"
 require_relative "envv/errors"
 require_relative "envv/registry"
 require_relative "envv/builder"
+require_relative "envv/base"
 
 module ENVV
-  module_function
-
-  # Validates ENV vars with schema rules and store coerced values in ENVV registry
-  # @param [Proc] A block with Dry::Schema.Params rules
-  # @raise [ENVV::InvalidSchemaError] if env vars requirements are not validated
-  # @return [ENVV]
-  def build!(&rules)
-    rules or raise ArgumentError, <<~MESSAGE
-      A block of schema rules is required to build ENVV.
-          Example:
-
-            ENVV.build! do
-              required(:MY_STRING_VAR).filled(:string)
-              required(:MY_INT_VAR).filled(:integer, gt?: 3000)
-              required(:MY_BOOLEAN_VAR).filled(:bool)
-            end
-
-          More info:
-
-          - https://dry-rb.org/gems/dry-schema
-          - https://github.com/16/envv
-
-    MESSAGE
-
-    @schema = ::Dry::Schema.Params(&rules)
-    @registry = Builder.call(ENV, @schema)
-    freeze
-  end
-
-  # @raise [ENVV::NotBuilt] error if called before ENVV built (see #build!)
-  # @return [Dry::Schema.Params] used to validate environment variables
-  def schema
-    @schema
-  end
-
-  # @raise [ENVV::NotBuilt] error if called before ENVV built (see #build!)
-  # @return [ENVV::Registry] Hash-like instance created at build
-  def registry
-    @registry or raise(NotBuilt)
-  end
-
-  # Fetch a coerced environment variable.
-  #   This method use the same signature as Hash#fetch.
-  # @raise [KeyError] if `key` is not found and neither `default_value` nor a block was given.
-  # @overload fetch(key)
-  #   @param key [String, Symbol]
-  #   @return the value of the given `key` if found.
-  # @overload fetch(key, default_value)
-  #   @param key [String, Symbol]
-  #   @param default_value
-  #   @return `default_value` if `key` is not found and no block was given
-  # @overload fetch(key, &block)
-  #   @yields `key` to the block if `key` is not found and a block was given
-  #   @return the block's return value.
-  def fetch(key, default_value = nil, &block)
-    registry.fetch(key.to_s, default_value, &block)
-  end
-
-  public :build!, :schema, :registry, :fetch
+  extend Base
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: envv
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors:
 - Fabrice Luraine
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-09-19 00:00:00.000000000 Z
+date: 2023-09-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-schema
@@ -110,6 +110,7 @@ files:
 - doc/banner.inkscape.svg
 - doc/banner.svg
 - lib/envv.rb
+- lib/envv/base.rb
 - lib/envv/builder.rb
 - lib/envv/errors.rb
 - lib/envv/registry.rb