senv 0.4.2 → 0.4.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8e98f626b16a25e287d0bacc26b74693c7e73afdbcf5355fa6bdacc838a4ddc9
-  data.tar.gz: 4532ab5366769d32db307fe122a814e75a6d145754ca04982c099d0a1267485b
+  metadata.gz: ed4a908e406bfd5fee464873562d6b99314b21b532ef9f6ccde5ebbdd5c516e9
+  data.tar.gz: 61394517a8621bc151b3233d007256454eca77d50ac6fc20e8db33eb05d4526b
 SHA512:
-  metadata.gz: 87be7f0e30838c16754ede578042014dc806ac6daaee1bdaba767cc3823cbbb61486c6c14e522191aba0844ff01c8c6db2c0294fdb7617d4b918d3308316e603
-  data.tar.gz: 73de806290b942a1c721f1be37f5b837b3062f38ccb2762cb3e827fc404164d07a473fdf08b1243560e5ebaa121b2099565de8e272f3f82835693fcf0c0f7d63
+  metadata.gz: c390f086f6e7d13f72ff876a116c1c4fee103debc3726743084b6a3c9ed67291aeae86f65747e963c51ffe677b103f004ba835af80c430be6055c31c03160dd1
+  data.tar.gz: 0473b4cc43793f588b87bb971a1dac4d607ad9479298739fa308579948022788710c1ee2914248c2180632ded53b5ce87c1dae60f1752834f90eb373e0ea66cf

data/EXAMPLES.md

@@ -0,0 +1,7 @@
+in this repo is a .senv directoy, sample configs, and a .senv/.key
+
+if you clone the repo you can try running
+
+    senv @all
+
+and you'll know you're running locally ok

data/README.md

@@ -0,0 +1,401 @@
+NAME
+====
+senv - secure 12-factor env vars for your apps, in any lang, local and remote
+
+SYNOPSIS
+========
+@ syntax
+
+    ~> senv @development ./node/server
+
+    ~> senv @staging ./go/server
+
+    ~> senv @production ./ruby/server
+
+inline via environment variable
+
+    ~> SENV=production senv ./app/server
+
+via environment variable
+
+    ~> export SENV=development
+    ~> senv ./app/server
+
+DESCRIPTION
+===========
+*senv* is a command line tool that let's you manage named sets of encrypted
+environment variables across platforms, frameworks, and languages.  it works
+for development and production, on dev boxen, and in docker
+
+*senv* operates over text files stored in a '.senv' directory, typically in
+your project's root.  in this directory are meta stuff like your key:
+
+    .senv/.key
+
+and config files in .json, .yaml, or .rb format:
+
+    .senv/development.json
+    .senv/development.enc.json
+    .senv/production.json
+    .senv/production.enc.json
+
+*NOTE:* you will never check in your .senv/.key file.  *ADD IT TO YOUR .gitignore*
+
+config files can be either non-encrypted, or encrypted.  encrpted files are
+stored with '.enc' in the filename, obviously.
+
+for json, or yaml (yml) files, one can define static dictionaries of
+environment key=val mappings, for example, in a file named
+
+    .senv/development.yaml
+
+one might have:
+
+    APP_ENV : development
+    USE_SSL : false
+
+and, in a file that, to the naked eye, is full of encrypted garbage, named
+
+    .senv/development.enc.yaml
+
+something like: 
+
+    API_KEY : very-sensitive-info-654321
+
+now, you can run commands with these variables loaded into the processs'
+environment with, for example
+
+    ~> senv @development ./start/my/server-process.js
+
+of course, senv also supports management of these files, for example
+encrypting them is as simple as
+
+    ~> cat /tmp/development.json | senv .write .senv/development.enc.json
+
+and reading it back as simply
+
+    ~> senv .read .senv/development.enc.json
+
+it can spawn your $EDITOR directly via
+
+    ~> senv .edit .senv/production.enc.rb
+
+in addition to simple yaml, and json files, one can also load '.rb' files,
+which are parsed with ruby syntax.  and this can massively simplify managing
+complex sets of environment variables for any application
+
+for example, this does what you'd expect
+
+    # file : .senv/all.enc.rb
+    ENV['API_KEY'] = '1234-xyz'
+
+
+    # file : .senv/development.rb
+    Senv.load(:all)
+    ENV['DB_URL'] = 'db://dev-url'
+
+
+    # file : .senv/production.rb
+    Senv.load(:all)
+    ENV['DB_URL'] = 'db://prod-url'
+
+
+    ~> senv @production
+    ---
+    API_KEY : 1234-xyz
+    DB_URL : db://prod-url
+
+one can access the environment as in the examples above, using the senv cli
+program to run another command, but the environment can also be loaded into
+your shell scripts via
+
+    # import all senv env vars into this script
+    eval $(senv init -)
+
+or, in ruby programs via
+
+    require 'senv'
+    Senv.load( ENV['APP_ENV'] || ENV['RAILS_ENV'] || 'development' )
+
+learn more by installing senv and running
+
+    senv .help
+
+INSTALL
+=======
+senv supports 3 methods of installation
+
+* as a standalone binary, with *zero dependencies*
+  * grab the distribution for your platform at https://github.com/ahoward/senv/tree/main/dist
+  * if you don't know which flavor of linux you are on run `uname -a` and
+  * look at the output
+  * unpack the distribution
+  * make sure the ./bin/ directory in the distribution is your $PATH
+
+* as standalone ruby script/lib, depending only on ruby (not rubygems/bundler etc)
+  * grab the distribution here https://github.com/ahoward/senv/blob/main/dist/senv.rb
+  * drop it in, for example, ./lib/, and 'require "./lib/senv.rb"'
+  * the distribution is both the lib, and the *command line script*, so that
+    *same file* can be saved both as './lib/senv.rb' *and* './bin/senv', a
+    clever person might save just as './lib/senv.rb' and make a symlink
+    './bin/senv' -> './lib/senv.rb'
+
+* via rubygems/bundler
+  * in Gemfile, gem 'senv'
+  * or via rubygems, 'gem install senv'
+
+BIKESHED
+========
+
+Q1:
+---
+
+isn't this an imaginary problem?  aren't i still pretty professional dropping
+all my crap in a .env file and calling it a day?
+
+A1:
+---
+
+no.
+
+you will check it in.  you will put it in your backups.  but most of all
+you'll pass all the info inside it around in slack, email, text, and whatsapp
+because you don't have a better way to give it to people.  and you'll do this
+for each of the 17 config settings your 12-factor app nees.   check it all in,
+encrypt what is sensitive, and reduce your problem to merely needing to get
+the next girl *one single key* to unpack the whole lot.  btw, for this, i
+recommend using
+
+https://onetimesecret.com/
+
+now, about the key.  there are two main approaches.
+
+put it on disk, in .senv/.key, this is, at least, a large level of
+indirection, an attacker needs to know a lot more, and look a lot harder to
+figure out how to locate that key, and run some commands to unpack config
+files.  however, ideally you won't store the key on disk at all and, instead,
+with either manage some symlinks such that your .senv/.key resides on a
+thumbdrive, or, far simpler, just understand how to set *one variable* in your
+shell and do that when working on the project, after all what could be simpler
+than just doing
+
+    export SENV_ENV=teh-passwordz-y
+
+or, super fancy
+
+    SENV_KEY=my-key exec $SHELL
+
+or, power-neck-beard
+
+    SENV_KEY=my-key tmux 
+
+or
+
+    SENV_KEY=teh-key visual-studio-magick-coding-ide
+
+except that last one.  that won't work.  if you are uncomfortable on the
+command line, and manging environment variables senv may not be for you.
+however, if that is the case then managing *unencrypted* files full of api
+keys is *definitely not for you*
+
+in the end.  simple is better.
+
+
+WHY?
+====
+so many tools exist to load a file full of environment variables.  all of them
+expose these variables to arbitrary code anytime you:
+
+* run `npm install`, `bundle install`, `pip install`
+* accidentally commit .env files to git/version control
+* loose your laptop
+* a trillion other sloppy ways of leaking unencrypted files full of sensitive
+  information from your developer machine to the world wide web
+
+this problem is neither theoritical nor FUD based:
+
+* https://www.helpnetsecurity.com/2020/04/17/typosquatting-rubygems/
+* https://codeburst.io/how-secure-is-your-environment-file-in-node-js-7c4d2ed0d15a 
+* https://www.twilio.com/blog/2017/08/find-projects-infected-by-malicious-npm-packages.html
+* https://blog.sonatype.com/sonatype-spots-malicious-npm-packages
+* *and a million other reasons not to store unencrypted environment variables*
+* https://lmgtfy.app/#gsc.tab=0&gsc.q=malicious%20packages%20env
+
+solutions to this problem exist, i authored the original solution for the ruby
+programming language:
+
+* https://github.com/ahoward/sekrets
+
+this solution was eventually adapted and merged into 'Ruby on Rails':
+
+* https://github.com/rails/rails/issues/25095#issuecomment-269054302
+* https://guides.rubyonrails.org/4_1_release_notes.html
+
+solutions exist for es6, javascript, go, and many languages.  each operates
+differently:
+
+* https://github.com/kunalpanchal/secure-env
+* https://github.com/envkey/envkeygo
+
+however, all of these solutions, including some of my work, operate at the
+wrong level, which is to say at the language or framework level.  this misses,
+entirely, the point of configuring applications via the environment in the
+ordained 12-factor way; by requiring tight integration, such as the addition
+of libraries and tooling into projects to manage, load, and set environment
+variables, we reduce significantly the simplicity of a pure 12-factor app that
+does only.
+
+    const DATABASE_URL = process.env.DATABASE_URL;
+
+it's easy to make this mistake and, so long as your project remains a
+monolith, it works just fine.  until it doesn't.
+
+as many of us know, a real, modern, web project is unlikely to remain a single
+process in a single framework and language.  micro-services will be
+introduced.  background jobs will get introduced.  someone will split the main
+web app from the consumer app.  everything will get re-written in node, and
+then go.  finally, each developer in every language will solve the problem
+their own way, and pass around unencrypted text files full of sensitive
+information all day long like someone yelling 'b-crypt' very slowly in bounded
+time.  someone will port the application deployment from heroku to gcp, and
+re-tool setting 100 confiuration variables instead of the one meta SENV\_KEY
+to rule them all.  he'll be a 'dev-ops' guy, kind of an asshole, and he'll
+grind deployments down from a 3 minute process to a 3 week fight about vpns.
+don't be that guy.
+
+EXAMPLES
+========
+    # setup a directory to use senv, including making some sample config files
+     
+      ~> senv .setup /full/path/to/directory
+
+    # setup _this_ directory
+
+      ~> senv .setup
+
+    # encrypt a file
+     
+      ~> senv /tmp/development.json | senv .write .senv/development.enc.json
+
+    # read a file, encrypted or not
+     
+      ~> senv .read .senv/development.enc.json
+      ~> senv .read .senv/development.json
+
+    # show all the environemnt settings for the production environment
+
+      ~> senv @production
+
+    # run a command under an environment
+    
+      ~> senv @test ./run/the/tests.js
+
+    # edit a file, encrypted or not, using the $EDITOR like all unix citizens
+    
+      ~> senv .edit ./senv/production.enc.rb
+
+    # pluck a single value from a config set
+
+      ~> senv .get API_KEY
+
+    # load an entire senv into a shell script
+
+      #! /bin/sh
+      export SENV=production
+      eval $(senv init -)
+
+    # load senv in ruby program
+     
+      #! /usr/bin/env ruby
+      require 'senv'
+      Senv.load(:all)
+
+    # setup a project with a .senv directory and key, this will drop in some
+    # sample files
+    #
+
+    ~> senv .setup .
+
+ENVIRONMENT
+===========
+  the following environment variables affect senv itself
+
+    SENV
+      specify which senv should be loaded
+
+    SENV_KEY
+      specify the encryption key via the environment
+
+    SENV_PATH
+      a colon separated set of paths in which to search for '.senv' directories
+
+    SENV_ROOT
+      the location of the .senv directory
+
+    SENV_DEBUG
+      you guessed it
+
+
+REFMASTER
+=========
+  http://github.com/ahoward/senv
+
+TL;DR;
+======
+it's at the bottom because everyone should read the docs ;-)
+
+```
+↟ senv[]@master $ senv .setup .                                                                                                                                                        
+[SENV] setup /home/ahoward/git/ahoward/senv/.senv                                                                                                                                      
+- .senv/all.rb                                                                                                                                                                         
+- .senv/development.enc.rb                                                                                                                                                             
+- .senv/development.rb                                                                                                                                                                 
+- .senv/production.enc.rb                                                                                                                                                              
+- .senv/production.rb                                                                                                                                                                  
+
+↟ senv[]@master $ cat .senv/all.rb                                                                                                                                                     
+ENV['A'] = 'one'                                                                                                                                                                       
+ENV['B'] = 'two'                                                                                                                                                                       
+ENV['C'] = 'three'                                                                                                                                                                     
+
+↟ senv[]@master $ cat .senv/production.rb                                                                                                                                              
+Senv.load(:all)                                                                                                                                                                        
+ENV['B'] = 'two (via production.rb)'                                                                                                                                                   
+
+↟ senv[]@master $ cat .senv/production.enc.rb                                                                                                                                          
+0GWID?䱐xAǼdW)\        1waxE͑!k
+
+↟ senv[]@master $ senv .read .senv/production.enc.rb                                                                                                                                   
+Senv.load(:all)                                                                                                                                                                        
+ENV['C'] = 'three (via production.enc.rb)'                                                                                                                                             
+
+↟ senv[]@master $ cat .senv/.key                                                                                                                                                       
+770db0fd-fddc-4c8c-a264-37d15766d0a5                                                                                                                                                   
+
+↟ senv[]@master $ senv @production                                                                                                                                                     
+---                                                                                                                                                                                    
+A: one                                                                                                                                                                                 
+B: two (via production.rb)                                                                                                                                                             
+C: three (via production.enc.rb)                                                                                                                                                       
+
+↟ senv[]@master $ rm .senv/.key
+
+↟ senv[]@master $ senv @production                                                          
+Senv.key not found in : /home/ahoward/git/ahoward/senv/.senv/.key                          
+
+↟ senv[]@master $ SENV_KEY=770db0fd-fddc-4c8c-a264-37d15766d0a5 senv @proudction
+---                                                                                                                                                                                    
+A: one                                                                                                                                                                                 
+B: two (via production.rb)                                                                                                                                                             
+C: three (via production.enc.rb)                                                                                                                                                       
+
+↟ senv[]@master $ cat a.sh
+#! /bin/sh
+echo $C
+
+↟ senv[]@master $ SENV=production SENV_KEY=770db0fd-fddc-4c8c-a264-37d15766d0a5 senv ./a.sh
+three (via production.enc.rb)
+```
+
+:wq
+

data/a.sh

@@ -0,0 +1,2 @@
+#! /bin/sh
+echo $C

data/bin/senv

@@ -1,18 +1,79 @@
 #! /usr/bin/env ruby
 # encoding: utf-8
+if $0 == __FILE__
 
 #
   HELP = <<-____
 
-    NAME
-      senv - secure 12-factor environment variables
+  NAME
+  ========
+    senv - secure 12-factor env vars for your apps, in any lang, local and remote
 
-    VERSION
-      <%= Senv.version %>
+  EXAMPLES
+  ========
+    # setup a directory to use senv, including making some sample config files
+     
+      ~> senv .setup /full/path/to/directory
 
-    TL;DR;
+    # setup _this_ directory
 
-      # WIP ...
+      ~> senv .setup
+
+    # encrypt a file
+     
+      ~> senv /tmp/development.json | senv .write .senv/development.enc.json
+
+    # read a file, encrypted or not
+     
+      ~> senv .read .senv/development.enc.json
+      ~> senv .read .senv/development.json
+
+    # show all the environemnt settings for the production environment
+
+      ~> senv @production
+
+    # run a command under an environment
+    
+      ~> senv @test ./run/the/tests.js
+
+    # edit a file, encrypted or not, using the $EDITOR like all unix citizens
+    
+      ~> senv .edit ./senv/production.enc.rb
+
+    # pluck a single value from a config set
+
+      ~> senv .get API_KEY
+
+    # load an entire senv into a shell script
+
+      #! /bin/sh
+      export SENV=production
+      eval $(senv init -)
+
+    # load senv into yer ruby program
+     
+      #! /usr/bin/env ruby
+      require 'senv'
+      Senv.load(:all)
+
+  ENVIRONMENT
+  ===========
+    the following environment variables affect senv itself
+
+    SENV
+      specify which senv should be loaded
+
+    SENV_KEY
+      specify the encryption key via the environment
+
+    SENV_PATH
+      a colon separated set of paths in which to search for '.senv' directories
+
+    SENV_ROOT
+      the location of the .senv directory
+
+    SENV_DEBUG
+      you guessed it
 
   ____
 
@@ -81,17 +142,23 @@
 
       key.strip!
 
+      dir = File.expand_path(dir)
+
+      FileUtils.mkdir_p(dir)
+
       Dir.chdir(dir) do
+      #
         if test(?d, '.senv')
           abort "#{ dir }/.senv directory exists"
         end
 
         FileUtils.mkdir_p('.senv')
 
-        IO.binwrite('.senv/_key', "#{ key }\n")
+        IO.binwrite('.senv/.key', "#{ key }\n")
 
         Senv.key = key
 
+      #
         Senv.write(
           '.senv/all.rb',
           u.unindent(
@@ -109,7 +176,6 @@
             u.unindent(
               <<-____
                 Senv.load(:all)
-
                 ENV['B'] = 'two (via #{ env }.rb)'
               ____
             )
@@ -120,14 +186,14 @@
             u.unindent(
               <<-____
                 Senv.load(:all)
-
                 ENV['C'] = 'three (via #{ env }.enc.rb)'
               ____
             )
           )
         end
 
-        puts "[SENV] setup #{ File.expand_path(dir) }" 
+      #
+        puts "[SENV] setup #{ dir }/.senv" 
 
         Dir.glob('.senv/**/**').sort.each do |entry|
           next unless test(?f, entry)
@@ -225,6 +291,10 @@
       end
     end
 
+    run '.help' do
+      show_help!
+    end
+
   #
     def show_help!
       help = ERB.new(u.unindent(HELP)).result(::TOPLEVEL_BINDING)
@@ -257,3 +327,5 @@
       end
     end
   end
+
+end

data/dist/senv.rb

@@ -1,18 +1,79 @@
 #! /usr/bin/env ruby
 # encoding: utf-8
+if $0 == __FILE__
 
 #
   HELP = <<-____
 
-    NAME
-      senv - secure 12-factor environment variables
+  NAME
+  ========
+    senv - secure 12-factor env vars for your apps, in any lang, local and remote
 
-    VERSION
-      <%= Senv.version %>
+  EXAMPLES
+  ========
+    # setup a directory to use senv, including making some sample config files
+     
+      ~> senv .setup /full/path/to/directory
 
-    TL;DR;
+    # setup _this_ directory
 
-      # WIP ...
+      ~> senv .setup
+
+    # encrypt a file
+     
+      ~> senv /tmp/development.json | senv .write .senv/development.enc.json
+
+    # read a file, encrypted or not
+     
+      ~> senv .read .senv/development.enc.json
+      ~> senv .read .senv/development.json
+
+    # show all the environemnt settings for the production environment
+
+      ~> senv @production
+
+    # run a command under an environment
+    
+      ~> senv @test ./run/the/tests.js
+
+    # edit a file, encrypted or not, using the $EDITOR like all unix citizens
+    
+      ~> senv .edit ./senv/production.enc.rb
+
+    # pluck a single value from a config set
+
+      ~> senv .get API_KEY
+
+    # load an entire senv into a shell script
+
+      #! /bin/sh
+      export SENV=production
+      eval $(senv init -)
+
+    # load senv into yer ruby program
+     
+      #! /usr/bin/env ruby
+      require 'senv'
+      Senv.load(:all)
+
+  ENVIRONMENT
+  ===========
+    the following environment variables affect senv itself
+
+    SENV
+      specify which senv should be loaded
+
+    SENV_KEY
+      specify the encryption key via the environment
+
+    SENV_PATH
+      a colon separated set of paths in which to search for '.senv' directories
+
+    SENV_ROOT
+      the location of the .senv directory
+
+    SENV_DEBUG
+      you guessed it
 
   ____
 
@@ -81,17 +142,23 @@
 
       key.strip!
 
+      dir = File.expand_path(dir)
+
+      FileUtils.mkdir_p(dir)
+
       Dir.chdir(dir) do
+      #
         if test(?d, '.senv')
           abort "#{ dir }/.senv directory exists"
         end
 
         FileUtils.mkdir_p('.senv')
 
-        IO.binwrite('.senv/_key', "#{ key }\n")
+        IO.binwrite('.senv/.key', "#{ key }\n")
 
         Senv.key = key
 
+      #
         Senv.write(
           '.senv/all.rb',
           u.unindent(
@@ -109,7 +176,6 @@
             u.unindent(
               <<-____
                 Senv.load(:all)
-
                 ENV['B'] = 'two (via #{ env }.rb)'
               ____
             )
@@ -120,14 +186,14 @@
             u.unindent(
               <<-____
                 Senv.load(:all)
-
                 ENV['C'] = 'three (via #{ env }.enc.rb)'
               ____
             )
           )
         end
 
-        puts "[SENV] setup #{ File.expand_path(dir) }" 
+      #
+        puts "[SENV] setup #{ dir }/.senv" 
 
         Dir.glob('.senv/**/**').sort.each do |entry|
           next unless test(?f, entry)
@@ -225,6 +291,10 @@
       end
     end
 
+    run '.help' do
+      show_help!
+    end
+
   #
     def show_help!
       help = ERB.new(u.unindent(HELP)).result(::TOPLEVEL_BINDING)
@@ -258,6 +328,8 @@
     end
   end
 
+end
+
 
 BEGIN {
 
@@ -280,7 +352,7 @@ BEGIN {
 #
   module Senv
   #
-    VERSION = '0.4.2'.freeze
+    VERSION = '0.4.3'.freeze
 
     def Senv.version
       VERSION
@@ -562,7 +634,7 @@ BEGIN {
     end
 
     def Senv.key_path
-      Senv.directory.join('_key')
+      Senv.directory.join('.key')
     end
 
     def Senv.key
@@ -641,6 +713,8 @@ BEGIN {
           end
       end
 
+      FileUtils.mkdir_p(File.dirname(path))
+
       IO.binwrite(path, data)
     end
 

data/lib/senv.rb

@@ -15,7 +15,7 @@
 #
   module Senv
   #
-    VERSION = '0.4.2'.freeze
+    VERSION = '0.4.3'.freeze
 
     def Senv.version
       VERSION
@@ -297,7 +297,7 @@
     end
 
     def Senv.key_path
-      Senv.directory.join('_key')
+      Senv.directory.join('.key')
     end
 
     def Senv.key
@@ -376,6 +376,8 @@
           end
       end
 
+      FileUtils.mkdir_p(File.dirname(path))
+
       IO.binwrite(path, data)
     end
 

data/senv.gemspec

@@ -3,29 +3,31 @@
 
 Gem::Specification::new do |spec|
   spec.name = "senv"
-  spec.version = "0.4.2"
+  spec.version = "0.4.3"
   spec.platform = Gem::Platform::RUBY
   spec.summary = "senv"
   spec.description = "description: senv kicks the ass"
   spec.license = "MIT"
 
   spec.files =
-["LICENSE",
- "README",
+["EXAMPLES.md",
+ "LICENSE",
+ "README.md",
  "Rakefile",
- "a.rb",
+ "a.sh",
  "bin",
  "bin/senv",
  "dist",
- "dist/senv-0.4.2-linux-x86.tgz",
- "dist/senv-0.4.2-linux-x86_64.tgz",
- "dist/senv-0.4.2-osx.tgz",
+ "dist/senv-0.4.3-linux-x86.tgz",
+ "dist/senv-0.4.3-linux-x86_64.tgz",
+ "dist/senv-0.4.3-osx.tgz",
  "dist/senv.rb",
  "dist/senv.sh",
  "lib",
  "lib/senv",
  "lib/senv.rb",
  "lib/senv/script.rb",
+ "samples",
  "senv.gemspec"]
 
   spec.executables = ["senv"]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: senv
 version: !ruby/object:Gem::Version
-  version: 0.4.2
+  version: 0.4.3
 platform: ruby
 authors:
 - Ara T. Howard
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-01-12 00:00:00.000000000 Z
+date: 2021-01-19 00:00:00.000000000 Z
 dependencies: []
 description: 'description: senv kicks the ass'
 email: ara.t.howard@gmail.com
@@ -17,14 +17,15 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- EXAMPLES.md
 - LICENSE
-- README
+- README.md
 - Rakefile
-- a.rb
+- a.sh
 - bin/senv
-- dist/senv-0.4.2-linux-x86.tgz
-- dist/senv-0.4.2-linux-x86_64.tgz
-- dist/senv-0.4.2-osx.tgz
+- dist/senv-0.4.3-linux-x86.tgz
+- dist/senv-0.4.3-linux-x86_64.tgz
+- dist/senv-0.4.3-osx.tgz
 - dist/senv.rb
 - dist/senv.sh
 - lib/senv.rb

data/README

@@ -1,14 +0,0 @@
-NAME
-  senv
-
-URI
-  http://github.com/ahoward/senv
-
-SYNOPSIS
-# WIP ...
-
-INSTALL
-  gem install senv
-
-DESCRIPTION
-# WIP ...

data/a.rb

@@ -1,92 +0,0 @@
-task :dist => [:dist_rb] do
-  Dir.chdir(This.dir)
-
-  version = This.version
-  name = This.name.downcase
-
-  platforms = %w[
-    linux-x86 linux-x86_64 osx
-  ]
-
-  Dir.glob("./dist/#{ name }-*").each{|entry| FileUtils.rm_rf(entry)}
-
-  spawn = proc{|cmd| system(cmd) or abort("#{ cmd } #=> #{ $? }")}
-
-  entrypoint = File.expand_path("./dist/#{ name }.sh")
-
-  platforms.each do |platform|
-    distdir = "./dist/#{ name }-#{ version }-#{ platform }"
-    FileUtils.mkdir_p(distdir)
-
-    libdir = File.join(distdir, 'lib')
-    FileUtils.mkdir_p(libdir)
-
-    appdir = File.join(libdir, 'app')
-    FileUtils.mkdir_p(appdir)
-
-    rubydir = File.join(libdir, 'ruby')
-    FileUtils.mkdir_p(rubydir)
-
-    FileUtils.cp('./dist/senv.rb', appdir)
-
-    Dir.chdir(rubydir) do
-      basename = "traveling-ruby-20141215-2.1.5-#{ platform }.tar.gz"
-      cmd = "curl -s -L -O --fail https://d6r77u77i8pq3.cloudfront.net/releases/#{ basename }"
-      spawn[cmd]
-      spawn["tar -xzf #{ basename }"]
-      FileUtils.rm(basename)
-    end
-
-    Dir.chdir(distdir) do
-      FileUtils.cp(entrypoint, name)
-    end
-  end
-
-  system('tree -L 4 dist 2>/dev/null') if STDOUT.tty?
-
-  Dir.chdir './dist' do
-    platforms.each do |platform|
-      dist = "#{ name }-#{ version }-#{ platform }"
-      spawn["tar cvfz #{ dist }.tgz ./#{ dist } >/dev/null 2>&1"]
-      FileUtils.rm_rf(dist)
-    end
-  end
-end
-
-
-
-
-  HELP = <<-____.tap{|s| s.gsub!(s[%r/^\s*/], '')}
-      VERSION
-        <%= Senv.version %>
-
-      TL;DR;
-
-        $ tree ./config/senvs/
-
-          config/senvs/
-           development.enc.rb
-           development.rb
-           development.yml
-           development.json
-           production.enc.rb
-           production.rb
-           production.yml
-           staging.json
-           staging.enc.rb
-           staging.rb
-           staging.yml
-           staging.json
-
-
-       ~> export SENV=production
-
-       ~> ./bin/senv run-something-in-production senv
-
-       ~> ./bin/senv @staging # show it
-
-       ~> ./bin/senv @staging run-something-in-staging-senv
-
-    ____
-
-puts HELP