Class: Sekrets

Inherits:

Object

• Object
• Sekrets

Extended by:

Blowfish

Defined in:

lib/sekrets.rb

Defined Under Namespace

Modules: Blowfish

Class Method Summary

• .ask(question) ⇒ Object
• .binstub ⇒ Object
• .console? ⇒ Boolean
• .key_for(*args) ⇒ Object
• .key_for!(*args, &block) ⇒ Object
• .openr(arg, &block) ⇒ Object
• .openw(arg, &block) ⇒ Object
• .path_for(object) ⇒ Object
• .prompt_for(*words) ⇒ Object
• .read(*args, &block) ⇒ Object
• .settings_for(*args, &block) ⇒ Object
• .tmpdir(&block) ⇒ Object
• .unindent(string) ⇒ Object
• .unindent!(string) ⇒ Object
• .write(*args, &block) ⇒ Object

Methods included from Blowfish

cipher, cycle, decrypt, encrypt, recrypt

Class Method Details

.ask(question) ⇒ Object

# File 'lib/sekrets.rb', line 119

def Sekrets.ask(question)
  @highline ||= HighLine.new
  @highline.ask(prompt_for(question))
end

.binstub ⇒ Object

# File 'lib/sekrets.rb', line 245

def Sekrets.binstub
  @binstub ||= (
    unindent(
      <<-'_v_'
        #! /usr/bin/env ruby
        
        require 'pathname'
        ENV['BUNDLE_GEMFILE'] ||= File.expand_path("../../Gemfile",
          Pathname.new(__FILE__).realpath)
        
        require 'rubygems'
        require 'bundler/setup'
      
        dirname = File.dirname(__FILE__)

        root = File.dirname(dirname)

        ciphertext = File.expand_path('ciphertext', dirname)

        case ARGV.size
          when 0
            ENV['SEKRETS_ARGV'] = "edit #{ ciphertext }"
          when 1
            ENV['SEKRETS_ARGV'] = "#{ ARGV[0] } #{ ciphertext }"
        end

        key = File.join(root, '.sekrets.key')

        if test(?s, key)
          ENV['SEKRETS_KEY'] = IO.binread(key).strip
        end

        exec(Gem.bin_path('sekrets', 'sekrets'))
      _v_
    )
  )
end

.console? ⇒ Boolean

Returns:

• (Boolean)

# File 'lib/sekrets.rb', line 125

def Sekrets.console?
  STDIN.tty?
end

.key_for(*args) ⇒ Object

# File 'lib/sekrets.rb', line 10

def Sekrets.key_for(*args)
  options = Map.options_for!(args)
  path = args.shift || options[:path]

  if options.has_key?(:key)
    key = options[:key]
    return(key)
  end

  path = path_for(path)

  if path
    dirname, basename = File.split(path)

    keyfiles =
      Coerce.list_of_strings(
        [:keyfile, :keyfiles].map{|k| options[k]},
        %W[ #{ dirname }/.#{ basename }.key #{ dirname }/.#{ basename }.k ]
      )

    keyfiles.each do |file|
      if test(?s, file)
        key = IO.binread(file).strip
        return(key)
      end
    end
  end

  if Sekrets.project_key and test(?s, Sekrets.project_key)
    return IO.binread(Sekrets.project_key).strip
  end

  env_key = (options[:env] || Sekrets.env).to_s
  if ENV.has_key?(env_key)
    key = ENV[env_key]
    return(key)
  end

  if Sekrets.global_key and test(?s, Sekrets.global_key)
    return IO.binread(Sekrets.global_key).strip
  end

  unless options[:prompt] == false
    if console?
      key = Sekrets.ask(path)
      return(key)
    end
  end

  return nil
end

.key_for!(*args, &block) ⇒ Object

Raises:

• (ArgumentError)

# File 'lib/sekrets.rb', line 63

def Sekrets.key_for!(*args, &block)
  key = Sekrets.key_for(*args, &block)
  raise(ArgumentError, 'no key!') unless key
  key
end

.openr(arg, &block) ⇒ Object

# File 'lib/sekrets.rb', line 196

def Sekrets.openr(arg, &block)
  opened = false

  io =
    case
      when arg.respond_to?(:read)
        arg
      when arg.to_s.strip == '-'
        STDIN
      else
        opened = true
        open(arg, 'rb+')
    end

  close = 
    proc do
      io.close if opened
    end

  if block
    begin
      block.call(io)
    ensure
      close.call
    end
  else
    at_exit{ close.call }
    io
  end
end

.openw(arg, &block) ⇒ Object

# File 'lib/sekrets.rb', line 156

def Sekrets.openw(arg, &block)
  opened = false
  atomic_move = proc{}

  io =
    case
      when arg.respond_to?(:read)
        arg
      when arg.to_s.strip == '-'
        STDOUT
      else
        opened = true
        path = File.expand_path(arg.to_s)
        dirname, basename = File.split(path)
        FileUtils.mkdir_p(dirname)
        tmp = path + ".sekrets.tmp.#{ Process.ppid }.#{ Process.pid }"
        at_exit{ FileUtils.rm_f(tmp) }
        atomic_move = proc{ FileUtils.mv(tmp, path) }
        open(tmp, 'wb+')
    end

  close = 
    proc do
      io.close if opened
      atomic_move.call
    end

  if block
    begin
      block.call(io)
    ensure
      close.call
    end
  else
    at_exit{ close.call }
    io
  end
end

.path_for(object) ⇒ Object

# File 'lib/sekrets.rb', line 228

def Sekrets.path_for(object)
  path = nil

  if object.is_a?(String) or object.is_a?(Pathname)
    return(path = object.to_s)
  end

  [:original_path, :original_filename, :path, :filename, :pathname].each do |msg|
    if object.respond_to?(msg)
      path = object.send(msg)
      break
    end
  end

  path
end

.prompt_for(*words) ⇒ Object

# File 'lib/sekrets.rb', line 114

def Sekrets.prompt_for(*words)
  ["sekrets:", words, "> "].flatten.compact.join(' ')
end

.read(*args, &block) ⇒ Object

# File 'lib/sekrets.rb', line 70

def Sekrets.read(*args, &block)
  options = Map.options_for!(args)
  path = args.shift || options[:path]
  key = args.shift || Sekrets.key_for!(path, options)

  return nil unless test(?s, path)

  encrypted = IO.binread(path)
  decrypted = Sekrets.decrypt(key, encrypted)
  new(decrypted)
end

.settings_for(*args, &block) ⇒ Object

# File 'lib/sekrets.rb', line 103

def Sekrets.settings_for(*args, &block)
  decrypted = read(*args, &block)

  if decrypted
    expanded = ERB.new(decrypted).result(TOPLEVEL_BINDING)
    object = YAML.load(expanded)
    object.is_a?(Hash) ? Map.for(object) : object
  end
end

.tmpdir(&block) ⇒ Object

# File 'lib/sekrets.rb', line 130

def Sekrets.tmpdir(&block)
  dirname = File.join(Dir.tmpdir, 'sekrets', Process.ppid.to_s, Process.pid.to_s, rand.to_s)

  FileUtils.mkdir_p(dirname)

  cleanup = proc do
    if dirname and test(?d, dirname)
      FileUtils.rm_rf(dirname)
    end
  end

  if block
    begin
      Dir.chdir(dirname) do
        block.call(dirname)
      end
    ensure
      cleanup.call
    end
  else
    at_exit{ cleanup.call }
    dirname
  end
end

.unindent(string) ⇒ Object

# File 'lib/sekrets.rb', line 283

def Sekrets.unindent(string)
  indent = string.split("\n").select {|line| !line.strip.empty? }.map {|line| line.index(/[^\s]/) }.compact.min || 0
  string.gsub(/^[[:blank:]]{#{indent}}/, '')
end

.unindent!(string) ⇒ Object

# File 'lib/sekrets.rb', line 288

def Sekrets.unindent!(string)
  string.replace(string.unindent)
end

.write(*args, &block) ⇒ Object

# File 'lib/sekrets.rb', line 83

def Sekrets.write(*args, &block)
  options = Map.options_for!(args)
  path = args.shift || options[:path]
  content = args.shift || options[:content]
  key = args.shift || Sekrets.key_for!(path, options)

  dirname, basename = File.split(File.expand_path(path))
  FileUtils.mkdir_p(dirname)

  encrypted = Sekrets.encrypt(key, content)

  tmp = path + '.tmp'
  IO.binwrite(tmp, encrypted)
  FileUtils.mv(tmp, path)

  encrypted
  new(encrypted)
end