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, #tmp_dir, #unix?, #which, #windows?

Methods included from Hub::Context::GitReaderMethods

extended

Instance Method Details

#alias(args) ⇒ Object 



758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
 
# File 'lib/hub/commands.rb', line 758

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



497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
 
# File 'lib/hub/commands.rb', line 497

def am(args)
  if url = args.find { |a| a =~ %r{^https?://(gist\.)?github\.com/} }
    idx = args.index(url)
    if $1 == 'gist.'
      path_parts = $'.sub(/#.*/, '').split('/')
      gist_id = path_parts.last
      patch_name = "gist-#{gist_id}.txt"
      patch = api_client.gist_raw(gist_id)
    else
      gh_url = resolve_github_url(url)
      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 = File.join(tmp_dir, patch_name)
    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



670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
 
# File 'lib/hub/commands.rb', line 670

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
    else
      # $ hub browse
      prefer_upstream = 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)}"
    when 'tree', NilClass
      "/tree/#{branch_in_url(branch)}" 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



409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
 
# File 'lib/hub/commands.rb', line 409

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



471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
 
# File 'lib/hub/commands.rb', line 471

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



78
79
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
 
# File 'lib/hub/commands.rb', line 78

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 #{ref}")
    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



279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
 
# File 'lib/hub/commands.rb', line 279

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' || args.noop? || 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”



716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
 
# File 'lib/hub/commands.rb', line 716

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

    path = '/compare/%s' % range.tr('/', ';')
    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



581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
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
 
# File 'lib/hub/commands.rb', line 581

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



368
369
370
371
372
373
374
375
376
377
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
 
# File 'lib/hub/commands.rb', line 368

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



546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
 
# File 'lib/hub/commands.rb', line 546

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)



806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
 
# File 'lib/hub/commands.rb', line 806

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

  if command == 'hub' || custom_command?(command)
    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
      ENV['GIT_PAGER'] = '' unless args.has_flag?('-p', '--paginate') # Use `cat`.
      puts improved_help_text
      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



747
748
749
750
751
752
753
754
755
756
 
# File 'lib/hub/commands.rb', line 747

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



535
536
537
538
539
540
541
 
# File 'lib/hub/commands.rb', line 535

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…’



437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
 
# File 'lib/hub/commands.rb', line 437

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']

    url = github_project(url.project_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



123
124
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
 
# File 'lib/hub/commands.rb', line 123

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 = '%w(78,0,0)%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, remote_branch]
    end

    options[:title], options[:body] = pullrequest_editmsg(commit_summary) { |msg, initial_message|
      initial_message ||= default_message
      msg.puts initial_message if initial_message
      msg.puts ""
      msg.puts "# Requesting a pull to #{base_project.owner}:#{options[:base]} from #{options[:head]}"
      msg.puts "#"
      msg.puts "# Write a message for this pull request. The first block"
      msg.puts "# 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



638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
 
# File 'lib/hub/commands.rb', line 638

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



331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
 
# File 'lib/hub/commands.rb', line 331

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

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

#run(args) ⇒ Object 



43
44
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
 
# File 'lib/hub/commands.rb', line 43

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



315
316
317
318
319
320
321
 
# File 'lib/hub/commands.rb', line 315

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)



799
800
801
 
# File 'lib/hub/commands.rb', line 799

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