Premiers pas

Installer

Téléchargez Prchum.app depuis les releases : elle est signée et notarisée, il suffit donc de télécharger, décompresser et double-cliquer ; Apple Silicon, macOS 14+. Sous Linux, les releases fournissent un paquet pour à peu près chaque façon d'installer : .deb, .rpm, ou une simple archive prchum-gtk. Toutes demandent GTK 4.12 et libadwaita 1.5 ou plus récents :

sudo apt install ./prchum_*.deb      # Debian, Ubuntu
sudo dnf install ./prchum-*.rpm      # Fedora, RHEL, openSUSE

Sous Arch, on construit comme le fait Arch, avec le PKGBUILD de linux/packaging :

makepkg -si

Avec Nix, le dépôt est un flake :

nix run github:perrito666/prchum          # l'essayer
nix profile install github:perrito666/prchum   # le garder

Ou compilez depuis les sources, partout :

make run ARGS=changement.diff   # compile cœur + app et ouvre un patch
make app                        # un Prchum.app double-cliquable dans dist/
make check                      # ce que la CI exécute : tests, smoke test, dérive de l'en-tête

La commande de terminal pr s'installe depuis le menu de l'application (Prchum → Install pr Command…) ou avec make install-cli.

La compilation demande une chaîne d'outils Rust et Xcode. La revue de pull requests demande le CLI de la forge installé et authentifié : gh (gh auth login) pour GitHub, fj pour Forgejo. Les patchs et les comparaisons git locales n'exigent rien de plus que git.

Première revue

Lancée sans cible, l'application demande quoi revoir : une pull request, votre file de revue, un fichier de patch ou un dépôt git. Chaque porte figure aussi dans le menu File, et tout fonctionne en ligne de commande :

Prchum changement.diff                       # un fichier de patch
Prchum 418                                   # la PR 418 de l'origin du dépôt courant
Prchum owner/repo#418                        # dépôt explicite
Prchum https://github.com/owner/repo/pull/418

Une fois le diff ouvert :

1. Naviguez. ⌘↓/⌘↑ sautent de changement en changement, ⌥⌘↓/⌥⌘↑ de hunk en hunk, ⇧⌘↓/⇧⌘↑ de fichier en fichier — ou cliquez sur un fichier dans la barre latérale.
2. Commentez. Placez le curseur (ou sélectionnez des lignes) et pressez ⌘↩. Écrivez la note, pressez Comment. La ligne reçoit un marqueur ● et la note s'affiche en ligne dessous.
3. Soumettez ou exportez. Sur une pull request, ⇧⌘↩ ouvre la feuille de soumission — rien ne part avant confirmation. Partout, ⇧⌘E exporte vos notes en Markdown (ou en document d'échange si le nom finit en .json).

Les brouillons se sauvegardent seuls par source et se rechargent à la prochaine ouverture de la même comparaison.