# PyGitTools

Hooks, tooling, and pygit2 workflows used by PyGitWeb. Can be used headless for many purposes.

## PGT

PGT is a command line curses application you can use to make commits, switch branches and repos, and do other basic git tasks. Keybinds:
 - Arrow keys or `j`/`k` to navigate
 - `Enter` to confirm actions, stage or unstage files or categories
 - `Space` to collapse menus
 - `ctrl-c` or `esc` to exit.

To run from the repo root, use `uv run pgt`.

## Hook framework

`pygittools.hooks` provides a thin `Hook` base class plus one subclass per git hook type
(client- and server-side). Receive-pack hooks (`PreReceive`, `PostReceive`) parse their
ref-update lines via `parse_ref_updates(stdin)`.

`pygittools.hooks_notify` adds `PreReceiveNotify` / `PostReceiveNotify`: minimal hook
variants that POST `?project=<name>` to a pygitweb `/_internal/notify` endpoint so its
long-poll `updates=true` subscribers wake up immediately on each push. Notification
failures never reject the push.

See `hook_samples/` for ready-to-use scripts.