honkster-giternal 0.2.1

data/.gitignore

@@ -0,0 +1,5 @@
+spec/test_repos
+pkg
+features/tmp
+test_repos
+.idea

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Pat Maddox
+
+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,75 @@
+= Why giternal
+
+There are a couple tools out there that keep track of git externals
+for you.  Git submodules are built in, and braid is a different
+project.  They both have problems that prevent them from using those
+externals collaboratively.
+
+In a nutshell, git submodules keep a reference to the head of each
+external project.  This means that if Joe and Sarah each make
+non-conflicting changes to their externals, and push the external
+reference in the main project, one of them will get a conflict on
+update.  Braid doesn't treat the externals as being separate from the
+main project, so any commits you make will go to the parent instead of
+the external.
+
+In order to demonstrate these issues more concretely, I've written a
+script that will simulate the workflow of making changes to an
+external, pushing it upstream, and pulling it into another project.
+You'll notice in the submodule example that there's a conflict when
+updating the main repo, and files are missing in the local external
+after update.  In the braid example, the changes never make it
+upstream.  This script checks to see if a tool allows you to not only
+track dependencies but collaborate as well.  To execute it, run
+
+ruby test_trackers.rb giternal|submodules|braid
+
+= Using it
+
+Put a file in your project named .giternal.yml or config/giternal.yml,
+that looks like this:
+
+  local_dir_name:
+    repo: git://path/to/repo.git
+    path: local/sub/dir
+
+As an example, here's how you'd track rspec:
+
+  rspec:
+    repo: git://github.com/dchelimsky/rspec.git
+    path: vendor/plugins
+
+To pull the externals into your workspace, run "giternal update".  You
+should add vendor/plugins/rspec to .gitignore to keep the files from
+being added to your main repo.
+
+= Deploying externals
+
+I frequently use a cap task that changes to deploy_root and runs
+"giternal update" to pull all the externals.  The downside with this
+approach is that you'll get the bleeding edge of your external, and
+you may want to use a particular version that you've tested and know
+works with your app.  Enter freezing.
+
+Make sure your working dir is clean and then run "giternal freeze".
+The externals are no longer separate repos - the history was zipped up
+so that the external can be unfrozen later.  Each external is added to
+the git index, so all you have to do is commit.  You've got a
+self-contained external that is frozen to a working version, suitable
+for deploy.
+
+After you've tagged your release, you can unfreeze the giternal with
+"giternal unfreeze" and get back to development.
+
+= How I want to work with externals
+
+When tracking externals, the most important thing is knowing my
+libraries work together, and second I can try to stay up to date.
+When I update an external, I would run rake.  If it passes, keep that
+version.  If not, look at what it would take to take for my code and
+the library code to work.  If I feel like I can do it, I do, otherwise
+I unfreeze and stay on the older working version.
+
+== Copyright
+
+Copyright (c) 2009 Pat Maddox. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,60 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "#{ENV["GEM_PREFIX"]}giternal"
+    gem.summary = %Q{Non-sucky git externals}
+    gem.description = %Q{Giternal provides dead-simple management of external git dependencies. It only stores a small bit of metadata, letting you actively develop in any of the repos. Come deploy time, you can easily freeze freeze all the dependencies to particular versions}
+    gem.email = "pat.maddox@gmail.com"
+    gem.homepage = "http://github.com/pat-maddox/giternal"
+    gem.authors = ["Pat Maddox"]
+    gem.add_development_dependency "rspec"
+    gem.add_development_dependency "cucumber"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+begin
+  require 'cucumber/rake/task'
+  Cucumber::Rake::Task.new(:features)
+
+  task :features => :check_dependencies
+rescue LoadError
+  task :features do
+    abort "Cucumber is not available. In order to run features, you must: sudo gem install cucumber"
+  end
+end
+
+task :default => [:spec, :features]
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION')
+    version = File.read('VERSION')
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "giternal #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION.yml

@@ -0,0 +1,5 @@
+--- 
+:major: 0
+:minor: 2
+:patch: 1
+:build: 

data/bin/giternal

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+require "rubygems"
+if File.exist?(File.dirname(__FILE__) + '/../lib/giternal.rb')
+  $:.unshift(File.dirname(__FILE__) + '/../lib')
+end
+require 'giternal'
+
+action = ARGV[0]
+available_actions = %w(update freeze unfreeze)
+unless available_actions.include?(action)
+  puts "Usage: giternal (#{available_actions.join(':')})"
+  exit 1
+end
+
+Giternal::Repository.verbose = true
+app = Giternal::App.new(FileUtils.pwd)
+app.run(*ARGV)

data/features/checking_out_externals.feature

@@ -0,0 +1,25 @@
+Feature: Checking out and updating externals
+  As a developer
+  I want to check out and update external projects via git
+  So that I can add functionality to my app with little effort
+
+  Scenario: Repository is not yet checked out
+    Given an external repository named 'first_external'
+    And 'first_external' is not yet checked out
+    When I update the externals
+    Then 'first_external' should be checked out
+
+  Scenario: Multiple externals
+    Given an external repository named 'first_external'
+    And an external repository named 'second_external'
+    When I update the externals
+    Then 'first_external' should be checked out
+    And 'second_external' should be checked out
+
+  Scenario: Repository checked out then updated
+    Given an external repository named 'first_external'
+    And the externals are up to date
+    And content is added to 'first_external'
+    Then 'first_external' should not be up to date
+    When I update the externals
+    Then 'first_external' should be up to date

data/features/freeze_externals.feature

@@ -0,0 +1,26 @@
+Feature: Freeze externals
+  As a developer
+  I want to freeze externals
+  So that I can test and deploy my app with no worries
+
+  Scenario: Main project has one external
+    Given an external repository named 'first_external'
+    And the externals are up to date
+    When I freeze the externals
+    Then 'first_external' should no longer be a git repo
+    And 'first_external' should be added to the commit index
+
+  Scenario: External has been added to .gitignore
+    Given an external repository named 'first_external'
+    And the external 'first_external' has been added to .gitignore
+    And the externals are up to date
+    When I freeze the externals
+    Then 'first_external' should be added to the commit index
+
+  Scenario: Main project has two externals
+    Given an external repository named 'first_external'
+    And an external repository named 'second_external'
+    And the externals are up to date
+    When I freeze the external 'second_external'
+    Then 'second_external' should be added to the commit index
+    And 'first_external' should be removed from the commit index

data/features/steps/repository_steps.rb

@@ -0,0 +1,113 @@
+require 'spec'
+$:.unshift(File.dirname(__FILE__) + '/../../lib')
+require 'giternal'
+require 'giternal_helper'
+
+def be_up_to_date
+  Spec::Matchers::SimpleMatcher.new("a giternal'd repository") do |repo_name|
+    File.directory?(GiternalHelper.checked_out_path(repo_name)).should == true
+    GiternalHelper.repo_contents(GiternalHelper.checked_out_path(repo_name)) ==
+      GiternalHelper.repo_contents(GiternalHelper.external_path(repo_name))
+  end
+end
+
+def be_a_git_repo
+  Spec::Matchers::SimpleMatcher.new("a giternal'd repository") do |repo_name|
+    File.directory?(GiternalHelper.checked_out_path(repo_name) + '/.git')
+  end
+end
+
+def be_added_to_commit_index
+  Spec::Matchers::SimpleMatcher.new("a giternal'd repository") do |repo_name|
+    Dir.chdir(GiternalHelper.tmp_path + '/main_repo') do
+      status = `git status`
+      flattened_status = status.split("\n").join(" ")
+      to_be_committed_regex = /new file:\W+dependencies\/#{repo_name}/
+      untracked_files_regex = /Untracked files:.*#{repo_name}/
+      status =~ to_be_committed_regex && !(flattened_status =~ untracked_files_regex)
+    end
+  end
+end
+
+Before do
+  GiternalHelper.clean!
+  GiternalHelper.create_main_repo
+end
+
+After do
+  GiternalHelper.clean!
+end
+
+Given /an external repository named '(.*)'/ do |repo_name|
+  GiternalHelper.create_repo repo_name
+  GiternalHelper.add_content repo_name
+end
+
+Given /'(.*)' is not yet checked out/ do |repo_name|
+  # TODO: Figure out why I can't use should be_false here
+  File.directory?(GiternalHelper.checked_out_path(repo_name)).should == false
+end
+
+Given "the externals are up to date" do
+  GiternalHelper.update_externals
+end
+
+Given "the externals are frozen" do
+  GiternalHelper.freeze_externals
+end
+
+Given /content is added to '(.*)'/ do |repo_name|
+  GiternalHelper.add_content(repo_name)
+end
+
+Given /^the external '(.*)' has been added to \.gitignore$/ do |repo_name|
+  GiternalHelper.add_external_to_ignore(repo_name)
+end
+
+When "I update the externals" do
+  GiternalHelper.update_externals
+end
+
+When "I freeze the externals" do
+  GiternalHelper.freeze_externals
+end
+
+When /I freeze the external '(.*)'/ do |external_name|
+  GiternalHelper.freeze_externals("dependencies/#{external_name}")
+end
+
+When "I unfreeze the externals" do
+  GiternalHelper.unfreeze_externals
+end
+
+When /I unfreeze the external '(.*)'/ do |external_name|
+  GiternalHelper.unfreeze_externals("dependencies/#{external_name}")
+end
+
+Then /'(.*)' should be checked out/ do |repo_name|
+  repo_name.should be_up_to_date
+end
+
+Then /'(.*)' should be up to date/ do |repo_name|
+  repo_name.should be_up_to_date
+end
+
+Then /'(.*)' should not be up to date/ do |repo_name|
+  repo_name.should_not be_up_to_date
+end
+
+Then /'(.*)' should no longer be a git repo/ do |repo_name|
+  repo_name.should_not be_a_git_repo
+end
+
+Then /'(.*)' should be a git repo/ do |repo_name|
+  repo_name.should be_a_git_repo
+end
+
+Then /'(.*)' should be added to the commit index/ do |repo_name|
+  repo_name.should be_added_to_commit_index
+end
+
+Then /'(.*)' should be removed from the commit index/ do |repo_name|
+  repo_name.should_not be_added_to_commit_index
+end

data/features/unfreeze_externals.feature

@@ -0,0 +1,23 @@
+Feature: Unfreeze externals
+  As a developer
+  I want to unfreeze externals
+  So that I can continue to update and develop on them
+
+  Scenario: Main project has one frozen external
+    Given an external repository named 'first_external'
+    And the externals are up to date
+    And the externals are frozen
+    When I unfreeze the externals
+    Then 'first_external' should be a git repo
+    And 'first_external' should be removed from the commit index
+
+  Scenario: Main project has two frozen externals
+    Given an external repository named 'first_external'
+    And an external repository named 'second_external'
+    And the externals are up to date
+    And the externals are frozen
+    When I unfreeze the external 'second_external'
+    Then 'second_external' should be a git repo
+    And 'second_external' should be removed from the commit index
+    And 'first_external' should no longer be a git repo
+    And 'first_external' should be added to the commit index

data/giternal.gemspec

@@ -0,0 +1,74 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE
+# Instead, edit Jeweler::Tasks in Rakefile, and run `rake gemspec`
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{giternal}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Pat Maddox"]
+  s.date = %q{2009-10-10}
+  s.default_executable = %q{giternal}
+  s.description = %q{Giternal provides dead-simple management of external git dependencies. It only stores a small bit of metadata, letting you actively develop in any of the repos. Come deploy time, you can easily freeze freeze all the dependencies to particular versions}
+  s.email = %q{pat.maddox@gmail.com}
+  s.executables = ["giternal"]
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".emacs-project",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION.yml",
+     "bin/giternal",
+     "features/checking_out_externals.feature",
+     "features/freeze_externals.feature",
+     "features/steps/repository_steps.rb",
+     "features/unfreeze_externals.feature",
+     "giternal.gemspec",
+     "giternal_helper.rb",
+     "lib/giternal.rb",
+     "lib/giternal/app.rb",
+     "lib/giternal/repository.rb",
+     "lib/giternal/version.rb",
+     "lib/giternal/yaml_config.rb",
+     "spec/giternal/app_spec.rb",
+     "spec/giternal/repository_spec.rb",
+     "spec/giternal/yaml_config_spec.rb",
+     "spec/spec.opts",
+     "spec/spec_helper.rb",
+     "test_trackers.rb"
+  ]
+  s.homepage = %q{http://github.com/pat-maddox/giternal}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Non-sucky git externals}
+  s.test_files = [
+    "spec/giternal/app_spec.rb",
+     "spec/giternal/repository_spec.rb",
+     "spec/giternal/yaml_config_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, [">= 0"])
+      s.add_development_dependency(%q<cucumber>, [">= 0"])
+    else
+      s.add_dependency(%q<rspec>, [">= 0"])
+      s.add_dependency(%q<cucumber>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 0"])
+    s.add_dependency(%q<cucumber>, [">= 0"])
+  end
+end

data/giternal_helper.rb

@@ -0,0 +1,105 @@
+class GiternalHelper
+  @@giternal_base ||= File.expand_path(File.dirname(__FILE__))
+
+  def self.create_main_repo
+    FileUtils.mkdir_p tmp_path
+    Dir.chdir(tmp_path) do
+      FileUtils.mkdir "main_repo"
+      Dir.chdir('main_repo') do
+        `git init`
+        `echo 'first content' > starter_repo`
+        `git add starter_repo`
+        `git commit -m "starter repo"`
+      end
+    end
+  end
+
+  def self.tmp_path
+    "/tmp/giternal_test"
+  end
+
+  def self.giternal_base
+    @@giternal_base
+  end
+
+  def self.base_project_dir
+    tmp_path + '/main_repo'
+  end
+
+  def self.run(*args)
+    `#{giternal_base}/bin/giternal #{args.join(' ')}`
+  end
+
+  def self.create_repo(repo_name)
+    Dir.chdir(tmp_path) do
+      FileUtils.mkdir_p "externals/#{repo_name}"
+      `cd externals/#{repo_name} && git init`
+    end
+    add_content repo_name
+    add_to_config_file repo_name
+  end
+
+  def self.add_to_config_file(repo_name)
+    config_dir = tmp_path + '/main_repo/config'
+    FileUtils.mkdir(config_dir) unless File.directory?(config_dir)
+    Dir.chdir(config_dir) do
+      `echo #{repo_name}: >> giternal.yml`
+      `echo '  repo: #{external_path(repo_name)}' >> giternal.yml`
+      `echo '  path: dependencies' >> giternal.yml`
+    end
+  end
+
+  def self.add_content(repo_name, content=repo_name)
+    Dir.chdir(tmp_path + "/externals/#{repo_name}") do
+      `echo #{content} >> #{content} && git add #{content}`
+      `git commit #{content} -m "added content to #{content}"`
+    end
+  end
+
+  def self.external_path(repo_name)
+    File.expand_path(tmp_path + "/externals/#{repo_name}")
+  end
+
+  def self.checked_out_path(repo_name)
+    File.expand_path(tmp_path + "/main_repo/dependencies/#{repo_name}")
+  end
+
+  def self.clean!
+    FileUtils.rm_rf tmp_path
+    %w(GIT_DIR GIT_WORK_TREE GIT_INDEX_FILE).each {|var| ENV[var] = nil }
+  end
+
+  def self.update_externals
+    Dir.chdir(tmp_path + '/main_repo') do
+      GiternalHelper.run('update')
+    end
+  end
+
+  def self.freeze_externals(*args)
+    Dir.chdir(tmp_path + '/main_repo') do
+      GiternalHelper.run("freeze", *args)
+    end
+  end
+
+  def self.unfreeze_externals(*args)
+    Dir.chdir(tmp_path + '/main_repo') do
+      GiternalHelper.run("unfreeze", *args)
+    end
+  end
+
+  def self.repo_contents(path)
+    Dir.chdir(path) do
+      contents = `git cat-file -p HEAD`
+      unless contents.include?('tree') && contents.include?('author')
+        raise "something is wrong with the repo, output doesn't contain expected git elements:\n\n #{contents}"
+      end
+      contents
+    end
+  end
+
+  def self.add_external_to_ignore(repo_name)
+    Dir.chdir(tmp_path + '/main_repo') do
+      `echo 'dependencies/#{repo_name}' >> .gitignore`
+    end
+  end
+end

data/lib/giternal.rb

@@ -0,0 +1,10 @@
+$:.unshift(File.dirname(__FILE__)) unless
+  $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+module Giternal
+  
+end
+
+require 'giternal/repository'
+require 'giternal/yaml_config'
+require 'giternal/app'

data/lib/giternal/app.rb

@@ -0,0 +1,61 @@
+module Giternal
+  class App
+    def initialize(base_dir)
+      @base_dir = base_dir
+    end
+
+    def update
+      config.each_repo {|r| r.update }
+    end
+
+    def freezify(*dirs)
+      if dirs.empty?
+        config.each_repo {|r| r.freezify }
+      else
+        dirs.each do |dir|
+          if repo = config.find_repo(dir)
+            repo.freezify
+          end
+        end
+      end
+    end
+
+    def unfreezify(*dirs)
+      if dirs.empty?
+        config.each_repo {|r| r.unfreezify }
+      else
+        dirs.each do |dir|
+          if repo = config.find_repo(dir)
+            repo.unfreezify
+          end
+        end
+      end
+    end
+
+    def run(action, *args)
+      case action
+      when "freeze"
+        freezify(*args)
+      when "unfreeze"
+        unfreezify(*args)
+      else
+        send(action, *args)
+      end
+    end
+
+    def config
+      return @config if @config
+
+      config_file = ['config/giternal.yml', '.giternal.yml'].detect do |file|
+        File.file? File.expand_path(@base_dir + '/' + file)
+      end
+
+      if config_file.nil?
+        $stderr.puts "config/giternal.yml is missing"
+        exit 1
+      end
+
+      @config = YamlConfig.new(@base_dir, File.read(config_file))
+    end
+  end
+end

data/lib/giternal/repository.rb

@@ -0,0 +1,92 @@
+require 'fileutils'
+
+module Giternal
+  class Repository
+    class << self
+      attr_accessor :verbose
+    end
+    attr_accessor :verbose
+
+    def initialize(base_dir, name, repo_url, rel_path)
+      @base_dir = base_dir
+      @name = name
+      @repo_url = repo_url
+      @rel_path = rel_path
+      @verbose = self.class.verbose
+    end
+
+    def update
+      git_ignore_self
+
+      return true if frozen?
+      FileUtils.mkdir_p checkout_path unless File.exist?(checkout_path)
+      if checked_out?
+        if !File.exist?(repo_path + '/.git')
+          raise "Directory '#{@name}' exists but is not a git repository"
+        else
+          update_output { `cd #{repo_path} && git pull 2>&1` }
+        end
+      else
+        update_output { `cd #{checkout_path} && git clone #{@repo_url} #{@name}` }
+      end
+      true
+    end
+
+    def freezify
+      return true if frozen? || !checked_out?
+
+      Dir.chdir(repo_path) do
+        `find .git | sort | xargs tar czf .git.frozen.tgz`
+        FileUtils.rm_r('.git')
+      end
+      `cd #{@base_dir} && git add -f #{rel_repo_path}`
+      true
+    end
+
+    def unfreezify
+      return true unless frozen?
+
+      Dir.chdir(repo_path) do
+        `tar xzf .git.frozen.tgz`
+        FileUtils.rm('.git.frozen.tgz')
+      end
+      `cd #{@base_dir} && git rm -r --cached #{rel_repo_path}`
+      true
+    end
+
+    def frozen?
+      File.exist?(repo_path + '/.git.frozen.tgz')
+    end
+
+    def checked_out?
+      File.exist?(repo_path)
+    end
+
+    private
+    def checkout_path
+      File.expand_path(File.join(@base_dir, @rel_path))
+    end
+
+    def repo_path
+      File.expand_path(checkout_path + '/' + @name)
+    end
+
+    def rel_repo_path
+      @rel_path + '/' + @name
+    end
+
+    def update_output(&block)
+      puts "Updating #{@name}" if verbose
+      block.call
+      puts " ..updated\n" if verbose
+    end
+
+    def git_ignore_self
+      Dir.chdir(@base_dir) do
+        unless File.exist?('.gitignore') && File.read('.gitignore').include?(rel_repo_path)
+          `echo '#{rel_repo_path}' >> .gitignore`
+        end
+      end
+    end
+  end
+end

data/lib/giternal/version.rb

@@ -0,0 +1,9 @@
+module Giternal
+  module VERSION #:nodoc:
+    MAJOR = 0
+    MINOR = 0
+    TINY  = 2
+
+    STRING = [MAJOR, MINOR, TINY].join('.')
+  end
+end

data/lib/giternal/yaml_config.rb

@@ -0,0 +1,30 @@
+require 'yaml'
+
+module Giternal
+  class YamlConfig
+    def initialize(base_dir, yaml_string)
+      @base_dir = base_dir
+      @config_hash = YAML.load yaml_string
+    end
+
+    def each_repo
+      repositories.each { |r| yield(r) if block_given? }
+    end
+
+    def find_repo(path)
+      @config_hash.each do |name, attributes|
+        if path == File.join(attributes["path"], name)
+          return Repository.new(@base_dir, name, attributes["repo"], attributes["path"])
+        end
+      end
+      return nil
+    end
+
+    private
+    def repositories
+      @config_hash.map do |name, attributes|
+        Repository.new(@base_dir, name, attributes["repo"], attributes["path"])
+      end
+    end
+  end
+end

data/spec/giternal/app_spec.rb

@@ -0,0 +1,64 @@
+require File.expand_path(File.join(File.dirname(__FILE__), "..", "spec_helper"))
+
+module Giternal
+  describe App do
+    before(:each) do
+      @app = App.new("some_fake_dir")
+      @mock_config = stub("config", :null_object => true)
+    end
+
+    describe "loading the config file" do
+      before(:each) do
+        File.stub!(:file?).and_return true
+        File.stub!(:read).and_return "yaml config"
+        YamlConfig.stub!(:new).and_return @mock_config
+      end
+
+      it "should look for config/giternal.yml" do
+        File.should_receive(:file?).with(/some_fake_dir\/config\/giternal\.yml/)
+        @app.config
+      end
+
+      it "should look for .giternal.yml if giternal.yml does not exist" do
+        File.should_receive(:file?).with(/some_fake_dir\/config\/giternal\.yml/).and_return false
+        File.should_receive(:file?).with(/some_fake_dir\/\.giternal\.yml/).and_return true
+        @app.config
+      end
+
+      it "should exit with an error when no config file exists" do
+        File.stub!(:file?).and_return false
+        $stderr.should_receive(:puts)
+        @app.should_receive(:exit).with(1)
+        @app.config
+      end
+
+      it "should create a config from the config file" do
+        YamlConfig.should_receive(:new).with('some_fake_dir', "yaml config").and_return @mock_config
+        @app.config
+      end
+    end
+
+    describe "app actions" do
+      before(:each) do
+        @app.stub!(:config).and_return @mock_config
+        @mock_repo = mock("repo")
+        @mock_config.stub!(:each_repo).and_yield(@mock_repo)
+      end
+
+      it "should update each of the repositories" do
+        @mock_repo.should_receive(:update)
+        @app.update
+      end
+
+      it "should freeze each of the repositories" do
+        @mock_repo.should_receive(:freezify)
+        @app.freezify
+      end
+
+      it "should unfreeze each of the repositories" do
+        @mock_repo.should_receive(:unfreezify)
+        @app.unfreezify
+      end
+    end
+  end
+end

data/spec/giternal/repository_spec.rb

@@ -0,0 +1,133 @@
+require File.expand_path(File.join(File.dirname(__FILE__), "..", "spec_helper"))
+
+module Giternal
+  describe Repository do
+    before(:each) do
+      GiternalHelper.create_main_repo
+      GiternalHelper.create_repo 'foo'
+      @repository = Repository.new(GiternalHelper.base_project_dir, "foo",
+                                   GiternalHelper.external_path('foo'),
+                                   'dependencies')
+    end
+
+    it "should check itself out to a dir" do
+      @repository.update
+      File.file?(GiternalHelper.checked_out_path('foo/foo')).should be_true
+      File.read(GiternalHelper.checked_out_path('foo/foo')).strip.
+        should == 'foo'
+    end
+
+    it "should be ignored from git" do
+      @repository.update
+      Dir.chdir(GiternalHelper.base_project_dir) do
+        # TODO: What I really want is to say it shouldn't include 'foo'
+        `git status`.should_not include('dependencies')
+      end
+    end
+
+    it "should only add itself to .gitignore if it's not already there" do
+      2.times { @repository.update }
+      Dir.chdir(GiternalHelper.base_project_dir) do
+        File.read('.gitignore').scan(/foo/).should have(1).item
+        # TODO: What I really want is to say it shouldn't include 'foo'
+        `git status`.should_not include('dependencies')
+      end
+    end
+
+    it "should not show any output when verbose mode is off" do
+      @repository.verbose = false
+      @repository.should_not_receive(:puts)
+      @repository.update
+    end
+
+    it "should not show output when verbose mode is on" do
+      @repository.verbose = true
+      @repository.should_receive(:puts).any_number_of_times
+      @repository.update
+    end
+
+    it "should update the repo when it's already been checked out" do
+      @repository.update
+      GiternalHelper.add_content 'foo', 'newfile'
+      @repository.update
+      File.file?(GiternalHelper.checked_out_path('foo/newfile')).should be_true
+      File.read(GiternalHelper.checked_out_path('foo/newfile')).strip.
+        should == 'newfile'
+    end
+
+    it "should raise an error if the directory exists but there's no .git dir" do
+      FileUtils.mkdir_p(GiternalHelper.checked_out_path('foo'))
+      lambda {
+        @repository.update
+      }.should raise_error(/Directory 'foo' exists but is not a git repository/)
+    end
+
+    describe "freezify" do
+      before(:each) do
+        GiternalHelper.create_repo('external')
+        @repository = Repository.new(GiternalHelper.base_project_dir, 'external',
+                                     GiternalHelper.external_path('external'),
+                                     'dependencies')
+        @repository.update
+      end
+
+      it "should archive the .git dir" do
+        @repository.freezify
+        File.file?(GiternalHelper.checked_out_path('external/.git.frozen.tgz')).should be_true
+      end
+
+      it "should get rid of the .git dir" do
+        File.directory?(GiternalHelper.checked_out_path('external/.git')).should be_true
+        @repository.freezify
+        File.directory?(GiternalHelper.checked_out_path('external/.git')).should be_false
+      end
+    end
+
+    it "should simply return if updated when frozen" do
+      @repository.update
+      @repository.freezify
+      lambda { @repository.update }.should_not raise_error
+    end
+
+    it "should simply return when made to freeze when already frozen" do
+      @repository.update
+      @repository.freezify
+      lambda { @repository.freezify }.should_not raise_error
+    end
+
+    it "should simply return when made to freeze before checked out" do
+      lambda { @repository.freezify }.should_not raise_error
+    end
+
+    it "should simply return when made to unfreeze before checked out" do
+      lambda { @repository.unfreezify }.should_not raise_error
+    end
+
+    it "should simply return when made to unfreeze when already unfrozen" do
+      @repository.update
+      lambda { @repository.unfreezify }.should_not raise_error
+    end
+
+    describe "unfreezify" do
+      before(:each) do
+        GiternalHelper.create_repo('main')
+        GiternalHelper.create_repo('external')
+        @repository = Repository.new(GiternalHelper.base_project_dir, 'external',
+                                     GiternalHelper.external_path('external'),
+                                     'dependencies')
+        @repository.update
+        @repository.freezify
+      end
+
+      it "should unarchive the .git dir" do
+        @repository.unfreezify
+        File.directory?(GiternalHelper.checked_out_path('external/.git')).should be_true
+      end
+
+      it "should remove the archived file" do
+        @repository.unfreezify
+        File.file?(GiternalHelper.checked_out_path('external/.git.frozen.tgz')).should be_false
+      end
+    end
+  end
+end

data/spec/giternal/yaml_config_spec.rb

@@ -0,0 +1,14 @@
+require File.expand_path(File.join(File.dirname(__FILE__), "..", "spec_helper"))
+
+module Giternal
+  describe YamlConfig do
+    it "should create repositories from the config" do
+      config = YamlConfig.new('base_dir',
+                              "rspec:\n  repo: git://rspec\n  path: vendor/plugins\n" +
+                              "foo:\n  repo: git://at/foo\n  path: path/to/foo\n")
+      Repository.should_receive(:new).with('base_dir', "rspec", "git://rspec", "vendor/plugins").and_return :a_repo
+      Repository.should_receive(:new).with('base_dir', "foo", "git://at/foo", "path/to/foo").and_return :a_repo
+      config.each_repo {|r| r.should == :a_repo}
+    end
+  end
+end

data/spec/spec.opts

@@ -0,0 +1 @@
+--colour

data/spec/spec_helper.rb

@@ -0,0 +1,19 @@
+begin
+  require 'spec'
+rescue LoadError
+  require 'rubygems'
+  require 'spec'
+end
+
+$:.unshift(File.dirname(__FILE__) + '/../lib')
+require 'giternal'
+require 'fileutils'
+require 'giternal_helper'
+
+Spec::Runner.configuration.before(:each) do
+  GiternalHelper.clean!
+end
+
+Spec::Runner.configuration.after(:each) do
+  GiternalHelper.clean!
+end

data/test_trackers.rb

@@ -0,0 +1,157 @@
+require 'fileutils'
+module Repomanipulator
+  def repo_path(path)
+    File.expand_path File.join(File.dirname(__FILE__), "test_repos", path)
+  end
+
+  def create_repo(name)
+    path = repo_path(name)
+    FileUtils.mkdir_p(path)
+    Dir.chdir(path) do
+      `git init`
+      `echo first_file > first_file`
+    end
+    commit_all path, "created repo"
+  end
+
+  def commit_all(path, message)
+    Dir.chdir(path) do
+      `git add .`
+      puts `git commit -m "#{message}"`
+    end
+  end
+
+  def clone_repo(from, to, options=nil)
+    Dir.chdir(repo_path("")) { `git clone #{options} #{from} #{to}` }
+  end
+
+  def add_content_to(file, content)
+    path = repo_path file
+    FileUtils.touch path
+    File.open(path, 'w') {|f| f << content }
+    `cd #{File.dirname(path)} && git checkout master`
+    commit_all File.dirname(repo_path(file)), "added content to #{file}"
+  end
+
+  def push(repo)
+    Dir.chdir(repo_path(repo)) { `git push origin master` }
+  end
+
+  def pull(repo)
+    Dir.chdir(repo_path(repo)) { puts `git pull` }
+  end
+
+  def verify_repo_has_files(repo, *files)
+    Dir.chdir(repo_path(repo)) do
+      missing_files = files.select {|f| !File.exist?(f) }
+      raise "Expected files: [#{missing_files.join(', ')}] to exist in #{repo} but are missing" unless missing_files.empty?
+    end
+  end
+end
+include Repomanipulator
+
+module GitSubmodules
+  def add_external(base, external)
+    external_path = repo_path(external)
+    Dir.chdir(repo_path(base)) { puts `git submodule add #{external_path} #{external}` }
+    commit_all repo_path(base), "committed external #{external}"
+  end
+
+  def update_externals(repo)
+    Dir.chdir(repo_path(repo)) do
+      puts `git submodule init`
+      puts `git submodule update`
+    end
+    commit_all repo_path(repo), "updated externals"
+  end
+end
+
+module Giternal
+  def add_external(base, external)
+    external_path = repo_path external
+    Dir.chdir(repo_path(base)) do
+      FileUtils.touch ".giternal.yml"
+      File.open(".giternal.yml", 'w') do |f|
+        f << external << ":\n"
+        f << "  repo: #{external_path}\n"
+        f << "  path: ."
+      end
+      `echo #{external} >> .gitignore`
+    end
+    commit_all repo_path(base), "added #{external}"
+  end
+
+  def update_externals(base)
+    Dir.chdir(repo_path(base)) { puts `giternal update` }
+  end
+end
+
+module Braid
+  def add_external(base, external)
+    external_path = repo_path external
+    Dir.chdir(repo_path(base)) { puts `braid add --type git #{external_path} #{external}` }
+  end
+
+  def update_externals(base)
+    Dir.chdir(repo_path(base)) { puts `braid update` }
+  end
+end
+
+
+drivers = {"submodules" => GitSubmodules, "giternal" => Giternal, "braid" => Braid}
+unless drivers.keys.include?(ARGV.first)
+  puts "Run with:  ruby test_tracking.rb #{drivers.keys.join('|')}"
+  exit
+end
+include drivers[ARGV.first]
+
+FileUtils.rm_rf repo_path("")
+
+def ALERT(message)
+  puts
+  puts "*** " + message
+end
+
+ALERT "the project has will_paginate as an external"
+create_repo "will_paginate-full"
+clone_repo "will_paginate-full", "will_paginate", "--bare"
+
+create_repo "base-full"
+add_external "base-full", "will_paginate"
+clone_repo "base-full", "base", "--bare"
+
+ALERT "Joe and Sarah clone copies of the project"
+clone_repo "base", "joe"
+update_externals "joe"
+
+clone_repo "base", "sarah"
+update_externals "sarah"
+
+ALERT "Joe adds README to will_paginate and commits"
+add_content_to "joe/will_paginate/README", "some content"
+
+ALERT "Joe commits a change to the base project"
+add_content_to "joe/foo", "in the base project"
+
+ALERT "Joe pushes his code"
+push "joe"
+push "joe/will_paginate"
+
+ALERT "Sarah adds LICENSE to her repo and commits"
+add_content_to "sarah/will_paginate/LICENSE", "gnu baby"
+
+ALERT "Sarah commits a change to the base project"
+add_content_to "sarah/bar", "in the base project"
+
+ALERT "Sarah pulls from base project and updates externals"
+pull "sarah"
+update_externals "sarah"
+push "sarah/will_paginate"
+
+ALERT "Does the cloned project have all the files we expect?"
+verify_repo_has_files("sarah", "foo", "bar", "will_paginate/README", "will_paginate/LICENSE")
+
+ALERT "Does the upstream external have all the files we expect?"
+clone_repo "will_paginate", "will_paginate_clone"
+verify_repo_has_files "will_paginate_clone", "README", "LICENSE"
+puts "woooo!  Collaboration ftw"

metadata

@@ -0,0 +1,121 @@
+--- !ruby/object:Gem::Specification 
+name: honkster-giternal
+version: !ruby/object:Gem::Version 
+  hash: 21
+  prerelease: false
+  segments: 
+  - 0
+  - 2
+  - 1
+  version: 0.2.1
+platform: ruby
+authors: 
+- Pat Maddox
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-07-20 00:00:00 -07:00
+default_executable: giternal
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: cucumber
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id002
+description: Giternal provides dead-simple management of external git dependencies. It only stores a small bit of metadata, letting you actively develop in any of the repos. Come deploy time, you can easily freeze freeze all the dependencies to particular versions
+email: pat.maddox@gmail.com
+executables: 
+- giternal
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .emacs-project
+- .gitignore
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION.yml
+- bin/giternal
+- features/checking_out_externals.feature
+- features/freeze_externals.feature
+- features/steps/repository_steps.rb
+- features/unfreeze_externals.feature
+- giternal.gemspec
+- giternal_helper.rb
+- lib/giternal.rb
+- lib/giternal/app.rb
+- lib/giternal/repository.rb
+- lib/giternal/version.rb
+- lib/giternal/yaml_config.rb
+- spec/giternal/app_spec.rb
+- spec/giternal/repository_spec.rb
+- spec/giternal/yaml_config_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- test_trackers.rb
+has_rdoc: true
+homepage: http://github.com/pat-maddox/giternal
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Non-sucky git externals
+test_files: 
+- spec/spec_helper.rb
+- spec/giternal/yaml_config_spec.rb
+- spec/giternal/repository_spec.rb
+- spec/giternal/app_spec.rb