@san-siva/gitsy 1.0.0

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@san-siva/gitsy",
+  "version": "1.0.0",
+  "description": "A set of bash utilities for managing Git repositories with ease",
+  "keywords": [
+    "git",
+    "cli",
+    "bash",
+    "git-tools",
+    "git-utilities",
+    "workflow",
+    "productivity"
+  ],
+  "homepage": "https://gitsy-56895.web.app",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/san-siva/gitsy.git"
+  },
+  "bugs": {
+    "url": "https://github.com/san-siva/gitsy/issues"
+  },
+  "author": {
+    "name": "Santhosh Siva",
+    "url": "https://github.com/san-siva"
+  },
+  "license": "MIT",
+  "bin": {
+    "g-co": "./g-co",
+    "g-pull": "./g-pull",
+    "g-push": "./g-push",
+    "g-wa": "./g-wa",
+    "g-wr": "./g-wr",
+    "g-db": "./g-db",
+    "g-dlc": "./g-dlc",
+    "g-rmf": "./g-rmf",
+    "g-rto": "./g-rto",
+    "g-cb": "./g-cb",
+    "g-s": "./g-s",
+    "g-diff": "./g-diff"
+  },
+  "files": [
+    "g-co",
+    "g-pull",
+    "g-push",
+    "g-wa",
+    "g-wr",
+    "g-db",
+    "g-dlc",
+    "g-rmf",
+    "g-rto",
+    "g-cb",
+    "g-s",
+    "g-diff",
+    "utils",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "bash -c 'for script in g-*; do bash -n \"$script\" || exit 1; done'",
+    "postinstall": "echo '\\n✓ gitsy installed successfully!\\n\\nDependencies required: git, figlet, lolcat\\n\\nRun any command with --help to get started:\\n  g-co --help\\n\\nDocumentation: https://gitsy-56895.web.app\\n'"
+  },
+  "engines": {
+    "node": ">=12.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux"
+  ],
+  "preferGlobal": true
+}

package/utils

@@ -0,0 +1,464 @@
+#!/usr/bin/env bash
+
+# Author: Santhosh Siva
+# Date Created: 03-08-2025
+
+# Colors
+BLUE=$(tput setaf 4)
+PROMPT=$(tput setaf 3)
+GREEN=$(tput setaf 2)
+RED=$(tput setaf 1)
+NC=$(tput sgr0)
+
+overwrite() { echo -e "\r\033[1A\033[0K$@"; }
+
+default_spaces="    "
+
+print_message() {
+	local number=$2
+	local message=$1
+
+	if [ -z "$message" ]; then
+		message=""
+	fi
+
+	if [ -z "$number" ]; then
+		number=0
+	fi
+
+	if [ "$number" -eq 0 ]; then
+		echo -e "   $message"
+		return 0
+	fi
+
+	# print_message ""
+
+	if [ "$number" -lt 10 ]; then
+		printf "%d. %s\n" "$number" "$message"
+		return 0
+	fi
+
+	printf "%02d. %s\n" "$number" "$message"
+}
+
+indent() {
+	local prefix="   │ "
+	sed "s/^/${prefix}/"
+}
+
+install_dependency() {
+	local cmd=$1
+	local package=$2
+
+	if ! command -v "$cmd" >/dev/null; then
+		if brew install "$package" >>"$log_file" 2>>"$error_log_file"; then
+			return
+		else
+			print_message "${RED}Failed to install $package.${NC}"
+			exit 1
+		fi
+	fi
+}
+
+validate_dependencies() {
+	for cmd in $@; do
+		install_dependency "$cmd" "$cmd"
+	done
+}
+
+print_banner() {
+	print_message ""
+	figlet -f slant "Gitsy" | lolcat
+	print_message ""
+}
+
+prompt_user() {
+	local default_to_yes=$1
+	local message=$2
+	local step_number=$3
+
+	if [ -n "$step_number" ] && [ "$step_number" -ne 0 ]; then
+		local prefix="$(printf "%${default_spaces}s")${step_number}. "
+	elif [ "$step_number" -eq 0 ]; then
+		local prefix="$(printf "%${default_spaces}s")   "
+	else
+		local prefix="$(printf "%${default_spaces}s")- "
+	fi
+
+	local prompt="${prefix}${PROMPT}${message}${NC} "
+
+	if [ "$default_to_yes" = "true" ]; then
+		read -p "${prompt}(Y/n): " response
+		response="${response:-y}"
+	else
+		read -p "${prompt}(y/N): " response
+		response="${response:-n}"
+	fi
+
+	case "$response" in
+	[Yy]) echo "y" ;;
+	[Nn]) echo "n" ;;
+	*) print_message "Invalid input." 0 && exit 1 ;;
+	esac
+}
+
+fetch_current_branch() {
+	current_branch=$(git rev-parse --abbrev-ref HEAD)
+	if [ -z "$current_branch" ]; then
+		print_message "${RED}Failed to get current branch. [Fail]${NC}"
+		exit 1
+	fi
+	echo "${current_branch}"
+}
+
+stash_changes() {
+	local stash_changes=$1
+	local step_number=$2
+	local tag_message=$3
+
+	if [ -z "$step_number" ]; then
+		step_number=0
+	fi
+
+	if [ "$stash_changes" = "true" ]; then
+		print_message "${BLUE}Stashing changes...${NC}" $step_number
+
+		if ! (git -c color.ui=always add -A 2>&1 | indent); then
+			print_message "${RED}Failed to add changes to stash. [Fail]${NC}" 0
+			exit 1
+		fi
+
+		local stash_message
+		local branch_name=$(git rev-parse --abbrev-ref HEAD)
+		local stash_date=$(date '+%Y-%m-%d %H:%M:%S')
+
+		if [ -n "$tag_message" ]; then
+			stash_message="Manual stash; Branch: ${branch_name}; Date: ${stash_date}; Message: ${tag_message}"
+		else
+			stash_message="Auto stash; Branch: ${branch_name}; Date: ${stash_date}"
+		fi
+
+		if ! (git -c color.ui=always stash push -m "$stash_message" 2>&1 | indent 4); then
+			print_message "${RED}Failed to stash changes. [Fail]${NC}" 0
+			exit 1
+		fi
+
+		print_message "${GREEN}Changes stashed successfully.${NC}" 0
+	fi
+}
+
+fetch_changes() {
+	local target_branch=$1
+
+	if [ -z "$target_branch" ]; then
+		print_message "${RED}Target branch is not set. [Fail]${NC}" 0
+		return 1
+	fi
+
+	if ! git -c color.ui=always fetch origin "${target_branch}" 2>&1 | indent; then
+		print_message "${PROMPT}Auto-Fetch failed, Please do it manually.${NC}"
+		return 1
+	else
+		return 0
+	fi
+
+	return 0
+}
+
+checkout_branch() {
+	local target_branch=$1
+	local new_branch=$2
+
+	if [ -z "$target_branch" ]; then
+		print_message "${RED}Target branch is not set. [Fail]${NC}"
+		exit 1
+	fi
+
+	if [ "$new_branch" = "true" ]; then
+		if ! git -c color.ui=always checkout -b "${target_branch}" 2>&1 | indent; then
+			print_message "${RED}Failed to create new branch. [Fail]${NC}"
+			exit 1
+		fi
+		print_message "${GREEN}Created new local branch ${NC}${target_branch}${GREEN}. [DONE]${NC}"
+		return 0
+	fi
+
+	if ! git -c color.ui=always checkout "${target_branch}" 2>&1 | indent; then
+		print_message "${RED}Failed to checkout to branch ${NC}${target_branch}${RED}. [Fail]${NC}"
+		exit 1
+	fi
+	return 0
+}
+
+create_worktree() {
+	local target_branch="$1"
+	local worktree_path="$2"
+	local new_branch="$3"
+	local base_branch
+	local created_worktree_message="${GREEN}Successfully created worktree for branch ${NC}$target_branch${GREEN} at ${NC}$worktree_path${GREEN}. [DONE]${NC}"
+	local failed_worktree_message="${RED}Failed to create worktree for branch ${NC}$target_branch${RED}. [Fail]${NC}"
+
+	if [ -z "$target_branch" ]; then
+		print_message "${RED}Target branch is not set. [Fail]${NC}"
+		exit 1
+	fi
+	if [ -z "$worktree_path" ]; then
+		print_message "${RED}Worktree path is not set. [Fail]${NC}"
+		exit 1
+	fi
+	if [ -d "$worktree_path" ]; then
+		print_message "${RED}Worktree path already exists. [Fail]${NC}"
+		exit 1
+	fi
+
+	base_branch=$(fetch_current_branch)
+	if [ -z "$base_branch" ]; then
+		print_message "${RED}Failed to get current branch. [Fail]${NC}"
+		exit 1
+	fi
+
+	if [ "$new_branch" = "true" ]; then
+		# Make sure the source branch exists remotely!
+		if ! git rev-parse --verify "origin/$base_branch" >/dev/null 2>&1; then
+			print_message "${RED}Base branch ${NC}origin/$base_branch${RED} not found. Cannot create new branch.${NC}"
+			exit 1
+		fi
+
+		# Use the -b flag on worktree directly:
+		local worktree_output
+		worktree_output=$(git -c color.ui=always worktree add -b "$target_branch" "$worktree_path" "origin/$base_branch" 2>&1)
+		local worktree_exit_code=$?
+
+		echo "$worktree_output" | indent
+
+		if [ $worktree_exit_code -ne 0 ]; then
+			print_message "${failed_worktree_message}"
+			exit 1
+		fi
+
+		print_message "${BLUE}Pushing new branch ${NC}$target_branch${BLUE} to remote...${NC}"
+		if ! git -c color.ui=always push -u origin "$target_branch" 2>&1 | indent; then
+			print_message "${RED}Failed to push new branch ${NC}$target_branch${RED} to remote. [Fail]${NC}"
+			exit 1
+		fi
+
+		print_message "${created_worktree_message}"
+		return 0
+	fi
+
+	# Just add the worktree to an existing branch:
+	local worktree_output
+	worktree_output=$(git -c color.ui=always worktree add "$worktree_path" "$target_branch" 2>&1)
+	local worktree_exit_code=$?
+
+	echo "$worktree_output" | indent
+
+	if [ $worktree_exit_code -ne 0 ]; then
+		print_message "${failed_worktree_message}"
+		exit 1
+	fi
+
+	print_message "${created_worktree_message}"
+	return 0
+}
+
+reset_to_target_branch() {
+	local target_branch=$1
+	local step_number=$2
+
+	if [ -z "$step_number" ]; then
+		step_number=0
+	fi
+
+	if [ -z "$target_branch" ]; then
+		print_message "${RED}Target branch is not set. [Fail]${NC}"
+		exit 1
+	fi
+
+	print_message "${BLUE}Resetting to ${NC}origin/${target_branch}${BLUE}...${NC}" $step_number
+
+	if ! git -c color.ui=always reset --hard "origin/${target_branch}" 2>&1 | indent; then
+		print_message "${RED}Failed to reset to ${NC}origin/${target_branch}${RED}. [Fail]${NC}"
+		exit 1
+	fi
+
+	print_message "${GREEN}Reset to ${NC}origin/${target_branch}${GREEN} successfully.${NC}"
+}
+
+pull_changes() {
+	local target_branch=$1
+	local step_number=$2
+
+	if [ -z "$step_number" ]; then
+		step_number=0
+	fi
+
+	if [ -z "$target_branch" ]; then
+		print_message "${RED}Target branch is not set. [Fail]${NC}"
+		exit 1
+	fi
+
+	print_message "${BLUE}Pulling changes from ${NC}remote/${target_branch}${BLUE}...${NC}" $step_number
+	if ! git -c color.ui=always pull origin "${target_branch}" 2>&1 | indent; then
+		print_message "${RED}Failed to pull changes from remote. [Fail]${NC}"
+		exit 1
+	fi
+	print_message "${GREEN}Pulled changes from ${NC}remote/${target_branch} ${GREEN}successfully.${NC}"
+}
+
+push_changes() {
+	local target_branch=$1
+	local should_force_push=$2
+	local step_number=$3
+
+	if [ -z "$step_number" ]; then
+		step_number=0
+	fi
+
+	if [ -z "$target_branch" ]; then
+		print_message "${RED}Target branch is not set. [Fail]${NC}"
+		exit 1
+	fi
+
+	# Check if local branch is behind remote
+	if [ "$should_force_push" = "false" ]; then
+		fetch_changes "${target_branch}" >/dev/null 2>&1
+		local local_commit=$(git rev-parse "${target_branch}" 2>/dev/null)
+		local remote_commit=$(git rev-parse "origin/${target_branch}" 2>/dev/null)
+
+		if [ -n "$local_commit" ] && [ -n "$remote_commit" ] && [ "$local_commit" != "$remote_commit" ]; then
+			if ! git merge-base --is-ancestor "origin/${target_branch}" "${target_branch}" 2>/dev/null; then
+				print_message "${RED}Error: Your local branch is behind or has diverged from remote.${NC}" 0
+				print_message "${RED}Use ${NC}--force${RED} flag if you want to force push.${NC}" 0
+				exit 1
+			fi
+		fi
+	fi
+
+	if [ "$should_force_push" = "true" ]; then
+		print_message "${BLUE}Force pushing changes to ${NC}remote/${target_branch}${BLUE}...${NC}" $step_number
+		if ! git -c color.ui=always push --force origin "${target_branch}" 2>&1 | indent; then
+			print_message "${RED}Failed to force push changes to remote. [Fail]${NC}"
+			exit 1
+		fi
+	else
+		print_message "${BLUE}Pushing changes to ${NC}remote/${target_branch}${BLUE}...${NC}" $step_number
+		if ! git -c color.ui=always push origin "${target_branch}" 2>&1 | indent; then
+			print_message "${RED}Failed to push changes to remote. [Fail]${NC}"
+			exit 1
+		fi
+	fi
+	print_message "${GREEN}Pushed changes to ${NC}remote/${target_branch} ${GREEN}successfully.${NC}"
+}
+
+already_on_branch() {
+	local target_branch=$1
+	print_message "${BLUE}Checking current branch...${NC}" 1
+	current_branch=$(fetch_current_branch true)
+	if [ "${target_branch}" = "${current_branch}" ]; then
+		print_message "${GREEN}Already on branch ${NC}${target_branch}${GREEN}. [DONE]${NC}"
+		exit 1
+	fi
+}
+
+check_if_target_branch_is_set() {
+	local target_branch=$1
+	if [ -z "${target_branch}" ]; then
+		print_message "${RED}Error: No target branch specified, use -t or --target-branch option.${NC}"
+		exit 1
+	fi
+}
+
+navigate_to_dir() {
+	local dir=$1
+	if pwd | grep -q "$dir"; then
+		return 0
+	fi
+	if ! cd "$dir" 2>/dev/null; then
+		return 1
+	fi
+	return 0
+}
+
+check_uncommitted_changes() {
+	if ! git diff-index --quiet HEAD --; then
+		return 1
+	fi
+	return 0
+}
+
+is_git_repo() {
+	local dir=$1
+	local original_path=$PWD
+
+	if ! navigate_to_dir "$dir"; then
+		print_message "${RED}Failed to navigate to directory: ${NC}${dir}${RED}. [Fail]${NC}" 0
+		exit 1
+	fi
+
+	if git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+		navigate_to_dir "$original_path"
+		return 0
+	fi
+
+	navigate_to_dir "$original_path"
+	return 1
+}
+
+has_uncommitted_changes() {
+	local original_path=$PWD
+	local worktree_path=$1
+
+	if ! navigate_to_dir "$worktree_path"; then
+		print_message "${RED}Failed to navigate to worktree directory: ${NC}${worktree_path}${RED}. [Fail]${NC}" 0
+		exit 1
+	fi
+
+	if ! is_git_repo "$worktree_path"; then
+		return 1
+	fi
+
+	if ! check_uncommitted_changes; then
+		if ! navigate_to_dir "$original_path"; then
+			print_message "${RED}Failed to navigate to original directory: ${NC}${original_path}${RED}. [Fail]${NC}" 0
+			exit 1
+		fi
+		return 0
+	fi
+
+	if ! navigate_to_dir "$original_path"; then
+		print_message "${RED}Failed to navigate to original directory: ${NC}${original_path}${RED}. [Fail]${NC}" 0
+		exit 1
+	fi
+	return 1
+}
+
+branch_exists_locally() {
+	local branch=$1
+	if git show-ref --verify --quiet "refs/heads/${branch}"; then
+		return 0
+	fi
+	return 1
+}
+
+branch_exists_on_remote() {
+	local branch=$1
+	if git ls-remote --heads origin "${branch}" | grep -q "${branch}"; then
+		return 0
+	fi
+	return 1
+}
+
+copy_to_clipboard() {
+	local content="$1"
+	local message="$2"
+
+	if [ -n "$content" ]; then
+		# Strip all ANSI escape sequences: colors, character sets, etc.
+		printf '%s' "$content" | sed -E $'s/\033(\\[[0-9;]*[a-zA-Z]|\\([0-9A-B])//g' | pbcopy
+	fi
+
+	if [ -n "$message" ]; then
+		print_message "${GREEN}${message}${NC}"
+	fi
+}