hub 1.6.0

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,351 @@
+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
+
+    Expands to:
+    $ git clone git://github.com/rtomayko/tilt.git
+
+Wrapping `git`:
+
+    $ git clone rack/rack
+
+    Expands to:
+    $ git clone git://github.com/rack/rack.git
+
+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.io/hub/standalone -sLo ~/bin/hub &&
+    chmod 755 ~/bin/hub
+
+Assuming `~/bin/` is in your `$PATH`, you're ready to roll:
+
+    $ hub version
+    git version 1.7.0.4
+    hub version 1.1.0
+
+### Homebrew
+
+    $ brew install hub
+    $ which hub
+    /usr/local/bin/hub
+    $ hub version
+    ...
+
+### RubyGems
+
+Though not recommended, `hub` can also be installed as a RubyGem:
+
+    $ gem install hub
+
+(It's not recommended for casual use because of the RubyGems startup
+time. See [this gist][speed] for information.)
+
+### Standalone via RubyGems
+
+    $ gem install hub
+    $ hub hub standalone > ~/bin/hub && chmod 755 ~/bin/hub
+
+This installs a standalone version which doesn't require RubyGems to
+run.
+
+### Source
+
+You can also install from source:
+
+    $ git clone git://github.com/defunkt/hub.git
+    $ cd hub
+    $ rake install prefix=/usr/local
+
+### Help! It's Slow!
+
+Is your prompt slow? It may be hub.
+
+1. Check that it's **not** installed using RubyGems.
+2. Check that RUBYOPT isn't loading anything shady:
+
+       $ echo $RUBYOPT
+
+3. Check that your system Ruby is speedy:
+
+       $ time /usr/bin/env ruby -e0
+
+If #3 is slow, it may be your [GC settings][gc].
+
+
+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 rtomayko
+    > git remote add rtomayko git@github.com:rtomayko/CURRENT_REPO.git
+
+    $ git remote add origin
+    > git remote add origin git://github.com/YOUR_USER/CURRENT_REPO.git
+
+### git fetch
+
+    $ git fetch mislav
+    > git remote add mislav git://github.com/mislav/REPO.git
+    > git fetch mislav
+
+    $ git fetch mislav,xoebus
+    > git remote add mislav ...
+    > git remote add xoebus ...
+    > git fetch --multiple mislav xoebus
+
+### git cherry-pick
+
+    $ git cherry-pick http://github.com/mislav/REPO/commit/SHA
+    > git remote add -f mislav git://github.com/mislav/REPO.git
+    > git cherry-pick SHA
+
+    $ git cherry-pick mislav@SHA
+    > git remote add -f mislav git://github.com/mislav/CURRENT_REPO.git
+    > git cherry-pick SHA
+
+    $ git cherry-pick mislav@SHA
+    > git fetch mislav
+    > git cherry-pick SHA
+
+### git fork
+
+    $ git fork
+    ... hardcore forking action ...
+    > git remote add -f YOUR_USER git@github.com:YOUR_USER/CURRENT_REPO.git
+
+Forks the original repo on GitHub and adds the new remote under your
+username. It requires your GitHub token to be present; see "GitHub
+login" below for details.
+
+### git create
+
+    $ git create
+    ... hardcore creating action ...
+    > git remote add origin git@github.com:YOUR_USER/CURRENT_REPO.git
+
+Creates a new public github repository and adds the remote `origin` at
+"git@github.com:<USER>/<REPOSITORY>.git"
+
+### git init
+
+    $ git init -g
+    > git init
+    > git remote add origin git@github.com:YOUR_USER/REPO.git
+
+### git push
+
+    $ git push origin,staging,qa bert_timeout
+    > git push origin bert_timeout
+    > git push staging bert_timeout
+    > git push qa bert_timeout
+
+### git browse
+
+    $ git browse
+    > open https://github.com/YOUR_USER/CURRENT_REPO
+
+    $ git browse -- issues
+    > open https://github.com/YOUR_USER/CURRENT_REPO/issues
+
+    $ git browse schacon/ticgit
+    > open https://github.com/schacon/ticgit
+
+    $ git browse resque
+    > open https://github.com/YOUR_USER/resque
+
+    $ git browse resque network
+    > open https://github.com/YOUR_USER/resque/network
+
+### git compare
+
+    $ git compare refactor
+    > open https://github.com/CURRENT_REPO/compare/refactor
+
+    $ git compare 1.0...1.1
+    > open https://github.com/CURRENT_REPO/compare/1.0...1.1
+
+    $ git compare -u fix
+    > (https://github.com/CURRENT_REPO/compare/fix)
+
+    $ git compare other-user patch
+    > open https://github.com/other-user/REPO/compare/patch
+
+### git submodule
+
+    $ hub submodule add wycats/bundler vendor/bundler
+    > git submodule add git://github.com/wycats/bundler.git vendor/bundler
+
+    $ hub submodule add -p wycats/bundler vendor/bundler
+    > git submodule add git@github.com:wycats/bundler.git vendor/bundler
+
+    $ hub submodule add -b ryppl ryppl/pip vendor/pip
+    > git submodule add -b ryppl git://github.com/ryppl/pip.git vendor/pip
+
+
+### git help
+
+    $ git help
+    > (improved git help)
+    $ git help hub
+    > (hub man page)
+
+
+GitHub Login
+------------
+
+To get the most out of `hub`, you'll want to ensure your GitHub login
+is stored locally in your Git config or environment variables.
+
+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
+
+For commands that require write access to GitHub (such as `fork`), you'll want to
+setup "github.token" as well. See [local GitHub config guide][2] for more information.
+
+Want to use environment variables instead of a local gitconfig?
+
+* `GITHUB_USER`  - If set, this will be used instead of the `github.user` config
+                   value to determine your GitHub username.
+* `GITHUB_TOKEN` - If set, this will be used instead of the `github.token` config
+                   value to determine your GitHub API token.
+
+Configuration
+-------------
+
+If you prefer `http://` clones to `git://` clones, you can set the
+`hub.http-clone` option to true using `git-config`.
+
+For example:
+
+    $ git clone defunkt/repl
+    < git clone >
+    $ git config --global --bool hub.http-clone true
+    $ git clone defunkt/repl
+    < http clone >
+
+Or you can enter this manually into your `~/.gitconfig` file:
+
+    $ cat ~/.gitconfig
+    [hub]
+      http-clone = yes
+
+
+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!
+
+### Development Gems
+You will need the following gems (and their dependencies) to
+contribute to `hub`:
+
+* `rake` (`gem install rake`)
+* `kicker` (`gem install kicker`)
+* `turn` (`gem install turn`)
+* `mg` (`gem install mg`)
+* `ronn` (`gem install ronn`)
+* `webmock` (`gem install webmock`)
+
+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>
+* Test: <http://runcoderun.com/defunkt/hub>
+* Gems: <http://gemcutter.org/gems/hub>
+
+
+Authors
+-------
+
+<https://github.com/defunkt/hub/contributors>
+
+[0]: http://help.github.com/forking/
+[1]: http://github.com/defunkt/hub/issues
+[speed]: http://gist.github.com/284823
+[2]: http://github.com/guides/local-github-config
+[gc]: https://twitter.com/brynary/status/49560668994674688

data/Rakefile

@@ -0,0 +1,104 @@
+require 'rake/testtask'
+
+#
+# Helpers
+#
+
+def command?(command)
+  `which #{command} 2>/dev/null`
+  $?.success?
+end
+
+task :load_hub do
+  $LOAD_PATH.unshift 'lib'
+  require 'hub'
+end
+
+task :check_dirty do
+  if !`git status`.include?('nothing to commit')
+    abort "dirty index - not publishing!"
+  end
+end
+
+
+#
+# Tests
+#
+
+task :default => :test
+
+if command? :turn
+  desc "Run tests"
+  task :test do
+    suffix = "-n #{ENV['TEST']}" if ENV['TEST']
+    sh "turn test/*.rb #{suffix}"
+  end
+else
+  Rake::TestTask.new do |t|
+    t.libs << 'lib'
+    t.ruby_opts << '-rubygems'
+    t.pattern = 'test/**/*_test.rb'
+    t.verbose = false
+  end
+end
+
+if command? :kicker
+  desc "Launch Kicker (like autotest)"
+  task :kicker do
+    puts "Kicking... (ctrl+c to cancel)"
+    exec "kicker -e rake test lib"
+  end
+end
+
+
+#
+# Ron
+#
+
+if command? :ronn
+  desc "Show the manual"
+  task :man => "man:build" do
+    exec "man man/hub.1"
+  end
+
+  desc "Build the manual"
+  task "man:build" do
+    sh "ronn -br5 --organization=DEFUNKT --manual='Git Manual' man/*.ronn"
+  end
+end
+
+
+#
+# Gems
+#
+
+desc "Build standalone script"
+task :standalone => :load_hub do
+  require 'hub/standalone'
+  Hub::Standalone.save('hub')
+end
+
+desc "Install standalone script and man pages"
+task :install => :standalone do
+  prefix = ENV['PREFIX'] || ENV['prefix'] || '/usr/local'
+
+  FileUtils.mkdir_p "#{prefix}/bin"
+  FileUtils.cp "hub", "#{prefix}/bin", :preserve => true
+
+  FileUtils.mkdir_p "#{prefix}/share/man/man1"
+  FileUtils.cp "man/hub.1", "#{prefix}/share/man/man1"
+end
+
+desc "Publish to GitHub Pages"
+task :pages => [ "man:build", :check_dirty, :standalone ] do
+  cp "man/hub.1.html", "html"
+  sh "git checkout gh-pages"
+  sh "mv hub standalone"
+  sh "git add standalone*"
+  sh "mv html hub.1.html"
+  sh "git add hub.1.html"
+  sh "git commit -m 'update standalone'"
+  sh "git push origin gh-pages"
+  sh "git checkout master"
+  puts :done
+end