Modèles et champs
Un modèle génère une table SQL, des fichiers Rust et cinq routes CRUD.
▶ Voir la démoDans cette page
Créer un modèle
- Appuyez sur a et nommez le modèle, par exemple
User. - Nommez un champ, choisissez son type, puis ses options avec Espace.
- Ajoutez d’autres champs ou une relation depuis Champs de la ressource.
- Choisissez Terminer et générer, validez le chemin de collection, puis Générer.
id est ajouté automatiquement. Utilisez des noms de champs comme first_name. Échap annule avant génération.
En ligne de commande
miblo add User name:string email:string:unique --yes
miblo add Product title:string price:float active:bool --yes--path /members change le chemin de collection. Sans champs ni --yes, le CLI ouvre son assistant.
Types de champs
| Type | Rust | SQLite | MySQL |
|---|---|---|---|
| string | String | TEXT | VARCHAR(255) |
| text | String | TEXT | TEXT |
| int | i64 | INTEGER | BIGINT |
| float | f64 | REAL | DOUBLE |
| bool | bool | INTEGER | BOOLEAN |
Un champ facultatif utilise Option<T>. Syntaxe : nom:type?:option, par exemple description:text?.
Options et champs privés
| Option | Exemple | Comportement |
|---|---|---|
| Facultatif | nickname:string? | Accepte NULL. |
| Unique | email:string:unique | Contrainte d’unicité. Utiliser string plutôt que text pour un texte unique. |
| Privé | token:string:private | Écriture acceptée ; valeur omise des réponses CRUD. |
Les noms sensibles courants (password, password_hash, secret, token, api_key) deviennent privés via le CLI. Ce filtrage ne chiffre pas les données et ne crée pas d’authentification.
Le CRUD produit
| Méthode | Chemin User | Résultat |
|---|---|---|
| GET | /users | Liste paginée : limit et offset, maximum 100 par page. |
| POST | /users | Création : 201. |
| GET | /users/{id} | Ligne ou 404. |
| PATCH | /users/{id} | Modification des champs fournis ; champs omis inchangés. |
| DELETE | /users/{id} | Suppression : 204 ; ligne absente : 404. |
Champs inconnus et types incorrects sont refusés. Unicité : 409. Un PATCH vide, la modification de id et NULL sur un champ obligatoire sont refusés.
Préserver le projet existant
Un ajout crée les fichiers du nouveau modèle et sa migration sans régénérer les ressources existantes. Les registres, miblo.yaml et .miblo/state.json sont actualisés.
--dry-run montre le plan. Une collision de fichiers ou un conflit dans les registres gérés interrompt l’opération. Pour ajouter un champ, utilisez miblo edit ou m.