toque 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 728adde958810a994d9d16b9d51d2f8cd31ef9dd
+  data.tar.gz: f56fb4afebd0bfc9defe5a9e995a4f26a4466f17
+SHA512:
+  metadata.gz: 2c689a0d5f297ed1cbd9c4fba502ecf4ab918770afe4eef89c936d1a207dc3593d85e476c5ce127a2e384d1d23d50cb036d4c46c905b0fc938c02cd16ada185f
+  data.tar.gz: d13815fc714a02a45cb16a4fb3a783e970b3761910b5387078a3aa8464cf0401104fcc7de1b1b21b5b39716174ad1ca826e4af7b6b9269b9e2a4561ee1c297cd

data/.gitignore

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

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 2.0.0
+  - 1.9.3

data/Capfile

@@ -0,0 +1,3 @@
+load 'deploy'
+load 'spec/config/deploy'
+require 'toque'

data/Gemfile

@@ -0,0 +1,12 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in toque.gemspec
+gemspec
+
+group :development, :test do
+  gem 'rake'
+  gem 'rspec'
+  gem 'vagrant', '>= 1.0.7'
+  gem 'bundler', '~> 1.3'
+  gem 'capistrano-spec', github: 'jgraichen/capistrano-spec'
+end

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Jan Graichen
+
+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,109 @@
+# Toque - The cap of a Chef
+
+[![Build Status](https://travis-ci.org/jgraichen/toque.png?branch=master)](https://travis-ci.org/jgraichen/toque)
+
+**Toque** combines the power of *chef-solo* and *capistrano*. It allows you to
+run chef cookbooks with chef-solo as part of your capistrano deploy process.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'toque'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install toque
+
+After capifying your project add to your `Capfile`:
+
+```ruby
+require 'toque'
+```
+
+You can install chef by running `cap toque:chef:install` otherwise it will be
+installed on first `run_list` call. **Toque** uses chef omnibus installer to
+install a complete self-contained embedded chef environment.
+
+You can specify a specific chef version by setting `:chef_version` to
+something different to `:latest` or `nil`. An already installed version of
+chef will not be upgraded.
+
+See `cap toque:config` for more options.
+
+## Usage
+
+**Toque** assumes your cookbooks to be in `config/cookbooks` or
+`vendor/cookbooks`. One way is to use `config/cookbooks` for your own
+application cookbook(s) and `vendor/cookbooks` for community cookbooks managed
+by [librarian-chef](https://github.com/applicationsonline/librarian-chef).
+
+You can configure *librarian-chef* to use `vendor/cookbooks` as cookbook path:
+
+```bash
+$ librarian-chef config path ./vendor/cookbooks --local
+```
+
+In your deploy configuration you can now run `toque.run_list` with a list of
+recipes you want to execute. You can run chef more then once with different
+list.
+
+For example if you want to setup the server before deploying your app run
+your setup recipe right at the start:
+
+```ruby
+before "deploy:update_code" do
+  toque.run_list 'recipe[awesome::setup]'
+end
+```
+
+After deploying your app you may need to create a config for your application
+like `database.yml` or redis configuration:
+
+after "deploy:create_symlink" do
+  toque.run_list 'recipe[awesome::configure]'
+end
+
+## Configuration
+
+By default all capistrano options are available in your node configuration:
+
+```ruby
+# config/deploy.rb
+
+set :application, 'awesomeium'
+set :deploy_to, "/var/www/#{application}"
+set :user, 'awesomeix'
+
+# config/cookbooks/awesome/recipes/configure.rb
+
+template File.join(node[:deploy_to], 'config', 'database.yml') do
+  source 'database.yml.erb'
+  owner node[:user]
+  recursive true
+end
+```
+
+## Thanks
+
+Thanks to [roundsman](https://github.com/iain/roundsman) doing even some more
+tasks like installing ruby and chef via rubygems. I've decided to make up
+something new to use omnibus installer right from the start.
+
+Also take a look at
+[capistrano-spec](https://github.com/technicalpickles/capistrano-spec) allowing
+some really great capistrano testing.
+
+## 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
+
+You can run a simple vagrant based test by running `bundle exec rspec spec/spec_toque.rb`.

data/Rakefile

@@ -0,0 +1,6 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/Vagrantfile

@@ -0,0 +1,99 @@
+# -*- mode: ruby -*-
+# vi: set ft=ruby :
+
+Vagrant::Config.run do |config|
+  # All Vagrant configuration is done here. The most common configuration
+  # options are documented and commented below. For a complete reference,
+  # please see the online documentation at vagrantup.com.
+
+  # Every Vagrant virtual environment requires a box to build off of.
+  config.vm.box = 'precise32'
+
+  # The url from where the 'config.vm.box' box will be fetched if it
+  # doesn't already exist on the user's system.
+  config.vm.box_url = 'http://files.vagrantup.com/precise32.box'
+
+  # Boot with a GUI so you can see the screen. (Default is headless)
+  # config.vm.boot_mode = :gui
+
+  # Assign this VM to a host-only network IP, allowing you to access it
+  # via the IP. Host-only networks can talk to the host machine as well as
+  # any other machines on the same network, but cannot be accessed (through this
+  # network interface) by any external networks.
+  config.vm.network :hostonly, "192.168.33.10"
+
+  # Assign this VM to a bridged network, allowing you to connect directly to a
+  # network using the host's network device. This makes the VM appear as another
+  # physical device on your network.
+  # config.vm.network :bridged
+
+  # Forward a port from the guest to the host, which allows for outside
+  # computers to access the VM, whereas host only networking does not.
+  # config.vm.forward_port 80, 8080
+
+  # Share an additional folder to the guest VM. The first argument is
+  # an identifier, the second is the path on the guest to mount the
+  # folder, and the third is the path on the host to the actual folder.
+  # config.vm.share_folder "v-data", "/vagrant_data", "../data"
+
+  # Enable provisioning with Puppet stand alone.  Puppet manifests
+  # are contained in a directory path relative to this Vagrantfile.
+  # You will need to create the manifests directory and a manifest in
+  # the file base.pp in the manifests_path directory.
+  #
+  # An example Puppet manifest to provision the message of the day:
+  #
+  # # group { "puppet":
+  # #   ensure => "present",
+  # # }
+  # #
+  # # File { owner => 0, group => 0, mode => 0644 }
+  # #
+  # # file { '/etc/motd':
+  # #   content => "Welcome to your Vagrant-built virtual machine!
+  # #               Managed by Puppet.\n"
+  # # }
+  #
+  # config.vm.provision :puppet do |puppet|
+  #   puppet.manifests_path = "manifests"
+  #   puppet.manifest_file  = "base.pp"
+  # end
+
+  # Enable provisioning with chef solo, specifying a cookbooks path, roles
+  # path, and data_bags path (all relative to this Vagrantfile), and adding 
+  # some recipes and/or roles.
+  #
+  # config.vm.provision :chef_solo do |chef|
+  #   chef.cookbooks_path = "../my-recipes/cookbooks"
+  #   chef.roles_path = "../my-recipes/roles"
+  #   chef.data_bags_path = "../my-recipes/data_bags"
+  #   chef.add_recipe "mysql"
+  #   chef.add_role "web"
+  #
+  #   # You may also specify custom JSON attributes:
+  #   chef.json = { :mysql_password => "foo" }
+  # end
+
+  # Enable provisioning with chef server, specifying the chef server URL,
+  # and the path to the validation key (relative to this Vagrantfile).
+  #
+  # The Opscode Platform uses HTTPS. Substitute your organization for
+  # ORGNAME in the URL and validation key.
+  #
+  # If you have your own Chef Server, use the appropriate URL, which may be
+  # HTTP instead of HTTPS depending on your configuration. Also change the
+  # validation key to validation.pem.
+  #
+  # config.vm.provision :chef_client do |chef|
+  #   chef.chef_server_url = "https://api.opscode.com/organizations/ORGNAME"
+  #   chef.validation_key_path = "ORGNAME-validator.pem"
+  # end
+  #
+  # If you're using the Opscode platform, your validator client is
+  # ORGNAME-validator, replacing ORGNAME with your organization name.
+  #
+  # IF you have your own Chef Server, the default validation client name is
+  # chef-validator, unless you changed the configuration.
+  #
+  #   chef.validation_client_name = "ORGNAME-validator"
+end

data/lib/toque.rb

@@ -0,0 +1,18 @@
+require 'capistrano'
+
+require 'toque/version'
+require 'toque/helpers'
+require 'toque/tasks'
+require 'toque/chef'
+
+module Toque
+  def self.load_into(configuration)
+    Toque::Helpers.load_into configuration
+    Toque::Tasks.load_into configuration
+    Toque::Chef.load_into configuration
+  end
+end
+
+if Capistrano::Configuration.instance
+  Toque.load_into Capistrano::Configuration.instance
+end

data/lib/toque/chef.rb

@@ -0,0 +1,145 @@
+require 'tempfile'
+
+module Toque
+
+  # Tasks and method to interact with chef.
+  #
+  module Chef
+    def self.load_into(configuration)
+      configuration.load do
+
+        namespace :toque do
+          namespace :chef do
+
+            set_default :chef_omnibus_installer_url, 'http://www.opscode.com/chef/install.sh'
+            set_default :cookbooks_paths, %w(config/cookbooks vendor/cookbooks)
+            set_default :databags_path, 'config/databags'
+            set_default :chef_version, :latest
+            set_default :chef_debug, false
+            set_default :chef_solo, '/opt/chef/bin/chef-solo'
+
+            # Check if chef-solo installed on remote machine.
+            #
+            def installed?
+              !installed_version.nil?
+            end
+
+            # Return installed chef-solo version.
+            #
+            def installed_version
+              capture("#{chef_solo} -v || true") =~ /Chef: (\d+\.\d+\.\d+)/ ? $1 : nil
+            end
+
+            # Return path to chef solo executable.
+            #
+            def chef_solo
+              fetch(:chef_solo).to_s || 'chef-solo'
+            end
+
+            # Return list of current recipes in run_list.
+            #
+            def recipes
+              Array fetch(:run_list)
+            end
+
+            # Return list of existing cookbook paths.
+            #
+            def cookbooks_paths
+              fetch(:cookbooks_paths).to_a.select { |path| File.exists? path }
+            end
+
+            # Abort if no existing cookbook paths are setted.
+            #
+            def ensure_cookbooks!
+              raise 'No existing cookbook paths found.' if cookbooks_paths.empty?
+            end
+
+            # Return existing databag path or nil if path does not exist.
+            #
+            def databags_path
+              File.exists?((path = fetch(:databags_path))) ? path : nil
+            end
+
+            # Create and return omnibus installer command
+            #
+            def install_command
+              cmd = "#{top.sudo} bash"
+              cmd += " -s -- -v #{fetch :chef_version}" unless fetch(:chef_version) == :latest or fetch(:chef_version).nil?
+              cmd
+            end
+
+            #
+            # Tasks
+            #
+
+            desc 'Install chef via omnibus installed if not preset.'
+            task :check do
+              install unless installed?
+            end
+
+            desc 'Installs chef using omnibus installer.'
+            task :install do
+              require_curl
+              run "#{top.sudo} true && curl -L #{fetch :chef_omnibus_installer_url} | #{install_command}"
+            end
+
+            namespace :setup do
+              desc 'Upload local cookbook to remote server.'
+              task :cookbooks do
+                pwd!
+
+                tar = ::Tempfile.new("cookbooks.tar")
+                begin
+                  tar.close
+                  system "tar -cjf #{tar.path} #{cookbooks_paths.join(' ')} #{databags_path.to_s}"
+                  upload tar.path, toque.pwd("cookbooks.tar"), :via => :scp
+                  run "cd #{toque.pwd} && tar -xjf cookbooks.tar"
+                ensure
+                  tar.unlink
+                end
+              end
+
+              desc 'Generate and upload chef solo script.'
+              task :script do
+                pwd!
+
+                cookbooks = cookbooks_paths.map { |p| %("#{pwd p}") }.join(', ')
+                solo = <<-HEREDOC
+                file_cache_path "#{pwd! 'cache'}"
+                cookbook_path [ #{cookbooks} ]
+                data_bag_path "#{pwd databags_path}"
+                HEREDOC
+                put solo, pwd("node.rb"), :via => :scp
+              end
+
+              desc 'Generate and upload node json configuration.'
+              task :configuration do
+                pwd!
+
+                attrs = variables.dup
+                attrs[:run_list] = recipes
+                put attrs.to_json, pwd("node.json"), :via => :scp
+              end
+            end
+
+            desc 'Run list of recipes from `:run_list` option.'
+            task :run_list do
+              ensure_cookbooks!
+
+              check
+              setup.cookbooks
+              setup.script
+              setup.configuration
+
+              logger.info "Now running #{recipes.join(', ')}"
+
+              sudo "#{chef_solo} -c #{pwd "node.rb"} -j #{pwd "node.json"}#{' -l debug' if fetch(:chef_debug)}"
+            end
+
+          end
+        end
+
+      end
+    end
+  end
+end

data/lib/toque/helpers.rb

@@ -0,0 +1,69 @@
+module Toque
+
+  # Toque helpers
+  #
+  module Helpers
+    def self.load_into(configuration)
+      configuration.load do
+
+        namespace :toque do
+
+          # Set toque default variable.
+          #
+          def set_default(variable, *args, &block)
+            @_toque_variables ||= []
+            @_toque_overridden ||= []
+            @_toque_variables << variable
+            if exists? variable
+              @_toque_overridden << variable
+            else
+              set variable, *args, &block
+            end
+          end
+
+          # Return toque remote working directory.
+          #
+          def pwd(*path)
+            File.join(fetch(:toque_pwd).to_s, *path.map(&:to_s))
+          end
+          set_default :toque_pwd, '/tmp/toque'
+
+          # Return toque remote working directory. Will be created remotely if not existing.
+          #
+          def pwd!(*path)
+            run "mkdir -p #{pwd = pwd(*path)}"
+            pwd
+          end
+
+          # Search if curl is present
+          #
+          def curl?
+            !(capture('curl || true') =~ /not found/)
+          end
+
+          # Install curl if not present
+          #
+          def require_curl
+            sudo 'apt-get install --no-install-recommends -yq curl' unless curl?
+          end
+
+          desc 'List current toque configuration'
+          task :config do
+            @_toque_variables.sort_by(&:to_s).each do |name|
+              display_name = ":#{name},".ljust(30)
+              if variables[name].is_a?(Proc)
+                value = "<block>"
+              else
+                value = fetch(name).inspect
+                value = "#{value[0..40]}... (truncated)" if value.length > 40
+              end
+              overridden = @_toque_overridden.include?(name) ? " (overridden)" : ""
+              puts "set #{display_name} #{value}#{overridden}"
+            end
+          end
+
+        end
+      end
+    end
+  end
+end

data/lib/toque/tasks.rb

@@ -0,0 +1,20 @@
+module Toque
+  module Tasks
+    def self.load_into(configuration)
+      configuration.load do
+
+        namespace :toque do
+
+          # Run list of recipes. Install chef if not already preset.
+          #
+          def run_list(*recipes)
+            set :run_list, recipes
+            chef.run_list
+          end
+
+        end
+
+      end
+    end
+  end
+end

data/lib/toque/version.rb

@@ -0,0 +1,12 @@
+module Toque
+  module VERSION
+    MAJOR = 1
+    MINOR = 0
+    PATCH = 0
+    STAGE = nil
+
+    STRING = [MAJOR, MINOR, PATCH, STAGE].reject(&:nil?).join('.')
+
+    def self.to_s; STRING end
+  end
+end

data/spec/config/cookbooks/awesomeium/recipes/default.rb

@@ -0,0 +1,8 @@
+
+bash 'Be awesome!' do
+  cwd node[:toque_pwd]
+  code <<-EOH
+    touch awesome
+  EOH
+  creates "#{node[:toque_pwd]}/awesome"
+end

data/spec/config/cookbooks/awesomeium/recipes/second.rb

@@ -0,0 +1,7 @@
+
+bash 'Be awesome again!' do
+  cwd node[:toque_pwd]
+  code <<-EOH
+    rm -f awesome
+  EOH
+end

data/spec/config/deploy.rb

@@ -0,0 +1,35 @@
+require 'vagrant'
+
+set :application, 'awesomeium'
+
+set :repository, '.'
+set :scm,        :none # not recommended in production
+set :deploy_via, :copy
+
+server '192.168.33.10', :web, :app, :db, :primary => true
+
+set :user, 'vagrant'
+set :password, 'vagrant' # not recommended in production
+
+set :deploy_to, "/home/#{user}/#{application}"
+
+set :use_sudo, false
+default_run_options[:pty] = true
+
+# Toque options
+set :cookbooks_paths, %w(spec/config/cookbooks)
+
+namespace :vagrant do
+  task :up do
+    Vagrant::Environment.new.cli 'up'
+  end
+
+  task :destroy do
+    Vagrant::Environment.new.cli 'destroy'
+  end
+end
+
+task :spec do
+  toque.run_list "recipe[awesomeium]"
+end
+before 'spec', 'vagrant:up'

data/spec/spec_helper.rb

@@ -0,0 +1,16 @@
+require 'capistrano-spec'
+require 'toque'
+
+Dir[File.expand_path('spec/support/**/*.rb')].each {|f| require f}
+
+RSpec.configure do |config|
+  config.include Capistrano::Spec::Matchers
+  config.include Capistrano::Spec::Helpers
+
+  config.order = "random"
+
+  config.expect_with :rspec do |c|
+    # Only allow expect syntax
+    c.syntax = :expect
+  end
+end

data/spec/spec_toque.rb

@@ -0,0 +1,54 @@
+require 'spec_helper'
+require 'vagrant'
+
+describe Toque do
+
+  before do
+    @vagrant = Vagrant::Environment.new
+    @vagrant.cli 'up'
+
+    @configuration = Capistrano::Configuration.new
+    Toque.load_into(@configuration)
+
+    @configuration.load do
+
+      server '192.168.33.10', :web, :app, :db, :primary => true
+      set :user, 'vagrant'
+      set :password, 'vagrant'
+
+      set :use_sudo, false
+      default_run_options[:pty] = true
+
+      # Toque options
+      set :cookbooks_paths, %w(spec/config/cookbooks)
+      set :chef_version, '10.24.0'
+
+      task :awesome! do
+        toque.run_list 'recipe[awesomeium]'
+      end
+
+      task :awesome_the_second! do
+        toque.run_list 'recipe[awesomeium::second]'
+      end
+    end
+
+    @configuration.sudo 'apt-get remove -yq curl'
+    @configuration.sudo 'apt-get autoremove -yq'
+  end
+
+  it 'should write an awesome file' do
+    @configuration.awesome!
+
+    # should have installed chef version
+    expect(@configuration.capture('/opt/chef/bin/chef-solo -v').strip).to be == 'Chef: 10.24.0'
+
+    # should have executed cookbook and created an awesome file
+    file_exists = @vagrant.primary_vm.channel.sudo 'ls /tmp/toque/awesome'
+    expect(file_exists).to be == 0
+
+    @configuration.awesome_the_second!
+
+    file_exists = @vagrant.primary_vm.channel.sudo 'ls /tmp/toque/awesome', :error_check => false
+    expect(file_exists).to_not be == 0
+  end
+end

data/spec/toque/chef_spec.rb

@@ -0,0 +1,129 @@
+require 'spec_helper'
+
+describe Toque::Chef, 'loaded into capistrano' do
+  before do
+    @configuration = Capistrano::Configuration.new
+    @configuration.extend Capistrano::Spec::ConfigurationExtension
+    Toque.load_into(@configuration)
+  end
+
+  it 'should define default omnibus installer URL' do
+    expect(@configuration.fetch :chef_omnibus_installer_url).to be == 'http://www.opscode.com/chef/install.sh'
+  end
+
+  it "defines toque:chef:install task" do
+    expect(@configuration.find_task 'toque:chef:install').to_not be_nil
+  end
+
+  describe '#installed?' do
+    it 'detect if chef-solo is not installed' do
+      expect(@configuration.toque.chef.installed?).to be_false
+    end
+
+    it 'detect if chef-solo is installed' do
+      @configuration.stub_command '/opt/chef/bin/chef-solo -v || true', data: 'Chef: 11.4.0'
+      expect(@configuration.toque.chef.installed?).to be_true
+    end
+  end
+
+  describe '#installed_version' do
+    it 'should fetch installed chef version' do
+      @configuration.stub_command '/opt/chef/bin/chef-solo -v || true', data: 'Chef: 11.4.0'
+      expect(@configuration.toque.chef.installed_version).to be == '11.4.0'
+    end
+  end
+
+  describe '#cookbooks_paths' do
+    it 'should return existing cookbook paths' do
+      File.stub(:exists?).with('config/cookbooks').and_return true
+      File.stub(:exists?).with('vendor/cookbooks').and_return false
+
+      expect(@configuration.toque.chef.cookbooks_paths).to be == %w(config/cookbooks)
+    end
+  end
+
+  describe '#ensure_cookbooks!' do
+    it 'should abort if no cookbook path exist' do
+      File.stub(:exists?).with('config/cookbooks').and_return false
+      File.stub(:exists?).with('vendor/cookbooks').and_return false
+
+      expect{ @configuration.toque.chef.ensure_cookbooks! }.to raise_error
+    end
+  end
+
+  describe '#databags_path' do
+    it 'should return path if exists' do
+      File.stub(:exists?).with('config/databags').and_return true
+
+      expect(@configuration.toque.chef.databags_path).to be == 'config/databags'
+    end
+
+    it 'should return nit if path does not exists' do
+      File.stub(:exists?).with('config/databags').and_return false
+
+      expect(@configuration.toque.chef.databags_path).to be_nil
+    end
+  end
+
+  describe '#chef_solo' do
+    it 'should return path to chef solo executable' do
+      expect(@configuration.toque.chef.chef_solo).to be == '/opt/chef/bin/chef-solo'
+    end
+
+    it 'should return path to custom chef solo executable' do
+      @configuration.set :chef_solo, 'chef-solo'
+      expect(@configuration.toque.chef.chef_solo).to be == 'chef-solo'
+    end
+  end
+
+  describe '#upload_cookbooks' do
+    before do
+      File.stub(:exists?).and_return false
+      File.stub(:exists?).with('config/cookbooks').and_return true
+    end
+
+    it 'should create working dir' do
+      @configuration.toque.chef.setup.cookbooks
+
+      expect(@configuration).to have_run 'mkdir -p /tmp/toque'
+    end
+
+    it 'should upload cookbooks' do
+      @configuration.toque.chef.setup.cookbooks
+
+      expect(@configuration).to have_uploaded.to('/tmp/toque/cookbooks.tar')
+    end
+
+    it 'should extract cookbooks on server' do
+      @configuration.toque.chef.setup.cookbooks
+
+      expect(@configuration).to have_run 'cd /tmp/toque && tar -xjf cookbooks.tar'
+    end
+  end
+
+  describe 'toque:chef:install' do
+
+    it 'should install chef using omnibus installer' do
+      @configuration.toque.chef.install
+      expect(@configuration).to have_run("sudo -p 'sudo password: ' true && curl -L http://www.opscode.com/chef/install.sh | sudo -p 'sudo password: ' bash")
+    end
+
+    context 'with custom installer URL' do
+      before { @configuration.set :chef_omnibus_installer_url, 'http://mysrv.tld/inst.sh' }
+
+      it 'should install chef using custom omnibus installer' do
+        @configuration.toque.chef.install
+        expect(@configuration).to have_run("sudo -p 'sudo password: ' true && curl -L http://mysrv.tld/inst.sh | sudo -p 'sudo password: ' bash")
+      end
+    end
+
+    context 'with specific chef version' do
+      before { @configuration.set :chef_version, '10.24.0' }
+
+      it 'should install chef using custom omnibus installer' do
+        @configuration.toque.chef.install
+        expect(@configuration).to have_run("sudo -p 'sudo password: ' true && curl -L http://www.opscode.com/chef/install.sh | sudo -p 'sudo password: ' bash -s -- -v 10.24.0")
+      end
+    end
+  end
+end

data/spec/toque/helpers_spec.rb

@@ -0,0 +1,39 @@
+require 'spec_helper'
+
+describe Toque::Helpers, 'loaded into capistrano' do
+  before do
+    @configuration = Capistrano::Configuration.new
+    @configuration.extend Capistrano::Spec::ConfigurationExtension
+    Toque.load_into(@configuration)
+  end
+
+  describe '#pwd' do
+    it 'return toque working dir' do
+      expect(@configuration.toque.pwd).to be == '/tmp/toque'
+    end
+
+    it 'return custom path if set' do
+      @configuration.set :toque_pwd, '/tmp/custom_path'
+      expect(@configuration.toque.pwd).to be == '/tmp/custom_path'
+    end
+  end
+
+  describe '#pwd!' do
+    it 'return create remote working dir' do
+      @configuration.toque.pwd!
+      expect(@configuration).to have_run 'mkdir -p /tmp/toque'
+    end
+  end
+
+  describe '#curl?' do
+    it 'return true if curl exists' do
+      @configuration.stub_command 'curl || true', data: "curl: try 'curl --help' or 'curl --manual' for more information"
+      expect(@configuration.toque.curl?).to be_true
+    end
+
+    it 'return false if curl is missing' do
+      @configuration.stub_command 'curl || true', data: "sh: command not found"
+      expect(@configuration.toque.curl?).to be_false
+    end
+  end
+end

data/toque.gemspec

@@ -0,0 +1,22 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'toque/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'toque'
+  spec.version       = Toque::VERSION
+  spec.authors       = ['Jan Graichen']
+  spec.email         = %w(jg@altimos.de)
+  spec.description   = %q{Toque: Cap of a Chef. Integrate Chef into Capistrano.}
+  spec.summary       = %q{Toque: Cap of a Chef. Integrate Chef into Capistrano.}
+  spec.homepage      = 'https://github.com/jgraichen/toque'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = %w(lib)
+
+  spec.add_dependency 'capistrano'
+end

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification
+name: toque
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Jan Graichen
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-04-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: capistrano
+  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'
+description: 'Toque: Cap of a Chef. Integrate Chef into Capistrano.'
+email:
+- jg@altimos.de
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Capfile
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- Vagrantfile
+- lib/toque.rb
+- lib/toque/chef.rb
+- lib/toque/helpers.rb
+- lib/toque/tasks.rb
+- lib/toque/version.rb
+- spec/config/cookbooks/awesomeium/recipes/default.rb
+- spec/config/cookbooks/awesomeium/recipes/second.rb
+- spec/config/deploy.rb
+- spec/spec_helper.rb
+- spec/spec_toque.rb
+- spec/toque/chef_spec.rb
+- spec/toque/helpers_spec.rb
+- toque.gemspec
+homepage: https://github.com/jgraichen/toque
+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.0.3
+signing_key: 
+specification_version: 4
+summary: 'Toque: Cap of a Chef. Integrate Chef into Capistrano.'
+test_files:
+- spec/config/cookbooks/awesomeium/recipes/default.rb
+- spec/config/cookbooks/awesomeium/recipes/second.rb
+- spec/config/deploy.rb
+- spec/spec_helper.rb
+- spec/spec_toque.rb
+- spec/toque/chef_spec.rb
+- spec/toque/helpers_spec.rb