gitonic simplifies working with multiple git repositories.

gitonic comes with an easy to use Tkinter GUI.

there is also a plugin for thonny thonny-gitonic

where software components/ artefacts are stored in multiple repositories separately gitonic helps to keep track

Check CHANGELOG for latest ongoing, or upcoming news.

Check BACKLOG for open development tasks and limitations.

IMPORTANT:

gitonic interacts with git just like starting in bash / commandline. at the present time there is no additional error checking. this must be done by checking the log tab manually where all cmdline output goes.

an introduction on how git works in general can be found in the official git documentation in section Git-Basics.

todo - documentation pending

when adding a git repo to the tracked list, and staging files (from different repositories) a following commit command is executed on all repositories in the tracked list with the same commit message. this is not a bug; moreover it is intened to be like that.

following list contains all hotkeys:

HINT:

if not responding to a hotkey, make sure that CapsLock is disabled

the file status is the same as when calling git status --porcelain

tested on python3, and linux

alpha state, use on your own risk!!!

phyton3 -m pip install gitonic

to use git difftool, and mergetool install a 3rd party tool like meld merge and configure like described below

when during startup an error is thrown, such as:

from PIL import Image, ImageTk, ImageDraw, ImageFont
ImportError: cannot import name 'ImageTk' from 'PIL' (/usr/lib64/python3.10/site-packages/PIL/__init__.py)

here it is required to install imagetk in addtion

# debian ubuntu etc
sudo apt-get install python3-pil python3-pil.imagetk

# fedora
sudo yum install python3-pillow python3-pillow-tk

add a .git-credentials file as described here git-credentials

add a .gitconfig file as described here git-config and configure for diff and merge tools. NOTE: you need to install the diff-tool e.g. meld merge manually, if meld is not installed pressing the button will have no effect.

[user]
    name = your name
    email = [email protected]
    
[credential]
    helper = store

[diff]
    tool = meld
[difftool]
    prompt = false
[difftool "meld"]
    cmd = meld "$LOCAL" "$REMOTE"

[merge]
    tool = meld
[mergetool "meld"]
    # Choose one of these 2 lines (not both!) 
    # cmd = meld "$LOCAL" "$MERGED" "$REMOTE" --output "$MERGED"
    cmd = meld "$LOCAL" "$BASE" "$REMOTE" --output "$MERGED"

the following tools are part of the standard git distribution

• gitk git history browser
• git-gui a git front end

other gui-clients are listed on git-scm

following files are used:

HINT: crash after configuration change can be resolved by changing the setting manually in config.json, or delete the config file to fall back to the defaults

gitonic is released under the following LICENSE