denv 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f0944471b087e3b02a91ff4b3096812e0643b641
-  data.tar.gz: 86af88174173f473634b43cbabfcbb9dec6deca4
+  metadata.gz: e8dc02ec38953c284f7e3683d224f5eedbc73f63
+  data.tar.gz: b71b09fa0d21d8a24496a52e418b68bfbcef25ad
 SHA512:
-  metadata.gz: 83f3759e5d7ded69567d3fd1bfd7d7a742a393fced3c9124c1ac066ec91fda7abab6c7add2fe9026c79ec378be957f420f3979aaa3815b6a5cb070fa7aa68457
-  data.tar.gz: 863e6dc9d1c586dc8f00aff14cc28882bd7490ce02e510282c47b1411a61cce14d4b43b008df0186cb9bb57e1362c9108fa98933a502d947caa11bd923a67756
+  metadata.gz: b58bd7a2c6e6c0fd59780d072210c8bdf0403f07e3b3b1ad770a2ebabad35423862f13969e96431193e528a929d9a64c0d124362d4d072066d584013e2d44245
+  data.tar.gz: 4073d21e171d9b0d10801b29b940a897526ab7743f8a4b2380f360af9396c40873b6e3ea8f072e5545d00464310b17a30bea38fcc3e954e410f211361f83b47d

data/CHANGELOG.md

@@ -0,0 +1,4 @@
+# CHANGELOG.md for denv
+## 0.2.0
+- Behaves as over-write.
+- Add `Denv.build_env(filename)` to load and get env hash.

data/README.md

@@ -1,7 +1,12 @@
 # denv
+[![Build Status](https://travis-ci.org/taiki45/denv.svg?branch=master)](https://travis-ci.org/taiki45/denv) [![Gem Version](https://badge.fury.io/rb/denv.svg)](https://badge.fury.io/rb/denv)
+
 denv = dotenv + Docker envfile format
 
-No special treatments about shell meta characters (e.g. `$`).
+Loads environment variables to `ENV` from `.env` file.
+
+- No special treatments about shell meta characters (e.g. `$`).
+- Behaves as over-write.
 
 ## Usage
 Add this line to your application's Gemfile:
@@ -19,10 +24,21 @@ And then execute:
 $ bundle
 ```
 
-Then call `Denv.load` in your application initialization.
+Write your envfile at `.env`:
+
+```sh
+AWESOME_SERVICE_CREDENTIAL=xxxxxx
+ANOTHER_CREDENTIAL=xxxxxx
+```
+
+Then call `Denv.load` in your application initialization. Now you can refer env vars via `ENV`.
+
+```ruby
+puts ENV['AWESOME_SERVICE_CREDENTIAL'] #=> "xxxxxx"
+```
 
 ### Rails integration
-Denv automatically set initializer for your Rails application, so you only have to write gem dependency to your Gemfile.
+denv automatically sets initializer for your Rails application, so you only have to write gem dependency to your Gemfile.
 
 ## Development
 After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
@@ -30,7 +46,7 @@ After checking out the repo, run `bin/setup` to install dependencies. You can al
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
 ## Contributing
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/denv.
+Bug reports and pull requests are welcome on GitHub at https://github.com/taiki45/denv.
 
 
 ## License

data/denv.gemspec

@@ -8,7 +8,7 @@ Gem::Specification.new do |spec|
   spec.authors       = ['Taiki Ono']
   spec.email         = ['taiks.4559@gmail.com']
 
-  spec.summary       = %q{dotenv + Docker envfile. No special treatments about shell meta characters.}
+  spec.summary       = %q{Loads environment variables to `ENV` from `.env` file. No special treatments about shell meta characters.}
   spec.description   = spec.summary
   spec.homepage      = 'https://github.com/taiki45/denv'
   spec.license       = 'MIT'

data/lib/denv.rb

@@ -27,12 +27,28 @@ module Denv
 
     attr_accessor :callback
 
+    # Read from .env file and load vars into `ENV`.
+    # Default is over-write.
+    # @param [String] filename
+    # @return [Hash] env
     def load(filename = DEFAULT_ENV_FILENAME)
       filename = File.expand_path(filename.to_s)
       run_callback(filename) do
-        env = File.open(filename) {|f| Parser.new(f, filename).parse }
-        env.each {|k, v| ENV[k] ||= v }
+        build_env(filename).each {|k, v| ENV[k] = v }
       end
+    end
+
+    # Read from .env file and build env Hash.
+    # @param [String] filename
+    # @return [Hash] loaded environment variables
+    def build_env(filename)
+      open_file(filename) {|f| Parser.new(f, filename).parse }
+    end
+
+    private
+
+    def open_file(filename)
+      File.open(filename) {|f| yield f }
     rescue Errno::ENOENT
       raise NoSuchFileError.new(filename)
     end

data/lib/denv/rails.rb

@@ -12,9 +12,9 @@ module Denv
   class Railtie < ::Rails::Railtie
     DEFAULT_ENV_FILES = %w[.env.local .env.#{Rails.env} .env]
 
-    config.before_configuration { load }
+    config.before_configuration { load_env }
 
-    def load
+    def load_env
       DEFAULT_ENV_FILES.map {|name| root.join(name) }.select(&:exist?).each do |path|
         Denv.load(path)
       end
@@ -23,13 +23,5 @@ module Denv
     def root
       Rails.root || Pathname.new(ENV['RAILS_ROOT'] || Dir.pwd)
     end
-
-    # Brought from dotenv.
-    #
-    # Rails uses `#method_missing` to delegate all class methods to the
-    # instance, which means `Kernel#load` gets called here. We don't want that.
-    def self.load
-      instance.load
-    end
   end
 end

data/lib/denv/version.rb

@@ -1,3 +1,3 @@
 module Denv
-  VERSION = "0.1.0"
+  VERSION = '0.2.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: denv
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Taiki Ono
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-01-07 00:00:00.000000000 Z
+date: 2016-01-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -66,7 +66,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3'
-description: dotenv + Docker envfile. No special treatments about shell meta characters.
+description: Loads environment variables to `ENV` from `.env` file. No special treatments
+  about shell meta characters.
 email:
 - taiks.4559@gmail.com
 executables: []
@@ -76,6 +77,7 @@ files:
 - ".gitignore"
 - ".rspec"
 - ".travis.yml"
+- CHANGELOG.md
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -110,5 +112,6 @@ rubyforge_project:
 rubygems_version: 2.5.1
 signing_key: 
 specification_version: 4
-summary: dotenv + Docker envfile. No special treatments about shell meta characters.
+summary: Loads environment variables to `ENV` from `.env` file. No special treatments
+  about shell meta characters.
 test_files: []