git-release 0.0.1

data/support/support-functions.sh

@@ -0,0 +1,10 @@
+#!/bin/bash -e
+
+#Manifest to ensure correct loading of all files in order.
+# Use to handle sourcing all required files.
+# Loading example: . "${BASH_SOURCE[0]%/*}/../support/support-functions.sh"
+
+. "${BASH_SOURCE[0]%/*}/language-bash.sh"
+. "${BASH_SOURCE[0]%/*}/git-functions.sh"
+. "${BASH_SOURCE[0]%/*}/git-release-functions.sh"
+. "${BASH_SOURCE[0]%/*}/changelog-functions.sh"

data/test/bin/run_all

@@ -0,0 +1,7 @@
+#!/bin/bash -e
+
+DIR=$(dirname $0)
+
+time $DIR/../support/roundup $DIR/../{integration,unit}/*
+
+

data/test/integration/releaseable-deployed-test.sh

@@ -0,0 +1,359 @@
+#!/bin/bash -e
+
+. ./test/test_helper.sh
+. ./support/support-functions.sh
+
+rup() { ./bin/git-release-deployed $@; }
+sandbox_rup() { /bin/bash ../bin/git-release-deployed $@; }
+
+usage_head="++ /bin/bash ../bin/git-release-deployed
+Required parameter: Please enter the deploy tag released.
+
+usage : git-release-deployed $(arg_for $ARG_DEPLOYED_TAG '<deployed_tag>') [$(arg_for $ARG_RELEASE_PREFIX '<prefix>')] [$(arg_for $ARG_START '<start>')] [$(arg_for $ARG_FINISH '<finish>')]"
+
+describe "git-release-deployed - integration"
+
+after() {
+  if [[ $MAINTAIN_SANDBOX != true ]]; then
+    remove_sandbox
+  fi;
+}
+
+### Failure Cases
+
+it_will_fail_with_no_deployed_tag() {
+  generate_git_repo
+
+  should_fail $(sandbox_rup)
+}
+
+it_will_display_help_text_on_fail() {
+  generate_git_repo
+
+  local output=$(sandbox_rup 2>&1 | head -n 4 2>&1)
+  test "$output" = "$usage_head"
+}
+
+it_will_display_error_when_no_git_directory_exists() {
+  enter_sandbox
+
+  local output=$(sandbox_rup $(arg_for $ARG_DEPLOYED_TAG 'AnyDeployTag') 2>&1 | head -n 2 2>&1)
+  local missing_git="Error - Not a git repository please run from the base of your git repo."
+
+  test $(search_substring "$output" "$missing_git") = 'found'
+}
+
+it_will_error_if_git_is_in_a_dirty_state() {
+  local tag_name='MyReleases/v1.0.3'
+  local tags=("${tag_name}")
+  generate_sandbox_tags tags[@]
+
+  should_succeed $(sandbox_rup $(arg_for $ARG_DEPLOYED_TAG "$tag_name"))
+
+  touch 'FileToMakeGitDirty'
+
+  should_fail $(sandbox_rup $(arg_for $ARG_DEPLOYED_TAG "$tag_name"))
+
+  rm 'FileToMakeGitDirty'
+
+  should_succeed $(sandbox_rup $(arg_for $ARG_DEPLOYED_TAG "$tag_name"))
+}
+
+it_will_forcibly_replace_existing_deploy_tags() {
+  local tag_name="MyReleases/v1.0.3"
+  local tags=("${tag_name}")
+  generate_sandbox_tags tags[@]
+
+  sandbox_rup $(arg_for $ARG_DEPLOYED_TAG "$tag_name")
+
+  file_should_exist "CHANGELOG"
+  file_should_not_exist "CHANGELOG2"
+
+  sandbox_rup $(arg_for $ARG_DEPLOYED_TAG "$tag_name") $(arg_for $ARG_CHANGELOG 'CHANGELOG2')
+
+  file_should_not_exist "CHANGELOG"
+  file_should_exist "CHANGELOG2"
+
+  #Explicitly checkout the deploy tag in current state
+  git checkout -f -B "deployed/MyReleases/v1.0.3"
+
+  file_should_not_exist "CHANGELOG"
+  file_should_exist "CHANGELOG2"
+}
+
+it_will_error_if_deploy_tag_cannot_be_found(){
+  local tag_name='found/v1.0.3'
+  local tags=("${tag_name}")
+  generate_sandbox_tags tags[@]
+
+  should_succeed $(sandbox_rup $(arg_for $ARG_DEPLOYED_TAG "$tag_name"))
+  should_fail $(sandbox_rup $(arg_for $ARG_DEPLOYED_TAG 'cannotFindThisTag'))
+}
+
+# ### Success cases
+
+it_will_genereate_a_new_deploy_tag_for_each_release() {
+  local tags=( "release/production/v3.1.9" )
+  generate_sandbox_tags tags[@]
+
+  should_succeed $(check_tag_exists "release/production/v3.1.9")
+  should_fail $(check_tag_exists "deployed/release/production/v3.1.9")
+
+  sandbox_rup $(arg_for $ARG_DEPLOYED_TAG "release/production/v3.1.9")
+
+  should_succeed $(check_tag_exists "deployed/release/production/v3.1.9")
+}
+
+it_will_genereate_a_new_deploy_tag_for_each_release_overwriting_any_existing() {
+  local tags=( "release/production/v3.1.9" )
+  generate_sandbox_tags tags[@]
+
+  should_succeed $(check_tag_exists "release/production/v3.1.9")
+  should_fail $(check_tag_exists "deployed/release/production/v3.1.9")
+
+  sandbox_rup $(arg_for $ARG_DEPLOYED_TAG 'release/production/v3.1.9')
+
+  should_succeed $(check_tag_exists "deployed/release/production/v3.1.9")
+  file_should_exist 'CHANGELOG'
+  file_should_not_exist 'DifferentFile'
+
+  sandbox_rup $(arg_for $ARG_DEPLOYED_TAG 'release/production/v3.1.9') $(arg_for $ARG_CHANGELOG 'DifferentFile')
+
+  should_succeed $(check_tag_exists "deployed/release/production/v3.1.9")
+  file_should_not_exist 'CHANGELOG'
+  file_should_exist 'DifferentFile'
+}
+
+it_will_genereate_a_new_deploy_tag_for_next_release_with_defaults() {
+  #From last deployed tag
+  #With anything else in HEAD
+  #Overwrite any existing tag
+
+  local tags=(
+    'release/v1.0.5'
+    'deployed/release/v1.0.5'
+    'release/v1.0.6'
+  )
+  local commit_messages=(
+    '[Any Old] Message for 1.0.5'
+    'The last deployed release'
+    'latest commit message to 1.0.6'
+  )
+
+  generate_sandbox_tags tags[@] commit_messages[@]
+
+  sandbox_rup $(arg_for $ARG_DEPLOYED_TAG 'release/v1.0.6')
+
+  test "$(cat CHANGELOG)" = "$(changelog_divider)
+|| Release: 1.0.6
+|| Released on $(get_current_release_date)
+$(changelog_divider)
+latest commit message to 1.0.6
+The last deployed release
+$(changelog_divider)
+$(changelog_footer)"
+
+  sandbox_rup $(arg_for $ARG_DEPLOYED_TAG 'release/v1.0.6') $(arg_for $ARG_CHANGELOG 'DiffChangeLog')
+  file_should_not_exist 'CHANGELOG'
+
+  test "$(cat DiffChangeLog)" = "$(changelog_divider)
+|| Release: 1.0.6
+|| Released on $(get_current_release_date)
+$(changelog_divider)
+latest commit message to 1.0.6
+The last deployed release
+$(changelog_divider)
+$(changelog_footer)"
+}
+
+it_will_generate_a_deploy_changelog_for_a_set_starting_point() {
+  local tags=(
+    'release/v1.0.4'
+    'release/v1.0.5'
+    'release/v1.0.6'
+  )
+  local commit_messages=(
+    'commit message for 1.0.4'
+    '[Any Old] Message for 1.0.5'
+    'latest commit message to 1.0.6'
+  )
+
+  generate_sandbox_tags tags[@] commit_messages[@]
+
+  sandbox_rup $(arg_for $ARG_DEPLOYED_TAG 'release/v1.0.6')
+
+  test "$(cat CHANGELOG)" = "$(changelog_divider)
+|| Release: 1.0.6
+|| Released on $(get_current_release_date)
+$(changelog_divider)
+latest commit message to 1.0.6
+[Any Old] Message for 1.0.5
+commit message for 1.0.4
+Initial Commit
+$(changelog_divider)
+$(changelog_footer)"
+
+  sandbox_rup $(arg_for $ARG_DEPLOYED_TAG 'release/v1.0.6') $(arg_for $ARG_START 'release/v1.0.5')
+
+  test "$(cat CHANGELOG)" = "$(changelog_divider)
+|| Release: 1.0.6
+|| Released on $(get_current_release_date)
+$(changelog_divider)
+latest commit message to 1.0.6
+[Any Old] Message for 1.0.5
+$(changelog_divider)
+$(changelog_footer)"
+}
+
+it_will_generate_a_deploy_changelog_for_a_set_range_with_start_and_end() {
+  local tags=(
+    'release/v1.0.4'
+    'release/v1.0.5'
+    'release/v1.0.6'
+  )
+  local commit_messages=(
+    'commit message for 1.0.4'
+    '[Any Old] Message for 1.0.5'
+    'latest commit message to 1.0.6'
+  )
+
+  generate_sandbox_tags tags[@] commit_messages[@]
+
+  sandbox_rup $(arg_for $ARG_DEPLOYED_TAG 'release/v1.0.6') $(arg_for $ARG_START 'release/v1.0.4') $(arg_for $ARG_FINISH 'release/v1.0.5')
+
+  test "$(cat CHANGELOG)" = "$(changelog_divider)
+|| Release: 1.0.6
+|| Released on $(get_current_release_date)
+$(changelog_divider)
+[Any Old] Message for 1.0.5
+commit message for 1.0.4
+$(changelog_divider)
+$(changelog_footer)"
+}
+
+it_will_generate_a_deploy_changelog_with_optional_names() {
+  local tags=(
+    'release/v1.0.5'
+    'release/v1.0.6'
+  )
+  local commit_messages=(
+    '[Any Old] Message for 1.0.5'
+    'latest commit message to 1.0.6'
+  )
+
+  generate_sandbox_tags tags[@] commit_messages[@]
+
+  file_should_not_exist "CHANGELOG"
+
+  sandbox_rup $(arg_for $ARG_DEPLOYED_TAG 'release/v1.0.6')
+
+  file_should_exist "CHANGELOG"
+
+  sandbox_rup $(arg_for $ARG_DEPLOYED_TAG "release/v1.0.6") $(arg_for $ARG_CHANGELOG "NewChangeLog")
+
+  file_should_not_exist 'CHANGELOG'
+  file_should_exist "NewChangeLog"
+}
+
+it_will_generate_a_deploy_changelog_file_scoped_to_pull_requests() {
+  local tags=(
+    'tag_with_pulls/1'
+    'tag_with_pulls/2'
+    'tag_without_pulls/1'
+    'tag_with_pulls/3'
+    'tag_with_pulls/4'
+    'releases/v0.0.1'
+  )
+  local commit_messages=(
+    "Merge pull request #705 from Ferocia/bug/limit-payment-description-length
+
+[BUG] Pay anyone from the accounts screen"
+    "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"
+    " A 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[@]
+
+  sandbox_rup $(arg_for $ARG_DEPLOYED_TAG 'releases/v0.0.1') $(arg_for $ARG_PULL_REQUESTS)
+
+  test "$(cat CHANGELOG)" = "$(changelog_divider)
+|| Release: 0.0.1
+|| 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)
+$(changelog_footer)"
+}
+
+it_will_append_to_a_deploy_changelog_optionally(){
+  local tags=(
+    'release/v1.0.4'
+    'release/v1.0.5'
+    'release/v1.0.6'
+  )
+  local commit_messages=(
+    'commit message for 1.0.4'
+    '[Any Old] Message for 1.0.5'
+    'latest commit message to 1.0.6'
+  )
+
+  generate_sandbox_tags tags[@] commit_messages[@]
+
+  sandbox_rup $(arg_for $ARG_DEPLOYED_TAG 'release/v1.0.4')
+
+  test "$(cat CHANGELOG)" = "$(changelog_divider)
+|| Release: 1.0.4
+|| Released on $(get_current_release_date)
+$(changelog_divider)
+commit message for 1.0.4
+Initial Commit
+$(changelog_divider)
+$(changelog_footer)"
+
+  #Add current changelog to tag
+  git checkout release/v1.0.5
+  git merge deployed/release/v1.0.4
+  git tag -f release/v1.0.5
+  git checkout master
+
+  sandbox_rup $(arg_for $ARG_DEPLOYED_TAG 'release/v1.0.5') $(arg_for $ARG_APPEND)
+
+test "$(cat CHANGELOG)" = "$(changelog_divider)
+|| Release: 1.0.5
+|| Released on $(get_current_release_date)
+$(changelog_divider)
+Merge tag 'deployed/release/v1.0.4' into HEAD
+[Any Old] Message for 1.0.5
+Release deployed : release/v1.0.4
+$(changelog_divider)
+$(changelog_divider)
+|| Release: 1.0.4
+|| Released on $(get_current_release_date)
+$(changelog_divider)
+commit message for 1.0.4
+Initial Commit
+$(changelog_divider)
+$(changelog_footer)"
+}
+
+#TODO
+# it_will_optionally_force_push_of_tag()

data/test/integration/releaseable-test.sh

@@ -0,0 +1,409 @@
+#!/bin/bash -e
+
+. ./test/test_helper.sh
+. ./support/support-functions.sh
+
+rup() { ./bin/git-release $@; }
+sandbox_rup() { /bin/bash ../bin/git-release $@; }
+
+usage_head="++ /bin/bash ../bin/git-release
+incorrect versioning type: ''
+Please set to one of 'major', 'minor' or 'patch'
+
+usage : git-release $(arg_for $ARG_VERSION '<version>') [$(arg_for $ARG_RELEASE_PREFIX '<prefix>')] [$(arg_for $ARG_START '<start>')] [$(arg_for $ARG_FINISH '<finish>')]"
+
+describe "git-release - integration"
+
+after() {
+  if [[ $MAINTAIN_SANDBOX != true ]]; then
+    remove_sandbox
+  fi;
+}
+
+### Failure Cases
+
+it_will_fail_with_no_versioning_type() {
+  ! rup
+}
+
+it_will_display_help_text_on_fail() {
+  generate_git_repo
+
+  local output=$(sandbox_rup 2>&1 | head -n 5 2>&1)
+  test "$output" = "$usage_head"
+}
+
+it_will_display_error_when_no_git_directory_exists() {
+  enter_sandbox
+
+  local output=$(sandbox_rup $(arg_for $ARG_VERSION 'patch') 2>&1 | head -n 2 2>&1)
+  local missing_git="Error - Not a git repository please run from the base of your git repo."
+
+  test $(search_substring "$output" "$missing_git") = 'found'
+}
+
+it_will_error_if_git_is_in_a_dirty_state() {
+  generate_git_repo
+
+  should_succeed $(sandbox_rup $(arg_for $ARG_VERSION 'minor'))
+
+  touch 'FileToMakeGitDirty'
+
+  should_fail $(sandbox_rup $(arg_for $ARG_VERSION 'minor'))
+
+  rm 'FileToMakeGitDirty'
+
+  should_succeed $(sandbox_rup $(arg_for $ARG_VERSION 'minor'))
+}
+
+### Success cases
+
+it_will_genereate_a_new_tag_for_next_release() {
+  local tags=(
+    "release/v1.0.5"
+    "release/production/v3.1.9"
+  )
+  generate_sandbox_tags tags[@]
+
+  should_succeed $(check_tag_exists "release/production/v3.1.9")
+  should_fail $(check_tag_exists "release/production/v3.1.10")
+
+  sandbox_rup $(arg_for $ARG_VERSION 'patch') $(arg_for $ARG_RELEASE_PREFIX 'release/production/v')
+
+  should_succeed $(check_tag_exists "release/production/v3.1.10")
+}
+
+it_will_genereate_a_new_tag_for_next_release_with_defaults() {
+  local tags=(
+    "release/v1.0.5"
+    "random_tag_2"
+    "release/v1.0.6"
+  )
+  generate_sandbox_tags tags[@]
+
+  should_succeed $(check_tag_exists "release/v1.0.6")
+  should_fail $(check_tag_exists "release/v1.1.6")
+
+  sandbox_rup $(arg_for $ARG_VERSION 'minor')
+
+  should_succeed $(check_tag_exists "release/v1.1.6")
+}
+
+it_will_genereate_a_new_tag_for_next_release_when_none_exist() {
+  generate_git_repo
+
+  should_fail $(check_tag_exists "my-release/yay-1.0.0")
+  should_fail $(check_tag_exists "my-release/yay-1.1.0")
+
+  sandbox_rup $(arg_for $ARG_VERSION 'major') $(arg_for $ARG_RELEASE_PREFIX 'my-release/yay-')
+
+  should_succeed $(check_tag_exists "my-release/yay-1.0.0")
+  should_fail $(check_tag_exists "my-release/yay-1.1.0")
+
+  sandbox_rup $(arg_for $ARG_VERSION 'minor') $(arg_for $ARG_RELEASE_PREFIX 'my-release/yay-')
+
+  should_succeed $(check_tag_exists "my-release/yay-1.0.0")
+  should_succeed $(check_tag_exists "my-release/yay-1.1.0")
+}
+
+it_will_generate_files_by_default_from_last_tag_to_head() {
+  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 commit message to 1.0.6'
+  )
+
+  generate_sandbox_tags tags[@] commit_messages[@]
+
+  sandbox_rup $(arg_for $ARG_VERSION 'major') $(arg_for $ARG_RELEASE_PREFIX 'release/v')
+
+  test "$(cat CHANGELOG)" = "$(changelog_divider)
+|| Release: 2.0.6
+|| Released on $(get_current_release_date)
+$(changelog_divider)
+latest commit message to 1.0.6
+$(changelog_divider)
+$(changelog_footer)"
+
+  test "$(cat VERSION)" = "2.0.6"
+}
+
+it_will_generate_a_changelog_for_a_set_starting_point() {
+  local tags=(
+    'random_commit_1'
+    'release/v1.0.5'
+    'random_commit_2'
+    'release/v1.0.6'
+  )
+  local commit_messages=(
+    'Message For Random Commit 1'
+    '[Any Old] Message for 1.0.5'
+    'Lots of changes in this commit for random commit 2'
+    'latest commit message to 1.0.6'
+  )
+
+  generate_sandbox_tags tags[@] commit_messages[@]
+
+  sandbox_rup $(arg_for $ARG_VERSION 'patch') $(arg_for $ARG_RELEASE_PREFIX 'release/v') $(arg_for $ARG_START 'release/v1.0.5')
+
+  test "$(cat CHANGELOG)" = "$(changelog_divider)
+|| Release: 1.0.7
+|| Released on $(get_current_release_date)
+$(changelog_divider)
+latest commit message to 1.0.6
+Lots of changes in this commit for random commit 2
+[Any Old] Message for 1.0.5
+$(changelog_divider)
+$(changelog_footer)"
+
+  test "$(cat VERSION)" = "1.0.7"
+}
+
+it_will_generate_a_changelog_for_a_set_range_with_start_and_end() {
+  local tags=(
+    'release/v1.0.4'
+    'random_commit_1'
+    'release/v1.0.5'
+    'random_commit_2'
+    'release/v1.0.6'
+  )
+  local commit_messages=(
+    'Commit for last released start point 1.0.4'
+    'Message For Random Commit 1'
+    '[Any Old] Message for 1.0.5'
+    'Lots of changes in this commit for random commit 2'
+    'latest commit message to 1.0.6'
+  )
+
+  generate_sandbox_tags tags[@] commit_messages[@]
+
+  sandbox_rup $(arg_for $ARG_VERSION 'minor') $(arg_for $ARG_RELEASE_PREFIX 'release/v') $(arg_for $ARG_START 'release/v1.0.5') $(arg_for $ARG_FINISH 'release/v1.0.6')
+
+  test "$(cat CHANGELOG)" = "$(changelog_divider)
+|| Release: 1.1.6
+|| Released on $(get_current_release_date)
+$(changelog_divider)
+latest commit message to 1.0.6
+Lots of changes in this commit for random commit 2
+[Any Old] Message for 1.0.5
+$(changelog_divider)
+$(changelog_footer)"
+
+  test "$(cat VERSION)" = "1.1.6"
+}
+
+
+it_will_generate_files_with_optional_names() {
+  local tags=(
+    'release/v1.0.5'
+    'release/v1.0.6'
+  )
+  local commit_messages=(
+    '[Any Old] Message for 1.0.5'
+    'latest commit message to 1.0.6'
+  )
+
+  generate_sandbox_tags tags[@] commit_messages[@]
+
+  sandbox_rup $(arg_for $ARG_VERSION 'major') $(arg_for $ARG_CHANGELOG 'MYCHANGELOG') $(arg_for $ARG_VERSION_FILE 'VERSION_NUMBER')
+
+  file_should_not_exist "CHANGELOG"
+  file_should_not_exist "VERSION"
+  file_should_exist "MYCHANGELOG"
+  file_should_exist "VERSION_NUMBER"
+
+  test "$(cat MYCHANGELOG)" = "$(changelog_divider)
+|| Release: 2.0.6
+|| Released on $(get_current_release_date)
+$(changelog_divider)
+latest commit message to 1.0.6
+$(changelog_divider)
+$(changelog_footer)"
+
+  test "$(cat VERSION_NUMBER)" = "2.0.6"
+}
+
+
+it_will_generate_a_changelog_file_scoped_to_pull_requests() {
+  local tags=(
+    'tag_with_pulls/1.0.0'
+    'tag_witout_pull'
+    'tag_with_pulls/2.0.0'
+    'another_tag_without'
+    'tag_with_pulls/3.0.0'
+    'tag_with_pulls/4.0.0'
+  )
+  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[@]
+
+  sandbox_rup $(arg_for $ARG_VERSION 'minor') $(arg_for $ARG_PULL_REQUESTS)
+
+  test "$(cat CHANGELOG)" = "$(changelog_divider)
+|| Release: 0.1.0
+|| 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)
+$(changelog_footer)"
+
+  test "$(cat VERSION)" = "0.1.0"
+}
+
+it_will_overwrite_a_changelog_file_by_default() {
+  local tags=(
+    'release/v1.0.4'
+    'release/v1.0.5'
+    'release/v1.0.6'
+  )
+  local commit_messages=(
+    'Commit for last released start point 1.0.4'
+    '[Any Old] Message for 1.0.5'
+    'latest commit message to 1.0.6'
+  )
+
+  generate_sandbox_tags tags[@] commit_messages[@]
+
+  sandbox_rup $(arg_for $ARG_VERSION 'minor') $(arg_for $ARG_START 'release/v1.0.4') $(arg_for $ARG_FINISH 'release/v1.0.5')
+
+  test "$(cat CHANGELOG)" = "$(changelog_divider)
+|| Release: 1.1.6
+|| Released on $(get_current_release_date)
+$(changelog_divider)
+[Any Old] Message for 1.0.5
+Commit for last released start point 1.0.4
+$(changelog_divider)
+$(changelog_footer)"
+
+  test "$(cat VERSION)" = "1.1.6"
+
+  sandbox_rup $(arg_for $ARG_VERSION 'major') $(arg_for $ARG_START 'release/v1.0.5') $(arg_for $ARG_FINISH 'release/v1.0.6')
+
+  test "$(cat CHANGELOG)" = "$(changelog_divider)
+|| Release: 2.1.6
+|| Released on $(get_current_release_date)
+$(changelog_divider)
+latest commit message to 1.0.6
+[Any Old] Message for 1.0.5
+$(changelog_divider)
+$(changelog_footer)"
+
+  test "$(cat VERSION)" = "2.1.6"
+}
+
+it_will_append_to_a_changelog_optionally(){
+  local tags=(
+    'release/v1.0.4'
+    'release/v1.0.5'
+  )
+  local commit_messages=(
+    'Commit for last released start point 1.0.4'
+    '[Any Old] Message for 1.0.5'
+  )
+
+  generate_sandbox_tags tags[@] commit_messages[@]
+
+  sandbox_rup $(arg_for $ARG_VERSION 'minor') $(arg_for $ARG_APPEND)
+
+  test "$(cat CHANGELOG)" = "$(changelog_divider)
+|| Release: 1.1.5
+|| Released on $(get_current_release_date)
+$(changelog_divider)
+[Any Old] Message for 1.0.5
+$(changelog_divider)
+$(changelog_footer)"
+
+  test "$(cat VERSION)" = "1.1.5"
+
+  sandbox_rup $(arg_for $ARG_VERSION 'major') $(arg_for $ARG_APPEND)
+
+  test "$(cat CHANGELOG)" = "$(changelog_divider)
+|| Release: 2.1.5
+|| Released on $(get_current_release_date)
+$(changelog_divider)
+Release : release/v1.1.5
+$(changelog_divider)
+$(changelog_divider)
+|| Release: 1.1.5
+|| Released on $(get_current_release_date)
+$(changelog_divider)
+[Any Old] Message for 1.0.5
+$(changelog_divider)
+$(changelog_footer)"
+
+  test "$(cat VERSION)" = "2.1.5"
+}
+
+
+it_will_generate_in_an_opinionated_fashion(){
+  #using defaults other than append
+  generate_git_repo
+
+  sandbox_rup $(arg_for $ARG_VERSION 'minor') $(arg_for $ARG_APPEND)
+
+  test "$(cat CHANGELOG)" = "$(changelog_divider)
+|| Release: 0.1.0
+|| Released on $(get_current_release_date)
+$(changelog_divider)
+Initial Commit
+$(changelog_divider)
+$(changelog_footer)"
+
+  test "$(cat VERSION)" = "0.1.0"
+
+  sandbox_rup $(arg_for $ARG_VERSION 'major') $(arg_for $ARG_APPEND)
+
+  test "$(cat CHANGELOG)" = "$(changelog_divider)
+|| Release: 1.1.0
+|| Released on $(get_current_release_date)
+$(changelog_divider)
+Release : release/v0.1.0
+$(changelog_divider)
+$(changelog_divider)
+|| Release: 0.1.0
+|| Released on $(get_current_release_date)
+$(changelog_divider)
+Initial Commit
+$(changelog_divider)
+$(changelog_footer)"
+
+  test "$(cat VERSION)" = "1.1.0"
+}
+
+#TODO
+# it_will_optionally_force_push_of_tag()
+
+