git-cli/README.md

git-cli

A small command-line-like Git interface for Racket. The package invokes the installed git executable and exposes commands both through the generic git procedure and through direct procedures.

(require git-cli)

(git 'status)
(git 'log '-l '-5)
(git 'fetch '--prune)
(git 'switch "main")
(git 'tag "v0.3.16")
(git 'diff)
(git 'show 'HEAD)

(git-status)
(git-fetch '--prune)
(git-switch "main")
(git-tag "v0.3.16")

git is an ordinary procedure. The first argument is the Git command symbol and the remaining arguments are passed to that command.

Several commands provide Racket-oriented output in addition to the normal Git behavior:

• git-status uses Git's porcelain status and returns structured status items.
• git-log -l / git-log --list returns (commit subject) items.
• git-diff renders HTML by default; --output=- selects stdout and --output=string returns a string.
• git-show renders a commit and its diff as HTML by default. -l / --list provides structured variants for --stat, --name-only, and --name-status.

Git is searched on PATH. Git itself remains responsible for remotes, credentials, SSH keys, pull strategy, and other repository configuration.

Commands

The package currently registers commands including status, add, commit, push, pull, fetch, branch, switch, clone, tag, log, rev-list, diff, show, grep, help, version, and new-version.

Most are also exported as direct procedures such as git-status, git-add, git-fetch, git-switch, git-tag, git-log, git-diff, and git-show.

See the Scribble documentation for command-specific behavior and return values.