capistrano-unison 0.0.1

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in capistrano-unison.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Josh Nichols
+
+MIT License
+
+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.md

@@ -0,0 +1,63 @@
+# Capistrano::Unison
+
+Capistrano::Unison is a deployment strategy for [Capistrano](http://capify.org/) that uses [Unison](http://www.cis.upenn.edu/~bcpierce/unison/) to syncrhronize the working directory with the filesystem on the remote side. The result is very similar to [Capistrano::Deploy::Strategy::Copy](https://github.com/capistrano/capistrano/blob/master/lib/capistrano/recipes/deploy/strategy/copy.rb), except it is significantly faster and can feasibly used to pull changes on the remote end down.
+
+The main motivation for this is to speed up testing deploys while doing devopsy things with [capistrano]((http://capify.org/), [moonshine](http://github.com/railsmachine/moonshine), [puppet](http://puppetlabs.com/), etc, while avoiding having to commit changes that are still being developed. [capistrano-cowboy](http://github.com/railsmachine/capistrano-cowboy) was our first attempt at this workflow, but for sufficiently large repositories and sufficiently slow uplinks, the feedback cycle is enough to kick a developer out of The Zone(tm).
+
+During initial development, capistrano-cowboy deploys took over 2 minutes, and capistrano-unison depoys took 15 seconds. It was pretty shocking
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    group :development do
+      gem 'capistrano-unison', :require => false
+    end
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install capistrano-unison
+
+## Usage
+
+Add to `config/deploy.rb`:
+
+    require 'capistrano/unison'
+
+You need to install unison locally first, which most packages managers have:
+
+    # on debian/ubuntu
+    $ sudo apt-get install unison # for
+    # on macos with homebrew
+    $ brew install unison
+
+Important note! The major.minor version of unison needs to match on client and server, or it will fail with sads.
+
+You have to do an initial setup to get unison installed on the remote end:
+
+    $ cap <stage> unison:setup
+
+Now you can use the `unison` task to enable unison deploys just for this run:
+
+    $ cap <stage> unison deploy
+
+## TODO
+
+* Don't hardcode local directory '.' (borrow from :repository when using scm none?)
+* Support ignores, like .git
+* Test and document using to pulling remote changes back to local directory
+* Write tests with [capistrano-spec](https://github.com/technicalpickles/capistrano-spec)
+* Reset unison lock files and info, ie that is kept on ~/.unison. Interrupting a unison run can leave these around, and is super annoying to manually remove. unison will spit out what needs to be removed as part of its output, so that could be parsed
+* Test and fix working with conflicting versions of unison on client/server
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/capistrano-unison.gemspec

@@ -0,0 +1,20 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'capistrano/unison/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "capistrano-unison"
+  gem.version       = Capistrano::Unison::VERSION
+  gem.authors       = ["Josh Nichols"]
+  gem.email         = ["josh@technicalpickles.com"]
+  gem.description   = %q{Capistrano::Unison adds support to capistrano for deploying with unison. This lets you synchronize your local working directory with a cache on the remote servers, significantly speeding up deployment times if you are testing a lot of very small changes during deployment.}
+  gem.summary       = %q{Deploy code using capistrano and unison}
+  gem.homepage      = "http://github.com/railsmachine/capistrano-unison"
+  gem.add_dependency('capistrano')
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+end

data/lib/capistrano-unison.rb

@@ -0,0 +1,3 @@
+require "capistrano-unison/version"
+
+require "capistrano/unison"

data/lib/capistrano/recipes/deploy/strategy/unison.rb

@@ -0,0 +1,25 @@
+require 'capistrano/recipes/deploy/strategy/base'
+module Capistrano
+  module Deploy
+    module Strategy
+      class Unison < Base
+        def deploy!
+          find_servers.each do |server|
+            flags = [
+              '-auto',
+              '-batch',
+              '-terse',
+              '-contactquietly',
+              '-force .',
+              '-ignore "Name {.git}"',
+              '-ignore "Name {,.}*{.git}"'
+            ]
+            system "unison #{flags.join(' ')} . ssh://#{server}/#{shared_path}/unison-copy"
+#            abort unless $?.success?
+          end 
+          run "ln -sf #{shared_path}/unison-copy #{release_path}"
+        end 
+      end 
+    end 
+  end 
+end

data/lib/capistrano/unison.rb

@@ -0,0 +1,34 @@
+require 'capistrano'
+
+module Capistrano
+  module Unison
+    def self.load_into(configuration)
+      configuration.load do
+        namespace :unison do
+          task :default do
+            set :repository,  "."
+            set :deploy_via, :unison
+            set :scm, :none
+            after 'moonshine:configure', 'unison:default'
+          end
+          task :setup do
+            sudo "apt-get update"
+            sudo "apt-get install -y unison"
+            copy # do an initial copy
+          end
+          task :copy do
+            find_servers.each do |server|
+              system "unison -auto -batch -contactquietly . ssh://#{server}/#{shared_path}/unison-copy"
+            end
+          end
+        end
+
+      end
+
+    end
+  end
+end
+
+if Capistrano::Configuration.instance
+  Capistrano::Unison.load_into(Capistrano::Configuration.instance)
+end

data/lib/capistrano/unison/version.rb

@@ -0,0 +1,5 @@
+module Capistrano
+  module Unison
+    VERSION = "0.0.1"
+  end
+end

metadata

@@ -0,0 +1,70 @@
+--- !ruby/object:Gem::Specification
+name: capistrano-unison
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Josh Nichols
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-11-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: capistrano
+  requirement: &70331390884500 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70331390884500
+description: Capistrano::Unison adds support to capistrano for deploying with unison.
+  This lets you synchronize your local working directory with a cache on the remote
+  servers, significantly speeding up deployment times if you are testing a lot of
+  very small changes during deployment.
+email:
+- josh@technicalpickles.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- capistrano-unison.gemspec
+- lib/capistrano-unison.rb
+- lib/capistrano/recipes/deploy/strategy/unison.rb
+- lib/capistrano/unison.rb
+- lib/capistrano/unison/version.rb
+homepage: http://github.com/railsmachine/capistrano-unison
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Deploy code using capistrano and unison
+test_files: []
+has_rdoc: