fido 0.1.0

data/README.md

@@ -0,0 +1,75 @@
+# Fido - he fetches
+
+## Install
+
+    gem install fido -s http://gemcutter.org
+
+## Usage
+
+    $ fido git://github.com/sinatra/sinatra.git
+    $ cd sinatra
+    $ git branch
+    * master
+    $ git log --format=%h | head -n1
+    6d8b333
+
+The second run will perform no operation because it's already been fetched.
+This is for safety so any local work isn't interupted
+
+    $ .. add file and commit
+    $ cd ..
+    $ fido git://github.com/sinatra/sinatra.git
+    $ git log --format=%h | head -n1
+    71435b7
+
+## Branch failover
+This is where fido becomes interesting
+
+    $ fido git://github.com/sinatra/sinatra.git foo 0.3.x bar baz
+    $ cd sinatra
+    $ git branch
+    * 0.3.x
+
+We told fido we want to clone the sinatra repo and checkout one branch
+with preference to `foo` if `origin/foo`, then `0.3.x`, etc.
+
+## Destruction
+After fido has fetched a repo he knows that it can be bad to interupt
+any local work.  He can be told destruction is ok.
+
+    $ fido git://github.com/sinatra/sinatra.git foo 0.3.x bar baz
+    $ cd sinatra
+    $ git branch
+    * 0.3.x
+
+    $ cd ..
+    $ fido git://github.com/sinatra/sinatra.git -f 0.9.x
+    $ cd sinatra
+    $ git branch
+      0.3.x
+    * 0.9.x
+
+## LICENSE
+
+Copyright (c) 2009 Blake Mizerany
+
+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/bin/fido

@@ -0,0 +1,32 @@
+#!/usr/bin/env ruby
+$LOAD_PATH.unshift File.dirname(__FILE__) + "/../lib"
+require 'optparse'
+require 'fido'
+
+debug = false
+force = false
+
+ARGV.options do |o|
+  o.banner = "Usage: fido <git-url> [branch[, work, bug123]]"
+  o.separator "\n"
+  o.separator "  This example will clone <git-url> and checkout"
+  o.separator "  to work if origin/work exists otherwise origin/bug123"
+  o.separator "  or origin/master (implied)"
+  o.separator "\n"
+  o.on_tail("-f", "--force", "destructive fetch") { force = true }
+  o.on_tail("-h", "--help", "Show this message") { abort(o.to_s) }
+  o.on_tail("-d", "--debug", "Show debug information") { debug = true }
+  o.parse!
+
+  abort(o.to_s) if ARGV.empty?
+end
+
+ARGV << force if force
+
+if debug
+  Fido.new(Logger.new(STDOUT))
+else
+  Fido.new
+end.clone(*ARGV)
+
+#vim: syn=ruby

data/fido.gemspec

@@ -0,0 +1,29 @@
+Gem::Specification.new do |s|
+  s.specification_version = 2 if s.respond_to? :specification_version=
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+
+  s.name = 'fido'
+  s.version = '0.1.0'
+  s.date = '2009-10-30'
+
+  s.description = "Fido - he fetches"
+  s.summary     = s.description
+
+  s.authors = ["Blake Mizerany"]
+  s.email = "blake.mizerany@gmail.com"
+
+  s.files = %w[
+    README.md
+    fido.gemspec
+    lib/fido.rb
+    bin/fido
+    spec/fido_spec.rb
+  ]
+  s.executables = ['fido']
+
+  s.extra_rdoc_files = %w[README.md]
+
+  s.homepage = "http://github.com/bmizerany/fido/"
+  s.require_paths = %w[lib]
+  s.rubygems_version = '1.1.1'
+end

data/lib/fido.rb

@@ -0,0 +1,55 @@
+require 'fileutils'
+require 'open3'
+require 'logger'
+require 'hutils/logable'
+
+class Fido
+  include FileUtils
+  include Logable
+
+  def clone(repo, *to)
+    force = to.last == true && to.pop
+    to << "master"
+
+    dir = File.basename(repo, ".git")
+    mkdir_p dir
+
+    cd dir do
+      return if !force && File.exists?(".git/FIDO")
+
+      if !File.exists?(".git")
+        cmd "git init"
+        cmd "git remote add origin #{repo}"
+      end
+
+      cmd "git fetch origin"
+
+      branches = cmd("git branch -a")
+
+      to.each do |branch|
+        if branches =~ /\* #{branch}\n/
+          cmd "git reset --hard origin/#{branch}"
+          break
+        elsif branches =~ /  remotes\/origin\/#{branch}\n/
+          cmd "git branch -D #{branch}" if branches =~ /  #{branch}\n/
+          cmd "git checkout -b #{branch} origin/#{branch}"
+          break
+        end
+      end
+
+      touch ".git/FIDO"
+    end
+  end
+
+  def cmd(c)
+    out, err = nil
+    @logger.debug c
+    Open3.popen3(c) do |_i, o, e|
+      out = o.read
+      err = e.read
+    end
+    @logger.debug out if out !~ /^\s*$/
+    @logger.error err if err !~ /^\s*$/
+    out
+  end
+end

data/spec/fido_spec.rb

@@ -0,0 +1,115 @@
+$LOAD_PATH.unshift File.dirname(__FILE__) + "/../lib"
+require 'fido'
+require 'recho'
+
+GitDir = File.expand_path(File.dirname(__FILE__) + "/git")
+TestRepo = GitDir + "/test-repo.git"
+
+include FileUtils
+
+describe "Fido" do
+
+  def lastSHA
+    `git log --format=%H | head -n1`.chomp
+  end
+
+  before do
+    @fido = if $DEBUG
+      Fido.new(Logger.new(STDOUT))
+    else
+      Fido.new
+    end
+
+    @pwd = pwd
+
+    mkdir_p TestRepo
+
+    cd TestRepo do
+      `git init`
+      echo("foo!") > "FOO"
+      `git add FOO`
+      `git commit -m 'foo'`
+    end
+
+    cd GitDir
+  end
+
+  after { cd @pwd ; rm_rf GitDir }
+
+  it "clones a repo and leaves it at master by default" do
+    @fido.clone(TestRepo)
+    cd "test-repo" do
+      `git branch`.should =~ /\* master/
+    end
+  end
+
+  it "does a checkout of the first branch if available" do
+    cd TestRepo do
+      `git branch first`
+    end
+    @fido.clone(TestRepo, "first")
+    cd "test-repo" do
+      `git branch`.should =~ /\* first/
+    end
+  end
+
+  it "does a checkout of the second branch if first is not available" do
+    cd TestRepo do
+      `git branch second`
+    end
+    @fido.clone(TestRepo, "first", "second")
+    cd "test-repo" do
+      `git branch`.should =~ /\* second/
+    end
+  end
+
+  it "drops a FIDO file one clone" do
+    @fido.clone(TestRepo)
+    cd "test-repo" do
+      File.exists?(".git/FIDO").should == true
+    end
+  end
+
+  it "does nothing if .git/FIDO exists" do
+    cd TestRepo do
+      `git branch some-work`
+    end
+
+    @fido.clone(TestRepo)
+
+    cd "test-repo" do
+      `git checkout -b stay-here 2>/dev/null`
+    end
+
+    @fido.clone(TestRepo, "some-work")
+
+    cd "test-repo" do
+      `git branch`.should =~ /\* stay-here/
+    end
+  end
+
+  it "will mirror upstream if forced" do
+    sha = nil
+
+    cd TestRepo do
+      echo("foo") >> "FOO"
+      `git add FOO`
+      `git commit -m 'foo'`
+      sha = lastSHA
+    end
+
+    @fido.clone(TestRepo)
+
+    cd "test-repo" do
+      echo("bar") >> "BAR"
+      `git add BAR`
+      `git commit -m 'foo'`
+    end
+
+    @fido.clone(TestRepo, true)
+
+    cd "test-repo" do
+      lastSHA.should == sha
+    end
+  end
+end

metadata

@@ -0,0 +1,59 @@
+--- !ruby/object:Gem::Specification 
+name: fido
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Blake Mizerany
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-10-30 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: Fido - he fetches
+email: blake.mizerany@gmail.com
+executables: 
+- fido
+extensions: []
+
+extra_rdoc_files: 
+- README.md
+files: 
+- README.md
+- fido.gemspec
+- lib/fido.rb
+- bin/fido
+- spec/fido_spec.rb
+has_rdoc: true
+homepage: http://github.com/bmizerany/fido/
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.4
+signing_key: 
+specification_version: 2
+summary: Fido - he fetches
+test_files: []
+