caprica 0.0.1.alpha

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 caprica.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Jean Mertz
+
+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,193 @@
+# Caprica
+
+Extend your Capistrano tasks with frakkin' awesomeness.
+
+There are currently three known models on Caprica. They each have their
+own functionality.
+
+## Models
+
+### One
+
+'One' extends the core tasks that come with Capistrano, and adds
+notifications while running `Cap`.
+
+It changes this
+
+```bash
+ $ be cap deploy:check
+
+    triggering load callbacks
+  * 2013-01-09 13:37:01 executing `staging'
+    triggering start callbacks for `deploy:check'
+  * 2013-01-09 13:37:02 executing `multistage:ensure'
+  * 2013-01-09 13:37:03 executing `deploy:check'
+  * executing "test -d /var/www/caprica/releases"
+    servers: ["127.0.0.1"]
+    [root@127.0.0.1] executing command
+    command finished in 90ms
+  * executing "test -w /var/www/caprica"
+    servers: ["127.0.0.1"]
+    [root@127.0.0.1] executing command
+    command finished in 74ms
+  * executing "test -w /var/www/caprica/releases"
+    servers: ["127.0.0.1"]
+    [root@127.0.0.1] executing command
+    command finished in 68ms
+  * executing "which git"
+    servers: ["127.0.0.1"]
+    [root@127.0.0.1] executing command
+    command finished in 74ms
+  * executing "which rsync"
+    servers: ["127.0.0.1"]
+    [root@127.0.0.1] executing command
+    command finished in 68ms
+  * executing "test -w /var/www/caprica/shared"
+    servers: ["127.0.0.1"]
+    [root@127.0.0.1] executing command
+    command finished in 74ms
+The following dependencies failed. Please check them and try again:
+--> `/var/www/caprica/releases' does not exist. Please run `cap deploy:setup'. (root@127.0.0.1)
+--> You do not have permissions to write to `/var/www/caprica'. (root@127.0.0.1)
+--> You do not have permissions to write to `/var/www/caprica/releases'. (root@127.0.0.1)
+--> `/var/www/caprica/shared' is not writable (root@127.0.0.1)
+```
+
+into this:
+
+```bash
+ $ be cap deploy:check -vv
+
+➞   Set the target stage to `staging'. .................. ✓
+➞   [internal] Ensure that a stage has been selected. ... ✓
+➞   Test deployment dependencies.
+    executing "test -d /var/www/caprica/releases"
+    executing "test -w /var/www/caprica"
+    executing "test -w /var/www/caprica/releases"
+    executing "which git"
+    executing "which rsync"
+➞   Test deployment dependencies. ....................... ✘ failed dependencies
+➞   `/var/www/caprica/releases' does not exist. Please run `cap deploy:setup'. (root@127.0.0.1)
+➞   You do not have permissions to write to `/var/www/caprica'. (root@127.0.0.1)
+➞   You do not have permissions to write to `/var/www/caprica/releases'. (root@127.0.0.1)
+➞   `/var/www/caprica/shared' is not writable (root@127.0.0.1)
+```
+
+or this:
+
+```bash
+$ cap nginx:install
+
+➞   Set the target stage to `staging'. .... ✓
+➞   Test deployment dependencies. ......... ⣾ executing "test -d /var/www/caprica/releases"
+➞   Test deployment dependencies. ......... ⣽ executing "test -w /var/www/caprica"
+➞   Test deployment dependencies. ......... ⣻ executing "test -w /var/www/caprica/releases"
+➞   Test deployment dependencies. ......... ⣻ executing "which git"
+➞   Test deployment dependencies. ......... ⢿ executing "which rsync"
+➞   Test deployment dependencies. ......... ✘ failed dependencies
+➞   `/var/www/graduation/releases' does not exist. Please run `cap deploy:setup'. (root@178.79.130.64)
+➞   You do not have permissions to write to `/var/www/graduation'. (root@178.79.130.64)
+➞   You do not have permissions to write to `/var/www/graduation/releases'. (root@178.79.130.64)
+➞   `/var/www/graduation/shared' is not writable (root@178.79.130.64)
+```
+
+*The 'Install nginx' lines will actually replace previous line after each
+step. resulting in a two line final output:*
+
+```bash
+➞   Set the target stage to `staging'. .... ✓
+➞   Test deployment dependencies. ......... ✘ failed dependencies
+➞   `/var/www/graduation/releases' does not exist. Please run `cap deploy:setup'. (root@178.79.130.64)
+➞   You do not have permissions to write to `/var/www/graduation'. (root@178.79.130.64)
+➞   You do not have permissions to write to `/var/www/graduation/releases'. (root@178.79.130.64)
+➞   `/var/www/graduation/shared' is not writable (root@178.79.130.64)
+```
+
+### Three
+
+'Three' adds custom tasks to your Capistrano files, these tasks take full
+advantage of the styling provided by 'Six'.
+
+Here is a list of the currently supported tasks:
+
+```
+nginx:setup
+nginx:install
+nginx:reload
+nginx:config
+nginx:sites:available
+nginx:sites:enable
+nginx:sites:disable
+```
+
+For all tasks and their descriptions, see the README in `lib/caprica/three`.
+
+### Six
+
+Prettify Capistrano output.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'caprica', group: :development
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install caprica
+
+## Usage
+
+Add this line to your Capfile:
+
+    require 'capistrano/caprica'
+
+If you want to specify which parts you want to load, you can do so:
+
+    require 'capistrano/caprica/one'   # extends core Capistrano tasks with 'six'
+    require 'capistrano/caprica/three' # add custom tasks which work with 'six'
+    require 'capistrano/caprica/six'   # beatifies Capistrano output
+
+While 'three' gives you a lot of custom tasks, you might want to narrow
+down the ones that are loaded:
+
+    require 'capistrano/caprica/three/nginx'
+    require 'capistrano/caprica/three/postgresql'
+    require 'capistrano/caprica/three/sidekiq'
+
+## 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
+
+## License
+
+Copyright (c) 2012-2013 Jean Mertz
+
+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/Rakefile

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

data/caprica.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'capistrano/caprica/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = 'caprica'
+  gem.version       = Caprica::VERSION::STRING
+  gem.authors       = ['Jean Mertz']
+  gem.email         = ['jean@mertz.fm']
+  gem.description   = %q{Extend your Capistrano tasks with frakkin' awesomeness.}
+  gem.summary       = %q{Prettify output, enhance existing tasks, extend with custom tasks.}
+  gem.homepage      = 'https://github.com/JeanMertz/Caprica'
+
+  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{^(spec|features)/})
+  gem.require_paths = ['lib']
+
+  gem.add_dependency 'capistrano'
+end

data/lib/capistrano/caprica.rb

@@ -0,0 +1,84 @@
+class Caprica
+  require 'pp'
+  require 'capistrano/caprica/version'
+  require 'capistrano/caprica/task'
+  require 'capistrano/caprica/one'
+  # require 'caprica/three'
+  require 'capistrano/caprica/six'
+
+  require 'colored'
+
+
+  attr_reader :task, :logger, :spinner, :one, :six
+
+  @@active_instance = nil
+  @verbose = true if ARGV.any? { |v| v =~ /-[v]{2,}/ }
+
+  def initialize task
+    @task     = Caprica::Task.new(task)
+    @logger   = Caprica::Six::Logger.new(self)
+    @spinner  = Caprica::Six::Spinner.new(self)
+    @silence  = false
+
+    @@active_instance = self
+
+    # activate cylons
+    @one = Caprica::One.new(self) if defined? Caprica::One
+    @six = Caprica::Six.new(self) if defined? Caprica::Six
+  end
+
+  def self.active_instance
+    @@active_instance
+  end
+
+  def before
+    @six.before if defined? @six
+  end
+
+  def after
+    @six.after if defined? @six
+  end
+
+  def silence!
+    @silence = true
+  end
+
+  def silenced?
+    @silence
+  end
+
+  def self.verbose
+    @verbose ? true : false
+  end
+
+  def self.verbose= value
+    @verbose = value
+  end
+end
+
+Capistrano::Configuration.instance(true).load do
+  @skip_carpica = true if ARGV.include? '-v'
+
+  next if @skip_carpica
+
+  on :before do
+    @caprica = Caprica.new(current_task)
+    @caprica.before
+  end
+
+  on :after do
+    @caprica.after
+  end
+end
+
+
+class Array
+  def inject(n)
+     each { |value| n = yield(n, value) }
+     n
+  end
+
+  def rsend(baseobj)
+    inject(baseobj) { |n, value| n.send(value) }
+  end
+end

data/lib/capistrano/caprica/one.rb

@@ -0,0 +1,54 @@
+require 'capistrano/caprica/six'
+require 'capistrano/caprica/one/deploy'
+
+class Caprica::One
+  include Caprica::One::Deploy
+
+  def initialize caprica
+    @caprica = caprica
+  end
+
+  def verbose_debugger message
+    msg_opts = {
+      styling: :black,
+      clear_line: true,
+      dots: false,
+      prefix: '    '
+    }
+
+    case @caprica.logger.notice
+    when nil
+      @caprica.spinner.stop
+      @caprica.logger.puts clear_line: true, dots: false
+    when /^executing ".*"/
+      @caprica.logger.puts msg_opts.merge(msg: @caprica.logger.notice)
+    end
+
+    @caprica.logger.notice = message
+    @caprica.logger.print msg_opts.merge(msg: message)
+  end
+
+  def inline_debugger message
+    @caprica.spinner.start message
+  end
+end
+
+module ::Capistrano
+  class Logger
+
+    alias_method :debug_internal, :debug
+    def debug(message, line_prefix=nil)
+      @caprica = Caprica.active_instance
+
+      if ! @caprica || @caprica.silenced? || message =~ /^executing command$/
+        return debug_internal(message, line_prefix)
+      end
+
+      if Caprica.verbose
+        @caprica.one.verbose_debugger(message)
+      else
+        @caprica.one.inline_debugger(message)
+      end
+    end
+  end
+end

data/lib/capistrano/caprica/one/deploy.rb

@@ -0,0 +1,26 @@
+class Caprica::One
+  module Deploy
+
+    module ::Capistrano
+      class Configuration
+        module Namespaces
+          class Namespace
+
+            def puts content
+              @caprica = Caprica.active_instance
+              return super unless @caprica
+
+              if content.include? 'The following dependencies failed.'
+                @caprica.six.error notice: 'failed dependencies', continue: true
+              else
+                content.gsub!('--> ', '')
+                @caprica.logger.puts msg: content, length: false, styling: :white, dots: false, prefix: ["\u279E".red, '   ']
+              end
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/capistrano/caprica/six.rb

@@ -0,0 +1,20 @@
+require 'capistrano/caprica/six/before'
+require 'capistrano/caprica/six/after'
+require 'capistrano/caprica/six/logger'
+require 'capistrano/caprica/six/spinner'
+require 'capistrano/caprica/six/error.rb'
+# require 'caprica/six/prettify.rb'
+# require 'caprica/six/callbacks.rb'
+# require 'caprica/six/notify.rb'
+# require 'caprica/six/skip.rb'
+# require 'caprica/six/succeed.rb'
+
+class Caprica::Six
+  include Caprica::Six::Before
+  include Caprica::Six::After
+  include Caprica::Six::Error
+
+  def initialize caprica
+    @caprica = caprica
+  end
+end

data/lib/capistrano/caprica/six/after.rb

@@ -0,0 +1,18 @@
+class Caprica::Six
+  module After
+
+    def after
+      successful unless @caprica.task.failed? || @caprica.silenced?
+
+      # don't show any more output for this task after completion
+      @caprica.silence!
+    end
+
+    def successful
+      @caprica.task.success!
+      @caprica.spinner.stop
+      @caprica.logger.puts styling: :green, clear_line: true, status: :done
+    end
+
+  end
+end

data/lib/capistrano/caprica/six/before.rb

@@ -0,0 +1,21 @@
+class Caprica::Six
+  module Before
+
+    def before
+      @caprica.task.internal? && ! Caprica.verbose ? stop : start
+    end
+
+    def after
+      finish unless @caprica.silenced?
+    end
+
+    def stop
+      @caprica.silence!
+    end
+
+    def start
+      @caprica.logger.print styling: :white, append: ' '
+      @caprica.spinner.start
+    end
+  end
+end

data/lib/capistrano/caprica/six/callbacks.rb

@@ -0,0 +1,88 @@
+# module Caprica
+#   module Six
+#     module Callbacks
+
+#       def initialize
+#         @hide_task_output         = false
+#         @tasks_without_callbacks  = ['nginx:setup']
+#       end
+
+#       def before
+#         Capistrano::Configuration.instance.load do
+#           on :before, except: tasks_without_callbacks do
+#             Caprica::Six.start(current_task)
+#           end
+
+#           on :after, except: tasks_without_callbacks do
+#             Caprica::Six.finish(current_task) if show_output?
+#           end
+
+#           def internal_task?
+#             current_task.desc.include?('[internal]')
+#           end
+#         end
+
+#       end
+
+#       def after
+#         Capistrano::Configuration.instance.load do
+#           on :after, except: tasks_without_callbacks do
+#             Caprica::Six.succeed if show_output?
+#           end
+#         end
+#       end
+
+
+#       Capistrano::Configuration.instance.load do
+#         on :before, except: tasks_without_callbacks do
+#           Caprica::Six::Callbacks.start
+#           return hide_task_output if internal_task?
+
+#           @description = current_task.desc
+
+#           pprint styling: :white, trailing_whitespace: true
+#           spinner :start
+#         end
+
+#         on :after, except: tasks_without_callbacks do
+#           Caprica::Six.succeed if show_output?
+#         end
+
+#         def internal_task?
+#           current_task.desc.include?('[internal]')
+#         end
+#       end
+
+#       private
+
+#       def show_output?
+#         !! @hide_task_output
+#       end
+
+#       def tasks_without_callbacks
+#         @tasks_without_callbacks
+#       end
+
+#     end
+#   end
+# end
+
+
+# Capistrano::Configuration.instance.load do
+#     on :before, except: skip_callbacks do
+#     unset :cap_task_unsuccessful
+#     @hide_task_output = false
+#     if ! current_task.desc || current_task.desc.include?('[internal]')
+#       @hide_task_output = true
+#     else
+#       @start_msg = current_task.desc
+#       pprint @start_msg, styling: :white, trailing_whitespace: true
+#       start_spinner
+#     end
+#   end
+
+#   on :after, except: skip_callbacks do
+#     succeeded unless @hide_task_output
+#   end
+
+# end

data/lib/capistrano/caprica/six/error.rb

@@ -0,0 +1,17 @@
+class Caprica::Six
+  module Error
+
+    def error opts = {}
+      @caprica.task.failed!
+      @caprica.spinner.stop
+
+      print_error opts
+    end
+
+    def print_error opts = {}
+      @caprica.logger.puts styling: :red, notice: opts[:notice], clear_line: true, status: :error
+      abort unless opts[:continue]
+    end
+
+  end
+end

data/lib/capistrano/caprica/six/logger.rb

@@ -0,0 +1,59 @@
+class Caprica::Six
+  class Logger
+
+    attr_accessor :notice
+
+    def initialize(caprica)
+      @caprica = caprica
+    end
+
+    def print opts = {}
+      ::Kernel.print(parser opts)
+    end
+
+    def puts opts = {}
+      ::Kernel.puts(parser opts)
+    end
+
+    def string opts = {}
+      parser opts
+    end
+
+    def parser opts = {}
+      opts = {
+        length:     terminal_width/2.3,       # [False, Integer]
+        styling:    [],                       # [Array, :red, :green, :blue, :bold, etc...]
+        clear_line: false,                    # [False, True]
+        prefix:     ["\u279E".white, '   '],  # [False, String, Array]
+        dots:       true,                     # [True, False]
+        status:     nil,                      # [False, String, :done, :error, :skipped]
+        notice:     nil,                      # [False, String]
+        append:     nil                       # [Nill, String]
+      }.merge(opts)
+
+      msg = opts.fetch(:msg, @caprica.task.description.strip)
+      msg = msg[0, opts[:length]] if opts[:length]
+      dots_width  = terminal_width/2 - msg.length
+
+      m =   []
+      m <<  ["\r","\e[K"]                         if opts[:clear_line]
+      m <<  [opts[:prefix]]                       if opts[:prefix]
+      m <<  [[opts[:styling]].flatten.rsend(msg)]
+      m <<  [' ', ('.' * dots_width).black]       if opts[:dots]
+      m <<  [' ', "\u2713".green]                 if opts[:status] == :done
+      m <<  [' ', "\u2718".red]                   if opts[:status] == :error
+      m <<  [' ', "\u273B".yellow]                if opts[:status] == :skipped
+      m <<  [' ', opts[:status].yellow]           if opts[:status].is_a? String
+      m <<  [' ', opts[:notice].black]            if opts[:notice]
+      m <<  [opts[:append]]                       if opts[:append]
+
+      m.flatten.join('')
+    end
+
+    private
+
+    def terminal_width
+      `stty size | cut -d' ' -f2`.to_i
+    end
+  end
+end

data/lib/capistrano/caprica/six/notify.rb

@@ -0,0 +1,8 @@
+Capistrano::Configuration.instance.load do |cap|
+  def notify string
+    @caprica = Caprica.active_instance
+    return unless @caprica
+
+    @caprica.logger.print notice: string, clear_line: true
+  end
+end

data/lib/capistrano/caprica/six/spinner.rb

@@ -0,0 +1,45 @@
+# encoding: utf-8
+class Caprica::Six
+  class Spinner
+
+    def initialize caprica
+      @caprica = caprica
+      @chars = %w[⣾ ⣽ ⣻ ⢿ ⡿ ⣟ ⣯ ⣷]
+      @running = false
+    end
+
+    def start notice = false
+      stop
+      @notice = notice
+      @running = true
+      spinner :wakeup
+    end
+
+    def stop
+      @notice = false
+      @running = false
+      sleep 0.1
+    end
+
+    def spinner action
+      Thread.new do
+        loop do
+          if ! @running
+            Thread.stop
+          end
+
+          if @notice
+            @caprica.logger.print notice: @notice, status: @chars[0].bold.yellow, clear_line: true
+            sleep 0.1
+          else
+            print @chars[0].bold.yellow
+            sleep 0.1
+            print "\b"
+          end
+          @chars.push @chars.shift
+        end
+      end.send(action)
+    end
+
+  end
+end

data/lib/capistrano/caprica/task.rb

@@ -0,0 +1,39 @@
+class Caprica::Task
+
+  def initialize(current_task)
+    @cap_task = current_task
+    @success = false
+    @failure = false
+  end
+
+  def current
+    @cap_task
+  end
+
+  def description
+    @cap_task.brief_description
+  end
+
+  def internal?
+    description.include?('[internal]')
+  end
+
+  def failed!
+    @success = false  && @success.freeze
+    @failure = true   && @failure.freeze
+  end
+
+  def failed?
+    @failed && ! @success
+  end
+
+  def success!
+    @success = true   && @success.freeze
+    @failure = false  && @failure.freeze
+  end
+
+  def success?
+    @success && ! @failed
+  end
+
+end

data/lib/capistrano/caprica/three.rb

@@ -0,0 +1,2 @@
+require 'capistrano/caprica/six'
+require 'capistrano/caprica/three/nginx'

data/lib/capistrano/caprica/three/nginx.rb

@@ -0,0 +1,7 @@
+require 'caprica/three/nginx/setup'
+require 'caprica/three/nginx/install'
+require 'caprica/three/nginx/reload'
+require 'caprica/three/nginx/config'
+require 'caprica/three/nginx/sites_available'
+require 'caprica/three/nginx/sites_enable'
+require 'caprica/three/nginx/sites_disable'

data/lib/capistrano/caprica/three/nginx/README.md

@@ -0,0 +1,65 @@
+# nginx
+
+Install and manage your nginx server. 
+
+## nginx:install - install nginx on remote server
+
+configuration variables:
+
+```
+nginx_install_role            # default: web
+nginx_sites_available_path    # default: /var/nginx/sites-available
+nginx_sites_enable_path       # default: /var/nginx/sites-enabled
+```
+
+## nginx:reload - reload nginx configuration
+
+The `nginx:reload` command reloads the nginx configuration without
+actually restarting the server. This allows active sites to continue
+functioning correctly, while you can start and stop specific sites using
+`nginx:sites:enable` and `nginx:sites:disable`.
+
+Note that this command is automatically run after the above two tasks.
+
+configuration variables:
+
+```
+nginx_reload_role             # default: web
+```
+
+
+## nginx:config - upload global configuration file
+
+configuration variables:
+
+```
+nginx_config_role             # default: web
+nginx_config_source           # default: asks for path/url
+nginx_config_path             # default: /etc/nginx/nginx.conf
+```
+
+## nginx:sites:available - upload site configuration file
+
+configuration variables:
+
+```
+nginx_sites_available_role    # default: web
+nginx_sites_available_source  # default: asks for path/url
+```
+
+## nginx:sites:enable - enable site configuration file
+
+configuration variables:
+
+```
+nginx_sites_enable_role       # default: web
+nginx_sites_enable_source     # default: asks for path/url
+```
+
+## nginx:sites:disable - disable site configuration file
+
+configuration variables:
+
+```
+nginx_sites_disable_role       # default: web
+```

data/lib/capistrano/caprica/three/nginx/install.rb

@@ -0,0 +1,53 @@
+# encoding: utf-8
+require 'open-uri'
+# Set OpenURI buffer to 0, always create FileIO instead of StringIO
+OpenURI::Buffer.send :remove_const, 'StringMax' if OpenURI::Buffer.const_defined?('StringMax')
+OpenURI::Buffer.const_set 'StringMax', 0
+
+Capistrano::Configuration.instance.load do
+  default_run_options[:pty] = true
+
+  namespace :nginx do
+    desc 'Install nginx'
+    task :install, role: -> { fetch :nginx_install_role, :web_root } do
+      transaction do
+        # break if already installed
+        break skip('nginx already installed') if remote_file_exists? '/etc/init.d/nginx'
+
+        # set rollback instructions
+        on_rollback do
+          error
+          run "rm -rf /etc/apt/sources.list.d/nginx"
+          run 'apt-get -y purge nginx'
+          run "rm -rf #{fetch :nginx_sites_available_path, '/var/nginx/sites-available'}"
+          run "rm -rf #{fetch :nginx_sites_enable_path, '/var/nginx/sites-enabled'}"
+          run %Q{apt-key remove `apt-key list | grep 'nginx' -b1 | grep -Eo '[0-9A-Z]{6,}'`}
+        end
+
+        # add nginx package repository signed key to apt-key
+        notify 'downloading nginx package signed key'
+        run 'curl http://nginx.org/packages/keys/nginx_signing.key | apt-key add -'
+        #run "curl http://nginx.org/packages/keys/nginx_signing.key | #{try_sudo} apt-key add -"
+
+        # set-up official package repository sources
+        sources = "deb http://nginx.org/packages/debian/ squeeze nginx\n
+          deb-src http://nginx.org/packages/debian/ squeeze nginx"
+        notify 'adding official nginx repository to apt sources'
+        put sources, '/etc/apt/sources.list.d/nginx'
+
+        # update sources content
+        notify 'updating apt sources content'
+        run 'apt-get -y update'
+
+        # install latest nginx release
+        notify 'installing nginx from apt-get'
+        run 'apt-get install nginx'
+
+        # create sites-available and sites-enabled
+        notify 'creating sites-available and sites-enabled'
+        run "mkdir -p #{fetch :nginx_sites_available_path, '/var/nginx/sites-available'}"
+        run "mkdir -p #{fetch :nginx_sites_enable_path, '/var/nginx/sites-enabled'}"
+      end
+    end
+  end
+end

data/lib/capistrano/caprica/three/nginx/setup.rb

@@ -0,0 +1,14 @@
+Capistrano::Configuration.instance.load do
+  default_run_options[:pty] = true
+
+  namespace :nginx do
+    task :setup, role: -> { fetch :nginx_setup_role, :web } do
+      transaction do
+        top.nginx.install
+        top.nginx.config
+        top.nginx.sites.available
+        top.nginx.sites.enable
+      end
+    end
+  end
+end

data/lib/capistrano/caprica/tyrol.rb

@@ -0,0 +1,6 @@
+class Caprica::Tyrol
+
+  def initialize caprica
+    @caprica = caprica
+  end
+end

data/lib/capistrano/caprica/version.rb

@@ -0,0 +1,10 @@
+class Caprica
+  module VERSION #:nodoc:
+    MAJOR = 0
+    MINOR = 0
+    TINY  = 1
+    PRE   = 'alpha'
+
+    STRING = [MAJOR, MINOR, TINY, PRE].compact.join('.')
+  end
+end

metadata

@@ -0,0 +1,92 @@
+--- !ruby/object:Gem::Specification
+name: caprica
+version: !ruby/object:Gem::Version
+  version: 0.0.1.alpha
+  prerelease: 6
+platform: ruby
+authors:
+- Jean Mertz
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-01-09 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: Extend your Capistrano tasks with frakkin' awesomeness.
+email:
+- jean@mertz.fm
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- caprica.gemspec
+- lib/capistrano/caprica.rb
+- lib/capistrano/caprica/one.rb
+- lib/capistrano/caprica/one/deploy.rb
+- lib/capistrano/caprica/six.rb
+- lib/capistrano/caprica/six/after.rb
+- lib/capistrano/caprica/six/before.rb
+- lib/capistrano/caprica/six/callbacks.rb
+- lib/capistrano/caprica/six/error.rb
+- lib/capistrano/caprica/six/logger.rb
+- lib/capistrano/caprica/six/notify.rb
+- lib/capistrano/caprica/six/skip.rb
+- lib/capistrano/caprica/six/spinner.rb
+- lib/capistrano/caprica/task.rb
+- lib/capistrano/caprica/three.rb
+- lib/capistrano/caprica/three/nginx.rb
+- lib/capistrano/caprica/three/nginx/README.md
+- lib/capistrano/caprica/three/nginx/config.rb
+- lib/capistrano/caprica/three/nginx/install.rb
+- lib/capistrano/caprica/three/nginx/reload.rb
+- lib/capistrano/caprica/three/nginx/setup.rb
+- lib/capistrano/caprica/three/nginx/sites_available.rb
+- lib/capistrano/caprica/three/nginx/sites_disable.rb
+- lib/capistrano/caprica/three/nginx/sites_enable.rb
+- lib/capistrano/caprica/tyrol.rb
+- lib/capistrano/caprica/version.rb
+homepage: https://github.com/JeanMertz/Caprica
+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: 1.3.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Prettify output, enhance existing tasks, extend with custom tasks.
+test_files: []