Files
khadhroony-solana-project/deltas/0.1.3/pre.002-fix.001.md

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 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 :

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.