deplomat 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 67aed2b09a78c6ff894531f065ba7db0bdc60e20
+  data.tar.gz: 848f9cba73c651699f2496b5b871448fbc15fcb6
+SHA512:
+  metadata.gz: 7723cc145303719df54eb436a43a012b02e5180ab8fc56d08d121fe3ec1ed6a4b1fffa8befa7dd4d4cb22db0178e9d214e480b4884a062ebe4b5a42357f1eb2e
+  data.tar.gz: 6298c99481b28878c15763b0aeed01e99697c3621a677f35027cedb50410f9faaae0ab4f526e753be48d6741acbedd56f214d56f8c3422eef3c3252be32684d3

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,10 @@
+source "http://rubygems.org"
+
+gem "sys-proctable"
+gem "colorize"
+
+group :development do
+  gem "bundler", "~> 1.0"
+  gem "jeweler"
+  gem "rspec"
+end

data/Gemfile.lock

@@ -0,0 +1,78 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    addressable (2.4.0)
+    builder (3.2.2)
+    colorize (0.7.7)
+    descendants_tracker (0.0.4)
+      thread_safe (~> 0.3, >= 0.3.1)
+    diff-lcs (1.2.5)
+    faraday (0.9.2)
+      multipart-post (>= 1.2, < 3)
+    git (1.3.0)
+    github_api (0.13.1)
+      addressable (~> 2.4.0)
+      descendants_tracker (~> 0.0.4)
+      faraday (~> 0.8, < 0.10)
+      hashie (>= 3.4)
+      multi_json (>= 1.7.5, < 2.0)
+      oauth2
+    hashie (3.4.4)
+    highline (1.7.8)
+    jeweler (2.1.1)
+      builder
+      bundler (>= 1.0)
+      git (>= 1.2.5)
+      github_api
+      highline (>= 1.6.15)
+      nokogiri (>= 1.5.10)
+      rake
+      rdoc
+      semver
+    json (1.8.3)
+    jwt (1.5.1)
+    mini_portile2 (2.0.0)
+    multi_json (1.11.3)
+    multi_xml (0.5.5)
+    multipart-post (2.0.0)
+    nokogiri (1.6.7.2)
+      mini_portile2 (~> 2.0.0.rc2)
+    oauth2 (1.1.0)
+      faraday (>= 0.8, < 0.10)
+      jwt (~> 1.0, < 1.5.2)
+      multi_json (~> 1.3)
+      multi_xml (~> 0.5)
+      rack (>= 1.2, < 3)
+    rack (1.6.4)
+    rake (11.1.2)
+    rdoc (4.2.2)
+      json (~> 1.4)
+    rspec (3.4.0)
+      rspec-core (~> 3.4.0)
+      rspec-expectations (~> 3.4.0)
+      rspec-mocks (~> 3.4.0)
+    rspec-core (3.4.4)
+      rspec-support (~> 3.4.0)
+    rspec-expectations (3.4.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.4.0)
+    rspec-mocks (3.4.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.4.0)
+    rspec-support (3.4.1)
+    semver (1.0.1)
+    sys-proctable (1.0.0)
+    thread_safe (0.3.5)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0)
+  colorize
+  jeweler
+  rspec
+  sys-proctable
+
+BUNDLED WITH
+   1.12.0

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2016 Roman Snitko
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,3 @@
+= deplomat
+
+Stack agnostic deployment system that uses bash and ssh commands.

data/Rakefile

@@ -0,0 +1,25 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://guides.rubygems.org/specification-reference/ for more options
+  gem.name = "deplomat"
+  gem.homepage = "http://github.com/snitko/deplomat"
+  gem.license = "MIT"
+  gem.summary = %Q{Stack agnostic deployment system that uses bash and ssh commands}
+  gem.description = %Q{Stack agnostic deployment system that uses bash and ssh commands}
+  gem.email = "roman.snitko@gmail.com"
+  gem.authors = ["Roman Snitko"]
+  # dependencies defined in Gemfile
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.1

data/deplomat.gemspec

@@ -0,0 +1,77 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+# stub: deplomat 0.1.1 ruby lib
+
+Gem::Specification.new do |s|
+  s.name = "deplomat"
+  s.version = "0.1.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.require_paths = ["lib"]
+  s.authors = ["Roman Snitko"]
+  s.date = "2016-07-05"
+  s.description = "Stack agnostic deployment system that uses bash and ssh commands"
+  s.email = "roman.snitko@gmail.com"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "examples/simple_deploy.rb",
+    "lib/deplomat.rb",
+    "lib/deplomat/directives.rb",
+    "lib/deplomat/exceptions.rb",
+    "lib/deplomat/local_node.rb",
+    "lib/deplomat/node.rb",
+    "lib/deplomat/remote_node.rb",
+    "spec/directives_spec.rb",
+    "spec/fixtures/cleaning/.keep",
+    "spec/fixtures/dir1/file1",
+    "spec/fixtures/dir1/file2",
+    "spec/fixtures/upload1/uploaded_file1",
+    "spec/fixtures/upload1/uploaded_file2",
+    "spec/local_node_spec.rb",
+    "spec/node_spec.rb",
+    "spec/remote_node_spec.rb",
+    "spec/spec_helper.rb"
+  ]
+  s.homepage = "http://github.com/snitko/deplomat"
+  s.licenses = ["MIT"]
+  s.rubygems_version = "2.5.1"
+  s.summary = "Stack agnostic deployment system that uses bash and ssh commands"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 4
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<sys-proctable>, [">= 0"])
+      s.add_runtime_dependency(%q<colorize>, [">= 0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0"])
+      s.add_development_dependency(%q<jeweler>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, [">= 0"])
+    else
+      s.add_dependency(%q<sys-proctable>, [">= 0"])
+      s.add_dependency(%q<colorize>, [">= 0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0"])
+      s.add_dependency(%q<jeweler>, [">= 0"])
+      s.add_dependency(%q<rspec>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<sys-proctable>, [">= 0"])
+    s.add_dependency(%q<colorize>, [">= 0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0"])
+    s.add_dependency(%q<jeweler>, [">= 0"])
+    s.add_dependency(%q<rspec>, [">= 0"])
+  end
+end
+

data/examples/simple_deploy.rb

@@ -0,0 +1,22 @@
+# This is an example of a deployment script. This file is not executable and uses a simple DSL
+# which is implemented using Ruby. Thus, it may contain valid ruby code, but it's not necessary
+# to know Ruby to write deployment scripts - all that's required is to know a few simple common
+# deplomat directives.
+
+# executes right away, but only in particular environment
+execute_in env: "staging" do
+  $db  = new_node host: "0.0.0.0", port: 1234, user: "deploy" 
+  $app = new_node host: "0.0.0.0", port: 1234, user: "deploy" 
+end
+
+# doesn't execute right away and awaits until called with `execute :compile_assets` 
+partial 'compile_assets' do
+  $db.execute  "echo compiling assets..."
+  $app.execute "echo compiling assets..."
+end
+
+partial 'run_migrations' do |args|
+  args[:server].execute "rake db:migrate"
+end
+
+execute_partial 'run_migrations', node: $app

data/lib/deplomat/directives.rb

@@ -0,0 +1,25 @@
+$partials = {}
+
+def execute_in(env:)
+  yield if $env == env
+end
+
+def execute_partial(name, args={})
+  print_to_terminal $partials[name][:before_message]
+  $partials[name][:block].call(args)
+  print_to_terminal $partials[name][:after_message]
+end
+
+def partial(name, message: [], &block)
+  message         = [message] if message.kind_of?(String)
+  before_message  = message[0]
+  after_message   = message[1]
+  $partials[name] = { block: block, before_message: before_message, after_message: after_message }
+end
+
+def print_to_terminal(message, color: nil, newline: true)
+  return unless message
+  message += "\n" if newline
+  message = message.send(color) if color
+  $stdout.print message
+end

data/lib/deplomat/exceptions.rb

@@ -0,0 +1,4 @@
+module Deplomat
+  class ExecutionError  < Exception;end
+  class NoSuchPathError < Exception;end
+end

data/lib/deplomat/local_node.rb

@@ -0,0 +1,13 @@
+module Deplomat
+
+  class LocalNode < Node
+
+    private
+
+      def path_exist?(path)
+        File.exist?(path)
+      end
+
+  end
+
+end

data/lib/deplomat/node.rb

@@ -0,0 +1,149 @@
+module Deplomat
+
+  class Node
+
+    attr_accessor :log_to, :raise_exceptions, :logfile
+    attr_reader   :current_path
+
+    def initialize(logfile: "#{Dir.pwd}/deplomat.log", log_to: [:stdout])
+      @log_to  = log_to
+      @logfile = logfile
+    end
+
+    def execute(command, path=@current_path, message: [], stdout_source: :stdout, log_command: true)
+
+      message = [message] if message.kind_of?(String)
+      log(message[0] + "\n", color: 'white') unless message.empty? || message.nil?
+
+      # Respect current_path
+      command_to_log = command
+      if path
+        command_to_log = "#{command}\n(in #{path})"
+        command = "cd #{path} && #{command}"
+      end
+
+      out    = ""
+      status = nil
+      Open3.popen3(command) do |stdin, stdout, stderr, thread|
+
+        # Sometimes, programs write in stderr, although there are no errors.
+        # rake assets:precompile does that, for example.
+        stdout_source_object = (stdout_source == :stderr ? stderr : stdout) 
+
+        log("--> " + command_to_log + "\n", color: "white") if log_command
+        while line=stdout_source_object.gets do 
+          out << line
+          log("  #{line}")
+        end
+
+        error_out = ""
+        status = thread.value.exitstatus.to_i
+        if status > 0
+          while o = stderr.gets
+            error_out += o
+          end
+          log(error_out + "\n", color: 'red')
+          if @raise_exceptions
+            self.close if self.respond_to?(:close)
+            raise Deplomat::ExecutionError 
+          end
+        end
+        yield if block_given?
+      end
+
+      log(message[1] + "\n", color: 'white') unless message.empty? || message.nil?
+
+      return { status: status, out: out }
+    end
+
+    def copy(what, where)
+      execute("rsync -ar #{what} #{where}")
+    end
+    alias :cp :copy
+
+    def move(what, where)
+      execute("mv #{what} #{where}")
+    end
+    alias :mv :move
+
+    def remove(what)
+      execute("rm -rf #{what}")
+    end
+    alias :rm :remove
+
+    def create_file(filename)
+      execute("touch #{filename}")
+    end
+    alias :touch :create_file
+
+    def create_dir(dirname)
+      execute("mkdir #{dirname}")
+    end
+    alias :mkdir :create_dir
+
+    def create_symlink(source, target)
+      execute("ln -s #{source} #{target}")
+    end
+    alias :ln :create_symlink
+
+    def cd(path)
+      @current_path = if path =~ /\A[\/~]/ || path.nil?
+        path
+      else
+        File.expand_path("#{@current_path}#{path}")
+      end
+      raise Deplomat::NoSuchPathError, @current_path if !@current_path.nil? && !path_exist?(@current_path)
+
+      # Making sure we don't end up with double // at the end of the path
+      @current_path = @current_path.chomp("/") + "/"
+    end
+
+    def git_push(remote="origin", branch="master")
+      execute("git push -u #{remote} #{branch}")
+    end
+
+    def git_pull(remote="origin", branch="master")
+      execute("git pull #{remote} #{branch}")
+    end
+
+    def git_merge(source="origin", target="master")
+      execute("git merge #{source} #{target}")
+    end
+
+    def git_checkout(target)
+      execute("git checkout #{target}")
+    end
+
+    def clean(path: @current_path, except: [], leave: [0, :last])
+      # Gets us all entries sorted by date, most recent ones first
+      entries_by_date = execute("ls -t", path)[:out].split("\n")
+      # Don't do anything with entries listed in :except
+      entries_by_date = entries_by_date - except
+      if leave
+        entries_by_date.reverse! if leave[1] == :first
+        entries_by_date = entries_by_date[leave[0]..entries_by_date.length]
+      end
+      entries_by_date.each { |entry| remove("#{path}#{entry}") }
+    end
+
+    private
+
+      def log(line, color: 'light_black')
+        @message_color = color
+        # Only calls log methods mentioned in the @log_to property
+        @log_to.each { |logger| self.send("log_to_#{logger}", line) }
+      end
+
+      def log_to_file(line)
+        if @logfile
+          open(@logfile, 'a') { |f| f.puts line }
+        end
+      end
+
+      def log_to_stdout(line)
+        print_to_terminal(line, color: @message_color, newline: false)
+      end
+
+  end
+
+end

data/lib/deplomat/remote_node.rb

@@ -0,0 +1,63 @@
+module Deplomat
+  class RemoteNode < Node
+
+    def initialize(host:, port: 22, user: "deploy")
+      super()
+
+      # Create ControlMasters dir, user might not have it
+      unless File.exists?("#{ENV['HOME']}/.ssh/controlmasters/")
+        Dir.mkdir("#{ENV['HOME']}/.ssh/controlmasters/") 
+      end
+
+      # Establish connection
+      first_ssh_command = "ssh -MNfS #{ENV['HOME']}/.ssh/controlmasters/%r@%h:%p #{user}@#{host} -p #{port} -o ControlPersist=10m"
+      system first_ssh_command
+
+      # get background process id by the full command name
+      Sys::ProcTable.ps.each do |process|
+        if process.cmdline.match(first_ssh_command)
+          @pid = process.pid.to_i 
+          puts "Connected with ssh, host #{host}, pid #{@pid}."
+          break
+        end
+      end
+
+      @ssh_command = "ssh -S #{ENV['HOME']}/.ssh/controlmasters/%r@%h:%p #{user}@#{host} -p #{port}"
+
+      @host = host
+      @user = user
+      @port = port
+    end
+
+    alias :local_execute :execute
+    def execute(command, path=@current_path, message: [], env_vars: '', login_shell: false, stdout_source: :stdout)
+
+      log("(#{@host}) --> " + command + "\n", color: "white")
+      command = "#{env_vars} cd #{path} && #{command}"  if path
+      command = "bash -l -c \"#{command}\"" if login_shell
+      super("#{@ssh_command} '#{command}'", nil, message: message, stdout_source: stdout_source, log_command: false)
+    end
+
+    def upload(what, where)
+      local_execute "rsync -arz #{what} #{@user}@#{@host}:#{where} --port=#{@port}"
+    end
+
+    def close
+      begin
+        puts "Closing connection to #{@host}."
+        Process.kill 'KILL', @pid
+      rescue Errno::ESRCH
+        puts "WARNING: no process with #{@pid} found, no connection to close!"
+      end
+    end
+
+    private
+
+      def path_exist?(path)
+        old_raise_exceptions = @raise_exceptions
+        @raise_exceptions    = false
+        !(execute("ls #{path}", nil){ @raise_exceptions = old_raise_exceptions}[:status] > 0)
+      end
+
+  end
+end

data/lib/deplomat.rb

@@ -0,0 +1,8 @@
+require 'sys/proctable'
+require 'open3'
+require 'colorize'
+require_relative 'deplomat/exceptions'
+require_relative 'deplomat/node'
+require_relative 'deplomat/local_node'
+require_relative 'deplomat/remote_node'
+require_relative 'deplomat/directives'

data/spec/directives_spec.rb

@@ -0,0 +1,25 @@
+require 'spec_helper'
+
+describe "directives" do
+
+  it "executes arbitrary ruby code in a particular environment" do
+    $env = 'staging'
+    expect(self).to receive(:hello).exactly(1).times
+    execute_in(env: 'staging')    { hello() }
+    execute_in(env: 'production') { hello() }
+  end
+
+  it "creates a partial" do
+    partial("hello_partial") { hello() }
+    expect($partials["hello_partial"][:block]).to be_kind_of(Proc)
+  end
+
+  it "executes a partial" do
+    expect(self).to receive(:hello).with("hello").exactly(1).times
+    partial("hello_partial") { |args| hello(args[:x]) }
+    execute_partial "hello_partial", x: 'hello'
+  end
+
+  it "passes before and after messages"
+
+end

data/spec/local_node_spec.rb

@@ -0,0 +1,180 @@
+require 'spec_helper'
+
+describe Deplomat::LocalNode do
+
+  before(:each) do
+    @fixtures_dir = Dir.pwd + "/spec/fixtures"
+    @localhost = Deplomat::LocalNode.new
+    @localhost.log_to = []
+    @localhost.raise_exceptions = false
+  end
+
+  after(:each) do
+    FileUtils.rm_r(Dir.glob("#{@fixtures_dir}/dir2/*"))
+  end
+
+  describe "filesystem operations" do
+
+    it "copies files to another folder" do
+      @localhost.copy("#{@fixtures_dir}/dir1/*", "#{@fixtures_dir}/dir2/")
+      expect(File.exist?("#{@fixtures_dir}/dir2/file1")).to be_truthy
+      expect(File.exist?("#{@fixtures_dir}/dir2/file2")).to be_truthy
+    end
+
+    it "moves files and dirs to another directory" do
+      @localhost.move("#{@fixtures_dir}/dir1/*", "#{@fixtures_dir}/dir2/")
+      expect(File.exist?("#{@fixtures_dir}/dir2/file1")).to be_truthy
+      expect(File.exist?("#{@fixtures_dir}/dir2/file2")).to be_truthy
+      expect(File.exist?("#{@fixtures_dir}/dir2/subdir1")).to be_truthy
+      expect(File.exist?("#{@fixtures_dir}/dir1/file1")).to be_falsy
+      expect(File.exist?("#{@fixtures_dir}/dir1/file2")).to be_falsy
+      expect(File.exist?("#{@fixtures_dir}/dir1/subdir1")).to be_falsy
+
+      @localhost.move("#{@fixtures_dir}/dir2/*", "#{@fixtures_dir}/dir1/")
+      expect(File.exist?("#{@fixtures_dir}/dir1/file1")).to be_truthy
+      expect(File.exist?("#{@fixtures_dir}/dir1/file2")).to be_truthy
+      expect(File.exist?("#{@fixtures_dir}/dir1/subdir1")).to be_truthy
+      expect(File.exist?("#{@fixtures_dir}/dir2/file1")).to be_falsy
+      expect(File.exist?("#{@fixtures_dir}/dir2/file2")).to be_falsy
+      expect(File.exist?("#{@fixtures_dir}/dir2/subdir1")).to be_falsy
+    end
+
+    it "removes files and dirs" do
+      @localhost.copy("#{@fixtures_dir}/dir1/*", "#{@fixtures_dir}/dir2/")
+      @localhost.remove("#{@fixtures_dir}/dir2/*")
+      expect(File.exist?("#{@fixtures_dir}/dir2/file1")).to be_falsy
+      expect(File.exist?("#{@fixtures_dir}/dir2/file2")).to be_falsy
+      expect(File.exist?("#{@fixtures_dir}/dir2/subdir1")).to be_falsy
+    end
+
+    it "changes current directory" do
+      @localhost.cd("/etc")
+      expect(@localhost.current_path).to eq("/etc/") 
+      expect(-> { @localhost.cd("/non-existent-path") }).to raise_exception(Deplomat::NoSuchPathError)
+    end
+
+    it "executes commands from the current directory" do
+      @localhost.cd("#{@fixtures_dir}/dir1")
+      expect(@localhost.execute("ls")[:out]).to eq("file1\nfile2\nsubdir1\n")
+    end
+
+    it "creates an empty file" do
+      @localhost.cd("#{@fixtures_dir}/dir2")
+      @localhost.touch("myfile")
+      expect(@localhost.execute("ls")[:out]).to have_files("myfile")
+    end
+
+    it "creates a directory" do
+      @localhost.cd("#{@fixtures_dir}/dir2")
+      @localhost.mkdir("mydir")
+      expect(@localhost.execute("ls")[:out]).to have_files("mydir")
+    end
+
+    it "creates a symlink" do
+      @localhost.cd("#{@fixtures_dir}/dir2")
+      @localhost.create_symlink("../dir1", "./")
+      expect(@localhost.execute("ls dir1")[:out]).to have_files("file1", "file2", "subdir1")
+    end
+
+  end
+
+  describe "handling status and errors" do
+
+    it "returns the status" do
+      expect(@localhost.execute("ls #{@fixtures_dir}/dir1/")[:status]).to eq(0)
+      expect(@localhost.execute("ls #{@fixtures_dir}/non-existent-dir/")[:status]).to eq(2)
+    end
+
+    it "raises execution error when command fails" do
+      @localhost.raise_exceptions = true
+      expect( -> { @localhost.execute("ls #{@fixtures_dir}/non-existent-dir/")[:status] }).to raise_exception(Deplomat::ExecutionError)
+    end
+
+  end
+
+  describe "cleaning" do
+
+    before(:each) do
+      @localhost.cd("#{@fixtures_dir}/cleaning")
+      @localhost.execute("touch file1 file2 file3")
+      @localhost.execute("mkdir current")
+      sleep(0.01)
+      @localhost.execute("mkdir dir1 dir2 dir3")
+    end
+
+    after(:each) do
+      @localhost.execute("rm -rf #{@fixtures_dir}/cleaning/*")
+    end
+
+    it "cleans all the files and dirs in a given directory" do
+      @localhost.clean
+      expect(@localhost.execute('ls')[:out]).to be_empty
+    end
+
+    it "cleans all but last 3 entries in a given directory" do
+      @localhost.clean(leave: [3, :last])
+      expect(@localhost.execute('ls')[:out]).to eq("dir1\ndir2\ndir3\n")
+    end
+
+    it "cleans all, but :except entries in a given directory" do
+      @localhost.clean(except: ["current"])
+      expect(@localhost.execute('ls')[:out]).to eq("current\n")
+    end
+
+  end
+
+  describe "git commands" do
+
+    before(:all) do
+      @fixtures_dir = Dir.pwd + "/spec/fixtures"
+      @localhost_git = Deplomat::LocalNode.new
+      @localhost_git.log_to = [:stdout]
+      @localhost_git.cd(@fixtures_dir)
+      @localhost_git.mkdir("git_repo")
+      @localhost_git.cd("git_repo")
+      @localhost_git.touch("file1")
+      @localhost_git.execute("git init && git add .")
+      @localhost_git.execute("git remote add origin deploy@deplomat-test-node:/home/deploy/deplomat/.git_repo")
+      @remote_node = Deplomat::RemoteNode.new(host: "deplomat-test-node", user: "deploy")
+      @remote_node.log_to = [:stdout]
+      @remote_node.execute("cd ~/deplomat && mkdir .git_repo && cd .git_repo && git --bare init")
+      @localhost_git.cd("#{@fixtures_dir}/git_repo")
+      @localhost_git.execute("git commit -m \"Initial commit\"")
+
+      @localhost_git.raise_exceptions = true
+      @remote_node.raise_exceptions   = true
+    end
+
+    after(:all) do
+      @remote_node.remove("~/deplomat/.git_repo")
+      @localhost_git.remove("#{@fixtures_dir}/git_repo")
+    end
+    
+    it "pushes to remote" do
+      expect(@localhost_git.git_push[:status]).to eq(0)
+    end
+
+    it "pulls from remote" do
+      expect(@localhost_git.git_pull[:status]).to eq(0)
+    end
+
+    it "merges branches" do
+      @localhost_git.execute("git checkout -b dev1")
+      @localhost_git.touch("file2")
+      @localhost_git.execute("git add . && git commit -m \"adding file2\"")
+      @localhost_git.execute("git checkout master")
+      expect(@localhost_git.git_merge("dev1", "master")[:status]).to eq(0)
+      expect(File.exist?("#{@fixtures_dir}/git_repo/file2")).to be_truthy
+    end
+
+    it "checks out into a branch" do
+      @localhost_git.execute("git branch dev2")
+      @localhost_git.touch("file3")
+      @localhost_git.execute("git add . && git commit -m \"adding file3\"")
+      @localhost_git.git_checkout("dev2")
+      expect(File.exist?("#{@fixtures_dir}/git_repo/file3")).to be_falsy
+    end
+
+  end
+
+end

data/spec/node_spec.rb

@@ -0,0 +1,41 @@
+require 'spec_helper'
+
+describe Deplomat::Node do
+
+  describe "logging" do
+
+    before(:each) do
+      @fixtures_dir = Dir.pwd + "/spec/fixtures"
+      @node = Deplomat::Node.new(logfile: "#{@fixtures_dir}/deplomat.log", log_to: [:file, :stdout])
+    end
+
+    after(:each) do
+      @node.log_to = []
+      @node.remove("#{@fixtures_dir}/deplomat.log")
+    end
+
+    it "logs to the stdout" do
+      expect($stdout).to receive(:print).exactly(4).times
+      @node.execute("ls #{@fixtures_dir}/dir1")
+    end
+
+    it "logs to a log file" do
+      @node.log_to = [:file]
+      @node.execute("ls #{@fixtures_dir}/dir1")
+      log = File.readlines("#{@fixtures_dir}/deplomat.log")
+      expect(log.size).to eq(4)
+    end
+
+    it "puts additional messages into the terminal when required" do
+      expect($stdout).to receive(:print).once.with("hello\n".white)
+      expect($stdout).to receive(:print).once.with("--> ls /home/roman/Dropbox/Work/my_libs/deplomat/spec/fixtures/dir1\n".white)
+      expect($stdout).to receive(:print).once.with("  file1\n".light_black)
+      expect($stdout).to receive(:print).once.with("  file2\n".light_black)
+      expect($stdout).to receive(:print).once.with("  subdir1\n".light_black)
+      expect($stdout).to receive(:print).once.with("bye\n".white)
+      @node.execute("ls #{@fixtures_dir}/dir1", message: ["hello", "bye"])
+    end
+
+  end
+
+end

data/spec/remote_node_spec.rb

@@ -0,0 +1,132 @@
+require 'spec_helper'
+
+describe Deplomat::RemoteNode do
+
+  before(:all) do
+    @fixtures_dir       = "/home/deploy/deplomat"
+    @local_fixtures_dir = Dir.pwd + "/spec/fixtures"
+    @node = Deplomat::RemoteNode.new(host: "deplomat-test-node", user: "deploy")
+    @node.log_to = []
+  end
+
+  before(:each) do
+    @node.raise_exceptions = true
+  end
+
+  after(:all) do
+    @node.close
+  end
+
+  after(:each) do
+    @node.raise_exceptions = false
+    @node.execute("rm -rf #{@fixtures_dir}/dir2/*")
+    @node.execute("rm -rf #{@fixtures_dir}/uploaded1/*")
+    @node.execute("rm -rf #{@fixtures_dir}/uploaded2/*")
+  end
+
+  describe "filesystem operations" do
+
+    it "copies files to another folder" do
+      @node.copy("#{@fixtures_dir}/dir1/*", "#{@fixtures_dir}/dir2/")
+      expect(@node.execute("ls #{@fixtures_dir}/dir2/")[:out]).to have_files("file1", "file2", "subdir1")
+    end
+
+    it "moves files and dirs from one directory into another" do
+      @node.move("#{@fixtures_dir}/dir1/*", "#{@fixtures_dir}/dir2/")
+      expect(@node.execute("ls #{@fixtures_dir}/dir1/")[:out]).to eq("")
+      expect(@node.execute("ls #{@fixtures_dir}/dir2/")[:out]).to have_files("file1", "file2", "subdir1")
+      @node.move("#{@fixtures_dir}/dir2/*", "#{@fixtures_dir}/dir1/")
+      expect(@node.execute("ls #{@fixtures_dir}/dir2/")[:out]).to eq("")
+      expect(@node.execute("ls #{@fixtures_dir}/dir1/")[:out]).to have_files("file1", "file2", "subdir1")
+    end
+
+    it "removes files and dirs" do
+      @node.copy("#{@fixtures_dir}/dir1/*", "#{@fixtures_dir}/dir2/")
+      expect(@node.execute("ls #{@fixtures_dir}/dir2/")[:out]).to have_files("file1", "file2", "subdir1")
+      @node.remove("#{@fixtures_dir}/dir2/*")
+      expect(@node.execute("ls #{@fixtures_dir}/dir2/")[:out]).to eq("")
+    end
+
+    it "uploads files from localhost to the node" do
+      @node.upload("#{@local_fixtures_dir}/upload1/*", "#{@fixtures_dir}/uploaded1/")
+      expect(@node.execute("ls #{@fixtures_dir}/uploaded1/")[:out]).to have_files("uploaded_file1", "uploaded_file2")
+    end
+
+    it "changes current directory" do
+      #@node.cd("/etc")
+      #expect(@node.current_path).to eq("/etc/") 
+      expect(-> { @node.cd("/non-existent-path") }).to raise_exception(Deplomat::NoSuchPathError)
+    end
+
+    it "executes commands from the current directory" do
+      @node.cd("#{@fixtures_dir}/dir1")
+      expect(@node.execute("ls")[:out]).to have_files("file1", "file2", "subdir1")
+    end
+
+    it "creates an empty file" do
+      @node.cd("#{@fixtures_dir}/dir2")
+      @node.touch("myfile")
+      expect(@node.execute("ls")[:out]).to have_files("myfile")
+    end
+
+    it "creates a directory" do
+      @node.cd("#{@fixtures_dir}/dir2")
+      @node.mkdir("mydir")
+      expect(@node.execute("ls")[:out]).to have_files("mydir")
+    end
+
+    it "creates a symlink" do
+      @node.cd("#{@fixtures_dir}/dir2")
+      @node.create_symlink("../dir1", "./")
+      expect(@node.execute("ls dir1")[:out]).to have_files("file1", "file2", "subdir1")
+    end
+
+  end
+
+  describe "handling status and errors" do
+
+    it "returns the status" do
+      @node.raise_exceptions = false
+      expect(@node.execute("ls #{@fixtures_dir}/dir1/")[:status]).to eq(0)
+      expect(@node.execute("ls #{@fixtures_dir}/non-existent-dir/")[:status]).to eq(2)
+    end
+
+    it "raises execution error when command fails" do
+      @node.raise_exceptions = true
+      expect( -> { @node.execute("ls #{@fixtures_dir}/non-existent-dir/")[:status] }).to raise_exception(Deplomat::ExecutionError)
+    end
+
+  end
+
+  describe "cleaning" do
+
+    before(:each) do
+      @node.cd("#{@fixtures_dir}/cleaning")
+      @node.execute("touch file1 file2 file3")
+      @node.execute("mkdir current")
+      sleep(0.01)
+      @node.execute("mkdir dir1 dir2 dir3")
+    end
+
+    after(:each) do
+      @node.execute("rm -rf #{@fixtures_dir}/cleaning/*")
+    end
+
+    it "cleans all the files and dirs in a given directory" do
+      @node.clean
+      expect(@node.execute('ls')[:out]).to be_empty
+    end
+
+    it "cleans all but last 3 entries in a given directory" do
+      @node.clean(leave: [3, :last])
+      expect(@node.execute('ls')[:out]).to eq("dir1\ndir2\ndir3\n")
+    end
+
+    it "cleans all, but :except entries in a given directory" do
+      @node.clean(except: ["current"])
+      expect(@node.execute('ls')[:out]).to eq("current\n")
+    end
+
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,17 @@
+require 'rspec/expectations'
+require "fileutils"
+require_relative "../lib/deplomat"
+
+RSpec::Matchers.define :have_files do |*expected|
+  match do |actual|
+    actual = actual.split("\n")
+    actual.pop if actual.last == ""
+    expected.each do |e|
+      return false unless actual.include?(e)
+    end
+    true
+  end
+  failure_message do |actual|
+    "expected these files in the directory:\n\t#{actual.split("\n").inspect}\nwould include all of these:\n\t#{expected.inspect}"
+  end
+end

metadata

@@ -0,0 +1,141 @@
+--- !ruby/object:Gem::Specification
+name: deplomat
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Roman Snitko
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-07-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sys-proctable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Stack agnostic deployment system that uses bash and ssh commands
+email: roman.snitko@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.rdoc
+files:
+- ".document"
+- ".rspec"
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- deplomat.gemspec
+- examples/simple_deploy.rb
+- lib/deplomat.rb
+- lib/deplomat/directives.rb
+- lib/deplomat/exceptions.rb
+- lib/deplomat/local_node.rb
+- lib/deplomat/node.rb
+- lib/deplomat/remote_node.rb
+- spec/directives_spec.rb
+- spec/fixtures/cleaning/.keep
+- spec/fixtures/dir1/file1
+- spec/fixtures/dir1/file2
+- spec/fixtures/upload1/uploaded_file1
+- spec/fixtures/upload1/uploaded_file2
+- spec/local_node_spec.rb
+- spec/node_spec.rb
+- spec/remote_node_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/snitko/deplomat
+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: Stack agnostic deployment system that uses bash and ssh commands
+test_files: []