class Envfile

Envfile understands various input file formats and executes commands according to that.

It should be noted that Envfile is (unlike the ENV object itself) a kind of Hash. So if you want to modify some environment variables, feel free to do so as you normally do with Hashes. It is of course up to you to properly set them up.

Public Class Methods

run_with_envfile(envfile, cmd, *argv) click to toggle source

Utility method to setup, fire, then forget.

@param [String] envfile an envfile path @param [String] cmd program file path @param [String] argv passed to cmd

@see Envfile#exec!

# File lib/envfile.rb, line 43
def self.run_with_envfile envfile, cmd, *argv
   new.parse(envfile).exec!(cmd, argv)
end

Public Instance Methods

exec!(cmd, argv) click to toggle source

Executes the given cmd under self's setup. @param [String] cmd program file path @param [String] argv passed to cmd

@note This method does not always return. But when it does it always

results into an exception.

@raise [Errno::ENOENT] envfile does not exist @raise [Errno::ENOEXEC] cmd not runnable @raise [Errno::EACCESS] permission denied to exec @raise [Errno::ELOOP] symlink is too deep @raise [Errno::ENAMETOOLONG] file path too long

# File lib/envfile.rb, line 75
def exec! cmd, argv
   exec self, [cmd, cmd], *argv, close_others: true
end

parse(envfile) click to toggle source

Load up the contents of the given file. @param [String] envfile path to a file

@note When called multiple times with different envfile per instance, and

if any  of the env key  collides, the result is  undefined.  I would
like to advise you no to do such thing.

# File lib/envfile.rb, line 53
def parse envfile
   path = Pathname.new envfile
   update case path.extname
          when '.pl',  '.perl' then parse_perl    path
          when '.js',  '.json' then parse_json    path
          when '.yml', '.yaml' then parse_yaml    path
          else                      parse_xaicron path
          end
end

Private Instance Methods

parse_json(path) click to toggle source

# File lib/envfile.rb, line 82
def parse_json path
   path.open do |f|
      return JSON.load f
   end
end

parse_perl(path) click to toggle source

# File lib/envfile.rb, line 94
   def parse_perl path
      IO.popen 'perl', 'r+' do |io|
         io.puts <<-"end"
                                use App::envfile;
                                use JSON::XS;
                                my $json = JSON::XS->new->utf8->allow_nonref;
                                my $envf = App::envfile->new->parse_envfile('#{path}');
                                print $json->encode($envf);
                                exit;
                        end
         io.close_write
         return JSON.load io
      end
   end

parse_xaicron(path) click to toggle source

# File lib/envfile.rb, line 109
def parse_xaicron path
   path.open do |f|
      return f.each_line.reject do |i|
         /^\s*#/ =~ i
      end.map do |i|
         i.chomp.split %r/=/, 2
      end.each_with_object Hash.new do |(k, v), h|
         h[k] = v
      end
   end
end

parse_yaml(path) click to toggle source

# File lib/envfile.rb, line 88
def parse_yaml path
   path.open do |f|
      return Psych.load f
   end
end