Level: The Truth

gitgud/skills/rampup/__init__.py

@@ -5,7 +5,6 @@
     'Rampup',
     'rampup',
     [
-        BasicLevel("Detaching HEAD", 'detaching', __name__),
         BasicLevel("Relative References I: Using (^)", 'relrefs1', __name__),
         BasicLevel("Relative References II: Using (~)", 'relrefs2', __name__),
         BasicLevel("Reversing Changes in Git", 'reversing', __name__)

gitgud/skills/rewriting/__init__.py

@@ -17,5 +17,6 @@ def status(self):
     'Rewriting History',
     'rewriting',
     [
+        SentenceLevel('The Truth', 'truth', __name__)
     ]
 )

gitgud/skills/rewriting/_truth/details.yaml

@@ -0,0 +1,10 @@
+'1':
+  message: This
+'2':
+  message: is
+'3':
+  message: an
+'4':
+  message: easy
+'5':
+  message: level

gitgud/skills/rewriting/_truth/explanation.txt

@@ -0,0 +1,42 @@
+There's something you need to know about...
+>>>
+The truth is...
+>>>
+What you did with "git rebase -i"...
+>>>
+Can be done by...
+>>>
+Detatching your head! Eek!
+>>>
+Let me clarify, I'm actually talking about your HEAD.
+>>>
+HEAD is used to refer to the commit or branch that is currently checked out.
+This basically means that when you're on branch master, HEAD means master, which itself means a commit.
+>>>
+This is important because when you're in a 'detached HEAD' state, cherry-picking still works the same way, and you can do exactly what you just did in the last level.
+>>>
+Normally, HEAD points to the branch that you have checked out, so it refers to whichever commit the branch does, even if there is a new commit!
+For example, if you have bugFix checked out, then when bugFix is updated, HEAD is updated as well, just like this:
+
+    HEAD -> bugFix -> C1   // HEAD points to bugFix.
+    HEAD -> bugFix -> C2   // A commit moved bugFix to C2, HEAD effectively points to C2
+
+For us, since no branches point to the first commit, we can't check it out while staying on a branch.
+>>>
+What if we HEAD to point at a commit rather than a branch?
+(e.g., HEAD -> C1 instead of HEAD -> bugFix -> C1)
+>>>
+In comes the concept of the 'detached HEAD' state. Simply use "git checkout <commit_hash>" to modify HEAD so that it points to the commit instead of the branch.
+>>>
+As you've seen, a commit hash is a unique identifier for a commit.
+Use "git log" or "git gud status" to see the commit tree and to look for the hashes.
+>>>
+The hashes look something like: "d6ba740".
+The full commit hash is 40 characters long, and every one is unique.
+>>>
+In general, if you only have a few commits, even just the first few characters of the commit hash are going to be unique, so you can use as few as the first four characters to refer to the commit.
+Using the example has above "git checkout d6ba" will detach the HEAD so it refers to the commit with the hash "d6ba740"
+>>>
+Finally, to beat this level, you're going to need to check out the first commit (detaching HEAD) then cherry-pick the rest of the commits so they are in the right order.
+Finish the job by making a new branch with the re-ordered commits.
+It can be named anything, but don't check it out so we know you detached your HEAD!

gitgud/skills/rewriting/_truth/goal.txt

@@ -0,0 +1,3 @@
+Just like last level, make the log messages form the sentence "This is an easy level"
+This time, instead of rebasing, detach HEAD using git checkout then use git cherry-pick.
+Save your changes on a new branch named whatever you want, but don't check it out.

gitgud/skills/rewriting/_truth/setup.spec

@@ -0,0 +1,6 @@
+1
+4
+3
+2
+5 (master)
+master

gitgud/skills/rewriting/_truth/solution.txt

@@ -0,0 +1,7 @@
+git checkout master~4
+git cherry-pick master~1
+git cherry-pick master~2
+git cherry-pick master~3
+git cherry-pick master
+git branch -D master
+git checkout -b master

gitgud/skills/rewriting/_truth/test.spec

@@ -0,0 +1,6 @@
+1
+2'
+3'
+4'
+5' (master)
+master

gitgud/test_commands.py

@@ -8,10 +8,10 @@ def test_load(gg):
     load_tests = [
         ('git gud load 1', all_skills["1"]["1"]),
         ('git gud load rampup', all_skills["rampup"]["1"]),
-        ('git gud load 2 detaching', all_skills["2"]["detaching"]),
-        ('git gud load rampup 4', all_skills["rampup"]["4"]),
+        ('git gud load 2 relrefs1', all_skills["2"]["relrefs1"]),
+        ('git gud load rampup 3', all_skills["rampup"]["3"]),
         ('git gud load 5-octopus', all_skills["5"]["octopus"]),
-        ('git gud load rampup-4', all_skills["rampup"]["4"]),
+        ('git gud load rampup-3', all_skills["rampup"]["3"]),
         ('git gud load -2', all_skills["rampup"]["2"])
     ]