[RFC]: Migrate from tape to in-house @stdlib/test/harness
I maintainer di solito rispondono entro 1 giorno
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 5/5
- Tempo stimato
- Più di una settimana
- Idoneità per principianti
- 20/100
- Tipo di issue
- Refactoring
- Chiarezza
- Abbastanza chiara
- Stato di attività
- Ferma
- Stack tecnologico
- javascript, node.js
- Ambito
- build-system, testing-qa, tooling
Direzione di ricerca
Inizia leggendo il @stdlib/test/harness proposto insieme ai pattern esistenti di @stdlib/bench/harness, quindi esamina i file di test di lib, package.json, il Makefile di stdlib e tools/harness.js. Confronta l’attuale esecuzione dei test basata su tape e l’output TAP con l’harness proposto; il lavoro è completato quando l’ambito della migrazione, le asserzioni supportate e la validazione CI sono concordati e funzionano per tutti i test interessati.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
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:.
- Lingua principale
- JavaScript
- Stelle
- 6k
- Fork
- 1.3k
- Merge medio
- 1g 21h
- PR unite (30g)
- 224
Preparare l'ambiente
Avvia il container di sviluppo del progetto nel browser, con il tuo account GitHub.
- Nessun Dockerfile né file Docker Compose
- Ha un modello di pull request
- Leggi la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di stdlib-js/stdlib
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 72/100
stdlib-js/stdlib#16655 · 1 commento ·
I maintainer di solito rispondono entro 1 giorno
-
Fix JavaScript lint errorsForse già presa @protestershankar l’ha presa 5 giorni fa. ApertaGood First Issue
Difficoltà 2/5 1-3 ore Idoneità per principianti 82/100
stdlib-js/stdlib#16563 · 3 commenti ·
I maintainer di solito rispondono entro 1 giorno
-
Fix C lint errorsForse già presa @raus7n l’ha presa 14 giorni fa. ApertaGood First Issue
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 82/100
stdlib-js/stdlib#16454 · 1 commento ·
I maintainer di solito rispondono entro 1 giorno
-
Fix JavaScript lint errorsForse già presa @Devansh-18155 l’ha presa 39 giorni fa. ApertaGood First Issue
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 82/100
stdlib-js/stdlib#15970 · 1 commento ·
I maintainer di solito rispondono entro 1 giorno
-
Fix JavaScript lint errorsForse già presa @lb1192176991-lab l’ha presa 44 giorni fa. ApertaGood First Issue
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 90/100
stdlib-js/stdlib#15831 · 2 commenti ·
I maintainer di solito rispondono entro 1 giorno
Tutte le issue di stdlib-js/stdlib
Issue simili
-
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 69/100
I maintainer di solito rispondono entro 1 giorno
-
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
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 76/100
-
bug
Difficoltà 2/5 1-3 ore Idoneità per principianti 84/100
swc-project/swc-next-issues#394 ·
-
Difficoltà 1/5 1-3 ore Idoneità per principianti 88/100
githubnext/gh-aw-workshop#5790 ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100
adobe/helix-tools-website#480 ·
I maintainer di solito rispondono entro 1 giorno