Change behavior of `--exact` doc-tests
Personne n'a encore pris cette issue.
- Langage dominant
- Rust
- Étoiles
- 119k
- Forks
- 16.2k
- Métriques de merge des PR
- Métriques de PR en attente
Description
Problem
I have this code:
#[test]
fn foo() {}
#[test]
fn foo_more() {}
/// ```
/// let foo = 10;
/// ```
fn doc_foo() {}
/// ```
/// let foo_more = 10;
/// ```
fn doc_foo_more() {}
Command cargo test foo runs both (non-doc) tests. Command cargo test foo -- --exact runs 1 test named foo.
Command cargo test --doc doc_foo runs both doc tests. Command cargo test --doc doc_foo -- --exact doesn't run any tests, but I expect it to run 1 doc test named doc_foo.
cargo test -- --list shows this 4 tests:
foo: test
foo_more: test
src\lib.rs - doc_foo (line 7): test
src\lib.rs - doc_foo_more (line 12): test
I am able to run specific doc test named doc_foo using cargo test --doc 'doc_foo\ (line\ 7)' thanks to this issue on rust-lang.org.
This solution is not ideal imo because of the need for escape sequences and line number. I think its very hard to use this in complex cases such as doctests in structs or inline modules, basically places with namespace nesting.
This issue originates from my issue in rust-analyzer but the more I think about it, the more I feel like this problem is not about rust-analyzer. It's too tedious to run specific doc test even manually in a shell.
Proposed Solution
Change behavior of --exact flag to match only the name of the test in doc tests by default as it does in non-doc tests.
- This solution still allows to run specific test if you modify test name to match
'test_name\ (line\ 4)' - Currently existing scripts will remain unchanged
Notes
No response
Guide de contribution
Ouvrir le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Piste de recherche
Commencez par reproduire les commandes documentées cargo test --doc doc_foo et --exact, en comparant leur sortie avec celle de cargo test -- --list. Suivez le point d’entrée du filtrage des noms de doctest et ajoutez une couverture montrant que --exact correspond à doc_foo sans exiger le suffixe de ligne échappé, tout en préservant le comportement existant pour les noms complets.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Évaluation
- Stack technique
- rust
- Domaine
- cli, testing-qa
- Type d'issue
- Fonctionnalité
- Difficulté
- 4/5
- Temps estimé
- 3-5 jours
- Activité
- À l'abandon
- Clarté
- Plutôt claire
- Accessibilité débutants
- 42/100