git-hub 0.1.0

data/.kick

@@ -0,0 +1,26 @@
+# take control of the growl notifications
+module GrowlHacks
+  def growl(type, subject, body, *args, &block)
+    case type
+    when Kicker::GROWL_NOTIFICATIONS[:succeeded]
+      puts subject = "Success"
+      body = body.split("\n").last
+    when Kicker::GROWL_NOTIFICATIONS[:failed]
+      subject = "Failure"
+      puts body
+      body = body.split("\n").last
+    else
+      return nil
+    end
+    super(type, subject, body, *args, &block)
+  end
+end
+
+Kicker.send :extend, GrowlHacks
+
+# no logging
+Kicker::Utils.module_eval do
+  def log(message)
+    nil
+  end
+end

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Chris Wanstrath
+
+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,184 @@
+hub: git + hub = github
+=======================
+
+`hub` is a command line utility which adds GitHub knowledge to `git`.
+
+It can used on its own or as a `git` wrapper.
+
+Normal:
+
+    $ hub clone rtomayko/tilt
+    Initialized empty Git repository in /Users/chris/sandbox/tilt/.git/
+    remote: Counting objects: 307, done.
+    remote: Compressing objects: 100% (219/219), done.
+    remote: Total 307 (delta 175), reused 85 (delta 45)
+    Receiving objects: 100% (307/307), 48.91 KiB, done.
+    Resolving deltas: 100% (175/175), done.
+
+Wrapping `git`:
+
+    $ git clone rack/rack
+    Initialized empty Git repository in /Users/chris/sandbox/rack/.git/
+    remote: Counting objects: 4005, done.
+    remote: Compressing objects: 100% (1738/1738), done.
+    remote: Total 4005 (delta 2505), reused 3620 (delta 2208)
+    Receiving objects: 100% (4005/4005), 785.82 KiB | 129 KiB/s, done.
+    Resolving deltas: 100% (2505/2505), done.
+
+hub requires you have `git` installed and in your path. It also
+requires Ruby 1.8.6+ or Ruby 1.9.1+. No other libraries necessary.
+
+
+Install
+-------
+
+### Standalone
+
+`hub` is most easily installed as a standalone script:
+
+    curl http://defunkt.github.com/hub/standalone > ~/bin/hub && chmod 0755 !$
+
+Assuming `~/bin/` is in your path, you're ready to roll:
+
+    $ hub version
+    git version 1.6.4.2
+    hub version 0.1.0
+
+### Rubygems
+
+Though not recommended, `hub` can also be installed as a Rubygem:
+
+    $ gem install git-hub -s http://gemcutter.org/
+
+(Yes, the gem name is `git-hub`.)
+
+### Source
+
+You can also install from source:
+
+    $ git clone git://github.com/defunkt/hub.git
+    $ cd hub
+    $ rake standalone
+    $ cp hub /usr/local/bin/
+
+
+Aliasing
+--------
+
+hub works best when it wraps `git`. This is not dangerous - your
+normal git commands should all work. hub merely adds some sugar.
+
+Typing `hub alias <shell>` will display alias instructions for
+your shell. `hub alias` alone will show the known shells.
+
+For example:
+
+    $ hub alias bash
+    Run this in your shell to start using `hub` as `git`:
+      alias git=hub
+
+You should place this command in your `.bash_profile` or other startup
+script to ensure runs on login.
+
+The alias command can also be eval'd directly using the `-s` flag:
+
+    $ eval `hub alias -s bash`
+
+
+Commands
+--------
+
+Assuming you've aliased `hub` to `git` the following commands now have
+superpowers:
+
+### git clone
+
+    $ git clone schacon/ticgit
+    > git clone git://github.com/schacon/ticgit.git
+
+    $ git clone -p schacon/ticgit
+    > git clone git@github.com:schacon/ticgit.git
+
+    $ git clone resque
+    > git clone git://github.com/YOUR_USER/resque.git
+
+    $ git clone -p resque
+    > git clone git@github.com:YOUR_USER/resque.git
+
+### git remote add
+
+    $ git remote add rtomayko
+    > git remote add rtomayko git://github.com/rtomayko/CURRENT_REPO.git
+
+    $ git remote add -p pjhyett
+    > git remote add rtomayko git@github.com:rtomayko/CURRENT_REPO.git
+
+### git init
+
+    $ git init -g
+    > git init
+    > git remote add origin git@github.com:YOUR_USER/REPO.git
+
+### git help
+
+    $ git help
+    > (improved git help)
+
+
+GitHub Login
+------------
+
+To get the most out of `hub`, you'll want to ensure your GitHub login
+is stored locally in your Git config.
+
+To test it run this:
+
+    $ git config --global github.user
+
+If you see nothing, you need to set the config setting:
+
+    $ git config --global github.user YOUR_USER
+
+See <http://github.com/guides/local-github-config> for more information.
+
+
+Prior Art
+---------
+
+These projects also aim to either improve git or make interacting with
+GitHub simpler:
+
+* [eg](http://www.gnome.org/~newren/eg/)
+* [github-gem](http://github.com/defunkt/github-gem)
+* [gh](http://github.com/visionmedia/gh)
+
+
+Contributing
+------------
+
+Once you've made your great commits:
+
+1. [Fork][0] hub
+2. Create a topic branch - `git checkout -b my_branch`
+3. Push to your branch - `git push origin my_branch`
+4. Create an [Issue][1] with a link to your branch
+5. That's it!
+
+
+Meta
+----
+
+* Code: `git clone git://github.com/defunkt/hub.git`
+* Home: <http://github.com/defunkt/hub>
+* Bugs: <http://github.com/defunkt/hub/issues>
+* List: <http://groups.google.com/group/github>
+* Gems: <http://gemcutter.org/gems/hub>
+
+
+Author
+------
+
+Chris Wanstrath :: chris@ozmm.org :: @defunkt
+
+[0]: http://help.github.com/forking/
+[1]: http://github.com/defunkt/hub/issues

data/Rakefile

@@ -0,0 +1,93 @@
+require 'rake/testtask'
+
+task :default => :test
+
+Rake::TestTask.new do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = false
+end
+
+desc "Launch Kicker (like autotest)"
+task :kicker do
+  puts "Kicking... (ctrl+c to cancel)"
+  exec "kicker -e rake test bin"
+end
+
+desc "Build a gem"
+task :gem => [ :gemspec, :build ]
+
+desc "Build standalone script"
+task :standalone => [ :test, :load_hub ] do
+  Hub::Standalone.save('hub')
+end
+
+task :load_hub do
+  $LOAD_PATH.unshift 'lib'
+  require 'hub'
+end
+
+begin
+  require 'jeweler'
+  $LOAD_PATH.unshift 'lib'
+  require 'hub'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "git-hub"
+    gemspec.summary = gemspec.description = "hub introduces git to GitHub"
+    gemspec.homepage = "http://github.com/defunkt/hub"
+    gemspec.version = Hub::Version
+    gemspec.authors = ["Chris Wanstrath"]
+    gemspec.email = "chris@ozmm.org"
+    gemspec.post_install_message = <<-message
+
+------------------------------------------------------------
+
+                  You there! Wait, I say!
+                  =======================
+
+       If you are a heavy user of `git` on the command
+       line  you  may  want  to  install `hub` the old
+       fashioned way.  Faster  startup  time,  you see.
+
+       Check  out  the  installation  instructions  at
+       http://github.com/defunkt/hub#readme  under the
+       "Standalone" section.
+
+       Cheers,
+       defunkt
+
+------------------------------------------------------------
+
+message
+  end
+rescue LoadError
+  puts "Jeweler not available."
+  puts "Install it with: gem install jeweler"
+end
+
+desc "Push a new version to Gemcutter"
+task :publish => [ :test, :gemspec, :build ] do
+  system "git tag v#{Hub::Version}"
+  system "git push origin v#{Hub::Version}"
+  system "git push origin master"
+  system "gem push pkg/git-hub-#{Hub::Version}.gem"
+  system "git clean -fd"
+  exec "rake pages"
+end
+
+desc "Publish to GitHub Pages"
+task :pages => [ :check_dirty, :standalone ] do
+  `git checkout gh-pages`
+  `mv hub standalone`
+  `git add standalone*`
+  `git commit -m "update standalone"`
+  `git push origin gh-pages`
+  `git checkout master`
+  puts :done
+end
+
+task :check_dirty do
+  if !`git status`.include?('nothing to commit')
+    abort "dirty index - not publishing!"
+  end
+end

data/bin/hub

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+# hub(1)
+# alias git=hub
+
+require 'hub'
+Hub::Runner.execute(*ARGV)

data/lib/hub.rb

@@ -0,0 +1,5 @@
+require 'hub/version'
+require 'hub/args'
+require 'hub/commands'
+require 'hub/runner'
+require 'hub/standalone'

data/lib/hub/args.rb

@@ -0,0 +1,35 @@
+module Hub
+  # The Args class exists to make it more convenient to work with
+  # command line arguments intended for git from within the Hub
+  # codebase.
+  #
+  # The ARGV array is converted into an Args instance by the Hub
+  # instance when instantiated.
+  class Args < Array
+    # With no arguments, returns the `after` callback.
+    #
+    # With a single argument, sets the `after` callback.
+    # Can be set to a string or a proc.
+    #
+    # If proc:
+    #   The proc is executed after the git command is executed. For
+    #   example, the `hub version` command sets the following proc to
+    #   print its information after running `git version`:
+    #
+    #     after { puts "hub version #{version_number}" }
+    #
+    # If string:
+    #   The string is assumed to be a command and executed after the
+    #   git command is executed:
+    #
+    #     after "echo 'hub version #{version_number}'"
+    def after(command = nil, &block)
+      @after ||= block ? block : command
+    end
+
+    # Boolean indicating whether an `after` callback has been set.
+    def after?
+      !!@after
+    end
+  end
+end

data/lib/hub/commands.rb

@@ -0,0 +1,245 @@
+module Hub
+  # The Commands module houses the git commands that hub
+  # lovingly wraps. If a method exists here, it is expected to have a
+  # corresponding git command which either gets run before or after
+  # the method executes.
+  #
+  # The typical flow is as follows:
+  #
+  # 1. hub is invoked from the command line:
+  #    $ hub clone rtomayko/tilt
+  #
+  # 2. The Hub class is initialized:
+  #    >> hub = Hub.new('clone', 'rtomayko/tilt')
+  #
+  # 3. The method representing the git subcommand is executed with the
+  #    full args:
+  #    >> Commands.clone('clone', 'rtomayko/tilt')
+  #
+  # 4. That method rewrites the args as it sees fit:
+  #    >> args[1] = "git://github.com/" + args[1] + ".git"
+  #    => "git://github.com/rtomayko/tilt.git"
+  #
+  # 5. The new args are used to run `git`:
+  #    >> exec "git", "clone", "git://github.com/rtomayko/tilt.git"
+  #
+  # An optional `after` callback can be set. If so, it is run after
+  # step 5 (which then performs a `system` call rather than an
+  # `exec`). See `Hub::Args` for more information on the `after` callback.
+  module Commands
+    # We are a blank slate.
+    instance_methods.each { |m| undef_method(m) unless m =~ /(^__|send|to\?$)/ }
+    extend self
+
+    # Templates and useful information.
+    PRIVATE = 'git@github.com:%s/%s.git'
+    PUBLIC  = 'git://github.com/%s/%s.git'
+    USER    = `git config --global github.user`.chomp
+    REPO    = `basename $(pwd)`.chomp
+    LGHCONF = "http://github.com/guides/local-github-config"
+
+    # $ hub clone rtomayko/tilt
+    # > git clone git://github.com/rtomayko/tilt.
+    #
+    # $ hub clone -p kneath/hemingway
+    # > git clone git@github.com:kneath/hemingway.git
+    def clone(args)
+      ssh = args.delete('-p')
+      args[1..-1].each_with_index do |arg, i|
+        i += 1
+        if arg.scan('/').size == 1 && !arg.include?(':')
+          url = ssh ? PRIVATE : PUBLIC
+          args[i] = url % arg.split('/')
+          break
+        elsif arg !~ /:|\//
+          url = ssh ? PRIVATE : PUBLIC
+          args[i] = url % [ github_user, arg ]
+          break
+        end
+      end
+    end
+
+    # $ hub remote add pjhyett
+    # > git remote add pjhyett git://github.com/pjhyett/THIS_REPO.git
+    #
+    # $ hub remote add -p mojombo
+    # > git remote add mojombo git@github.com:mojombo/THIS_REPO.git
+    def remote(args)
+      return unless args[1] == 'add'
+
+      # Assume GitHub usernames don't ever contain : or /, while URLs
+      # do.
+      if args[-1] !~ /:|\//
+        ssh  = args.delete('-p')
+        user = args.last
+        url  = ssh ? PRIVATE : PUBLIC
+        args << url % [ user, REPO ]
+      end
+    end
+
+    # $ hub init -g
+    # > git init
+    # > git remote add origin git@github.com:USER/REPO.git
+    def init(args)
+      if args.delete('-g')
+        # Can't do anything if we don't have a USER set.
+
+        url = PRIVATE % [ github_user, REPO ]
+        args.after "git remote add origin #{url}"
+      end
+    end
+
+    def alias(args)
+      shells = {
+        'sh'   => 'alias git=hub',
+        'bash' => 'alias git=hub',
+        'zsh'  => 'alias git=hub',
+        'csh'  => 'alias git hub',
+        'fish' => 'alias git hub'
+      }
+
+      silent = args.delete('-s')
+
+      if shell = args[1]
+        if silent.nil?
+          puts "Run this in your shell to start using `hub` as `git`:"
+          print "  "
+        end
+      else
+        puts "usage: hub alias [-s] SHELL", ""
+        puts "You already have hub installed and available in your PATH,"
+        puts "but to get the full experience you'll want to alias it to"
+        puts "`git`.", ""
+        puts "To see how to accomplish this for your shell, run the alias"
+        puts "command again with the name of your shell.", ""
+        puts "Known shells:"
+        shells.map { |key, _| key }.sort.each do |key|
+          puts "  " + key
+        end
+        puts "", "Options:"
+        puts "  -s   Silent. Useful when using the output with eval, e.g."
+        puts "       $ eval `hub alias -s bash`"
+
+        exit
+      end
+
+      if shells[shell]
+        puts shells[shell]
+      else
+        abort "fatal: never heard of `#{shell}'"
+      end
+
+      exit
+    end
+
+    # $ hub version
+    # > git version
+    # (print hub version)
+    def version(args)
+      args.after do
+        puts "hub version %s" % Version
+      end
+    end
+    alias_method "--version", :version
+
+    # $ hub help
+    # (print improved help text)
+    def help(args)
+      return if args.size > 1
+      puts improved_help_text
+      exit
+    end
+
+    # The text print when `hub help` is run, kept in its own method
+    # for the convenience of the author.
+    def improved_help_text
+      <<-help
+usage: git [--version] [--exec-path[=GIT_EXEC_PATH]] [--html-path]
+    [-p|--paginate|--no-pager] [--bare] [--git-dir=GIT_DIR]
+    [--work-tree=GIT_WORK_TREE] [--help] COMMAND [ARGS]
+
+Creating a git repository:
+   clone      Clone a repository into a new directory
+   init       Create an empty git repository or reinitialize an existing one
+
+Working with content:
+   add        Add file contents to the index
+   branch     List, create, or delete branches
+   checkout   Checkout a branch or paths to the working tree
+   commit     Record changes to the repository
+   diff       Show changes between commits, commit and working tree, etc
+   log        Show commit logs
+   merge      Join two or more development histories together
+   mv         Move or rename a file, a directory, or a symlink
+   rm         Remove files from the working tree and from the index
+   status     Show the working tree status
+   show       Show various types of objects
+   tag        Create, list, delete or verify a tag object signed with GPG
+
+Over the network:
+   fetch      Download objects and refs from another repository
+   pull       Fetch from and merge with another repository or a local branch
+   push       Update remote refs along with associated objects
+   remote     Manage a set of tracked repositories
+
+Advanced commands:
+   bisect     Find by binary search the change that introduced a bug
+   grep       Print lines matching a pattern
+   reset      Reset current HEAD to the specified state
+   rebase     Forward-port local commits to the updated upstream head
+
+See 'git help COMMAND' for more information on a specific command.
+help
+    end
+
+  private
+    #
+    # Helper methods are private so they cannot be invoked
+    # from the command line.
+    #
+
+    def github_user
+      if USER.empty?
+        abort "** No GitHub user set. See #{LGHCONF}"
+      else
+        USER
+      end
+    end
+
+    # All calls to `puts` in after hooks or commands are paged,
+    # git-style.
+    def puts(*args)
+      page_stdout
+      super
+    end
+
+    # http://nex-3.com/posts/73-git-style-automatic-paging-in-ruby
+    def page_stdout
+      return unless $stdout.tty?
+
+      read, write = IO.pipe
+
+      if Kernel.fork
+        # Parent process, become pager
+        $stdin.reopen(read)
+        read.close
+        write.close
+
+        # Don't page if the input is short enough
+        ENV['LESS'] = 'FSRX'
+
+        # Wait until we have input before we start the pager
+        Kernel.select [STDIN]
+
+        pager = ENV['PAGER'] || 'less'
+        exec pager rescue exec "/bin/sh", "-c", pager
+      else
+        # Child process
+        $stdout.reopen(write)
+        $stderr.reopen(write) if $stderr.tty?
+        read.close
+        write.close
+      end
+    end
+  end
+end

data/lib/hub/runner.rb

@@ -0,0 +1,64 @@
+module Hub
+  # The Hub runner expects to be initialized with `ARGV` and primarily
+  # exists to run a git command.
+  #
+  # The actual functionality, that is, the code it runs when it needs to
+  # augment a git command, is kept in the `Hub::Commands` module.
+  class Runner
+    attr_reader :args
+    def initialize(*args)
+      @args = Args.new(args)
+
+      # Hack to emulate git-style
+      @args[0] = 'help' if @args.empty?
+
+      if Commands.respond_to?(@args[0])
+        Commands.send(@args[0], @args)
+      end
+    end
+
+    # Shortcut
+    def self.execute(*args)
+      new(*args).execute
+    end
+
+    # Returns the current after callback, which (if set) is run after
+    # the target git command.
+    #
+    # See the `Hub::Args` class for more information on the `after`
+    # callback.
+    def after
+      args.after.to_s
+    end
+
+    # A string representation of the git command we would run if
+    # #execute were called.
+    def command
+      "git #{args.join(' ')}"
+    end
+
+    # Runs the target git command with an optional callback. Replaces
+    # the current process.
+    def execute
+      if args.after?
+        execute_with_after_callback
+      else
+        exec "git", *args
+      end
+    end
+
+    # Runs the target git command then executes the `after` callback.
+    #
+    # See the `Hub::Args` class for more information on the `after`
+    # callback.
+    def execute_with_after_callback
+      after = args.after
+      if system("git", *args)
+        after.respond_to?(:call) ? after.call : exec(after)
+        exit
+      else
+        exit 1
+      end
+    end
+  end
+end

data/lib/hub/standalone.rb

@@ -0,0 +1,49 @@
+module Hub
+  module Standalone
+    extend self
+
+    PREAMBLE = <<-premable
+#!/usr/bin/env ruby
+#
+# This file, hub, is generated code.
+# Please DO NOT EDIT or send patches for it.
+#
+# Please take a look at the source from
+# http://github.com/defunkt/hub
+# and submit patches against the individual files
+# that build hub.
+#
+
+premable
+
+    POSTAMBLE = "Hub::Runner.execute(*ARGV)"
+
+    def save(filename, path = '.')
+      target = File.join(File.expand_path(path), filename)
+      File.open(target, 'w') do |f|
+        f.puts build
+        f.chmod 0755
+      end
+    end
+
+    def build
+      root = File.dirname(__FILE__)
+
+      standalone = ''
+      standalone << PREAMBLE
+
+      Dir["#{root}/*.rb"].each do |file|
+        # skip standalone.rb
+        next if file == __FILE__
+
+        File.readlines(file).each do |line|
+          next if line =~ /^\s*#/
+          standalone << line
+        end
+      end
+
+      standalone << POSTAMBLE
+      standalone
+    end
+  end
+end

data/lib/hub/version.rb

@@ -0,0 +1,3 @@
+module Hub
+  Version = '0.1.0'
+end

data/test/alias_test.rb

@@ -0,0 +1,41 @@
+$LOAD_PATH.unshift File.dirname(__FILE__)
+require 'helper'
+
+class AliasTest < Test::Unit::TestCase
+  def test_alias
+    instructions = hub("alias")
+    assert_includes "bash", instructions
+    assert_includes "sh", instructions
+    assert_includes "csh", instructions
+    assert_includes "zsh", instructions
+    assert_includes "fish", instructions
+  end
+
+  def test_alias_silent
+    assert_equal "alias git=hub\n", hub("alias -s bash")
+  end
+
+  def test_alias_bash
+    assert_alias_command "bash", "alias git=hub"
+  end
+
+  def test_alias_sh
+    assert_alias_command "sh", "alias git=hub"
+  end
+
+  def test_alias_zsh
+    assert_alias_command "zsh", "alias git=hub"
+  end
+
+  def test_alias_csh
+    assert_alias_command "csh", "alias git hub"
+  end
+
+  def test_alias_fish
+    assert_alias_command "fish", "alias git hub"
+  end
+
+  def test_alias_blah
+    assert_alias_command "blah", "fatal: never heard of `blah'"
+  end
+end

data/test/helper.rb

@@ -0,0 +1,78 @@
+require 'test/unit'
+$LOAD_PATH.unshift File.dirname(__FILE__) + '/../lib'
+require 'hub'
+
+class Test::Unit::TestCase
+  # Shortcut for creating a `Hub` instance. Pass it what you would
+  # normally pass `hub` on the command line, e.g.
+  #
+  # shell: hub clone rtomayko/tilt
+  #  test: Hub("clone rtomayko/tilt")
+  def Hub(args)
+    Hub::Runner.new(*args.split(' '))
+  end
+
+  # Shortcut for running the `hub` command in a subprocess. Returns
+  # STDOUT as a string. Pass it what you would normally pass `hub` on
+  # the command line, e.g.
+  #
+  # shell: hub clone rtomayko/tilt
+  #  test: hub("clone rtomayko/tilt")
+  #
+  # If a block is given it will be run in the child process before
+  # execution begins. You can use this to monkeypatch or fudge the
+  # environment before running hub.
+  def hub(args)
+    parent_read, child_write = IO.pipe
+
+    fork do
+      yield if block_given?
+      $stdout.reopen(child_write)
+      $stderr.reopen(child_write)
+      Hub(args).execute
+    end
+
+    child_write.close
+    parent_read.read
+  end
+
+  # Asserts that `hub` will run a specific git command based on
+  # certain input.
+  #
+  # e.g.
+  #  assert_command "clone git/hub", "git clone git://github.com/git/hub.git"
+  #
+  # Here we are saying that this:
+  #   $ hub clone git/hub
+  # Should in turn execute this:
+  #   $ git clone git://github.com/git/hub.git
+  def assert_command(input, expected)
+    assert_equal expected, Hub(input).command
+  end
+
+  # Asserts that `hub` will show a specific alias command for a
+  # specific shell.
+  #
+  # e.g.
+  #  assert_alias_command "sh", "alias git=hub"
+  #
+  # Here we are saying that this:
+  #   $ hub alias sh
+  # Should display this:
+  #   Run this in your shell to start using `hub` as `git`:
+  #     alias git=hub
+  def assert_alias_command(shell, command)
+    expected = "Run this in your shell to start using `hub` as `git`:\n  %s\n"
+    assert_equal(expected % command, hub("alias #{shell}"))
+  end
+
+  # Asserts that `haystack` includes `needle`.
+  def assert_includes(needle, haystack)
+    assert haystack.include?(needle)
+  end
+
+  # Asserts that `haystack` does not include `needle`.
+  def assert_not_includes(needle, haystack)
+    assert !haystack.include?(needle)
+  end
+end

data/test/hub_test.rb

@@ -0,0 +1,98 @@
+$LOAD_PATH.unshift File.dirname(__FILE__)
+require 'helper'
+
+class HubTest < Test::Unit::TestCase
+  def setup
+    Hub::Commands::USER.replace("tpw")
+  end
+
+  def test_private_clone
+    input   = "clone -p rtomayko/ron"
+    command = "git clone git@github.com:rtomayko/ron.git"
+    assert_command input, command
+  end
+
+  def test_public_clone
+    input   = "clone rtomayko/ron"
+    command = "git clone git://github.com/rtomayko/ron.git"
+    assert_command input, command
+  end
+
+  def test_your_private_clone
+    input   = "clone -p resque"
+    command = "git clone git@github.com:tpw/resque.git"
+    assert_command input, command
+  end
+
+  def test_your_public_clone
+    input   = "clone resque"
+    command = "git clone git://github.com/tpw/resque.git"
+    assert_command input, command
+  end
+
+  def test_your_private_clone_fails_without_config
+    out = hub("clone -p mustache") do
+      Hub::Commands::USER.replace("")
+    end
+
+    assert_equal "** No GitHub user set. See http://github.com/guides/local-github-config\n", out
+  end
+
+  def test_your_public_clone_fails_without_config
+    out = hub("clone mustache") do
+      Hub::Commands::USER.replace("")
+    end
+
+    assert_equal "** No GitHub user set. See http://github.com/guides/local-github-config\n", out
+  end
+
+  def test_private_clone_left_alone
+    input   = "clone git@github.com:rtomayko/ron.git"
+    command = "git clone git@github.com:rtomayko/ron.git"
+    assert_command input, command
+  end
+
+  def test_public_clone_left_alone
+    input   = "clone git://github.com/rtomayko/ron.git"
+    command = "git clone git://github.com/rtomayko/ron.git"
+    assert_command input, command
+  end
+
+  def test_private_remote
+    input   = "remote add -p rtomayko"
+    command = "git remote add rtomayko git@github.com:rtomayko/hub.git"
+    assert_command input, command
+  end
+
+  def test_public_remote
+    input   = "remote add rtomayko"
+    command = "git remote add rtomayko git://github.com/rtomayko/hub.git"
+    assert_command input, command
+  end
+
+  def test_init
+    h = Hub("init -g")
+    assert_equal "git init", h.command
+    assert_equal "git remote add origin git@github.com:tpw/hub.git", h.after
+  end
+
+  def test_init_no_login
+    out = hub("init -g") do
+      Hub::Commands::USER.replace("")
+    end
+
+    assert_equal "** No GitHub user set. See http://github.com/guides/local-github-config\n", out
+  end
+
+  def test_version
+    assert_equal "git version 1.6.4.2\nhub version 0.1.0\n", hub('--version')
+  end
+
+  def test_help
+    assert_equal Hub::Commands.improved_help_text, hub("help")
+  end
+
+  def test_help_by_default
+    assert_equal Hub::Commands.improved_help_text, hub("")
+  end
+end

data/test/standalone_test.rb

@@ -0,0 +1,46 @@
+$LOAD_PATH.unshift File.dirname(__FILE__)
+require 'helper'
+require 'fileutils'
+
+class StandaloneTest < Test::Unit::TestCase
+  include FileUtils
+
+  def setup
+    rm "hub" if File.exists? 'hub'
+    rm_rf "/tmp/_hub_private" if File.exists? '/tmp/_hub_private'
+    mkdir "/tmp/_hub_private"
+    chmod 0400, "/tmp/_hub_private"
+  end
+
+  def teardown
+    rm "hub" if File.exists? 'hub'
+    rm_rf "/tmp/_hub_private" if File.exists? "/tmp/_hub_private"
+  end
+
+  def test_standalone
+    standalone = Hub::Standalone.build
+    assert_includes "This file, hub, is generated code", standalone
+    assert_includes "Runner", standalone
+    assert_includes "Args", standalone
+    assert_includes "Commands", standalone
+    assert_includes ".execute(*ARGV)", standalone
+    assert_not_includes "module Standalone", standalone
+  end
+
+  def test_standalone_save
+    Hub::Standalone.save("hub")
+    assert_equal Hub::Standalone.build + "\n", File.read('./hub')
+  end
+
+  def test_standalone_save_permission_denied
+    assert_raises Errno::EACCES do
+      Hub::Standalone.save("hub", "/tmp/_hub_private")
+    end
+  end
+
+  def test_standalone_save_doesnt_exist
+    assert_raises Errno::ENOENT do
+      Hub::Standalone.save("hub", "/tmp/something/not/real")
+    end
+  end
+end

metadata

@@ -0,0 +1,92 @@
+--- !ruby/object:Gem::Specification 
+name: git-hub
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Chris Wanstrath
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-12-08 00:00:00 -08:00
+default_executable: hub
+dependencies: []
+
+description: hub introduces git to GitHub
+email: chris@ozmm.org
+executables: 
+- hub
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.md
+files: 
+- .kick
+- LICENSE
+- README.md
+- Rakefile
+- bin/hub
+- lib/hub.rb
+- lib/hub/args.rb
+- lib/hub/commands.rb
+- lib/hub/runner.rb
+- lib/hub/standalone.rb
+- lib/hub/version.rb
+- test/alias_test.rb
+- test/helper.rb
+- test/hub_test.rb
+- test/standalone_test.rb
+has_rdoc: true
+homepage: http://github.com/defunkt/hub
+licenses: []
+
+post_install_message: |+
+  
+  ------------------------------------------------------------
+  
+                    You there! Wait, I say!
+                    =======================
+  
+         If you are a heavy user of `git` on the command
+         line  you  may  want  to  install `hub` the old
+         fashioned way.  Faster  startup  time,  you see.
+  
+         Check  out  the  installation  instructions  at
+         http://github.com/defunkt/hub#readme  under the
+         "Standalone" section.
+  
+         Cheers,
+         defunkt
+  
+  ------------------------------------------------------------
+  
+rdoc_options: 
+- --charset=UTF-8
+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.5
+signing_key: 
+specification_version: 3
+summary: hub introduces git to GitHub
+test_files: 
+- test/alias_test.rb
+- test/helper.rb
+- test/hub_test.rb
+- test/standalone_test.rb