creating/deleting branches

create_challenge.sh

@@ -36,6 +36,10 @@ echo 'A slightly older alternative to `switch` is `checkout`, which also works,
 git add branch.md
 commit -m "WIP branch: add explenation on checkout"
 
+cat "$DOCDIR/04_branch/branch_create_delete.md" >> branch.md
+git add branch.md
+commit -m "WIP branch: add explenation on how to create/delete"
+
 git switch main
 
 # commit

src/04_branch/branch_create_delete.md

@@ -0,0 +1,11 @@
+## Toggling between two branches
+
+Sometimes you find yourself switching back and forth between two branches and it becomes tedious to always type the branch names, so there is a shortcut for it: instead of a branch name, you can simply write a `-` like: `git switch -`
+
+## How to create a branch
+
+To create a new branch from the commit you are currently on you can simply run `git switch -c my-new-branch` (short for `--create`). You can also create one based on a different commit (not the one you currently have checked out) by adding it (in this example the last commit on the main branch): `git switch main -c my-new-branch`.
+
+## How to delete a branch
+
+To delete a branch you can run `git branch -d my-new-branch` (short for `--delete`). That will not work if the branch has changes that are not merged yet (not in the main branch). In that case you need to add a `--force` (or `-f` for short) as well. Alternatively there is the shortcut `-D` that is the same as `--delete --force`.

src/hooks/post-checkout

@@ -4,6 +4,14 @@ PREV_HEAD="$1"
 NEXT_REF="$2"
 IS_SWITCH="$3"
 
+# switched to my-new-branch
+if [ "$(git rev-parse --abbrev-ref HEAD)" = "my-new-branch" ] && [ "$IS_SWITCH" = 1 ]; then
+    echo "Flag: MyFirstBranch"
+    exit
+fi
+
+# switched to branches-explained
 if [ "$NEXT_REF" = "$(git rev-parse branches-explained)" ] && [ "$IS_SWITCH" = 1 ]; then
     echo "Flag: Switcheridoo"
+    exit
 fi

test.sh

@@ -34,4 +34,7 @@ exec $(sed -n '/^```sh$/,/^```$/{n;p;}' commit.md) | grep --quiet "Flag: ShowMeM
 echo 'Switcheridoo when switching to "branches-explained"'
 git switch branches-explained 2>&1 | grep --quiet "Flag: Switcheridoo"
 
+echo 'MyFirstBranch when creating'
+git switch -c my-new-branch 2>&1 | grep --quiet "Flag: MyFirstBranch"
+
 echo success!