capistrano-local-precompile 0.0.1

data/.gitignore

@@ -0,0 +1,40 @@
+*.gem
+*.rbc
+*.sw[a-p]
+*.tmproj
+*.tmproject
+*.un~
+*~
+.DS_Store
+.Spotlight-V100
+.Trashes
+._*
+.bundle
+.config
+.directory
+.elc
+.emacs.desktop
+.emacs.desktop.lock
+.redcar
+.yardoc
+Desktop.ini
+Gemfile.lock
+Icon?
+InstalledFiles
+Session.vim
+Thumbs.db
+\#*\#
+_yardoc
+auto-save-list
+coverage
+doc
+lib/bundler/man
+pkg
+pkg/*
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+tmtags
+tramp

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--format=nested
+--backtrace

data/.travis.yml

@@ -0,0 +1,8 @@
+bundler_args: --without development
+language: ruby
+rvm:
+  - jruby-19mode
+  - rbx-19mode
+  - 1.9.2
+  - 1.9.3
+  - 2.0.0

data/.yardopts

@@ -0,0 +1,3 @@
+--markup markdown
+-
+LICENSE.md

data/Gemfile

@@ -0,0 +1,17 @@
+source 'https://rubygems.org'
+
+gem 'rake'
+gem 'yard'
+
+group :development do
+  gem 'kramdown'
+  gem 'guard-rspec'
+end
+
+group :test do
+  gem 'rspec'
+  gem 'capistrano-spec'
+  gem 'simplecov', :require => false
+end
+
+gemspec

data/Guardfile

@@ -0,0 +1,6 @@
+guard 'rspec', :version => 2 do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+end
+

data/LICENSE.md

@@ -0,0 +1,20 @@
+Copyright (c) 2013 Steve Agalloco
+
+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,52 @@
+# Capistrano Local Precompile
+
+If your Rails apps are anything like mine, one of the slowest parts of your deployment is waiting for asset pipeline precompilation. It's sometimes so slow, it's painful. So I went searching for some solutions. [turbo-sprockets](https://github.com/ndbroadbent/turbo-sprockets-rails3) helped, but it's not a silver bullet.  This gem isn't a silver bullet either, but it can help.  Capistrano Local Precompile takes a different approach. It builds your assets locally and rsync's them to your web server(s).
+
+## Usage
+
+Add capistrano-local-precompile to your Gemfile:
+
+```ruby
+group :development do
+  gem 'capistrano-local-precompile', require: false
+end
+```
+
+Then add the following line to your `deploy.rb`:
+
+```ruby
+require 'capistrano/local_precompile'
+```
+
+If you are using turbo-sprockets, just set it to enabled. Your asset will still compile locally, but they'll use turbosprockets to do so:
+
+```ruby
+set :turbosprockets_enabled, true
+```
+
+Here's the full set of configurable options:
+
+```ruby
+set :precompile_cmd             # default: bundle exec rake assets:precompile
+set :assets_dir                 # default: "public/assets"
+set :rsync_cmd                  # default: "rsync -av"
+
+set :turbosprockets_enabled     # default: false
+set :turbosprockets_backup_dir  # default: "public/.assets"
+set :cleanexpired_cmd           # default: bundle exec rake assets:clean_expired
+```
+
+## Acknowledgement
+
+This gem is derived from gists by [uhlenbrock][] and [keighl][].
+
+[uhlenbrock]: https://gist.github.com/uhlenbrock/1477596
+[keighl]: https://gist.github.com/keighl/4338134
+
+## Contributing
+
+Pull requests welcome: fork, make a topic branch, commit (squash when possible) *with tests* and I'll happily consider.
+
+## Copyright
+
+Copyright (c) 2013 Steve Agalloco. See [LICENSE](LICENSE.md) for detail

data/Rakefile

@@ -0,0 +1,17 @@
+#!/usr/bin/env rake
+
+require 'bundler/gem_tasks'
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec
+task :test => :spec
+
+require 'yard'
+namespace :doc do
+  YARD::Rake::YardocTask.new do |task|
+    task.files   = ['LICENSE.md', 'lib/**/*.rb']
+    task.options = ['--markup', 'markdown']
+  end
+end

data/capistrano-local-precompile.gemspec

@@ -0,0 +1,23 @@
+# encoding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'capistrano-local-precompile/version'
+
+Gem::Specification.new do |gem|
+  gem.name        = 'capistrano-local-precompile'
+  gem.version     = CapistranoLocalPrecompile::VERSION
+  gem.homepage    = 'https://github.com/spagalloco/capistrano-local-precompile'
+
+  gem.author      = "Steve Agalloco"
+  gem.email       = 'steve.agalloco@gmail.com'
+  gem.description = 'Local asset-pipeline precompilation for Capstrano'
+  gem.summary     = gem.description
+
+  gem.add_dependency 'capistrano'
+
+  gem.executables = `git ls-files -- bin/*`.split("\n").map{|f| File.basename(f)}
+  gem.files       = `git ls-files`.split("\n")
+  gem.test_files  = `git ls-files -- {test,spec,features}/*`.split("\n")
+
+  gem.require_paths = ['lib']
+end

data/lib/capistrano-local-precompile.rb

@@ -0,0 +1 @@
+require 'capistrano/local_precompile'

data/lib/capistrano-local-precompile/version.rb

@@ -0,0 +1,3 @@
+module CapistranoLocalPrecompile
+  VERSION = "0.0.1"
+end

data/lib/capistrano/local_precompile.rb

@@ -0,0 +1,58 @@
+require 'capistrano'
+
+module Capistrano
+  module LocalPrecompile
+
+    def self.load_into(configuration)
+      configuration.load do
+
+        set(:precompile_cmd)   { "#{fetch(:bundle_cmd, "bundle")} exec rake assets:precompile" }
+        set(:cleanexpired_cmd) { "#{fetch(:bundle_cmd, "bundle")} exec rake assets:clean_expired" }
+        set(:assets_dir)       { "public/assets" }
+
+        set(:turbosprockets_enabled)    { false }
+        set(:turbosprockets_backup_dir) { "public/.assets" }
+        set(:rsync_cmd)                 { "rsync -av" }
+
+        before "deploy:assets:precompile", "deploy:assets:prepare"
+        after "deploy:assets:precompile", "deploy:assets:cleanup"
+
+        namespace :deploy do
+          namespace :assets do
+
+            task :cleanup, :on_no_matching_servers => :continue  do
+              if fetch(:turbosprockets_enabled)
+                run_locally "mv #{fetch(:assets_dir)} #{fetch(:turbosprockets_backup_dir)}"
+              else
+                run_locally "rm -rf #{fetch(:assets_dir)}"
+              end
+            end
+
+            task :prepare, :on_no_matching_servers => :continue  do
+              if fetch(:turbosprockets_enabled)
+                run_locally "mkdir -p #{fetch(:turbosprockets_backup_dir)}"
+                run_locally "mv #{fetch(:turbosprockets_backup_dir)} #{fetch(:assets_dir)}"
+                run_locally "#{fetch(:cleanexpired_cmd)}"
+              end
+              run_locally "#{fetch(:precompile_cmd)}"
+            end
+
+            desc "Precompile assets locally and then rsync to app servers"
+            task :precompile, :only => { :primary => true }, :on_no_matching_servers => :continue do
+              servers = find_servers :roles => assets_role, :except => { :no_release => true }
+              servers.each do |srvr|
+                run_locally "#{fetch(:rsync_cmd)} ./#{fetch(:assets_dir)} #{user}@#{srvr}:#{release_path}/#{fetch(:assets_dir)}"
+              end
+            end
+
+          end
+        end
+      end
+    end
+
+  end
+end
+
+if Capistrano::Configuration.instance
+  Capistrano::LocalPrecompile.load_into(Capistrano::Configuration.instance)
+end

data/spec/configuration_spec.rb

@@ -0,0 +1,45 @@
+require 'spec_helper'
+
+describe Capistrano::LocalPrecompile, "configuration" do
+  before do
+    @configuration = Capistrano::Configuration.new
+    Capistrano::LocalPrecompile.load_into(@configuration)
+  end
+
+  it "defines precompile_cmd" do
+    cmd = 'bundle exec rake assets:precompile'
+    expect(@configuration.fetch(:precompile_cmd)).to eq(cmd)
+  end
+
+  it "defines cleanexpired_cmd" do
+    cmd = 'bundle exec rake assets:clean_expired'
+    expect(@configuration.fetch(:cleanexpired_cmd)).to eq(cmd)
+  end
+
+  it "defines assets_dir" do
+    expect(@configuration.fetch(:assets_dir)).to eq('public/assets')
+  end
+
+  it "defines turbosprockets_enabled" do
+    expect(@configuration.fetch(:turbosprockets_enabled)).to be_false
+  end
+
+  it "defines turbosprockets_backup_dir" do
+    dir = 'public/.assets'
+    expect(@configuration.fetch(:turbosprockets_backup_dir)).to eq(dir)
+  end
+
+  it "defines rsync_cmd" do
+    expect(@configuration.fetch(:rsync_cmd)).to eq('rsync -av')
+  end
+
+  it "performs deploy:assets:prepare before deploy:assets:precompile" do
+    expect(@configuration).to callback('deploy:assets:prepare').
+      before('deploy:assets:precompile')
+  end
+
+  it "performs deploy:assets:cleanup after deploy:assets:precompile" do
+    expect(@configuration).to callback('deploy:assets:cleanup').
+      after('deploy:assets:precompile')
+  end
+end

data/spec/integration_spec.rb

@@ -0,0 +1,79 @@
+require 'spec_helper'
+
+describe Capistrano::LocalPrecompile, "integration" do
+  before do
+    @configuration = Capistrano::Configuration.new
+    Capistrano::LocalPrecompile.load_into(@configuration)
+  end
+
+  describe 'cleanup task' do
+    it 'removes the asset files from public/assets' do
+      expect(@configuration).to receive(:run_locally).
+        with('rm -rf public/assets')
+
+      @configuration.find_and_execute_task('deploy:assets:cleanup')
+    end
+  end
+
+  describe 'prepare task' do
+    it 'invokes the precompile command' do
+      expect(@configuration).to receive(:run_locally).
+        with('bundle exec rake assets:precompile').once
+
+      @configuration.find_and_execute_task('deploy:assets:prepare')
+    end
+  end
+
+  describe 'precompile task' do
+    let(:servers) { %w(10.0.1.1 10.0.1.2) }
+
+    before do
+      allow(@configuration).to receive(:run_locally).
+        with('bundle exec rake assets:precompile').once
+      allow(@configuration).to receive(:run_locally).
+        with('rm -rf public/assets').once
+
+
+      allow(@configuration).to receive(:user).and_return('root')
+      allow(@configuration).to receive(:assets_role).and_return('app')
+      allow(@configuration).to receive(:find_servers).and_return(servers)
+      allow(@configuration).to receive(:release_path).and_return('/tmp')
+    end
+
+    it 'rsyncs the local asset files to the server' do
+      expect(@configuration).to receive(:run_locally).with(/rsync -av/).twice
+
+      @configuration.find_and_execute_task('deploy:assets:precompile')
+    end
+  end
+
+  context 'with turbosprockets enabled' do
+    before do
+      @configuration.set :turbosprockets_enabled, true
+    end
+
+    describe 'cleanup task' do
+      it 'moves assets to the configured turbosprockets backup dir' do
+        expect(@configuration).to receive(:run_locally).
+          with('mv public/assets public/.assets')
+
+        @configuration.find_and_execute_task('deploy:assets:cleanup')
+      end
+    end
+
+    describe 'prepare task' do
+      it 'invokes the precompile command' do
+        expect(@configuration).to receive(:run_locally).
+          with('mkdir -p public/.assets').once
+        expect(@configuration).to receive(:run_locally).
+          with('mv public/.assets public/assets').once
+        expect(@configuration).to receive(:run_locally).
+          with('bundle exec rake assets:clean_expired').once
+        expect(@configuration).to receive(:run_locally).
+          with('bundle exec rake assets:precompile').once
+
+        @configuration.find_and_execute_task('deploy:assets:prepare')
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,22 @@
+# coding: utf-8
+unless ENV['CI']
+  require 'simplecov'
+  SimpleCov.start do
+    add_group 'Capistrano', 'lib/capistrano'
+    add_group 'Specs', 'spec/*'
+    add_filter '.bundle'
+  end
+end
+
+require 'capistrano-local-precompile'
+require 'rspec'
+require 'capistrano-spec'
+
+RSpec.configure do |config|
+  config.include Capistrano::Spec::Matchers
+  config.include Capistrano::Spec::Helpers
+
+  config.expect_with :rspec do |c|
+    c.syntax = :expect
+  end
+end

metadata

@@ -0,0 +1,87 @@
+--- !ruby/object:Gem::Specification
+name: capistrano-local-precompile
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Steve Agalloco
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-10-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: capistrano
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Local asset-pipeline precompilation for Capstrano
+email: steve.agalloco@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gemtest
+- .gitignore
+- .rspec
+- .travis.yml
+- .yardopts
+- Gemfile
+- Guardfile
+- LICENSE.md
+- README.md
+- Rakefile
+- capistrano-local-precompile.gemspec
+- lib/capistrano-local-precompile.rb
+- lib/capistrano-local-precompile/version.rb
+- lib/capistrano/local_precompile.rb
+- spec/configuration_spec.rb
+- spec/integration_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/spagalloco/capistrano-local-precompile
+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'
+      segments:
+      - 0
+      hash: -3750338883934434309
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -3750338883934434309
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Local asset-pipeline precompilation for Capstrano
+test_files:
+- spec/configuration_spec.rb
+- spec/integration_spec.rb
+- spec/spec_helper.rb
+has_rdoc: