Module: Hub::Commands

Extended by:
Commands, Context
Included in:
Commands
Defined in:
lib/hub/commands.rb

Overview

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 Runner class is initialized: >> Hub::Runner.new(‘clone’, ‘rtomayko/tilt’)

  3. The method representing the git subcommand is executed with the full args: >> Hub::Commands.clone([‘clone’, ‘rtomayko/tilt’])

  4. That method rewrites the args as it sees fit: >> args = “git://github.com/” + args + “.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.

Constant Summary collapse

NAME_RE = 
/[\w.][\w.-]*/
OWNER_RE = 
/[a-zA-Z0-9][a-zA-Z0-9-]*/
NAME_WITH_OWNER_RE = 
/^(?:#{NAME_RE}|#{OWNER_RE}\/#{NAME_RE})$/
CUSTOM_COMMANDS = 
%w[alias create browse compare fork pull-request ci-status]

Constants included from Context

Hub::Context::NULL

Instance Method Summary collapse

Methods included from Hub::Context::System

#browser_launcher, #command?, #osx?, #terminal_width, #unix?, #which, #windows?

Methods included from Hub::Context::GitReaderMethods

extended

Instance Method Details

#alias(args) ⇒ Object 



774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
 
# File 'lib/hub/commands.rb', line 774

def alias(args)
  shells = %w[bash zsh sh ksh csh fish]

  script = !!args.delete('-s')
  shell = args[1] || ENV['SHELL']
  abort "hub alias: unknown shell" if shell.nil? or shell.empty?
  shell = File.basename shell

  unless shells.include? shell
    $stderr.puts "hub alias: unsupported shell"
    warn "supported shells: #{shells.join(' ')}"
    abort
  end

  if script
    puts "alias git=hub"
  else
    profile = case shell
      when 'bash' then '~/.bash_profile'
      when 'zsh'  then '~/.zshrc'
      when 'ksh'  then '~/.profile'
      when 'fish' then '~/.config/fish/config.fish'
      else
        'your profile'
      end

    puts "# Wrap git automatically by adding the following to #{profile}:"
    puts
    if shell == 'fish'
      puts 'eval (hub alias -s)'
    else
      puts 'eval "$(hub alias -s)"'
    end
  end

  exit
end

#am(args) ⇒ Object Also known as: apply

$ hub am github.com/defunkt/hub/pull/55 … downloads patch via API … > git am /tmp/55.patch



508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
 
# File 'lib/hub/commands.rb', line 508

def am(args)
  gh_url = nil
  idx = args.index { |arg|
    gh_url = if arg =~ %r{^https?://gist\.github\.com/} then URI(arg)
    else resolve_github_url(arg)
    end
  }

  if gh_url
    if "gist.github.com" == gh_url.host
      gist_id = gh_url.path.split('/').last
      patch_name = "gist-#{gist_id}.txt"
      patch = api_client.gist_raw(gist_id)
    else
      case gh_url.project_path
      when /^pull\/(\d+)/
        pull_id = $1.to_i
        patch_name = "#{pull_id}.patch"
        patch = api_client.pullrequest_patch(gh_url.project, pull_id)
      when /^commit\/([a-f0-9]{7,40})/
        commit_sha = $1
        patch_name = "#{commit_sha}.patch"
        patch = api_client.commit_patch(gh_url.project, commit_sha)
      else
        raise ArgumentError, url
      end
    end

    patch_file = Tempfile.new(patch_name).path
    File.open(patch_file, 'w') { |file| file.write(patch) }
    args[idx] = patch_file
  end
end

#browse(args) ⇒ Object

$ hub browse > open github.com/CURRENT_REPO

$ hub browse – issues > open github.com/CURRENT_REPO/issues

$ hub browse pjhyett/github-services > open github.com/pjhyett/github-services

$ hub browse github-services > open github.com/YOUR_LOGIN/github-services

$ hub browse github-services wiki > open github.com/YOUR_LOGIN/github-services/wiki



685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
 
# File 'lib/hub/commands.rb', line 685

def browse(args)
  args.shift
  browse_command(args) do
    dest = args.shift
    dest = nil if dest == '--'
    # $ hub browse -- wiki
    subpage = args.shift

    if dest
      # $ hub browse pjhyett/github-services
      # $ hub browse github-services
      project = github_project dest
      branch = master_branch
    elsif subpage && !%w[commits tree blob settings].include?(subpage)
      branch = master_branch
      project = local_repo.main_project
    elsif local_repo(false)
      # $ hub browse
      prefer_upstream = current_branch && current_branch.master?
      branch, project = remote_branch_and_project(method(:github_user), prefer_upstream)
      branch ||= master_branch
    end

    abort "Usage: hub browse [<USER>/]<REPOSITORY>" unless project

    path = case subpage
    when 'commits'
      "/commits/#{branch_in_url(branch.short_name)}"
    when 'tree', NilClass
      "/tree/#{branch_in_url(branch.short_name)}" if branch and !branch.master?
    else
      "/#{subpage}"
    end

    project.web_url(path, api_client.config.method(:protocol))
  end
end

#checkout(args) ⇒ Object

$ git checkout github.com/defunkt/hub/pull/73 > git remote add -f -t feature git://github:com/mislav/hub.git > git checkout –track -B mislav-feature mislav/feature



419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
 
# File 'lib/hub/commands.rb', line 419

def checkout(args)
  _, url_arg, new_branch_name = args.words
  if url = resolve_github_url(url_arg) and url.project_path =~ /^pull\/(\d+)/
    pull_id = $1
    pull_data = api_client.pullrequest_info(url.project, pull_id)

    args.delete new_branch_name
    user, branch = pull_data['head']['label'].split(':', 2)
    abort "Error: #{user}'s fork is not available anymore" unless pull_data['head']['repo']
    new_branch_name ||= "#{user}-#{branch}"

    if remotes.include? user
      args.before ['remote', 'set-branches', '--add', user, branch]
      args.before ['fetch', user, "+refs/heads/#{branch}:refs/remotes/#{user}/#{branch}"]
    else
      url = github_project(url.project_name, user).git_url(:private => pull_data['head']['repo']['private'],
                                                           :https => https_protocol?)
      args.before ['remote', 'add', '-f', '-t', branch, user, url]
    end
    idx = args.index url_arg
    args.delete_at idx
    args.insert idx, '--track', '-B', new_branch_name, "#{user}/#{branch}"
  end
end

#cherry_pick(args) ⇒ Object

$ git cherry-pick github.com/mislav/hub/commit/a319d88#comments > git remote add -f mislav git://github.com/mislav/hub.git > git cherry-pick a319d88

$ git cherry-pick mislav@a319d88 > git remote add -f mislav git://github.com/mislav/hub.git > git cherry-pick a319d88

$ git cherry-pick mislav@SHA > git fetch mislav > git cherry-pick SHA



482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
 
# File 'lib/hub/commands.rb', line 482

def cherry_pick(args)
  unless args.include?('-m') or args.include?('--mainline')
    ref = args.words.last
    if url = resolve_github_url(ref) and url.project_path =~ /^commit\/([a-f0-9]{7,40})/
      sha = $1
      project = url.project
    elsif ref =~ /^(#{OWNER_RE})@([a-f0-9]{7,40})$/
      owner, sha = $1, $2
      project = local_repo.main_project.owned_by(owner)
    end

    if project
      args[args.index(ref)] = sha

      if remote = project.remote and remotes.include? remote
        args.before ['fetch', remote.to_s]
      else
        args.before ['remote', 'add', '-f', project.owner, project.git_url(:https => https_protocol?)]
      end
    end
  end
end

#ci_status(args) ⇒ Object

$ hub ci-status $ hub ci-status 6f6d9797f9d6e56c3da623a97cfc3f45daf9ae5f $ hub ci-status master $ hub ci-status origin/master



80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
 
# File 'lib/hub/commands.rb', line 80

def ci_status(args)
  args.shift
  ref = args.words.first || 'HEAD'
  verbose = args.include?('-v')

  unless project = local_repo.main_project
    abort "Aborted: the origin remote doesn't point to a GitHub repository."
  end

  unless sha = local_repo.git_command("rev-parse -q '%s'" % ref.gsub("'", "\\'"))
    abort "Aborted: no revision could be determined from '#{ref}'"
  end

  statuses = api_client.statuses(project, sha)
  status = statuses.first
  if status
    ref_state = status['state']
    ref_target_url = status['target_url']
  else
    ref_state = 'no status'
    ref_target_url = nil
  end

  exit_code = case ref_state
    when 'success'          then 0
    when 'failure', 'error' then 1
    when 'pending'          then 2
    else 3
    end

  if verbose and ref_target_url
    $stdout.puts "%s: %s" % [ref_state, ref_target_url]
  else
    $stdout.puts ref_state
  end
  exit exit_code
rescue GitHubAPI::Exceptions
  response = $!.response
  display_api_exception("fetching CI status", response)
  exit 1
end

#clone(args) ⇒ Object

$ hub clone rtomayko/tilt > git clone git://github.com/rtomayko/tilt.

$ hub clone -p kneath/hemingway > git clone [email protected]:kneath/hemingway.git

$ hub clone tilt > git clone git://github.com/YOUR_LOGIN/tilt.

$ hub clone -p github > git clone [email protected]:YOUR_LOGIN/hemingway.git



284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
 
# File 'lib/hub/commands.rb', line 284

def clone(args)
  ssh = args.delete('-p')
  has_values = /^(--(upload-pack|template|depth|origin|branch|reference|name)|-[ubo])$/

  idx = 1
  while idx < args.length
    arg = args[idx]
    if arg.index('-') == 0
      idx += 1 if arg =~ has_values
    else
      # $ hub clone rtomayko/tilt
      # $ hub clone tilt
      if arg =~ NAME_WITH_OWNER_RE and !File.directory?(arg)
        name, owner = arg, nil
        owner, name = name.split('/', 2) if name.index('/')
        project = github_project(name, owner || github_user)
        unless ssh || args[0] == 'submodule' || https_protocol?
          repo_info = api_client.repo_info(project)
          ssh = repo_info.success? && (repo_info.data['private'] || repo_info.data['permissions']['push'])
        end
        args[idx] = project.git_url(:private => ssh, :https => https_protocol?)
      end
      break
    end
    idx += 1
  end
end

#compare(args) ⇒ Object

$ hub compare 1.0..fix > open github.com/CURRENT_REPO/compare/1.0…fix $ hub compare refactor > open github.com/CURRENT_REPO/compare/refactor $ hub compare myfork feature > open github.com/myfork/REPO/compare/feature $ hub compare -u 1.0…2.0 “github.com/CURRENT_REPO/compare/1.0…2.0”



731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
 
# File 'lib/hub/commands.rb', line 731

def compare(args)
  args.shift
  browse_command(args) do
    branch, project = remote_branch_and_project(method(:github_user))
    if args.empty?
      if branch and not branch.master?
        range = branch.short_name
      else
        abort "Usage: hub compare [USER] [<START>...]<END>"
      end
    else
      sha_or_tag = /((?:#{OWNER_RE}:)?\w[\w.-]+\w)/
      # replaces two dots with three: "sha1...sha2"
      range = args.pop.sub(/^#{sha_or_tag}\.\.#{sha_or_tag}$/, '\1...\2')
      if owner = args.pop
        project = project.owned_by(owner)
      end
    end

    escaped_range = range.include?('..') ? range : branch_in_url(range)
    path = '/compare/%s' % escaped_range
    project.web_url(path, api_client.config.method(:protocol))
  end
end

#create(args) ⇒ Object

$ hub create … create repo on github … > git remote add -f origin [email protected]:YOUR_USER/CURRENT_REPO.git



596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
 
# File 'lib/hub/commands.rb', line 596

def create(args)
  if !is_repo?
    abort "'create' must be run from inside a git repository"
  else
    owner = github_user
    args.shift
    options = {}
    options[:private] = true if args.delete('-p')
    new_repo_name = nil

    until args.empty?
      case arg = args.shift
      when '-d'
        options[:description] = args.shift
      when '-h'
        options[:homepage] = args.shift
      else
        if arg =~ /^[^-]/ and new_repo_name.nil?
          new_repo_name = arg
          owner, new_repo_name = new_repo_name.split('/', 2) if new_repo_name.index('/')
        else
          abort "invalid argument: #{arg}"
        end
      end
    end
    new_repo_name ||= repo_name
    new_project = github_project(new_repo_name, owner)

    if api_client.repo_exists?(new_project)
      warn "#{new_project.name_with_owner} already exists on #{new_project.host}"
      action = "set remote origin"
    else
      action = "created repository"
      unless args.noop?
        repo_data = api_client.create_repo(new_project, options)
        new_project = github_project(repo_data['full_name'])
      end
    end

    url = new_project.git_url(:private => true, :https => https_protocol?)

    if remotes.first != 'origin'
      args.replace %W"remote add -f origin #{url}"
    else
      args.replace %W"remote -v"
    end

    args.after 'echo', ["#{action}:", new_project.name_with_owner]
  end
rescue GitHubAPI::Exceptions
  display_api_exception("creating repository", $!.response)
  exit 1
end

#fetch(args) ⇒ Object

$ hub fetch mislav > git remote add mislav git://github.com/mislav/REPO.git > git fetch mislav

$ hub fetch –multiple mislav xoebus > git remote add mislav … > git remote add xoebus … > git fetch –multiple mislav xoebus



378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
 
# File 'lib/hub/commands.rb', line 378

def fetch(args)
  # $ hub fetch --multiple <name1>, <name2>, ...
  if args.include?('--multiple')
    names = args.words[1..-1]
  # $ hub fetch <name>
  elsif remote_name = args.words[1]
    # $ hub fetch <name1>,<name2>,...
    if remote_name =~ /^\w+(,\w+)+$/
      index = args.index(remote_name)
      args.delete(remote_name)
      names = remote_name.split(',')
      args.insert(index, *names)
      args.insert(index, '--multiple')
    else
      names = [remote_name]
    end
  else
    names = []
  end

  projects = names.map { |name|
    unless name !~ /^#{OWNER_RE}$/ or remotes.include?(name) or remotes_group(name)
      project = github_project(nil, name)
      repo_info = api_client.repo_info(project)
      if repo_info.success?
        project.repo_data = repo_info.data
        project
      end
    end
  }.compact

  if projects.any?
    projects.each do |project|
      args.before ['remote', 'add', project.owner, project.git_url(:https => https_protocol?)]
    end
  end
end

#fork(args) ⇒ Object

$ hub fork … hardcore forking action … > git remote add -f YOUR_USER [email protected]:YOUR_USER/CURRENT_REPO.git



561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
 
# File 'lib/hub/commands.rb', line 561

def fork(args)
  unless project = local_repo.main_project
    abort "Error: repository under 'origin' remote is not a GitHub project"
  end
  forked_project = project.owned_by(github_user(project.host))

  existing_repo = api_client.repo_info(forked_project)
  if existing_repo.success?
    parent_data = existing_repo.data['parent']
    parent_url  = parent_data && resolve_github_url(parent_data['html_url'])
    if !parent_url or parent_url.project != project
      abort "Error creating fork: %s already exists on %s" %
        [ forked_project.name_with_owner, forked_project.host ]
    end
  else
    api_client.fork_repo(project) unless args.noop?
  end

  if args.include?('--no-remote')
    exit
  else
    origin_url = project.remote.github_url
    url = forked_project.git_url(:private => true, :https => https_protocol?)
    args.replace %W"remote add -f #{forked_project.owner} #{origin_url}"
    args.after %W"remote set-url #{forked_project.owner} #{url}"
    args.after 'echo', ['new remote:', forked_project.owner]
  end
rescue GitHubAPI::Exceptions
  display_api_exception("creating fork", $!.response)
  exit 1
end

#help(args) ⇒ Object Also known as: --help

$ hub help (print improved help text)



822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
 
# File 'lib/hub/commands.rb', line 822

def help(args)
  command = args.words[1]

  if command == 'hub' || custom_command?(command)
    paginated_puts hub_manpage
    exit
  elsif command.nil?
    if args.has_flag?('-a', '--all')
      # Add the special hub commands to the end of "git help -a" output.
      args.after 'echo', ["\nhub custom commands\n"]
      args.after 'echo', CUSTOM_COMMANDS.map {|cmd| "  #{cmd}" }
    else
      if args.has_flag?('-p', '--paginate')
        paginated_puts improved_help_text
      else
        puts improved_help_text
      end
      exit
    end
  end
end

#hub(args) ⇒ Object

$ hub hub standalone Prints the “standalone” version of hub for an easy, memorable installation sequence:

$ gem install hub $ hub hub standalone > ~/bin/hub && chmod 755 ~/bin/hub $ gem uninstall hub



763
764
765
766
767
768
769
770
771
772
 
# File 'lib/hub/commands.rb', line 763

def hub(args)
  return help(args) unless args[1] == 'standalone'
  require 'hub/standalone'
  Hub::Standalone.build $stdout
  exit
rescue LoadError
  abort "hub is already running in standalone mode."
rescue Errno::EPIPE
  exit # ignore broken pipe
end

#init(args) ⇒ Object

$ hub init -g > git init > git remote add origin [email protected]:USER/REPO.git



550
551
552
553
554
555
556
 
# File 'lib/hub/commands.rb', line 550

def init(args)
  if args.delete('-g')
    project = github_project(File.basename(current_dir))
    url = project.git_url(:private => true, :https => https_protocol?)
    args.after ['remote', 'add', 'origin', url]
  end
end

#merge(args) ⇒ Object

$ git merge github.com/defunkt/hub/pull/73 > git fetch git://github.com/mislav/hub.git +refs/heads/feature:refs/remotes/mislav/feature > git merge mislav/feature –no-ff -m ‘Merge pull request #73 from mislav/feature…’



447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
 
# File 'lib/hub/commands.rb', line 447

def merge(args)
  _, url_arg = args.words
  if url = resolve_github_url(url_arg) and url.project_path =~ /^pull\/(\d+)/
    pull_id = $1
    pull_data = api_client.pullrequest_info(url.project, pull_id)

    user, branch = pull_data['head']['label'].split(':', 2)
    abort "Error: #{user}'s fork is not available anymore" unless pull_data['head']['repo']

    repo_name = pull_data['head']['repo']['name']
    url = github_project(repo_name, user).git_url(:private => pull_data['head']['repo']['private'],
                                                  :https => https_protocol?)

    merge_head = "#{user}/#{branch}"
    args.before ['fetch', url, "+refs/heads/#{branch}:refs/remotes/#{merge_head}"]

    idx = args.index url_arg
    args.delete_at idx
    args.insert idx, merge_head, '-m', "Merge pull request ##{pull_id} from #{merge_head}\n\n#{pull_data['title']}"
    idx = args.index '-m'
    args.insert idx, '--no-ff' unless args.include?('--ff-only')
  end
end

#pull_request(args) ⇒ Object Also known as: e_note

$ hub pull-request $ hub pull-request “My humble contribution” $ hub pull-request github.com/rtomayko/tilt/issues/92



125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
 
# File 'lib/hub/commands.rb', line 125

def pull_request(args)
  args.shift
  options = { }
  force = explicit_owner = false
  base_project = local_repo.main_project
  tracked_branch, head_project = remote_branch_and_project(method(:github_user))

  unless current_branch
    abort "Aborted: not currently on any branch."
  end

  unless base_project
    abort "Aborted: the origin remote doesn't point to a GitHub repository."
  end

  from_github_ref = lambda do |ref, context_project|
    if ref.index(':')
      owner, ref = ref.split(':', 2)
      project = github_project(context_project.name, owner)
    end
    [project || context_project, ref]
  end

  while arg = args.shift
    case arg
    when '-f'
      force = true
    when '-F', '--file'
      file = args.shift
      text = file == '-' ? $stdin.read : File.read(file)
      options[:title], options[:body] = read_msg(text)
    when '-m', '--message'
      text = args.shift
      options[:title], options[:body] = read_msg(text)
    when '-b'
      base_project, options[:base] = from_github_ref.call(args.shift, base_project)
    when '-h'
      head = args.shift
      explicit_owner = !!head.index(':')
      head_project, options[:head] = from_github_ref.call(head, head_project)
    when '-i'
      options[:issue] = args.shift
    when '-o', '--browse'
      open_with_browser = true
    else
      if url = resolve_github_url(arg) and url.project_path =~ /^issues\/(\d+)/
        options[:issue] = $1
        base_project = url.project
      elsif !options[:title] && arg.index('-') != 0
        options[:title] = arg
        warn "hub: Specifying pull request title without a flag is deprecated."
        warn "Please use one of `-m' or `-F' options."
      else
        abort "invalid argument: #{arg}"
      end
    end
  end

  if options[:issue]
    warn "Warning: Issue to pull request conversion is deprecated and might not work in the future."
  end

  options[:project] = base_project
  options[:base] ||= master_branch.short_name

  if options[:head].nil? && tracked_branch
    if !tracked_branch.remote?
      # The current branch is tracking another local branch. Pretend there is
      # no upstream configuration at all.
      tracked_branch = nil
    elsif base_project == head_project and tracked_branch.short_name == options[:base]
      $stderr.puts "Aborted: head branch is the same as base (#{options[:base].inspect})"
      warn "(use `-h <branch>` to specify an explicit pull request head)"
      abort
    end
  end
  options[:head] ||= (tracked_branch || current_branch).short_name

  remote_branch = "#{head_project.remote}/#{options[:head]}"
  options[:head] = "#{head_project.owner}:#{options[:head]}"

  if !force and tracked_branch and local_commits = rev_list(remote_branch, nil)
    $stderr.puts "Aborted: #{local_commits.split("\n").size} commits are not yet pushed to #{remote_branch}"
    warn "(use `-f` to force submit a pull request anyway)"
    abort
  end

  if args.noop?
    puts "Would request a pull to #{base_project.owner}:#{options[:base]} from #{options[:head]}"
    exit
  end

  unless options[:title] or options[:issue]
    base_branch = "#{base_project.remote}/#{options[:base]}"
    commits = rev_list(base_branch, remote_branch).to_s.split("\n")

    case commits.size
    when 0
      default_message = commit_summary = nil
    when 1
      format = '%s%n%+b'
      default_message = git_command "show -s --format='#{format}' #{commits.first}"
      commit_summary = nil
    else
      format = '%h (%aN, %ar)%n%w(78,3,3)%s%n%+b'
      default_message = nil
      commit_summary = git_command "log --no-color --format='%s' --cherry '%s...%s'" % [
        format,
        base_branch.to_s.gsub("'", "\\'"),
        remote_branch.to_s.gsub("'", "\\'")
      ]
    end

    options[:title], options[:body] = pullrequest_editmsg(commit_summary) { |msg, initial_message, cc|
      initial_message ||= default_message
      msg.puts initial_message if initial_message
      msg.puts ""
      msg.puts "#{cc} Requesting a pull to #{base_project.owner}:#{options[:base]} from #{options[:head]}"
      msg.puts "#{cc}"
      msg.puts "#{cc} Write a message for this pull request. The first block"
      msg.puts "#{cc} of text is the title and the rest is description."
    }
  end

  pull = api_client.create_pullrequest(options)

  args.push('-u') unless open_with_browser
  browse_command(args) do
    pull['html_url']
  end
rescue GitHubAPI::Exceptions
  response = $!.response
  display_api_exception("creating pull request", response)
  if 404 == response.status
    base_url = base_project.web_url.split('://', 2).last
    warn "Are you sure that #{base_url} exists?"
  end
  exit 1
else
  delete_editmsg
end

#push(args) ⇒ Object

$ hub push origin,staging cool-feature > git push origin cool-feature > git push staging cool-feature



653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
 
# File 'lib/hub/commands.rb', line 653

def push(args)
  return if args[1].nil? || !args[1].index(',')

  refs    = args.words[2..-1]
  remotes = args[1].split(',')
  args[1] = remotes.shift

  if refs.empty?
    # add current branch as explicit ref when there are no refs specified
    refs = [current_branch.short_name]
    args.concat refs
  end

  remotes.each do |name|
    args.after ['push', name, *refs]
  end
end

#remote(args) ⇒ Object

$ hub remote add pjhyett > git remote add pjhyett git://github.com/pjhyett/THIS_REPO.git

$ hub remote add -p mojombo > git remote add mojombo [email protected]:mojombo/THIS_REPO.git

$ hub remote add origin > git remote add origin git://github.com/YOUR_LOGIN/THIS_REPO.git



336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
 
# File 'lib/hub/commands.rb', line 336

def remote(args)
  if %w[add set-url].include?(args[1])
    name = args.last
    if name =~ /^(#{OWNER_RE})$/ || name =~ /^(#{OWNER_RE})\/(#{NAME_RE})$/
      user, repo = $1, $2 || repo_name
    end
  end
  return unless user # do not touch arguments

  ssh = args.delete('-p')

  if args.words[2] == 'origin' && args.words[3].nil?
    # Origin special case triggers default user/repo
    user, repo = github_user, repo_name
  elsif args.words[-2] == args.words[1]
    # rtomayko/tilt => rtomayko
    # Make sure you dance around flags.
    idx = args.index( args.words[-1] )
    args[idx] = user
  else
    # They're specifying the remote name manually (e.g.
    # git remote add blah rtomayko/tilt), so just drop the last
    # argument.
    args.pop
  end

  if user.downcase == github_user.downcase
    user = github_user
    ssh = true
  end

  args << git_url(user, repo, :private => ssh)
end

#run(args) ⇒ Object 



45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
 
# File 'lib/hub/commands.rb', line 45

def run(args)
  slurp_global_flags(args)

  # Hack to emulate git-style
  args.unshift 'help' if args.empty?

  cmd = args[0]
  if expanded_args = expand_alias(cmd)
    cmd = expanded_args[0]
    expanded_args.concat args[1..-1]
  end

  respect_help_flags(expanded_args || args) if custom_command? cmd

  # git commands can have dashes
  cmd = cmd.gsub(/(\w)-/, '\1_')
  if method_defined?(cmd) and cmd != 'run'
    args.replace expanded_args if expanded_args
    send(cmd, args)
  end
rescue Errno::ENOENT
  if $!.message.include? "No such file or directory - git"
    abort "Error: `git` command not found"
  else
    raise
  end
rescue Context::FatalError => err
  abort "fatal: #{err.message}"
end

#submodule(args) ⇒ Object

$ 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 [email protected]:wycats/bundler.git vendor/bundler

$ hub submodule add -b ryppl –name pip ryppl/pip vendor/pip > git submodule add -b ryppl –name pip git://github.com/ryppl/pip.git vendor/pip



320
321
322
323
324
325
326
 
# File 'lib/hub/commands.rb', line 320

def submodule(args)
  return unless index = args.index('add')
  args.delete_at index

  clone(args)
  args.insert index, 'add'
end

#version(args) ⇒ Object Also known as: --version

$ hub version > git version (print hub version)



815
816
817
 
# File 'lib/hub/commands.rb', line 815

def version(args)
  args.after 'echo', ['hub version', Version]
end