Citadel

Versioning sans perte : un dépôt .citadel, l'annulation de toute opération, la fusion à trois voies et les conflits conservés comme données. Même logique et même syntaxe que les commandes de dépôt de nxs ; la seule différence est la création : citadel init (au lieu de nxs repo -i). Le paquet est construit comme nexus_project (zpp_args, impmagic, zpp_config, zpp_color) et ne dépend pas de lui.

pip install .
citadel init
citadel commit -m "premier"

Commandes

-n/--dry-run simule (rien n'est écrit) sur les commandes qui modifient le dépôt. -C désigne toujours une révision, -c crée.

Configuration (citadel config)

Fichier ~\AppData\Local\Citadel\.config\citadel.yml (Windows) ou ~/.config/Citadel/.config/citadel.yml, créé au premier lancement (variable CITADEL_CONFIG pour en choisir un autre). Sans argument la commande liste les réglages ; avec une clé booléenne elle la bascule ; avec une clé et une valeur elle l'écrit.

Les clés repo.* (sauf ignore, appliquée à chaque ouverture) sont copiées dans un dépôt au moment de sa création : ensuite chaque dépôt garde les siennes, modifiables avec citadel repo config.

Format

Le dossier .citadel est le même que celui de nxs (implémentation Rust et paquet nexus_project) : un dépôt créé par l'un se lit avec l'autre. Empreintes SHA-256, segments compressés en zstd, gros fichiers en morceaux de 4 Mio. Règles d'exclusion : .citadelignore ; les fichiers qui ressemblent à des secrets (.env, *.pem…) sont ignorés par défaut.

Utilisation en bibliothèque

from citadel import open_repo
repo = open_repo(".", create=True)       # CitadelBackend
repo.commit("message")

Tests

python -m unittest discover -s tests