[RFC]: Bringing `minimist` Dependency In-House
Mantenedores costumam responder em até 1 dia
Ninguém assumiu esta issue ainda.
Avaliação
- Dificuldade
- 5/5
- Tempo estimado
- Mais de uma semana
- Facilidade para iniciantes
- 55/100
- Tipo de issue
- Funcionalidade
- Clareza
- Claramente especificada
- Status de atividade
- Pouca atividade
- Stack de tecnologia
- javascript, nodejs
Direção de pesquisa
Comece pela estrutura proposta de @stdlib/cli/parse-args e seu ponto de entrada lib/main.js; em seguida, inspecione @stdlib/cli/ctor/lib/main.js e os consumidores de _tools listados. Execute os comandos de verificação de parse-args, cli/ctor e da CLI de ponta a ponta. Considera-se concluído quando o comportamento documentado de minimist estiver coberto, os consumidores usarem o pacote stdlib e minimist tiver sido removido.
Escrita pelo modelo de indexação a partir do texto da issue.
Descrição
Replace minimist Dependency with In-House @stdlib/cli/parse-args
Replace the third-party minimist dependency with a stdlib-native equivalent to reduce supply-chain security risk and bring all production code into conformance with stdlib conventions (docs, tests, examples, benchmarks, backward-compatibility).
Background
minimistis used exclusively as a command-line argument parser- Primary consumer: [
@stdlib/cli/ctor/lib/main.js]— the central CLI class used by every stdlib package with a CLI - Secondary consumers: ~12 internal tool scripts under
@stdlib/_tools/package-json/scripts/and@stdlib/_tools/modules/pkg-deps/bin/cli - The existing code has a [TODO comment]:
// TODO: replace with stdlib equivalent - The minimist source is 264 lines — straightforward to reimplement
API Surface Analysis
The full minimist API supports these options: boolean, string, alias, default, stopEarly, -- separator, unknown callback, and dotted key expansion.
What stdlib actually uses (confirmed by auditing every cli_opts.json and direct call site):
| Option | Used? | Example |
|---|---|---|
boolean |
✅ Yes | ["help", "version"] |
string |
✅ Yes | ["split", "aliases"] |
alias |
✅ Yes | { "help": ["h"], "version": ["V"] } |
default |
❌ No | — |
stopEarly |
❌ No | — |
unknown |
❌ No | — |
-- separator |
❌ No | — |
[!IMPORTANT]
Decision: Implement the full minimist API (all 7 options) for backward-compatibility and completeness, but prioritize testing the 3 options actually used. This ensures the replacement is a true drop-in and supports any future stdlib packages that might need additional options.
Proposed Changes
1. New Package: @stdlib/cli/parse-args
Create a brand-new stdlib package that reimplements minimist's parseArgs(args, opts) function.
Folder Structure
lib/node_modules/@stdlib/cli/parse-args/
├── package.json
├── README.md
├── lib/
│ ├── index.js # Standard stdlib entry point
│ └── main.js # Core argument parser implementation
├── test/
│ ├── test.js # Main export, basic parsing, type checks
│ ├── test.bool.js # boolean option, --no- prefix, allBools
│ ├── test.string.js # string option, number coercion suppression
│ ├── test.alias.js # alias option, bidirectional resolution
│ ├── test.default.js # default option
│ ├── test.long.js # Long flags (--key, --key=val, --key val)
│ ├── test.short.js # Short flags (-k, -abc, -k=val, -k val)
│ ├── test.dash.js # -- separator and opts['--']
│ ├── test.stop_early.js # stopEarly option
│ ├── test.unknown.js # unknown callback
│ ├── test.num.js # Number coercion
│ └── test.proto.js # Prototype pollution prevention
├── benchmark/
│ └── benchmark.js # Performance benchmarks
├── examples/
│ └── index.js # Runnable usage examples
└── docs/
└── types/
├── index.d.ts # TypeScript declarations
└── test.ts # TypeScript compile-time tests
main.js
Core implementation. The function signature:
function parseArgs( args, opts ) → { _: Array, ...flags }
Behavior to reimplement (in order of parsing priority):
--key=value— long flag with inline value--no-key— long flag negation → setskey: false--key value— long flag with next-arg value--key(boolean) — long boolean flag →true-abc— short flag grouping (each letter is a boolean flag)-k value— short flag with next-arg value-k=value— short flag with inline value--— stop parsing, rest goes to_(orargv['--'])- Positional args — everything else goes to
_ - Number coercion — numeric strings → Number (unless
stringoption set) - Alias expansion — set value on all aliases simultaneously
- Default values — apply defaults for keys not explicitly set
stopEarly— after first positional, everything goes to_unknowncallback — called for undefined flags; if returnsfalse, skip- Prototype pollution guard — reject
__proto__andconstructor
2. Update Consumer: @stdlib/cli/ctor
[MODIFY] @stdlib/cli/ctor/lib/main.js
Single-line change on line 25:
-var parseArgs = require( 'minimist' ); // TODO: replace with stdlib equivalent
+var parseArgs = require( '@stdlib/cli/parse-args' );
3. Update Consumers: Internal Tool Scripts
[MODIFY] 12 files under @stdlib/_tools/
Same single-line change in each file:
-var parseArgs = require( 'minimist' );
+var parseArgs = require( '@stdlib/cli/parse-args' );
Files to update:
_tools/modules/pkg-deps/bin/cli_tools/package-json/scripts/update_directories_tools/package-json/scripts/update_license_tools/package-json/scripts/update_engines_node_version_tools/package-json/scripts/update_homepage_tools/package-json/scripts/update_author_tools/package-json/scripts/update_os_tools/package-json/scripts/update_bugs_tools/package-json/scripts/update_contributors_tools/package-json/scripts/update_engines_npm_version_tools/package-json/scripts/update_gypfile_tools/package-json/scripts/update_repository
4. Remove minimist from Dependencies
npm uninstall minimist
Verification Plan
Automated Tests
-
New package unit tests (primary verification):
make TESTS_FILTER=".*/cli/parse-args/.*" -
Existing
@stdlib/cli/ctortests (regression — must continue passing after swap):make TESTS_FILTER=".*/cli/ctor/.*" -
Equivalence test — Run the existing minimist test suite against our implementation to verify behavioral parity:
# We can create a shim that points minimist's tests at our implementation NODE_PATH=lib/node_modules node -e "var parse = require('@stdlib/cli/parse-args'); console.log(JSON.stringify(parse(['--foo', 'bar', '-abc', '--no-debug', '--count=5'])))"
Manual Verification
- End-to-end CLI test — Run a real stdlib CLI command and verify it still works:
NODE_PATH=lib/node_modules node bin/cli is-leap-year 2024 # Expected: true NODE_PATH=lib/node_modules node bin/cli is-leap-year 2023 # Expected: false NODE_PATH=lib/node_modules node bin/cli --help # Expected: prints usage text NODE_PATH=lib/node_modules node bin/cli --version # Expected: prints version
- Linguagem predominante
- JavaScript
- Estrelas
- 6k
- Forks
- 1.3k
- Merge médio
- 1d 21h
- PRs com merge (30d)
- 224
Preparar o ambiente
Inicia o contêiner de desenvolvimento do projeto no navegador, com a sua própria conta do GitHub.
- Sem Dockerfile nem arquivo Docker Compose
- Tem um modelo de pull request
- Ler o guia de contribuição
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Mais de stdlib-js/stdlib
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 72/100
stdlib-js/stdlib#16655 · 1 comentário ·
Mantenedores costumam responder em até 1 dia
-
Fix JavaScript lint errorsTalvez já em andamento @protestershankar assumiu há 6 dias. AbertaGood First Issue
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 82/100
stdlib-js/stdlib#16563 · 3 comentários ·
Mantenedores costumam responder em até 1 dia
-
Fix C lint errorsTalvez já em andamento @raus7n assumiu há 14 dias. AbertaGood First Issue
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 82/100
stdlib-js/stdlib#16454 · 1 comentário ·
Mantenedores costumam responder em até 1 dia
-
Fix JavaScript lint errorsTalvez já em andamento @Devansh-18155 assumiu há 39 dias. AbertaGood First Issue
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 82/100
stdlib-js/stdlib#15970 · 1 comentário ·
Mantenedores costumam responder em até 1 dia
-
Fix JavaScript lint errorsTalvez já em andamento @lb1192176991-lab assumiu há 44 dias. AbertaGood First Issue
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 90/100
stdlib-js/stdlib#15831 · 2 comentários ·
Mantenedores costumam responder em até 1 dia
Todas as issues de stdlib-js/stdlib
Issues semelhantes
-
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 69/100
Mantenedores costumam responder em até 1 dia
-
bug ready-for-agent
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 72/100
nearform/unbreakci#897 · 1 comentário · 1 reação ·
Mantenedores costumam responder em até 1 dia
-
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
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 76/100
-
bug
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 84/100
swc-project/swc-next-issues#394 ·
-
Dificuldade 1/5 1-3 horas Facilidade para iniciantes 88/100
githubnext/gh-aw-workshop#5790 ·
Mantenedores costumam responder em até 1 dia