tests/test-userguide.t
author Boris Feld <boris.feld@octobus.net>
Fri, 22 Nov 2019 18:56:42 +0100
changeset 5226 38d225efcea9
parent 4624 c9798965b1f4
child 4674 3810ca63398f
permissions -rw-r--r--
tutorial: compile the tutorial in rst so it can be included

ensure that all the scenarios in the user guide work as documented

basic repo
  $ hg init t
  $ cd t
  $ touch file1.c file2.c
  $ hg -q commit -A -m init

example 1: commit creates a changeset in draft phase
(this is nothing to do with evolve, but it's mentioned in the user guide)
  $ echo 'feature Y' >> file1.c
  $ hg commit -u alice -d '0 0' -m 'implement feature X'
  $ hg phase -r .
  1: draft
  $ hg identify -in
  6e725fd2be6f 1

example 2: unsafe amend with plain vanilla Mercurial: the original
commit is stripped
  $ hg commit --amend -u alice -d '1 0' -m 'implement feature Y'
  saved backup bundle to $TESTTMP/t/.hg/strip-backup/6e725fd2be6f-42cc74d4-amend.hg (glob)
  $ hg log -r 23fe4ac6d3f1
  abort: unknown revision '23fe4ac6d3f1'!
  [255]
  $ hg identify -in
  fe0ecd3bd2a4 1

enable evolve for safe history modification
  $ cat >> $HGRCPATH <<EOF
  > [alias]
  > shortlog = log --template '{rev}:{node|short}  {phase}  {desc|firstline}\n'
  > [extensions]
  > rebase =
  > EOF
  $ echo "evolve=$(echo $(dirname $TESTDIR))/hgext3rd/evolve/" >> $HGRCPATH

example 3: safe amend with "hg commit --amend" (figure 2)
  $ echo 'tweak feature Y' >> file1.c
  $ hg commit --amend -u alice -d '2 0' -m 'implement feature Y'
  $ hg shortlog -q -r fe0ecd3bd2a4
  abort: hidden revision 'fe0ecd3bd2a4' was rewritten as: 934359450037!
  (use --hidden to access hidden revisions)
  [255]
  $ hg --hidden shortlog -G
  @  2:934359450037  draft  implement feature Y
  |
  | x  1:fe0ecd3bd2a4  draft  implement feature Y
  |/
  o  0:08c4b6f4efc8  draft  init
  
example 3 redux: repeat safe amend, this time with "hg amend"
  $ hg rollback -q
  $ hg amend -u alice -d '2 0' -m 'implement feature Y'
  $ hg --hidden shortlog -G
  @  2:934359450037  draft  implement feature Y
  |
  | x  1:fe0ecd3bd2a4  draft  implement feature Y
  |/
  o  0:08c4b6f4efc8  draft  init
  
example 4: prune at head (figure 3)
  $ echo 'debug hack' >> file1.c
  $ hg commit -m 'debug hack'
  $ hg prune .
  1 files updated, 0 files merged, 0 files removed, 0 files unresolved
  working directory is now at 934359450037
  1 changesets pruned
  $ hg parents --template '{rev}:{node|short}  {desc|firstline}\n'
  2:934359450037  implement feature Y
  $ hg --hidden shortlog -G -r 934359450037:
  x  3:a3e0ef24aaf0  draft  debug hack
  |
  @  2:934359450037  draft  implement feature Y
  |
  ~

example 5: uncommit files at head (figure 4)
  $ echo 'relevant' >> file1.c
  $ echo 'irrelevant' >> file2.c
  $ hg commit -u dan -d '10 0' -m 'fix bug 234'
  $ hg uncommit file2.c
  $ hg status
  M file2.c
  $ hg --hidden shortlog -G -r 'descendants(934359450037) - a3e0ef24aaf0'
  @  5:c8defeecf7a4  draft  fix bug 234
  |
  | x  4:da4331967f5f  draft  fix bug 234
  |/
  o  2:934359450037  draft  implement feature Y
  |
  ~
  $ hg parents --template '{rev}:{node|short}  {desc|firstline}\n{files}\n'
  5:c8defeecf7a4  fix bug 234
  file1.c
  $ hg revert --no-backup file2.c

example 6: fold multiple changesets together into one (figure 5)
  $ echo step1 >> file1.c
  $ hg commit -m 'step 1'
  $ echo step2 >> file1.c
  $ hg commit -m 'step 2'
  $ echo step3 >> file2.c
  $ hg commit -m 'step 3'
  $ hg log --template '{rev}:{node|short}  {desc|firstline}\n' -r 05e61aab8294::
  6:05e61aab8294  step 1
  7:be6d5bc8e4cc  step 2
  8:35f432d9f7c1  step 3
  $ hg fold -d '0 0' -m 'fix bug 64' --from -r 05e61aab8294::
  3 changesets folded
  1 files updated, 0 files merged, 0 files removed, 0 files unresolved
  $ hg --hidden shortlog -G -r c8defeecf7a4::
  @  9:171c6a79a27b  draft  fix bug 64
  |
  | x  8:35f432d9f7c1  draft  step 3
  | |
  | x  7:be6d5bc8e4cc  draft  step 2
  | |
  | x  6:05e61aab8294  draft  step 1
  |/
  o  5:c8defeecf7a4  draft  fix bug 234
  |
  ~
  $ hg --hidden log -q -r 'successors(05e61aab8294) | successors(be6d5bc8e4cc) | successors(35f432d9f7c1)'
  9:171c6a79a27b
  $ hg --hidden log -q -r 'predecessors(171c6a79a27b)'
  6:05e61aab8294
  7:be6d5bc8e4cc
  8:35f432d9f7c1
  $ hg diff -c 171c6a79a27b -U 0
  diff -r c8defeecf7a4 -r 171c6a79a27b file1.c
  --- a/file1.c	Thu Jan 01 00:00:10 1970 +0000
  +++ b/file1.c	Thu Jan 01 00:00:00 1970 +0000
  @@ -3,0 +4,2 @@
  +step1
  +step2
  diff -r c8defeecf7a4 -r 171c6a79a27b file2.c
  --- a/file2.c	Thu Jan 01 00:00:10 1970 +0000
  +++ b/file2.c	Thu Jan 01 00:00:00 1970 +0000
  @@ -0,0 +1,1 @@
  +step3

setup for example 7: amend an older changeset
  $ echo 'fix fix oops fix' > file2.c
  $ hg commit -u bob -d '3 0' -m 'fix bug 17'
  $ echo 'cleanup' >> file1.c
  $ hg commit -u bob -d '4 0' -m 'cleanup'
  $ echo 'new feature' >> file1.c
  $ hg commit -u bob -d '5 0' -m 'feature 23'
  $ hg --hidden shortlog -G -r 171c6a79a27b::
  @  12:dadcbba2d606  draft  feature 23
  |
  o  11:debd46bb29dc  draft  cleanup
  |
  o  10:3e1cb8f70c02  draft  fix bug 17
  |
  o  9:171c6a79a27b  draft  fix bug 64
  |
  ~

example 7: amend an older changeset (figures 6, 7)
  $ hg update -q -r 3e1cb8f70c02
  $ echo 'fix fix fix fix' > file2.c
  $ hg amend -u bob -d '6 0'
  2 new orphan changesets
  $ hg shortlog -r 'obsolete()'
  10:3e1cb8f70c02  draft  fix bug 17
  $ hg shortlog -r "orphan()"
  11:debd46bb29dc  draft  cleanup
  12:dadcbba2d606  draft  feature 23
  $ hg --hidden shortlog -G -r 171c6a79a27b::
  @  13:395cbeda3a06  draft  fix bug 17
  |
  | *  12:dadcbba2d606  draft  feature 23
  | |
  | *  11:debd46bb29dc  draft  cleanup
  | |
  | x  10:3e1cb8f70c02  draft  fix bug 17
  |/
  o  9:171c6a79a27b  draft  fix bug 64
  |
  ~
  $ hg evolve -q --all --update
  $ hg shortlog -G -r 171c6a79a27b::
  @  15:91b4b0f8b5c5  draft  feature 23
  |
  o  14:fe8858bd9bc2  draft  cleanup
  |
  o  13:395cbeda3a06  draft  fix bug 17
  |
  o  9:171c6a79a27b  draft  fix bug 64
  |
  ~

setup for example 8: prune an older changeset (figure 8)
  $ echo 'useful' >> file1.c
  $ hg commit -u carl -d '7 0' -m 'useful work'
  $ echo 'debug' >> file2.c
  $ hg commit -u carl -d '8 0' -m 'debug hack'
  $ echo 'more useful' >> file1.c
  $ hg commit -u carl -d '9 0' -m 'more work'
  $ hg shortlog -G -r 91b4b0f8b5c5::
  @  18:ea8fafca914b  draft  more work
  |
  o  17:b23d06b457a8  draft  debug hack
  |
  o  16:1f33e68b18b9  draft  useful work
  |
  o  15:91b4b0f8b5c5  draft  feature 23
  |
  ~

example 8: prune an older changeset (figures 8, 9)
  $ hg prune b23d06b457a8
  1 changesets pruned
  1 new orphan changesets
  $ hg --hidden shortlog -G -r b23d06b457a8::
  @  18:ea8fafca914b  draft  more work
  |
  x  17:b23d06b457a8  draft  debug hack
  |
  ~
  $ hg evolve -q --all --any --update
  $ hg --hidden shortlog -G -r 1f33e68b18b9::
  @  19:4393e5877437  draft  more work
  |
  | x  18:ea8fafca914b  draft  more work
  | |
  | x  17:b23d06b457a8  draft  debug hack
  |/
  o  16:1f33e68b18b9  draft  useful work
  |
  ~

example 9: uncommit files from an older changeset (discard changes)
(figure 10)
  $ echo 'this fixes bug 53' >> file1.c
  $ echo 'debug hack' >> file2.c
  $ hg commit -u dan -d '11 0' -m 'fix bug 53'
  $ echo 'and this handles bug 67' >> file1.c
  $ hg commit -u dan -d '12 0' -m 'fix bug 67'
  $ hg update -r f84357446753
  1 files updated, 0 files merged, 0 files removed, 0 files unresolved
  $ hg shortlog -G -r 4393e5877437::
  o  21:4db2428c8ae3  draft  fix bug 67
  |
  @  20:f84357446753  draft  fix bug 53
  |
  o  19:4393e5877437  draft  more work
  |
  ~
  $ hg uncommit file2.c
  1 new orphan changesets
  $ hg status
  M file2.c
  $ hg revert file2.c
  $ hg evolve --all --any --update
  move:[21] fix bug 67
  atop:[22] fix bug 53
  working directory is now at 0d972d6888e6
  $ hg --hidden shortlog -G -r 4393e5877437::
  @  23:0d972d6888e6  draft  fix bug 67
  |
  o  22:71bb83d674c5  draft  fix bug 53
  |
  | x  21:4db2428c8ae3  draft  fix bug 67
  | |
  | x  20:f84357446753  draft  fix bug 53
  |/
  o  19:4393e5877437  draft  more work
  |
  ~
  $ rm file2.c.orig

example 10: uncommit files from an older changeset (keep changes)
(figures 11, 12)
  $ echo 'fix a bug' >> file1.c
  $ echo 'useful but unrelated' >> file2.c
  $ hg commit -u dan -d '11 0' -m 'fix a bug'
  $ echo 'new feature' >> file1.c
  $ hg commit -u dan -d '12 0' -m 'new feature'
  $ hg update 5b31a1239ab9
  1 files updated, 0 files merged, 0 files removed, 0 files unresolved
  $ hg --hidden shortlog -G -r 0d972d6888e6::
  o  25:fbb3c6d50427  draft  new feature
  |
  @  24:5b31a1239ab9  draft  fix a bug
  |
  o  23:0d972d6888e6  draft  fix bug 67
  |
  ~
  $ hg uncommit file2.c
  1 new orphan changesets
  $ hg status
  M file2.c
  $ hg commit -m 'useful tweak'
  $ hg --hidden shortlog -G -r 0d972d6888e6::
  @  27:51e0d8c0a922  draft  useful tweak
  |
  o  26:2594e98553a9  draft  fix a bug
  |
  | *  25:fbb3c6d50427  draft  new feature
  | |
  | x  24:5b31a1239ab9  draft  fix a bug
  |/
  o  23:0d972d6888e6  draft  fix bug 67
  |
  ~
  $ hg evolve --all --any --update
  move:[25] new feature
  atop:[26] fix a bug
  working directory is now at 166c1c368ab6
  $ hg --hidden shortlog -G -r 0d972d6888e6::
  @  28:166c1c368ab6  draft  new feature
  |
  | o  27:51e0d8c0a922  draft  useful tweak
  |/
  o  26:2594e98553a9  draft  fix a bug
  |
  | x  25:fbb3c6d50427  draft  new feature
  | |
  | x  24:5b31a1239ab9  draft  fix a bug
  |/
  o  23:0d972d6888e6  draft  fix bug 67
  |
  ~