git-topic 0.1.6.3 → 0.1.6.4

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 (57) hide show
  1. data/.autotest +10 -0
  2. data/.vimrc +21 -1
  3. data/Gemfile +2 -0
  4. data/Gemfile.lock +2 -0
  5. data/Rakefile +4 -11
  6. data/VERSION.yml +1 -1
  7. data/bin/git-topic +1 -165
  8. data/git-topic +13 -0
  9. data/git-topic.gemspec +52 -6
  10. data/lib/git_topic/cli.rb +171 -0
  11. data/lib/git_topic/git.rb +13 -3
  12. data/lib/git_topic/naming.rb +16 -8
  13. data/lib/git_topic.rb +15 -9
  14. data/lib/tasks/annotations.rake +20 -0
  15. data/spec/git_topic_spec.rb +107 -6
  16. data/spec/template/origin/ORIG_HEAD +1 -0
  17. data/spec/template/origin/RENAMED-REF +1 -0
  18. data/spec/template/origin/objects/2d/a16986c7f742f808a3a3e68108bd2e4dae009d +0 -0
  19. data/spec/template/origin/objects/65/3d7112dadcacaaae6390612eac58c234f92b18 +2 -0
  20. data/spec/template/origin/objects/dd/26afde91bbae18e13e4df1cd1da56a75ccc665 +0 -0
  21. data/spec/template/origin/refs/heads/rejected/{davidjh → USER}/krakens +0 -0
  22. data/spec/template/origin/refs/heads/review/{davidjh → USER}/pirates +0 -0
  23. data/spec/template/origin/refs/heads/wip/USER/pirates-advanced +1 -0
  24. data/spec/template/origin/refs/heads/wip/USER/zombie-basic +1 -0
  25. data/spec/template/origin/refs/heads/wip/prevent-ff +1 -0
  26. data/spec/template/origin-fresh/HEAD +1 -0
  27. data/spec/template/origin-fresh/RENAMED-REF +1 -0
  28. data/spec/template/origin-fresh/config +7 -0
  29. data/spec/template/origin-fresh/description +1 -0
  30. data/spec/template/origin-fresh/hooks/applypatch-msg.sample +15 -0
  31. data/spec/template/origin-fresh/hooks/commit-msg.sample +24 -0
  32. data/spec/template/origin-fresh/hooks/post-commit.sample +8 -0
  33. data/spec/template/origin-fresh/hooks/post-receive.sample +15 -0
  34. data/spec/template/origin-fresh/hooks/post-update.sample +8 -0
  35. data/spec/template/origin-fresh/hooks/pre-applypatch.sample +14 -0
  36. data/spec/template/origin-fresh/hooks/pre-commit.sample +46 -0
  37. data/spec/template/origin-fresh/hooks/pre-rebase.sample +169 -0
  38. data/spec/template/origin-fresh/hooks/prepare-commit-msg.sample +36 -0
  39. data/spec/template/origin-fresh/hooks/update.sample +128 -0
  40. data/spec/template/origin-fresh/info/exclude +6 -0
  41. data/spec/template/origin-fresh/objects/0a/da6d051b94cd0df50f5a0b7229aec26f0d2cdf +0 -0
  42. data/spec/template/origin-fresh/objects/0c/e06c616769768f09f5e629cfcc68eabe3dee81 +0 -0
  43. data/spec/template/origin-fresh/objects/20/049991cdafdce826f5a3c01e10ffa84d6997ec +0 -0
  44. data/spec/template/origin-fresh/objects/33/1d827fd47fb234af54e3a4bbf8c6705e9116cc +3 -0
  45. data/spec/template/origin-fresh/objects/41/51899b742fd6b1c873b177b9d13451682089bc +0 -0
  46. data/spec/template/origin-fresh/objects/44/ffd9c9c8b52b201659e3ad318cdad6ec836b46 +0 -0
  47. data/spec/template/origin-fresh/objects/4b/825dc642cb6eb9a060e54bf8d69288fbee4904 +0 -0
  48. data/spec/template/origin-fresh/objects/55/eeb01bdf874d1a35870bcf24a970c475c63344 +0 -0
  49. data/spec/template/origin-fresh/objects/8d/09f9b8d80ce282218125cb0cbf53cccf022203 +0 -0
  50. data/spec/template/origin-fresh/objects/b4/8e68d5cac189af36abe48e893d11c24b7b2a19 +0 -0
  51. data/spec/template/origin-fresh/objects/c0/838ed2ee8f2e83c8bda859fc5e332b92f0a5a3 +1 -0
  52. data/spec/template/origin-fresh/objects/cd/f7b9dbc4911a0d1404db54cde2ed448f6a6afd +0 -0
  53. data/spec/template/origin-fresh/objects/d2/6b33daea1ed9823a189992bba38fbc913483c1 +0 -0
  54. data/spec/template/origin-fresh/objects/fe/4e254557e19f338f40ccfdc00a7517771db880 +0 -0
  55. data/spec/template/origin-fresh/refs/heads/master +1 -0
  56. data/spec/template/origin-fresh/refs/heads/wip/USER/zombie-basic +1 -0
  57. metadata +61 -5
data/lib/git_topic.rb CHANGED
@@ -43,22 +43,28 @@ module GitTopic
43
43
  # Done with the given topic. If none is specified, then topic is assumed to
44
44
  # be the current branch (if it's a topic branch).
45
45
  def done( topic=nil, opts={} )
46
- raise(
47
- "Branch must be a topic branch"
48
- ) unless current_branch =~ %r{^wip/}
49
- raise(
50
- "Working tree must be clean"
51
- ) unless working_tree_clean?
46
+ if topic.nil?
47
+ raise "
48
+ Current branch is not a topic branch. Switch to a topic branch or
49
+ supply an argument.
50
+ ".oneline if current_topic.nil?
51
+
52
+ topic = current_topic
53
+ else
54
+ raise "
55
+ Specified topic #{topic} does not refer to a topic branch.
56
+ " unless branches.include? wip_branch( topic )
57
+ end
58
+ raise "Working tree must be clean" unless working_tree_clean?
52
59
 
53
- topic = current_topic if topic.nil?
54
60
 
55
61
  wb = wip_branch( topic )
56
62
  rb = review_branch( topic )
57
63
  git [
58
64
  "push origin #{wb}:#{rb} :#{wb}",
59
- "checkout master",
65
+ ("checkout master" if strip_namespace( topic ) == current_topic),
60
66
  "branch -D #{wip_branch( topic )}"
61
- ]
67
+ ].compact
62
68
  end
63
69
 
64
70
  # Produce status like
@@ -0,0 +1,20 @@
1
+ require 'rails/source_annotation_extractor'
2
+
3
+ desc "Enumerate all annotations (use notes:optimize, :fixme, :todo for focus)"
4
+ task :notes do
5
+ SourceAnnotationExtractor.enumerate "OPTIMIZE|FIXME|TODO", :tag => true
6
+ end
7
+
8
+ namespace :notes do
9
+ ["OPTIMIZE", "FIXME", "TODO"].each do |annotation|
10
+ # desc "Enumerate all #{annotation} annotations"
11
+ task annotation.downcase.intern do
12
+ SourceAnnotationExtractor.enumerate annotation
13
+ end
14
+ end
15
+
16
+ desc "Enumerate a custom annotation, specify with ANNOTATION=CUSTOM"
17
+ task :custom do
18
+ SourceAnnotationExtractor.enumerate ENV['ANNOTATION']
19
+ end
20
+ end
@@ -15,9 +15,15 @@ describe GitTopic do
15
15
  FileUtils.rm_rf './tmp'
16
16
  FileUtils.mkdir './tmp'
17
17
 
18
- %w(fresh in-progress origin).each do |repo|
19
- FileUtils.cp_r "spec/template/#{repo}", './tmp'
18
+ # Copy our repos into tmp
19
+ %w(fresh in-progress).each do |d|
20
+ FileUtils.mkdir "./tmp/#{d}"
21
+ FileUtils.cp_r "spec/template/#{d}", "./tmp/#{d}/.git"
22
+ end
23
+ FileUtils.cp_r "spec/template/origin", './tmp'
24
+ FileUtils.cp_r "spec/template/origin-fresh", './tmp'
20
25
 
26
+ %w(origin origin-fresh fresh in-progress).each do |repo|
21
27
  # set template branches to their proper name (i.e. matching @user)
22
28
  Dir.chdir "./tmp/#{repo}"
23
29
  git_branches.each do |orig_name|
@@ -25,6 +31,7 @@ describe GitTopic do
25
31
  system(
26
32
  "git branch -m #{orig_name} #{new_name}"
27
33
  ) unless orig_name == new_name
34
+ system "git fetch --prune > /dev/null 2> /dev/null"
28
35
  end
29
36
  Dir.chdir @starting_dir
30
37
  end
@@ -91,14 +98,28 @@ describe GitTopic do
91
98
  end
92
99
 
93
100
  # }}}
94
-
95
101
 
96
102
  describe "#work_on" do
97
103
 
104
+ share_examples_for "#work_on general cases" do
105
+
106
+ it "
107
+ should trim namespaces from args and output a warning
108
+ ".oneline do
109
+
110
+ git_branch.should_not == "wip/davidjh/topic"
111
+ GitTopic.work_on "wip/#{@user}/topic"
112
+ git_branch.should == "wip/davidjh/topic"
113
+ end
114
+
115
+ end
116
+
98
117
  describe "in fresh" do
99
118
  before( :each ) { use_repo( 'fresh' )}
100
119
  after( :each ) { Dir.chdir( '..' )}
101
120
 
121
+ it_should_behave_like "#work_on general cases"
122
+
102
123
  it "
103
124
  should create (and switch to) a new branch with a name that matches the
104
125
  given topic, in the wip namespace. A remote tracking branch should also
@@ -122,6 +143,7 @@ describe GitTopic do
122
143
  before( :each ) { use_repo( 'in-progress' )}
123
144
  after( :each ) { Dir.chdir( '..' )}
124
145
 
146
+ it_should_behave_like "#work_on general cases"
125
147
 
126
148
  it "should switch to (rather than create) an existing topic branch" do
127
149
  git_branches.should include( "wip/#{@user}/zombie-basic" )
@@ -142,9 +164,25 @@ describe GitTopic do
142
164
  git_remote_branches.should include( "wip/#{@user}/krakens" )
143
165
  git_head.should == '44ffd9c9c8b52b201659e3ad318cdad6ec836b46'
144
166
  end
167
+
168
+ it "
169
+ should use (and then destroy) the review branch for the topic, if one
170
+ exists
171
+ ".oneline do
172
+
173
+ git_remote_branches.should include( "rejected/#{@user}/krakens" )
174
+ GitTopic.work_on 'krakens'
175
+ git_branch.should == "wip/#{@user}/krakens"
176
+ git_remote_branches.should_not include( "rejected/#{@user}/krakens" )
177
+ git_remote_branches.should include( "wip/#{@user}/krakens" )
178
+ git_head.should == '44ffd9c9c8b52b201659e3ad318cdad6ec836b46'
179
+ end
180
+
145
181
  end
146
- end
182
+
183
+ pending "with no origin"
147
184
 
185
+ end
148
186
 
149
187
  describe "#done" do
150
188
 
@@ -185,6 +223,53 @@ describe GitTopic do
185
223
  end
186
224
  end
187
225
 
226
+ describe "with an argument" do
227
+
228
+ it "should fail for non-wip branch arguments" do
229
+ git_branches.should_not include( "wip/#{@user}/invalid-branch" )
230
+ lambda{ GitTopic.done( 'invalid-branch' )}.should raise_error
231
+ end
232
+
233
+ it "should succeed for superfluous wip-branch arguments" do
234
+ git_branches.should include( "wip/#{@user}/zombie-basic" )
235
+ git_remote_branches.should_not include( "review/#{@user}/zombie-basic" )
236
+ GitTopic.work_on 'zombie-basic'
237
+ GitTopic.done( 'zombie-basic' )
238
+
239
+ git_branches.should_not include( "wip/#{@user}/zombie-basic" )
240
+ git_remote_branches.should include( "review/#{@user}/zombie-basic" )
241
+ git_remote_branches.should_not include( "wip/#{@user}/zombie-basic" )
242
+ git_branch.should == 'master'
243
+ end
244
+
245
+ it "
246
+ should succeed for wip-branch arguments, and leave the user on the
247
+ same branch
248
+ ".oneline do
249
+ git_branches.should include( "wip/#{@user}/pirates-advanced" )
250
+ git_branches.should include( "wip/#{@user}/zombie-basic" )
251
+ git_remote_branches.should_not include( "review/#{@user}/zombie-basic" )
252
+
253
+ GitTopic.work_on 'pirates-advanced'
254
+ GitTopic.done 'zombie-basic'
255
+
256
+ git_branch.should == "wip/#{@user}/pirates-advanced"
257
+ git_branches.should_not include( "wip/#{@user}/zombie-basic" )
258
+ git_remote_branches.should include( "review/#{@user}/zombie-basic" )
259
+ git_remote_branches.should_not include( "wip/#{@user}/zombie-basic" )
260
+ end
261
+
262
+ it "should succeed for fully-qualified wip-branch arguments" do
263
+ git_branches.should include( "wip/#{@user}/zombie-basic" )
264
+ git_remote_branches.should_not include( "review/#{@user}/zombie-basic" )
265
+ GitTopic.done( "wip/#{@user}/zombie-basic" )
266
+
267
+ git_branches.should_not include( "wip/#{@user}/zombie-basic" )
268
+ git_remote_branches.should include( "review/#{@user}/zombie-basic" )
269
+ git_remote_branches.should_not include( "wip/#{@user}/zombie-basic" )
270
+ git_branch.should == 'master'
271
+ end
272
+ end
188
273
  end
189
274
  end
190
275
 
@@ -227,6 +312,9 @@ describe GitTopic do
227
312
  @output.should =~ /# On branch master/
228
313
  end
229
314
  end
315
+
316
+ pending "with useless args"
317
+
230
318
  end
231
319
 
232
320
  describe "#review" do
@@ -250,7 +338,7 @@ describe GitTopic do
250
338
  after( :each ) { Dir.chdir '..' }
251
339
 
252
340
  it "
253
- should create a local tracking branch for the most recent remote review
341
+ should create a local tracking branch for the oldest remote review
254
342
  branch if none was specified
255
343
  " do
256
344
 
@@ -284,6 +372,11 @@ describe GitTopic do
284
372
  lambda{ GitTopic.review( 'fakeuser/faketopic' )}.should raise_error
285
373
  end
286
374
  end
375
+
376
+ pending "with non-branch arg"
377
+ pending "with non-review-branch arg"
378
+ pending "with my-review-branch arg"
379
+
287
380
  end
288
381
 
289
382
  describe "#accept" do
@@ -318,7 +411,7 @@ describe GitTopic do
318
411
  use_repo 'in-progress'
319
412
  system "
320
413
  git checkout master > /dev/null 2> /dev/null &&
321
- git merge wip/prevent-ff > /dev/null 2> /dev/null
414
+ git merge origin/wip/prevent-ff > /dev/null 2> /dev/null
322
415
  "
323
416
  @original_git_Head = git_head
324
417
  GitTopic.review 'user24601/zombie-basic'
@@ -345,6 +438,8 @@ describe GitTopic do
345
438
  end
346
439
  end
347
440
 
441
+ pending "with an arg"
442
+
348
443
  end
349
444
 
350
445
  describe "#reject" do
@@ -380,6 +475,9 @@ describe GitTopic do
380
475
  lambda{ GitTopic.reject }.should raise_error
381
476
  end
382
477
  end
478
+
479
+ pending "with an arg"
480
+
383
481
  end
384
482
 
385
483
 
@@ -396,6 +494,9 @@ describe GitTopic do
396
494
  git_config( 'alias.r' ).should == 'topic review'
397
495
  git_config( 'alias.st' ).should == 'topic status --prepended'
398
496
  end
497
+
498
+ pending "with an arg"
499
+
399
500
  end
400
501
  end
401
502
 
@@ -0,0 +1 @@
1
+ 0ce06c616769768f09f5e629cfcc68eabe3dee81
@@ -0,0 +1 @@
1
+ 331d827fd47fb234af54e3a4bbf8c6705e9116cc
@@ -0,0 +1,2 @@
1
+ x��M
2
+ �0@a�9�\��?�D\H�a����H�=�� n���Z��@}h+3hB�������d@��]P2D�l Yʞ�W^�(h������O�
@@ -0,0 +1 @@
1
+ 331d827fd47fb234af54e3a4bbf8c6705e9116cc
@@ -0,0 +1 @@
1
+ 331d827fd47fb234af54e3a4bbf8c6705e9116cc
@@ -0,0 +1 @@
1
+ 653d7112dadcacaaae6390612eac58c234f92b18
@@ -0,0 +1 @@
1
+ ref: refs/heads/master
@@ -0,0 +1 @@
1
+ 331d827fd47fb234af54e3a4bbf8c6705e9116cc
@@ -0,0 +1,7 @@
1
+ [core]
2
+ repositoryformatversion = 0
3
+ filemode = true
4
+ bare = true
5
+ sharedrepository = 1
6
+ [receive]
7
+ denyNonFastforwards = true
@@ -0,0 +1 @@
1
+ Unnamed repository; edit this file 'description' to name the repository.
@@ -0,0 +1,15 @@
1
+ #!/bin/sh
2
+ #
3
+ # An example hook script to check the commit log message taken by
4
+ # applypatch from an e-mail message.
5
+ #
6
+ # The hook should exit with non-zero status after issuing an
7
+ # appropriate message if it wants to stop the commit. The hook is
8
+ # allowed to edit the commit message file.
9
+ #
10
+ # To enable this hook, rename this file to "applypatch-msg".
11
+
12
+ . git-sh-setup
13
+ test -x "$GIT_DIR/hooks/commit-msg" &&
14
+ exec "$GIT_DIR/hooks/commit-msg" ${1+"$@"}
15
+ :
@@ -0,0 +1,24 @@
1
+ #!/bin/sh
2
+ #
3
+ # An example hook script to check the commit log message.
4
+ # Called by git-commit with one argument, the name of the file
5
+ # that has the commit message. The hook should exit with non-zero
6
+ # status after issuing an appropriate message if it wants to stop the
7
+ # commit. The hook is allowed to edit the commit message file.
8
+ #
9
+ # To enable this hook, rename this file to "commit-msg".
10
+
11
+ # Uncomment the below to add a Signed-off-by line to the message.
12
+ # Doing this in a hook is a bad idea in general, but the prepare-commit-msg
13
+ # hook is more suited to it.
14
+ #
15
+ # SOB=$(git var GIT_AUTHOR_IDENT | sed -n 's/^\(.*>\).*$/Signed-off-by: \1/p')
16
+ # grep -qs "^$SOB" "$1" || echo "$SOB" >> "$1"
17
+
18
+ # This example catches duplicate Signed-off-by lines.
19
+
20
+ test "" = "$(grep '^Signed-off-by: ' "$1" |
21
+ sort | uniq -c | sed -e '/^[ ]*1[ ]/d')" || {
22
+ echo >&2 Duplicate Signed-off-by lines.
23
+ exit 1
24
+ }
@@ -0,0 +1,8 @@
1
+ #!/bin/sh
2
+ #
3
+ # An example hook script that is called after a successful
4
+ # commit is made.
5
+ #
6
+ # To enable this hook, rename this file to "post-commit".
7
+
8
+ : Nothing
@@ -0,0 +1,15 @@
1
+ #!/bin/sh
2
+ #
3
+ # An example hook script for the "post-receive" event.
4
+ #
5
+ # The "post-receive" script is run after receive-pack has accepted a pack
6
+ # and the repository has been updated. It is passed arguments in through
7
+ # stdin in the form
8
+ # <oldrev> <newrev> <refname>
9
+ # For example:
10
+ # aa453216d1b3e49e7f6f98441fa56946ddcd6a20 68f7abf4e6f922807889f52bc043ecd31b79f814 refs/heads/master
11
+ #
12
+ # see contrib/hooks/ for a sample, or uncomment the next line and
13
+ # rename the file to "post-receive".
14
+
15
+ #. /usr/share/doc/git-core/contrib/hooks/post-receive-email
@@ -0,0 +1,8 @@
1
+ #!/bin/sh
2
+ #
3
+ # An example hook script to prepare a packed repository for use over
4
+ # dumb transports.
5
+ #
6
+ # To enable this hook, rename this file to "post-update".
7
+
8
+ exec git-update-server-info
@@ -0,0 +1,14 @@
1
+ #!/bin/sh
2
+ #
3
+ # An example hook script to verify what is about to be committed
4
+ # by applypatch from an e-mail message.
5
+ #
6
+ # The hook should exit with non-zero status after issuing an
7
+ # appropriate message if it wants to stop the commit.
8
+ #
9
+ # To enable this hook, rename this file to "pre-applypatch".
10
+
11
+ . git-sh-setup
12
+ test -x "$GIT_DIR/hooks/pre-commit" &&
13
+ exec "$GIT_DIR/hooks/pre-commit" ${1+"$@"}
14
+ :
@@ -0,0 +1,46 @@
1
+ #!/bin/sh
2
+ #
3
+ # An example hook script to verify what is about to be committed.
4
+ # Called by git-commit with no arguments. The hook should
5
+ # exit with non-zero status after issuing an appropriate message if
6
+ # it wants to stop the commit.
7
+ #
8
+ # To enable this hook, rename this file to "pre-commit".
9
+
10
+ if git-rev-parse --verify HEAD >/dev/null 2>&1
11
+ then
12
+ against=HEAD
13
+ else
14
+ # Initial commit: diff against an empty tree object
15
+ against=4b825dc642cb6eb9a060e54bf8d69288fbee4904
16
+ fi
17
+
18
+ # If you want to allow non-ascii filenames set this variable to true.
19
+ allownonascii=$(git config hooks.allownonascii)
20
+
21
+ # Cross platform projects tend to avoid non-ascii filenames; prevent
22
+ # them from being added to the repository. We exploit the fact that the
23
+ # printable range starts at the space character and ends with tilde.
24
+ if [ "$allownonascii" != "true" ] &&
25
+ # Note that the use of brackets around a tr range is ok here, (it's
26
+ # even required, for portability to Solaris 10's /usr/bin/tr), since
27
+ # the square bracket bytes happen to fall in the designated range.
28
+ test "$(git diff --cached --name-only --diff-filter=A -z $against |
29
+ LC_ALL=C tr -d '[ -~]\0')"
30
+ then
31
+ echo "Error: Attempt to add a non-ascii file name."
32
+ echo
33
+ echo "This can cause problems if you want to work"
34
+ echo "with people on other platforms."
35
+ echo
36
+ echo "To be portable it is advisable to rename the file ..."
37
+ echo
38
+ echo "If you know what you are doing you can disable this"
39
+ echo "check using:"
40
+ echo
41
+ echo " git config hooks.allownonascii true"
42
+ echo
43
+ exit 1
44
+ fi
45
+
46
+ exec git diff-index --check --cached $against --
@@ -0,0 +1,169 @@
1
+ #!/bin/sh
2
+ #
3
+ # Copyright (c) 2006, 2008 Junio C Hamano
4
+ #
5
+ # The "pre-rebase" hook is run just before "git-rebase" starts doing
6
+ # its job, and can prevent the command from running by exiting with
7
+ # non-zero status.
8
+ #
9
+ # The hook is called with the following parameters:
10
+ #
11
+ # $1 -- the upstream the series was forked from.
12
+ # $2 -- the branch being rebased (or empty when rebasing the current branch).
13
+ #
14
+ # This sample shows how to prevent topic branches that are already
15
+ # merged to 'next' branch from getting rebased, because allowing it
16
+ # would result in rebasing already published history.
17
+
18
+ publish=next
19
+ basebranch="$1"
20
+ if test "$#" = 2
21
+ then
22
+ topic="refs/heads/$2"
23
+ else
24
+ topic=`git symbolic-ref HEAD` ||
25
+ exit 0 ;# we do not interrupt rebasing detached HEAD
26
+ fi
27
+
28
+ case "$topic" in
29
+ refs/heads/??/*)
30
+ ;;
31
+ *)
32
+ exit 0 ;# we do not interrupt others.
33
+ ;;
34
+ esac
35
+
36
+ # Now we are dealing with a topic branch being rebased
37
+ # on top of master. Is it OK to rebase it?
38
+
39
+ # Does the topic really exist?
40
+ git show-ref -q "$topic" || {
41
+ echo >&2 "No such branch $topic"
42
+ exit 1
43
+ }
44
+
45
+ # Is topic fully merged to master?
46
+ not_in_master=`git-rev-list --pretty=oneline ^master "$topic"`
47
+ if test -z "$not_in_master"
48
+ then
49
+ echo >&2 "$topic is fully merged to master; better remove it."
50
+ exit 1 ;# we could allow it, but there is no point.
51
+ fi
52
+
53
+ # Is topic ever merged to next? If so you should not be rebasing it.
54
+ only_next_1=`git-rev-list ^master "^$topic" ${publish} | sort`
55
+ only_next_2=`git-rev-list ^master ${publish} | sort`
56
+ if test "$only_next_1" = "$only_next_2"
57
+ then
58
+ not_in_topic=`git-rev-list "^$topic" master`
59
+ if test -z "$not_in_topic"
60
+ then
61
+ echo >&2 "$topic is already up-to-date with master"
62
+ exit 1 ;# we could allow it, but there is no point.
63
+ else
64
+ exit 0
65
+ fi
66
+ else
67
+ not_in_next=`git-rev-list --pretty=oneline ^${publish} "$topic"`
68
+ perl -e '
69
+ my $topic = $ARGV[0];
70
+ my $msg = "* $topic has commits already merged to public branch:\n";
71
+ my (%not_in_next) = map {
72
+ /^([0-9a-f]+) /;
73
+ ($1 => 1);
74
+ } split(/\n/, $ARGV[1]);
75
+ for my $elem (map {
76
+ /^([0-9a-f]+) (.*)$/;
77
+ [$1 => $2];
78
+ } split(/\n/, $ARGV[2])) {
79
+ if (!exists $not_in_next{$elem->[0]}) {
80
+ if ($msg) {
81
+ print STDERR $msg;
82
+ undef $msg;
83
+ }
84
+ print STDERR " $elem->[1]\n";
85
+ }
86
+ }
87
+ ' "$topic" "$not_in_next" "$not_in_master"
88
+ exit 1
89
+ fi
90
+
91
+ exit 0
92
+
93
+ ################################################################
94
+
95
+ This sample hook safeguards topic branches that have been
96
+ published from being rewound.
97
+
98
+ The workflow assumed here is:
99
+
100
+ * Once a topic branch forks from "master", "master" is never
101
+ merged into it again (either directly or indirectly).
102
+
103
+ * Once a topic branch is fully cooked and merged into "master",
104
+ it is deleted. If you need to build on top of it to correct
105
+ earlier mistakes, a new topic branch is created by forking at
106
+ the tip of the "master". This is not strictly necessary, but
107
+ it makes it easier to keep your history simple.
108
+
109
+ * Whenever you need to test or publish your changes to topic
110
+ branches, merge them into "next" branch.
111
+
112
+ The script, being an example, hardcodes the publish branch name
113
+ to be "next", but it is trivial to make it configurable via
114
+ $GIT_DIR/config mechanism.
115
+
116
+ With this workflow, you would want to know:
117
+
118
+ (1) ... if a topic branch has ever been merged to "next". Young
119
+ topic branches can have stupid mistakes you would rather
120
+ clean up before publishing, and things that have not been
121
+ merged into other branches can be easily rebased without
122
+ affecting other people. But once it is published, you would
123
+ not want to rewind it.
124
+
125
+ (2) ... if a topic branch has been fully merged to "master".
126
+ Then you can delete it. More importantly, you should not
127
+ build on top of it -- other people may already want to
128
+ change things related to the topic as patches against your
129
+ "master", so if you need further changes, it is better to
130
+ fork the topic (perhaps with the same name) afresh from the
131
+ tip of "master".
132
+
133
+ Let's look at this example:
134
+
135
+ o---o---o---o---o---o---o---o---o---o "next"
136
+ / / / /
137
+ / a---a---b A / /
138
+ / / / /
139
+ / / c---c---c---c B /
140
+ / / / \ /
141
+ / / / b---b C \ /
142
+ / / / / \ /
143
+ ---o---o---o---o---o---o---o---o---o---o---o "master"
144
+
145
+
146
+ A, B and C are topic branches.
147
+
148
+ * A has one fix since it was merged up to "next".
149
+
150
+ * B has finished. It has been fully merged up to "master" and "next",
151
+ and is ready to be deleted.
152
+
153
+ * C has not merged to "next" at all.
154
+
155
+ We would want to allow C to be rebased, refuse A, and encourage
156
+ B to be deleted.
157
+
158
+ To compute (1):
159
+
160
+ git-rev-list ^master ^topic next
161
+ git-rev-list ^master next
162
+
163
+ if these match, topic has not merged in next at all.
164
+
165
+ To compute (2):
166
+
167
+ git-rev-list master..topic
168
+
169
+ if this is empty, it is fully merged to "master".
@@ -0,0 +1,36 @@
1
+ #!/bin/sh
2
+ #
3
+ # An example hook script to prepare the commit log message.
4
+ # Called by git-commit with the name of the file that has the
5
+ # commit message, followed by the description of the commit
6
+ # message's source. The hook's purpose is to edit the commit
7
+ # message file. If the hook fails with a non-zero status,
8
+ # the commit is aborted.
9
+ #
10
+ # To enable this hook, rename this file to "prepare-commit-msg".
11
+
12
+ # This hook includes three examples. The first comments out the
13
+ # "Conflicts:" part of a merge commit.
14
+ #
15
+ # The second includes the output of "git diff --name-status -r"
16
+ # into the message, just before the "git status" output. It is
17
+ # commented because it doesn't cope with --amend or with squashed
18
+ # commits.
19
+ #
20
+ # The third example adds a Signed-off-by line to the message, that can
21
+ # still be edited. This is rarely a good idea.
22
+
23
+ case "$2,$3" in
24
+ merge,)
25
+ perl -i.bak -ne 's/^/# /, s/^# #/#/ if /^Conflicts/ .. /#/; print' "$1" ;;
26
+
27
+ # ,|template,)
28
+ # perl -i.bak -pe '
29
+ # print "\n" . `git diff --cached --name-status -r`
30
+ # if /^#/ && $first++ == 0' "$1" ;;
31
+
32
+ *) ;;
33
+ esac
34
+
35
+ # SOB=$(git var GIT_AUTHOR_IDENT | sed -n 's/^\(.*>\).*$/Signed-off-by: \1/p')
36
+ # grep -qs "^$SOB" "$1" || echo "$SOB" >> "$1"