berkshelf 0.1.1

data/.gitignore

@@ -0,0 +1,20 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+/Gemfile.lock
+_yardoc
+/coverage
+/doc/
+/pkg
+/spec/reports
+/Berksfile*
+tmp
+*~
+*.tar*
+\#*
+.DS_Store
+/spec/fixtures/vcr_cassettes/*
+/features/config.yml
+*.sw[op]

data/.rbenv-version

@@ -0,0 +1 @@
+1.9.3-p125

data/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gemspec

data/Guardfile

@@ -0,0 +1,23 @@
+guard 'spork' do
+  watch('Gemfile')
+  watch('spec/spec_helper.rb')  { :rspec }
+  watch(%r{^features/support/}) { :cucumber }
+end
+
+guard 'yard', :stdout => '/dev/null', :stderr => '/dev/null' do
+  watch(%r{app/.+\.rb})
+  watch(%r{lib/.+\.rb})
+  watch(%r{ext/.+\.c})
+end
+
+guard 'rspec', :version => 2, :cli => "--color --drb --format Fuubar", :all_on_start => false, :all_after_pass => false, :notification => false do
+  watch(%r{^spec/unit/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})          { |m| "spec/unit/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')       { "spec" }
+end
+
+guard 'cucumber', :cli => "--drb --format pretty --tags ~@wip", :all_on_start => false, :all_after_pass => false, :notification => false do
+  watch(%r{^features/.+\.feature$})
+  watch(%r{^features/support/.+$})                      { 'features' }
+  watch(%r{^features/step_definitions/(.+)_steps\.rb$}) { |m| Dir[File.join("**/#{m[1]}.feature")][0] || 'features' }
+end

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Riot Games
+
+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.rdoc

@@ -0,0 +1,102 @@
+= Berkshelf
+
+Manages a Cookbook's, or an Application's, Cookbook dependencies
+
+== Getting Started
+
+=== Install
+
+    $ gem install berkshelf
+
+=== Use
+
+==== Berksfile
+
+Dependencies are managed via a `Berksfile` in the directory where you want the cookbooks to be installed.  The Berksfile, like Bundler's Gemfile, contains which cookbooks are needed and, optionally, where to find them:
+
+    cookbook 'memcached'
+    cookbook 'nginx'
+    cookbook 'my_app', path: '/path/to/cookbook'
+    cookbook 'mysql', git: 'git://github.com/opscode-cookbooks/mysql.git'
+
+==== CLI
+
+The CLI consists of 2 commands: install, update
+
+    $ knife berks (install|update) [(--without|-W) group_to_exclude]
+
+[install]  Installs the from the Berksfile.lock, or Berksfile if the the lockfile does not exist.
+
+[update] Skips the lockfile and installs fresh
+
+[init] Prepares a local path to have it's Cookbook dependencies managed by Berkshelf. If the target path is a Cookbook itself, additional Berkshelf support files will be generated to get you started.
+
+== The Berksfile
+
+Cookbooks are defined as dependencies by declaring them in the `Berksfile`
+
+    cookbook 'nginx'
+
+Cookbooks without additional options are assumed to come from the Opscode Community site at the latest available version: http://community.opscode.com/cookbooks
+
+Options available include:
+
+version constraint
+
+    cookbook "nginx", "= 0.101.2"    # precisely 0.101.2
+    cookbook "mysql", "< 1.2.4"      # less than and not including 1.2.4
+    cookbook "openssl", "~> 1.0.0"   # greater than 1.0.0, and up to but not including 1.1.0
+
+git
+
+    # ref can be a branch name, tag, or commit hash. If ref is not provided, HEAD is used.
+    cookbook "mysql", git: "https://github.com/opscode-cookbooks/mysql.git", ref: "<any git ref>" 
+
+path
+
+    # knife berks will look in /path/to/location/of/my_application for the cookbook
+    cookbook "my_application", path: "/path/to/location/of"
+
+=== Groups
+
+Groups can be defined via blocks or inline as an option:
+
+    group :solo do
+      cookbook 'base'
+    end
+    
+    cookbook 'base', :group => 'solo'
+
+When using install or update, groups can be excluded with the --without GROUP_NAME or -W GROUP_NAME flags.
+
+= Contributing
+
+== Running tests
+
+=== Install prerequisites
+
+Install the latest version of {Bundler}[http://gembundler.com]
+
+    $ gem install bundler
+
+Clone the project
+
+    $ git clone git://github.com/RiotGames/berkshelf.git
+
+and run:
+
+    $ cd berkshelf
+    $ bundle install
+
+Bundler will install all gems and their dependencies required for testing and developing. 
+
+=== Running unit (RSpec) and acceptance (Cucumber) tests
+
+    $ bundle exec guard start
+
+= Authors and Contributors
+
+* Josiah Kiehl (<josiah@skirmisher.net>)
+* Jamie Winsor (<jamie@vialstudios.com>)
+* Erik Hollensbe (<erik@hollensbe.org>)
+* Michael Ivey (<ivey@gweezlebur.com>)

data/Thorfile

@@ -0,0 +1,47 @@
+# encoding: utf-8
+$:.push File.expand_path("../lib", __FILE__)
+
+require 'bundler'
+require 'bundler/setup'
+
+require 'berkshelf'
+require 'thor/rake_compat'
+
+class Berks < Thor
+  include Thor::RakeCompat
+  Bundler::GemHelper.install_tasks
+
+  desc "build", "Build berkshelf-#{Berkshelf::VERSION}.gem into the pkg directory"
+  def build
+    Rake::Task["build"].execute
+  end
+
+  desc "install", "Build and install berkshelf-#{Berkshelf::VERSION}.gem into system gems"
+  def install
+    Rake::Task["install"].execute
+  end
+
+  desc "release", "Create tag v#{Berkshelf::VERSION} and build and push berkshelf-#{Berkshelf::VERSION}.gem to Rubygems"
+  def release
+    Rake::Task["release"].execute
+  end
+
+  desc "spec", "Run RSpec code examples"
+  def spec
+    exec "rspec --color --format=documentation spec"
+  end
+
+  desc "cucumber", "Run Cucumber features"
+  def cucumber
+    exec "cucumber --color --format=progress"
+  end
+
+  class VCR < Thor
+    namespace :vcr
+
+    desc "clean", "clean VCR cassettes"
+    def clean
+      FileUtils.rm_rf("spec/fixtures/vcr_cassettes/*")
+    end
+  end
+end

data/berkshelf.gemspec

@@ -0,0 +1,39 @@
+# -*- encoding: utf-8; mode: ruby -*-
+
+require File.expand_path('../lib/berkshelf/version', __FILE__)
+
+Gem::Specification.new do |s|
+  s.authors               = ["Josiah Kiehl", "Jamie Winsor", "Michael Ivey", "Erik Hollensbe"]
+  s.email                 = ["josiah@skirmisher.net", "jamie@vialstudios.com", "ivey@gweezlebur.com", "erik@hollensbe.org"]
+  s.description           = %q{Manages a Cookbook's, or an Application's, Cookbook dependencies}
+  s.summary               = s.description
+  s.homepage              = "https://github.com/RiotGames/berkshelf"
+  s.files                 = `git ls-files`.split($\)
+  s.executables           = s.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  s.test_files            = s.files.grep(%r{^(test|spec|features)/})
+  s.name                  = "berkshelf"
+  s.require_paths         = ["lib"]
+  s.version               = Berkshelf::VERSION
+  s.required_ruby_version = ">= 1.9.1"
+
+  s.add_runtime_dependency 'dep_selector'
+  s.add_runtime_dependency 'chef',            '~> 0.10.0'
+  s.add_runtime_dependency 'minitar'
+  s.add_runtime_dependency 'thor',            '~> 0.15.2'
+
+  s.add_development_dependency 'cucumber'
+  s.add_development_dependency 'vcr'
+  s.add_development_dependency 'webmock'
+  s.add_development_dependency 'aruba'
+  s.add_development_dependency 'rspec'
+  s.add_development_dependency 'json_spec'
+  s.add_development_dependency 'simplecov'
+  s.add_development_dependency 'fuubar'
+  s.add_development_dependency 'spork'
+  s.add_development_dependency 'yard'
+  s.add_development_dependency 'guard'
+  s.add_development_dependency 'guard-rspec'
+  s.add_development_dependency 'guard-cucumber'
+  s.add_development_dependency 'guard-spork'
+  s.add_development_dependency 'guard-yard'
+end

data/features/config.sample.yml

@@ -0,0 +1,3 @@
+node_name: 'reset'
+client_key: '/Users/reset/.chef/reset.pem'
+chef_server_url: 'https://api.opscode.com/organizations/vialstudios'

data/features/init_command.feature

@@ -0,0 +1,40 @@
+Feature: initialize command
+  As a Cookbook author  
+  I want a way to quickly prepare a Cookbook on my local disk with Berkshelf files
+  So that I can resolve my Cookbook's dependencies with Berkshelf
+
+  Scenario: initializing a path containing a cookbook
+    Given a cookbook named "sparkle_motion"
+    When I run the init command with the cookbook "sparkle_motion" as the target
+    Then the cookbook "sparkle_motion" should have the following files:
+      | Berksfile |
+      | .chefignore  |
+    And the file "Berksfile" in the cookbook "sparkle_motion" should contain:
+      """
+      metadata
+      """
+    And the output should contain "Successfully initialized"
+    And the exit status should be 0
+
+  Scenario: initializing a path that does not contain a cookbook
+    Given a directory named "not_a_cookbook"
+    When I run the init command with the directory "not_a_cookbook" as the target
+    Then the directory "not_a_cookbook" should have the following files:
+      | Berksfile |
+    And the directory "not_a_cookbook" should not have the following files:
+      | .chefignore  |
+    And the file "Berksfile" in the directory "not_a_cookbook" should not contain:
+      """
+      metadata
+      """
+    And the output should contain "Successfully initialized"
+    And the exit status should be 0
+
+  Scenario: initializing with no value given for target
+    When I run the init command with no value for the target
+    Then the output should contain "Successfully initialized"
+    And the current directory should have the following files:
+      | Berksfile |
+    And the current directory should not have the following files:
+      | .chefignore  |
+    And the exit status should be 0

data/features/install.feature

@@ -0,0 +1,55 @@
+Feature: install cookbooks from a Berksfile
+  As a user with a Berksfile
+  I want to be able to run knife berkshelf install to install my cookbooks
+  So that I don't have to download my cookbooks and their dependencies manually
+
+  Scenario: install cookbooks
+    Given I write to "Berksfile" with:
+      """
+      cookbook "mysql", "1.2.4"
+      """
+    When I run the install command
+    Then the cookbook store should have the cookbooks:
+      | mysql   | 1.2.4 |
+      | openssl | 1.0.0 |
+    And the output should contain:
+      """
+      Installing mysql (1.2.4) from site: 'http://cookbooks.opscode.com/api/v1/cookbooks'
+      Installing openssl (1.0.0) from site: 'http://cookbooks.opscode.com/api/v1/cookbooks'
+      """
+
+  Scenario: running install when current project is a cookbook and the 'metadata' is specified
+    Given a cookbook named "sparkle_motion"
+    And the cookbook "sparkle_motion" has the file "Berksfile" with:
+      """
+      metadata
+      """
+    When I cd to "sparkle_motion"
+    And I run the install command
+    Then the output should contain:
+      """
+      Using sparkle_motion (0.0.0) at path:
+      """
+    And the exit status should be 0
+
+  Scenario: running install with no Berksfile or Berksfile.lock
+    Given I do not have a Berksfile
+    And I do not have a Berksfile.lock
+    When I run the install command
+    Then the output should contain:
+      """
+      No Berksfile or Berksfile.lock found at:
+      """
+    And the CLI should exit with the status code for error "BerksfileNotFound"
+
+  Scenario: running install when the Cookbook is not found on the remote site
+    Given I write to "Berksfile" with:
+      """
+      cookbook "doesntexist"
+      """
+    And I run the install command
+    Then the output should contain:
+      """
+      Cookbook 'doesntexist' not found at site: 'http://cookbooks.opscode.com/api/v1/cookbooks'
+      """
+    And the CLI should exit with the status code for error "DownloadFailure"

data/features/lockfile.feature

@@ -0,0 +1,22 @@
+Feature: Berksfile.lock
+  As a user
+  I want my versions to be locked even when I don't specify versions in my Berksfile 
+  So when I share my repository, all other developers get the same versions that I did when I installed.
+
+  @slow_process
+  Scenario: Writing the Berksfile.lock
+    Given I write to "Berksfile" with:
+      """
+      cookbook 'ntp'
+      cookbook 'mysql', git: 'https://github.com/opscode-cookbooks/mysql.git', :ref => '190c0c2267785b7b9b303369b8a64ed04364d5f9'
+      """
+    When I run the install command
+    Then a file named "Berksfile.lock" should exist in the current directory
+    And the file "Berksfile.lock" should contain in the current directory:
+      """
+      cookbook 'ntp', :locked_version => '1.1.8'
+      cookbook 'mysql', :git => 'https://github.com/opscode-cookbooks/mysql.git', :ref => '190c0c2267785b7b9b303369b8a64ed04364d5f9'
+      cookbook 'openssl', :locked_version => '1.0.0'
+      cookbook 'chef_handler', :locked_version => '1.0.6'
+      cookbook 'windows', :locked_version => '1.3.0'
+      """

data/features/step_definitions/chef_server_steps.rb

@@ -0,0 +1,13 @@
+World(Berkshelf::RSpec::ChefAPI)
+
+Given /^the Chef server does not have the cookbooks:$/ do |cookbooks|
+  cookbooks.raw.each do |name, version|
+    purge_cookbook(name, version)
+  end
+end
+
+Then /^the Chef server should have the cookbooks:$/ do |cookbooks|
+  cookbooks.raw.each do |name, version|
+    server_has_cookbook?(name, version).should be_true
+  end
+end

data/features/step_definitions/cli_steps.rb

@@ -0,0 +1,56 @@
+require 'aruba/api'
+
+World(Aruba::Api)
+World(Berkshelf::RSpec::FileSystemMatchers)
+
+Then /^I trace$/ do
+end
+
+When /^I sleep$/ do
+  sleep 10
+end
+
+Then /^a file named "(.*?)" should exist in the current directory$/ do |filename|
+  in_current_dir do
+    File.exists?(filename).should be_true # not sure why Aruba's
+                                          # #check_file_presence
+                                          # doesn't work here. It
+                                          # looks in the wrong
+                                          # directory.
+  end
+end
+
+Then /^the file "(.*?)" should contain in the current directory:$/ do |filename, string|
+  in_current_dir do
+    File.read(filename).should match(Regexp.new(string))
+  end
+end
+
+When /^I run the init command with the cookbook "(.*?)" as the target$/ do |cookbook_name|
+  run_simple(unescape("knife berks init #{cookbook_name}"), false)
+end
+
+When /^I run the init command with the directory "(.*?)" as the target$/ do |directory_name|
+  run_simple(unescape("knife berks init #{directory_name}"), false)
+end
+
+When /^I run the init command with no value for the target$/ do
+  run_simple(unescape("knife berks init"), false)
+end
+
+When /^I run the install command$/ do
+  run_simple(unescape("knife berks install"), false)
+end
+
+When /^I run the update command$/ do
+  run_simple(unescape("knife berks update"), false)
+end
+
+When /^I run the upload command$/ do
+  run_simple(unescape("knife berks upload"), false)
+end
+
+Then /^the CLI should exit with the status code for error "(.*?)"$/ do |error_constant|
+  exit_status = Berkshelf.const_get(error_constant).status_code
+  assert_exit_status(exit_status)
+end