dotenvious 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 7f3d8233b6bd8144495af0638e41cf3b14fa65db
+  data.tar.gz: 18506bfd293ac3125816db78052fed52dd85660a
+SHA512:
+  metadata.gz: 26a1170e357207a78f1ecfb5a8881e0ca1a462b0db643ba7e1dff023eec89b38d3cad3b60f26297d76439aa44c578e0843a260cf5cbf2719b63a38f80e3fe479
+  data.tar.gz: cc93d31e8d2ac1cec5e6b47e9bb033d0b993b5f99647b284488dfa4ccb3320be2366fd524a16f042cb623603d75246c778b05eac8a8d2fd6e5d8659366ca72b5

data/.gitignore

@@ -0,0 +1,5 @@
+.dotenvious
+.env
+.example-env
+.envious
+dotenvious-*.gem

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://www.rubygems.org'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,41 @@
+PATH
+  remote: .
+  specs:
+    dotenvious (0.0.0)
+
+GEM
+  remote: https://www.rubygems.org/
+  specs:
+    coderay (1.1.1)
+    diff-lcs (1.2.5)
+    method_source (0.8.2)
+    pry (0.10.3)
+      coderay (~> 1.1.0)
+      method_source (~> 0.8.1)
+      slop (~> 3.4)
+    rspec (3.3.0)
+      rspec-core (~> 3.3.0)
+      rspec-expectations (~> 3.3.0)
+      rspec-mocks (~> 3.3.0)
+    rspec-core (3.3.2)
+      rspec-support (~> 3.3.0)
+    rspec-expectations (3.3.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.3.0)
+    rspec-mocks (3.3.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.3.0)
+    rspec-support (3.3.0)
+    slop (3.6.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.3)
+  dotenvious!
+  pry
+  rspec (>= 3.0)
+
+BUNDLED WITH
+   1.12.5

data/README.md

@@ -0,0 +1,41 @@
+# Dotenvious
+
+A gem to manage .env dependencies.
+
+Your `.env` file gets jealous when `.example-env` has keys that it does not. Dotenvious helps `.env` get back on the right track.
+
+This gem exists to solve the following workflow:
+
+Imagine you're working at a small to mid-size team in a startup whose architecture is constantly evolving. In a fast-moving startup, environment variable may change rapidly.
+
+If you're working on one team within a larger application, environment variables may be added to your codebase that you might know were added, some of which may break the application's code after pulling from your updated repository.
+
+Dotenvious solves this problem. See that your most recent pull breaks Rails on startup? Run dotenvious and it will present to you the new variables that were added - and give you the option to immediately add them to your `.env` file.
+
+Dotenvious eliminates the pain of manually parsing through a newly changed `.example-env` file to see which new breaking variables have been added.
+
+## Getting Started
+
+
+
+## What You Need
+
+This gem compares the variables set in your `.env` file with what exists in `.example-env`. The gem includes a CLI which walks you through the variables missing in `.env` but present in `.example-env`.
+
+Currently, this gem relies on [Dotenv](https://github.com/bkeepers/dotenv) to load dependencies from ENV.
+
+## Future Work
+
+- [ ] Figure out how to incorporate in rakefile
+
+- [x] Compare keys already present in both files but with different values
+
+- [ ] Ability to choose which development `.env-*` file to load from
+
+- [ ] Persist user's individual choices in a `.dotenvious` file in directory
+
+- [ ] Option to always run on boot after recent pull from master
+
+- [ ] Auto create `.envious` with user specified options if not exists
+
+- [ ] More things are always on the horizon!

data/bin/dotenvious

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+
+require "dotenvious"
+Dotenvious::CLI.new.run

data/dotenvious.gemspec

@@ -0,0 +1,19 @@
+Gem::Specification.new do |s|
+  s.name        = 'dotenvious'
+  s.version     = '0.0.1'
+  s.date        = '2016-09-10'
+  s.summary     = "Dotenvious"
+  s.description = "A dotenv wrapper to manage variables"
+  s.authors     = ["Jake Faris"]
+  s.email       = 'jakefaris@outlook.com'
+  s.files       = `git ls-files`.split($/)
+  s.executables = ['dotenvious']
+  s.homepage    =
+    'http://rubygems.org/gems/dotenvious'
+  s.license       = 'MIT'
+
+  s.add_development_dependency 'bundler', '~> 1.3'
+  s.add_development_dependency 'rspec', '~> 3.0'
+  s.add_development_dependency 'pry', '~> 0.10'
+
+end

data/lib/dotenvious/cli.rb

@@ -0,0 +1,44 @@
+require_relative 'loaders/environments'
+require_relative 'missing_variable_finder'
+require_relative 'prompter'
+require_relative 'loaders/configuration'
+require 'pry'
+module Dotenvious
+  class CLI
+    def initialize
+      #figure out which file - for now can just look .env.example or .example-env
+      @filename = '.example-env' # or .env-example
+    end
+
+    def run
+      Loaders::Configuration.new.load
+      Loaders::Environments.new(filename).load_envs
+      unless all_vars_present? && all_vars_match?
+        alert_user
+        decision = STDIN.gets.strip
+        Prompter.run if decision.downcase == 'y'
+      end
+    end
+
+    private
+
+    attr_reader :filename
+
+    def alert_user
+      puts "You have missing ENV variables. Examime them? [y/n]"
+    end
+
+    def all_vars_present?
+      !MissingVariableFinder.required_vars_missing?
+    end
+
+    def all_vars_match?
+      !MismatchedVariableFinder.mismatched_vars?
+    end
+
+    def abort
+      abort_message = 'Hold up! Your .env file is green with envy towards .example-env. You should update it.'
+      super abort_message
+    end
+  end
+end

data/lib/dotenvious/configuration.rb

@@ -0,0 +1,39 @@
+require 'pry'
+module Dotenvious
+  class Configuration
+
+    class ConfigurationError < StandardError; end
+
+    def initialize
+      yield self if block_given?
+    end
+
+    def example_file=(filename)
+      raise ConfigurationError if not_string?(filename)
+      CONFIG[:example_file] = filename
+    end
+
+    def custom_variables=(vars)
+      raise ConfigurationError unless all_caps_array?(vars)
+      CONFIG[:custom_variables] = vars
+    end
+
+    def optional_variables=(vars)
+      raise ConfigurationError unless all_caps_array?(vars)
+      CONFIG[:optional_variables] = vars
+    end
+
+    private
+
+    def not_string?(filename)
+      filename.class != String
+    end
+
+    def all_caps_array?(vars)
+      vars.class == Array &&
+      vars.all? do |var|
+        var.class == String && var.upcase == var
+      end
+    end
+  end
+end

data/lib/dotenvious/env_appender.rb

@@ -0,0 +1,15 @@
+module Dotenvious
+  class EnvAppender
+    def append(key)
+      env.write("#{key}=#{ENV_EXAMPLE[key]}\n")
+    end
+
+    private
+
+    attr_reader :env
+
+    def env
+      @env ||= File.open('.env', 'a+')
+    end
+  end
+end

data/lib/dotenvious/loaders/configuration.rb

@@ -0,0 +1,27 @@
+require 'pry'
+require_relative '../configuration'
+module Dotenvious
+  module Loaders
+    class Configuration
+      def load
+        load_config if config_file_present?
+      end
+
+      private
+
+      attr_reader :file
+
+      def load_config
+        Kernel.load dotenvious
+      end
+
+      def dotenvious
+        Dir.pwd + '/.envious'
+      end
+
+      def config_file_present?
+        File.file?(dotenvious)
+      end
+    end
+  end
+end

data/lib/dotenvious/loaders/env.rb

@@ -0,0 +1,11 @@
+module Dotenvious
+  module Loaders
+    class Env < Environment
+      private
+
+      def environment
+        Dotenvious::ENV
+      end
+    end
+  end
+end

data/lib/dotenvious/loaders/environment.rb

@@ -0,0 +1,28 @@
+module Dotenvious
+  module Loaders
+    class Environment
+      def initialize(filename)
+        @filename = filename
+      end
+
+      def load
+        #took from Dotenv source code whoops
+        file.each do |line|
+          environment[$1] = $2 if line =~ /\A([\w_]+)=(.*)\z/
+        end
+      end
+
+      private
+
+      def environment
+        raise "environment must be defined in child class"
+      end
+
+      def file
+        File.read(@filename).split("\n")
+      end
+
+      attr_reader :filename
+    end
+  end
+end

data/lib/dotenvious/loaders/environments.rb

@@ -0,0 +1,22 @@
+require_relative 'example'
+require_relative 'env'
+
+module Dotenvious
+  module Loaders
+    class Environments
+
+      def initialize(filename)
+        @filename = filename
+      end
+
+      def load_envs
+        Env.new('.env').load
+        Example.new(filename).load
+      end
+
+      private
+
+      attr_reader :filename
+    end
+  end
+end

data/lib/dotenvious/loaders/example.rb

@@ -0,0 +1,13 @@
+require_relative 'environment'
+
+module Dotenvious
+  module Loaders
+    class Example < Environment
+      private
+
+      def environment
+        Dotenvious::ENV_EXAMPLE
+      end
+    end
+  end
+end

data/lib/dotenvious/mismatched_variable_finder.rb

@@ -0,0 +1,22 @@
+module Dotenvious
+  class MismatchedVariableFinder
+    def self.mismatched_vars?
+      mismatched_vars.any?
+    end
+
+    def self.mismatched_vars
+      keys.select do |key|
+        ENV_EXAMPLE.has_key?(key) && ENV_EXAMPLE[key] != ENV[key]
+      end
+    end
+
+    private
+
+    def self.keys
+      return ENV.keys if CONFIG[:custom_variables].nil?
+      ENV.keys.reject do |key|
+        CONFIG[:custom_variables].include?(key)
+      end
+    end
+  end
+end

data/lib/dotenvious/missing_variable_finder.rb

@@ -0,0 +1,23 @@
+module Dotenvious
+  class MissingVariableFinder
+    def self.required_vars_missing?
+      missing_required_vars.any?
+    end
+
+    def self.missing_required_vars
+      keys.reject do |key|
+        ENV.has_key?(key)
+      end
+    end
+
+    private
+
+    def self.keys
+      all_keys = Dotenvious::ENV_EXAMPLE.keys
+      return all_keys if CONFIG[:optional_variables].nil?
+      all_keys.reject do |key|
+        CONFIG[:optional_variables].include?(key)
+      end
+    end
+  end
+end

data/lib/dotenvious/prompter.rb

@@ -0,0 +1,54 @@
+require_relative 'value_replacer'
+require_relative 'mismatched_variable_finder'
+require_relative 'prompter'
+require_relative 'env_appender'
+
+module Dotenvious
+  class Prompter
+    def self.run
+      keys_in_question.each do |key, status|
+        decision = prompt(key, status)
+        return if decision == 'q'
+        next unless decision.downcase == 'y'
+
+        if status == 'missing'
+          EnvAppender.new.append(key)
+        elsif status == 'mismatched'
+          ValueReplacer.new.replace(key)
+        end
+      end
+    end
+
+    private
+
+    def self.keys_in_question
+      missing_keys = missing_vars.zip(['missing'] * missing_vars.length)
+      mismatched_keys = mismatched_vars.zip(['mismatched'] * mismatched_vars.length)
+      missing_keys + mismatched_keys
+    end
+
+    def self.missing_vars
+      MissingVariableFinder.missing_required_vars
+    end
+
+    def self.mismatched_vars
+      MismatchedVariableFinder.mismatched_vars
+    end
+
+    def self.prompt(var, status)
+      send(:"display_#{status}_output", var)
+      STDIN.gets.strip
+    end
+
+    def self.display_missing_output(var)
+      puts "#{var}=#{ENV_EXAMPLE[var]}"
+      puts "Add to .env? [y/n/q]"
+    end
+
+    def self.display_mismatched_output(var)
+      puts "ENV[#{var}] is set to: #{ENV[var]}"
+      puts "Example [#{var}] is set to: #{ENV_EXAMPLE[var]}"
+      puts "Replace with the example value? [y/n/q]"
+    end
+  end
+end

data/lib/dotenvious/value_replacer.rb

@@ -0,0 +1,24 @@
+module Dotenvious
+  class ValueReplacer
+    def replace(key)
+      line_number = base_env.find_index do |line|
+        line.match(/^#{key}=/)
+      end
+      updated_env = base_env.dup
+      updated_env[line_number] = "#{key}=#{ENV_EXAMPLE[key]}"
+      env_writer.write(updated_env.join("\n"))
+    end
+
+    private
+
+    attr_reader :base_env
+
+    def base_env
+      @base_env ||= File.read('.env').split("\n")
+    end
+
+    def env_writer
+      File.open('.env', 'w')
+    end
+  end
+end

data/lib/dotenvious.rb

@@ -0,0 +1,7 @@
+module Dotenvious
+  ENV = {}
+  ENV_EXAMPLE = {}
+  CONFIG = {}
+end
+
+require_relative 'dotenvious/cli'

data/spec/dotenvious/cli_spec.rb

@@ -0,0 +1,47 @@
+require 'spec_helper'
+
+describe Dotenvious::CLI do
+  describe '.new' do
+    xit 'determines the correct file to use as example' do
+      # future release work
+    end
+  end
+
+  describe '#run' do
+    it 'loads the environment & example environment variables' do
+      expect_any_instance_of(Dotenvious::Loaders::Environments).to receive(:load_envs)
+
+      described_class.new.run
+    end
+
+    context 'when there are ENV vars missing' do
+      context 'and the user wants to append them' do
+        it 'begins the Prompter' do
+          io_object = double
+          expect(STDIN).to receive(:gets).and_return('y')
+          expect_any_instance_of(described_class).to receive(:all_vars_present?).and_return false
+          expect(Dotenvious::Prompter).to receive(:run)#.and_return false
+          described_class.new.run
+        end
+      end
+      context 'but the user does not care' do
+        it 'quits' do
+          expect(STDIN).to receive(:gets).and_return('n')
+          expect_any_instance_of(described_class).to receive(:all_vars_present?).and_return false
+          expect(Dotenvious::Prompter).not_to receive(:run)#.and_return false
+
+          described_class.new.run
+        end
+      end
+    end
+
+    context 'when there are no ENV vars missing or mismatched' do
+      it 'does nothing' do
+        expect_any_instance_of(described_class).to receive(:all_vars_present?).and_return true
+        expect_any_instance_of(described_class).to receive(:all_vars_match?).and_return true
+
+        expect { described_class.new.run }.to_not raise_error
+      end
+    end
+  end
+end

data/spec/dotenvious/configuration_spec.rb

@@ -0,0 +1,84 @@
+require 'spec_helper'
+
+describe Dotenvious::Configuration do
+  before(:each) do
+    stub_const('Dotenvious::CONFIG', {} )
+  end
+  describe '#example_file=' do
+    it 'sets :example_file in CONFIG' do
+      described_class.new do |config|
+        config.example_file = 'test_file.txt'
+      end
+
+      expect(Dotenvious::CONFIG[:example_file]).to eq 'test_file.txt'
+    end
+
+    it 'only accepts a string' do
+      expect do
+        described_class.new do |config|
+          config.example_file = 1
+        end
+      end.to raise_error Dotenvious::Configuration::ConfigurationError
+    end
+  end
+
+  describe '#custom_variables=' do
+    it 'sets :custom_variables in CONFIG' do
+      described_class.new do |config|
+        config.custom_variables = %w(TEST VARS)
+      end
+
+      expect(Dotenvious::CONFIG[:custom_variables]).to eq ['TEST', 'VARS']
+    end
+
+    it 'only accepts an array of all caps strings' do
+      expect do
+        described_class.new do |config|
+          config.custom_variables = 'idk'
+        end
+      end.to raise_error Dotenvious::Configuration::ConfigurationError
+
+      expect do
+        described_class.new do |config|
+          config.custom_variables = [:symbol]
+        end
+      end.to raise_error Dotenvious::Configuration::ConfigurationError
+
+      expect do
+        described_class.new do |config|
+          config.custom_variables = ['lower', 'case']
+        end
+      end.to raise_error Dotenvious::Configuration::ConfigurationError
+    end
+  end
+
+  describe '#optional_variables=' do
+    it 'sets :optional_variables in CONFIG' do
+      described_class.new do |config|
+        config.optional_variables = %w(TEST VARS)
+      end
+
+      expect(Dotenvious::CONFIG[:optional_variables]).to eq ['TEST', 'VARS']
+    end
+
+    it 'only accepts an array of all caps strings' do
+      expect do
+        described_class.new do |config|
+          config.optional_variables = 'idk'
+        end
+      end.to raise_error Dotenvious::Configuration::ConfigurationError
+
+      expect do
+        described_class.new do |config|
+          config.optional_variables = [:symbol]
+        end
+      end.to raise_error Dotenvious::Configuration::ConfigurationError
+
+      expect do
+        described_class.new do |config|
+          config.optional_variables = ['lower', 'case']
+        end
+      end.to raise_error Dotenvious::Configuration::ConfigurationError
+    end
+  end
+end

data/spec/dotenvious/env_appender_spec.rb

@@ -0,0 +1,19 @@
+require 'spec_helper'
+
+describe Dotenvious::EnvAppender do
+  describe '#append' do
+    before do
+      stub_const('Dotenvious::ENV', { 'test' => 'example' } )
+      stub_const('Dotenvious::ENV_EXAMPLE', { 'test' => 'example', 'test2' => 'example2' } )
+    end
+    it 'appends the value to the end of the .env file' do
+      env_double = double('File', write: nil)
+      expect(env_double).to receive(:write).with("test2=example2\n")
+      expect(File).to receive(:open).
+        with('.env', 'a+').once.
+        and_return(env_double)
+
+      described_class.new.append('test2')
+    end
+  end
+end

data/spec/dotenvious/loaders/configuration_spec.rb

@@ -0,0 +1,28 @@
+require 'spec_helper'
+
+describe Dotenvious::Loaders::Configuration do
+  describe '#load' do
+    let(:filepath) { Dir.pwd + '/.envious' }
+    context 'when ./.envious is present' do
+      before do
+        allow(File).to receive(:file?).with(filepath).and_return true
+      end
+      it 'loads the file' do
+        expect(Kernel).to receive(:load).with(filepath)
+
+        described_class.new.load
+      end
+    end
+
+    context 'when ./.envious is not present' do
+      before do
+        allow(File).to receive(:file?).with(filepath).and_return false
+      end
+      it 'does nothing' do
+        expect(Kernel).not_to receive(:require)
+
+        described_class.new.load
+      end
+    end
+  end
+end

data/spec/dotenvious/loaders/env_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+
+describe Dotenvious::Loaders::Env do
+  describe '.new' do
+    it 'takes one argument' do
+      expect{ described_class.new('test') }.to_not raise_error
+    end
+  end
+
+  describe '#load' do
+    it 'loads files from its .new argument' do
+      expect(File).to receive(:read).with('test').and_return ""
+
+      described_class.new('test').load
+    end
+
+    it 'passes those arguments to Dotenvious::ENV_EXAMPLE' do
+      expect(File).to receive(:read).and_return "TEST=123\nEXAMPLE=234"
+
+      described_class.new('test').load
+
+      expect(Dotenvious::ENV['TEST']).to eq '123'
+      expect(Dotenvious::ENV['EXAMPLE']).to eq '234'
+    end
+  end
+end

data/spec/dotenvious/loaders/environments_spec.rb

@@ -0,0 +1,18 @@
+require 'spec_helper'
+
+describe Dotenvious::Loaders::Environments do
+  describe '#initialize' do
+    it 'takes 1 argument' do
+      expect { described_class.new('test') }.to_not raise_error
+    end
+  end
+
+  describe '#load_envs' do
+    it 'loads from Dotenv as well as Loaders::Example' do
+      expect_any_instance_of(Dotenvious::Loaders::Example).to receive(:load)
+      expect_any_instance_of(Dotenvious::Loaders::Env).to receive(:load)
+
+      described_class.new('test').load_envs
+    end
+  end
+end

data/spec/dotenvious/loaders/example_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+
+describe Dotenvious::Loaders::Example do
+  describe '.new' do
+    it 'takes one argument' do
+      expect{ described_class.new('test') }.to_not raise_error
+    end
+  end
+
+  describe '#load' do
+    it 'loads files from its .new argument' do
+      expect(File).to receive(:read).with('test').and_return ""
+
+      described_class.new('test').load
+    end
+
+    it 'passes those arguments to Dotenvious::ENV_EXAMPLE' do
+      expect(File).to receive(:read).and_return "TEST=123\nEXAMPLE=234"
+
+      described_class.new('test').load
+
+      expect(Dotenvious::ENV_EXAMPLE['TEST']).to eq '123'
+      expect(Dotenvious::ENV_EXAMPLE['EXAMPLE']).to eq '234'
+    end
+  end
+end

data/spec/dotenvious/mismatched_variable_finder_spec.rb

@@ -0,0 +1,41 @@
+require 'spec_helper'
+
+describe Dotenvious::MismatchedVariableFinder do
+  describe '.mismatched_vars' do
+    before do
+      stub_const('Dotenvious::ENV', {'test' => 'test_value', 'test_2' => 'same'} )
+      stub_const('Dotenvious::ENV_EXAMPLE', {'test_2' => 'different', 'test_3' => 'test_value'} )
+    end
+    context 'without custom configuration' do
+      it 'returns array of keys whose values are mismatched ENV & ENV_EXAMPLE' do
+        expect(described_class.mismatched_vars).to match_array(['test_2'])
+      end
+    end
+
+    context 'with custom configuration' do
+      before do
+        stub_const('Dotenvious::ENV', {'TEST' => 'same', 'TEST_2' => 'some_value'} )
+        stub_const('Dotenvious::ENV_EXAMPLE', {'TEST' => 'different', 'TEST_2' => 'different_value'} )
+        stub_const('Dotenvious::CONFIG', { custom_variables: ['TEST'] } )
+      end
+
+      it 'ignores vars specified in CONFIG[:custom_variables]' do
+        expect(described_class.mismatched_vars).to match_array(['TEST_2'])
+      end
+    end
+  end
+
+  describe '.mismatched_vars?' do
+    it 'returns true if mismatched_vars are present' do
+      expect(described_class).to receive(:mismatched_vars).and_return(['asdf'])
+
+      expect(described_class.mismatched_vars?).to be true
+    end
+
+    it 'returns false if mismatched_vars are not present' do
+      expect(described_class).to receive(:mismatched_vars).and_return([])
+
+      expect(described_class.mismatched_vars?).to be false
+    end
+  end
+end

data/spec/dotenvious/missing_variable_finder_spec.rb

@@ -0,0 +1,46 @@
+require 'spec_helper'
+
+describe Dotenvious::MissingVariableFinder do
+  describe '.missing_required_vars' do
+    before(:each) do
+      stub_const('Dotenvious::ENV', {'TEST' => 'same'} )
+      stub_const('Dotenvious::ENV_EXAMPLE', {'TEST' => 'different', 'TEST_2' => 'value', 'TEST_3' => 'missing_value'} )
+    end
+    context 'with custom configuration' do
+      before do
+        stub_const('Dotenvious::CONFIG', { optional_variables: ['TEST_3'] } )
+      end
+
+      it 'ignores vars specified in CONFIG[:custom_variables]' do
+        expect(described_class.missing_required_vars).to match_array(['TEST_2'])
+      end
+    end
+
+    context 'without custom configuration' do
+      it 'specifies any ENV_EXAMPLE vars that are missing from ENV' do
+        expect(described_class.missing_required_vars).to match_array(['TEST_2', 'TEST_3'])
+      end
+    end
+  end
+
+  describe '.required_vars_missing?' do
+    context 'given a loaded ENV and ENV_EXAMPLE' do
+      before(:each) do
+        stub_const('Dotenvious::ENV_EXAMPLE', {'test' => "123", 'example' => "234"} )
+      end
+      context 'where ENV has all variables' do
+        it 'returns false' do
+          allow(described_class).to receive(:missing_required_vars).and_return([])
+          expect(described_class.required_vars_missing?).to eq false
+        end
+      end
+
+      context 'where ENV is missing variables' do
+        it 'returns true' do
+          allow(described_class).to receive(:missing_required_vars).and_return(['test'])
+          expect(described_class.required_vars_missing?).to eq true
+        end
+      end
+    end
+  end
+end

data/spec/dotenvious/prompter_spec.rb

@@ -0,0 +1,32 @@
+require 'spec_helper'
+
+describe Dotenvious::Prompter do
+  describe '.run' do
+    before(:each) do
+      stub_const('Dotenvious::ENV', { 'test' => nil } )
+      stub_const('Dotenvious::ENV_EXAMPLE', {'test' => nil, 'test2' => nil, 'test3' => nil} )
+      # expect(Dotenvious::ENV).to receive(:keys).and_return(['test'])
+      # expect(Dotenvious::ENV_EXAMPLE).to receive(:keys).and_return(['test', 'test2', 'test3'])
+    end
+    it 'prompts the user to add every missing or mismatched variable do' do
+      expect(STDIN).to receive(:gets).twice.and_return('n')
+
+      described_class.run
+    end
+
+    it 'appends the vars to .env' do
+      expect(STDIN).to receive(:gets).twice.and_return('y','n')
+      expect(File).to receive(:open).
+        with('.env', 'a+').once.
+        and_return(double('File', write: nil))
+
+      described_class.run
+    end
+
+    it 'quits out if the user presses q' do
+      expect(STDIN).to receive(:gets).once.and_return('q')
+
+      described_class.run
+    end
+  end
+end

data/spec/dotenvious/value_replacer_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+
+describe Dotenvious::ValueReplacer do
+  describe '#replace' do
+    before do
+      stub_const('Dotenvious::ENV_EXAMPLE', {'fake' => 'correct'} )
+    end
+    it "replaces the key's value in .env if user presses yes" do
+      expect(File).to receive(:read).
+        with('.env').
+        and_return("test=1234\nfake=missing")
+
+      env_double = double('File', write: nil)
+      expect(env_double).to receive(:write).with("test=1234\nfake=correct")
+
+      expect(File).to receive(:open).
+        with('.env', 'w').
+        and_return(env_double)
+
+      described_class.new.replace('fake')
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,20 @@
+require 'bundler/setup'
+Bundler.setup
+
+require 'dotenvious' # and any other gems you need
+
+RSpec.configure do |config|
+  #copied & pasted from http://stackoverflow.com/questions/15430551
+  #whoops
+  original_stderr = $stderr
+  original_stdout = $stdout
+  config.before(:all) do
+    # Redirect stderr and stdout
+    $stderr = File.open(File::NULL, "w")
+    $stdout = File.open(File::NULL, "w")
+  end
+  config.after(:all) do
+    $stderr = original_stderr
+    $stdout = original_stdout
+  end
+end

metadata

@@ -0,0 +1,118 @@
+--- !ruby/object:Gem::Specification
+name: dotenvious
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Jake Faris
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-09-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !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: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+description: A dotenv wrapper to manage variables
+email: jakefaris@outlook.com
+executables:
+- dotenvious
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- Gemfile.lock
+- README.md
+- bin/dotenvious
+- dotenvious.gemspec
+- lib/dotenvious.rb
+- lib/dotenvious/cli.rb
+- lib/dotenvious/configuration.rb
+- lib/dotenvious/env_appender.rb
+- lib/dotenvious/loaders/configuration.rb
+- lib/dotenvious/loaders/env.rb
+- lib/dotenvious/loaders/environment.rb
+- lib/dotenvious/loaders/environments.rb
+- lib/dotenvious/loaders/example.rb
+- lib/dotenvious/mismatched_variable_finder.rb
+- lib/dotenvious/missing_variable_finder.rb
+- lib/dotenvious/prompter.rb
+- lib/dotenvious/value_replacer.rb
+- spec/dotenvious/cli_spec.rb
+- spec/dotenvious/configuration_spec.rb
+- spec/dotenvious/env_appender_spec.rb
+- spec/dotenvious/loaders/configuration_spec.rb
+- spec/dotenvious/loaders/env_spec.rb
+- spec/dotenvious/loaders/environments_spec.rb
+- spec/dotenvious/loaders/example_spec.rb
+- spec/dotenvious/mismatched_variable_finder_spec.rb
+- spec/dotenvious/missing_variable_finder_spec.rb
+- spec/dotenvious/prompter_spec.rb
+- spec/dotenvious/value_replacer_spec.rb
+- spec/spec_helper.rb
+homepage: http://rubygems.org/gems/dotenvious
+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.5.1
+signing_key: 
+specification_version: 4
+summary: Dotenvious
+test_files: []
+has_rdoc: