3.9 KiB
Delta 0.1.3-pre.002-fix.001
Base requise
Livraison précédente :
0.1.3-pre.002
Version technique de cette base :
workspace.package.version = "0.1.3-pre.2"
Le correctif ne change pas le périmètre fonctionnel de pre.002.
Objectif
Supprimer le warning missing_docs émis pour la crate d'intégration :
crates/ksp-config-lib/tests/public_api.rs
Le workspace active missing_docs = "warn". Un fichier sous tests/ est compilé comme une crate d'intégration autonome et doit donc posséder sa propre documentation de crate.
Correction
crates/ksp-config-lib/tests/public_api.rs reçoit une Rustdoc de crate :
//! Integration tests for the public `ksp-config-lib` bootstrap contract.
Aucun allow(missing_docs) n'est ajouté : le test respecte directement la règle documentaire du workspace.
Version technique
Le correctif modifie un source Rust. Conformément à VER-ID-007 et VER-ID-010, la version Cargo devient :
workspace.package.version = "0.1.3-pre.2.fix.1"
Le header du manifest racine passe :
Cargo.toml version 41 -> 42
Le header du test passe :
crates/ksp-config-lib/tests/public_api.rs version 1 -> 2
Fichiers ajoutés
deltas/0.1.3/pre.002-fix.001.md
Fichiers modifiés
Cargo.toml
crates/ksp-config-lib/tests/public_api.rs
Fichiers supprimés
Aucun.
Dépendances
Aucune dépendance ajoutée ou modifiée.
Validations de pre.002 fournies par l'utilisateur
Sur 0.1.3-pre.002, l'utilisateur a exécuté :
cargo fmt --all
cargo check --workspace
cargo clippy --workspace --all-targets
cargo test --workspace
cargo tree -p ksp-config-lib
cargo tree -p ksp-config-lib -d
cargo tree -p ksp-config-lib -e features
Résultats observés avant ce fix :
cargo fmt --all: réussi ;cargo check --workspace: réussi ;cargo clippy --workspace --all-targets: réussi avec un warningmissing_docslimité àtests/public_api.rs;cargo test --workspace: tous les tests exécutés ont réussi, avec le même warningmissing_docs;cargo tree -p ksp-config-lib:ksp-core-libest la seule dépendance directe ;cargo tree -p ksp-config-lib -d: aucune dépendance dupliquée à afficher ;cargo tree -p ksp-config-lib -e features: aucune feature Config supplémentaire ni dépendance inattendue.
Validations exécutées sur ce correctif
Contrôles statiques effectués pendant la préparation :
- le delta ne contient que les deux fichiers modifiés et ce fichier de delta ;
workspace.package.versionvaut0.1.3-pre.2.fix.1;- les headers de fichiers progressent correctement ;
tests/public_api.rspossède une Rustdoc de crate ;- aucun
allow(missing_docs)n'est introduit ; - aucune dépendance n'est modifiée ;
- aucune surface
file_id, JSON, schema,.envou Logging n'est ouverte par ce fix.
Validations non exécutées après correction
L'environnement de préparation ne fournit pas cargo, rustc ou rustfmt. Les commandes suivantes restent donc à réexécuter par l'utilisateur sur le correctif :
cargo fmt --all
cargo check --workspace
cargo clippy --workspace --all-targets
cargo test --workspace
cargo tree -p ksp-config-lib
cargo tree -p ksp-config-lib -d
cargo tree -p ksp-config-lib -e features
Aucune commande non exécutée après application du fix n'est déclarée réussie.
Décisions prises
- les crates d'intégration respectent
missing_docspar une Rustdoc de crate explicite ; - aucune exception lint n'est ajoutée pour masquer ce warning ;
- le correctif reste strictement borné à la conformité documentaire du test ;
- le périmètre de
pre.003reste inchangé : registre logiquefile_id -> filenameet--filemap.
Questions ouvertes
Aucune question bloquante pour ce correctif.