Prérequis & premier projet

• Rust 1.94+ — installer rustup
• Une base de données : SQLite (rien à installer, utilisé par défaut), PostgreSQL 12+, ou MySQL / MariaDB

rustc --version    # 1.94 ou plus

cargo install runique --features sqlite --locked

La CLI se connecte à la base (create-superuser) : elle doit être compilée avec le pilote de votre moteur. Remplacez sqlite par postgres, mysql ou mariadb, ou utilisez all-databases pour un binaire qui parle aux trois. Sans feature de moteur, toute connexion échoue avec « driver not enabled ».

--locked utilise les versions de dépendances publiées avec la crate ; sans lui, Cargo peut choisir des versions plus récentes, incompatibles entre elles.

Pour changer de moteur plus tard, réinstallez avec --force :

cargo install runique --features postgres --locked --force

runique new mon_projet
cd mon_projet

Le nom ne peut contenir que des lettres, chiffres, _ et -, ne commence ni par un chiffre ni par -, et ne peut pas être un nom réservé (mot-clé Rust, std, core, test, noms de périphériques Windows comme con, ou migration / runique, déjà pris dans le projet généré).

runique new génère un projet complet, prêt à lancer :

mon_projet/
├── Cargo.toml          workspace : l'application + son crate `migration`
├── .env                réglages, avec un SECRET_KEY aléatoire propre au projet
├── migration/          le crate de migrations (Cargo.toml, src/main.rs, src/lib.rs)
├── src/
│   ├── main.rs         le builder de l'application
│   ├── url.rs          les routes (/, /signup, /login, /logout, /about)
│   ├── views.rs        les vues
│   ├── forms/          formulaires d'inscription et de connexion
│   └── entities/       vos modèles (model!)
├── templates/          base.html (mise en page), index, about, signup, login
├── static/css/
└── media/              favicon, logo, et les fichiers envoyés par les utilisateurs

Le projet utilise SQLite par défaut. Pour un autre moteur, voir Base de données.

runique migration up

Le crate migration/ contient déjà les migrations des tables du framework (eihwaz_users, sessions, droits, historique, jetons de réinitialisation). Cette commande les applique. Le premier lancement compile le crate : il prend un peu de temps, les suivants sont rapides.

Sans cette étape, l'application démarre mais la première requête qui touche une session échoue avec no such table: eihwaz_sessions.

cargo run

Sortie attendue :

   Runique est opérationnel
      └──>  Serveur lancé sur http://127.0.0.1:3000
          └──>  Connecté à la base de données Sqlite -> data.db
              └──> ctrl + c pour arrêter

La page d'accueil fournit l'inscription, la connexion et la déconnexion.

runique create-superuser

Voir CLI Runique. Le panneau d'administration demande en plus la feature admin : voir Admin.

runique new l'écrit pour vous :

IP_SERVER=127.0.0.1
PORT=3000

# `dev` ou `prod` : règle le comportement de l'application (cookie de session,
# contrôles au démarrage, URL publique, hôtes autorisés, rechargement des templates, logs).
# Absente ou inconnue : `prod`.
RUNIQUE_ENV=dev

# Affiche les pages d'erreur détaillées, sans rien changer d'autre. Possible aussi avec
# RUNIQUE_ENV=prod pour diagnostiquer en direct, mais tous les visiteurs voient ces pages :
# déconseillé, à couper dès que le problème est trouvé.
DEBUG=true

# Signe les jetons CSRF et les sessions : propre à ce projet, à garder secret
SECRET_KEY=<64 caractères hexadécimaux générés par runique new>

DB_ENGINE=sqlite
DB_NAME=data.db
DATABASE_URL="sqlite://data.db?mode=rwc"

Le SECRET_KEY est généré aléatoirement à la création. Si vous devez le remplacer (fuite, nouveau déploiement), n'importe quelle chaîne aléatoire d'au moins 32 caractères convient, par exemple :

openssl rand -hex 32

En production (RUNIQUE_ENV=prod), Runique refuse de démarrer avec une clé absente, trop courte ou laissée à sa valeur d'exemple.

Les autres variables (dossiers des templates, des fichiers statiques et des médias, journalisation…) ont des valeurs par défaut : voir Variables d'environnement.

rustup component add rust-analyzer clippy rustfmt

sea-orm-cli n'est pas nécessaire : runique migration up | down | status lance cargo run sur le crate migration du projet, dont le main appelle la CLI de la bibliothèque sea-orm-migration. Voir Le Cargo.toml attendu.