gitsl 1.2.0

Git to Sapling CLI shim

gitsl

Git to Sapling CLI shim - translates git commands to their Sapling (sl) equivalents.

Installation

pip install gitsl

Requires Python 3.8 or later. Requires Sapling to be installed and available as sl.

Quick Start

Use familiar git commands in any Sapling repository:

# Check status (outputs git-compatible format)
gitsl status --porcelain

# View recent commits
gitsl log --oneline -5

# Stage and commit changes
gitsl add -A
gitsl commit -m "Your message"

gitsl translates these to equivalent Sapling commands automatically.

Supported Commands

Command	Status	Translation
init	Full	sl init
status	Full	sl status with output transformation
log	Full	sl log with flag translation
diff	Full	sl diff
add	Full	sl add / sl addremove
commit	Full	sl commit
rev-parse	Partial	Only --short HEAD via sl whereami
show	Full	sl show
blame	Full	sl annotate
rm	Full	sl remove
mv	Full	sl rename
clone	Full	sl clone
grep	Full	sl grep
clean	Full	sl purge (requires -f or -n)
config	Full	sl config
switch	Full	sl goto / sl bookmark
branch	Full	sl bookmark
restore	Full	sl revert
stash	Full	sl shelve / sl unshelve
checkout	Full	sl goto / sl revert / sl bookmark

Commands not listed are unsupported.

Command Reference

git status

Flag	Supported	Behavior
(none)	Yes	Passthrough to sl status
--porcelain	Yes	Output transformed to git XY format
--short / -s	Yes	Output transformed to git XY format
other flags	Partial	Passed through to sl

Status code translation:

Sapling	Git	Meaning
M	M	Modified in working tree
A	A	Added (staged)
R	D	Removed (staged deletion)
?	??	Untracked
!	D	Missing (deleted from disk)

git log

Flag	Supported	Translation
(none)	Yes	sl log
--oneline	Yes	sl log -T "{node|short} {desc|firstline}\n"
-N (e.g., -5)	Yes	sl log -l N
-n N	Yes	sl log -l N
-nN	Yes	sl log -l N
--max-count=N	Yes	sl log -l N
--format	No	Not implemented
--graph	No	Not implemented

git add

Flag	Supported	Translation
<files>	Yes	sl add <files>
-A / --all	Yes	sl addremove
-u / --update	Yes	Marks deleted files with sl remove --mark
-p / --patch	No	Not implemented

git diff, git init, git commit

All flags passed through to sl equivalents unchanged.

git show, git clone, git grep

All flags passed through to sl equivalents unchanged.

git blame

Translates to sl annotate. All flags passed through.

git rm

Translates to sl remove. The -r flag is filtered (sl remove is recursive by default).

git mv

Translates to sl rename. All flags passed through.

git clean

Translates to sl purge. Requires -f or -n flag (safety validation).

Flag	Supported	Translation
-f	Yes	sl purge
-n / --dry-run	Yes	sl purge --print
-d	Yes	Included by default in sl purge
-fd	Yes	sl purge

git config

Translates to sl config.

Flag	Supported	Translation
<key>	Yes	sl config <key>
<key> <value>	Yes	sl config --local <key> <value>
--list	Yes	sl config
--global	Yes	sl config --user
--local	Yes	sl config --local

git switch

Flag	Supported	Translation
<branch>	Yes	sl goto <branch>
-c <name>	Yes	sl bookmark <name>

git branch

Translates to sl bookmark.

Flag	Supported	Translation
(none)	Yes	sl bookmark (list)
<name>	Yes	sl bookmark <name> (create)
-d <name>	Yes	sl bookmark -d <name>
-D <name>	Yes	sl bookmark -d <name> (safety: -D is translated to -d)

git restore

Translates to sl revert.

Flag	Supported	Translation
<file>	Yes	sl revert <file>
.	Yes	sl revert --all

git stash

Translates to sl shelve / sl unshelve.

Subcommand	Supported	Translation
(none)	Yes	sl shelve
push	Yes	sl shelve
-m <msg>	Yes	sl shelve -m <msg>
pop	Yes	sl unshelve
apply	Yes	sl unshelve --keep
list	Yes	sl shelve --list
drop	Yes	sl shelve --delete <name>

git checkout

Disambiguates between branches, files, and commits.

Usage	Supported	Translation
<branch>	Yes	sl goto <branch>
<commit>	Yes	sl goto <commit>
<file>	Yes	sl revert <file>
-- <file>	Yes	sl revert <file>
-b <name>	Yes	sl bookmark <name> + sl goto <name>
-B <name>	Yes	sl bookmark -f <name> + sl goto <name>

git rev-parse

Flag	Supported	Translation
--short HEAD	Yes	sl whereami (truncated to 7 chars)
other variants	No	Returns error

Unsupported Commands

Commands not listed above will print a message to stderr and exit with code 0:

gitsl: unsupported command: git checkout main

This exit behavior prevents gitsl from breaking tools that expect git commands to succeed.

For unsupported operations, use Sapling commands directly. See the Sapling Git Cheat Sheet for translations.

Why Some Commands Are Unsupported

Command	Reason
merge	Sapling prefers rebase workflow
rebase	Complex flag translation, use sl rebase directly
push / pull / fetch	Remote operations differ significantly
revert	Maps to sl backout, not sl revert - semantic confusion

Debug Mode

Set GITSL_DEBUG=1 to see what command would be executed without running it:

$ GITSL_DEBUG=1 gitsl status --porcelain
[DEBUG] Command: status
[DEBUG] Args: ['--porcelain']
[DEBUG] Would execute: sl status

How It Works

gitsl intercepts git commands and translates them to Sapling equivalents:

1. Parses the git command and flags
2. Translates to corresponding sl command
3. Transforms output to git-compatible format where needed (status, log)
4. Returns sl's exit code

For commands without translation, gitsl prints a message to stderr and exits 0.

License

MIT