gitupdt 1.0.0

A git repository updater

gitupdt

A Python tool for easily updating Git repositories. It checks for updates in remote repositories and allows you to pull branches or switch to tags through an interactive menu.

This tool is intended for use in execution-only repositories that are cloned for software usage purposes, without making edits. It is not recommended for use in development repositories.

Features

• Remote update check: Check if there are updates in the remote repository
• Interactive selection menu: Interactive CLI powered by questionary
• Branch pull: Update the current branch to the latest state
• Checkout to tag: Switch to a specified version tag
• Reset mode: Use git reset --hard with the --reset option to update
• requirements.txt change display and installation: Display changes in dependency files and support automatic installation
• Automatic virtual environment detection: Automatically detect .venv or venv folders and display appropriate Python interpreter options
• Repository maintenance: Automatically run git gc --auto after updates

Installation

pip install gitupdt

Usage

Update repository in current directory

gitupdt

Update repository at specified path

gitupdt /path/to/repo

Update with reset mode

When you specify the --reset option, it uses git reset --hard instead of git checkout or git pull to update. This is useful for forcibly overwriting a local file with a remote one when the local file is corrupted.

gitupdt --reset

gitupdt /path/to/repo --reset

Available Actions

When you run the tool, you can select from the following actions:

1. Checkout and Pull latest remote: Checkout and pull the remote default branch
2. Pull: Update the current branch to the latest state (when behind remote)
3. Checkout to tag: Switch to a specified version tag (select from latest or past tags)

Automatic Installation on requirements.txt Changes

When there are changes in requirements.txt, the following process occurs:

1. Changes are displayed in unified diff format
2. You are prompted whether to install the updated requirements.txt
3. You can select the appropriate Python interpreter:
   • Currently running Python
   • Detected virtual environment (.venv or venv) Python
4. pip install -r requirements.txt is executed with the selected Python interpreter
5. You can also choose to cancel and install manually later

Dependencies

• GitPython
• questionary
• packaging

Python Version

Python 3.9 or higher is required.

License

MIT License