CLI Runique

La CLI crée les projets, génère et applique les migrations, crée le premier superutilisateur et lance les tests métier. Elle se lance depuis la racine du projet (là où se trouve .env).

Toutes les commandes

runique new <nom>                 # Créer un nouveau projet
runique makemigrations            # Écrire les migrations des modèles qui ont changé
runique makemigrations --force    # Pareil, en autorisant les changements destructifs
runique migration up              # Appliquer toutes les migrations en attente
runique migration down -n 1       # Annuler la dernière migration (son down() s'exécute)
runique migration status          # Lister les migrations et leur état
runique create-superuser          # Créer un superutilisateur
runique test [fichier] [test]     # Lancer src/runique_test/ (voir Tests)

Pas de runique start : l'application se lance avec cargo run. L'admin se déclare en Rust (ModelAdmin + .with_admin(...)), sans daemon ni génération de code.

`runique new`

Crée le projet complet : application, crate migration/, templates, CSS, .env avec un SECRET_KEY aléatoire. Voir Prérequis & premier projet.

Noms refusés : vide, caractères autres que lettres / chiffres / _ / -, commençant par un chiffre ou -, mots-clés Rust, crates intégrés (std, core, alloc, proc_macro, test), dossiers de cargo (build, deps, examples, incremental), noms de périphériques Windows (con, nul, com1…), et migration / runique. La comparaison ignore la casse et traite - comme _.

`runique makemigrations`

runique makemigrations [--entities src/entities] [--migrations migration/src] [--force]

Lit les model!{} et extend!{} de src/entities/, les compare à leurs snapshots, et écrit les migrations. Si le crate migration/ n'existe pas encore (projet non créé par runique new), il est créé, avec le moteur de DB_ENGINE (SQLite si la variable est absente). Détails : Migrations.

`runique migration up | down | status`

runique migration up [--migrations migration/src]
runique migration down [-n 1] [--migrations migration/src]
runique migration status [--migrations migration/src]

Lance le crate migration du projet (cargo run sur migration/Cargo.toml), qui lit DATABASE_URL dans .env. sea-orm-cli n'est pas nécessaire : la version de SeaORM qui applique les migrations est celle de migration/Cargo.toml, alignée sur Runique.

`runique create-superuser`

Crée un compte actif, superutilisateur, activé immédiatement. La commande lit la base comme l'application : DATABASE_URL, ou DB_ENGINE + DB_*, dans .env. Les migrations doivent être appliquées avant.

L'assistant enchaîne cinq étapes, avec des menus au clavier (flèches + Entrée) :

Algorithme de hachage : Argon2 (recommandé), Bcrypt, Scrypt, ou un fournisseur personnalisé
Nom d'utilisateur : refusé s'il est vide ou déjà pris
Email : refusé s'il est invalide ou déjà pris
Mot de passe, puis sa confirmation
Récapitulatif : confirmer et créer, changer d'algorithme, ou modifier le mot de passe

Le mot de passe doit faire au moins 12 caractères et contenir une minuscule, une majuscule, un chiffre et un caractère spécial. Ctrl+C annule à tout moment.

La CLI s'exécute sans l'application : elle n'a pas accès à la PasswordConfig de main.rs. L'algorithme se choisit donc à chaque exécution. Choisissez le même que l'application ; à défaut, le hash est converti vers l'algorithme configuré à la première connexion réussie (mode Auto).

Fournisseur personnalisé : indiquez le chemin d'un exécutable (pas un lien symbolique) qui lit le mot de passe sur stdin et écrit le hash sur stdout. Il est lancé sans shell et doit répondre en moins de 10 secondes.

`runique test`

Lance les tests de src/runique_test/, chacun dans une transaction annulée à la fin. La commande refuse de tourner si la feature test-utils manque, ou si elle est déclarée dans [dependencies] au lieu de [dev-dependencies] (elle finirait alors dans le binaire de production). Voir Tests.