envied 0.7.2 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: edcedc4d8c20ce9daebc7a4850197705ea88e0d1
-  data.tar.gz: 76db142dc7ae98934704145a788617b2c62948f0
+  metadata.gz: 3da0d6e67da927a774c498a1042d5ee27b3ee3f9
+  data.tar.gz: 9dadd80c4f668ddb1990d0f8837b730db4ecd54c
 SHA512:
-  metadata.gz: cd8ca76d1dda0a489be8b5c97ddf2d4c75a3e10a8eafe9d64a14c00432b40025948f62f782069228b64029494fb8544ea9b9c9e11ac02c96f032feb51132949d
-  data.tar.gz: 3e523db66a464e6b3a236908f5439d38d877aa6cf867ad5754e7555b1e20edb99e2f6f15f3757026c999d8cc7e43b550212a4ea0fa940bb1b9734fc1ea7cfdb7
+  metadata.gz: c2ef13db6f79e0590da7a86217c5b5b50b4b72b993f4a6b7711feffbccf8a285e9ec20743b2fd7859e901bc495dc13623b8068446ac0664e954687eba1b6f0fd
+  data.tar.gz: d5eaf03debc9c15d30360d8ee7c2fd75dae3cbac6d92d8cd72e9adc82c8be477a8a661532e24a54d435998da5de128a013c8c1a2af38f9cd49f9f8813b97623d

data/CHANGELOG.md

@@ -1,98 +1,136 @@
-# 0.7.2 / 2014-9-7
+## 0.8.0 / 2014-10-04
 
-## Added:
-* extract-task: see all ENV-variables used in your project.
+### Added
 
-  ```bash
-  $ bin/envied extract
-  Found 63 occurrences of 45 variables:
-  BUNDLE_GEMFILE
-  * config/boot.rb:4
-  * config/boot.rb:6
-  ...
-  ```
+ * the `check:heroku:binstub` task uses ENV['HEROKU_APP'] as app-option if present
+ * the `check` and `check:heroku` task now have a `--quiet` option
 
-* version-task (i.e. bin/envied --version)
+    This prevents output on STDOUT for a successful check.  
+    Handy for wrapper-scripts:
 
-# 0.7.1 / 2014-08-29
+        # some bash-script 'ensure-env'
+        #!/usr/bin/env bash
+        bundle exec envied check --quiet --groups default && $@
 
-* Total refactor (TM).
+        $ ./ensure-env echo 'works!'
+        works!
 
-* Fix bug in Heroku binstub.
+ * ENVied.require accepts string with groups, e.g. 'default,production'
 
-  It checked for group 'default,production' instead of 'default' and 'production'.
+    This way it's possible to easily require groups using the ENV:
 
-# 0.7.0 / 2014-08-24
+        # config/initializers/envied.rb
+        ENVied.require(*ENV['ENVIED_GROUPS'] || Rails.groups)
 
-* Add init:rails-task for setup in Rails applications.
+        $ ENVIED_GROUPS='default,production' bin/rails server
 
-# 0.6.3 / 2014-08-22
+### Fixed
 
-* Fix bug: 'false' was not a coercible value.
+ * extract-task would report at most one variable per line of code.
+ * extract-task would not extract variable names with digits
 
-# 0.6.2 / 2014-08-20
+### Deprecated
 
-* Add `envied check:heroku` to do a check on your Heroku app.
+ * titlecase variable types. Use downcased instead: `variable :PORT, :integer`
 
-* Add `envied check:heroku:binstub` to generate script for convenient 'check:heroku'
+### Removed
 
-# 0.6.1 / 2014-08-13
+ * extract: test/spec-folder are no longer part of the default globs.
 
-* Add `envied check` to check whether defined variables are present and valid.
+    Use the option `--tests` to include it:
 
-# 0.6.0 / 2014-08-13
+        $ bundle exec envied extract --tests
 
-* The configuration now lives in `Envfile` by default.
+## 0.7.2 / 2014-09-07
 
-# 0.5.0 / 2014-07-02
+### Added
 
-* add Array Hash types
+ * extract-task: see all ENV-variables used in your project.
 
-  ```ruby
-  # in env.rb
-  ENVied.configure { variable :TAGS, :Array; variable :HASH, :Hash }
-  ENVied.require
+        $ envied extract
+        Found 63 occurrences of 45 variables:
+        BUNDLE_GEMFILE
+        * config/boot.rb:4
+        * config/boot.rb:6
+        ...
 
-  $ HASH=a=1&b=2 TAGS=tag1,tag2 ruby -renvied -r./env.rb -e 'p ENVied.TAGS'
-  # ["tag1", "tag2"]
-  $ HASH='a=1&b=2' TAGS=tag1,tag2 ruby -renvied -r./env.rb -e 'p ENVied.HASH'
-  # {'a' => '1', 'b' => '2'}
-  ```
+ * version-task (i.e. bin/envied --version)
 
-# 0.4.0 / 2014-05-16
+## 0.7.1 / 2014-08-29
 
-* groups added
+ * Total refactor (TM).
 
-  This allows for more fine-grained requiring.  
-  See the section in the [README](https://github.com/eval/envied/tree/v0.4.0#groups).
+ * Fix bug in Heroku binstub.
 
-* configuring is now simpler:
+    It checked for group 'default,production' instead of 'default' and 'production'.
 
-  ```ruby
-  ENVied.configure { variable :RACK_ENV }
-  # vs
-  ENVied.configure {|env| env.variable :RACK_ENV }
-  ```
+## 0.7.0 / 2014-08-24
 
-* Deprecate `require!`. Use `require` instead.
+ * Add init:rails-task for setup in Rails applications.
 
-  Just like requiring groups with Bundler.
+## 0.6.3 / 2014-08-22
 
-* Deprecate lowercase methods for uppercase ENV-variables.
+ * Fix bug: 'false' was not a coercible value.
 
-  `ENV['RACK_ENV']` is no longer accessible as `ENVied.rack_env`, only as `ENVied.RACK_ENV`.  
-  This is not only what you would expect, but it also reduces the chance of clashing with existing class-methods.
+## 0.6.2 / 2014-08-20
 
-# 0.3.0 / 2014-03-14
+ * Add `envied check:heroku` to do a check on your Heroku app.
 
-* defaults need to be enabled explicitly:
+ * Add `envied check:heroku:binstub` to generate script for convenient 'check:heroku'
 
-  `ENVied.configure(enable_defaults: Rails.env.development?) { ... }`
+## 0.6.1 / 2014-08-13
 
-# 0.2.0 / 2014-03-14
+ * Add `envied check` to check whether defined variables are present and valid.
 
-* add defaults
+## 0.6.0 / 2014-08-13
 
-# 0.1.0 / 2014-03-13
+ * The configuration now lives in `Envfile` by default.
 
-* add defaults
+## 0.5.0 / 2014-07-02
+
+ * add Array Hash types
+
+        # in env.rb
+        ENVied.configure { variable :TAGS, :Array; variable :HASH, :Hash }
+        ENVied.require
+
+        $ HASH=a=1&b=2 TAGS=tag1,tag2 ruby -renvied -r./env.rb -e 'p ENVied.TAGS'
+        # ["tag1", "tag2"]
+        $ HASH='a=1&b=2' TAGS=tag1,tag2 ruby -renvied -r./env.rb -e 'p ENVied.HASH'
+        # {'a' => '1', 'b' => '2'}
+
+## 0.4.0 / 2014-05-16
+
+ * groups added
+
+    This allows for more fine-grained requiring.  
+    See the section in the [README](https://github.com/eval/envied/tree/v0.4.0#groups).
+
+ * configuring is now simpler:
+
+        ENVied.configure { variable :RACK_ENV }
+        # vs
+        ENVied.configure {|env| env.variable :RACK_ENV }
+
+ * Deprecate `require!`. Use `require` instead.
+
+    Just like requiring groups with Bundler.
+
+ * Deprecate lowercase methods for uppercase ENV-variables.
+
+    `ENV['RACK_ENV']` is no longer accessible as `ENVied.rack_env`, only as `ENVied.RACK_ENV`.  
+    This is not only what you would expect, but it also reduces the chance of clashing with existing class-methods.
+
+## 0.3.0 / 2014-03-14
+
+ * defaults need to be enabled explicitly:
+
+    `ENVied.configure(enable_defaults: Rails.env.development?) { ... }`
+
+## 0.2.0 / 2014-03-14
+
+ * add defaults
+
+## 0.1.0 / 2014-03-13
+
+ * add defaults

data/README.md

@@ -17,7 +17,7 @@
   * [Groups](#groups)
   * [Defaults](#defaults)
   * [More examples](#more-examples)
-* [Rails](#rails)
+* [Rails](#rails--spring)
 * [Command-line interface](#command-line-interface)
 * [Testing](#testing)
 * [Developing](#developing)
@@ -31,8 +31,8 @@ After [successful installation](#installation), define some variables in `Envfil
 
 ```ruby
 # file: Envfile
-variable :FORCE_SSL, :Boolean
-variable :PORT, :Integer
+variable :FORCE_SSL, :boolean
+variable :PORT, :integer
 ```
 
 ### 2) Check for presence and coercibility
@@ -79,14 +79,14 @@ Add this line to your application's Gemfile:
 
 The following types are supported:
 
-* `:String` (implied)
-* `:Boolean` (e.g. '0'/'1', 'f'/'t', 'false'/'true', 'off'/'on', 'no'/'yes' for resp. false and true)
-* `:Integer`
-* `:Symbol`
-* `:Date` (e.g. '2014-3-26')
-* `:Time` (e.g. '14:00')
-* `:Hash` (e.g. 'a=1&b=2' becomes `{'a' => '1', 'b' => '2'}`)
-* `:Array` (e.g. 'tag1,tag2' becomes `['tag1', 'tag2']`)
+* `:string` (implied)
+* `:boolean` (e.g. '0'/'1', 'f'/'t', 'false'/'true', 'off'/'on', 'no'/'yes' for resp. false and true)
+* `:integer`
+* `:symbol`
+* `:date` (e.g. '2014-3-26')
+* `:time` (e.g. '14:00')
+* `:hash` (e.g. 'a=1&b=2' becomes `{'a' => '1', 'b' => '2'}`)
+* `:array` (e.g. 'tag1,tag2' becomes `['tag1', 'tag2']`)
 
 ### Groups
 
@@ -95,10 +95,10 @@ It's similar to groups in a Gemfile:
 
 ```ruby
 # file: Envfile
-variable :FORCE_SSL, :Boolean
+variable :FORCE_SSL, :boolean
 
 group :production do
-  variable :NEW_RELIC_LICENSE_KEY
+  variable :SECRET_KEY_BASE
 end
 ```
 
@@ -106,7 +106,15 @@ end
 # For local development you would typically do:
 ENVied.require(:default) #=> Only ENV['FORCE_SSL'] is required
 # On the production server:
-ENVied.require(:default, :production) #=> ...also ENV['NEW_RELIC_LICENSE_KEY'] is required
+ENVied.require(:default, :production) #=> ...also ENV['SECRET_KEY_BASE'] is required
+
+# You can also pass it a string with the groups separated by comma's:
+ENVied.require('default, production')
+
+# This allows for easily requiring groups using the ENV:
+ENVied.require(ENV['ENVIED_GROUPS'])
+# ...then from the prompt:
+$ ENVIED_GROUPS='default,production' bin/rails server
 
 # BTW the following are equivalent:
 ENVied.require
@@ -134,16 +142,17 @@ Please remember that ENVied only **reads** from ENV; it doesn't mutate ENV.
 Don't let setting a default for, say `RAILS_ENV`, give you the impression that `ENV['RAILS_ENV']` is set.  
 As a rule of thumb you should only use defaults:
 * for local development
-* for ENV-variables that your application introduces (i.e. for `ENV['STAFF_EMAILS']` not for `ENV['REDIS_URL']`)
+* for ENV-variables that are solely used by your application (i.e. for `ENV['STAFF_EMAILS']`, not for `ENV['RAILS_ENV']`)
 
 ### More examples
 
 * See the [examples](/examples)-folder for a more extensive Envfile
-* See [the Envfile](https://github.com/eval/bunny_drain/blob/c54d7d977afb5e23a92da7a2fd0d39f6a7e29bf1/Envfile) for the bunndy_drain application
+* See [the Envfile](https://github.com/eval/bunny_drain/blob/c54d7d977afb5e23a92da7a2fd0d39f6a7e29bf1/Envfile) for the bunny_drain application
 
-## Rails
+## Rails & Spring
 
-**tl;dr** use the `init:rails`-task to generate the necessary files for a Rails app (see [installation](#installation)).
+**tl;dr** use the `init:rails`-task to generate the necessary files for a Rails app (see [installation](#installation)).  
+Remember: the environment as seen by Spring is not up-to-date until *after* initialization - this is good enough for checking the environment, but too late to use it to configure your app.
 
 ---
 
@@ -173,9 +182,10 @@ If you want to change Rails' config based on ENV-variables you should put this i
 ```ruby
 # config/initializers/envied.rb as generated by 'bundle exec envied init:rails'
 ENVied.springify do
-  ENVied.require(:default, ENV['RAILS_ENV'])
+  ENVied.require(*ENV['ENVIED_GROUPS'] || Rails.groups)
 
-  Rails.configuration.force_ssl = ENVied.FORCE_SSL
+  # Put any initialization based on ENV-variables below, e.g.:
+  # Rails.configuration.force_ssl = ENVied.FORCE_SSL
 end
 ```
 
@@ -184,30 +194,30 @@ end
 ```bash
 $ envied help
 Commands:
-  envied --version             # Shows version number
-  envied check                 # Checks whether you environment contains the defined variables
-  envied check:heroku          # Checks whether a Heroku config contains the defined variables
-  envied check:heroku:binstub  # Generates a shell script for the check:heroku-task
-  envied extract               # Shows candidate variables (i.e. occurences of ENV['X'])
-  envied help [COMMAND]        # Describe available commands or one specific command
-  envied init                  # Generates a default Envfile in the current working directory
-  envied init:rails            # Generate all files needed for a Rails project
+  envied check                   # Checks whether you environment contains required variables
+  envied check:heroku            # Checks whether a Heroku config contains required variables
+  envied check:heroku:binstub    # Generates a shell script for the check:heroku-task
+  envied extract                 # Grep code to find ENV-variables
+  envied help [COMMAND]          # Describe available commands or one specific command
+  envied init                    # Generates a default Envfile in the current working directory
+  envied init:rails              # Generate all files needed for a Rails project
+  envied version, --version, -v  # Shows version number
 ```
 
 ## Testing
 
 ```bash
-bundle install --binstubs
+bundle install
 
-bin/rspec
+bundle exec rspec
 # or
-bin/rake
+bundle exec rake
 ```
 
 ## Developing
 
 ```bash
-bin/pry --gem
+bundle exec pry --gem
 ```
 
 ## Contributing

data/examples/extensive_envfile

@@ -10,10 +10,10 @@ enable_defaults!(&not_production_nor_ci)
 # we want it to be present though; heck, we're using it in this file!
 variable :RACK_ENV
 
-variable :FORCE_SSL, :Boolean, default: false
-variable :PORT, :Integer, default: 3000
+variable :FORCE_SSL, :boolean, default: false
+variable :PORT, :integer, default: 3000
 # generate the default value using the value of PORT:
-variable :PUBLIC_HOST_WITH_PORT, :String, default: proc {|envied| "localhost:#{envied.PORT}" }
+variable :PUBLIC_HOST_WITH_PORT, :string, default: proc {|envied| "localhost:#{envied.PORT}" }
 
 group :production do
   variable :MAIL_PAAS_USERNAME
@@ -27,7 +27,7 @@ end
 group :not_ci do
   # CI needs no puma-threads, and sidekiq-stuff etc.
   # Define that here:
-  variable :MIN_THREADS, :Integer, default: 1
+  variable :MIN_THREADS, :integer, default: 1
   # more...
 end
 

data/lib/envied.rb

@@ -38,7 +38,8 @@ class ENVied
   end
 
   def self.required_groups(*groups)
-    result = groups.compact
+    splitter = ->(group){ group.is_a?(String) ? group.split(/ *, */) : group }
+    result = groups.compact.map(&splitter).flatten
     result.any? ? result.map(&:to_sym) : [:default]
   end
 

data/lib/envied/cli.rb

@@ -6,16 +6,26 @@ class ENVied
     include Thor::Actions
     source_root File.expand_path('../templates', __FILE__)
 
-    desc "--version", "Shows version number"
+    desc "version, --version, -v", "Shows version number"
     def version
       puts ENVied::VERSION
     end
     map %w(-v --version) => :version
 
-    desc "extract", "Shows candidate variables (i.e. occurences of ENV['X'])"
+    desc "extract", "Grep code to find ENV-variables"
+    long_desc <<-LONG
+      Greps source-files to find all ENV-variables your code is using.
+
+      This task helps you find variables to put in your Envfile.
+
+      By default the test/spec-folders are excluded. Use `--tests` to include them.
+    LONG
     option :globs, type: :array, default: ENVied::EnvVarExtractor.defaults[:globs], banner: "*.* lib/*"
+    option :tests, type: :boolean, default: false, desc: "include tests/specs"
     def extract
-      var_occurences = ENVied::EnvVarExtractor.new(globs: options[:globs]).extract
+      globs = options[:globs]
+      globs << "{test,spec}/*" if options[:tests]
+      var_occurences = ENVied::EnvVarExtractor.new(globs: globs).extract
 
       puts "Found %d occurrences of %d variables:" % [var_occurences.values.flatten.size, var_occurences.size]
       var_occurences.sort.each do |var, occs|
@@ -29,13 +39,20 @@ class ENVied
 
     desc "init", "Generates a default Envfile in the current working directory"
     def init
-      puts "Writing new Envfile to #{File.expand_path('Envfile')}"
+      puts "Writing Envfile to #{File.expand_path('Envfile')}"
       template("Envfile.tt")
+
+      puts <<-INIT
+Add the following snippet (or similar) to your app's initialization:
+ENVied.require(*ENV['ENVIED_GROUPS'] || [:default, ENV['RACK_ENV']])
+INIT
     end
 
     desc "init:rails", "Generate all files needed for a Rails project"
     define_method "init:rails" do
-      init
+      puts "Writing Envfile to #{File.expand_path('Envfile')}"
+      template("Envfile.tt")
+
       template("rails-initializer.tt", 'config/initializers/envied.rb')
     end
 
@@ -47,9 +64,12 @@ class ENVied
       Else the missing/invalid variables will be shown, and the process will exit with status 1.
     LONG
     option :groups, type: :array, default: %w(default), banner: 'default production'
+    option :quiet, type: :boolean, desc: 'Communicate success of the check only via the exit status.'
     def check
       ENVied.require(*options[:groups])
-      puts "All variables for group(s) #{options[:groups]} are present and valid"
+      unless options[:quiet]
+        puts "All variables for group(s) #{options[:groups]} are present and valid"
+      end
     end
 
     desc "check:heroku", "Checks whether a Heroku config contains required variables"
@@ -61,12 +81,13 @@ class ENVied
 
       heroku config | bundle exec envied check:heroku
 
-      It's more convenient to generate a shell script using the check:heroku:binstub-task.
+      Use the check:heroku:binstub-task to turn this into a bash-script.
 
       On success the process will exit with status 0.
       Else the missing/invalid variables will be shown, and the process will exit with status 1.
     LONG
     option :groups, type: :array, default: %w(default production), banner: 'default production'
+    option :quiet, type: :boolean, desc: 'Communicate success of the check only via the exit status.'
     define_method "check:heroku" do
       if STDIN.tty?
         error <<-ERR
@@ -81,7 +102,9 @@ ERR
       end]
       ENV.replace({}).update(heroku_env)
       ENVied.require(*options[:groups])
-      puts "All variables for group(s) #{options[:groups]} are present and valid in your Heroku app"
+      unless options[:quiet]
+        puts "All variables for group(s) #{options[:groups]} are present and valid in your Heroku app"
+      end
     end
 
     desc "check:heroku:binstub", "Generates a shell script for the check:heroku-task"
@@ -91,14 +114,16 @@ ERR
       The same as the check:heroku-task, but all in one script (no need to pipe `heroku config` to it etc.).
 
     LONG
-    option :dest, banner: "where to put the script", default: 'bin/heroku-env-check'
-    option :app, banner: "name of Heroku app"
+    option :dest, banner: "where to put the script", desc: "Default: bin/<app>-env-check or bin/heroku-env-check"
+    option :app, banner: "name of Heroku app", desc: "uses ENV['HEROKU_APP'] as default if present", default: ENV['HEROKU_APP']
     option :groups, type: :array, default: %w(default production), banner: 'default production'
     define_method "check:heroku:binstub" do
       require 'fileutils'
       @app = options[:app]
-      @dest = @app ? File.join(*%W(bin #{@app}-env-check)) : options[:dest]
+      @dest = options[:dest]
+      @dest ||= File.join(*%W(bin #{(@app || 'heroku')}-env-check))
       @groups = options[:groups]
+
       full_dest = File.expand_path(@dest)
       template("heroku-env-check.tt", full_dest)
       FileUtils.chmod 0755, full_dest

data/lib/envied/env_var_extractor.rb

@@ -4,7 +4,7 @@ class ENVied
       @defaults ||= begin
         {
           extensions: %w(ru thor rake rb yml ruby yaml erb builder markerb haml),
-          globs: %w(*.* Thorfile Rakefile {app,config,db,lib,script,test,spec}/*)
+          globs: %w(*.* Thorfile Rakefile {app,config,db,lib,script}/*)
         }
       end
     end
@@ -13,19 +13,6 @@ class ENVied
       self.class.defaults
     end
 
-    def self.env_var_re
-      @env_var_re ||= begin
-        /^[^\#]*           # not matching comments
-          ENV
-          (?:              # non-capture...
-            \[['"] |       # either ENV['
-            \.fetch\(['"]  # or ENV.fetch('
-          )
-          ([a-zA-Z_]+)     # capture variable name
-        /x
-      end
-    end
-
     attr_reader :globs, :extensions
 
     def initialize(options = {})
@@ -37,6 +24,22 @@ class ENVied
       new(options.merge(globs: Array(globs))).extract
     end
 
+    # Greps all ENV-variables from non-comment-parts of line.
+    # Captures 'A' in lines like `ENV['A']`, but also `ENV.fetch('A')`.
+    #
+    # @param line [String] the line to grep
+    #
+    # @example
+    #   extractor.new.capture_variables("config.force_ssl = ENV['FORCE_SSL']")
+    #   # => ["FORCE_SSL"]
+    #   extractor.new.capture_variables("# comment about ENV['FORCE_SSL']")
+    #   # => []
+    #
+    # @return [Array<String>] the names o
+    def capture_variables(line)
+      noncomment, _ = line.split("#", 2)
+      noncomment.scan(/ENV(?:\[|\.fetch\()['"]([^'"]+)['"]/).flatten
+    end
 
     # Extract all keys recursively from files found via `globs`.
     # Any occurence of `ENV['A']` or `ENV.fetch('A')` in code (not in comments), will result
@@ -61,8 +64,8 @@ class ENVied
             results.merge!(extract("#{item}/*"))
           else
             next unless extensions.detect {|ext| File.extname(item)[ext] }
-            File.readlines(item, :encoding=>"UTF-8").each_with_index do |line, ix|
-              if variable = line[self.class.env_var_re, 1]
+            File.readlines(item).each_with_index do |line, ix|
+              capture_variables(line).each do |variable|
                 results[variable] << { :path => item, :line => ix.succ }
               end
             end

data/lib/envied/templates/Envfile.tt

@@ -1,8 +1,8 @@
 # A sample Envfile
 # enable_defaults! { ENV['RACK_ENV'] != 'production' }
 
-# variable :REDIS_URL, :String, default: 'redis://localhost:6379'
+# variable :REDIS_URL, :string, default: 'redis://localhost:6379'
 #
 # group :production do
-#   variable :MAIL_PASS_USERNAME, :String
+#   variable :SECRET_KEY_BASE
 # end

data/lib/envied/templates/rails-initializer.tt

@@ -1,5 +1,6 @@
 ENVied.springify do
-  ENVied.require(:default, ENV['RAILS_ENV'])
+  ENVied.require(*ENV['ENVIED_GROUPS'] || Rails.groups)
+
   # Put any initialization based on ENV-variables below, e.g.:
   # Rails.configuration.force_ssl = ENVied.FORCE_SSL
 end

data/lib/envied/version.rb

@@ -1,3 +1,3 @@
 class ENVied
-  VERSION = '0.7.2'
+  VERSION = '0.8.0'
 end

data/spec/env_var_extractor_spec.rb

@@ -0,0 +1,24 @@
+require 'spec_helper'
+
+describe ENVied::EnvVarExtractor do
+
+  describe "#capture_variables" do
+    def capture_variables(text)
+      described_class.new.capture_variables(text)
+    end
+
+    {
+      %{self.a = ENV['A']} => %w(A),
+      %{self.a = ENV["A"]} => %w(A),
+      %{self.a = ENV.fetch("A")]} => %w(A),
+      %{self.a = ENV.fetch("A")]} => %w(A),
+      %{# self.a = ENV["A"]} => %w(),
+      %{self.a = ENV["A"] && self.b = ENV["B"]} => %w(A B),
+      %{self.a = ENV["A3"]} => %w(A3)
+    }.each do |line, expected|
+      it "captures #{expected} from #{line.inspect}" do
+        expect(capture_variables(line)).to contain_exactly(*expected)
+      end
+    end
+  end
+end

data/spec/envied_spec.rb

@@ -198,6 +198,28 @@ describe ENVied do
     end
 
     describe "groups" do
+      describe 'requiring' do
+        it 'yields :default when nothing passed to require' do
+          envied_require
+          expect(ENVied.env.groups).to eq [:default]
+        end
+
+        it 'yields groupnames passed to it as string' do
+          envied_require('bar')
+          expect(ENVied.env.groups).to eq [:bar]
+        end
+
+        it 'yields groupnames passed to it as symbols' do
+          envied_require(:foo)
+          expect(ENVied.env.groups).to eq [:foo]
+        end
+
+        it 'yields the groups passed via a string with groupnames' do
+          envied_require('foo,bar')
+          expect(ENVied.env.groups).to eq [:foo, :bar]
+        end
+      end
+
       context 'a variable in a group' do
         before do
           configure do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: envied
 version: !ruby/object:Gem::Version
-  version: 0.7.2
+  version: 0.8.0
 platform: ruby
 authors:
 - Gert Goet
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-09-07 00:00:00.000000000 Z
+date: 2014-10-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: coercible
@@ -126,6 +126,7 @@ files:
 - lib/envied/version.rb
 - spec/coercer_spec.rb
 - spec/configuration_spec.rb
+- spec/env_var_extractor_spec.rb
 - spec/envied_spec.rb
 - spec/spec_helper.rb
 - spec/variable_spec.rb
@@ -149,13 +150,14 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.0
+rubygems_version: 2.4.2
 signing_key: 
 specification_version: 4
 summary: Ensure presence and type of ENV-variables
 test_files:
 - spec/coercer_spec.rb
 - spec/configuration_spec.rb
+- spec/env_var_extractor_spec.rb
 - spec/envied_spec.rb
 - spec/spec_helper.rb
 - spec/variable_spec.rb