git-release 0.0.1

data/test/support/roundup

@@ -0,0 +1,310 @@
+#!/bin/bash
+# [r5]: roundup.5.html
+# [r1t]: roundup-1-test.sh.html
+# [r5t]: roundup-5-test.sh.html
+
+#Direct copy of roundup so we can use it on Travis CI
+#https://github.com/bmizerany/roundup
+#
+# _(c) 2010 Blake Mizerany - MIT License_
+#
+# Spray **roundup** on your shells to eliminate weeds and bugs.  If your shells
+# survive **roundup**'s deathly toxic properties, they are considered
+# roundup-ready.
+#
+# **roundup** reads shell scripts to form test plans.  Each
+# test plan is sourced into a sandbox where each test is executed.
+#
+# See [roundup-1-test.sh.html][r1t] or [roundup-5-test.sh.html][r5t] for example
+# test plans.
+#
+# __Install__
+#
+#     git clone http://github.com/bmizerany/roundup.git
+#     cd roundup
+#     make
+#     sudo make install
+#     # Alternatively, copy `roundup` wherever you like.
+#
+# __NOTE__:  Because test plans are sourced into roundup, roundup prefixes its
+# variable and function names with `roundup_` to avoid name collisions.  See
+# "Sandbox Test Runs" below for more insight.
+
+# Usage and Prerequisites
+# -----------------------
+
+# Exit if any following command exits with a non-zero status.
+set -e
+
+# The current version is set during `make version`.  Do not modify this line in
+# anyway unless you know what you're doing.
+ROUNDUP_VERSION="0.0.5"
+export ROUNDUP_VERSION
+
+# Usage is defined in a specific comment syntax. It is `grep`ed out of this file
+# when needed (i.e. The Tomayko Method).  See
+# [shocco](http://rtomayko.heroku.com/shocco) for more detail.
+#/ usage: roundup [--help|-h] [--version|-v] [plan ...]
+
+roundup_usage() {
+    grep '^#/' <"$0" | cut -c4-
+}
+
+while test "$#" -gt 0
+do
+    case "$1" in
+        --help|-h)
+            roundup_usage
+            exit 0
+            ;;
+        --version|-v)
+            echo "roundup version $ROUNDUP_VERSION"
+            exit 0
+            ;;
+        --color)
+            color=always
+            shift
+            ;;
+        -)
+            echo >&2 "roundup: unknown switch $1"
+            exit 1
+            ;;
+        *)
+            break
+            ;;
+    esac
+done
+
+# Consider all scripts with names matching `*-test.sh` the plans to run unless
+# otherwise specified as arguments.
+if [ "$#" -gt "0" ]
+then
+    roundup_plans="$@"
+else
+    roundup_plans="$(ls *-test.sh)"
+fi
+
+: ${color:="auto"}
+
+# Create a temporary storage place for test output to be retrieved for display
+# after failing tests.
+roundup_tmp="$PWD/.roundup.$$"
+mkdir -p "$roundup_tmp"
+
+trap "rm -rf \"$roundup_tmp\"" EXIT INT
+
+# __Tracing failures__
+roundup_trace() {
+    # Delete the first two lines that represent roundups execution of the
+    # test function.  They are useless to the user.
+    sed '1d'                                   |
+    # Delete the last line which is the "set +x" of the error trap
+    sed '$d'                                   |
+    # Replace the rc=$? of the error trap with an verbose string appended
+    # to the failing command trace line.
+    sed '$s/.*rc=/exit code /'                 |
+    # Trim the two left most `+` signs.  They represent the depth at which
+    # roundup executed the function.  They also, are useless and confusing.
+    sed 's/^++//'                              |
+    # Indent the output by 4 spaces to align under the test name in the
+    # summary.
+    sed 's/^/    /'                            |
+    # Highlight the last line in front of the exit code to bring notice to
+    # where the error occurred.
+    #
+    # The sed magic puts every line into the hold buffer first, then
+    # substitutes in the previous hold buffer content, prints that and starts
+    # with the next cycle. At the end the last line (in the hold buffer)
+    # is printed without substitution.
+    sed -n "x;1!{ \$s/\(.*\)/$mag\1$clr/; };1!p;\$x;\$p"
+}
+
+# __Other helpers__
+
+# Track the test stats while outputting a real-time report.  This takes input on
+# **stdin**.  Each input line must come in the format of:
+#
+#     # The plan description to be displayed
+#     d <plan description>
+#
+#     # A passing test
+#     p <test name>
+#
+#     # A failed test
+#     f <test name>
+roundup_summarize() {
+    set -e
+
+    # __Colors for output__
+
+    # Use colors if we are writing to a tty device.
+    if (test -t 1) || (test $color = always)
+    then
+        red=$(printf "\033[31m")
+        grn=$(printf "\033[32m")
+        mag=$(printf "\033[35m")
+        clr=$(printf "\033[m")
+        cols=$(tput cols)
+    fi
+
+    # Make these available to `roundup_trace`.
+    export red grn mag clr
+
+    ntests=0
+    passed=0
+    failed=0
+
+    : ${cols:=10}
+
+    while read status name
+    do
+        case $status in
+        p)
+            ntests=$(expr $ntests + 1)
+            passed=$(expr $passed + 1)
+            printf "  %-48s " "$name:"
+            printf "$grn[PASS]$clr\n"
+            ;;
+        f)
+            ntests=$(expr $ntests + 1)
+            failed=$(expr $failed + 1)
+            printf "  %-48s " "$name:"
+            printf "$red[FAIL]$clr\n"
+            roundup_trace < "$roundup_tmp/$name"
+            ;;
+        d)
+            printf "%s\n" "$name"
+            ;;
+        esac
+    done
+    # __Test Summary__
+    #
+    # Display the summary now that all tests are finished.
+    yes = | head -n 57 | tr -d '\n'
+    printf "\n"
+    printf "Tests:  %3d | " $ntests
+    printf "Passed: %3d | " $passed
+    printf "Failed: %3d"    $failed
+    printf "\n"
+
+    # Exit with an error if any tests failed
+    test $failed -eq 0 || exit 2
+}
+
+# Sandbox Test Runs
+# -----------------
+
+# The above checks guarantee we have at least one test.  We can now move through
+# each specified test plan, determine its test plan, and administer each test
+# listed in a isolated sandbox.
+for roundup_p in $roundup_plans
+do
+    # Create a sandbox, source the test plan, run the tests, then leave
+    # without a trace.
+    (
+        # Consider the description to be the `basename` of the plan minus the
+        # tailing -test.sh.
+        roundup_desc=$(basename "$roundup_p" -test.sh)
+
+        # Define functions for
+        # [roundup(5)][r5]
+
+        # A custom description is recommended, but optional.  Use `describe` to
+        # set the description to something more meaningful.
+        # TODO: reimplement this.
+        describe() {
+            roundup_desc="$*"
+        }
+
+        # Provide default `before` and `after` functions that run only `:`, a
+        # no-op. They may or may not be redefined by the test plan.
+        before() { :; }
+        after() { :; }
+
+        # Seek test methods and aggregate their names, forming a test plan.
+        # This is done before populating the sandbox with tests to avoid odd
+        # conflicts.
+
+        # TODO:  I want to do this with sed only.  Please send a patch if you
+        # know a cleaner way.
+        roundup_plan=$(
+            grep "^it_.*()" $roundup_p           |
+            sed "s/\(it_[a-zA-Z0-9_]*\).*$/\1/g"
+        )
+
+        # We have the test plan and are in our sandbox with [roundup(5)][r5]
+        # defined.  Now we source the plan to bring its tests into scope.
+        . ./$roundup_p
+
+        # Output the description signal
+        printf "d %s" "$roundup_desc" | tr "\n" " "
+        printf "\n"
+
+        for roundup_test_name in $roundup_plan
+        do
+            # Any number of things are possible in `before`, `after`, and the
+            # test.  Drop into an subshell to contain operations that may throw
+            # off roundup; such as `cd`.
+            (
+                # Output `before` trace to temporary file. If `before` runs cleanly,
+                # the trace will be overwritten by the actual test case below.
+                {
+                    # redirect tracing output of `before` into file.
+                    {
+                        set -x
+                        # If `before` wasn't redefined, then this is `:`.
+                        before
+                    } &>"$roundup_tmp/$roundup_test_name"
+                    # disable tracing again. Its trace output goes to /dev/null.
+                    set +x
+                } &>/dev/null
+
+                # exit subshell with return code of last failing command. This
+                # is needed to see the return code 253 on failed assumptions.
+                # But, only do this if the error handling is activated.
+                set -E
+                trap 'rc=$?; set +x; set -o | grep "errexit.*on" >/dev/null && exit $rc' ERR
+
+                # If `before` wasn't redefined, then this is `:`.
+                before
+
+                # Momentarily turn off auto-fail to give us access to the tests
+                # exit status in `$?` for capturing.
+                set +e
+                (
+                    # Set `-xe` before the test in the subshell.  We want the
+                    # test to fail fast to allow for more accurate output of
+                    # where things went wrong but not in _our_ process because a
+                    # failed test should not immediately fail roundup.  Each
+                    # tests trace output is saved in temporary storage.
+                    set -xe
+                    $roundup_test_name
+                ) >"$roundup_tmp/$roundup_test_name" 2>&1
+
+                # We need to capture the exit status before returning the `set
+                # -e` mode.  Returning with `set -e` before we capture the exit
+                # status will result in `$?` being set with `set`'s status
+                # instead.
+                roundup_result=$?
+
+                # It's safe to return to normal operation.
+                set -e
+
+                # If `after` wasn't redefined, then this runs `:`.
+                after
+
+                # This is the final step of a test.  Print its pass/fail signal
+                # and name.
+                if [ "$roundup_result" -ne 0 ]
+                then printf "f"
+                else printf "p"
+                fi
+
+                printf " $roundup_test_name\n"
+            )
+        done
+    )
+done |
+
+# All signals are piped to this for summary.
+roundup_summarize

data/test/test_helper.sh

@@ -0,0 +1,95 @@
+#!/bin/bash -e
+
+#Script spec helpers
+
+script_directory() {
+  "$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+}
+
+#Search argument 1 for substring in argument 2
+search_substring() {
+  if echo "$1" | grep -q "$2"; then
+    echo 'found'
+  else
+    echo 'missing'
+  fi;
+}
+
+should_succeed() {
+  if [[ $? = 0 ]]; then
+    return 0
+  else
+    return 1
+  fi;
+}
+
+should_fail() {
+  ! should_succeed
+}
+
+file_should_exist() {
+  if [[ -f $1 ]];
+  then
+    return 0;
+  else
+    return 1;
+  fi;
+}
+
+file_should_not_exist() {
+  ! file_should_exist $1
+}
+
+enter_sandbox() {
+  __DIR__="$PWD"
+  rm -rf .sandbox
+  mkdir -p .sandbox
+  cd .sandbox
+}
+
+remove_sandbox() {
+  rm -rf .sandbox
+}
+
+generate_git_repo() {
+  enter_sandbox
+  git init
+  touch 'commit_1'
+  git add -A
+  git commit -am "Initial Commit"
+}
+
+generate_sandbox_tags() {
+  if [[ ! -f '.git' ]]; then
+    #Generate git repo & enter sandbox
+    generate_git_repo
+  fi;
+
+  #Optional arrays for sets of tags and commits
+  if [[ "$1" != '' ]]; then
+    declare -a tag_names=("${!1}")
+  else
+    local tag_names="$1"
+  fi;
+  if [[ "$2" != '' ]]; then
+    declare -a tag_commit_messages=("${!2}")
+  else
+    local tag_commit_messages="$2"
+  fi;
+
+  if [[ $tag_names = '' ]]; then
+    echo "Error - Please be specific on the tag names you want to generate";
+    exit 1;
+  fi;
+  for i in "${!tag_names[@]}"; do
+    touch "change${i}" &>/dev/null
+    git add -A  &>/dev/null
+    local commit_message="${tag_commit_messages[$i]}"
+    if [[ "$commit_message" = '' ]]; then
+      #Use default commit message
+      commit_message="Change : ${i}";
+    fi;
+    git commit -m "$commit_message" &>/dev/null
+    git tag "${tag_names[$i]}" &>/dev/null
+  done;
+}

data/test/unit/changelog-functions-test.sh

@@ -0,0 +1,440 @@
+#!/bin/bash -e
+
+. ./test/test_helper.sh
+. ./support/git-functions.sh
+. ./support/changelog-functions.sh
+
+describe "git-release - unit - changelog"
+
+after() {
+  if [[ $MAINTAIN_SANDBOX != true ]]; then
+    remove_sandbox
+  fi;
+}
+
+
+#get_changelog_text_for_commits
+
+it_uses_get_changelog_text_for_commits_to_return_titles_by_default() {
+  local tags=(
+    'random_tag_1'
+    'release/v1.0.5'
+    'random_tag_2'
+    'release/v1.0.6'
+  )
+
+  local commit_message_1="Release 1.0.6"
+  local commit_message_2="Random Release 2"
+  local commit_message_3="Older Release 1.0.5"
+
+  local commit_messages=(
+    "Random Release numero uno"
+    "$commit_message_3"
+    "$commit_message_2"
+    "$commit_message_1"
+  )
+  generate_sandbox_tags tags[@] commit_messages[@]
+
+  local commit_shas=$(get_commits_between_points "release/v1.0.5" "release/v1.0.6")
+
+  output=$(get_changelog_text_for_commits "$commit_shas")
+
+  test "$output" = "${commit_message_1}
+${commit_message_2}
+${commit_message_3}"
+}
+
+it_uses_get_changelog_text_for_commits_to_return_titles_with_a_custom_format() {
+  local tags=(
+    'random_tag_1'
+    'release/v1.0.5'
+    'random_tag_2'
+    'release/v1.0.6'
+  )
+
+  local commit_message_1="Release 1.0.6"
+  local commit_message_2="Random Release 2"
+  local commit_message_3="Older Release 1.0.5"
+
+  local commit_messages=(
+    "Random Release numero uno"
+    "$commit_message_3"
+    "$commit_message_2"
+    "$commit_message_1"
+  )
+  generate_sandbox_tags tags[@] commit_messages[@]
+
+  local commit_shas=$(get_commits_between_points "release/v1.0.5" "release/v1.0.6")
+  local sha_array=($commit_shas)
+
+  output=$(get_changelog_text_for_commits "--format=%H--%s" "$commit_shas")
+
+  test "$output" = "${sha_array[0]}--${commit_message_1}
+${sha_array[1]}--${commit_message_2}
+${sha_array[2]}--${commit_message_3}"
+}
+
+it_uses_get_changelog_text_for_commits_to_return_titles_grouped_by_tags() {
+  local tags=(
+    "releases/v0.0.3"
+    "releases/v0.0.4"
+    "releases/v0.1.4"
+    "releases/v1.1.4"
+    "releases/v1.1.5"
+    "releases/v1.1.6"
+  )
+  local commit_messages=(
+    "Start of the project"
+    "[bugs]Argh, I fixed a bug here"
+    "[feature] OMG. I had time to write something of use"
+    "[features]Its so exciting writing useful things!!"
+    "[bug] What comes up, must come down"
+    "Some random tweak fix"
+  )
+  generate_sandbox_tags tags[@] commit_messages[@]
+  local commit_shas=$(get_commits_between_points "${tags[0]}" "${tags[5]}")
+
+  output=$(get_changelog_text_for_commits "$commit_shas")
+
+  local sha_array=($commit_shas)
+  test "$output" = "Features:
+  Its so exciting writing useful things!!
+  OMG. I had time to write something of use
+
+Bugs:
+  What comes up, must come down
+  Argh, I fixed a bug here
+
+Some random tweak fix
+Start of the project"
+}
+
+it_uses_get_changelog_text_for_commits_to_return_titles_grouped_by_tags_case_insensitive() {
+  local tags=(
+    "releases/v0.0.3"
+    "releases/v1.1.5"
+    "releases/v1.1.6"
+  )
+  local commit_messages=(
+    "[Bug] Start of the project"
+    "[BUGS]   Argh, I fixed a bug here"
+    "[fEaTuRes]     OMG. I had time to write something of use"
+  )
+  generate_sandbox_tags tags[@] commit_messages[@]
+  local commit_shas=$(get_commits_between_points "${tags[0]}" "${tags[2]}")
+
+  output=$(get_changelog_text_for_commits "$commit_shas")
+
+  test "$output" = "Features:
+  OMG. I had time to write something of use
+
+Bugs:
+  Argh, I fixed a bug here
+  Start of the project"
+}
+
+it_uses_get_changelog_text_for_commits_to_return_titles_grouped_by_tags_with_multiple_brackets() {
+  local tags=(
+    "releases/v0.0.3"
+    "releases/v1.1.6"
+  )
+  local commit_messages=(
+    "[BUGS] [QC Some Reference][More Custom References] Fixed the tagged bugs"
+    "[fEaTuRes][Additonal Tag one] Another referenced feature"
+  )
+  generate_sandbox_tags tags[@] commit_messages[@]
+  local commit_shas=$(get_commits_between_points "${tags[0]}" "${tags[1]}")
+
+  output=$(get_changelog_text_for_commits "$commit_shas")
+
+  test "$output" = "Features:
+  [Additonal Tag one] Another referenced feature
+
+Bugs:
+  [QC Some Reference][More Custom References] Fixed the tagged bugs"
+}
+
+#generate_changelog_content
+
+it_uses_generate_changelog_content_to_exit_with_errors_without_release_name() {
+  generate_git_repo
+
+  should_fail $(generate_changelog_content)
+  should_fail $(generate_changelog_content '')
+}
+
+it_uses_generate_changelog_content_to_exit_with_errors_with_invalid_commit_filter() {
+  generate_git_repo
+
+  should_fail $(generate_changelog_content 'AnyOldReleaseName')
+  should_fail $(generate_changelog_content 'AnyOldReleaseName' '')
+  should_fail $(generate_changelog_content 'AnyOldReleaseName' ':unknown')
+  should_fail $(generate_changelog_content 'AnyOldReleaseName' ':anything')
+
+  should_succeed $(generate_changelog_content 'AnyOldReleaseName' ':all_commits')
+  should_succeed $(generate_changelog_content 'AnyOldReleaseName' ':pulls_only')
+}
+
+it_uses_generate_changelog_content_to_succeed_without_a_startpoint() {
+  generate_git_repo
+
+  should_succeed $(generate_changelog_content 'v0.0.5' ':all_commits' '' 'releases/end/v02.34')
+}
+
+it_uses_generate_changelog_content_to_succeed_without_an_endpoint() {
+  generate_git_repo
+
+  should_succeed $(generate_changelog_content 'v0.0.5' ':all_commits' 'releases/v1.0.45')
+}
+
+it_uses_generate_changelog_content_to_generate_with_all_commit_messages(){
+  local tags=(
+    'random_tag_1'
+    'release/v1.0.5'
+    'random_tag_2'
+    'release/v1.0.6'
+  )
+  local commit_messages=(
+    'Message For Random Tag 1'
+    '[Any Old] Message for 1.0.5'
+    'Lots of changes in this commit for random tag 2'
+    'latest release to 1.0.6'
+  )
+
+  generate_sandbox_tags tags[@] commit_messages[@]
+
+  local custom_release_name="v1.0.7"
+  local output=$(generate_changelog_content "$custom_release_name" ':all_commits')
+
+  test "$output" = "$(changelog_divider)
+|| Release: ${custom_release_name}
+|| Released on $(get_current_release_date)
+$(changelog_divider)
+${commit_messages[3]}
+${commit_messages[2]}
+${commit_messages[1]}
+${commit_messages[0]}
+$(get_commit_message_for_first_commit)
+$(changelog_divider)"
+}
+
+it_uses_generate_changelog_content_to_generate_with_commit_messages_for_a_range(){
+  local tags=(
+    'random_tag_1'
+    'release/v1.0.5'
+    'random_tag_2'
+    'release/v1.0.6'
+  )
+  local commit_messages=(
+    'Message For Random Tag 1'
+    '[Any Old] Message for 1.0.5'
+    'Lots of changes in this commit for random tag 2'
+    'latest release to 1.0.6'
+  )
+
+  generate_sandbox_tags tags[@] commit_messages[@]
+
+  local custom_release_name="v1.0.7"
+  local output=$(generate_changelog_content "$custom_release_name" ':all_commits' 'release/v1.0.5' 'random_tag_2')
+
+  test "$output" = "$(changelog_divider)
+|| Release: ${custom_release_name}
+|| Released on $(get_current_release_date)
+$(changelog_divider)
+${commit_messages[2]}
+${commit_messages[1]}
+$(changelog_divider)"
+}
+
+it_uses_generate_changelog_content_to_generate_scoped_to_only_pull_requests(){
+  local tags=(
+    'tag_with_pulls_1'
+    'tag_witout_pull'
+    'tag_with_pulls_2'
+    'another_tag_without'
+    'tag_with_pulls_3'
+    'tag_with_pulls_4'
+  )
+  local commit_messages=(
+    "Merge pull request #705 from Ferocia/bug/limit-payment-description-length
+
+[BUG] Pay anyone from the accounts screen"
+    " This commit is not a pull request and should be ignored"
+    "Merge pull request #722 from Ferocia/feature/running-balance-field (Anthony Langhorne, 18 hours ago)
+
+[Features] This is a pull request merging a feature across multiple
+lines and continuing"
+    " Yet another commit,that isn't a pull request"
+    "Merge pull request #714 from Ferocia/fix-customer-login
+
+Fixing the customer login but no tag displayed."
+    "Merge pull request #685 from Ferocia/bug/modal-new-payee
+
+[Security] Commit fixing the modal with security flaw"
+  )
+
+  generate_sandbox_tags tags[@] commit_messages[@]
+
+  local custom_release_name="v2.0.5"
+  local output=$(generate_changelog_content "$custom_release_name" ':pulls_only')
+
+  test "$output" = "$(changelog_divider)
+|| Release: ${custom_release_name}
+|| Released on $(get_current_release_date)
+$(changelog_divider)
+Features:
+  This is a pull request merging a feature across multiple
+lines and continuing
+
+Security:
+  Commit fixing the modal with security flaw
+
+Bugs:
+  Pay anyone from the accounts screen
+
+Fixing the customer login but no tag displayed.
+$(changelog_divider)"
+}
+
+#generate_version_file
+
+it_uses_generate_version_file_to_fail_with_no_version_number_passed() {
+  should_fail $(generate_version_file)
+}
+
+it_uses_generate_version_file_to_create_a_version_file() {
+  enter_sandbox
+
+  file_should_not_exist "VERSION"
+
+  generate_version_file 'v12.03.23'
+
+  file_should_exist "VERSION"
+
+  test "$(cat VERSION)" = "v12.03.23"
+}
+
+it_uses_generate_version_file_to_create_a_custom_version_file() {
+  enter_sandbox
+
+  file_should_not_exist "CUSTOM_VERSION"
+
+  generate_version_file 'v12.03.23' 'CUSTOM_VERSION'
+
+  file_should_exist "CUSTOM_VERSION"
+
+  test "`cat CUSTOM_VERSION`" = "v12.03.23"
+}
+
+it_uses_generate_version_file_to_replace_any_existing_version_file() {
+  enter_sandbox
+
+  file_should_not_exist "VERSION"
+
+  generate_version_file 'v12.03.23'
+
+  file_should_exist "VERSION"
+
+  test "`cat VERSION`" = "v12.03.23"
+
+  generate_version_file 'v14.05.25'
+
+  test "`cat VERSION`" = "v14.05.25"
+}
+
+#generate_changelog_file
+
+it_uses_generate_changelog_file_to_fail_with_content_passed_or_strategy() {
+  enter_sandbox
+
+  should_fail $(generate_changelog_file)
+  should_fail $(generate_changelog_file 'some content')
+  should_fail $(generate_changelog_file 'some content' '')
+
+  should_succeed $(generate_changelog_file 'some content' ':overwrite')
+}
+
+it_uses_generate_changelog_file_to_fail_with_invalid_strategy() {
+  enter_sandbox
+
+  should_fail $(generate_changelog_file 'some content' '')
+  should_fail $(generate_changelog_file 'some content' ':anything')
+  should_fail $(generate_changelog_file 'some content' ':unknown')
+
+
+  should_succeed $(generate_changelog_file 'some content' ':overwrite')
+  should_succeed $(generate_changelog_file 'some content' ':append')
+}
+
+it_uses_generate_changelog_file_file_to_create_a_changelog_file() {
+  enter_sandbox
+
+  file_should_not_exist "CHANGELOG"
+
+  local content="
+My Content
+Is Here Across Multiple Lines
+"
+  local output=$(generate_changelog_file "$content" ':overwrite')
+
+  file_should_exist "CHANGELOG"
+
+  test "$(cat CHANGELOG)" = "$content
+$(changelog_footer)"
+}
+
+it_uses_generate_changelog_file_file_to_create_a_custom_version_file() {
+  enter_sandbox
+
+  file_should_not_exist "CHANGELOG"
+  file_should_not_exist "CUSTOM_CHANGELOG"
+
+  local content="
+My Content
+Is Here Across Multiple Lines
+"
+  output=$(generate_changelog_file "$content" ':overwrite' 'CUSTOM_CHANGELOG')
+
+  file_should_not_exist "CHANGELOG"
+  file_should_exist "CUSTOM_CHANGELOG"
+
+  test "`cat CUSTOM_CHANGELOG`" = "$content
+$(changelog_footer)"
+}
+
+it_uses_generate_changelog_file_to_replace_any_existing_file_with_overwrite_strategy() {
+  enter_sandbox
+
+  file_should_not_exist "CHANGELOG"
+
+  output=$(generate_changelog_file 'Original Content' ':overwrite')
+
+  file_should_exist "CHANGELOG"
+
+  test "`cat CHANGELOG`" = "Original Content
+$(changelog_footer)"
+
+  generate_changelog_file 'Updated Content' ':overwrite'
+
+  test "`cat CHANGELOG`" = "Updated Content
+$(changelog_footer)"
+}
+
+it_uses_generate_changelog_file_to_append_to_any_existing_file_with_append_strategy() {
+  enter_sandbox
+
+  file_should_not_exist "CHANGELOG"
+
+  generate_changelog_file 'Original Content' ':append'
+
+  file_should_exist "CHANGELOG"
+
+  test "`cat CHANGELOG`" = "Original Content
+$(changelog_footer)"
+
+  generate_changelog_file 'Updated Content' ':append'
+
+  test "`cat CHANGELOG`" = "Updated Content
+Original Content
+$(changelog_footer)"
+}