pygitgo 1.6.0__tar.gz → 1.6.2__tar.gz

{pygitgo-1.6.0/src/pygitgo.egg-info → pygitgo-1.6.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pygitgo
-Version: 1.6.0
+Version: 1.6.2
 Summary: GitGo CLI - Your Fast Git Companion. Simplifies git push, link, stash, and user management.
 Author: Huerte
 License: GPL-3.0-or-later
@@ -20,11 +20,12 @@ Requires-Dist: pick>=2.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-mock>=3.10; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
 Dynamic: license-file
 
 <div align="center">
 
-# GitGo
+![GitGo Banner](assets/banner.png)
 
 [![Tests](https://github.com/Huerte/GitGo/actions/workflows/tests.yml/badge.svg)](https://github.com/Huerte/GitGo/actions)
 [![PyPI version](https://img.shields.io/pypi/v/pygitgo?color=blue&label=PyPI)](https://pypi.org/project/pygitgo)
@@ -38,6 +39,14 @@ Dynamic: license-file
 
 <a href="https://github.com/Huerte/GitGo/issues">Report Bug</a> · <a href="https://github.com/Huerte/GitGo/issues">Request Feature</a>
 
+<br />
+
+If GitGo saves you time, consider buying me a coffee. It helps keep the project going.
+
+<a href="https://ko-fi.com/huerte">
+  <img src="https://ko-fi.com/img/githubbutton_sm.svg" alt="Support on Ko-fi" />
+</a>
+
 </div>
 
 ---
@@ -63,7 +72,10 @@ gitgo link https://github.com/username/repo.git "init"
 - [Command Reference](#command-reference)
 - [How It Works](#how-it-works)
 - [Contributing](#contributing)
+- [Credits](#credits)
 - [License](#license)
+- [Changelog](CHANGELOG.md)
+- [Contributing Guide](CONTRIBUTING.md)
 
 ---
 
@@ -75,17 +87,18 @@ gitgo link https://github.com/username/repo.git "init"
 
 ## Features
 
-GitGo provides a CLI environment designed for faster and simpler Git workflows. Built to be intuitive, fast, and frictionless.
+GitGo provides a CLI environment designed for faster and simpler Git workflows.
+No chained commands, no cryptic flags — just short commands you can actually remember.
 
-- **Simplified Git Operations:** Replaces chained commands with single intuitive commands for linking, pushing, and stashing.
-- **Easy Undo Operations:** Safely undo commits, un-queue files, or wipe local changes without any complex Git jargon.
-- **Smart Branch Hopping:** Safely traverse branches with `jump`. Auto-stashes messy code and prevents merge conflict disasters with a Try-And-Revert safety engine.
+- **Simplified Git Operations:** Replaces chained commands with single commands for linking, pushing, and stashing.
+- **Undo Operations:** Safely undo commits, un-queue files, or wipe local changes without any complex Git jargon.
+- **Safe Branch Switching:** Safely traverse branches with `jump`. Auto-stashes messy code and prevents merge conflict disasters with a Try-And-Revert safety engine.
 - **State Management:** A human-readable interface over `git stash`. States are named and listed by index so you never have to remember cryptic stash references.
 - **Custom Defaults:** Save your preferred branch name and commit message locally so you never have to type them again.
 - **Auto-Update Checker:** Silently checks for newer versions in the background and notifies you, without slowing down your commands.
 - **SSH Auto-Setup:** Generates an SSH key, adds it to `ssh-agent`, and opens your GitHub settings automatically.
 - **HTTPS to SSH Conversion:** Silently converts the remote to SSH before pushing if your SSH is configured.
-- **Termux Compatibility:** Works natively on Android natively handling common issues like dubious ownership errors.
+- **Termux Compatibility:** Works on Android via Termux, handling common issues like dubious ownership errors out of the box.
 
 ---
 
@@ -94,16 +107,38 @@ GitGo provides a CLI environment designed for faster and simpler Git workflows.
 ### Prerequisites
 
 - **Python 3.8+**
-- **Git 2.x+** — [git-scm.com](https://git-scm.com)
-- **OpenSSH** — required for `gitgo user login` (pre-installed on most systems)
+- **Git 2.x+**: [git-scm.com](https://git-scm.com)
+- **OpenSSH**: required for `gitgo user login` (pre-installed on most systems)
 - A **GitHub account**
 
 ### Install from PyPI
 
+For Windows users or environments without global pip restrictions, you can install GitGo directly via pip:
+
 ```bash
 pip install pygitgo
 ```
 
+*(Alternatively, you can use `pipx install pygitgo` if you prefer isolated environments).*
+
+### Install via pipx (Cross-Platform)
+
+If you already have `pipx` installed, you can use it to safely install GitGo on any operating system:
+
+```bash
+pipx install pygitgo
+```
+
+### Quick Install (Linux & macOS)
+
+The easiest way to install GitGo on Unix systems without worrying about Python environments or PEP 668 restrictions is using our install script:
+
+```bash
+curl -sSL https://raw.githubusercontent.com/Huerte/GitGo/main/install.sh | bash
+```
+
+This will automatically create an isolated environment and place `gitgo` in your `~/.local/bin` folder.
+
 Verify the installation:
 
 ```bash
@@ -142,13 +177,13 @@ gitgo link https://github.com/username/repo.git "Initial commit"
 gitgo push main "Fix auth bug"
 
 # Create a new branch and push
-gitgo push -n feature/login "Add login flow"
+gitgo push -n feat/login "Add login flow"
 ```
 
 ### 4. Safely Switch Branches
 Jump to a different branch without worrying about your uncommitted changes. GitGo will safely stash them, hop to the new branch, sync with `main`, and carefully unpack them.
 ```bash
-gitgo jump feature/new-login
+gitgo jump feat/new-login
 ```
 
 ### 5. Safely Undo Mistakes
@@ -225,7 +260,7 @@ gitgo jump <branch>
 
 ### `gitgo undo`
 
-Safely undo recent actions and mistakes using simple, human-readable commands.
+Safely undo recent actions and mistakes using plain commands that say exactly what they do.
 
 ```bash
 gitgo undo commit    # Undo your last commit without losing files
@@ -235,7 +270,7 @@ gitgo undo changes   # Permanently wipe all new files and local edits
 
 ### `gitgo state`
 
-A human-readable interface over `git stash`.
+A named interface over `git stash`.
 
 ```bash
 gitgo state list              # show all saved states
@@ -291,13 +326,9 @@ gitgo -r        # verify GitGo is ready
 
 ## Contributing
 
-Contributions are welcome and appreciated!
-
-1. Fork the Project
-2. Create a Feature Branch (`git checkout -b feature/your-feature`)
-3. Commit Changes
-4. Push to the Branch (`git push origin feature/your-feature`)
-5. Open a Pull Request
+Contributions are welcome. Read [CONTRIBUTING.md](CONTRIBUTING.md) for the full guide,
+including project structure, test instructions, commit conventions, and a
+[Good First Issues](CONTRIBUTING.md#good-first-issues) table if you are not sure where to start.
 
 ---
 
@@ -314,18 +345,6 @@ Contributions are welcome and appreciated!
 
 ---
 
-## Support
-
-If GitGo saves you time, consider buying me a coffee. It helps keep the project going.
-
-<div align="center">
-  <a href="https://ko-fi.com/huerte">
-    <img src="https://ko-fi.com/img/githubbutton_sm.svg" alt="Support on Ko-fi" />
-  </a>
-</div>
-
----
-
 ## License
 
 Distributed under the **GPLv3** License. See [`LICENSE`](LICENSE) for details.

{pygitgo-1.6.0 → pygitgo-1.6.2}/README.md

@@ -1,6 +1,6 @@
 <div align="center">
 
-# GitGo
+![GitGo Banner](assets/banner.png)
 
 [![Tests](https://github.com/Huerte/GitGo/actions/workflows/tests.yml/badge.svg)](https://github.com/Huerte/GitGo/actions)
 [![PyPI version](https://img.shields.io/pypi/v/pygitgo?color=blue&label=PyPI)](https://pypi.org/project/pygitgo)
@@ -14,6 +14,14 @@
 
 <a href="https://github.com/Huerte/GitGo/issues">Report Bug</a> · <a href="https://github.com/Huerte/GitGo/issues">Request Feature</a>
 
+<br />
+
+If GitGo saves you time, consider buying me a coffee. It helps keep the project going.
+
+<a href="https://ko-fi.com/huerte">
+  <img src="https://ko-fi.com/img/githubbutton_sm.svg" alt="Support on Ko-fi" />
+</a>
+
 </div>
 
 ---
@@ -39,7 +47,10 @@ gitgo link https://github.com/username/repo.git "init"
 - [Command Reference](#command-reference)
 - [How It Works](#how-it-works)
 - [Contributing](#contributing)
+- [Credits](#credits)
 - [License](#license)
+- [Changelog](CHANGELOG.md)
+- [Contributing Guide](CONTRIBUTING.md)
 
 ---
 
@@ -51,17 +62,18 @@ gitgo link https://github.com/username/repo.git "init"
 
 ## Features
 
-GitGo provides a CLI environment designed for faster and simpler Git workflows. Built to be intuitive, fast, and frictionless.
+GitGo provides a CLI environment designed for faster and simpler Git workflows.
+No chained commands, no cryptic flags — just short commands you can actually remember.
 
-- **Simplified Git Operations:** Replaces chained commands with single intuitive commands for linking, pushing, and stashing.
-- **Easy Undo Operations:** Safely undo commits, un-queue files, or wipe local changes without any complex Git jargon.
-- **Smart Branch Hopping:** Safely traverse branches with `jump`. Auto-stashes messy code and prevents merge conflict disasters with a Try-And-Revert safety engine.
+- **Simplified Git Operations:** Replaces chained commands with single commands for linking, pushing, and stashing.
+- **Undo Operations:** Safely undo commits, un-queue files, or wipe local changes without any complex Git jargon.
+- **Safe Branch Switching:** Safely traverse branches with `jump`. Auto-stashes messy code and prevents merge conflict disasters with a Try-And-Revert safety engine.
 - **State Management:** A human-readable interface over `git stash`. States are named and listed by index so you never have to remember cryptic stash references.
 - **Custom Defaults:** Save your preferred branch name and commit message locally so you never have to type them again.
 - **Auto-Update Checker:** Silently checks for newer versions in the background and notifies you, without slowing down your commands.
 - **SSH Auto-Setup:** Generates an SSH key, adds it to `ssh-agent`, and opens your GitHub settings automatically.
 - **HTTPS to SSH Conversion:** Silently converts the remote to SSH before pushing if your SSH is configured.
-- **Termux Compatibility:** Works natively on Android natively handling common issues like dubious ownership errors.
+- **Termux Compatibility:** Works on Android via Termux, handling common issues like dubious ownership errors out of the box.
 
 ---
 
@@ -70,16 +82,38 @@ GitGo provides a CLI environment designed for faster and simpler Git workflows.
 ### Prerequisites
 
 - **Python 3.8+**
-- **Git 2.x+** — [git-scm.com](https://git-scm.com)
-- **OpenSSH** — required for `gitgo user login` (pre-installed on most systems)
+- **Git 2.x+**: [git-scm.com](https://git-scm.com)
+- **OpenSSH**: required for `gitgo user login` (pre-installed on most systems)
 - A **GitHub account**
 
 ### Install from PyPI
 
+For Windows users or environments without global pip restrictions, you can install GitGo directly via pip:
+
 ```bash
 pip install pygitgo
 ```
 
+*(Alternatively, you can use `pipx install pygitgo` if you prefer isolated environments).*
+
+### Install via pipx (Cross-Platform)
+
+If you already have `pipx` installed, you can use it to safely install GitGo on any operating system:
+
+```bash
+pipx install pygitgo
+```
+
+### Quick Install (Linux & macOS)
+
+The easiest way to install GitGo on Unix systems without worrying about Python environments or PEP 668 restrictions is using our install script:
+
+```bash
+curl -sSL https://raw.githubusercontent.com/Huerte/GitGo/main/install.sh | bash
+```
+
+This will automatically create an isolated environment and place `gitgo` in your `~/.local/bin` folder.
+
 Verify the installation:
 
 ```bash
@@ -118,13 +152,13 @@ gitgo link https://github.com/username/repo.git "Initial commit"
 gitgo push main "Fix auth bug"
 
 # Create a new branch and push
-gitgo push -n feature/login "Add login flow"
+gitgo push -n feat/login "Add login flow"
 ```
 
 ### 4. Safely Switch Branches
 Jump to a different branch without worrying about your uncommitted changes. GitGo will safely stash them, hop to the new branch, sync with `main`, and carefully unpack them.
 ```bash
-gitgo jump feature/new-login
+gitgo jump feat/new-login
 ```
 
 ### 5. Safely Undo Mistakes
@@ -201,7 +235,7 @@ gitgo jump <branch>
 
 ### `gitgo undo`
 
-Safely undo recent actions and mistakes using simple, human-readable commands.
+Safely undo recent actions and mistakes using plain commands that say exactly what they do.
 
 ```bash
 gitgo undo commit    # Undo your last commit without losing files
@@ -211,7 +245,7 @@ gitgo undo changes   # Permanently wipe all new files and local edits
 
 ### `gitgo state`
 
-A human-readable interface over `git stash`.
+A named interface over `git stash`.
 
 ```bash
 gitgo state list              # show all saved states
@@ -267,13 +301,9 @@ gitgo -r        # verify GitGo is ready
 
 ## Contributing
 
-Contributions are welcome and appreciated!
-
-1. Fork the Project
-2. Create a Feature Branch (`git checkout -b feature/your-feature`)
-3. Commit Changes
-4. Push to the Branch (`git push origin feature/your-feature`)
-5. Open a Pull Request
+Contributions are welcome. Read [CONTRIBUTING.md](CONTRIBUTING.md) for the full guide,
+including project structure, test instructions, commit conventions, and a
+[Good First Issues](CONTRIBUTING.md#good-first-issues) table if you are not sure where to start.
 
 ---
 
@@ -290,18 +320,6 @@ Contributions are welcome and appreciated!
 
 ---
 
-## Support
-
-If GitGo saves you time, consider buying me a coffee. It helps keep the project going.
-
-<div align="center">
-  <a href="https://ko-fi.com/huerte">
-    <img src="https://ko-fi.com/img/githubbutton_sm.svg" alt="Support on Ko-fi" />
-  </a>
-</div>
-
----
-
 ## License
 
 Distributed under the **GPLv3** License. See [`LICENSE`](LICENSE) for details.

{pygitgo-1.6.0 → pygitgo-1.6.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pygitgo"
-version = "1.6.0"
+version = "1.6.2"
 description = "GitGo CLI - Your Fast Git Companion. Simplifies git push, link, stash, and user management."
 readme = "README.md"
 license = {text = "GPL-3.0-or-later"}
@@ -29,6 +29,7 @@ dependencies = [
 dev = [
     "pytest>=7.0",
     "pytest-mock>=3.10",
+    "pytest-cov>=4.0"
 ]
 
 [project.urls]
@@ -40,3 +41,7 @@ gitgo = "pygitgo.main:main"
 
 [tool.setuptools.packages.find]
 where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "--cov=pygitgo --cov-report=term-missing"

{pygitgo-1.6.0 → pygitgo-1.6.2}/src/pygitgo/commands/git_operations.py

@@ -2,6 +2,7 @@ from pygitgo.auth.ssh_utils import convert_https_to_ssh, is_ssh_url, check_conne
 from pygitgo.utils.colors import info, success, warning, error
 from pygitgo.utils.executor import run_command
 from pygitgo.utils.config import get_config
+from pygitgo.exceptions import GitGoError
 from argparse import Namespace
 import subprocess
 import sys
@@ -11,7 +12,7 @@ import os
 def get_status_content():
     status = run_command(["git", "status", "--porcelain"], allow_fail=True)
     if isinstance(status, subprocess.CalledProcessError) or not status.strip():
-        sys.exit(1)
+        raise GitGoError("\nWorking tree is clean. Nothing to commit.\n")
     return status
 
 def get_current_branch():
@@ -41,7 +42,7 @@ def git_new_branch(branch):
             from pygitgo.commands.jump import jump_operation
             jump_operation(Namespace(branch=branch))
         else:
-            sys.exit(1)
+            raise GitGoError(f"\nOperation canceled. Branch '{branch}' already exists.\n")
     else:
         success(f"\nBranch '{branch}' created.\n")
 
@@ -161,7 +162,7 @@ def git_push(branch):
         if "rebase in progress" in str(e):
             handle_rebase()
         else:
-            sys.exit(1)
+            raise GitGoError()
 
 
 def handle_rebase():
@@ -175,6 +176,6 @@ def handle_rebase():
         info("    git add <files>")
         info("    git rebase --continue")
         warning("When finished, run 'gitgo push <branch> <message>' again.\n")
-        sys.exit(1)
+        raise GitGoError()
 
     return True

{pygitgo-1.6.0 → pygitgo-1.6.2}/src/pygitgo/commands/jump.py

@@ -1,3 +1,4 @@
+from pygitgo.exceptions import GitGoError
 from pygitgo.commands.git_operations import (
     is_branch_exist, get_current_branch, git_new_branch, get_main_branch
 )
@@ -30,12 +31,11 @@ def jump_operation(args):
     
     if original_branch == target_branch:
         warning(f"\nYou are already on branch '{target_branch}'.\n")
-        sys.exit(0)
+        return
 
     has_changes = run_command(['git', 'status', '--porcelain'], allow_fail=True, loading_msg="Checking for uncommitted changes...")
     if isinstance(has_changes, subprocess.CalledProcessError):
-        warning("\nUnable to check for uncommitted changes. Please ensure you're in a valid git repository.")
-        sys.exit(1)
+        raise GitGoError("\nUnable to check for uncommitted changes. Please ensure you're in a valid git repository.\n")
     
     stashed_code = False
     if has_changes.strip():
@@ -43,12 +43,12 @@ def jump_operation(args):
         user_input = input("Do you want to move these changes to your new branch? (y/n): ").strip().lower()
         if user_input != 'y':
             warning("\nYou cannot switch branches with unsaved changes. Jump canceled.\n")
-            sys.exit(0)
+            return
         else:
             stash_result = run_command(["git", "stash", "push", "-u", "-m", "GitGo Jump Auto-Stash"], allow_fail=True, loading_msg="Saving your changes before jumping...")
             if isinstance(stash_result, subprocess.CalledProcessError):
                 warning("\nFailed to save your changes. Please resolve any issues and try again.")
-                sys.exit(1)
+                raise GitGoError()
             info("\nYour changes have been saved. Jumping to the new branch...")
             stashed_code = True
             
@@ -61,7 +61,7 @@ def jump_operation(args):
             info("Exiting without jumping...\n")
             if stashed_code:
                 run_command(["git", "stash", "pop"], loading_msg="Putting your unsaved changes back...")
-            sys.exit(0)
+            return
         
         git_new_branch(target_branch)
         created_branch = target_branch
@@ -76,7 +76,7 @@ def jump_operation(args):
         user_input = input("Do you want to stay on the new branch without the latest updates? (y/n): ").strip().lower()
         if user_input != 'y':
             undo_jump_operation(original_branch, stashed_code, created_branch)
-            sys.exit(1)
+            raise GitGoError()
         else:
             success(f"\nOkay! You are on the new branch, but without the latest updates from '{main_branch}'.")
 
@@ -91,17 +91,18 @@ def jump_operation(args):
 
             if conflict_choice != 'y':
                 undo_jump_operation(original_branch, stashed_code, created_branch)
-                sys.exit(0)
+                return
             else:
                 success("\nOkay! You are on the new branch with your code.")
                 warning("Please open your code editor RIGHT NOW to fix the conflicts!")
                 info("Your stash backup is still saved. Run 'gitgo state list' to see it.\n")
-                sys.exit(0)
+                return
         else:
             run_command(["git", "stash", "drop"], allow_fail=True, loading_msg="Cleaning up the temporary stash...")
             success(f"\nSuccess! You are now on '{target_branch}'.")
             success("Your unsaved code was moved here safely!\n")
-            sys.exit(0)
+            return
     else:
         success(f"\nSuccess! You are now on '{target_branch}'.\n")
-        sys.exit(0)
+        return
+        

{pygitgo-1.6.0 → pygitgo-1.6.2}/src/pygitgo/commands/pull.py

@@ -1,3 +1,4 @@
+from pygitgo.exceptions import GitGoError
 from pygitgo.utils.colors import success, warning, error, info
 from pygitgo.utils.executor import run_command
 from pygitgo.exceptions import GitCommandError
@@ -17,7 +18,7 @@ def pull_operation(args):
         if isinstance(remote_refs, subprocess.CalledProcessError) or not remote_refs.strip():
             error(f"\nFailed! The branch '{branch}' does not exist on the remote server.")
             warning("You might need to push your local branch first.\n")
-            sys.exit(1)
+            raise GitGoError()
 
         run_command(
             ["git", "pull", "--rebase", "--autostash", "origin", branch], 
@@ -35,9 +36,10 @@ def pull_operation(args):
             info("2. Fix the red conflict lines in your files.")
             info("3. Save the files.")
             info("4. Run this command to finish:  git rebase --continue\n")
-            sys.exit(1)
+            raise GitGoError()
         else:
-            error("\nFailed to pull updates from the server!")
-            error("Please check your internet connection and try again.")
-            error(f"Details: {e}\n")
-            sys.exit(1)
+            raise GitGoError(
+                "\nFailed to pull updates from the server!"
+                "Please check your internet connection and try again."
+                f"Details: {e}\n"
+            )

{pygitgo-1.6.0 → pygitgo-1.6.2}/src/pygitgo/commands/state.py

@@ -1,3 +1,4 @@
+from pygitgo.exceptions import GitGoError
 from pygitgo.utils.colors import info, highlight, error, warning, success
 from pygitgo.utils.executor import run_command
 import sys
@@ -19,7 +20,7 @@ def all_save_state():
 
     if not output:
         info("\nNo saved states found.\n")
-        sys.exit(0)
+        return
 
     save_states = []
 
@@ -88,7 +89,7 @@ def ask_state_id(save_states):
         state_id = input(">> ").strip().lower()
         if state_id == 'q':
             warning("\nLoad operation cancelled by user.\n")
-            sys.exit(0)
+            return
         proceed = validate_state_id(state_id, save_states)
     
     return state_id
@@ -106,10 +107,9 @@ def load_state(state_id=None):
         if state_id.isdigit():
             proceed = validate_state_id(state_id, save_states)
             if not proceed:
-                sys.exit(1)
+                raise GitGoError()
         else:
-            error(f"\nInvalid argument '{state_id}' for load operation. Expected a state ID.\n")
-            sys.exit(1)
+            raise GitGoError(f"\nInvalid argument '{state_id}' for load operation. Expected a state ID.\n")
     
     if not proceed:
         state_id = ask_state_id(save_states)
@@ -141,18 +141,17 @@ def delete_state(identifier=None):
             if confirm.lower() == 'y':
                 run_command(["git", "stash", "clear"])
                 success("\nAll saved states deleted successfully.\n")
-                sys.exit(0)
+                return
             else:
                 warning("\nDelete operation cancelled by user.\n")
-                sys.exit(0)
+                return
         
         elif not identifier.isdigit():
-            error("\nInvalid input. Please enter a valid state ID.\n")
-            sys.exit(1)
+            raise GitGoError("\nInvalid input. Please enter a valid state ID.\n")
 
         state_id = identifier
         if not validate_state_id(state_id, all_save_state()):
-            sys.exit(1)
+            raise GitGoError()
     
     run_command(["git", "stash", "drop", str(int(state_id) - 1)])
     success(f"\nState with ID '{state_id}' deleted successfully.\n")
@@ -173,5 +172,4 @@ def state_operations(args):
     elif action == "delete":
         delete_state(identifier)
     else:
-        error(f"\nUnknown state operation: {action}\n")
-        sys.exit(1)
+        raise GitGoError(f"\nUnknown state operation: {action}\n")

{pygitgo-1.6.0 → pygitgo-1.6.2}/src/pygitgo/commands/undo.py

@@ -1,3 +1,4 @@
+from pygitgo.exceptions import GitGoError
 from pygitgo.utils.colors import success, warning, error, info
 from pygitgo.exceptions import GitCommandError
 from pygitgo.utils.executor import run_command
@@ -9,18 +10,15 @@ def undo_commit():
         run_command(["git", "reset", "--soft", "HEAD~"])
         success("\nSuccess! Your last commit is undone. Your files are safe.\n")
     except GitCommandError as e:
-        error("\nFailed! You might not have any previous commits to undo yet.")
-        error(f"Details: {e}\n")
-        sys.exit(1)
+        raise GitGoError(
+            "\nFailed! You might not have any previous commits to undo yet."
+            f"Details: {e}\n"
+        )
     
 
 def undo_add():
-    try:
-        run_command(["git", "reset", "HEAD"])
-        success("\nSuccess! Files are no longer ready to commit.\n")
-    except GitCommandError as e:
-        error(f"\n{e}\n")
-        sys.exit(1)
+    run_command(["git", "reset", "HEAD"])
+    success("\nSuccess! Files are no longer ready to commit.\n")
 
 
 def undo_changes():
@@ -29,14 +27,11 @@ def undo_changes():
     if confirm.lower() != "y":
         info("\nCanceled. Your files are safe.\n")
         return
-    try:
-        run_command(["git", "reset", "--hard", "HEAD"], loading_msg="Throwing away edits...")
-        run_command(["git", "clean", "-fd"], loading_msg="Removing new files...")
+    
+    run_command(["git", "reset", "--hard", "HEAD"], loading_msg="Throwing away edits...")
+    run_command(["git", "clean", "-fd"], loading_msg="Removing new files...")
         
-        success("\nSuccess! All changes are completely gone. You have a clean start.\n")
-    except GitCommandError as e:
-        error(f"\n{e}\n")
-        sys.exit(1)
+    success("\nSuccess! All changes are completely gone. You have a clean start.\n")
 
 
 def undo_operations(args):
@@ -49,5 +44,5 @@ def undo_operations(args):
     elif action == "changes":
         undo_changes()
     else:
-        error(f"\nUnknown undo operation: {action}\n")
-        sys.exit(1)
+        raise GitGoError(f"\nUnknown undo operation: {action}\n")
+        

{pygitgo-1.6.0 → pygitgo-1.6.2}/src/pygitgo/main.py

@@ -38,10 +38,11 @@ def link_operation(args):
     repo_url = args.url
 
     if not validate_repo_url(repo_url):
-        error("\nInvalid repository URL!")
-        warning("Expected format: https://github.com/username/repo.git")
-        warning("             or: git@github.com:username/repo.git\n")
-        sys.exit(1)
+        raise GitGoError(
+            "\nInvalid repository URL!\n"
+            "Expected format: https://github.com/username/repo.git"
+            "             or: git@github.com:username/repo.git\n"
+        )
 
     commit_message = args.message
     
@@ -106,8 +107,7 @@ def push_operation(args):
 
     if args.new:
         if not branch:
-            error("\nBranch name required when using --new flag!\n")
-            sys.exit(1)
+            raise GitGoError("\nBranch name required when using --new flag!\n")
         git_new_branch(branch)
     else:
         if branch and not message and not is_branch_exist(branch):
@@ -121,8 +121,7 @@ def push_operation(args):
                 warning(f"You are currently on branch '{current_branch}', not '{branch}'.")
                 user_choice = input(f"Do you want to switch to branch '{branch}'? (y/n): ").lower()
                 if user_choice != 'y':
-                    error("\nPush aborted to prevent committing to the wrong branch.\n")
-                    sys.exit(1)
+                    raise GitGoError("\nPush aborted to prevent committing to the wrong branch.\n")
                 jump_operation(Namespace(branch=branch))
     
         elif not branch:
@@ -200,15 +199,14 @@ def user_management(args):
 
     if not action:
         display_current_user()
-        sys.exit(0)
+        return
     
     if action == 'login':
         login()
     elif action == 'logout':
         logout()
     else:
-        error(f"\nInvalid user operation '{action}'!\n")
-        sys.exit(1)
+        raise GitGoError(f"\nInvalid user operation '{action}'!\n")
 
 
 def get_version():
@@ -226,7 +224,7 @@ def main():
         epilog="Use 'gitgo <command> -h' for help on a specific command."
     )
     
-    parser.add_argument("-v", "-V", "--version", action="version", version=f"GitGo {get_version()}\nSupport GitGo: https://ko-fi.com/huerte")
+    parser.add_argument("-v", "-V", "--version", action="store_true", help="show program's version number and exit")
     parser.add_argument("-r", "--ready", action="store_true", help="Check tool readiness")
 
     subparsers = parser.add_subparsers(title="Commands", dest="command")
@@ -329,13 +327,18 @@ def main():
 
     args = parser.parse_args()
 
+    if getattr(args, 'version', False):
+        print(f"GitGo {get_version()}")
+        print(f"Support GitGo: https://ko-fi.com/huerte")
+        return
+
     if args.ready:
         info("\nALL UNITS ONLINE. GitGo STANDING BY. AWAITING COMMANDS...\n")
-        sys.exit(0)
+        return
 
     if not args.command:
         parser.print_help()
-        sys.exit(0)
+        return
 
     ensure_first_run_setup()
     check_for_updates_background(get_version())
@@ -358,7 +361,7 @@ def main():
         elif args.command == "pull":
             pull_operation(args)
     except GitGoError as e:
-        error(f"\n{e}\n")
+        error(f"{e}")
         sys.exit(1)
 
 if __name__ == "__main__":

{pygitgo-1.6.0 → pygitgo-1.6.2}/src/pygitgo/utils/setup.py

@@ -1,3 +1,4 @@
+from pygitgo.exceptions import GitGoError
 from pygitgo.auth.ssh_utils import ensure_github_known_host
 from pygitgo.utils.config import get_config, set_config
 from pygitgo.utils.colors import error, info
@@ -11,7 +12,7 @@ def check_git_installed():
         error("\nGit is not installed or not found on your PATH!")
         info("Install Git from: https://git-scm.com/downloads")
         info("After installing, restart your terminal and try again.\n")
-        sys.exit(1)
+        raise GitGoError()
 
 
 def ensure_first_run_setup():

{pygitgo-1.6.0 → pygitgo-1.6.2/src/pygitgo.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pygitgo
-Version: 1.6.0
+Version: 1.6.2
 Summary: GitGo CLI - Your Fast Git Companion. Simplifies git push, link, stash, and user management.
 Author: Huerte
 License: GPL-3.0-or-later
@@ -20,11 +20,12 @@ Requires-Dist: pick>=2.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-mock>=3.10; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
 Dynamic: license-file
 
 <div align="center">
 
-# GitGo
+![GitGo Banner](assets/banner.png)
 
 [![Tests](https://github.com/Huerte/GitGo/actions/workflows/tests.yml/badge.svg)](https://github.com/Huerte/GitGo/actions)
 [![PyPI version](https://img.shields.io/pypi/v/pygitgo?color=blue&label=PyPI)](https://pypi.org/project/pygitgo)
@@ -38,6 +39,14 @@ Dynamic: license-file
 
 <a href="https://github.com/Huerte/GitGo/issues">Report Bug</a> · <a href="https://github.com/Huerte/GitGo/issues">Request Feature</a>
 
+<br />
+
+If GitGo saves you time, consider buying me a coffee. It helps keep the project going.
+
+<a href="https://ko-fi.com/huerte">
+  <img src="https://ko-fi.com/img/githubbutton_sm.svg" alt="Support on Ko-fi" />
+</a>
+
 </div>
 
 ---
@@ -63,7 +72,10 @@ gitgo link https://github.com/username/repo.git "init"
 - [Command Reference](#command-reference)
 - [How It Works](#how-it-works)
 - [Contributing](#contributing)
+- [Credits](#credits)
 - [License](#license)
+- [Changelog](CHANGELOG.md)
+- [Contributing Guide](CONTRIBUTING.md)
 
 ---
 
@@ -75,17 +87,18 @@ gitgo link https://github.com/username/repo.git "init"
 
 ## Features
 
-GitGo provides a CLI environment designed for faster and simpler Git workflows. Built to be intuitive, fast, and frictionless.
+GitGo provides a CLI environment designed for faster and simpler Git workflows.
+No chained commands, no cryptic flags — just short commands you can actually remember.
 
-- **Simplified Git Operations:** Replaces chained commands with single intuitive commands for linking, pushing, and stashing.
-- **Easy Undo Operations:** Safely undo commits, un-queue files, or wipe local changes without any complex Git jargon.
-- **Smart Branch Hopping:** Safely traverse branches with `jump`. Auto-stashes messy code and prevents merge conflict disasters with a Try-And-Revert safety engine.
+- **Simplified Git Operations:** Replaces chained commands with single commands for linking, pushing, and stashing.
+- **Undo Operations:** Safely undo commits, un-queue files, or wipe local changes without any complex Git jargon.
+- **Safe Branch Switching:** Safely traverse branches with `jump`. Auto-stashes messy code and prevents merge conflict disasters with a Try-And-Revert safety engine.
 - **State Management:** A human-readable interface over `git stash`. States are named and listed by index so you never have to remember cryptic stash references.
 - **Custom Defaults:** Save your preferred branch name and commit message locally so you never have to type them again.
 - **Auto-Update Checker:** Silently checks for newer versions in the background and notifies you, without slowing down your commands.
 - **SSH Auto-Setup:** Generates an SSH key, adds it to `ssh-agent`, and opens your GitHub settings automatically.
 - **HTTPS to SSH Conversion:** Silently converts the remote to SSH before pushing if your SSH is configured.
-- **Termux Compatibility:** Works natively on Android natively handling common issues like dubious ownership errors.
+- **Termux Compatibility:** Works on Android via Termux, handling common issues like dubious ownership errors out of the box.
 
 ---
 
@@ -94,16 +107,38 @@ GitGo provides a CLI environment designed for faster and simpler Git workflows.
 ### Prerequisites
 
 - **Python 3.8+**
-- **Git 2.x+** — [git-scm.com](https://git-scm.com)
-- **OpenSSH** — required for `gitgo user login` (pre-installed on most systems)
+- **Git 2.x+**: [git-scm.com](https://git-scm.com)
+- **OpenSSH**: required for `gitgo user login` (pre-installed on most systems)
 - A **GitHub account**
 
 ### Install from PyPI
 
+For Windows users or environments without global pip restrictions, you can install GitGo directly via pip:
+
 ```bash
 pip install pygitgo
 ```
 
+*(Alternatively, you can use `pipx install pygitgo` if you prefer isolated environments).*
+
+### Install via pipx (Cross-Platform)
+
+If you already have `pipx` installed, you can use it to safely install GitGo on any operating system:
+
+```bash
+pipx install pygitgo
+```
+
+### Quick Install (Linux & macOS)
+
+The easiest way to install GitGo on Unix systems without worrying about Python environments or PEP 668 restrictions is using our install script:
+
+```bash
+curl -sSL https://raw.githubusercontent.com/Huerte/GitGo/main/install.sh | bash
+```
+
+This will automatically create an isolated environment and place `gitgo` in your `~/.local/bin` folder.
+
 Verify the installation:
 
 ```bash
@@ -142,13 +177,13 @@ gitgo link https://github.com/username/repo.git "Initial commit"
 gitgo push main "Fix auth bug"
 
 # Create a new branch and push
-gitgo push -n feature/login "Add login flow"
+gitgo push -n feat/login "Add login flow"
 ```
 
 ### 4. Safely Switch Branches
 Jump to a different branch without worrying about your uncommitted changes. GitGo will safely stash them, hop to the new branch, sync with `main`, and carefully unpack them.
 ```bash
-gitgo jump feature/new-login
+gitgo jump feat/new-login
 ```
 
 ### 5. Safely Undo Mistakes
@@ -225,7 +260,7 @@ gitgo jump <branch>
 
 ### `gitgo undo`
 
-Safely undo recent actions and mistakes using simple, human-readable commands.
+Safely undo recent actions and mistakes using plain commands that say exactly what they do.
 
 ```bash
 gitgo undo commit    # Undo your last commit without losing files
@@ -235,7 +270,7 @@ gitgo undo changes   # Permanently wipe all new files and local edits
 
 ### `gitgo state`
 
-A human-readable interface over `git stash`.
+A named interface over `git stash`.
 
 ```bash
 gitgo state list              # show all saved states
@@ -291,13 +326,9 @@ gitgo -r        # verify GitGo is ready
 
 ## Contributing
 
-Contributions are welcome and appreciated!
-
-1. Fork the Project
-2. Create a Feature Branch (`git checkout -b feature/your-feature`)
-3. Commit Changes
-4. Push to the Branch (`git push origin feature/your-feature`)
-5. Open a Pull Request
+Contributions are welcome. Read [CONTRIBUTING.md](CONTRIBUTING.md) for the full guide,
+including project structure, test instructions, commit conventions, and a
+[Good First Issues](CONTRIBUTING.md#good-first-issues) table if you are not sure where to start.
 
 ---
 
@@ -314,18 +345,6 @@ Contributions are welcome and appreciated!
 
 ---
 
-## Support
-
-If GitGo saves you time, consider buying me a coffee. It helps keep the project going.
-
-<div align="center">
-  <a href="https://ko-fi.com/huerte">
-    <img src="https://ko-fi.com/img/githubbutton_sm.svg" alt="Support on Ko-fi" />
-  </a>
-</div>
-
----
-
 ## License
 
 Distributed under the **GPLv3** License. See [`LICENSE`](LICENSE) for details.

{pygitgo-1.6.0 → pygitgo-1.6.2}/src/pygitgo.egg-info/requires.txt

@@ -4,3 +4,4 @@ pick>=2.0
 [dev]
 pytest>=7.0
 pytest-mock>=3.10
+pytest-cov>=4.0

{pygitgo-1.6.0 → pygitgo-1.6.2}/tests/test_config.py

@@ -56,7 +56,7 @@ def test_config_operation_not_valid_keys(mocker):
     value = "true"
     args = Namespace(key=key, action="set", value=value)
 
-    assert capture_system_exit_code(lambda: config_operation(args)) is None
+    assert capture_system_exit_code(lambda: config_operation(args)) == 0
 
     fake_error.assert_called_with(f"\nInvalid configuration key: '{key}'")
     fake_warning.assert_called_with(f"Valid keys are: {', '.join(VALID_KEYS)}\n")

{pygitgo-1.6.0 → pygitgo-1.6.2}/tests/test_git_operations.py

@@ -44,10 +44,9 @@ def test_git_branch_exists_jump_no(mocker):
 
     branch_name = "existing-branch"
     
-    with pytest.raises(SystemExit) as exc_info:
+    from pygitgo.exceptions import GitGoError
+    with pytest.raises(GitGoError):
         git_new_branch(branch_name)
-    
-    assert exc_info.value.code == 1
     fake_error.assert_called_once_with(f"Failed to create branch '{branch_name}'! It may already exist.")
     fake_jump.assert_not_called()
 
@@ -199,10 +198,9 @@ def test_handle_rebase_conflict(mocker):
         return_value='rebase'
     )
 
-    with pytest.raises(SystemExit) as exc_info:
+    from pygitgo.exceptions import GitGoError
+    with pytest.raises(GitGoError):
         handle_rebase()
-    
-    assert exc_info.value.code == 1
 
     fake_run.assert_called_with(
         ["git", "status"], allow_fail=True

{pygitgo-1.6.0 → pygitgo-1.6.2}/tests/test_jump.py

@@ -57,8 +57,6 @@ def test_jump_operation_not_valid_repo(mocker):
     
     assert capture_system_exit_code(lambda: jump_operation(make_args('main'))) == 1
 
-    fake_warning.assert_called_with("\nUnable to check for uncommitted changes. Please ensure you're in a valid git repository.")
-
     fake_run.assert_any_call(['git', 'status', '--porcelain'], allow_fail=True, loading_msg="Checking for uncommitted changes...")
 
 def test_jump_operation_has_changes_exit(mocker):

{pygitgo-1.6.0 → pygitgo-1.6.2}/tests/test_pull.py

@@ -1,7 +1,7 @@
 import pytest
 from unittest.mock import patch, MagicMock
 from pygitgo.commands.pull import pull_operation
-from pygitgo.exceptions import GitCommandError
+from pygitgo.exceptions import GitCommandError, GitGoError
 from argparse import Namespace
 import subprocess
 
@@ -44,22 +44,16 @@ def test_pull_operation_success_with_branch(mock_success, mock_run_command):
     )
     mock_success.assert_called_once()
 
-@patch("pygitgo.commands.pull.sys.exit")
-@patch("pygitgo.commands.pull.error")
 @patch("pygitgo.commands.pull.run_command")
-def test_pull_operation_branch_not_found(mock_run_command, mock_error, mock_exit):
+def test_pull_operation_branch_not_found(mock_run_command):
     mock_run_command.return_value = subprocess.CalledProcessError(128, ["git", "ls-remote"])
     
     args = Namespace(branch="does-not-exist")
-    pull_operation(args)
-    
-    mock_exit.assert_called_once_with(1)
-    mock_error.assert_called()
+    with pytest.raises(GitGoError):
+        pull_operation(args)
 
-@patch("pygitgo.commands.pull.sys.exit")
-@patch("pygitgo.commands.pull.error")
 @patch("pygitgo.commands.pull.run_command")
-def test_pull_operation_merge_conflict(mock_run_command, mock_error, mock_exit):
+def test_pull_operation_merge_conflict(mock_run_command):
     conflict_err = GitCommandError(["git", "pull"], stderr="merge conflict in file.py")
 
     def side_effect_fn(*args, **kwargs):
@@ -71,7 +65,5 @@ def test_pull_operation_merge_conflict(mock_run_command, mock_error, mock_exit):
     mock_run_command.side_effect = side_effect_fn
     
     args = Namespace(branch="main")
-    pull_operation(args)
-    
-    mock_exit.assert_called_once_with(1)
-    mock_error.assert_any_call("\nMERGE CONFLICT DETECTED!")
+    with pytest.raises(GitGoError):
+        pull_operation(args)

{pygitgo-1.6.0 → pygitgo-1.6.2}/tests/test_setup.py

@@ -18,7 +18,7 @@ def test_check_git_installed_exist(mocker):
     fake_error = mocker.patch("pygitgo.utils.setup.error")
     fake_info = mocker.patch("pygitgo.utils.setup.info")
 
-    assert capture_system_exit_code(lambda: check_git_installed()) == None
+    assert capture_system_exit_code(lambda: check_git_installed()) == 0
 
     fake_error.assert_not_called()
     fake_info.assert_not_called()

{pygitgo-1.6.0 → pygitgo-1.6.2}/tests/test_state.py

@@ -49,10 +49,8 @@ def test_all_save_state_no_output(mocker):
     fake_run = mocker.patch("pygitgo.commands.state.run_command", return_value="")
     fake_info = mocker.patch("pygitgo.commands.state.info")
 
-    with pytest.raises(SystemExit) as exc_info:
-        all_save_state()
+    all_save_state()
 
-    assert exc_info.value.code == 0
     fake_info.assert_called_once_with("\nNo saved states found.\n")
     fake_run.assert_called_once_with([
         "git", "stash", "list",
@@ -124,22 +122,19 @@ def test_load_state_invalid_id(mocker):
     mocker.patch("pygitgo.commands.state.all_save_state", return_value=save_states)
     mocker.patch("pygitgo.commands.state.validate_state_id", return_value=False)
 
-    with pytest.raises(SystemExit) as exc_info:
+    from pygitgo.exceptions import GitGoError
+    with pytest.raises(GitGoError):
         load_state("100")
 
-    assert exc_info.value.code == 1
-
 def test_load_state_invalid_argument(mocker):
     save_states = [{"id": 1, "ref": "stash@{0}", "date": "date", "message": "msg"}]
     mocker.patch("pygitgo.commands.state.all_save_state", return_value=save_states)
     fake_error = mocker.patch("pygitgo.commands.state.error")
 
-    with pytest.raises(SystemExit) as exc_info:
+    from pygitgo.exceptions import GitGoError
+    with pytest.raises(GitGoError):
         load_state("invalid_arg")
 
-    assert exc_info.value.code == 1
-    fake_error.assert_called_once_with("\nInvalid argument 'invalid_arg' for load operation. Expected a state ID.\n")
-
 def test_load_state_no_args(mocker):
     save_states = [{"id": 1, "ref": "stash@{0}", "date": "date", "message": "msg"},
                    {"id": 2, "ref": "stash@{1}", "date": "date2", "message": "msg2"}]
@@ -178,10 +173,8 @@ def test_delete_state_all_confirm(mocker):
     fake_run = mocker.patch("pygitgo.commands.state.run_command")
     fake_success = mocker.patch("pygitgo.commands.state.success")
 
-    with pytest.raises(SystemExit) as exc_info:
-        delete_state("-a")
+    delete_state("-a")
 
-    assert exc_info.value.code == 0
     fake_run.assert_called_once_with(["git", "stash", "clear"])
     fake_success.assert_called_once_with("\nAll saved states deleted successfully.\n")
 
@@ -189,21 +182,17 @@ def test_delete_state_all_cancel(mocker):
     mocker.patch("builtins.input", return_value="n")
     fake_warning = mocker.patch("pygitgo.commands.state.warning")
 
-    with pytest.raises(SystemExit) as exc_info:
-        delete_state("-a")
+    delete_state("-a")
 
-    assert exc_info.value.code == 0
     fake_warning.assert_called_once_with("\nDelete operation cancelled by user.\n")
 
 def test_delete_state_invalid_id(mocker):
     fake_error = mocker.patch("pygitgo.commands.state.error")
     
-    with pytest.raises(SystemExit) as exc_info:
+    from pygitgo.exceptions import GitGoError
+    with pytest.raises(GitGoError):
         delete_state("abc")
 
-    assert exc_info.value.code == 1
-    fake_error.assert_called_once_with("\nInvalid input. Please enter a valid state ID.\n")
-
 def test_delete_state_specific_id(mocker):
     mocker.patch("pygitgo.commands.state.validate_state_id", return_value=True)
     mocker.patch("pygitgo.commands.state.all_save_state", return_value=[])

{pygitgo-1.6.0 → pygitgo-1.6.2}/tests/test_undo.py

@@ -1,7 +1,7 @@
 import pytest
 from unittest.mock import patch, MagicMock
 from pygitgo.commands.undo import undo_commit, undo_add, undo_changes, undo_operations
-from pygitgo.exceptions import GitCommandError
+from pygitgo.exceptions import GitGoError, GitCommandError
 from argparse import Namespace
 
 @patch("pygitgo.commands.undo.run_command")
@@ -12,15 +12,12 @@ def test_undo_commit_success(mock_success, mock_run_command):
     mock_success.assert_called_once()
 
 
-@patch("pygitgo.commands.undo.sys.exit")
-@patch("pygitgo.commands.undo.error")
 @patch("pygitgo.commands.undo.run_command")
-def test_undo_commit_failure(mock_run_command, mock_error, mock_exit):
+def test_undo_commit_failure(mock_run_command):
     mock_run_command.side_effect = GitCommandError(["git", "reset", "--soft", "HEAD~"])
-    undo_commit()
+    with pytest.raises(GitGoError):
+        undo_commit()
     mock_run_command.assert_called_once()
-    assert mock_error.call_count == 2
-    mock_exit.assert_called_once_with(1)
 
 
 @patch("pygitgo.commands.undo.run_command")
@@ -31,15 +28,12 @@ def test_undo_add_success(mock_success, mock_run_command):
     mock_success.assert_called_once()
 
 
-@patch("pygitgo.commands.undo.sys.exit")
-@patch("pygitgo.commands.undo.error")
 @patch("pygitgo.commands.undo.run_command")
-def test_undo_add_failure(mock_run_command, mock_error, mock_exit):
+def test_undo_add_failure(mock_run_command):
     mock_run_command.side_effect = GitCommandError(["git", "reset", "HEAD"])
-    undo_add()
+    with pytest.raises(GitCommandError):
+        undo_add()
     mock_run_command.assert_called_once()
-    mock_error.assert_called_once()
-    mock_exit.assert_called_once_with(1)
 
 
 @patch("pygitgo.commands.undo.run_command")
@@ -85,10 +79,7 @@ def test_undo_operations_changes(mock_undo_changes):
     mock_undo_changes.assert_called_once()
 
 
-@patch("pygitgo.commands.undo.sys.exit")
-@patch("pygitgo.commands.undo.error")
-def test_undo_operations_invalid(mock_error, mock_exit):
+def test_undo_operations_invalid():
     args = Namespace(action="invalid")
-    undo_operations(args)
-    mock_error.assert_called_once()
-    mock_exit.assert_called_once_with(1)
+    with pytest.raises(GitGoError):
+        undo_operations(args)