hem 1.0.1.beta1

data/lib/hem/tasks/vm.rb

@@ -0,0 +1,140 @@
+desc "VM related commands"
+project_only
+namespace :vm do
+  def vagrantfile &block
+    locate "*Vagrantfile" do
+      yield
+    end
+  end
+
+  def vagrant_exec *args
+    opts = { :realtime => true, :indent => 2 }
+    color = Hem.ui.supports_color? ? '--color' : '--no-color'
+
+    if Hem.windows?
+      opts[:env] = { 'VAGRANT_HOME' => windows_short(dir) } if ENV['HOME'].match(/\s+/) && !ENV['VAGRANT_HOME']
+    end
+
+    args.unshift 'vagrant'
+    args.push color
+    args.push opts
+
+    shell *args
+  end
+
+  def windows_short dir
+    segments = dir.gsub(/\\/, '/').split('/')
+    segments.map do |segment|
+      if segment.match /\s+/
+        # This may fail in some edge cases but better than naught
+        # See the following link for the correct solution
+        # http://stackoverflow.com/questions/10224572/convert-long-filename-to-short-filename-8-3
+        segment.upcase.gsub(/\s+/, '')[0...6] + '~1'
+      else
+        segment
+      end
+    end.join('/')
+  end
+
+  desc "Start & provision VM"
+  task :up => [ 'assets:download', 'vm:start', 'vm:provision', 'deps:composer', 'assets:apply' ]
+
+  desc "Stop VM"
+  task :stop do
+    vagrantfile do
+      Hem.ui.title "Stopping VM"
+      vagrant_exec 'halt'
+      Hem.ui.separator
+    end
+  end
+
+  desc "Rebuild VM"
+  task :rebuild => [ 'vm:destroy', 'vm:up' ]
+
+  desc "Destroy VM"
+  task :destroy do
+    vagrantfile do
+      Hem.ui.title "Destroying VM"
+      vagrant_exec 'destroy', '--force'
+      Hem.ui.separator
+    end
+  end
+
+  desc "Start VM without provision"
+  task :start => [ "deps:gems", "deps:chef", "deps:vagrant_plugins" ] do
+    vagrantfile do
+      state = shell("vagrant --machine-readable status | grep ,state, | cut -d, -f4", :capture => true).strip
+      unless state == 'running'
+        Hem.ui.title "Starting vagrant VM"
+        args = ['up', '--no-provision']
+
+        provider = maybe(Hem.user_config.vm.provider)
+        provider ||= maybe(Hem.project_config.vm.provider)
+
+        if provider
+          args.concat ['--provider', provider]
+        end
+
+        vagrant_exec *args
+        Hem.ui.separator
+      end
+    end
+  end
+
+  desc "Reload VM"
+  task :reload do
+    vagrantfile do
+      Hem.ui.title "Reloading VM"
+      vagrant_exec 'reload', '--no-provision'
+      Hem.ui.separator
+    end
+  end
+
+  desc "Provision VM"
+  task :provision => [ "deps:chef" ] do
+     vagrantfile do
+      Hem.ui.title "Provisioning VM"
+      vagrant_exec 'provision'
+      Hem.ui.separator
+    end
+  end
+
+  desc "Open an SSH connection"
+  task :ssh do |task|
+    execute = task.opts[:_unparsed]
+    opts = { :psuedo_tty => STDIN.tty? }
+
+    Hem.ui.success "Determining VM connection details..." if STDOUT.tty?
+    command = execute.empty? ? vm_command(nil, opts) : vm_command(execute, opts)
+    Hem.logger.debug "vm:ssh: #{command}"
+
+    Hem.ui.success "Connecting..." if STDOUT.tty?
+    exec command
+  end
+
+  desc "Open a MySQL cli connection"
+  option '-D=', '--db=', 'Database'
+  task :mysql do |task|
+    opts = { :psuedo_tty => STDIN.tty? }
+    opts[:db] = task.opts[:db] if task.opts[:db]
+
+    Hem.ui.success "Determining VM connection details..." if STDOUT.tty?
+    command = vm_mysql(opts)
+    Hem.logger.debug "vm:mysql: #{command}"
+
+    Hem.ui.success "Connecting..." if STDOUT.tty?
+    exec command
+  end
+
+  desc "Open a Redis cli connection"
+  task :redis do
+    opts = { :psuedo_tty => STDIN.tty? }
+
+    Hem.ui.success "Determining VM connection details..." if STDOUT.tty?
+    command = vm_command("redis-cli", opts)
+    Hem.logger.debug "vm:redis: #{command}"
+
+    Hem.ui.success "Connecting..." if STDOUT.tty?
+    exec command
+  end
+end

data/lib/hem/ui.rb

@@ -0,0 +1,182 @@
+module Hem
+  class << self
+    attr_accessor :ui
+  end
+
+  class Ui
+    include Hem::Logging
+
+    attr_accessor :interactive
+
+    COLORS = {
+      :debug => [ ],
+      :info => [ ],
+      :warning => [:yellow],
+      :error => [:red],
+      :success => [:green],
+      :opt => [:green],
+      :command => [:green],
+      :special => [:blue],
+      :title => [:green],
+      :help_title => [:yellow],
+      :description => [:bold]
+    }
+
+    def initialize input = $stdin, output = $stdout, error = $stderr
+      require 'highline'
+      HighLine.color_scheme = HighLine::ColorScheme.new COLORS
+      @output_io = output
+      @out = ::HighLine.new input, output
+      @error = ::HighLine.new input, error
+      use_color supports_color?
+    end
+
+    def color_scheme scheme = nil
+      HighLine.color_scheme = scheme if scheme
+      HighLine.color_scheme
+    end
+
+    def supports_color?
+      return @output_io.tty? unless Hem.windows?
+      return (ENV['ANSICON'] || ENV['TERM'] == 'xterm') && @output_io.tty? # ANSICON or MinTTY && output is TTY
+    end
+
+    def use_color opt = nil
+      HighLine.use_color = opt unless opt.nil?
+      HighLine.use_color?
+    end
+
+    def ask question, opts = {}
+      opts = {
+        :validate => nil,
+        :default => nil,
+        :echo => true
+      }.merge(opts)
+
+      unless @interactive
+        raise Hem::NonInteractiveError.new(question) if opts[:default].nil?
+        return opts[:default].to_s
+      end
+
+      question = "#{question} [#{opts[:default]}]" if opts[:default]
+      question += ": "
+      begin
+        answer = @out.ask(question) do |q|
+          q.validate = opts[:validate] if opts[:validate]
+          q.echo = opts[:echo]
+          q.readline
+        end
+        answer = answer.to_s
+        answer.strip.empty? ? opts[:default].to_s : answer.strip
+      rescue EOFError
+        Hem.ui.info ""
+        ""
+      end
+    end
+
+    def ask_choice question, choices, opts = {}
+      unless @interactive
+        raise Hem::NonInteractiveError.new(question) if opts[:default].nil?
+        return opts[:default].to_s
+      end
+
+      question = "#{question} [#{opts[:default]}]" if opts[:default]
+      question += ":"
+      info question
+
+      choice_map = {}
+      choices.to_enum.with_index(1) do |choice, index|
+        choice_map[index.to_s] = choice
+        info "#{index}] #{choice}"
+      end
+
+      begin
+        answer = @out.ask("?  ") do |q|
+          q.validate = lambda do |a|
+            s = a.strip
+            s.empty? || (choice_map.keys + choices).include?(s)
+          end
+          q.readline
+        end
+        answer = answer.to_s
+        answer = choice_map[answer] if /^\d+$/.match(answer.strip)
+        answer.strip.empty? ? opts[:default].to_s : answer.strip
+      rescue EOFError
+        Hem.ui.info ""
+        ""
+      end
+    end
+
+    def editor initial_text
+      editor = Hem.user_config.editor.nil? ? ENV['EDITOR'] : Hem.user_config.editor
+      if editor.nil?
+        raise Hem::UndefinedEditorError.new
+      end
+
+      tmp = Tempfile.new('hem_tmp')
+      begin
+        tmp.write initial_text
+        tmp.close
+        system([editor, tmp.path].join(' '))
+        tmp.open
+        return tmp.read
+      rescue Exception => e
+        raise Hem::Error.new e.message
+      ensure
+        tmp.close
+        tmp.unlink
+      end
+    end
+
+    def section title
+      Hem.ui.title title
+      yield
+      Hem.ui.separator
+    end
+
+    def separator
+      info(supports_color? ? "" : "\n")
+    end
+
+    def color *args
+      @out.color *args
+    end
+
+    def debug message
+      say @out, message, :debug
+    end
+
+    def info message
+      say @out, message, :info
+    end
+
+    def warning message
+      say @error, message, :warning
+    end
+
+    def error message
+      say @error, message, :error
+    end
+
+    def success message
+      say @out, message, :success
+    end
+
+    def output message
+      say @out, message, nil
+    end
+
+    def title message
+      say @out, message, :title
+    end
+
+    private
+
+    def say channel, message, color
+      return if message.nil?
+      message = color ? channel.color(message, color) : message
+      channel.say(message) unless logger.level <= Logger::DEBUG
+      logger.debug(message)
+    end
+  end
+end

data/lib/hem/util.rb

@@ -0,0 +1,76 @@
+module Hem
+  class << self
+
+    attr_accessor :project_bar_cache
+
+    def relaunch! env = {}
+      Kernel.exec(env, 'hem', '--skip-host-checks', *$HEM_ARGV)
+    end
+
+    def in_project?
+      !!Hem.project_path
+    end
+
+    def progress file, increment, total, type, opts = {}
+      require 'ruby-progressbar'
+
+      opts = {
+        :title => File.basename(file),
+        :total => total,
+        :format => "%t [%B] %p%% %e"
+      }.merge(opts)
+
+      # Hack to stop newline spam on windows
+      opts[:length] = 79 if Gem::win_platform?
+
+      @progress_bar_cache ||= {}
+
+      if type == :reset
+        type = :update
+        @progress_bar_cache.delete file
+      end
+
+      @progress_bar_cache[file] ||= ProgressBar.create(opts)
+
+      case type
+        when :update
+          @progress_bar_cache[file].progress += increment
+        when :finished
+          @progress_bar_cache[file].finish
+      end
+
+      return @progress_bar_cache[file]
+    end
+
+    def aws_credentials
+      {
+        :access_key_id => maybe(Hem.user_config.aws.access_key_id) || ENV['AWS_ACCESS_KEY_ID'],
+        :secret_access_key => maybe(Hem.user_config.aws.secret_access_key) || ENV['AWS_SECRET_ACCESS_KEY']
+      }
+    end
+
+    def windows?
+      require 'rbconfig'
+      !!(RbConfig::CONFIG['host_os'] =~ /mswin|msys|mingw|cygwin|bccwin|wince|emc/)
+    end
+
+    def system_ruby?
+      require 'rbconfig'
+      File.join(RbConfig::CONFIG["bindir"], RbConfig::CONFIG["ruby_install_name"]).match(/\/rvm\/|\/\.rvm\/|\/\.rbenv/) != nil
+    end
+
+    def chefdk_compat
+      return if maybe(Hem.user_config.hem.disable_chefdk_compat) || ENV['HEM_DISABLE_CHEFDK_COMPAT']
+      return if Hem.windows?
+      which_ruby = File.join(RbConfig::CONFIG["bindir"], RbConfig::CONFIG["ruby_install_name"])
+      if which_ruby =~ /rbenv/
+        split_path = ENV['PATH'].split ':'
+        paths = split_path.reject do |p|
+          p =~ /chefdk/
+        end
+        chef_paths = split_path - paths
+        ENV['PATH'] = (chef_paths + paths).join ':'
+      end
+    end
+  end
+end

data/lib/hem/version.rb

@@ -0,0 +1,3 @@
+module Hem
+  VERSION = '1.0.1-beta1'
+end

data/lib/hem.rb

@@ -0,0 +1,72 @@
+# External deps
+require 'slop'
+require 'rake'
+require 'deepstruct'
+require 'logger'
+
+require 'shellwords'
+require 'fileutils'
+
+# DSL enhancements
+require 'hem/metadata'
+require 'hem/patches/rake'
+require 'hem/patches/slop'
+require 'hem/patches/deepstruct'
+
+# Basics
+require 'hem/version'
+require 'hem/null'
+require 'hem/paths'
+require 'hem/errors'
+require 'hem/logging'
+require 'hem/ui'
+require 'hem/util'
+require 'hem/help_formatter'
+require 'hem/error_handlers/exit_code_map'
+require 'hem/error_handlers/debug'
+require 'hem/error_handlers/friendly'
+require 'hem/config/file'
+require 'hem/config'
+
+# Asset sync
+require 'hem/lib/s3/sync'
+require 'hem/lib/s3/local/file'
+require 'hem/lib/s3/local/iohandler'
+require 'hem/lib/s3/remote/file'
+require 'hem/lib/s3/remote/iohandler'
+
+# Task helpers
+require 'hem/helper/shell'
+require 'hem/helper/file_locator'
+require 'hem/helper/github'
+require 'hem/helper/http_download'
+require 'hem/helper/vm_command'
+
+require 'hem/lib/vm/inspector'
+require 'hem/lib/vm/command'
+
+# Asset applicators
+require 'hem/asset_applicator'
+require 'hem/asset_applicators/sqldump'
+require 'hem/asset_applicators/files'
+
+# Libs
+require 'hem/lib/seed/project'
+require 'hem/lib/seed/replacer'
+require 'hem/lib/seed/seed'
+require 'hem/lib/self_signed_cert_generator'
+require 'hem/lib/github/api'
+require 'hem/lib/github/client'
+
+# Host checks
+require 'hem/lib/host_check/git'
+require 'hem/lib/host_check/vagrant'
+require 'hem/lib/host_check/ruby'
+require 'hem/lib/host_check/deps'
+require 'hem/lib/host_check'
+
+# App
+require 'hem/cli'
+
+# Hobo BC
+Hobo = Hem

data/lib/hobo/tasks/magento.rb

@@ -0,0 +1,3 @@
+Hem.ui.warning 'require \'hobo/tasks/magento\' in Hobofile is deprecated, and will be removed in a future release.'
+
+require 'hem/tasks/magento'

data/spec/hem/asset_applicator_spec.rb

@@ -0,0 +1,30 @@
+
+describe Hem::AssetApplicatorRegistry do
+  describe "asset_applicators accessor" do
+    it "should initialize registry if none exists" do
+      Hem.asset_applicators = nil
+      Hem.asset_applicators.should be_an_instance_of Hem::AssetApplicatorRegistry
+    end
+
+    it "should return registry if exists" do
+      Hem.asset_applicators.register "test" do
+        "test"
+      end
+
+      Hem.asset_applicators["test"].should be_an_instance_of Proc
+      Hem.asset_applicators["test"].call.should match "test"
+    end
+  end
+
+  describe "register" do
+    it "should store passed block with pattern" do
+      registry = Hem::AssetApplicatorRegistry.new
+      registry.register "abc" do
+        "block"
+      end
+
+      registry["abc"].should be_an_instance_of Proc
+      registry["abc"].call.should match "block"
+    end
+  end
+end

data/spec/hem/cli_spec.rb

@@ -0,0 +1,166 @@
+
+describe Hem::Cli do
+  cli = nil
+  help = nil
+  hemfile = nil
+
+  def test_args args
+    args.concat([])
+  end
+
+  before do
+    Rake::Task.tasks.each do |task|
+      task.clear
+    end
+
+    Hem.ui = double(Hem::Ui).as_null_object
+    help = double(Hem::HelpFormatter).as_null_object
+    host_check = double(Hem::Lib::HostCheck).as_null_object
+    cli = Hem::Cli.new help: help, host_check: host_check
+
+    hemfile = File.read(File.join(File.dirname(__FILE__), '../../Hemfile'))
+
+    Hem.project_path = nil
+    FakeFS.activate!
+
+    File.write('Hemfile', hemfile)
+  end
+
+  after do
+    FakeFS::FileSystem.clear
+    FakeFS.deactivate!
+  end
+
+  it "should load the hemfile if present" do
+    cli.start test_args([])
+    Rake::Task["test:non-interactive"].should_not be nil
+  end
+
+  it "should load the user hemfile if present" do
+    FileUtils.mkdir_p(File.dirname(Hem.user_hemfile_path))
+    File.write(Hem.user_hemfile_path, "namespace :user do\ntask :user do\nend\nend")
+    cli.start test_args([])
+    Rake::Task["user:user"].should_not be nil
+  end
+
+  it "should present Hemfile path in eval error" do
+    FileUtils.mkdir_p(File.dirname(Hem.hemfile_path))
+    File.write(Hem.hemfile_path, "An invalid hemfile")
+    begin
+      cli.start test_args([])
+    rescue Exception => e
+      e.backtrace[0].should match 'Hemfile'
+    end
+  end
+
+  it "should load project config if present" do
+    FileUtils.mkdir_p("tools/hem/")
+    File.write("tools/hem/config.yaml", YAML::dump({ :project => "project_config" }))
+    cli.start test_args([])
+    Hem.project_config.project.should match "project_config"
+  end
+
+  it "should load user config if present" do
+    FileUtils.mkdir_p(Hem.config_path)
+    File.write(Hem.user_config_file, YAML::dump({ :user => "user_config" }))
+    cli.start test_args([])
+    Hem.user_config.user.should match "user_config"
+  end
+
+  it "should set command map on help formatter" do
+    help.should_recieve('command_map=')
+    cli.start test_args(["test", "subcommand"])
+  end
+
+  it "should propagate description metadata" do
+    map = nil
+    allow(help).to receive("command_map=") { |i| map = i }
+    cli.start test_args([])
+    map["test:metadata"].description.should match "description"
+  end
+
+  it "should propagate long description metadata" do
+    map = nil
+    allow(help).to receive("command_map=") { |i| map = i }
+    cli.start test_args([])
+    map["test:metadata"].long_description.should match "long description"
+  end
+
+  it "should propagate arg list metadata" do
+    map = nil
+    allow(help).to receive("command_map=") { |i| map = i }
+    cli.start test_args([])
+    expect(map["test:metadata"].arg_list).to eq [ :arg ]
+  end
+
+  it "should propagate option metadata" do
+    map = nil
+    allow(help).to receive("command_map=") { |i| map = i }
+    cli.start test_args([])
+    map["test:metadata"].options.length.should be 2
+    expect(map["test:metadata"].options.map(&:short)).to eq [ 'o', 'h' ]
+    expect(map["test:metadata"].options.map(&:long)).to eq [ 'option', 'help' ]
+    expect(map["test:metadata"].options.map(&:description)).to eq [ 'Option description', 'Display help' ]
+  end
+
+  it "should propagate hidden metadata" do
+    map = nil
+    allow(help).to receive("command_map=") { |i| map = i }
+    cli.start test_args([])
+    map["test:metadata"].hidden.should be true
+  end
+
+  it "should show help if no args or opts passed" do
+    help.should_receive(:help)
+    cli.start(test_args([]))
+  end
+
+  it "should show help for --help" do
+    help.should_receive(:help)
+    cli.start test_args(["--help"])
+  end
+
+  it "should execute a top level command" do
+    Hem.ui.should_recieve(:info).with("top level")
+    cli.start test_args(["top-level"])
+  end
+
+  it "should execute a subcommand" do
+    Hem.ui.should_recieve(:info).with("Subcommand test")
+    cli.start test_args(["test", "subcommand"])
+  end
+
+  it "should show help for a namespace" do
+    help.should_receive(:help).with(all: nil, target: "test")
+    cli.start test_args(["test"])
+  end
+
+  it "should show command help for --help" do
+    help.should_receive(:help).with(all: nil, target: "test:subcommand")
+    cli.start test_args(["test", "subcommand", "--help"])
+  end
+
+  it "should propagate --all option to help" do
+    help.should_receive(:help).with(all: true, target: "test")
+    cli.start test_args(["test", "--all"])
+  end
+
+  it "should propagate command opts to command" do
+    Hem.ui.should_receive(:info).with("1234")
+    cli.start test_args(["test", "option-test", "--testing=1234"])
+  end
+
+  it "should propagate arguments to command" do
+    Hem.ui.should_receive(:info).with("1234")
+    cli.start test_args(["test", "argument-test", "1234"])
+  end
+
+  it "should propagate unparsed arguments in :_unparsed opt" do
+    Hem.ui.should_receive(:info).with("'ls' '--help'")
+    cli.start ["test", "unparsed", "--", "ls", "--help"]
+  end
+
+  it "should raise an exception if not enough arguments were passed" do
+    expect { cli.start(test_args(["test", "metadata"])) }.to raise_error Hem::MissingArgumentsError
+  end
+end