github 0.1.1 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (47) hide show
  1. data/History.txt +37 -0
  2. data/Manifest +33 -12
  3. data/README.md +187 -0
  4. data/Rakefile +44 -0
  5. data/bin/gh +8 -0
  6. data/bin/github +4 -1
  7. data/github.gemspec +29 -34
  8. data/lib/commands/commands.rb +249 -0
  9. data/lib/commands/helpers.rb +486 -0
  10. data/lib/commands/issues.rb +17 -0
  11. data/lib/commands/network.rb +110 -0
  12. data/lib/github.rb +117 -29
  13. data/lib/github/command.rb +69 -14
  14. data/lib/github/extensions.rb +39 -0
  15. data/lib/github/ui.rb +19 -0
  16. data/setup.rb +1551 -0
  17. data/spec/command_spec.rb +82 -0
  18. data/spec/commands/command_browse_spec.rb +36 -0
  19. data/spec/commands/command_clone_spec.rb +87 -0
  20. data/spec/commands/command_create-from-local_spec.rb +7 -0
  21. data/spec/commands/command_fetch_spec.rb +56 -0
  22. data/spec/commands/command_fork_spec.rb +44 -0
  23. data/spec/commands/command_helper.rb +170 -0
  24. data/spec/commands/command_home_spec.rb +20 -0
  25. data/spec/commands/command_info_spec.rb +23 -0
  26. data/spec/commands/command_issues_spec.rb +97 -0
  27. data/spec/commands/command_network_spec.rb +30 -0
  28. data/spec/commands/command_pull-request_spec.rb +51 -0
  29. data/spec/commands/command_pull_spec.rb +82 -0
  30. data/spec/commands/command_search_spec.rb +34 -0
  31. data/spec/commands/command_track_spec.rb +82 -0
  32. data/spec/commands_spec.rb +49 -0
  33. data/spec/extensions_spec.rb +36 -0
  34. data/spec/github_spec.rb +85 -0
  35. data/spec/helper_spec.rb +368 -0
  36. data/spec/spec_helper.rb +160 -4
  37. data/spec/windoze_spec.rb +38 -0
  38. metadata +114 -47
  39. data/README +0 -49
  40. data/commands/commands.rb +0 -54
  41. data/commands/helpers.rb +0 -79
  42. data/spec/helpers/owner_spec.rb +0 -12
  43. data/spec/helpers/project_spec.rb +0 -12
  44. data/spec/helpers/public_url_for_spec.rb +0 -12
  45. data/spec/helpers/repo_for_spec.rb +0 -12
  46. data/spec/helpers/user_and_repo_from_spec.rb +0 -15
  47. data/spec/helpers/user_for_spec.rb +0 -12
data/History.txt ADDED
@@ -0,0 +1,37 @@
1
+ == 0.4.0
2
+
3
+ Releasing to GemCutter!
4
+
5
+ Maintenance taken over by Dr Nic Williams.
6
+ Post issues/bugs to http://github.com/defunkt/github-gem/issues
7
+
8
+ New Commands:
9
+ * gh issues web [user] - opens the Issues page
10
+
11
+ Miscellaneous:
12
+ * no longer using old /network/members API call (which is 500ing at the moment)
13
+
14
+ == 0.3.10
15
+
16
+ * gh clone --search query -- now includes project descriptions
17
+ * bugfix
18
+ * added highline dependency
19
+
20
+ == 0.3.9
21
+
22
+ * gh clone --search query -- to search for a repo and then clone it
23
+ * fixed all the specs and started covering some commands that did not already have specs
24
+
25
+ == 0.3.X
26
+
27
+ * Some stuff done by some people
28
+
29
+ == 0.1.4
30
+
31
+ * Added usage notes to commands. [topfunky]
32
+ * Added config option to set github.user and github.repo. [topfunky]
33
+ * Uses current user to automatically use SSH when cloning own projects.
34
+
35
+ == 0.1.3
36
+
37
+ * Original version
data/Manifest CHANGED
@@ -1,17 +1,38 @@
1
+ History.txt
2
+ LICENSE
3
+ Manifest
4
+ README.md
5
+ Rakefile
6
+ bin/gh
1
7
  bin/github
2
- commands/commands.rb
3
- commands/helpers.rb
8
+ lib/commands/commands.rb
9
+ lib/commands/helpers.rb
10
+ lib/commands/issues.rb
11
+ lib/commands/network.rb
12
+ lib/github.rb
4
13
  lib/github/command.rb
14
+ lib/github/extensions.rb
5
15
  lib/github/helper.rb
6
- lib/github.rb
7
- LICENSE
8
- README
16
+ lib/github/ui.rb
17
+ setup.rb
9
18
  spec/command_spec.rb
10
- spec/helpers/owner_spec.rb
11
- spec/helpers/project_spec.rb
12
- spec/helpers/public_url_for_spec.rb
13
- spec/helpers/repo_for_spec.rb
14
- spec/helpers/user_and_repo_from_spec.rb
15
- spec/helpers/user_for_spec.rb
19
+ spec/commands/command_browse_spec.rb
20
+ spec/commands/command_clone_spec.rb
21
+ spec/commands/command_create-from-local_spec.rb
22
+ spec/commands/command_fetch_spec.rb
23
+ spec/commands/command_fork_spec.rb
24
+ spec/commands/command_helper.rb
25
+ spec/commands/command_home_spec.rb
26
+ spec/commands/command_info_spec.rb
27
+ spec/commands/command_issues_spec.rb
28
+ spec/commands/command_network_spec.rb
29
+ spec/commands/command_pull-request_spec.rb
30
+ spec/commands/command_pull_spec.rb
31
+ spec/commands/command_search_spec.rb
32
+ spec/commands/command_track_spec.rb
33
+ spec/commands_spec.rb
34
+ spec/extensions_spec.rb
35
+ spec/github_spec.rb
36
+ spec/helper_spec.rb
16
37
  spec/spec_helper.rb
17
- Manifest
38
+ spec/windoze_spec.rb
data/README.md ADDED
@@ -0,0 +1,187 @@
1
+ # The GitHub Gem
2
+
3
+ This gem works hand-in-hand with GitHub's API to help you out.
4
+
5
+ Catch us in the #github room on freenode if you want to get involved. Or just fork and send a pull request.
6
+
7
+ ## Getting started
8
+
9
+ $ gem source add http://gemcutter.org
10
+ $ gem install github
11
+
12
+ Run it:
13
+
14
+ $ github <command> <args>
15
+ $ gh <command> <args>
16
+
17
+ ## Pulling Upstream Changes
18
+
19
+ Let's say you just forked `github-gem` on GitHub from defunkt.
20
+
21
+ $ gh clone YOU/github-gem
22
+ $ cd github-gem
23
+ $ gh pull defunkt
24
+
25
+ This will setup a remote and branch for defunkt's repository at master.
26
+ In this case, a 'defunkt/master' branch.
27
+
28
+ If defunkt makes some changes you want, simply `github pull defunkt`. This will
29
+ leave you in the 'defunkt/master' branch after pulling changes from defunkt's
30
+ remote. After confirming that defunkt's changes were what you wanted, run `git
31
+ checkout master` and then `git merge defunkt/master` to merge defunkt's changes
32
+ into your own master branch. In summary:
33
+
34
+ $ gh pull defunkt
35
+ $ gh checkout master
36
+ $ gh merge defunkt/master
37
+
38
+ If you've already reviewed defunkt's changes and just want to merge them into your
39
+ master branch, use the `merge` flag:
40
+
41
+ $ gh pull --merge defunkt
42
+
43
+ ## Fetching and Evaluating Downstream Changes
44
+
45
+ If you are the maintainer of a project, you will often need to fetch commits
46
+ from other developers, evaluate and/or test them, then merge them into the
47
+ project.
48
+
49
+ Let's say you are 'defunkt' and 'mojombo' has forked your 'github-gem' repo,
50
+ made some changes and issues you a pull request for his 'master' branch.
51
+
52
+ From the root of the project, you can do:
53
+
54
+ $ gh fetch mojombo master
55
+
56
+ This will leave you in the 'mojombo/master' branch after fetching his commits.
57
+ Your local 'mojombo/master' branch is now at the exact same place as mojombo's
58
+ 'master' branch. You can now run tests or evaluate the code for awesomeness.
59
+
60
+ If mojombo's changes are good, you'll want to merge your 'master' (or another
61
+ branch) into those changes so you can retest post-integration:
62
+
63
+ $ gh merge master
64
+
65
+ Test/analyze again and if everything is ok:
66
+
67
+ $ gh checkout master
68
+ $ gh merge mojombo/master
69
+
70
+ The latter command will be a fast-forward merge since you already did the
71
+ real merge previously.
72
+
73
+ ## Network Patch Queue
74
+
75
+ The github gem can also show you all of the commits that exist on any fork of your
76
+ project (your network) that you don't have in your branch yet. In order to see
77
+ the list of the projects that have commits you do not, you can run:
78
+
79
+ $ gh network list
80
+
81
+ Which will show you all the forks that have changes. If you want to see what those
82
+ changes are, you can run:
83
+
84
+ $ gh network commits
85
+
86
+ which will show you something like this:
87
+
88
+ 9582b9 (jchris/gist) kevin@sb.org Add gist binary 4 months ago
89
+ c1a6f9 (jchris/gist~1) kevin@sb.org Tweak Rakefile spec tasks to be a bi 4 months ago
90
+ d3c332 (jchris/gist~2) kevin@sb.org Pull out two helpers into the shared 4 months ago
91
+ 8f65ab (jchris/gist~3) kevin@sb.org Extract command/helper spec assistan 4 months ago
92
+ 389dbf (jchris/gist~4) kevin@sb.org Rename ui_spec to command_spec 4 months ago
93
+ 670a1a (jchris/gist~5) kevin@sb.org Hoist the specs into a per-binary sp 4 months ago
94
+ 6aa18e (jchris/gist~6) kevin@sb.org Hoist commands/helpers into a per-co 4 months ago
95
+ ee013a (luislavena/master) luislavena@gmail.com Replaced STDOUT by $stdout in specs. 2 weeks ago
96
+ d543c4 (luislavena/master~3) luislavena@gmail.com Exclude package folder. 8 weeks ago
97
+ a8c3eb (luislavena/master~5) luislavena@gmail.com Fixed specs for open under Windows. 5 months ago
98
+ 33d003 (riquedafreak/master) enrique.osuna@gmail. Make sure it exists on the remote an 5 weeks ago
99
+ 157155 (riquedafreak/master~1) enrique.osuna@gmail. Updated specs. 5 weeks ago
100
+ f44e99 (riquedafreak/master~3) enrique.osuna@gmail. Only work with a clean branch. 3 months ago
101
+
102
+ These are all the commits that you don't have in your current branch that have been
103
+ pushed to other forks of your project. If you want to incorporate them, you can use:
104
+
105
+ $ gh cherry-pick ee013a
106
+
107
+ for example to apply that single patch to your branch. You can also merge a branch,
108
+ if you want all the changes introduced in another branch:
109
+
110
+ $ gh merge jchris/gist
111
+
112
+ The next time you run the 'github network commits' command, you won't see any of the
113
+ patches you have cherry-picked or merged (or rebased). If you want to ignore a
114
+ commit, you can simply run:
115
+
116
+ $ gh ignore a8c3eb
117
+
118
+ Then you won't ever see that commit again. Or, if you want to ignore a range of commits,
119
+ you can use the normal Git revision selection shorthands - for example, if you want
120
+ to ignore all 7 jchris/gist commits there, you can run:
121
+
122
+ $ gh ignore ..jchris/gist
123
+
124
+ You can also filter the output, if you want to see some subset. You can filter by project,
125
+ author and date range, or (one of the cooler things) you can filter by whether the patch
126
+ applies cleanly to your branch head or not. For instance, I can do this:
127
+
128
+ $ ./bin/github network commits --applies
129
+
130
+ ca15af (jchris/master~1) jchris@grabb.it fixed github gemspecs broken referen 8 weeks ago
131
+ ee013a (luislavena/master) luislavena@gmail.com Replaced STDOUT by $stdout in specs. 2 weeks ago
132
+ 157155 (riquedafreak/master~1) enrique.osuna@gmail. Updated specs. 5 weeks ago
133
+ f44e99 (riquedafreak/master~3) enrique.osuna@gmail. Only work with a clean branch. 3 months ago
134
+
135
+ $ ./bin/github network commits --applies --project=riq
136
+
137
+ 157155 (riquedafreak/master~1) enrique.osuna@gmail. Updated specs. 5 weeks ago
138
+ f44e99 (riquedafreak/master~3) enrique.osuna@gmail. Only work with a clean branch. 3 months ago
139
+
140
+ Pretty freaking sweet. Also, you can supply the --shas option to just get a list of
141
+ the shas instead of the pretty printout here, so you can pipe that into other
142
+ scripts (like 'github ignore' for instance).
143
+
144
+
145
+ ## Issues
146
+
147
+ If you'd like to see a summary of the open issues on your project:
148
+
149
+ $ gh issues open
150
+
151
+ -----
152
+ Issue #135 (2 votes): Remove Node#collect_namespaces
153
+ * URL: http://github.com/tenderlove/nokogiri/issues/#issue/135
154
+ * Opened 3 days ago by tenderlove
155
+ * Last updated about 1 hour ago
156
+
157
+ I think we should remove Node#collect_namespaces. Since namespace names are not unique, I don't know that this method is very useful.
158
+ -----
159
+ Issue #51 (0 votes): FFI: support varargs in error/exception callbacks
160
+ * URL: http://github.com/tenderlove/nokogiri/issues/#issue/51
161
+ * Opened 4 months ago by flavorjones
162
+ * Last updated about 1 month ago
163
+ * Labels: ffi, mdalessio
164
+
165
+ we should open JIRA tickets for vararg support in FFI callbacks
166
+
167
+ then we should format the libxml error messages properly in the error/exception callbacks
168
+ -----
169
+
170
+ If you want to additionally filter by time:
171
+
172
+ $ gh issues open --after=2009-09-14
173
+
174
+ Or filter by label:
175
+
176
+ $ gh issues open --label=ffi
177
+
178
+ ## Contributors
179
+
180
+ * defunkt
181
+ * maddox
182
+ * halorgium
183
+ * kballard
184
+ * mojombo
185
+ * schacon
186
+ * drnic
187
+
data/Rakefile ADDED
@@ -0,0 +1,44 @@
1
+ require 'rubygems'
2
+ require 'rake'
3
+
4
+ begin
5
+ require 'echoe'
6
+
7
+ Echoe.new('github', '0.4.0') do |p|
8
+ p.rubyforge_name = 'github'
9
+ p.summary = "The official `github` command line helper for simplifying your GitHub experience."
10
+ p.description = "The official `github` command line helper for simplifying your GitHub experience."
11
+ p.url = "http://github.com/"
12
+ p.author = ['Chris Wanstrath', 'Kevin Ballard', 'Scott Chacon']
13
+ p.email = "chris@ozmm.org"
14
+ p.dependencies = [
15
+ "text-format >=1.0.0",
16
+ "highline ~>1.5.1"
17
+ ]
18
+ end
19
+
20
+ rescue LoadError => boom
21
+ puts "You are missing a dependency required for meta-operations on this gem."
22
+ puts "#{boom.to_s.capitalize}."
23
+ end
24
+
25
+ # add spec tasks, if you have rspec installed
26
+ begin
27
+ require 'spec/rake/spectask'
28
+
29
+ Spec::Rake::SpecTask.new("spec") do |t|
30
+ t.spec_files = FileList['spec/**/*_spec.rb']
31
+ t.spec_opts = ['--color']
32
+ end
33
+
34
+ task :test do
35
+ Rake::Task['spec'].invoke
36
+ end
37
+
38
+ Spec::Rake::SpecTask.new("rcov_spec") do |t|
39
+ t.spec_files = FileList['spec/**/*_spec.rb']
40
+ t.spec_opts = ['--color']
41
+ t.rcov = true
42
+ t.rcov_opts = ['--exclude', '^spec,/gems/']
43
+ end
44
+ end
data/bin/gh ADDED
@@ -0,0 +1,8 @@
1
+ #!/usr/bin/env ruby
2
+
3
+ lib_dir = File.join(File.dirname(__FILE__), '..', 'lib')
4
+ $LOAD_PATH.unshift lib_dir if File.directory?(lib_dir)
5
+
6
+ require 'github'
7
+
8
+ GitHub.activate ARGV
data/bin/github CHANGED
@@ -1,5 +1,8 @@
1
1
  #!/usr/bin/env ruby
2
2
 
3
- require File.dirname(__FILE__) + '/../lib/github'
3
+ lib_dir = File.join(File.dirname(__FILE__), '..', 'lib')
4
+ $LOAD_PATH.unshift lib_dir if File.directory?(lib_dir)
5
+
6
+ require 'github'
4
7
 
5
8
  GitHub.activate ARGV
data/github.gemspec CHANGED
@@ -1,42 +1,37 @@
1
-
2
- # Gem::Specification for Github-0.1.1
3
- # Originally generated by Echoe
1
+ # -*- encoding: utf-8 -*-
4
2
 
5
3
  Gem::Specification.new do |s|
6
4
  s.name = %q{github}
7
- s.version = "0.1.1"
8
- s.date = %q{2008-03-26}
9
- s.summary = %q{The official `github` command line helper for simplifying your GitHub experience.}
5
+ s.version = "0.4.0"
6
+
7
+ s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
8
+ s.authors = ["Chris Wanstrath, Kevin Ballard, Scott Chacon"]
9
+ s.date = %q{2009-11-06}
10
+ s.description = %q{The official `github` command line helper for simplifying your GitHub experience.}
10
11
  s.email = %q{chris@ozmm.org}
12
+ s.executables = ["gh", "github"]
13
+ s.extra_rdoc_files = ["LICENSE", "README.md", "bin/gh", "bin/github", "lib/commands/commands.rb", "lib/commands/helpers.rb", "lib/commands/issues.rb", "lib/commands/network.rb", "lib/github.rb", "lib/github/command.rb", "lib/github/extensions.rb", "lib/github/helper.rb", "lib/github/ui.rb"]
14
+ s.files = ["History.txt", "LICENSE", "Manifest", "README.md", "Rakefile", "bin/gh", "bin/github", "lib/commands/commands.rb", "lib/commands/helpers.rb", "lib/commands/issues.rb", "lib/commands/network.rb", "lib/github.rb", "lib/github/command.rb", "lib/github/extensions.rb", "lib/github/helper.rb", "lib/github/ui.rb", "setup.rb", "spec/command_spec.rb", "spec/commands/command_browse_spec.rb", "spec/commands/command_clone_spec.rb", "spec/commands/command_create-from-local_spec.rb", "spec/commands/command_fetch_spec.rb", "spec/commands/command_fork_spec.rb", "spec/commands/command_helper.rb", "spec/commands/command_home_spec.rb", "spec/commands/command_info_spec.rb", "spec/commands/command_issues_spec.rb", "spec/commands/command_network_spec.rb", "spec/commands/command_pull-request_spec.rb", "spec/commands/command_pull_spec.rb", "spec/commands/command_search_spec.rb", "spec/commands/command_track_spec.rb", "spec/commands_spec.rb", "spec/extensions_spec.rb", "spec/github_spec.rb", "spec/helper_spec.rb", "spec/spec_helper.rb", "spec/windoze_spec.rb", "github.gemspec"]
11
15
  s.homepage = %q{http://github.com/}
16
+ s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Github", "--main", "README.md"]
17
+ s.require_paths = ["lib"]
12
18
  s.rubyforge_project = %q{github}
13
- s.description = %q{The official `github` command line helper for simplifying your GitHub experience.}
14
- s.default_executable = %q{github}
15
- s.has_rdoc = true
16
- s.authors = ["Chris Wanstrath"]
17
- s.files = ["bin/github", "commands/commands.rb", "commands/helpers.rb", "lib/github/command.rb", "lib/github/helper.rb", "lib/github.rb", "LICENSE", "README", "spec/command_spec.rb", "spec/helpers/owner_spec.rb", "spec/helpers/project_spec.rb", "spec/helpers/public_url_for_spec.rb", "spec/helpers/repo_for_spec.rb", "spec/helpers/user_and_repo_from_spec.rb", "spec/helpers/user_for_spec.rb", "spec/spec_helper.rb", "Manifest", "github.gemspec"]
18
- s.executables = ["github"]
19
- end
19
+ s.rubygems_version = %q{1.3.5}
20
+ s.summary = %q{The official `github` command line helper for simplifying your GitHub experience.}
20
21
 
22
+ if s.respond_to? :specification_version then
23
+ current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
24
+ s.specification_version = 3
21
25
 
22
- # # Original Rakefile source (requires the Echoe gem):
23
- #
24
- # require 'rubygems'
25
- # require 'rake'
26
- #
27
- # begin
28
- # require 'echoe'
29
- #
30
- # Echoe.new('github', '0.1.1') do |p|
31
- # p.rubyforge_name = 'github'
32
- # p.summary = "The official `github` command line helper for simplifying your GitHub experience."
33
- # p.description = "The official `github` command line helper for simplifying your GitHub experience."
34
- # p.url = "http://github.com/"
35
- # p.author = 'Chris Wanstrath'
36
- # p.email = "chris@ozmm.org"
37
- # end
38
- #
39
- # rescue LoadError => boom
40
- # puts "You are missing a dependency required for meta-operations on this gem."
41
- # puts "#{boom.to_s.capitalize}."
42
- # end
26
+ if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
27
+ s.add_runtime_dependency(%q<text-format>, [">= 1.0.0"])
28
+ s.add_runtime_dependency(%q<highline>, ["~> 1.5.1"])
29
+ else
30
+ s.add_dependency(%q<text-format>, [">= 1.0.0"])
31
+ s.add_dependency(%q<highline>, ["~> 1.5.1"])
32
+ end
33
+ else
34
+ s.add_dependency(%q<text-format>, [">= 1.0.0"])
35
+ s.add_dependency(%q<highline>, ["~> 1.5.1"])
36
+ end
37
+ end
@@ -0,0 +1,249 @@
1
+ desc "Open this repo's master branch in a web browser."
2
+ command :home do |user|
3
+ if helper.project
4
+ helper.open helper.homepage_for(user || helper.owner, 'master')
5
+ end
6
+ end
7
+
8
+ desc "Automatically set configuration info, or pass args to specify."
9
+ usage "github config [my_username] [my_repo_name]"
10
+ command :config do |user, repo|
11
+ user ||= ENV['USER']
12
+ repo ||= File.basename(FileUtils.pwd)
13
+ git "config --global github.user #{user}"
14
+ git "config github.repo #{repo}"
15
+ puts "Configured with github.user #{user}, github.repo #{repo}"
16
+ end
17
+
18
+ desc "Open this repo in a web browser."
19
+ usage "github browse [user] [branch]"
20
+ command :browse do |user, branch|
21
+ if helper.project
22
+ # if one arg given, treat it as a branch name
23
+ # unless it maches user/branch, then split it
24
+ # if two args given, treat as user branch
25
+ # if no args given, use defaults
26
+ user, branch = user.split("/", 2) if branch.nil? unless user.nil?
27
+ branch = user and user = nil if branch.nil?
28
+ user ||= helper.branch_user
29
+ branch ||= helper.branch_name
30
+ helper.open helper.homepage_for(user, branch)
31
+ end
32
+ end
33
+
34
+ desc 'Open the given user/project in a web browser'
35
+ usage 'github open [user/project]'
36
+ command :open do |arg|
37
+ helper.open "http://github.com/#{arg}"
38
+ end
39
+
40
+ desc "Info about this project."
41
+ command :info do
42
+ puts "== Info for #{helper.project}"
43
+ puts "You are #{helper.owner}"
44
+ puts "Currently tracking:"
45
+ helper.tracking.sort { |(a,),(b,)| a == helper.origin ? -1 : b == helper.origin ? 1 : a.to_s <=> b.to_s }.each do |(name,user_or_url)|
46
+ puts " - #{user_or_url} (as #{name})"
47
+ end
48
+ end
49
+
50
+ desc "Track another user's repository."
51
+ usage "github track remote [user]"
52
+ usage "github track remote [user/repo]"
53
+ usage "github track [user]"
54
+ usage "github track [user/repo]"
55
+ flags :private => "Use git@github.com: instead of git://github.com/."
56
+ flags :ssh => 'Equivalent to --private'
57
+ command :track do |remote, user|
58
+ # track remote user
59
+ # track remote user/repo
60
+ # track user
61
+ # track user/repo
62
+ user, remote = remote, nil if user.nil?
63
+ die "Specify a user to track" if user.nil?
64
+ user, repo = user.split("/", 2)
65
+ die "Already tracking #{user}" if helper.tracking?(user)
66
+ repo = @helper.project if repo.nil?
67
+ repo.chomp!(".git")
68
+ remote ||= user
69
+
70
+ if options[:private] || options[:ssh]
71
+ git "remote add #{remote} #{helper.private_url_for_user_and_repo(user, repo)}"
72
+ else
73
+ git "remote add #{remote} #{helper.public_url_for_user_and_repo(user, repo)}"
74
+ end
75
+ end
76
+
77
+ desc "Fetch all refs from a user"
78
+ command :fetch_all do |user|
79
+ GitHub.invoke(:track, user) unless helper.tracking?(user)
80
+ git "fetch #{user}"
81
+ end
82
+
83
+ desc "Fetch from a remote to a local branch."
84
+ command :fetch do |user, branch|
85
+ die "Specify a user to pull from" if user.nil?
86
+ user, branch = user.split("/", 2) if branch.nil?
87
+ branch ||= 'master'
88
+ GitHub.invoke(:track, user) unless helper.tracking?(user)
89
+
90
+ die "Unknown branch (#{branch}) specified" unless helper.remote_branch?(user, branch)
91
+ die "Unable to switch branches, your current branch has uncommitted changes" if helper.branch_dirty?
92
+
93
+ puts "Fetching #{user}/#{branch}"
94
+ git "fetch #{user} #{branch}:refs/remotes/#{user}/#{branch}"
95
+ git "update-ref refs/heads/#{user}/#{branch} refs/remotes/#{user}/#{branch}"
96
+ git_exec "checkout #{user}/#{branch}"
97
+ end
98
+
99
+ desc "Pull from a remote."
100
+ usage "github pull [user] [branch]"
101
+ flags :merge => "Automatically merge remote's changes into your master."
102
+ command :pull do |user, branch|
103
+ die "Specify a user to pull from" if user.nil?
104
+ user, branch = user.split("/", 2) if branch.nil?
105
+
106
+ if !helper.network_members(user, {}).include?(user)
107
+ git_exec "#{helper.argv.join(' ')}".strip
108
+ return
109
+ end
110
+
111
+ branch ||= 'master'
112
+ GitHub.invoke(:track, user) unless helper.tracking?(user)
113
+
114
+ die "Unable to switch branches, your current branch has uncommitted changes" if helper.branch_dirty?
115
+
116
+ if options[:merge]
117
+ git_exec "pull #{user} #{branch}"
118
+ else
119
+ puts "Switching to #{user}-#{branch}"
120
+ git "fetch #{user}"
121
+ git_exec "checkout -b #{user}/#{branch} #{user}/#{branch}"
122
+ end
123
+ end
124
+
125
+ desc "Clone a repo. Uses ssh if current user is "
126
+ usage "github clone [user] [repo] [dir]"
127
+ flags :ssh => "Clone using the git@github.com style url."
128
+ flags :search => "Search for [user|repo] and clone selected repository"
129
+ command :clone do |user, repo, dir|
130
+ die "Specify a user to pull from" if user.nil?
131
+ if options[:search]
132
+ query = [user, repo, dir].compact.join(" ")
133
+ data = JSON.parse(open("http://github.com/api/v1/json/search/#{URI.escape query}").read)
134
+ if (repos = data['repositories']) && !repos.nil? && repos.length > 0
135
+ repo_list = repos.map do |r|
136
+ { "name" => "#{r['username']}/#{r['name']}", "description" => r['description'] }
137
+ end
138
+ formatted_list = helper.format_list(repo_list).split("\n")
139
+ if user_repo = GitHub::UI.display_select_list(formatted_list)
140
+ user, repo = user_repo.strip.split('/', 2)
141
+ end
142
+ end
143
+ die "Perhaps try another search" unless user && repo
144
+ end
145
+
146
+ if user.include?('/') && !user.include?('@') && !user.include?(':')
147
+ die "Expected user/repo dir, given extra argument" if dir
148
+ (user, repo), dir = [user.split('/', 2), repo]
149
+ end
150
+
151
+ if repo
152
+ if options[:ssh] || current_user?(user)
153
+ git_exec "clone git@github.com:#{user}/#{repo}.git" + (dir ? " #{dir}" : "")
154
+ else
155
+ git_exec "clone git://github.com/#{user}/#{repo}.git" + (dir ? " #{dir}" : "")
156
+ end
157
+ else
158
+ git_exec "#{helper.argv.join(' ')}".strip
159
+ end
160
+ end
161
+
162
+ desc "Generate the text for a pull request."
163
+ usage "github pull-request [user] [branch]"
164
+ command :'pull-request' do |user, branch|
165
+ if helper.project
166
+ die "Specify a user for the pull request" if user.nil?
167
+ user, branch = user.split('/', 2) if branch.nil?
168
+ branch ||= 'master'
169
+ GitHub.invoke(:track, user) unless helper.tracking?(user)
170
+
171
+ git_exec "request-pull #{user}/#{branch} #{helper.origin}"
172
+ end
173
+ end
174
+
175
+ desc "Create a new, empty GitHub repository"
176
+ usage "github create [repo]"
177
+ flags :markdown => 'Create README.markdown'
178
+ flags :mdown => 'Create README.mdown'
179
+ flags :textile => 'Create README.textile'
180
+ flags :rdoc => 'Create README.rdoc'
181
+ flags :rst => 'Create README.rst'
182
+ flags :private => 'Create private repository'
183
+ command :create do |repo|
184
+ sh "curl -F 'repository[name]=#{repo}' -F 'repository[public]=#{!options[:private]}' -F 'login=#{github_user}' -F 'token=#{github_token}' http://github.com/repositories"
185
+ mkdir repo
186
+ cd repo
187
+ git "init"
188
+ extension = options.keys.first
189
+ touch extension ? "README.#{extension}" : "README"
190
+ git "add *"
191
+ git "commit -m 'First commit!'"
192
+ git "remote add origin git@github.com:#{github_user}/#{repo}.git"
193
+ git_exec "push origin master"
194
+ end
195
+
196
+ desc "Forks a GitHub repository"
197
+ usage "github fork"
198
+ usage "github fork [user]/[repo]"
199
+ command :fork do |user, repo|
200
+ if repo.nil?
201
+ if user
202
+ user, repo = user.split('/')
203
+ else
204
+ unless helper.remotes.empty?
205
+ is_repo = true
206
+ user = helper.owner
207
+ repo = helper.project
208
+ else
209
+ die "Specify a user/project to fork, or run from within a repo"
210
+ end
211
+ end
212
+ end
213
+
214
+ sh "curl -F 'login=#{github_user}' -F 'token=#{github_token}' http://github.com/#{user}/#{repo}/fork"
215
+
216
+ url = "git@github.com:#{github_user}/#{repo}.git"
217
+ if is_repo
218
+ git "config remote.origin.url #{url}"
219
+ puts "#{user}/#{repo} forked"
220
+ else
221
+ puts "Giving GitHub a moment to create the fork..."
222
+ sleep 3
223
+ git_exec "clone #{url}"
224
+ end
225
+ end
226
+
227
+ desc "Create a new GitHub repository from the current local repository"
228
+ flags :private => 'Create private repository'
229
+ command :'create-from-local' do
230
+ cwd = sh "pwd"
231
+ repo = File.basename(cwd)
232
+ is_repo = !git("status").match(/fatal/)
233
+ raise "Not a git repository. Use gh create instead" unless is_repo
234
+ sh "curl -F 'repository[name]=#{repo}' -F 'repository[public]=#{!options[:private].inspect} -F 'login=#{github_user}' -F 'token=#{github_token}' http://github.com/repositories"
235
+ git "remote add origin git@github.com:#{github_user}/#{repo}.git"
236
+ git_exec "push origin master"
237
+ end
238
+
239
+ desc "Search GitHub for the given repository name."
240
+ usage "github search [query]"
241
+ command :search do |query|
242
+ die "Usage: github search [query]" if query.nil?
243
+ data = JSON.parse(open("http://github.com/api/v1/json/search/#{URI.escape query}").read)
244
+ if (repos = data['repositories']) && !repos.nil? && repos.length > 0
245
+ puts repos.map { |r| "#{r['username']}/#{r['name']}"}.sort.uniq
246
+ else
247
+ puts "No results found"
248
+ end
249
+ end