git-flux-team

#!/usr/bin/env bash


cmd_usage_default() {
	printf "%s" "create|destroy|sync|review|switch <name> [-h]"
}

cmd_usage_create() {
	printf "%s" "create <name> [-h]"
}

cmd_usage_destroy() {
	printf "%s" "destroy <name> [-h]"
}

cmd_usage_sync() {
	printf "%s" "sync <name> [-h]"
}

cmd_usage_review() {
	printf "%s" "review <name> [-h]"
}

cmd_usage_switch() {
	printf "%s" "switch <name> [-h]"
}

cmd_long_usage_default() {
	printf "%s" "\
$(f_heading "team" | f_fg_yellow)

handle integration across team members and their features.


$(f_subheading "available actions")

$(cmd_long_usage_create)
$(cmd_long_usage_destroy)
$(cmd_long_usage_sync)
$(cmd_long_usage_review)
$(cmd_long_usage_switch)
"
}

cmd_long_usage_create() {
	printf "%s" "\
$(f_code_definition \
"$(cmd_usage_create)" \
"start a new team; create a local branch and push it to the remote.
the branch name will be composed of the pre-configured team prefix and the passed $(f_code "name").
aliases: $(f_code "assemble"), $(f_code "gather"), $(f_code "huddle").")
 "
}

cmd_long_usage_destroy() {
	printf "%s" "\
$(f_code_definition \
"$(cmd_usage_destroy)" \
"destroy an existing team; delete its local and remote branches, for good.
aliases: $(f_code "disassemble"), $(f_code "scatter"), $(f_code "break").")
 "
}

cmd_long_usage_sync() {
	printf "%s" "\
$(f_code_definition \
"$(cmd_usage_sync)" \
"sync an existing team with its base branch, i.e. the integration branch.")
 "
}

cmd_long_usage_review() {
	printf "%s" "\
$(f_code_definition \
"$(cmd_usage_review)" \
"open a pull request from the team branch to its base branch, i.e. the integration branch, for review in github.")
 "
}

cmd_long_usage_switch() {
	printf "%s" "\
$(f_code_definition \
"$(cmd_usage_switch)" \
"switch teams to another team, or join a team for the first time.
after this, all new features will be based on the new team.
aliases: $(f_code "switch").")
 "
}


# aliases 

cmd_assemble() { cmd_create "$@"; }
cmd_gather() { cmd_create "$@"; }
cmd_huddle() { cmd_create "$@"; }
cmd_disassemble() { cmd_destroy "$@"; }
cmd_scatter() { cmd_destroy "$@"; }
cmd_break() { cmd_destroy "$@"; }
cmd_join() { cmd_switch "$@"; }


cmd_create() {
	local name
	local branch
	require_args "$1"
	name="$1"
	branch="$(git_config_get "prefix.team")$name"
	io_log; create_branch_from_base "$branch" "$(git_config_get "branch.integration")"
	git_config_set "branch.team" "$branch"
	io_log; io_log_ok "team '$name' is created. congrats!"; io_log
}

cmd_destroy() {
	local name
	local branch
	require_args "$1"
	name="$1"
	branch="$(git_config_get "prefix.team")$name"
	io_log; destroy_branch_from_base "$branch"
	git_config_unset "branch.team" "$branch"
	io_log; io_log_ok "team '$name' is gone. so long!"; io_log
}

cmd_sync() {
	local name
	require_args "$1"
	name="$1"
	io_log; sync_branch_with_base "$(git_config_get "prefix.team")$name"
	io_log; io_log_ok "team '$name' is in sync with the base."; io_log
}

cmd_review() {
	local name
	require_args "$1"
	name="$1"
	io_log; review_branch_from_base "$(git_config_get "prefix.team")$name"
	io_log; io_log_ok "team '$name' is ready for review."; io_log
}

cmd_switch() {
	local prefix
	local new_team_branch
	local old_team_branch
	local new_team_name
	local old_team_name
    local old_team_feature_branches
	local n
	require_args "$1"
	new_team_name="$1"

	prefix="$(git_config_get "prefix.team")"
	new_team_branch="$prefix$new_team_name"
	old_team_branch="$(git_config_get "branch.team")"

	validate_git_local_and_remote_branches_exist "$new_team_branch"
	
	if [[ $new_team_branch = "$old_team_branch" ]]; then
		io_log; io_status_fatal "'$new_team_name' is the current team, nothing to do."
	fi

	# todo - should this block be used in the 'destroy' action as well?
	# relevant when switching teams, not when joining a team for the first time
	if [[ -n $old_team_branch ]]; then
		validate_git_local_and_remote_branches_exist "$old_team_branch"
		
		old_team_feature_branches=( $(git_config_get_subsections_by_value 'base' "$old_team_branch" 'branch:') )
		if (( ${#old_team_feature_branches[@]} > 0 )); then
			# strip prefix to get the team name
			old_team_name="${old_team_branch#$prefix}"
			io_log; io_log_info "feature branches of the '$old_team_name' team were found:"
			for (( n=0; n<${#old_team_feature_branches[@]}; n++ )); do
				io_log "${old_team_feature_branches[$n]}" 1
			done
			io_confirm "ignore them and continue?" "aborting, see ya later."
		fi
	fi

	io_log
	git_v_checkout "$new_team_branch"
	git_config_set "branch.team" "$new_team_branch"

	io_log; io_log_ok "team switched. welcome aboard!"; io_log
}