bin/hub

   1 #!/usr/bin/env ruby
   2 #
   3 # This file, hub, is generated code.
   4 # Please DO NOT EDIT or send patches for it.
   5 #
   6 # Please take a look at the source from
   7 # http://github.com/defunkt/hub
   8 # and submit patches against the individual files
   9 # that build hub.
  10 #
  11
  12 module Hub
  13   class Args < Array
  14     attr_accessor :executable
  15
  16     def initialize(*args)
  17       super
  18       @executable = ENV["GIT"] || "git"
  19       @after = nil
  20       @skip = false
  21       @original_args = args.first
  22       @chain = [nil]
  23     end
  24
  25     def after(cmd_or_args = nil, args = nil, &block)
  26       @chain.insert(-1, normalize_callback(cmd_or_args, args, block))
  27     end
  28
  29     def before(cmd_or_args = nil, args = nil, &block)
  30       @chain.insert(@chain.index(nil), normalize_callback(cmd_or_args, args, block))
  31     end
  32
  33     def chained?
  34       @chain.size > 1
  35     end
  36
  37     def commands
  38       chain = @chain.dup
  39       chain[chain.index(nil)] = self.to_exec
  40       chain
  41     end
  42
  43     def skip!
  44       @skip ||= true
  45     end
  46
  47     def skip?
  48       @skip
  49     end
  50
  51     def to_exec(args = self)
  52       Array(executable) + args
  53     end
  54
  55     def words
  56       reject { |arg| arg.index('-') == 0 }
  57     end
  58
  59     def flags
  60       self - words
  61     end
  62
  63     def changed?
  64       chained? or self != @original_args
  65     end
  66
  67     def has_flag?(*flags)
  68       pattern = flags.flatten.map { |f| Regexp.escape(f) }.join('|')
  69       !grep(/^#{pattern}(?:=|$)/).empty?
  70     end
  71
  72     private
  73
  74     def normalize_callback(cmd_or_args, args, block)
  75       if block
  76         block
  77       elsif args
  78         [cmd_or_args].concat args
  79       elsif Array === cmd_or_args
  80         self.to_exec cmd_or_args
  81       elsif cmd_or_args
  82         cmd_or_args
  83       else
  84         raise ArgumentError, "command or block required"
  85       end
  86     end
  87   end
  88 end
  89 module Hub
  90   module Context; end
  91
  92   module Commands
  93     instance_methods.each { |m| undef_method(m) unless m =~ /(^__|send|to\?$)/ }
  94     extend self
  95
  96     extend Context
  97
  98     API_REPO   = 'http://github.com/api/v2/yaml/repos/show/%s/%s'
  99     API_FORK   = 'http://github.com/api/v2/yaml/repos/fork/%s/%s'
 100     API_CREATE = 'http://github.com/api/v2/yaml/repos/create'
 101
 102     def run(args)
 103       slurp_global_flags(args)
 104
 105       args.unshift 'help' if args.empty?
 106
 107       cmd = args[0]
 108       expanded_args = expand_alias(cmd)
 109       cmd = expanded_args[0] if expanded_args
 110
 111       cmd = cmd.sub(/(\w)-/, '\1_')
 112       if method_defined?(cmd) and cmd != 'run'
 113         args[0, 1] = expanded_args if expanded_args
 114         send(cmd, args)
 115       end
 116     end
 117
 118     def clone(args)
 119       ssh = args.delete('-p')
 120       has_values = /^(--(upload-pack|template|depth|origin|branch|reference)|-[ubo])$/
 121
 122       idx = 1
 123       while idx < args.length
 124         arg = args[idx]
 125         if arg.index('-') == 0
 126           idx += 1 if arg =~ has_values
 127         elsif arg.index('://') or arg.index('@') or File.directory?(arg)
 128           break
 129         elsif arg.scan('/').size <= 1 && !arg.include?(':')
 130           args[args.index(arg)] = github_url(:repo => arg, :private => ssh)
 131           break
 132         end
 133         idx += 1
 134       end
 135     end
 136
 137     def submodule(args)
 138       return unless index = args.index('add')
 139       args.delete_at index
 140
 141       branch = args.index('-b') || args.index('--branch')
 142       if branch
 143         args.delete_at branch
 144         branch_name = args.delete_at branch
 145       end
 146
 147       clone(args)
 148
 149       if branch_name
 150         args.insert branch, '-b', branch_name
 151       end
 152       args.insert index, 'add'
 153     end
 154
 155     def remote(args)
 156       return unless ['add','set-url'].include?(args[1]) && args.last !~ %r{.+?://|.+?@|^[./]}
 157
 158       ssh = args.delete('-p')
 159
 160       args.last =~ /\b(.+?)(?:\/(.+))?$/
 161       user, repo = $1, $2
 162
 163       if args.words[2] == 'origin' && args.words[3].nil?
 164         user = repo = nil
 165       elsif args.words[-2] == args.words[1]
 166         idx = args.index( args.words[-1] )
 167         args[idx] = user
 168       else
 169         args.replace args[0...-1]
 170       end
 171
 172       args << github_url(:user => user, :repo => repo, :private => ssh)
 173     end
 174
 175     def fetch(args)
 176       if args.include?('--multiple')
 177         names = args.words[1..-1]
 178       elsif remote_name = args.words[1]
 179         if remote_name =~ /^\w+(,\w+)+$/
 180           index = args.index(remote_name)
 181           args.delete(remote_name)
 182           names = remote_name.split(',')
 183           args.insert(index, *names)
 184           args.insert(index, '--multiple')
 185         else
 186           names = [remote_name]
 187         end
 188       else
 189         names = []
 190       end
 191
 192       names.reject! { |name|
 193         name =~ /\W/ or remotes.include?(name) or
 194           remotes_group(name) or not repo_exists?(name)
 195       }
 196
 197       if names.any?
 198         names.each do |name|
 199           args.before ['remote', 'add', name, github_url(:user => name)]
 200         end
 201       end
 202     end
 203
 204     def cherry_pick(args)
 205       unless args.include?('-m') or args.include?('--mainline')
 206         case ref = args.words.last
 207         when %r{^(?:https?:)//github.com/(.+?)/(.+?)/commit/([a-f0-9]{7,40})}
 208           user, repo, sha = $1, $2, $3
 209           args[args.index(ref)] = sha
 210         when /^(\w+)@([a-f1-9]{7,40})$/
 211           user, repo, sha = $1, nil, $2
 212           args[args.index(ref)] = sha
 213         else
 214           user = nil
 215         end
 216
 217         if user
 218           if user == repo_owner
 219             args.before ['fetch', default_remote]
 220           elsif remotes.include?(user)
 221             args.before ['fetch', user]
 222           else
 223             remote_url = github_url(:user => user, :repo => repo, :private => false)
 224             args.before ['remote', 'add', '-f', user, remote_url]
 225           end
 226         end
 227       end
 228     end
 229
 230     def am(args)
 231       if url = args.find { |a| a =~ %r{^https?://(gist\.)?github\.com/} }
 232         idx = args.index(url)
 233         gist = $1 == 'gist.'
 234         url = url.sub(%r{(/pull/\d+)/\w*$}, '\1') unless gist
 235         ext = gist ? '.txt' : '.patch'
 236         url += ext unless File.extname(url) == ext
 237         patch_file = File.join(ENV['TMPDIR'], "#{gist ? 'gist-' : ''}#{File.basename(url)}")
 238         args.before 'curl', ['-#LA', "hub #{Hub::Version}", url, '-o', patch_file]
 239         args[idx] = patch_file
 240       end
 241     end
 242
 243     def init(args)
 244       if args.delete('-g')
 245         url = github_url(:private => true, :repo => current_dirname)
 246         args.after "git remote add origin #{url}"
 247       end
 248     end
 249
 250     def fork(args)
 251       if github_user && github_token && repo_owner
 252         if repo_exists?(github_user)
 253           puts "#{github_user}/#{repo_name} already exists on GitHub"
 254         else
 255           fork_repo
 256         end
 257
 258         if args.include?('--no-remote')
 259           exit
 260         else
 261           url = github_url(:private => true)
 262           args.replace %W"remote add -f #{github_user} #{url}"
 263           args.after { puts "new remote: #{github_user}" }
 264         end
 265       end
 266     rescue Net::HTTPExceptions
 267       response = $!.response
 268       warn "error creating fork: #{response.message} (HTTP #{response.code})"
 269       exit 1
 270     end
 271
 272     def create(args)
 273       if !is_repo?
 274         puts "'create' must be run from inside a git repository"
 275         args.skip!
 276       elsif github_user && github_token
 277         args.shift
 278         options = {}
 279         options[:private] = true if args.delete('-p')
 280
 281         until args.empty?
 282           case arg = args.shift
 283           when '-d'
 284             options[:description] = args.shift
 285           when '-h'
 286             options[:homepage] = args.shift
 287           else
 288             puts "unexpected argument: #{arg}"
 289             return
 290           end
 291         end
 292
 293         if repo_exists?(github_user)
 294           puts "#{github_user}/#{repo_name} already exists on GitHub"
 295           action = "set remote origin"
 296         else
 297           action = "created repository"
 298           create_repo(options)
 299         end
 300
 301         url = github_url(:private => true)
 302
 303         if remotes.first != 'origin'
 304           args.replace %W"remote add -f origin #{url}"
 305         else
 306           args.replace %W"remote -v"
 307         end
 308
 309         args.after { puts "#{action}: #{github_user}/#{repo_name}" }
 310       end
 311     rescue Net::HTTPExceptions
 312       response = $!.response
 313       warn "error creating repository: #{response.message} (HTTP #{response.code})"
 314       exit 1
 315     end
 316
 317     def push(args)
 318       return if args[1].nil? || !args[1].index(',')
 319
 320       branch  = (args[2] ||= normalize_branch(current_branch))
 321       remotes = args[1].split(',')
 322       args[1] = remotes.shift
 323
 324       remotes.each do |name|
 325         args.after ['push', name, branch]
 326       end
 327     end
 328
 329     def browse(args)
 330       args.shift
 331       browse_command(args) do
 332         user = repo = nil
 333         dest = args.shift
 334         dest = nil if dest == '--'
 335
 336         if dest
 337           repo = dest
 338         elsif repo_user
 339           user = repo_user
 340         else
 341           abort "Usage: hub browse [<USER>/]<REPOSITORY>"
 342         end
 343
 344         params = { :user => user, :repo => repo }
 345
 346         case subpage = args.shift
 347         when 'commits'
 348           branch = (!dest && tracked_branch) || 'master'
 349           params[:web] = "/commits/#{branch}"
 350         when 'tree', NilClass
 351           branch = !dest && tracked_branch
 352           params[:web] = "/tree/#{branch}" if branch && branch != 'master'
 353         else
 354           params[:web] = "/#{subpage}"
 355         end
 356
 357         params
 358       end
 359     end
 360
 361     def compare(args)
 362       args.shift
 363       browse_command(args) do
 364         if args.empty?
 365           branch = tracked_branch
 366           if branch && branch != 'master'
 367             range, user = branch, repo_user
 368           else
 369             abort "Usage: hub compare [USER] [<START>...]<END>"
 370           end
 371         else
 372           range = args.pop
 373           user = args.pop || repo_user
 374         end
 375         { :user => user, :web => "/compare/#{range}" }
 376       end
 377     end
 378
 379     def hub(args)
 380       return help(args) unless args[1] == 'standalone'
 381       require 'hub/standalone'
 382       puts Hub::Standalone.build
 383       exit
 384     rescue LoadError
 385       abort "hub is running in standalone mode."
 386     end
 387
 388     def alias(args)
 389       shells = {
 390         'sh'   => 'alias git=hub',
 391         'bash' => 'alias git=hub',
 392         'zsh'  => 'function git(){hub "$@"}',
 393         'csh'  => 'alias git hub',
 394         'fish' => 'alias git hub'
 395       }
 396
 397       silent = args.delete('-s')
 398
 399       if shell = args[1]
 400         if silent.nil?
 401           puts "Run this in your shell to start using `hub` as `git`:"
 402           print "  "
 403         end
 404       else
 405         puts "usage: hub alias [-s] SHELL", ""
 406         puts "You already have hub installed and available in your PATH,"
 407         puts "but to get the full experience you'll want to alias it to"
 408         puts "`git`.", ""
 409         puts "To see how to accomplish this for your shell, run the alias"
 410         puts "command again with the name of your shell.", ""
 411         puts "Known shells:"
 412         shells.map { |key, _| key }.sort.each do |key|
 413           puts "  " + key
 414         end
 415         puts "", "Options:"
 416         puts "  -s   Silent. Useful when using the output with eval, e.g."
 417         puts "       $ eval `hub alias -s bash`"
 418
 419         exit
 420       end
 421
 422       if shells[shell]
 423         puts shells[shell]
 424       else
 425         abort "fatal: never heard of `#{shell}'"
 426       end
 427
 428       exit
 429     end
 430
 431     def version(args)
 432       args.after do
 433         puts "hub version %s" % Version
 434       end
 435     end
 436     alias_method "--version", :version
 437
 438     def help(args)
 439       command = args.words[1]
 440
 441       if command == 'hub'
 442         puts hub_manpage
 443         exit
 444       elsif command.nil? && !args.has_flag?('-a', '--all')
 445         ENV['GIT_PAGER'] = '' unless args.has_flag?('-p', '--paginate') # Use `cat`.
 446         puts improved_help_text
 447         exit
 448       end
 449     end
 450     alias_method "--help", :help
 451
 452     def improved_help_text
 453       <<-help
 454 usage: git [--version] [--exec-path[=GIT_EXEC_PATH]] [--html-path]
 455     [-p|--paginate|--no-pager] [--bare] [--git-dir=GIT_DIR]
 456     [--work-tree=GIT_WORK_TREE] [--help] COMMAND [ARGS]
 457
 458 Basic Commands:
 459    init       Create an empty git repository or reinitialize an existing one
 460    add        Add new or modified files to the staging area
 461    rm         Remove files from the working directory and staging area
 462    mv         Move or rename a file, a directory, or a symlink
 463    status     Show the status of the working directory and staging area
 464    commit     Record changes to the repository
 465
 466 History Commands:
 467    log        Show the commit history log
 468    diff       Show changes between commits, commit and working tree, etc
 469    show       Show information about commits, tags or files
 470
 471 Branching Commands:
 472    branch     List, create, or delete branches
 473    checkout   Switch the active branch to another branch
 474    merge      Join two or more development histories (branches) together
 475    tag        Create, list, delete, sign or verify a tag object
 476
 477 Remote Commands:
 478    clone      Clone a remote repository into a new directory
 479    fetch      Download data, tags and branches from a remote repository
 480    pull       Fetch from and merge with another repository or a local branch
 481    push       Upload data, tags and branches to a remote repository
 482    remote     View and manage a set of remote repositories
 483
 484 Advanced commands:
 485    reset      Reset your staging area or working directory to another point
 486    rebase     Re-apply a series of patches in one branch onto another
 487    bisect     Find by binary search the change that introduced a bug
 488    grep       Print files with lines matching a pattern in your codebase
 489
 490 See 'git help COMMAND' for more information on a specific command.
 491 help
 492     end
 493
 494   private
 495
 496     def slurp_global_flags(args)
 497       flags = %w[ -c -p --paginate --no-pager --no-replace-objects --bare --version --help ]
 498       flags2 = %w[ --exec-path= --git-dir= --work-tree= ]
 499
 500       globals = []
 501       locals = []
 502
 503       while args[0] && (flags.include?(args[0]) || flags2.any? {|f| args[0].index(f) == 0 })
 504         flag = args.shift
 505         case flag
 506         when '--version', '--help'
 507           args.unshift flag.sub('--', '')
 508         when '-c'
 509           config_pair = args.shift
 510           key, value = config_pair.split('=', 2)
 511           Context::GIT_CONFIG["config #{key}"] = value.to_s
 512
 513           globals << flag << config_pair
 514         when '-p', '--paginate', '--no-pager'
 515           locals << flag
 516         else
 517           globals << flag
 518         end
 519       end
 520
 521       Context::GIT_CONFIG.executable = Array(Context::GIT_CONFIG.executable).concat(globals)
 522       args.executable = Array(args.executable).concat(globals).concat(locals)
 523     end
 524
 525     def browse_command(args)
 526       url_only = args.delete('-u')
 527       $stderr.puts "Warning: the `-p` flag has no effect anymore" if args.delete('-p')
 528       params = yield
 529
 530       args.executable = url_only ? 'echo' : browser_launcher
 531       args.push github_url({:web => true, :private => true}.update(params))
 532     end
 533
 534     def hub_manpage
 535       return "** Can't find groff(1)" unless command?('groff')
 536
 537       require 'open3'
 538       out = nil
 539       Open3.popen3(groff_command) do |stdin, stdout, _|
 540         stdin.puts hub_raw_manpage
 541         stdin.close
 542         out = stdout.read.strip
 543       end
 544       out
 545     end
 546
 547     def groff_command
 548       "groff -Wall -mtty-char -mandoc -Tascii"
 549     end
 550
 551     def hub_raw_manpage
 552       if File.exists? file = File.dirname(__FILE__) + '/../../man/hub.1'
 553         File.read(file)
 554       else
 555         DATA.read
 556       end
 557     end
 558
 559     def puts(*args)
 560       page_stdout
 561       super
 562     end
 563
 564     def page_stdout
 565       return unless $stdout.tty?
 566
 567       read, write = IO.pipe
 568
 569       if Kernel.fork
 570         $stdin.reopen(read)
 571         read.close
 572         write.close
 573
 574         ENV['LESS'] = 'FSRX'
 575
 576         Kernel.select [STDIN]
 577
 578         pager = ENV['GIT_PAGER'] ||
 579           `git config --get-all core.pager`.split.first || ENV['PAGER'] ||
 580           'less -isr'
 581
 582         pager = 'cat' if pager.empty?
 583
 584         exec pager rescue exec "/bin/sh", "-c", pager
 585       else
 586         $stdout.reopen(write)
 587         $stderr.reopen(write) if $stderr.tty?
 588         read.close
 589         write.close
 590       end
 591     end
 592
 593     def repo_exists?(user)
 594       require 'net/http'
 595       url = API_REPO % [user, repo_name]
 596       Net::HTTPSuccess === Net::HTTP.get_response(URI(url))
 597     end
 598
 599     def fork_repo
 600       url = API_FORK % [repo_owner, repo_name]
 601       response = Net::HTTP.post_form(URI(url), 'login' => github_user, 'token' => github_token)
 602       response.error! unless Net::HTTPSuccess === response
 603     end
 604
 605     def create_repo(options = {})
 606       url = API_CREATE
 607       params = {'login' => github_user, 'token' => github_token, 'name' => repo_name}
 608       params['public'] = '0' if options[:private]
 609       params['description'] = options[:description] if options[:description]
 610       params['homepage'] = options[:homepage] if options[:homepage]
 611
 612       response = Net::HTTP.post_form(URI(url), params)
 613       response.error! unless Net::HTTPSuccess === response
 614     end
 615
 616     def expand_alias(cmd)
 617       if expanded = git_alias_for(cmd)
 618         if expanded.index('!') != 0
 619           require 'shellwords' unless defined?(::Shellwords)
 620           Shellwords.shellwords(expanded)
 621         end
 622       end
 623     end
 624
 625   end
 626 end
 627 require 'shellwords'
 628
 629 module Hub
 630   module Context
 631     private
 632
 633     class ShellOutCache < Hash
 634       attr_accessor :executable
 635
 636       def initialize(executable = nil, &block)
 637         super(&block)
 638         @executable = executable
 639       end
 640
 641       def to_exec(args)
 642         args = Shellwords.shellwords(args) if args.respond_to? :to_str
 643         Array(executable) + Array(args)
 644       end
 645     end
 646
 647     GIT_CONFIG = ShellOutCache.new(ENV['GIT'] || 'git') do |cache, cmd|
 648       full_cmd = cache.to_exec(cmd)
 649       cmd_string = full_cmd.respond_to?(:shelljoin) ? full_cmd.shelljoin : full_cmd.join(' ')
 650       result = %x{#{cmd_string}}.chomp
 651       cache[cmd] = $?.success? && !result.empty? ? result : nil
 652     end
 653
 654     REMOTES = Hash.new do |cache, remote|
 655       if remote
 656         urls = GIT_CONFIG["config --get-all remote.#{remote}.url"].to_s.split("\n")
 657
 658         if urls.find { |u| u =~ %r{\bgithub\.com[:/](.+)/(.+).git$} }
 659           cache[remote] = { :user => $1, :repo => $2 }
 660         else
 661           cache[remote] = { }
 662         end
 663       else
 664         cache[remote] = { }
 665       end
 666     end
 667
 668     LGHCONF = "http://help.github.com/git-email-settings/"
 669
 670     def repo_owner
 671       REMOTES[default_remote][:user]
 672     end
 673
 674     def repo_user
 675       REMOTES[current_remote][:user]
 676     end
 677
 678     def repo_name
 679       REMOTES[default_remote][:repo] || current_dirname
 680     end
 681
 682     def github_user(fatal = true)
 683       if user = ENV['GITHUB_USER'] || GIT_CONFIG['config github.user']
 684         user
 685       elsif fatal
 686         abort("** No GitHub user set. See #{LGHCONF}")
 687       end
 688     end
 689
 690     def github_token(fatal = true)
 691       if token = ENV['GITHUB_TOKEN'] || GIT_CONFIG['config github.token']
 692         token
 693       elsif fatal
 694         abort("** No GitHub token set. See #{LGHCONF}")
 695       end
 696     end
 697
 698     def current_branch
 699       GIT_CONFIG['symbolic-ref -q HEAD']
 700     end
 701
 702     def tracked_branch
 703       branch = current_branch && tracked_for(current_branch)
 704       normalize_branch(branch) if branch
 705     end
 706
 707     def remotes
 708       list = GIT_CONFIG['remote'].to_s.split("\n")
 709       main = list.delete('origin') and list.unshift(main)
 710       list
 711     end
 712
 713     def remotes_group(name)
 714       GIT_CONFIG["config remotes.#{name}"]
 715     end
 716
 717     def current_remote
 718       return if remotes.empty?
 719       (current_branch && remote_for(current_branch)) || default_remote
 720     end
 721
 722     def default_remote
 723       remotes.first
 724     end
 725
 726     def normalize_branch(branch)
 727       branch.sub('refs/heads/', '')
 728     end
 729
 730     def remote_for(branch)
 731       GIT_CONFIG['config branch.%s.remote' % normalize_branch(branch)]
 732     end
 733
 734     def tracked_for(branch)
 735       GIT_CONFIG['config branch.%s.merge' % normalize_branch(branch)]
 736     end
 737
 738     def http_clone?
 739       GIT_CONFIG['config --bool hub.http-clone'] == 'true'
 740     end
 741
 742     def git_alias_for(name)
 743       GIT_CONFIG["config alias.#{name}"]
 744     end
 745
 746     def is_repo?
 747       GIT_CONFIG['config core.repositoryformatversion']
 748     end
 749
 750     def github_url(options = {})
 751       repo = options[:repo]
 752       user, repo = repo.split('/') if repo && repo.index('/')
 753       user ||= options[:user] || github_user
 754       repo ||= repo_name
 755       secure = options[:private]
 756
 757       if options[:web]
 758         scheme = secure ? 'https:' : 'http:'
 759         path = options[:web] == true ? '' : options[:web].to_s
 760         if repo =~ /\.wiki$/
 761           repo = repo.sub(/\.wiki$/, '')
 762           unless '/wiki' == path
 763             path = '/wiki%s' % if path =~ %r{^/commits/} then '/_history'
 764               else path.sub(/\w+/, '_\0')
 765               end
 766           end
 767         end
 768         '%s//github.com/%s/%s%s' % [scheme, user, repo, path]
 769       else
 770         if secure
 771           url = 'git@github.com:%s/%s.git'
 772         elsif http_clone?
 773           url = 'http://github.com/%s/%s.git'
 774         else
 775           url = 'git://github.com/%s/%s.git'
 776         end
 777
 778         url % [user, repo]
 779       end
 780     end
 781
 782     DIRNAME = File.basename(Dir.pwd)
 783
 784     def current_dirname
 785       DIRNAME
 786     end
 787
 788     def browser_launcher
 789       require 'rbconfig'
 790       browser = ENV['BROWSER'] ||
 791         (RbConfig::CONFIG['host_os'].include?('darwin') && 'open') ||
 792         (RbConfig::CONFIG['host_os'] =~ /msdos|mswin|djgpp|mingw|windows/ && 'start') ||
 793         %w[xdg-open cygstart x-www-browser firefox opera mozilla netscape].find { |comm| which comm }
 794
 795       abort "Please set $BROWSER to a web launcher to use this command." unless browser
 796       Array(browser)
 797     end
 798
 799     def which(cmd)
 800       exts = ENV['PATHEXT'] ? ENV['PATHEXT'].split(';') : ['']
 801       ENV['PATH'].split(File::PATH_SEPARATOR).each do |path|
 802         exts.each { |ext|
 803           exe = "#{path}/#{cmd}#{ext}"
 804           return exe if File.executable? exe
 805         }
 806       end
 807       return nil
 808     end
 809
 810     def command?(name)
 811       !which(name).nil?
 812     end
 813   end
 814 end
 815 module Hub
 816   class Runner
 817     attr_reader :args
 818
 819     def initialize(*args)
 820       @args = Args.new(args)
 821       Commands.run(@args)
 822     end
 823
 824     def self.execute(*args)
 825       new(*args).execute
 826     end
 827
 828     def command
 829       if args.skip?
 830         ''
 831       else
 832         commands.join('; ')
 833       end
 834     end
 835
 836     def commands
 837       args.commands.map do |cmd|
 838         if cmd.respond_to?(:join)
 839           cmd.map { |c| (c.index(' ') || c.empty?) ? "'#{c}'" : c }.join(' ')
 840         else
 841           cmd.to_s
 842         end
 843       end
 844     end
 845
 846     def execute
 847       unless args.skip?
 848         if args.chained?
 849           execute_command_chain
 850         else
 851           exec(*args.to_exec)
 852         end
 853       end
 854     end
 855
 856     def execute_command_chain
 857       commands = args.commands
 858       commands.each_with_index do |cmd, i|
 859         if cmd.respond_to?(:call) then cmd.call
 860         elsif i == commands.length - 1
 861           exec(*cmd)
 862         else
 863           exit($?.exitstatus) unless system(*cmd)
 864         end
 865       end
 866     end
 867   end
 868 end
 869 module Hub
 870   Version = VERSION = '1.6.1'
 871 end
 872 Hub::Runner.execute(*ARGV)
 873 __END__
 874 .\" generated with Ronn/v0.7.3
 875 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 876 .
 877 .TH "HUB" "1" "May 2011" "DEFUNKT" "Git Manual"
 878 .
 879 .SH "NAME"
 880 \fBhub\fR \- git + hub = github
 881 .
 882 .SH "SYNOPSIS"
 883 \fBhub\fR \fICOMMAND\fR \fIOPTIONS\fR
 884 .
 885 .br
 886 \fBhub alias\fR [\fB\-s\fR] \fISHELL\fR
 887 .
 888 .P
 889 \fBgit init \-g\fR \fIOPTIONS\fR
 890 .
 891 .br
 892 \fBgit create\fR [\fB\-p\fR] [\fB\-d <DESCRIPTION>\fR] [\fB\-h <HOMEPAGE>\fR]
 893 .
 894 .br
 895 \fBgit clone\fR [\fB\-p\fR] \fIOPTIONS\fR [\fIUSER\fR/]\fIREPOSITORY\fR \fIDIRECTORY\fR
 896 .
 897 .br
 898 \fBgit remote add\fR [\fB\-p\fR] \fIOPTIONS\fR \fIUSER\fR[/\fIREPOSITORY\fR]
 899 .
 900 .br
 901 \fBgit remote set\-url\fR [\fB\-p\fR] \fIOPTIONS\fR \fIREMOTE\-NAME\fR \fIUSER\fR[/\fIREPOSITORY\fR]
 902 .
 903 .br
 904 \fBgit fetch\fR \fIUSER\-1\fR,[\fIUSER\-2\fR,\.\.\.]
 905 .
 906 .br
 907 \fBgit cherry\-pick\fR \fIGITHUB\-REF\fR
 908 .
 909 .br
 910 \fBgit am\fR \fIGITHUB\-URL\fR
 911 .
 912 .br
 913 \fBgit push\fR \fIREMOTE\-1\fR,\fIREMOTE\-2\fR,\.\.\.,\fIREMOTE\-N\fR [\fIREF\fR]
 914 .
 915 .br
 916 \fBgit browse\fR [\fB\-u\fR] [[\fIUSER\fR\fB/\fR]\fIREPOSITORY\fR] [SUBPAGE]
 917 .
 918 .br
 919 \fBgit compare\fR [\fB\-u\fR] [\fIUSER\fR] [\fISTART\fR\.\.\.]\fIEND\fR
 920 .
 921 .br
 922 \fBgit submodule add\fR [\fB\-p\fR] \fIOPTIONS\fR [\fIUSER\fR/]\fIREPOSITORY\fR \fIDIRECTORY\fR
 923 .
 924 .br
 925 \fBgit fork\fR [\fB\-\-no\-remote\fR]
 926 .
 927 .SH "DESCRIPTION"
 928 \fBhub\fR enhances various \fBgit\fR commands with GitHub remote expansion\. The alias command displays information on configuring your environment:
 929 .
 930 .IP "\(bu" 4
 931 \fBhub alias\fR [\fB\-s\fR] \fISHELL\fR: Writes shell aliasing code for \fISHELL\fR (\fBbash\fR, \fBsh\fR, \fBzsh\fR, \fBcsh\fR) to standard output\. With the \fB\-s\fR option, the output of this command can be evaluated directly within the shell:
 932 .
 933 .br
 934 \fBeval $(hub alias \-s bash)\fR
 935 .
 936 .IP "\(bu" 4
 937 \fBgit init\fR \fB\-g\fR \fIOPTIONS\fR: Create a git repository as with git\-init(1) and add remote \fBorigin\fR at "git@github\.com:\fIUSER\fR/\fIREPOSITORY\fR\.git"; \fIUSER\fR is your GitHub username and \fIREPOSITORY\fR is the current working directory\'s basename\.
 938 .
 939 .IP "\(bu" 4
 940 \fBgit create\fR [\fB\-p\fR] [\fB\-d <DESCRIPTION>\fR] [\fB\-h <HOMEPAGE>\fR]:
 941 .
 942 .br
 943 Create a new public github repository from the current git repository and add remote \fBorigin\fR at "git@github\.com:\fIUSER\fR/\fIREPOSITORY\fR\.git"; \fIUSER\fR is your GitHub username and \fIREPOSITORY\fR is the current working directory\'s basename\. With \fB\-p\fR, create a private repository\. \fB\-d\fR and \fB\-h\fR set the repository\'s description and homepage, respectively\.
 944 .
 945 .IP "\(bu" 4
 946 \fBgit clone\fR [\fB\-p\fR] \fIOPTIONS\fR [\fIUSER\fR\fB/\fR]\fIREPOSITORY\fR \fIDIRECTORY\fR:
 947 .
 948 .br
 949 Clone repository "git://github\.com/\fIUSER\fR/\fIREPOSITORY\fR\.git" into \fIDIRECTORY\fR as with git\-clone(1)\. When \fIUSER\fR/ is omitted, assumes your GitHub login\. With \fB\-p\fR, use private remote "git@github\.com:\fIUSER\fR/\fIREPOSITORY\fR\.git"\.
 950 .
 951 .IP "\(bu" 4
 952 \fBgit remote add\fR [\fB\-p\fR] \fIOPTIONS\fR \fIUSER\fR[\fB/\fR\fIREPOSITORY\fR]:
 953 .
 954 .br
 955 Add remote "git://github\.com/\fIUSER\fR/\fIREPOSITORY\fR\.git" as with git\-remote(1)\. When /\fIREPOSITORY\fR is omitted, the basename of the current working directory is used\. With \fB\-p\fR, use private remote "git@github\.com:\fIUSER\fR/\fIREPOSITORY\fR\.git"\. If \fIUSER\fR is "origin" then uses your GitHub login\.
 956 .
 957 .IP "\(bu" 4
 958 \fBgit remote set\-url\fR [\fB\-p\fR] \fIOPTIONS\fR \fIREMOTE\-NAME\fR \fIUSER\fR[/\fIREPOSITORY\fR]
 959 .
 960 .br
 961 Sets the url of remote \fIREMOTE\-NAME\fR using the same rules as \fBgit remote add\fR\.
 962 .
 963 .IP "\(bu" 4
 964 \fBgit fetch\fR \fIUSER\-1\fR,[\fIUSER\-2\fR,\.\.\.]: Adds missing remote(s) with \fBgit remote add\fR prior to fetching\. New remotes are only added if they correspond to valid forks on GitHub\.
 965 .
 966 .IP "\(bu" 4
 967 \fBgit cherry\-pick\fR \fIGITHUB\-REF\fR: Cherry\-pick a commit from a fork using either full URL to the commit or GitHub\-flavored Markdown notation, which is \fBuser@sha\fR\. If the remote doesn\'t yet exist, it will be added\. A \fBgit fetch <user>\fR is issued prior to the cherry\-pick attempt\.
 968 .
 969 .IP "\(bu" 4
 970 \fBgit am\fR \fIGITHUB\-URL\fR: Downloads the patch file for the pull request or commit at the URL and applies that patch from disk with \fBgit am\fR\. Similar to \fBcherry\-pick\fR, but doesn\'t add new remotes\.
 971 .
 972 .IP "\(bu" 4
 973 \fBgit push\fR \fIREMOTE\-1\fR,\fIREMOTE\-2\fR,\.\.\.,\fIREMOTE\-N\fR [\fIREF\fR]: Push \fIREF\fR to each of \fIREMOTE\-1\fR through \fIREMOTE\-N\fR by executing multiple \fBgit push\fR commands\.
 974 .
 975 .IP "\(bu" 4
 976 \fBgit browse\fR [\fB\-u\fR] [[\fIUSER\fR\fB/\fR]\fIREPOSITORY\fR] [SUBPAGE]: Open repository\'s GitHub page in the system\'s default web browser using \fBopen(1)\fR or the \fBBROWSER\fR env variable\. If the repository isn\'t specified, \fBbrowse\fR opens the page of the repository found in the current directory\. If SUBPAGE is specified, the browser will open on the specified subpage: one of "wiki", "commits", "issues" or other (the default is "tree")\.
 977 .
 978 .IP "\(bu" 4
 979 \fBgit compare\fR [\fB\-u\fR] [\fIUSER\fR] [\fISTART\fR\.\.\.]\fIEND\fR: Open a GitHub compare view page in the system\'s default web browser\. \fISTART\fR to \fIEND\fR are branch names, tag names, or commit SHA1s specifying the range of history to compare\. If \fISTART\fR is omitted, GitHub will compare against the base branch (the default is "master")\.
 980 .
 981 .IP "\(bu" 4
 982 \fBgit submodule add\fR [\fB\-p\fR] \fIOPTIONS\fR [\fIUSER\fR/]\fIREPOSITORY\fR \fIDIRECTORY\fR:
 983 .
 984 .br
 985 Submodule repository "git://github\.com/\fIUSER\fR/\fIREPOSITORY\fR\.git" into \fIDIRECTORY\fR as with git\-submodule(1)\. When \fIUSER\fR/ is omitted, assumes your GitHub login\. With \fB\-p\fR, use private remote "git@github\.com:\fIUSER\fR/\fIREPOSITORY\fR\.git"\.
 986 .
 987 .IP "\(bu" 4
 988 \fBgit fork\fR [\fB\-\-no\-remote\fR]: Forks the original project (referenced by "origin" remote) on GitHub and adds a new remote for it under your username\. Requires \fBgithub\.token\fR to be set (see CONFIGURATION)\.
 989 .
 990 .IP "\(bu" 4
 991 \fBgit help\fR: Display enhanced git\-help(1)\.
 992 .
 993 .IP "" 0
 994 .
 995 .SH "CONFIGURATION"
 996 Use git\-config(1) to display the currently configured GitHub username:
 997 .
 998 .IP "" 4
 999 .
1000 .nf
1001
1002 $ git config \-\-global github\.user
1003 .
1004 .fi
1005 .
1006 .IP "" 0
1007 .
1008 .P
1009 Or, set the GitHub username and token with:
1010 .
1011 .IP "" 4
1012 .
1013 .nf
1014
1015 $ git config \-\-global github\.user <username>
1016 $ git config \-\-global github\.token <token>
1017 .
1018 .fi
1019 .
1020 .IP "" 0
1021 .
1022 .P
1023 See \fIhttp://github\.com/guides/local\-github\-config\fR for more information\.
1024 .
1025 .P
1026 You can also tell \fBhub\fR to use \fBhttp://\fR rather than \fBgit://\fR when cloning:
1027 .
1028 .IP "" 4
1029 .
1030 .nf
1031
1032 $ git config \-\-global \-\-bool hub\.http\-clone true
1033 .
1034 .fi
1035 .
1036 .IP "" 0
1037 .
1038 .P
1039 Want to use environment variables instead of a local gitconfig for authentication?
1040 .
1041 .IP "\(bu" 4
1042 \fBGITHUB_USER\fR \- If set, this will be used instead of the \fBgithub\.user\fR config
1043 .
1044 .IP "\(bu" 4
1045 \fBGITHUB_TOKEN\fR \- If set, this will be used instead of the \fBgithub\.token\fR
1046 .
1047 .IP "" 0
1048 .
1049 .SH "EXAMPLES"
1050 .
1051 .SS "git clone"
1052 .
1053 .nf
1054
1055 $ git clone schacon/ticgit
1056 > git clone git://github\.com/schacon/ticgit\.git
1057
1058 $ git clone \-p schacon/ticgit
1059 > git clone git@github\.com:schacon/ticgit\.git
1060
1061 $ git clone resque
1062 > git clone git://github\.com/YOUR_USER/resque\.git
1063
1064 $ git clone \-p resque
1065 > git clone git@github\.com:YOUR_USER/resque\.git
1066 .
1067 .fi
1068 .
1069 .SS "git remote add"
1070 .
1071 .nf
1072
1073 $ git remote add rtomayko
1074 > git remote add rtomayko git://github\.com/rtomayko/CURRENT_REPO\.git
1075
1076 $ git remote add \-p rtomayko
1077 > git remote add rtomayko git@github\.com:rtomayko/CURRENT_REPO\.git
1078
1079 $ git remote add origin
1080 > git remote add origin git://github\.com/YOUR_USER/CURRENT_REPO\.git
1081 .
1082 .fi
1083 .
1084 .SS "git fetch"
1085 .
1086 .nf
1087
1088 $ git fetch mislav
1089 > git remote add mislav git://github\.com/mislav/REPO\.git
1090 > git fetch mislav
1091
1092 $ git fetch mislav,xoebus
1093 > git remote add mislav \.\.\.
1094 > git remote add xoebus \.\.\.
1095 > git fetch \-\-multiple mislav xoebus
1096 .
1097 .fi
1098 .
1099 .SS "git cherry\-pick"
1100 .
1101 .nf
1102
1103 $ git cherry\-pick http://github\.com/mislav/REPO/commit/SHA
1104 > git remote add \-f mislav git://github\.com/mislav/REPO\.git
1105 > git cherry\-pick SHA
1106
1107 $ git cherry\-pick mislav@SHA
1108 > git remote add \-f mislav git://github\.com/mislav/CURRENT_REPO\.git
1109 > git cherry\-pick SHA
1110
1111 $ git cherry\-pick mislav@SHA
1112 > git fetch mislav
1113 > git cherry\-pick SHA
1114 .
1115 .fi
1116 .
1117 .SS "git am"
1118 .
1119 .nf
1120
1121 $ git am https://github\.com/defunkt/hub/pull/55
1122 > curl https://github\.com/defunkt/hub/pull/55\.patch \-o /tmp/55\.patch
1123 > git am /tmp/55\.patch
1124
1125 $ git am \-\-ignore\-whitespace https://github\.com/davidbalbert/hub/commit/fdb9921
1126 > curl https://github\.com/davidbalbert/hub/commit/fdb9921\.patch \-o /tmp/fdb9921\.patch
1127 > git am \-\-ignore\-whitespace /tmp/fdb9921\.patch
1128 .
1129 .fi
1130 .
1131 .SS "git fork"
1132 .
1133 .nf
1134
1135 $ git fork
1136 \.\.\. hardcore forking action \.\.\.
1137 > git remote add YOUR_USER git@github\.com:YOUR_USER/CURRENT_REPO\.git
1138 .
1139 .fi
1140 .
1141 .SS "git init"
1142 .
1143 .nf
1144
1145 $ git init \-g
1146 > git init
1147 > git remote add origin git@github\.com:YOUR_USER/REPO\.git
1148 .
1149 .fi
1150 .
1151 .SS "git create"
1152 .
1153 .nf
1154
1155 $ git create
1156 \.\.\. hardcore creating action \.\.\.
1157 > git remote add origin git@github\.com:YOUR_USER/CURRENT_REPO\.git
1158 .
1159 .fi
1160 .
1161 .SS "git push"
1162 .
1163 .nf
1164
1165 $ git push origin,staging,qa bert_timeout
1166 > git push origin bert_timeout
1167 > git push staging bert_timeout
1168 > git push qa bert_timeout
1169 .
1170 .fi
1171 .
1172 .SS "git browse"
1173 .
1174 .nf
1175
1176 $ git browse
1177 > open https://github\.com/YOUR_USER/CURRENT_REPO
1178
1179 $ git browse \-\- issues
1180 > open https://github\.com/YOUR_USER/CURRENT_REPO/issues
1181
1182 $ git browse schacon/ticgit
1183 > open https://github\.com/schacon/ticgit
1184
1185 $ git browse resque
1186 > open https://github\.com/YOUR_USER/resque
1187
1188 $ git browse resque network
1189 > open https://github\.com/YOUR_USER/resque/network
1190 .
1191 .fi
1192 .
1193 .SS "git compare"
1194 .
1195 .nf
1196
1197 $ git compare refactor
1198 > open https://github\.com/CURRENT_REPO/compare/refactor
1199
1200 $ git compare 1\.0\.\.\.1\.1
1201 > open https://github\.com/CURRENT_REPO/compare/1\.0\.\.\.1\.1
1202
1203 $ git compare \-u fix
1204 > (https://github\.com/CURRENT_REPO/compare/fix)
1205
1206 $ git compare other\-user patch
1207 > open https://github\.com/other\-user/REPO/compare/patch
1208 .
1209 .fi
1210 .
1211 .SS "git help"
1212 .
1213 .nf
1214
1215 $ git help
1216 > (improved git help)
1217 $ git help hub
1218 > (hub man page)
1219 .
1220 .fi
1221 .
1222 .SH "BUGS"
1223 \fIhttp://github\.com/defunkt/hub/issues\fR
1224 .
1225 .SH "AUTHORS"
1226 \fIhttps://github\.com/defunkt/hub/contributors\fR
1227 .
1228 .SH "SEE ALSO"
1229 git(1), git\-clone(1), git\-remote(1), git\-init(1), \fIhttp://github\.com\fR, \fIhttp://github\.com/defunkt/hub\fR