[RFC]: Migrate from tape to in-house @stdlib/test/harness
Les mainteneurs répondent en général sous 1 jour
Personne n'a encore pris cette issue.
Évaluation
- Difficulté
- 5/5
- Temps estimé
- Plus d'une semaine
- Accessibilité débutants
- 20/100
- Type d'issue
- Refactorisation
- Clarté
- Plutôt claire
- Activité
- À l'abandon
- Stack technique
- javascript, node.js
- Domaine
- build-system, testing-qa, tooling
Piste de recherche
Commencez par lire le @stdlib/test/harness proposé avec les modèles existants de @stdlib/bench/harness, puis examinez les fichiers de test de lib, package.json, le Makefile de stdlib et tools/harness.js. Comparez l’exécution actuelle des tests basée sur tape et la sortie TAP avec le harness proposé ; la migration est terminée lorsque le périmètre de migration, les assertions prises en charge et la validation CI sont convenus et fonctionnent pour tous les tests concernés.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
Description
This RFC proposes
Proposal: Migrate stdlib Tests to In-House @stdlib/test/harness
This proposal delivers a tape-equivalent in-house test runner as @stdlib/test/harness, directly porting its minimal TAP API while matching @stdlib/bench/harness patterns. It eliminates the tape dep, supports only stdlib's used assertions (equal, strictEqual, ok, deepEqual, pass, fail, plan, end, test), and adds @stdlib/string/format interpolation—no parallelism, grouping, or extras like mocha/jest.
Before/After Test File
Before (tape):
'use strict';
var tape = require( 'tape' );
var foo = require( './../lib' );
tape( 'main export is a function', function test( t ) {
t.ok( true, 'should be true' );
t.strictEqual( typeof foo, 'function', 'main export is a function' );
t.end();
});
tape( 'computes correctly', function test( t ) {
t.plan( 2 );
t.equal( foo( 3 ), 9, 'returns 9' );
t.deepEqual( foo( ),, 'deep equal' );[1][2][3]
t.end();
After (@stdlib/test/harness):
After (@stdlib/test/harness):
```javascript
'use strict';
var test = require( '@stdlib/test/harness' );
var foo = require( './../lib' );
test( 'main export is a function', function test( t ) {
t.ok( true, 'should be true' );
t.strictEqual( typeof foo, 'function', 'main export is %s', 'function' );
t.end();
});
test( 'computes correctly', function test( t ) {
t.plan( 2 );
t.equal( foo( 3 ), 9, 'returns %d', 9 );
t.deepEqual( foo( ),, 'deep equal' );[1][2][3]
t.end();
});
Changes: Swap require('tape') → require('@stdlib/test/harness'). Assertions identical—no renames/refactors. Interpolation optional (%s/%d/%j via @stdlib/string/format).
Study of References
Reviewed tape source (tape-testing/tape): TAP stream via events, nested tests, async end(), assertion tracking. Compared to @stdlib/bench/harness: Similar b.bench()/test(), exports harness/stream factory, stdout TAP—no deps. Stdlib tests (e.g., Makefile/package.json scans): Use ~6 assertions max, plain TAP, no advanced tape features. Impl ports tape's core (test context, assert/incr count, TAP lines) to ~400 LOC Node streams.
Automation Strategy
- Publish
@stdlib/test/harness(bench mirror: libtests, Makefile). - Global replace:
grep -rl "require('tape')" lib/ | xargs sed -i "s|require('tape')|require('@stdlib/test\/harness')|g"(handles escapes). - Glob run: Update stdlib Makefile:
$(QUIET) $(NODE) $(TOOLS_DIR)/harness.js $(shell find lib -name 'test.*.js'). - Validate: CI diff old/new TAP (tape | harness); fix interpolation mismatches via optional post-sed (regex scan t.equal/ok args).
- Coverage: Stick with istanbul (nyc/c8 drops Node 10-12 compat).
Related Issues
[Idea]: develop a project test runner
Questions
No.
Other
No.
Checklist
- I have read and understood the Code of Conduct.
- Searched for existing issues and pull requests.
- The issue name begins with
RFC:.
- Langage dominant
- JavaScript
- Étoiles
- 6k
- Forks
- 1.3k
- Merge moyen
- 1 j 21 h
- PR mergées (30 j)
- 224
Préparer son environnement
Lance le conteneur de développement du projet dans votre navigateur, avec votre propre compte GitHub.
- Aucun Dockerfile ni fichier Docker Compose
- Propose un modèle de pull request
- Lire 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.
Autres issues de stdlib-js/stdlib
-
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
stdlib-js/stdlib#16655 · 1 commentaire ·
Les mainteneurs répondent en général sous 1 jour
-
Fix JavaScript lint errorsPeut-être pris @protestershankar l’a pris il y a 5 jours. OuverteGood First Issue
Difficulté 2/5 1-3 heures Accessibilité débutants 82/100
stdlib-js/stdlib#16563 · 3 commentaires ·
Les mainteneurs répondent en général sous 1 jour
-
Fix C lint errorsPeut-être pris @raus7n l’a pris il y a 14 jours. OuverteGood First Issue
Difficulté 1/5 Moins d'une heure Accessibilité débutants 82/100
stdlib-js/stdlib#16454 · 1 commentaire ·
Les mainteneurs répondent en général sous 1 jour
-
Fix JavaScript lint errorsPeut-être pris @Devansh-18155 l’a pris il y a 39 jours. OuverteGood First Issue
Difficulté 1/5 Moins d'une heure Accessibilité débutants 82/100
stdlib-js/stdlib#15970 · 1 commentaire ·
Les mainteneurs répondent en général sous 1 jour
-
Fix JavaScript lint errorsPeut-être pris @lb1192176991-lab l’a pris il y a 44 jours. OuverteGood First Issue
Difficulté 1/5 Moins d'une heure Accessibilité débutants 90/100
stdlib-js/stdlib#15831 · 2 commentaires ·
Les mainteneurs répondent en général sous 1 jour
Toutes les issues de stdlib-js/stdlib
Issues similaires
-
Difficulté 1/5 Moins d'une heure Accessibilité débutants 69/100
Les mainteneurs répondent en général sous 1 jour
-
automation chore ci-cd consistency developer-experience difficulty: easy discoverability documentation enhancement github-actions good first issue help wanted hygiene priority: P3 seo shell yaml
Difficulté 1/5 Moins d'une heure Accessibilité débutants 76/100
-
bug
Difficulté 2/5 1-3 heures Accessibilité débutants 84/100
swc-project/swc-next-issues#394 ·
-
Difficulté 1/5 1-3 heures Accessibilité débutants 88/100
githubnext/gh-aw-workshop#5790 ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 2/5 1-3 heures Accessibilité débutants 68/100
adobe/helix-tools-website#480 ·
Les mainteneurs répondent en général sous 1 jour