capistrano-rsync-bladrak 1.0.2

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    NGRlMGYwMGE4YjY1NzZmNjRiYmZiZGEwZTlkYmFiMTMyNWRiMmE3OQ==
+  data.tar.gz: !binary |-
+    YTczM2VlOGNmOGIwNTYxMzc0ZmZmNDA0MjQ3MWVjY2JmYTk5MmQwYg==
+SHA512:
+  metadata.gz: !binary |-
+    MjFkNjRhOGJiNTYxZmIxYjM3NDhiOTliNDY5NDgxYjg1NGQ1ZGIwNzkwZTc4
+    MzU3ZDY1ZDRlNjM2YzA4OWRiMmE3NmQ1OGQ4OTMxYzYyNmM4ZmJhMGU3MGE5
+    NTIxMTQyZjFjMWZhMjU0YjhmYzRmMDViZWM5NmVkZTI2MmNlNjc=
+  data.tar.gz: !binary |-
+    M2U1ZTdjNWExNDU0MWMxNWJjM2Y3ZmFiMGE4NmE0ODNiZmQyNDJjNGQ0MzIz
+    Yjc3MWM3MTcyNzRlNTczMzA0YzdjMzNlM2JmN2VkOTA0OGY4MWNiZDNkNDFl
+    MDVlMzExNzY0ZDlkNTRhMzZjNzRiMTNmYmNkYTY4YWUzNjU3ZTU=

data/.gitignore

@@ -0,0 +1 @@
+/*.gem

data/CHANGELOG.md

@@ -0,0 +1,23 @@
+## 1.0.2 (Oct 13, 2013)
+- Updates README and code comments.
+
+## 1.0.1 (Sep 2, 2013)
+- Updates README and adds implementation details to it.
+
+## 1.0.0 (Sep 2, 2013)
+- Makes the `rsync:stage` task public for extending and hooking.
+- Renames `rsync:create_release` to `rsync:release`. Old name still works.
+- Adds optional caching to `rsync_cache` directory on the server.
+
+## 0.2.1 (Sep 1, 2013)
+- Fixes starting with no previous local repository cache.  
+  Note to self: Avoid writing code without integration tests.
+
+## 0.2.0 (Sep 1, 2013)
+- Passes user given in `role :app, "user@host"` to `rsync` if set.
+
+## 0.1.338 (Sep 1, 2013)
+- Adds gem dependency on Capistrano v3.
+
+## 0.1.337 (Sep 1, 2013)
+- First release. Let's get syncing!

data/LICENSE

@@ -0,0 +1,20 @@
+Capistrano::Rsync
+Copyright (C) 2013 Andri Möll
+
+This program is free software: you can redistribute it and/or modify it under
+the terms of the GNU Affero General Public License as published by the Free
+Software Foundation, either version 3 of the License, or any later version.
+
+Additional permission under the GNU Affero GPL version 3 section 7:
+If you modify this Program, or any covered work, by linking or
+combining it with other code, such other code is not for that reason
+alone subject to any of the requirements of the GNU Affero GPL version 3.
+
+In summary:
+- You can use this program for no cost.
+- You can use this program for both personal and commercial reasons.
+- You do not have to share your own program's code which uses this program.
+- You have to share modifications (e.g bug-fixes) you've made to this program.
+
+For the full copy of the GNU Affero General Public License see:
+http://www.gnu.org/licenses.

data/Makefile

@@ -0,0 +1,16 @@
+NAME = capistrano-rsync-bladrak
+
+love:
+	@echo "Feel like makin' love."
+
+pack:
+	gem build $(NAME).gemspec
+
+publish:
+	gem push $(NAME)-*.gem
+
+clean:
+	rm -f *.gem
+	
+.PHONY: love pack publish
+.PHONY: clean

data/README.md

@@ -0,0 +1,125 @@
+Capistrano::Rsync for Capistrano v3
+===================================
+[![Gem version][gem-badge]](http://badge.fury.io/rb/capistrano-rsync)
+[gem-badge]: https://badge.fury.io/rb/capistrano-rsync.png
+
+**Deploy with Rsync** to your server from any local (or remote) repository when
+using [**Capistrano**](http://www.capistranorb.com/).  Saves you from having to
+install Git on your production machine and allows you to customize which files
+you want to deploy. Also allows you to easily precompile things on your local
+machine before deploying.
+
+### Tour
+- Works with the new [**Capistrano v3**](http://www.capistranorb.com/) ([source
+  code](https://github.com/capistrano/capistrano)) versions `>= 3.0.0pre14` and
+  `< 4`.
+- Suitable for deploying any apps, be it Ruby, Rails, Node.js or others.  
+- Exclude files from being deployed with Rsync's `--exclude` options.
+- Precompile files or assets easily before deploying, like JavaScript or CSS.
+- Caches your previously deployed code to speed up deployments ~1337%.
+- Currently works only with Git (as does Capistrano v3), so please shout out
+  your interest in other SCMs.
+
+Using [Mina](http://nadarei.co/mina/) instead of Capistrano? I've built
+[Mina::Rsync](https://github.com/moll/mina-rsync) as well.
+
+
+Using
+-----
+Install with:
+```
+gem install capistrano-rsync
+```
+
+Require it at the top of your `Capfile` (or `config/deploy.rb`):
+```ruby
+require "capistrano/rsync"
+```
+
+Set some `rsync_options` to your liking:
+```ruby
+set :rsync_options, %w[--recursive --delete --delete-excluded --exclude .git*]
+```
+
+And after setting regular Capistrano options, deploy as usual!
+```
+cap deploy
+```
+
+### Implementation
+1. Clones and updates your repository to `rsync_stage` (defaults to
+   `tmp/deploy`) on your local machine.
+2. Checks out the branch set in the `branch` variable (defaults to `master`).
+3. If `rsync_cache` set (defaults to `shared/deploy`), rsyncs to that directory
+   on the server.
+4. If `rsync_cache` set, copies the content of that directory to a new release
+   directory.
+5. If `rsync_cache` is `nil`, rsyncs straight to a new release directory.
+
+After that, Capistrano takes over and runs its usual tasks and symlinking.
+
+### Exclude files from being deployed
+If you don't want to deploy everything you've committed to your repository, pass
+some `--exclude` options to Rsync:
+```ruby
+set :rsync_options, %w[
+  --recursive --delete --delete-excluded
+  --exclude .git*
+  --exclude /config/database.yml
+  --exclude /test/***
+]
+```
+
+### Precompile assets before deploy
+Capistrano::Rsync runs `rsync:stage` before rsyncing. Hook to that like this:
+```ruby
+task :precompile do
+  Dir.chdir fetch(:rsync_stage) do
+    system "rake", "assets:precompile"
+  end
+end
+
+after "rsync:stage", "precompile"
+```
+
+### Deploy release without symlinking the current directory
+```
+cap rsync:release
+```
+
+
+Configuration
+-------------
+Set Capistrano variables with `set name, value`.
+
+Name          | Default | Description
+--------------|---------|------------
+repo_url      | `.` | The path or URL to a Git repository to clone from.  
+branch        | `master` | The Git branch to checkout.  
+rsync_stage   | `tmp/deploy` | Path where to clone your repository for staging, checkouting and rsyncing. Can be both relative or absolute.
+rsync_cache   | `shared/deploy` | Path where to cache your repository on the server to avoid rsyncing from scratch each time. Can be both relative or absolute.<br> Set to `nil` if you want to disable the cache.
+rsync_options | `[]` | Array of options to pass to `rsync`.  
+
+
+License
+-------
+Capistrano::Rsync is released under a *Lesser GNU Affero General Public
+License*, which in summary means:
+
+- You **can** use this program for **no cost**.
+- You **can** use this program for **both personal and commercial reasons**.
+- You **do not have to share your own program's code** which uses this program.
+- You **have to share modifications** (e.g bug-fixes) you've made to this
+  program.
+
+For more convoluted language, see the `LICENSE` file.
+
+
+About
+-----
+**[Andri Möll](http://themoll.com)** made this happen.  
+[Monday Calendar](https://mondayapp.com) was the reason I needed this.
+
+If you find Capistrano::Rsync needs improving, please don't hesitate to type to
+me now at [andri@dot.ee](mailto:andri@dot.ee) or [create an issue
+online](https://github.com/moll/capistrano-rsync/issues).

data/capistrano-rsync-bladrak.gemspec

@@ -0,0 +1,32 @@
+require File.expand_path("../lib/capistrano/rsync/version", __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.name = "capistrano-rsync-bladrak"
+  gem.version = Capistrano::Rsync::VERSION
+  gem.homepage = "https://github.com/Bladrak/capistrano-rsync"
+  gem.summary = <<-end.strip.gsub(/\s*\n\s*/, " ")
+    Deploy with Rsync from any local (or remote) repository.
+    Capistrano v3 ready!
+  end
+
+  gem.description = <<-end.strip.gsub(/\s*?\n(\n?)\s*/, " \\1\\1")
+    Deploy with Rsync to your server from any local (or remote) repository.
+
+    Saves you the need to install Git on your production machine and deploy all
+    of your development files each time!
+
+    Works with the new Capistrano v3!
+    Suitable for deploying any apps, be it Ruby or Node.js.
+  end
+
+  gem.author = "Andri Möll, Hugo Briand"
+  gem.email = "andri@dot.ee, h.briand@gmail.com"
+  gem.license = "LAGPL"
+
+  gem.files = `git ls-files`.split($/)
+  gem.executables = gem.files.grep(/^bin\//).map(&File.method(:basename))
+  gem.test_files = gem.files.grep(/^spec\//)
+  gem.require_paths = ["lib"]
+
+  gem.add_dependency "capistrano", ">= 3.0.0.pre14", "< 4"
+end

data/lib/capistrano/rsync/version.rb

@@ -0,0 +1,5 @@
+module Capistrano
+  module Rsync
+    VERSION = "1.0.2"
+  end
+end

data/lib/capistrano/rsync.rb

@@ -0,0 +1,101 @@
+require File.expand_path("../rsync/version", __FILE__)
+
+# NOTE: Please don't depend on tasks without a description (`desc`) as they
+# might change between minor or patch version releases. They make up the
+# private API and internals of Capistrano::Rsync. If you think something should
+# be public for extending and hooking, please let me know!
+
+set :rsync_options, []
+set :rsync_copy, "rsync --archive --acls --xattrs"
+
+# Stage is used on your local machine for rsyncing from.
+set :rsync_stage, "tmp/deploy"
+
+# Cache is used on the server to copy files to from to the release directory.
+# Saves you rsyncing your whole app folder each time.  If you nil rsync_cache,
+# Capistrano::Rsync will sync straight to the release path.
+set :rsync_cache, "shared/deploy"
+
+set :rsync_target_dir, "/"
+
+rsync_cache = lambda do
+  cache = fetch(:rsync_cache)
+  cache = deploy_to + "/" + cache if cache && cache !~ /^\//
+  cache
+end
+
+Rake::Task["deploy:check"].enhance ["rsync:hook_scm"]
+Rake::Task["deploy:updating"].enhance ["rsync:hook_scm"]
+
+desc "Stage and rsync to the server (or its cache)."
+task :rsync => %w[rsync:stage] do
+  roles(:all).each do |role|
+    user = role.user + "@" if !role.user.nil?
+
+    rsync = %w[rsync]
+    rsync.concat fetch(:rsync_options)
+    rsync << fetch(:rsync_stage) + fetch(:rsync_target_dir)
+    rsync << "#{user}#{role.hostname}:#{rsync_cache.call || release_path}"
+
+    Kernel.system *rsync
+  end
+end
+
+namespace :rsync do
+  task :hook_scm do
+    Rake::Task.define_task("#{scm}:check") do
+      invoke "rsync:check" 
+    end
+
+    Rake::Task.define_task("#{scm}:create_release") do
+      invoke "rsync:release" 
+    end
+  end
+
+  task :check do
+    # Everything's a-okay inherently!
+  end
+
+  task :create_stage do
+    next if File.directory?(fetch(:rsync_stage))
+
+    clone = %W[git clone]
+    clone << fetch(:repo_url, ".")
+    clone << fetch(:rsync_stage)
+    Kernel.system *clone
+  end
+
+  desc "Stage the repository in a local directory."
+  task :stage => %w[create_stage] do
+    Dir.chdir fetch(:rsync_stage) do
+      update = %W[git fetch --quiet --all --prune]
+      Kernel.system *update
+
+      checkout = %W[git reset --hard origin/#{fetch(:branch)}]
+      Kernel.system *checkout
+    end
+  end
+
+  desc "Copy the code to the releases directory."
+  task :release => %w[rsync] do
+    # Skip copying if we've already synced straight to the release directory.
+    next if !fetch(:rsync_cache)
+
+    copy = %(#{fetch(:rsync_copy)} "#{rsync_cache.call}/" "#{release_path}/")
+    on roles(:all).each do execute copy end
+  end
+
+  # Matches the naming scheme of git tasks.
+  # Plus was part of the public API in Capistrano::Rsync <= v0.2.1.
+  task :create_release => %w[release]
+  
+  # internally needed by capistrano's "deploy.rake"
+  task :set_current_revision do
+    run_locally do
+      within fetch(:rsync_stage) do
+        rev = capture(:git, 'rev-parse', 'HEAD')
+        set :current_revision, rev
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification
+name: capistrano-rsync-bladrak
+version: !ruby/object:Gem::Version
+  version: 1.0.2
+platform: ruby
+authors:
+- Andri Möll, Hugo Briand
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-07-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: capistrano
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 3.0.0.pre14
+    - - <
+      - !ruby/object:Gem::Version
+        version: '4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 3.0.0.pre14
+    - - <
+      - !ruby/object:Gem::Version
+        version: '4'
+description: ! "Deploy with Rsync to your server from any local (or remote) repository.
+  \n\nSaves you the need to install Git on your production machine and deploy all
+  of your development files each time! \n\nWorks with the new Capistrano v3! Suitable
+  for deploying any apps, be it Ruby or Node.js."
+email: andri@dot.ee, h.briand@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- CHANGELOG.md
+- LICENSE
+- Makefile
+- README.md
+- capistrano-rsync-bladrak.gemspec
+- lib/capistrano/rsync.rb
+- lib/capistrano/rsync/version.rb
+homepage: https://github.com/Bladrak/capistrano-rsync
+licenses:
+- LAGPL
+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.3.0
+signing_key: 
+specification_version: 4
+summary: Deploy with Rsync from any local (or remote) repository. Capistrano v3 ready!
+test_files: []