librarian 0.0.1

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+tmp

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--tag ~slow

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in librarian.gemspec
+gemspec

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 ApplicationsOnline, LLC.
+
+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,46 @@
+Librarian
+=========
+
+A tool to resolve recursively a set of specifications and fetch and install the fully resolved specifications.
+
+Librarian::Mock
+---------------
+
+An adapter for Librarian for unit testing the general features.
+The mock source is in-process and in-memory and does not touch the filesystem or the network.
+
+Librarian::Chef
+---------------
+
+An adapter for Librarian applying to Chef cookbooks in a Chef Repository.
+
+Usage:
+
+    $ cd ~/path/to/chef-repo
+    # put dependencies and their sources into ./Cheffile
+
+    # resolve dependencies:
+    $ librarian-chef resolve [--clean] [--verbose]
+
+    # install dependencies into ./cookbooks
+    $ librarian-chef install [--clean] [--verbose]
+
+    # update your cheffile with new/changed/removed constraints/sources/dependencies
+    $ librarian-chef install [--verbose]
+
+    # update the version of a dependency
+    $ librarian-chef update dependency-1 dependency-2 dependency-3 [--verbose]
+
+You should `.gitignore` your `./cookbooks` directory.
+If you are manually tracking/vendoring outside cookbooks within the repository,
+  put them in another directory such as `./cookbooks-sources` and use the `:path` source.
+  You should typically not need to do this.
+
+License
+-------
+
+Written by Jay Feldblum.
+
+Copyright (c) 2011 ApplicationsOnline, LLC.
+
+Released under the terms of the MIT License.

data/Rakefile

@@ -0,0 +1,13 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+begin
+  require 'rspec/core/rake_task'
+  RSpec::Core::RakeTask.new(:spec)
+
+  require 'cucumber/rake/task'
+  Cucumber::Rake::Task.new(:features)
+
+  task :default => [:spec, :features]
+rescue LoadError
+end

data/bin/librarian-chef

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+lib = File.expand_path('../../lib', __FILE__)
+$:.unshift(lib) unless $:.include?(lib)
+
+require 'librarian/chef/cli'
+Librarian::Chef::Cli.bin!

data/bin/librarian-mock

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+lib = File.expand_path('../../lib', __FILE__)
+$:.unshift(lib) unless $:.include?(lib)
+
+require 'librarian/mock/cli'
+Librarian::Mock::Cli.bin!

data/config/cucumber.yaml

@@ -0,0 +1 @@
+default: --tags ~@wip --format progress

data/features/chef/cli/install.feature

@@ -0,0 +1,69 @@
+Feature: cli/catalog
+
+
+
+  Background:
+    Given a directory named "cookbooks"
+
+
+
+  Scenario: A simple Cheffile with one cookbook
+    Given a file named "cookbook-sources/apt/metadata.yaml" with:
+      """
+      name: apt
+      version: 1.0.0
+      dependencies: { }
+      """
+    Given a file named "Cheffile" with:
+      """
+      cookbook 'apt',
+        :path => 'cookbook-sources'
+      """
+    When I run "librarian-chef install --verbose"
+    Then the exit status should be 0
+    And the file "cookbooks/apt/metadata.yaml" should contain exactly:
+      """
+      name: apt
+      version: 1.0.0
+      dependencies: { }
+      """
+
+
+
+  Scenario: A simple Cheffile with one cookbook with one dependency
+    Given a file named "cookbook-sources/main/metadata.yaml" with:
+      """
+      name: main
+      version: 1.0.0
+      dependencies:
+        sub: 1.0.0
+      """
+    Given a file named "cookbook-sources/sub/metadata.yaml" with:
+      """
+      name: sub
+      version: 1.0.0
+      dependencies: {}
+      """
+    Given a file named "Cheffile" with:
+      """
+      path 'cookbook-sources'
+      cookbook 'main'
+      """
+    When I run "librarian-chef install --verbose"
+    Then the exit status should be 0
+    And the file "cookbooks/main/metadata.yaml" should contain exactly:
+      """
+      name: main
+      version: 1.0.0
+      dependencies:
+        sub: 1.0.0
+      """
+    And the file "cookbooks/sub/metadata.yaml" should contain exactly:
+      """
+      name: sub
+      version: 1.0.0
+      dependencies: {}
+      """
+
+
+

data/features/support/env.rb

@@ -0,0 +1,5 @@
+require 'aruba/cucumber'
+
+Before do
+  @aruba_timeout_seconds = 2
+end

data/lib/librarian.rb

@@ -0,0 +1,191 @@
+require 'pathname'
+
+require 'librarian/helpers/debug'
+require 'librarian/support/abstract_method'
+
+require 'librarian/version'
+require 'librarian/dependency'
+require 'librarian/manifest_set'
+require 'librarian/particularity'
+require 'librarian/resolver'
+require 'librarian/source'
+require 'librarian/spec_change_set'
+require 'librarian/specfile'
+require 'librarian/lockfile'
+require 'librarian/ui'
+
+module Librarian
+  extend self
+
+  include Support::AbstractMethod
+  include Helpers::Debug
+
+  class Error < StandardError
+  end
+
+  attr_accessor :ui
+
+  abstract_method :specfile_name, :dsl_class, :install_path
+
+  def project_path
+    @project_path ||= begin
+      root = Pathname.new(Dir.pwd)
+      root = root.dirname until root.join(specfile_name).exist? || root.dirname == root
+      path = root.join(specfile_name)
+      path.exist? ? root : nil
+    end
+  end
+
+  def specfile_path
+    project_path.join(specfile_name)
+  end
+
+  def specfile
+    Specfile.new(self, specfile_path)
+  end
+
+  def lockfile_name
+    "#{specfile_name}.lock"
+  end
+
+  def lockfile_path
+    project_path.join(lockfile_name)
+  end
+
+  def lockfile
+    Lockfile.new(self, lockfile_path)
+  end
+
+  def ephemeral_lockfile
+    Lockfile.new(self, nil)
+  end
+
+  def resolver
+    Resolver.new(self)
+  end
+
+  def cache_path
+    project_path.join('tmp/librarian/cache')
+  end
+
+  def project_relative_path_to(path)
+    Pathname.new(path).relative_path_from(project_path)
+  end
+
+  def spec_change_set(spec, lock)
+    SpecChangeSet.new(self, spec, lock)
+  end
+
+  def ensure!
+    unless project_path
+      raise Error, "Cannot find #{specfile_name}!"
+    end
+  end
+
+  def clean!
+    if cache_path.exist?
+      debug { "Deleting #{project_relative_path_to(cache_path)}" }
+      cache_path.rmtree
+    end
+    if install_path.exist?
+      install_path.children.each do |c|
+        debug { "Deleting #{project_relative_path_to(c)}" }
+        c.rmtree unless c.file?
+      end
+    end
+    if lockfile_path.exist?
+      debug { "Deleting #{project_relative_path_to(lockfile_path)}" }
+      lockfile_path.rmtree
+    end
+  end
+
+  def install!
+    resolve!
+    manifests = ManifestSet.sort(lockfile.load(lockfile_path.read).manifests)
+    manifests.each do |manifest|
+      manifest.source.cache!([manifest])
+    end
+    manifests.each do |manifest|
+      manifest.install!
+    end
+  end
+
+  def update!(dependency_names)
+    unless lockfile_path.exist?
+      raise Error, "Lockfile missing!"
+    end
+    previous_resolution = lockfile.load(lockfile_path.read)
+    partial_manifests = ManifestSet.deep_strip(previous_resolution.manifests, dependency_names)
+    debug { "Precaching Sources:" }
+    previous_resolution.sources.each do |source|
+      debug { "  #{source}" }
+    end
+    spec = specfile.read(previous_resolution.sources)
+    spec_changes = spec_change_set(spec, previous_resolution)
+    raise Error, "Cannot update when the specfile has been changed." unless spec_changes.same?
+    resolution = resolver.resolve(spec, partial_manifests)
+    unless resolution.correct?
+      ui.info { "Could not resolve the dependencies." }
+    else
+      lockfile_text = lockfile.save(resolution)
+      debug { "Bouncing #{lockfile_name}" }
+      bounced_lockfile_text = lockfile.save(lockfile.load(lockfile_text))
+      unless bounced_lockfile_text == lockfile_text
+        debug { "lockfile_text: \n#{lockfile_text}"}
+        debug { "bounced_lockfile_text: \n#{bounced_lockfile_text}"}
+        raise Error, "Cannot bounce #{lockfile_name}!"
+      end
+      lockfile_path.open('wb') { |f| f.write(lockfile_text) }
+    end
+  end
+
+  def resolve!(options = {})
+    if options[:force] || !lockfile_path.exist?
+      spec = specfile.read
+      manifests = []
+    else
+      lock = lockfile.read
+      debug { "Precaching Sources:" }
+      lock.sources.each do |source|
+        debug { "  #{source}" }
+      end
+      spec = specfile.read(lock.sources)
+      changes = spec_change_set(spec, lock)
+      if changes.same?
+        debug { "The specfile is unchanged: nothing to do." }
+        return
+      end
+      manifests = changes.analyze
+    end
+
+    resolution = resolver.resolve(spec, manifests)
+    unless resolution.correct?
+      raise Error, "Could not resolve the dependencies."
+    else
+      lockfile_text = lockfile.save(resolution)
+      debug { "Bouncing #{lockfile_name}" }
+      bounced_lockfile_text = lockfile.save(lockfile.load(lockfile_text))
+      unless bounced_lockfile_text == lockfile_text
+        debug { "lockfile_text: \n#{lockfile_text}"}
+        debug { "bounced_lockfile_text: \n#{bounced_lockfile_text}"}
+        raise Error, "Cannot bounce #{lockfile_name}!"
+      end
+      lockfile_path.open('wb') { |f| f.write(lockfile_text) }
+    end
+  end
+
+  def dsl(&block)
+    dsl_class.run(&block)
+  end
+
+  def dsl_class
+    self::Dsl
+  end
+
+private
+
+  def root_module
+    self
+  end
+
+end

data/lib/librarian/chef.rb

@@ -0,0 +1 @@
+require 'librarian/chef/extension'

data/lib/librarian/chef/cli.rb

@@ -0,0 +1,14 @@
+require 'librarian/cli'
+require 'librarian/chef'
+require 'librarian/chef/particularity'
+
+module Librarian
+  module Chef
+    class Cli < Librarian::Cli
+
+      include Particularity
+      extend Particularity
+
+    end
+  end
+end

data/lib/librarian/chef/dsl.rb

@@ -0,0 +1,14 @@
+require 'librarian/dsl'
+require 'librarian/chef/source'
+
+module Librarian
+  module Chef
+    class Dsl < Librarian::Dsl
+      dependency :cookbook
+
+      source :site => Source::Site
+      source :git => Source::Git
+      source :path => Source::Path
+    end
+  end
+end

data/lib/librarian/chef/extension.rb

@@ -0,0 +1,24 @@
+require 'librarian/specfile'
+require 'librarian/source'
+require 'librarian/chef/dsl'
+require 'librarian/chef/source'
+
+module Librarian
+  module Chef
+    extend self
+    extend Librarian
+
+    module Overrides
+      def specfile_name
+        'Cheffile'
+      end
+
+      def install_path
+        project_path.join('cookbooks')
+      end
+    end
+
+    extend Overrides
+
+  end
+end