rust-best-practices

L'état d'esprit est: écrire du code en forme Rust, pas une transposition un pour un de C++, Java, C# ou Python; rendre les états invalides irreprésentables, avec des énumérations au lieu d'indicateurs booléens, des newtypes pour les unités et les identifiants, et des constructeurs faillibles qui valident une fois; traiter le code applicatif et le code de bibliothèque différemment, en favorisant la simplicité dans les applications et des règles d'API strictes dans les bibliothèques; et laisser les outils faire le travail, avec rustfmt pour le formatage, clippy pour les vérifications d'idiome, et le compilateur pour la sécurité mémoire. Avant de remettre du code, lancez cargo fmt, cargo clippy avec toutes les cibles et toutes les fonctionnalités et les avertissements refusés, cargo test, et cargo doc sans dépendances pour les bibliothèques, et corrigez tout ce qu'ils signalent. Corrigez un lint plutôt que de le faire taire, en utilisant expect sur l'élément le plus étroit quand un lint est vraiment faux, et allow seulement dans le code généré ou la sortie de macro. Ne mettez jamais deny(warnings) dans le source: imposez les avertissements comme erreurs en CI à la place. Configurez les lints une fois dans Cargo.toml, pas avec des attributs de crate éparpillés. Le guide couvre ensuite la possession et l'emprunt, en préférant la possession unique et le type emprunté le plus général, les types et la conception d'API, le nommage, les newtypes, les dérivations de traits standards, les constructeurs et builders, la visibilité et l'évolution, les traits et génériques, la refactorisation du code d'autrui, les erreurs et paniques, les idiomes quotidiens, la concurrence et l'async, l'unsafe et le FFI, les crates, modules et dépendances, la documentation et les commentaires, les tests, et la performance dans l'ordre. Chaque section énonce sa règle et sa raison, avec un résumé condensé de chacun des cinq guides sources dans les références pour le raisonnement complet. Limites telles qu'écrites dans le SKILL.md: il se déclenche sur toute mention de Rust, cargo, crates, fichiers .rs, borrow checker, durées de vie, traits, clippy ou rustfmt, même quand l'utilisateur ne demande pas de "bonnes pratiques" ou de code "idiomatique". Sa liste de vérification finale doit être confirmée avant de remettre du code Rust, y compris aucun unwrap hors tests et main, aucun paramètre booléen dans les signatures publiques, aucun clone dont le seul travail est de satisfaire le borrow checker, et un commentaire SAFETY sur chaque bloc unsafe.