145 lines
3.9 KiB
Markdown
145 lines
3.9 KiB
Markdown
<!-- file: deltas/0.1.3/pre.002-fix.001.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# Delta 0.1.3-pre.002-fix.001
|
|
|
|
## Base requise
|
|
|
|
Livraison précédente :
|
|
|
|
```text
|
|
0.1.3-pre.002
|
|
```
|
|
|
|
Version technique de cette base :
|
|
|
|
```text
|
|
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 :
|
|
|
|
```text
|
|
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 :
|
|
|
|
```rust
|
|
//! 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 :
|
|
|
|
```text
|
|
workspace.package.version = "0.1.3-pre.2.fix.1"
|
|
```
|
|
|
|
Le header du manifest racine passe :
|
|
|
|
```text
|
|
Cargo.toml version 41 -> 42
|
|
```
|
|
|
|
Le header du test passe :
|
|
|
|
```text
|
|
crates/ksp-config-lib/tests/public_api.rs version 1 -> 2
|
|
```
|
|
|
|
## Fichiers ajoutés
|
|
|
|
```text
|
|
deltas/0.1.3/pre.002-fix.001.md
|
|
```
|
|
|
|
## Fichiers modifiés
|
|
|
|
```text
|
|
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é :
|
|
|
|
```bash
|
|
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 warning `missing_docs` limité à `tests/public_api.rs` ;
|
|
- `cargo test --workspace` : tous les tests exécutés ont réussi, avec le même warning `missing_docs` ;
|
|
- `cargo tree -p ksp-config-lib` : `ksp-core-lib` est 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.version` vaut `0.1.3-pre.2.fix.1` ;
|
|
- les headers de fichiers progressent correctement ;
|
|
- `tests/public_api.rs` possè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, `.env` ou 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 :
|
|
|
|
```bash
|
|
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_docs` par 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.003` reste inchangé : registre logique `file_id -> filename` et `--filemap`.
|
|
|
|
## Questions ouvertes
|
|
|
|
Aucune question bloquante pour ce correctif.
|