├── .github ├── CODEOWNERS └── settings.yml ├── .gitignore ├── .travis.yml ├── CHANGELOG.md ├── LICENSE.md ├── Makefile ├── README.md ├── appveyor.yml ├── auto-fallback.js ├── bin ├── .gitignore ├── index.js └── package.template.json ├── child.js ├── get-prefix.js ├── index.js ├── locales ├── ca.json ├── cs.json ├── de.json ├── en.json ├── es.json ├── fr.json ├── id.json ├── it.json ├── ja.json ├── ko.json ├── nb.json ├── nl.json ├── nn.json ├── no.json ├── pl.json ├── pt_BR.json ├── ro.json ├── ru.json ├── sr.json ├── tr.json ├── uk.json ├── zh_CN.json └── zh_TW.json ├── package-lock.json ├── package.json ├── parse-args.js ├── test ├── auto-fallback.js ├── child.js ├── get-prefix.js ├── guess-command-name.js ├── index.js ├── parse-args.js ├── util.js └── util │ ├── npx-bin-inherit-stdio.js │ ├── npx-bin.js │ └── test-dir.js ├── util.js └── y.js /.github/CODEOWNERS: -------------------------------------------------------------------------------- 1 | * @npm/cli-team 2 | -------------------------------------------------------------------------------- /.github/settings.yml: -------------------------------------------------------------------------------- 1 | --- 2 | _extends: 'open-source-project-boilerplate' 3 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | /node_modules 2 | /.nyc_output 3 | /test/cache 4 | libnpx.1 5 | /bin/CHANGELOG.md 6 | /bin/LICENSE.md 7 | -------------------------------------------------------------------------------- /.travis.yml: -------------------------------------------------------------------------------- 1 | language: node_js 2 | sudo: false 3 | node_js: 4 | - "12" 5 | - "10" 6 | - "8" 7 | - "6" 8 | 9 | before_install: 10 | - npm install -g npm@latest 11 | 12 | cache: 13 | directories: 14 | - $HOME/.npm 15 | -------------------------------------------------------------------------------- /CHANGELOG.md: -------------------------------------------------------------------------------- 1 | # Change Log 2 | 3 | All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines. 4 | 5 | 6 | ## [10.2.4](https://github.com/npm/npx/compare/v10.2.3...v10.2.4) (2020-07-20) 7 | 8 | 9 | 10 | 11 | ## [10.2.3](https://github.com/npm/npx/compare/v10.2.2...v10.2.3) (2020-03-24) 12 | 13 | 14 | 15 | 16 | ## [10.2.2](https://github.com/npm/npx/compare/v10.2.1...v10.2.2) (2020-01-28) 17 | 18 | 19 | ### Bug Fixes 20 | 21 | * correct Kat's github url ([9a23db1](https://github.com/npm/npx/commit/9a23db1)) 22 | * install latest npm on travis for node 6 ([e0eb3cb](https://github.com/npm/npx/commit/e0eb3cb)) 23 | * Update changelog to fix old issue links ([3733137](https://github.com/npm/npx/commit/3733137)) 24 | 25 | 26 | 27 | 28 | # [10.2.0](https://github.com/npm/npx/compare/v10.1.1...v10.2.0) (2018-04-13) 29 | 30 | 31 | ### Bug Fixes 32 | 33 | * **i18n:** fix korean; 쉘 -> 셸 ([#163](https://github.com/zkat/npx/issues/163)) ([11d9fe0](https://github.com/npm/npx/commit/11d9fe0)) 34 | * **spawn:** spawn child processes with node without relying on the shebang. ([#174](https://github.com/zkat/npx/issues/174)) ([cba97bb](https://github.com/npm/npx/commit/cba97bb)) 35 | * **windows:** Allow spaces in the node path when using --node-arg ([#173](https://github.com/zkat/npx/issues/173)) ([fe0d48a](https://github.com/npm/npx/commit/fe0d48a)), closes [#170](https://github.com/zkat/npx/issues/170) 36 | 37 | 38 | ### Features 39 | 40 | * **i18n:** add translation ([#159](https://github.com/zkat/npx/issues/159)) ([5da008b](https://github.com/npm/npx/commit/5da008b)) 41 | 42 | 43 | 44 | 45 | ## [10.1.1](https://github.com/npm/npx/compare/v10.1.0...v10.1.1) (2018-04-12) 46 | 47 | 48 | 49 | 50 | # [10.1.0](https://github.com/npm/npx/compare/v10.0.1...v10.1.0) (2018-04-12) 51 | 52 | 53 | ### Features 54 | 55 | * **spawn:** add --always-spawn to opt out of process takeover optimization feature ([#172](https://github.com/zkat/npx/issues/172)) ([c0d6abc](https://github.com/npm/npx/commit/c0d6abc)) 56 | 57 | 58 | 59 | 60 | ## [10.0.1](https://github.com/npm/npx/compare/v10.0.0...v10.0.1) (2018-03-08) 61 | 62 | 63 | ### Bug Fixes 64 | 65 | * **i18n:** Improve French localization ([#158](https://github.com/zkat/npx/issues/158)) ([c88823e](https://github.com/npm/npx/commit/c88823e)) 66 | * **windows:** on Windows, throw useful error when package contains no binaries([#142](https://github.com/zkat/npx/issues/142)) ([a69276e](https://github.com/npm/npx/commit/a69276e)), closes [#137](https://github.com/zkat/npx/issues/137) 67 | 68 | 69 | 70 | 71 | # [10.0.0](https://github.com/npm/npx/compare/v9.7.1...v10.0.0) (2018-03-08) 72 | 73 | 74 | ### Bug Fixes 75 | 76 | * **i18n:** Fix Korean locale ([#130](https://github.com/zkat/npx/issues/130)) ([752db48](https://github.com/npm/npx/commit/752db48)) 77 | * **index:** remove extraneous logging on Windows ([#136](https://github.com/zkat/npx/issues/136)) ([357e6ab](https://github.com/npm/npx/commit/357e6ab)), closes [#131](https://github.com/zkat/npx/issues/131) 78 | * **license:** change npx license to ISC ([a617d7b](https://github.com/npm/npx/commit/a617d7b)) 79 | * **parse-args:** fix version thing for yargs ([30677ed](https://github.com/npm/npx/commit/30677ed)) 80 | * **prefix:** Handle node_modules without package.json ([#128](https://github.com/zkat/npx/issues/128)) ([f64ae43](https://github.com/npm/npx/commit/f64ae43)), closes [/github.com/babel/babel/issues/4066#issuecomment-336705199](https://github.com//github.com/babel/babel/issues/4066/issues/issuecomment-336705199) 81 | * **standard:** get things in line with standard 11 ([6cf8e88](https://github.com/npm/npx/commit/6cf8e88)) 82 | 83 | 84 | ### BREAKING CHANGES 85 | 86 | * **license:** This moves the code over from CC0-1.0 to the ISC license. 87 | 88 | 89 | 90 | 91 | ## [9.7.1](https://github.com/npm/npx/compare/v9.7.0...v9.7.1) (2017-10-19) 92 | 93 | 94 | ### Bug Fixes 95 | 96 | * **main:** err... oops? ([f24b4e3](https://github.com/npm/npx/commit/f24b4e3)) 97 | 98 | 99 | 100 | 101 | # [9.7.0](https://github.com/npm/npx/compare/v9.6.0...v9.7.0) (2017-10-19) 102 | 103 | 104 | ### Bug Fixes 105 | 106 | * **exec:** fixed unix binary pathing issues (#120) ([f80a970](https://github.com/npm/npx/commit/f80a970)), closes [#120](https://github.com/zkat/npx/issues/120) 107 | 108 | 109 | ### Features 110 | 111 | * **child:** add opts.installerStdio (#126) ([ade03f7](https://github.com/npm/npx/commit/ade03f7)) 112 | 113 | 114 | 115 | 116 | # [9.6.0](https://github.com/npm/npx/compare/v9.5.0...v9.6.0) (2017-08-17) 117 | 118 | 119 | ### Features 120 | 121 | * **i18n:** add Arabic translation (#111) ([3c5b99a](https://github.com/npm/npx/commit/3c5b99a)) 122 | * **i18n:** add Dutch (#108) ([ed116fd](https://github.com/npm/npx/commit/ed116fd)) 123 | 124 | 125 | 126 | 127 | # [9.5.0](https://github.com/npm/npx/compare/v9.4.1...v9.5.0) (2017-07-28) 128 | 129 | 130 | ### Features 131 | 132 | * **i18n:** add Polish translations (#99) ([8442f59](https://github.com/npm/npx/commit/8442f59)) 133 | 134 | 135 | 136 | 137 | ## [9.4.1](https://github.com/npm/npx/compare/v9.4.0...v9.4.1) (2017-07-21) 138 | 139 | 140 | ### Bug Fixes 141 | 142 | * **i18n:** fix filename for uk.json locale ([2c770e4](https://github.com/npm/npx/commit/2c770e4)) 143 | 144 | 145 | 146 | 147 | # [9.4.0](https://github.com/npm/npx/compare/v9.3.2...v9.4.0) (2017-07-21) 148 | 149 | 150 | ### Bug Fixes 151 | 152 | * **i18n:** minor fixes to ru locale (#92) ([f4d5051](https://github.com/npm/npx/commit/f4d5051)), closes [#92](https://github.com/zkat/npx/issues/92) 153 | 154 | 155 | ### Features 156 | 157 | * **i18n:** `no` locale fallback for Norwegian bokmål ⚠️ In case of weird setups ⚠️ (#91) ([74f0e4c](https://github.com/npm/npx/commit/74f0e4c)) 158 | * **i18n:** add Bahasa Indonesia locale (#95) ([80dceeb](https://github.com/npm/npx/commit/80dceeb)) 159 | * **i18n:** add serbian translation (#96) ([040de7a](https://github.com/npm/npx/commit/040de7a)) 160 | * **i18n:** add Ukrainian locale (#93) ([9a3ef33](https://github.com/npm/npx/commit/9a3ef33)) 161 | * **i18n:** Added Norwegian (bokmål and nynorsk) translations (#90) ([6c5c733](https://github.com/npm/npx/commit/6c5c733)) 162 | 163 | 164 | 165 | 166 | ## [9.3.2](https://github.com/npm/npx/compare/v9.3.1...v9.3.2) (2017-07-17) 167 | 168 | 169 | ### Bug Fixes 170 | 171 | * **exec:** detect a wider range of shebang lines for node scripts (#89) ([1841b6f](https://github.com/npm/npx/commit/1841b6f)) 172 | * **windows:** escape spawn args because windows is picky (#87) ([314e5eb](https://github.com/npm/npx/commit/314e5eb)) 173 | * **windows:** get magic shim detection working on Windows (#88) ([255aeeb](https://github.com/npm/npx/commit/255aeeb)) 174 | 175 | 176 | 177 | 178 | ## [9.3.1](https://github.com/npm/npx/compare/v9.3.0...v9.3.1) (2017-07-17) 179 | 180 | 181 | ### Bug Fixes 182 | 183 | * **deps:** update to npm[@5](https://github.com/5).3.0 ([2b14de2](https://github.com/npm/npx/commit/2b14de2)) 184 | 185 | 186 | 187 | 188 | # [9.3.0](https://github.com/npm/npx/compare/v9.2.3...v9.3.0) (2017-07-17) 189 | 190 | 191 | ### Features 192 | 193 | * **i18n:** add Korean locale (#86) ([3655314](https://github.com/npm/npx/commit/3655314)) 194 | 195 | 196 | 197 | 198 | ## [9.2.3](https://github.com/npm/npx/compare/v9.2.2...v9.2.3) (2017-07-17) 199 | 200 | 201 | ### Bug Fixes 202 | 203 | * **paths:** support npm/npx paths with spaces in them ([8f3b829](https://github.com/npm/npx/commit/8f3b829)) 204 | 205 | 206 | 207 | 208 | ## [9.2.2](https://github.com/npm/npx/compare/v9.2.1...v9.2.2) (2017-07-15) 209 | 210 | 211 | ### Bug Fixes 212 | 213 | * **npm:** escape path to npm, too ([333d2ff](https://github.com/npm/npx/commit/333d2ff)) 214 | 215 | 216 | 217 | 218 | ## [9.2.1](https://github.com/npm/npx/compare/v9.2.0...v9.2.1) (2017-07-14) 219 | 220 | 221 | ### Bug Fixes 222 | 223 | * **windows:** fixed windows binary pathing issues ([761dfe9](https://github.com/npm/npx/commit/761dfe9)) 224 | 225 | 226 | 227 | 228 | # [9.2.0](https://github.com/npm/npx/compare/v9.1.0...v9.2.0) (2017-07-14) 229 | 230 | 231 | ### Bug Fixes 232 | 233 | * **binpath:** fix calling binaries from subdirectories ([f185d0d](https://github.com/npm/npx/commit/f185d0d)) 234 | * **i18n:** Fix typos in french locale (#78) ([f277fc7](https://github.com/npm/npx/commit/f277fc7)), closes [#78](https://github.com/zkat/npx/issues/78) 235 | 236 | 237 | ### Features 238 | 239 | * **i18n:** Add German translations (#79) ([c81e26d](https://github.com/npm/npx/commit/c81e26d)) 240 | * **i18n:** add zh_TW translation (#80) ([98288d8](https://github.com/npm/npx/commit/98288d8)) 241 | 242 | 243 | 244 | 245 | # [9.1.0](https://github.com/npm/npx/compare/v9.0.7...v9.1.0) (2017-07-12) 246 | 247 | 248 | ### Bug Fixes 249 | 250 | * **call:** only npm run env if package.json exists ([370f395](https://github.com/npm/npx/commit/370f395)) 251 | * **i18n:** Fix grammar and spelling for de.json (#63) ([b14020f](https://github.com/npm/npx/commit/b14020f)), closes [#63](https://github.com/zkat/npx/issues/63) 252 | * **i18n:** wording revisions for Brazilian Portuguese (#75) ([b5dc536](https://github.com/npm/npx/commit/b5dc536)) 253 | * **npm:** path directly to the npm-cli.js script ([d531206](https://github.com/npm/npx/commit/d531206)) 254 | * **rimraf:** fix rimraf.sync is not a function issue ([d2ecba3](https://github.com/npm/npx/commit/d2ecba3)) 255 | * **windows:** get npx working well on Windows again (#69) ([6cfb8de](https://github.com/npm/npx/commit/6cfb8de)), closes [#60](https://github.com/zkat/npx/issues/60) [#58](https://github.com/zkat/npx/issues/58) [#62](https://github.com/zkat/npx/issues/62) 256 | 257 | 258 | ### Features 259 | 260 | * **i18n:** add Czech translation (#76) ([8a0b3f6](https://github.com/npm/npx/commit/8a0b3f6)) 261 | * **i18n:** Add Turkish translation (#73) ([26e5edf](https://github.com/npm/npx/commit/26e5edf)) 262 | * **i18n:** Added support for Italian language (#71) ([6883e75](https://github.com/npm/npx/commit/6883e75)) 263 | * **i18n:** Fix Romanian translation (#70) ([fd6bbcf](https://github.com/npm/npx/commit/fd6bbcf)), closes [#70](https://github.com/zkat/npx/issues/70) 264 | * **node:** add --node-arg support to pass flags to node for script binaries (#77) ([65665bd](https://github.com/npm/npx/commit/65665bd)) 265 | 266 | 267 | 268 | 269 | ## [9.0.7](https://github.com/npm/npx/compare/v9.0.6...v9.0.7) (2017-07-11) 270 | 271 | 272 | ### Bug Fixes 273 | 274 | * **i18n:** Fix some Catalan translations (#59) ([11c8a19](https://github.com/npm/npx/commit/11c8a19)), closes [#59](https://github.com/zkat/npx/issues/59) 275 | 276 | 277 | 278 | 279 | ## [9.0.6](https://github.com/npm/npx/compare/v9.0.5...v9.0.6) (2017-07-11) 280 | 281 | 282 | ### Bug Fixes 283 | 284 | * **auto-fallback:** fix syntax error in bash/zsh auto-fallback ([d8b19db](https://github.com/npm/npx/commit/d8b19db)) 285 | 286 | 287 | 288 | 289 | ## [9.0.5](https://github.com/npm/npx/compare/v9.0.4...v9.0.5) (2017-07-11) 290 | 291 | 292 | ### Bug Fixes 293 | 294 | * **npx:** something went wrong with the 9.0.4 build and bundledeps ([75fc436](https://github.com/npm/npx/commit/75fc436)) 295 | 296 | 297 | 298 | 299 | ## [9.0.4](https://github.com/npm/npx/compare/v9.0.3...v9.0.4) (2017-07-11) 300 | 301 | 302 | ### Bug Fixes 303 | 304 | * **auto-fallback:** prevent infinite loop if npx disappears ([6c24e58](https://github.com/npm/npx/commit/6c24e58)) 305 | * **bin:** add repository and more detailed author info ([906574e](https://github.com/npm/npx/commit/906574e)) 306 | * **bin:** pin the npx bin's dependencies ([ae62f7a](https://github.com/npm/npx/commit/ae62f7a)) 307 | * **build:** make sure changelog and license are copied to bin ([4fbb599](https://github.com/npm/npx/commit/4fbb599)) 308 | * **deps:** stop bundling deps in libnpx itself ([c3e56e9](https://github.com/npm/npx/commit/c3e56e9)) 309 | * **errors:** print command not found for packages without valid binaries ([9b24359](https://github.com/npm/npx/commit/9b24359)) 310 | * **help:** --no-install help text was contradicting itself ([9d96f5e](https://github.com/npm/npx/commit/9d96f5e)) 311 | * **install:** prevent concurrent npx runs from clobbering each other ([6b35c91](https://github.com/npm/npx/commit/6b35c91)) 312 | * **npx:** npx npx npx npx npx npx npx npx npx works again ([875d4cd](https://github.com/npm/npx/commit/875d4cd)) 313 | * **updater:** dependency injection for update-notifier target ([c3027a9](https://github.com/npm/npx/commit/c3027a9)) 314 | * **updater:** ignore some kinds of update-notifier errors ([7631bbe](https://github.com/npm/npx/commit/7631bbe)) 315 | 316 | 317 | 318 | 319 | ## [9.0.3](https://github.com/npm/npx/compare/v9.0.2...v9.0.3) (2017-07-08) 320 | 321 | 322 | ### Bug Fixes 323 | 324 | * **version:** hand version to yargs directly ([e0b5eeb](https://github.com/npm/npx/commit/e0b5eeb)) 325 | 326 | 327 | 328 | 329 | ## [9.0.2](https://github.com/npm/npx/compare/v9.0.1...v9.0.2) (2017-07-08) 330 | 331 | 332 | ### Bug Fixes 333 | 334 | * **manpage:** fix manpage for real because files syntax is weird ([9145e2a](https://github.com/npm/npx/commit/9145e2a)) 335 | 336 | 337 | 338 | 339 | ## [9.0.1](https://github.com/npm/npx/compare/v9.0.0...v9.0.1) (2017-07-08) 340 | 341 | 342 | ### Bug Fixes 343 | 344 | * **man:** make sure manpage is used in npx bin ([704b94f](https://github.com/npm/npx/commit/704b94f)) 345 | 346 | 347 | 348 | 349 | # [9.0.0](https://github.com/npm/npx/compare/v8.1.1...v9.0.0) (2017-07-08) 350 | 351 | 352 | ### Features 353 | 354 | * **libnpx:** libify main npx codebase ([643f58e](https://github.com/npm/npx/commit/643f58e)) 355 | * **npx:** create a new binary for standalone publishing ([da5a3b7](https://github.com/npm/npx/commit/da5a3b7)) 356 | 357 | 358 | ### BREAKING CHANGES 359 | 360 | * **libnpx:** This version of npx can no longer be used as a 361 | standalone binary. It will be available on the registry as `libnpx`, 362 | and a separate project will take over the role of the main `npx` binary. 363 | 364 | 365 | 366 | 367 | ## [8.1.1](https://github.com/npm/npx/compare/v8.1.0...v8.1.1) (2017-07-06) 368 | 369 | 370 | ### Bug Fixes 371 | 372 | * **deps:** bump all deps ([6ea24bf](https://github.com/npm/npx/commit/6ea24bf)) 373 | * **npm:** bump npm to 5.1.0 for a bunch of fixes ([18e4587](https://github.com/npm/npx/commit/18e4587)) 374 | 375 | 376 | 377 | 378 | # [8.1.0](https://github.com/npm/npx/compare/v8.0.1...v8.1.0) (2017-06-27) 379 | 380 | 381 | ### Bug Fixes 382 | 383 | * **i18n:** minor tweaks to ja.json (#46) ([1ed63c2](https://github.com/npm/npx/commit/1ed63c2)) 384 | 385 | 386 | ### Features 387 | 388 | * **i18n:** Update pt_BR.json (#51) ([d292f22](https://github.com/npm/npx/commit/d292f22)) 389 | 390 | 391 | 392 | 393 | ## [8.0.1](https://github.com/npm/npx/compare/v8.0.0...v8.0.1) (2017-06-27) 394 | 395 | 396 | ### Bug Fixes 397 | 398 | * **npm:** bump npm version for more bugfixes ([30711a8](https://github.com/npm/npx/commit/30711a8)) 399 | * **npm:** Use --parseable option to work around output quirks ([8cb75a2](https://github.com/npm/npx/commit/8cb75a2)) 400 | 401 | 402 | 403 | 404 | # [8.0.0](https://github.com/npm/npx/compare/v7.0.0...v8.0.0) (2017-06-24) 405 | 406 | 407 | ### Features 408 | 409 | * **exec:** auto-guess binaries when different from pkg name ([139c434](https://github.com/npm/npx/commit/139c434)) 410 | 411 | 412 | ### BREAKING CHANGES 413 | 414 | * **exec:** `npx ember-cli` and such things will now execute the 415 | binary based on some guesswork, but only when using the shorthand format 416 | for npx execution, with no `-p` option or `-c`. This might cause npx to 417 | unintentionally execute the wrong binary if the package in question has 418 | multiple non-matching binaries, but that should be rare. 419 | 420 | 421 | 422 | 423 | # [7.0.0](https://github.com/npm/npx/compare/v6.2.0...v7.0.0) (2017-06-24) 424 | 425 | 426 | ### Bug Fixes 427 | 428 | * **win32:** improve win32 situation a bit (#50) ([b7ad934](https://github.com/npm/npx/commit/b7ad934)) 429 | 430 | 431 | ### Features 432 | 433 | * **local:** improve the behavior when calling ./local paths (#48) ([2e418d1](https://github.com/npm/npx/commit/2e418d1)) 434 | 435 | 436 | ### BREAKING CHANGES 437 | 438 | * **local:** `npx ./something` will now execute `./something` as a 439 | binary or script instead of trying to install it as npm would. Other behavior 440 | related to local path deps has likewise been changed. See 441 | [#49](https://github.com/zkat/npx/issues/49) for a detailed explanation 442 | of all the various cases and how each of them is handled. 443 | 444 | 445 | 446 | 447 | # [6.2.0](https://github.com/npm/npx/compare/v6.1.0...v6.2.0) (2017-06-23) 448 | 449 | 450 | ### Bug Fixes 451 | 452 | * **child:** iron out a few crinkles and add tests ([b3b5ef6](https://github.com/npm/npx/commit/b3b5ef6)) 453 | * **execCmd:** only reuse the current process if no shell passed in ([e413cff](https://github.com/npm/npx/commit/e413cff)) 454 | * **execCmd:** use the module built-in directly ([6f741c2](https://github.com/npm/npx/commit/6f741c2)) 455 | * **help:** fuck it. just hard-code it ([d5d5085](https://github.com/npm/npx/commit/d5d5085)) 456 | * **main:** only exec if this is the main module ([9631e2a](https://github.com/npm/npx/commit/9631e2a)) 457 | 458 | 459 | ### Features 460 | 461 | * **i18n:** Update fr.json (#44) ([ea47c4f](https://github.com/npm/npx/commit/ea47c4f)) 462 | * **i18n:** update the Romanian translation. (#42) ([2ed36b6](https://github.com/npm/npx/commit/2ed36b6)) 463 | 464 | 465 | 466 | 467 | # [6.1.0](https://github.com/npm/npx/compare/v6.0.0...v6.1.0) (2017-06-21) 468 | 469 | 470 | ### Bug Fixes 471 | 472 | * **deps:** remove unused gauge dep ([aa40a34](https://github.com/npm/npx/commit/aa40a34)) 473 | 474 | 475 | ### Features 476 | 477 | * **i18n:** update ru locale (#41) ([7c84dee](https://github.com/npm/npx/commit/7c84dee)) 478 | * **i18n:** update zh_CN (#40) ([da4ec67](https://github.com/npm/npx/commit/da4ec67)) 479 | * **perf:** run node-based commands in the current process ([6efcde4](https://github.com/npm/npx/commit/6efcde4)) 480 | 481 | 482 | 483 | 484 | # [6.0.0](https://github.com/npm/npx/compare/v5.4.0...v6.0.0) (2017-06-20) 485 | 486 | 487 | ### Bug Fixes 488 | 489 | * **call:** stop parsing -c for commands + fix corner cases ([bd4e538](https://github.com/npm/npx/commit/bd4e538)) 490 | * **child:** exec does not have the information needed to correctly escape its args ([6714992](https://github.com/npm/npx/commit/6714992)) 491 | * **guessCmdName:** tests failed because of lazy npa ([53a0119](https://github.com/npm/npx/commit/53a0119)) 492 | * **i18n:** gender inclusiveness fix for french version (#37) ([04920ae](https://github.com/npm/npx/commit/04920ae)), closes [#37](https://github.com/zkat/npx/issues/37) 493 | * **i18n:** typo 😇 (#38) ([ede4a53](https://github.com/npm/npx/commit/ede4a53)) 494 | * **install:** handle JSON parsing failures ([bec2887](https://github.com/npm/npx/commit/bec2887)) 495 | * **output:** stop printing out Command Failed messages ([873cffe](https://github.com/npm/npx/commit/873cffe)) 496 | * **parseArgs:** fix booboo in fast path ([d1e5487](https://github.com/npm/npx/commit/d1e5487)) 497 | * **perf:** fast-path `npx foo` arg parsing ([ba4fe71](https://github.com/npm/npx/commit/ba4fe71)) 498 | * **perf:** remove bluebird and defer some requires for SPEED ([00fc313](https://github.com/npm/npx/commit/00fc313)) 499 | 500 | 501 | ### Features 502 | 503 | * **i18n:** add Romanian translations. (#34) ([9e98bd0](https://github.com/npm/npx/commit/9e98bd0)) 504 | * **i18n:** added a few more localizable strings ([779d950](https://github.com/npm/npx/commit/779d950)) 505 | * **i18n:** updated ca.json ([af7a035](https://github.com/npm/npx/commit/af7a035)) 506 | * **i18n:** updated es.json ([414644f](https://github.com/npm/npx/commit/414644f)) 507 | * **i18n:** updated ja.json ([448b082](https://github.com/npm/npx/commit/448b082)) 508 | * **i18n:** Ze German Translation (#35) ([6f003f5](https://github.com/npm/npx/commit/6f003f5)) 509 | * **package:** report number of temp packages installed ([5b7fe8d](https://github.com/npm/npx/commit/5b7fe8d)) 510 | * **perf:** only launch update-notifier when npx installs stuff ([549d413](https://github.com/npm/npx/commit/549d413)) 511 | * **quiet:** added -q/--quiet to suppress output from npx itself ([16607d9](https://github.com/npm/npx/commit/16607d9)) 512 | 513 | 514 | ### BREAKING CHANGES 515 | 516 | * **call:** `npx -c "foo"` will no longer install `foo`. Use `-p` to specicify packages to install. npx will no longer assume any particular format or escape status for `-c` strings: they will be passed directly, unparsed, and unaltered, to child_process.spawn. 517 | 518 | 519 | 520 | 521 | # [5.4.0](https://github.com/npm/npx/compare/v5.3.0...v5.4.0) (2017-06-17) 522 | 523 | 524 | ### Bug Fixes 525 | 526 | * **i18n:** some corrections for es.json ([4d50b71](https://github.com/npm/npx/commit/4d50b71)) 527 | * **i18n:** update locale files with bugfixes ([77caf82](https://github.com/npm/npx/commit/77caf82)) 528 | * **i18n:** Y utility was ignoring falsy entries ([f22a4d0](https://github.com/npm/npx/commit/f22a4d0)) 529 | * **i18n:** してください -> します ([01671af](https://github.com/npm/npx/commit/01671af)) 530 | 531 | 532 | ### Features 533 | 534 | * **i18n:** add catalan translation ([579efa1](https://github.com/npm/npx/commit/579efa1)) 535 | * **i18n:** add pt-br translation (#33) ([6142551](https://github.com/npm/npx/commit/6142551)) 536 | * **i18n:** added largely machine-translated ja.json ([827705f](https://github.com/npm/npx/commit/827705f)) 537 | * **i18n:** adds russian translation (#32) ([b2619c1](https://github.com/npm/npx/commit/b2619c1)) 538 | 539 | 540 | 541 | 542 | # [5.3.0](https://github.com/npm/npx/compare/v5.2.0...v5.3.0) (2017-06-13) 543 | 544 | 545 | ### Features 546 | 547 | * **i18n:** add Chinese translation (#31) ([24e1b31](https://github.com/npm/npx/commit/24e1b31)) 548 | 549 | 550 | 551 | 552 | # [5.2.0](https://github.com/npm/npx/compare/v5.1.3...v5.2.0) (2017-06-12) 553 | 554 | 555 | ### Bug Fixes 556 | 557 | * **i18n:** removing extra spacing in fr.json ([002e2b8](https://github.com/npm/npx/commit/002e2b8)) 558 | 559 | 560 | ### Features 561 | 562 | * **i18n:** add french locale (#29) ([662395b](https://github.com/npm/npx/commit/662395b)) 563 | 564 | 565 | 566 | 567 | ## [5.1.3](https://github.com/npm/npx/compare/v5.1.2...v5.1.3) (2017-06-12) 568 | 569 | 570 | ### Bug Fixes 571 | 572 | * **fallback:** put the Y in the wrong place lol ([d6bf8aa](https://github.com/npm/npx/commit/d6bf8aa)) 573 | 574 | 575 | 576 | 577 | ## [5.1.2](https://github.com/npm/npx/compare/v5.1.1...v5.1.2) (2017-06-10) 578 | 579 | 580 | 581 | 582 | ## [5.1.1](https://github.com/npm/npx/compare/v5.1.0...v5.1.1) (2017-06-10) 583 | 584 | 585 | ### Bug Fixes 586 | 587 | * **i18n:** forgot to add locales to files ([4118d6a](https://github.com/npm/npx/commit/4118d6a)) 588 | 589 | 590 | 591 | 592 | # [5.1.0](https://github.com/npm/npx/compare/v5.0.3...v5.1.0) (2017-06-10) 593 | 594 | 595 | ### Bug Fixes 596 | 597 | * **exit:** let process exit normally to finish writes ([c50a398](https://github.com/npm/npx/commit/c50a398)) 598 | 599 | 600 | ### Features 601 | 602 | * **i18n:** added es.json ([6cf58b9](https://github.com/npm/npx/commit/6cf58b9)) 603 | * **i18n:** set up i18n plus baseline en.json locale ([b67bb3a](https://github.com/npm/npx/commit/b67bb3a)) 604 | 605 | 606 | 607 | 608 | ## [5.0.3](https://github.com/npm/npx/compare/v5.0.2...v5.0.3) (2017-06-09) 609 | 610 | 611 | ### Bug Fixes 612 | 613 | * **fallback:** exec is no ([42c1d30](https://github.com/npm/npx/commit/42c1d30)) 614 | 615 | 616 | 617 | 618 | ## [5.0.2](https://github.com/npm/npx/compare/v5.0.1...v5.0.2) (2017-06-09) 619 | 620 | 621 | ### Bug Fixes 622 | 623 | * **fallback:** allow fallback to local anyway ([569cf2c](https://github.com/npm/npx/commit/569cf2c)) 624 | 625 | 626 | 627 | 628 | ## [5.0.1](https://github.com/npm/npx/compare/v5.0.0...v5.0.1) (2017-06-09) 629 | 630 | 631 | 632 | 633 | # [5.0.0](https://github.com/npm/npx/compare/v4.0.3...v5.0.0) (2017-06-09) 634 | 635 | 636 | ### Features 637 | 638 | * **fallback:** by default, only fall back if you have an @ in the name ([bea08a0](https://github.com/npm/npx/commit/bea08a0)) 639 | 640 | 641 | ### BREAKING CHANGES 642 | 643 | * **fallback:** auto-fallback will no longer fall back unless there was 644 | an @ sign in the command. 645 | 646 | 647 | 648 | 649 | ## [4.0.3](https://github.com/npm/npx/compare/v4.0.2...v4.0.3) (2017-06-04) 650 | 651 | 652 | ### Bug Fixes 653 | 654 | * **npm:** use --userconfig when querying for npm cache config (#28) ([21bc3bf](https://github.com/npm/npx/commit/21bc3bf)) 655 | 656 | 657 | 658 | 659 | ## [4.0.2](https://github.com/npm/npx/compare/v4.0.1...v4.0.2) (2017-06-04) 660 | 661 | 662 | ### Bug Fixes 663 | 664 | * **install:** get windows workin (#27) ([9472175](https://github.com/npm/npx/commit/9472175)) 665 | 666 | 667 | 668 | 669 | ## [4.0.1](https://github.com/npm/npx/compare/v4.0.0...v4.0.1) (2017-06-04) 670 | 671 | 672 | ### Bug Fixes 673 | 674 | * **cmd:** make sure to use our own, enriched path ([9c89c2a](https://github.com/npm/npx/commit/9c89c2a)) 675 | * **error:** join args with a space on Command failed error ([c2f6f18](https://github.com/npm/npx/commit/c2f6f18)) 676 | 677 | 678 | 679 | 680 | # [4.0.0](https://github.com/npm/npx/compare/v3.0.0...v4.0.0) (2017-06-03) 681 | 682 | 683 | ### Features 684 | 685 | * **call:** -c now loads same env as run-script ([76ae44c](https://github.com/npm/npx/commit/76ae44c)) 686 | * **npm:** allow configuration of npm binary ([e5d5634](https://github.com/npm/npx/commit/e5d5634)) 687 | * **npm:** embed npm binary ([a2cae9d](https://github.com/npm/npx/commit/a2cae9d)) 688 | 689 | 690 | ### BREAKING CHANGES 691 | 692 | * **call:** scripts invoked with -c will now have a bunch of 693 | variables added to them that were not there before. 694 | * **npm:** npx will no longer use the system npm -- it embeds its own 695 | 696 | 697 | 698 | 699 | # [3.0.0](https://github.com/npm/npx/compare/v2.1.0...v3.0.0) (2017-06-03) 700 | 701 | 702 | ### Bug Fixes 703 | 704 | * **args:** accept argv as arg and fix minor bugs ([46f10fe](https://github.com/npm/npx/commit/46f10fe)) 705 | * **deps:** explicitly add mkdirp and rimraf to devDeps ([832c75d](https://github.com/npm/npx/commit/832c75d)) 706 | * **docs:** misc tweaks to docs ([ed70a7b](https://github.com/npm/npx/commit/ed70a7b)) 707 | * **exec:** escape binaries and args to cp.exec (#18) ([55d6a11](https://github.com/npm/npx/commit/55d6a11)) 708 | * **fallback:** shells were sometimes ignored based on $SHELL ([07b7efc](https://github.com/npm/npx/commit/07b7efc)) 709 | * **get-prefix:** nudge isRootPath ([1ab31eb](https://github.com/npm/npx/commit/1ab31eb)) 710 | * **help:** correctly enable -h and --help ([adc2f45](https://github.com/npm/npx/commit/adc2f45)) 711 | * **startup:** delay loading some things to speed up startup ([6b32bf5](https://github.com/npm/npx/commit/6b32bf5)) 712 | 713 | 714 | ### Features 715 | 716 | * **cmd:** do some heuristic guesswork on default command names (#23) ([2404420](https://github.com/npm/npx/commit/2404420)) 717 | * **ignore:** add --ignore-existing option (#20) ([0866a83](https://github.com/npm/npx/commit/0866a83)) 718 | * **install:** added --no-install option to prevent install fallbacks ([a5fbdaf](https://github.com/npm/npx/commit/a5fbdaf)) 719 | * **package:** multiple --package options are now accepted ([f2fa6b3](https://github.com/npm/npx/commit/f2fa6b3)) 720 | * **save:** remove all save-related functionality (#19) ([ab77f6c](https://github.com/npm/npx/commit/ab77f6c)) 721 | * **shell:** run -c strings inside a system shell (#22) ([17db461](https://github.com/npm/npx/commit/17db461)) 722 | 723 | 724 | ### BREAKING CHANGES 725 | 726 | * **save:** npx can no longer be used to save packages locally or globally. Use an actual package manager for that, instead. 727 | 728 | 729 | 730 | 731 | # [2.1.0](https://github.com/npm/npx/compare/v2.0.1...v2.1.0) (2017-06-01) 732 | 733 | 734 | ### Features 735 | 736 | * **opts:** add --shell-auto-fallback (#7) ([ac9cb40](https://github.com/npm/npx/commit/ac9cb40)) 737 | 738 | 739 | 740 | 741 | ## [2.0.1](https://github.com/npm/npx/compare/v2.0.0...v2.0.1) (2017-05-31) 742 | 743 | 744 | ### Bug Fixes 745 | 746 | * **exec:** use command lookup joined with current PATH ([d9175e8](https://github.com/npm/npx/commit/d9175e8)) 747 | 748 | 749 | 750 | 751 | # [2.0.0](https://github.com/npm/npx/compare/v1.1.1...v2.0.0) (2017-05-31) 752 | 753 | 754 | ### Bug Fixes 755 | 756 | * **npm:** manually look up npm path for Windows compat ([0fe8fbf](https://github.com/npm/npx/commit/0fe8fbf)) 757 | 758 | 759 | ### Features 760 | 761 | * **commands:** -p and [@version](https://github.com/version) now trigger installs ([9668c83](https://github.com/npm/npx/commit/9668c83)) 762 | 763 | 764 | ### BREAKING CHANGES 765 | 766 | * **commands:** If a command has an explicit --package option, or if the command has an @version part, any version of the command in $PATH will be ignored and a regular install will be executed. 767 | 768 | 769 | 770 | 771 | ## [1.1.1](https://github.com/npm/npx/compare/v1.1.0...v1.1.1) (2017-05-30) 772 | 773 | 774 | ### Bug Fixes 775 | 776 | * **docs:** make sure man page gets installed ([2aadc16](https://github.com/npm/npx/commit/2aadc16)) 777 | 778 | 779 | 780 | 781 | # [1.1.0](https://github.com/npm/npx/compare/v1.0.2...v1.1.0) (2017-05-30) 782 | 783 | 784 | ### Bug Fixes 785 | 786 | * **help:** update usage string for help ([0747cff](https://github.com/npm/npx/commit/0747cff)) 787 | * **main:** exit if no package was parsed ([cdb579d](https://github.com/npm/npx/commit/cdb579d)) 788 | * **opts:** allow -- to prevent further parsing ([db7a0e4](https://github.com/npm/npx/commit/db7a0e4)) 789 | 790 | 791 | ### Features 792 | 793 | * **updates:** added update-notifier ([8dc91d4](https://github.com/npm/npx/commit/8dc91d4)) 794 | 795 | 796 | 797 | 798 | ## [1.0.2](https://github.com/npm/npx/compare/v1.0.1...v1.0.2) (2017-05-30) 799 | 800 | 801 | ### Bug Fixes 802 | 803 | * **pkg:** bundle deps to guarantee global install precision ([3e21217](https://github.com/npm/npx/commit/3e21217)) 804 | 805 | 806 | 807 | 808 | ## [1.0.1](https://github.com/npm/npx/compare/v1.0.0...v1.0.1) (2017-05-30) 809 | 810 | 811 | ### Bug Fixes 812 | 813 | * **build:** add dummy test file to let things build ([6199eb6](https://github.com/npm/npx/commit/6199eb6)) 814 | * **docs:** fix arg documentation in readme/manpage ([d1cf44c](https://github.com/npm/npx/commit/d1cf44c)) 815 | * **opts:** add --version/-v ([2633a0e](https://github.com/npm/npx/commit/2633a0e)) 816 | 817 | 818 | 819 | 820 | # 1.0.0 (2017-05-30) 821 | 822 | 823 | ### Features 824 | 825 | * **npx:** initial working implementation ([a83a67d](https://github.com/npm/npx/commit/a83a67d)) 826 | -------------------------------------------------------------------------------- /LICENSE.md: -------------------------------------------------------------------------------- 1 | ISC License 2 | 3 | Copyright (c) npm, Inc. 4 | 5 | Permission to use, copy, modify, and/or distribute this software for 6 | any purpose with or without fee is hereby granted, provided that the 7 | above copyright notice and this permission notice appear in all copies. 8 | 9 | THE SOFTWARE IS PROVIDED "AS IS" AND THE COPYRIGHT HOLDER DISCLAIMS 10 | ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED 11 | WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE 12 | COPYRIGHT HOLDER BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR 13 | CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS 14 | OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE 15 | OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE 16 | USE OR PERFORMANCE OF THIS SOFTWARE. 17 | -------------------------------------------------------------------------------- /Makefile: -------------------------------------------------------------------------------- 1 | text-files = README.md CHANGELOG.md LICENSE.md 2 | 3 | bin: bin/npx.1 bin/package.json bin/node_modules $(text-files) 4 | 5 | bin/%: $(text-files) 6 | cp $(text-files) bin/ 7 | 8 | bin/npx.1: libnpx.1 9 | cat $< | sed s/libnpx/npx/ > $@ 10 | 11 | libnpx.1: README.md 12 | npm run docs 13 | 14 | bin/package.json: package.json bin/package.template.json 15 | cat bin/package.template.json | npx json -e "this.version = '$$(cat package.json | npx json version)'" > $@ 16 | npx json -I -f $@ -e "this.dependencies.libnpx = '$$(cat $@ | npx json version)'" 17 | 18 | bin/node_modules: bin/package.json 19 | cd bin && npm i 20 | 21 | clean: 22 | rm -rf bin/npx.1 bin/package.json bin/node_modules libnpx.1 $(addprefix bin/, $(text-files)) 23 | 24 | .PHONY: clean 25 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | ⚠️ DEPRECATED: This project has been deprecated - **npx** is now part of the **[npm cli](https://github.com/npm/cli)** 2 | 3 | [![npm](https://img.shields.io/npm/v/npx.svg)](https://npm.im/npx) [![license](https://img.shields.io/npm/l/npx.svg)](https://npm.im/npx) [![Travis](https://img.shields.io/travis/npm/npx.svg)](https://travis-ci.org/npm/npx) [![AppVeyor](https://ci.appveyor.com/api/projects/status/github/npm/npx?svg=true)](https://ci.appveyor.com/project/npm/npx) [![Coverage Status](https://coveralls.io/repos/github/npm/npx/badge.svg?branch=latest)](https://coveralls.io/github/npm/npx?branch=latest) 4 | 5 | # npx(1) -- execute npm package binaries 6 | 7 | ## SYNOPSIS 8 | 9 | `npx [options] [@version] [command-arg]...` 10 | 11 | `npx [options] [-p|--package ]... [command-arg]...` 12 | 13 | `npx [options] -c ''` 14 | 15 | `npx --shell-auto-fallback [shell]` 16 | 17 | ## INSTALL 18 | 19 | `npm install -g npx` 20 | 21 | ## DESCRIPTION 22 | 23 | Executes `` either from a local `node_modules/.bin`, or from a central cache, installing any packages needed in order for `` to run. 24 | 25 | By default, `npx` will check whether `` exists in `$PATH`, or in the local project binaries, and execute that. If `` is not found, it will be installed prior to execution. 26 | 27 | Unless a `--package` option is specified, `npx` will try to guess the name of the binary to invoke depending on the specifier provided. All package specifiers understood by `npm` may be used with `npx`, including git specifiers, remote tarballs, local directories, or scoped packages. 28 | 29 | If a full specifier is included, or if `--package` is used, npx will always use a freshly-installed, temporary version of the package. This can also be forced with the `--ignore-existing` flag. 30 | 31 | * `-p, --package ` - define the package to be installed. This defaults to the value of ``. This is only needed for packages with multiple binaries if you want to call one of the other executables, or where the binary name does not match the package name. If this option is provided `` will be executed as-is, without interpreting `@version` if it's there. Multiple `--package` options may be provided, and all the packages specified will be installed. 32 | 33 | * `--no-install` - If passed to `npx`, it will only try to run `` if it already exists in the current path or in `$prefix/node_modules/.bin`. It won't try to install missing commands. 34 | 35 | * `--cache ` - set the location of the npm cache. Defaults to npm's own cache settings. 36 | 37 | * `--userconfig ` - path to the user configuration file to pass to npm. Defaults to whatever npm's current default is. 38 | 39 | * `-c ` - Execute `` inside an `npm run-script`-like shell environment, with all the usual environment variables available. Only the first item in `` will be automatically used as ``. Any others _must_ use `-p`. 40 | 41 | * `--shell ` - The shell to invoke the command with, if any. 42 | 43 | * `--shell-auto-fallback []` - Generates shell code to override your shell's "command not found" handler with one that calls `npx`. Tries to figure out your shell, or you can pass its name (either `bash`, `fish`, or `zsh`) as an option. See below for how to install. 44 | 45 | * `--ignore-existing` - If this flag is set, npx will not look in `$PATH`, or in the current package's `node_modules/.bin` for an existing version before deciding whether to install. Binaries in those paths will still be available for execution, but will be shadowed by any packages requested by this install. 46 | 47 | * `-q, --quiet` - Suppressed any output from npx itself (progress bars, error messages, install reports). Subcommand output itself will not be silenced. 48 | 49 | * `-n, --node-arg` - Extra node argument to supply to node when binary is a node script. You can supply this option multiple times to add more arguments. 50 | 51 | * `-v, --version` - Show the current npx version. 52 | 53 | ## EXAMPLES 54 | 55 | ### Running a project-local bin 56 | 57 | ``` 58 | $ npm i -D webpack 59 | $ npx webpack ... 60 | ``` 61 | 62 | ### One-off invocation without local installation 63 | 64 | ``` 65 | $ npm rm webpack 66 | $ npx webpack -- ... 67 | $ cat package.json 68 | ...webpack not in "devDependencies"... 69 | ``` 70 | 71 | ### Invoking a command from a github repository 72 | 73 | ``` 74 | $ npx github:piuccio/cowsay 75 | ...or... 76 | $ npx git+ssh://my.hosted.git:cowsay.git#semver:^1 77 | ...etc... 78 | ``` 79 | 80 | ### Execute a full shell command using one npx call w/ multiple packages 81 | 82 | ``` 83 | $ npx -p lolcatjs -p cowsay -c \ 84 | 'echo "$npm_package_name@$npm_package_version" | cowsay | lolcatjs' 85 | ... 86 | _____ 87 | < your-cool-package@1.2.3 > 88 | ----- 89 | \ ^__^ 90 | \ (oo)\_______ 91 | (__)\ )\/\ 92 | ||----w | 93 | || || 94 | ``` 95 | 96 | ### Run node binary with --inspect 97 | 98 | ``` 99 | $ npx --node-arg=--inspect cowsay 100 | Debugger listening on ws://127.0.0.1:9229/.... 101 | ``` 102 | 103 | ### Specify a node version to run npm scripts (or anything else!) 104 | 105 | ``` 106 | npx -p node@8 npm run build 107 | ``` 108 | 109 | ## SHELL AUTO FALLBACK 110 | 111 | You can configure `npx` to run as your default fallback command when you type something in the command line with an `@` but the command is not found. This includes installing packages that were not found in the local prefix either. 112 | 113 | For example: 114 | 115 | ``` 116 | $ npm@4 --version 117 | (stderr) npm@4 not found. Trying with npx... 118 | 4.6.1 119 | $ asdfasdfasf 120 | zsh: command not found: asfdasdfasdf 121 | ``` 122 | 123 | Currently, `zsh`, `bash` (>= 4), and `fish` are supported. You can access these completion scripts using `npx --shell-auto-fallback `. 124 | 125 | To install permanently, add the relevant line below to your `~/.bashrc`, `~/.zshrc`, `~/.config/fish/config.fish`, or as needed. To install just for the shell session, simply run the line. 126 | 127 | You can optionally pass through `--no-install` when generating the fallback to prevent it from installing packages if the command is missing. 128 | 129 | ### For bash@>=4: 130 | 131 | ``` 132 | $ source <(npx --shell-auto-fallback bash) 133 | ``` 134 | 135 | ### For zsh: 136 | 137 | ``` 138 | $ source <(npx --shell-auto-fallback zsh) 139 | ``` 140 | 141 | ### For fish: 142 | 143 | ``` 144 | $ source (npx --shell-auto-fallback fish | psub) 145 | ``` 146 | 147 | ## ACKNOWLEDGEMENTS 148 | 149 | Huge thanks to [Kwyn Meagher](https://blog.kwyn.io) for generously donating the package name in the main npm registry. Previously `npx` was used for a Tessel board Neopixels library, which can now be found under [`npx-tessel`](https://npm.im/npx-tessel). 150 | 151 | ## AUTHOR 152 | 153 | Written by [Kat Marchan](https://github.com/zkat). 154 | 155 | ## REPORTING BUGS 156 | 157 | Please file any relevant issues [against the npm/cli repo.](https://github.com/npm/cli) 158 | 159 | ## LICENSE 160 | 161 | This work is released by its authors into the public domain under CC0-1.0. See `LICENSE.md` for details. 162 | 163 | ## SEE ALSO 164 | 165 | * `npm(1)` 166 | * `npm-run-script(1)` 167 | * `npm-config(7)` 168 | -------------------------------------------------------------------------------- /appveyor.yml: -------------------------------------------------------------------------------- 1 | environment: 2 | matrix: 3 | - nodejs_version: "10" 4 | - nodejs_version: "9" 5 | - nodejs_version: "8" 6 | - nodejs_version: "6" 7 | 8 | platform: 9 | - x64 10 | 11 | install: 12 | - ps: Install-Product node $env:nodejs_version $env:platform 13 | - npm config set spin false 14 | - npm i -g npm@latest 15 | - npm install 16 | 17 | cache: 18 | - '%APPDATA%\npm-cache' 19 | 20 | test_script: 21 | - npm test 22 | 23 | matrix: 24 | fast_finish: true 25 | 26 | build: off 27 | -------------------------------------------------------------------------------- /auto-fallback.js: -------------------------------------------------------------------------------- 1 | 'use strict' 2 | 3 | const Y = require('./y.js') 4 | 5 | function mkPosix (opts) { 6 | return ` 7 | command_not_found_${opts.isBash ? 'handle' : 'handler'}() { 8 | # Do not run within a pipe 9 | if test ! -t 1; then 10 | >&2 echo "${Y`command not found: ${'$1'}`}" 11 | return 127 12 | fi 13 | if which npx > /dev/null; then 14 | echo "${Y`${'$1'} not found. Trying with npx...`}" >&2 15 | else 16 | return 127 17 | fi 18 | if ! [[ $1 =~ @ ]]; then 19 | npx --no-install "$@" 20 | else 21 | npx "$@" 22 | fi 23 | return $? 24 | }` 25 | } 26 | 27 | function mkFish (opts) { 28 | return ` 29 | function __fish_command_not_found_on_interactive --on-event fish_prompt 30 | functions --erase __fish_command_not_found_handler 31 | functions --erase __fish_command_not_found_setup 32 | 33 | function __fish_command_not_found_handler --on-event fish_command_not_found 34 | if which npx > /dev/null 35 | echo "${Y`${'$argv[1]'} not found. Trying with npx...`}" >&2 36 | else 37 | return 127 38 | end 39 | if string match -q -r @ $argv[1] 40 | npx $argv 41 | else 42 | npx --no-install $argv 43 | end 44 | end 45 | 46 | functions --erase __fish_command_not_found_on_interactive 47 | end` 48 | } 49 | 50 | module.exports = autoFallback 51 | function autoFallback (shell, fromEnv, opts) { 52 | if (shell.includes('bash')) { 53 | return mkPosix({isBash: true, install: opts.install}) 54 | } 55 | 56 | if (shell.includes('zsh')) { 57 | return mkPosix({isBash: false, install: opts.install}) 58 | } 59 | 60 | if (shell.includes('fish')) { 61 | return mkFish(opts) 62 | } 63 | 64 | if (fromEnv) { 65 | return autoFallback(fromEnv, null, opts) 66 | } 67 | 68 | console.error(Y`Only Bash, Zsh, and Fish shells are supported :(`) 69 | } 70 | -------------------------------------------------------------------------------- /bin/.gitignore: -------------------------------------------------------------------------------- 1 | /README.md 2 | /package.json 3 | /npx.1 4 | /package-lock.json 5 | /node_modules 6 | -------------------------------------------------------------------------------- /bin/index.js: -------------------------------------------------------------------------------- 1 | #!/usr/bin/env node 2 | 3 | const npx = require('libnpx') 4 | const path = require('path') 5 | 6 | const NPM_PATH = path.join(__dirname, 'node_modules', 'npm', 'bin', 'npm-cli.js') 7 | 8 | const parsed = npx.parseArgs(process.argv, NPM_PATH) 9 | parsed.npxPkg = path.join(__dirname, 'package.json') 10 | npx(parsed) 11 | -------------------------------------------------------------------------------- /bin/package.template.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "npx", 3 | "description": "execute npm package binaries", 4 | "main": "index.js", 5 | "bin": "index.js", 6 | "man": "./npx.1", 7 | "files": [ 8 | "*.js", 9 | "npx.1" 10 | ], 11 | "keywords": [ 12 | "npm", 13 | "npm exec", 14 | "shell", 15 | "scripts", 16 | "npm bin", 17 | "cli" 18 | ], 19 | "repository": "https://github.com/npm/npx", 20 | "author": { 21 | "name": "Kat Marchán", 22 | "email": "kzm@sykosomatic.org", 23 | "twitter": "maybekatz" 24 | }, 25 | "license": "ISC", 26 | "dependencies": { 27 | "npm": "5.1.0", 28 | "libnpx": "" 29 | }, 30 | "bundleDependencies": [ 31 | "npm", 32 | "libnpx" 33 | ] 34 | } 35 | -------------------------------------------------------------------------------- /child.js: -------------------------------------------------------------------------------- 1 | 'use strict' 2 | 3 | const cp = require('child_process') 4 | const path = require('path') 5 | 6 | module.exports.runCommand = runCommand 7 | function runCommand (command, opts) { 8 | const cmd = opts.call || command || opts.command 9 | const copts = (opts.call ? [] : opts.cmdOpts) || [] 10 | return spawn(cmd, copts, { 11 | shell: opts.shell || !!opts.call, 12 | stdio: opts.stdio || 'inherit' 13 | }).catch(err => { 14 | if (err.code === 'ENOENT') { 15 | err = new Error( 16 | `npx: ${ 17 | require('./y.js')`command not found: ${path.basename(cmd)}` 18 | }` 19 | ) 20 | err.exitCode = 127 21 | } else { 22 | err.message = require('./y.js')`Command failed: ${cmd} ${err.message}` 23 | } 24 | throw err 25 | }) 26 | } 27 | 28 | module.exports.spawn = spawn 29 | function spawn (cmd, args, opts) { 30 | opts = opts || {} 31 | opts.shell = opts.shell || process.platform === 'win32' 32 | return new Promise((resolve, reject) => { 33 | const child = cp.spawn(cmd, args, opts) 34 | let stdout = '' 35 | let stderr = '' 36 | child.stdout && child.stdout.on('data', d => { stdout += d }) 37 | child.stderr && child.stderr.on('data', d => { stderr += d }) 38 | child.on('error', reject) 39 | child.on('close', code => { 40 | if (code) { 41 | const err = new Error( 42 | require('./y.js')`Command failed: ${cmd} ${args.join(' ')}` 43 | ) 44 | err.isOperational = true 45 | err.stderr = stderr 46 | err.exitCode = code 47 | reject(err) 48 | } else { 49 | resolve({code, stdout, stderr}) 50 | } 51 | }) 52 | }) 53 | } 54 | 55 | module.exports.exec = exec 56 | function exec (cmd, args, opts) { 57 | opts = opts || {} 58 | return new Promise((resolve, reject) => { 59 | cp.exec(`${escapeArg(cmd, true)} ${ 60 | args.join(' ') 61 | }`, opts, (err, stdout) => { 62 | if (err) { 63 | if (typeof err.code === 'number') { 64 | err.exitCode = err.code 65 | } 66 | reject(err) 67 | } else { 68 | resolve(stdout) 69 | } 70 | }) 71 | }) 72 | } 73 | 74 | module.exports.escapeArg = escapeArg 75 | function escapeArg (str, asPath) { 76 | return process.platform === 'win32' && asPath 77 | ? path.normalize(str) 78 | .split(/\\/) 79 | .map(s => s.match(/\s+/) ? `"${s}"` : s) 80 | .join('\\') 81 | : process.platform === 'win32' 82 | ? `"${str}"` 83 | : str.match(/[^-_.~/\w]/) 84 | ? `'${str.replace(/'/g, "'\"'\"'")}'` 85 | : str 86 | } 87 | -------------------------------------------------------------------------------- /get-prefix.js: -------------------------------------------------------------------------------- 1 | 'use strict' 2 | 3 | const promisify = require('./util.js').promisify 4 | 5 | const path = require('path') 6 | const statAsync = promisify(require('fs').stat) 7 | 8 | module.exports = getPrefix 9 | function getPrefix (root) { 10 | const original = root = path.resolve(root) 11 | while (path.basename(root) === 'node_modules') { 12 | root = path.dirname(root) 13 | } 14 | if (original !== root) { 15 | return Promise.resolve(root) 16 | } else { 17 | return Promise.resolve(getPrefixFromTree(root)) 18 | } 19 | } 20 | 21 | function getPrefixFromTree (current) { 22 | if (isRootPath(current, process.platform)) { 23 | return false 24 | } else { 25 | return Promise.all([ 26 | fileExists(path.join(current, 'package.json')), 27 | fileExists(path.join(current, 'node_modules')) 28 | ]).then(args => { 29 | const hasPkg = args[0] 30 | const hasModules = args[1] 31 | if (hasPkg || hasModules) { 32 | return current 33 | } else { 34 | return getPrefixFromTree(path.dirname(current)) 35 | } 36 | }) 37 | } 38 | } 39 | 40 | module.exports._fileExists = fileExists 41 | function fileExists (f) { 42 | return statAsync(f).catch(err => { 43 | if (err.code !== 'ENOENT') { 44 | throw err 45 | } 46 | }) 47 | } 48 | 49 | module.exports._isRootPath = isRootPath 50 | function isRootPath (p, platform) { 51 | return platform === 'win32' 52 | ? p.match(/^[a-z]+:[/\\]?$/i) 53 | : p === '/' 54 | } 55 | -------------------------------------------------------------------------------- /index.js: -------------------------------------------------------------------------------- 1 | 'use strict' 2 | 3 | const Buffer = require('safe-buffer').Buffer 4 | const promisify = require('./util.js').promisify 5 | 6 | const child = require('./child') 7 | const fs = require('fs') 8 | const parseArgs = require('./parse-args.js') 9 | const path = require('path') 10 | const which = promisify(require('which')) 11 | 12 | module.exports = npx 13 | module.exports.parseArgs = parseArgs 14 | function npx (argv) { 15 | const shell = argv['shell-auto-fallback'] 16 | if (shell || shell === '') { 17 | const fallback = require('./auto-fallback.js')( 18 | shell, process.env.SHELL, argv 19 | ) 20 | if (fallback) { 21 | return console.log(fallback) 22 | } else { 23 | process.exitCode = 1 24 | return 25 | } 26 | } 27 | 28 | if (!argv.call && (!argv.command || !argv.package)) { 29 | !argv.q && console.error(Y()`\nERROR: You must supply a command.\n`) 30 | !argv.q && parseArgs.showHelp() 31 | process.exitCode = 1 32 | return 33 | } 34 | 35 | const startTime = Date.now() 36 | 37 | // First, we look to see if we're inside an npm project, and grab its 38 | // bin path. This is exactly the same as running `$ npm bin`. 39 | return localBinPath(process.cwd()).then(local => { 40 | if (local) { 41 | // Local project paths take priority. Go ahead and prepend it. 42 | process.env.PATH = `${local}${path.delimiter}${process.env.PATH}` 43 | } 44 | return Promise.all([ 45 | // Figuring out if a command exists, early on, lets us maybe 46 | // short-circuit a few things later. This bit here primarily benefits 47 | // calls like `$ npx foo`, where we might just be trying to invoke 48 | // a single command and use whatever is already in the path. 49 | argv.command && getExistingPath(argv.command, argv), 50 | // The `-c` flag involves special behavior when used: in this case, 51 | // we take a bit of extra time to pick up npm's full lifecycle script 52 | // environment (so you can use `$npm_package_xxxxx` and company). 53 | // Without that flag, we just use the current env. 54 | argv.call && local && getEnv(argv) 55 | ]).then(args => { 56 | const existing = args[0] 57 | const newEnv = args[1] 58 | if (newEnv) { 59 | // NOTE - we don't need to manipulate PATH further here, because 60 | // npm has already done so. And even added the node-gyp path! 61 | Object.assign(process.env, newEnv) 62 | } 63 | if ((!existing && !argv.call) || argv.packageRequested) { 64 | // We only fire off the updateNotifier if we're installing things 65 | if (argv.npxPkg) { 66 | try { 67 | require('update-notifier')({ 68 | pkg: require(argv.npxPkg) 69 | }).notify() 70 | } catch (e) {} 71 | } 72 | // Some npm packages need to be installed. Let's install them! 73 | return ensurePackages(argv.package, argv).then(results => { 74 | if (results && results.added && results.updated && !argv.q) { 75 | console.error(Y()`npx: installed ${ 76 | results.added.length + results.updated.length 77 | } in ${(Date.now() - startTime) / 1000}s`) 78 | } 79 | if ( 80 | argv.command && 81 | !existing && 82 | !argv.packageRequested && 83 | argv.package.length === 1 84 | ) { 85 | return promisify(fs.readdir)(results.bin).then(bins => { 86 | if (process.platform === 'win32') { 87 | bins = bins.filter(b => b !== 'etc' && b !== 'node_modules') 88 | } 89 | if (bins.length < 1) { 90 | throw new Error(Y()`command not found: ${argv.command}`) 91 | } 92 | const cmd = new RegExp(`^${argv.command}(?:\\.cmd)?$`, 'i') 93 | const matching = bins.find(b => b.match(cmd)) 94 | return path.resolve(results.bin, bins[matching] || bins[0]) 95 | }, err => { 96 | if (err.code === 'ENOENT') { 97 | throw new Error(Y()`command not found: ${argv.command}`) 98 | } else { 99 | throw err 100 | } 101 | }) 102 | } else { 103 | return existing 104 | } 105 | }) 106 | } else { 107 | // We can skip any extra installation, 'cause everything exists. 108 | return existing 109 | } 110 | }).then(existing => { 111 | return execCommand(existing, argv) 112 | }).catch(err => { 113 | !argv.q && console.error(err.message) 114 | process.exitCode = err.exitCode || 1 115 | }) 116 | }) 117 | } 118 | 119 | module.exports._localBinPath = localBinPath 120 | function localBinPath (cwd) { 121 | return require('./get-prefix.js')(cwd).then(prefix => { 122 | return prefix && path.join(prefix, 'node_modules', '.bin') 123 | }) 124 | } 125 | 126 | module.exports._getEnv = getEnv 127 | function getEnv (opts) { 128 | const args = ['run', 'env', '--parseable'] 129 | return findNodeScript(opts.npm, {isLocal: true}).then(npmPath => { 130 | if (npmPath) { 131 | args.unshift(child.escapeArg(opts.npm)) 132 | return process.argv[0] 133 | } else { 134 | return opts.npm 135 | } 136 | }).then(npmPath => { 137 | return child.exec(npmPath, args) 138 | }).then(require('dotenv').parse) 139 | } 140 | 141 | module.exports._ensurePackages = ensurePackages 142 | function ensurePackages (specs, opts) { 143 | return ( 144 | opts.cache ? Promise.resolve(opts.cache) : getNpmCache(opts) 145 | ).then(cache => { 146 | const prefix = path.join(cache, '_npx', process.pid.toString()) 147 | const bins = process.platform === 'win32' 148 | ? prefix 149 | : path.join(prefix, 'bin') 150 | const rimraf = require('rimraf') 151 | process.on('exit', () => rimraf.sync(prefix)) 152 | return promisify(rimraf)(bins).then(() => { 153 | return installPackages(specs, prefix, opts) 154 | }).then(info => { 155 | // This will make temp bins _higher priority_ than even local bins. 156 | // This is intentional, since npx assumes that if you went through 157 | // the trouble of doing `-p`, you're rather have that one. Right? ;) 158 | process.env.PATH = `${bins}${path.delimiter}${process.env.PATH}` 159 | if (!info) { info = {} } 160 | info.prefix = prefix 161 | info.bin = bins 162 | return info 163 | }) 164 | }) 165 | } 166 | 167 | module.exports._getExistingPath = getExistingPath 168 | function getExistingPath (command, opts) { 169 | if (opts.isLocal) { 170 | return Promise.resolve(command) 171 | } else if ( 172 | opts.cmdHadVersion || opts.packageRequested || opts.ignoreExisting 173 | ) { 174 | return Promise.resolve(false) 175 | } else { 176 | return which(command).catch(err => { 177 | if (err.code === 'ENOENT') { 178 | if (opts.install === false) { 179 | err.exitCode = 127 180 | throw err 181 | } 182 | } else { 183 | throw err 184 | } 185 | }) 186 | } 187 | } 188 | 189 | module.exports._getNpmCache = getNpmCache 190 | function getNpmCache (opts) { 191 | const args = ['config', 'get', 'cache', '--parseable'] 192 | if (opts.userconfig) { 193 | args.push('--userconfig', child.escapeArg(opts.userconfig, true)) 194 | } 195 | return findNodeScript(opts.npm, {isLocal: true}).then(npmPath => { 196 | if (npmPath) { 197 | // This one is NOT escaped as a path because it's handed to Node. 198 | args.unshift(child.escapeArg(opts.npm)) 199 | return process.argv[0] 200 | } else { 201 | return opts.npm 202 | } 203 | }).then(npmPath => { 204 | return child.exec(npmPath, args) 205 | }).then(cache => cache.trim()) 206 | } 207 | 208 | module.exports._buildArgs = buildArgs 209 | function buildArgs (specs, prefix, opts) { 210 | const args = ['install'].concat(specs) 211 | args.push('--global', '--prefix', prefix) 212 | if (opts.cache) args.push('--cache', opts.cache) 213 | if (opts.userconfig) args.push('--userconfig', opts.userconfig) 214 | args.push('--loglevel', 'error', '--json') 215 | 216 | return args 217 | } 218 | 219 | module.exports._installPackages = installPackages 220 | function installPackages (specs, prefix, opts) { 221 | const args = buildArgs(specs, prefix, opts) 222 | return findNodeScript(opts.npm, {isLocal: true}).then(npmPath => { 223 | if (npmPath) { 224 | args.unshift( 225 | process.platform === 'win32' 226 | ? child.escapeArg(opts.npm) 227 | : opts.npm 228 | ) 229 | return process.argv[0] 230 | } else { 231 | return opts.npm 232 | } 233 | }).then(npmPath => { 234 | return process.platform === 'win32' ? child.escapeArg(npmPath, true) : npmPath 235 | }).then(npmPath => { 236 | return child.spawn(npmPath, args, { 237 | stdio: opts.installerStdio 238 | ? opts.installerStdio 239 | : [0, 'pipe', opts.q ? 'ignore' : 2] 240 | }).then(deets => { 241 | try { 242 | return deets.stdout ? JSON.parse(deets.stdout) : null 243 | } catch (e) { } 244 | }, err => { 245 | if (err.exitCode) { 246 | err.message = Y()`Install for ${specs} failed with code ${err.exitCode}` 247 | } 248 | throw err 249 | }) 250 | }) 251 | } 252 | 253 | module.exports._execCommand = execCommand 254 | function execCommand (_existing, argv) { 255 | return findNodeScript(_existing, argv).then(existing => { 256 | const argvCmdOpts = argv.cmdOpts || [] 257 | if (existing && !argv.alwaysSpawn && !argv.nodeArg && !argv.shell && existing !== process.argv[1]) { 258 | const Module = require('module') 259 | // let it take over the process. This means we can skip node startup! 260 | if (!argv.noYargs) { 261 | // blow away built-up yargs crud 262 | require('yargs').reset() 263 | } 264 | process.argv = [ 265 | process.argv[0], // Current node binary 266 | existing // node script path. `runMain()` will set this as the new main 267 | ].concat(argvCmdOpts) // options for the cmd itself 268 | Module.runMain() // ✨MAGIC✨. Sorry-not-sorry 269 | } else if (!existing && argv.nodeArg && argv.nodeArg.length) { 270 | throw new Error(Y()`ERROR: --node-arg/-n can only be used on packages with node scripts.`) 271 | } else { 272 | let cmd = existing 273 | let cmdOpts = argvCmdOpts 274 | if (existing) { 275 | cmd = process.argv[0] 276 | if (process.platform === 'win32') { 277 | cmd = child.escapeArg(cmd, true) 278 | } 279 | // If we know we're running a run script and we got a --node-arg, 280 | // we need to fudge things a bit to get them working right. 281 | cmdOpts = argv.nodeArg 282 | if (cmdOpts) { 283 | cmdOpts = Array.isArray(cmdOpts) ? cmdOpts : [cmdOpts] 284 | } else { 285 | cmdOpts = [] 286 | } 287 | // It's valid for a single arg to be a string of multiple 288 | // space-separated node args. 289 | // Example: `$ npx -n '--inspect --harmony --debug' ...` 290 | cmdOpts = cmdOpts.reduce((acc, arg) => { 291 | return acc.concat(arg.split(/\s+/)) 292 | }, []) 293 | cmdOpts = cmdOpts.concat(existing, argvCmdOpts) 294 | } 295 | const opts = Object.assign({}, argv, { cmdOpts }) 296 | return child.runCommand(cmd, opts).catch(err => { 297 | if (err.isOperational && err.exitCode) { 298 | // At this point, we want to treat errors from the child as if 299 | // we were just running the command. That means no extra msg logging 300 | process.exitCode = err.exitCode 301 | } else { 302 | // But if it's not just a regular child-level error, blow up normally 303 | throw err 304 | } 305 | }) 306 | } 307 | }) 308 | } 309 | 310 | module.exports._findNodeScript = findNodeScript 311 | function findNodeScript (existing, opts) { 312 | if (!existing) { 313 | return Promise.resolve(false) 314 | } else { 315 | return promisify(fs.stat)(existing).then(stat => { 316 | if (opts && opts.isLocal && path.extname(existing) === '.js') { 317 | return existing 318 | } else if (opts && opts.isLocal && stat.isDirectory()) { 319 | // npx will execute the directory itself 320 | try { 321 | const pkg = require(path.resolve(existing, 'package.json')) 322 | const target = path.resolve(existing, pkg.bin || pkg.main || 'index.js') 323 | return findNodeScript(target, opts).then(script => { 324 | if (script) { 325 | return script 326 | } else { 327 | throw new Error(Y()`command not found: ${target}`) 328 | } 329 | }) 330 | } catch (e) { 331 | throw new Error(Y()`command not found: ${existing}`) 332 | } 333 | } else if (process.platform !== 'win32') { 334 | const bytecount = 400 335 | const buf = Buffer.alloc(bytecount) 336 | return promisify(fs.open)(existing, 'r').then(fd => { 337 | return promisify(fs.read)(fd, buf, 0, bytecount, 0).then(() => { 338 | return promisify(fs.close)(fd) 339 | }, err => { 340 | return promisify(fs.close)(fd).then(() => { throw err }) 341 | }) 342 | }).then(() => { 343 | const re = /#!\s*(?:\/usr\/bin\/env\s*node|\/usr\/local\/bin\/node|\/usr\/bin\/node)\s*\r?\n/i 344 | return buf.toString('utf8').match(re) && existing 345 | }) 346 | } else if (process.platform === 'win32') { 347 | const buf = Buffer.alloc(1000) 348 | return promisify(fs.open)(existing, 'r').then(fd => { 349 | return promisify(fs.read)(fd, buf, 0, 1000, 0).then(() => { 350 | return promisify(fs.close)(fd) 351 | }, err => { 352 | return promisify(fs.close)(fd).then(() => { throw err }) 353 | }) 354 | }).then(() => { 355 | return buf.toString('utf8').trim() 356 | }).then(str => { 357 | const cmd = /"%~dp0\\node\.exe"\s+"%~dp0\\(.*)"\s+%\*/ 358 | const mingw = /"\$basedir\/node"\s+"\$basedir\/(.*)"\s+"\$@"/i 359 | return str.match(cmd) || str.match(mingw) 360 | }).then(match => { 361 | return match && path.join(path.dirname(existing), match[1]) 362 | }) 363 | } 364 | }) 365 | } 366 | } 367 | 368 | function Y () { 369 | return require('./y.js') 370 | } 371 | -------------------------------------------------------------------------------- /locales/ca.json: -------------------------------------------------------------------------------- 1 | { 2 | "Execute binaries from npm packages.\n%s": "Executa comandes de paquets de npm.\n%s", 3 | "Package to be installed.": "Paquet per a instal·lar.", 4 | "Location of the npm cache.": "Ruta de la memòria cau de npm.", 5 | "Skip installation if a package is missing.": "Salta el pas d'instal·lació si el paquet no està present.", 6 | "Path to user npmrc.": "Ruta al npmrc de l'usuari.", 7 | "Execute string as if inside `npm run-script`.": "Executa l'argument com si estigués dins de `npm run-script`.", 8 | "Shell to execute the command with, if any.": "Shell amb el qual s'executarà la comanda, si hi ha algun.", 9 | "Generate shell code to use npx as the \"command not found\" fallback.": "Genera codi de shell per utilizar npx com el replegament quan la comanda no existeix.", 10 | "Ignores existing binaries in $PATH, or in the local project. This forces npx to do a temporary install and use the latest version.": "Ignora comandaments en $PATH, o en el projecte local. Això obliga a npx a fer una instal·lació temporal i usar la versió més recent de la comanda.", 11 | "npm binary to use for internal operations.": "Comando d'npm que es farà servir per a operacions internes de npx.", 12 | "For the full documentation, see the manual page for npx(1).": "Per documentació completa, vegeu la pàgina del manual npx(1).", 13 | "Unable to guess a binary name from %s. Please use --package.": "No s'ha pogut endevinar el nom de la comanda usant %s. Si us plau utilitza --package.", 14 | "\nERROR: You must supply a command.\n": "\nERROR: Has proveir una comanda.\n", 15 | "Command failed: %s %s": "La comanda va fracasar: %s %s", 16 | "Install for %s failed with code %s": "instal·lació de %s fracassar amb codi %s", 17 | "%s not found. Trying with npx...": "%s no existeix. Provant-ho amb npx...", 18 | "command not found: %s": "comanda no existeix: %s", 19 | "options": "opcions", 20 | "command": "comanda", 21 | "version": "versió", 22 | "command-arg": "argument-de-comanda", 23 | "command-string": "text-de-comanda", 24 | "shell": "shell", 25 | "package": "paquet", 26 | "npx: installed %s in %ss": "npx: instal·lat %s en %ss", 27 | "Suppress output from npx itself. Subcommands will not be affected.": "Suprimir la sortida d' npx. Les sub-comandes no es veuran afectades." 28 | } 29 | -------------------------------------------------------------------------------- /locales/cs.json: -------------------------------------------------------------------------------- 1 | { 2 | "Execute binaries from npm packages.\n%s": "Spouštění skriptů z npm balíčků.\n%s", 3 | "Package to be installed.": "Balíček k instalaci.", 4 | "Location of the npm cache.": "Umístění npm keše.", 5 | "Skip installation if a package is missing.": "Neinstalovat chybějící balíčky.", 6 | "Path to user npmrc.": "Cesta k uživatelskému npmrc souboru.", 7 | "Execute string as if inside `npm run-script`.": "Příkaz, který se spustí jakoby uvnitř `npm run-script`.", 8 | "Shell to execute the command with, if any.": "Shell ke spuštění příkazu, pokud je třeba.", 9 | "Generate shell code to use npx as the \"command not found\" fallback.": "Vygenerovat shell kód použitelný jako \"command not found\" fallback.", 10 | "Ignores existing binaries in $PATH, or in the local project. This forces npx to do a temporary install and use the latest version.": "Ignorovat existující skripty v $PATH i v lokálním projektu, npx tak udělá dočasnou instalaci a použije poslední verzi balíčku.", 11 | "npm binary to use for internal operations.": "npm použité pro interní operace.", 12 | "For the full documentation, see the manual page for npx(1).": "Úplná dokumentace je dostupná v manuálu pro npx(1).", 13 | "Unable to guess a binary name from %s. Please use --package.": "Nelze uhodnout jméno skriptu z %s, použijte prosím --package.", 14 | "\nERROR: You must supply a command.\n": "\nCHYBA: Musíte zadat nějaký příkaz.\n", 15 | "Command failed: %s %s": "Příkaz selhal: %s %s", 16 | "Install for %s failed with code %s": "Instalace %s selhala s kódem %s", 17 | "%s not found. Trying with npx...": "%s nenalezen. Zkouším npx...", 18 | "command not found: %s": "příkaz nenalezen: %s", 19 | "options": "parametry", 20 | "command": "příkaz", 21 | "version": "verze", 22 | "command-arg": "argument", 23 | "command-string": "příkaz v řetězci", 24 | "shell": "shell", 25 | "package": "balíček", 26 | "npx: installed %s in %ss": "npx: nainstalováno %s za %ss", 27 | "Suppress output from npx itself. Subcommands will not be affected.": "Potlačit výstup z npx. Spuštěné příkazy nebudou ovlivněné." 28 | } 29 | -------------------------------------------------------------------------------- /locales/de.json: -------------------------------------------------------------------------------- 1 | { 2 | "Execute binaries from npm packages.\n%s": "Führt Programme aus, die von npm Paketen bereitgestellt werden.\n%s", 3 | "Package to be installed.": "Das zu installierende Paket.", 4 | "Location of the npm cache.": "Ort des npm Zwischenspeichers.", 5 | "Skip installation if a package is missing.": "Überspringe die Installation, falls ein Paket fehlt.", 6 | "Path to user npmrc.": "Pfad zu npmrc im Benutzerverzeichnis.", 7 | "Execute string as if inside `npm run-script`.": "Führe Zeichenkette aus, als wäre sie innerhalb von `npm run-script`.", 8 | "Shell to execute the command with, if any.": "Shell, mit der Programme ausgeführt werden soll, wenn überhaupt.", 9 | "Generate shell code to use npx as the \"command not found\" fallback.": "Erzeuge Shellcode, um npx als Alternative zu \"Programm konnte nicht gefunden werden\" zu benutzen.", 10 | "Ignores existing binaries in $PATH, or in the local project. This forces npx to do a temporary install and use the latest version.": "Ignoriere bestehende Programme innerhalb von $PATH oder im lokalen Projekt. Dies zwingt npx dazu, die neuste Version herunterzuladen und zu benutzen.", 11 | "npm binary to use for internal operations.": "npm-Programm für die interne Benutzung.", 12 | "For the full documentation, see the manual page for npx(1).": "In der Manpage npx(1) ist die gesamte Dokumentation einzusehen.", 13 | "Unable to guess a binary name from %s. Please use --package.": "Der Programmname von %s kann nicht automatisch ermittelt werden. Bitte benutze --package.", 14 | "\nERROR: You must supply a command.\n": "\nFEHLER: Du musst einen Befehl angeben.\n", 15 | "Command failed: %s %s": "Befehl fehlgeschlagen: %s %s", 16 | "Install for %s failed with code %s": "Die Installation von %s ist mit dem Code %s fehlgeschlagen", 17 | "%s not found. Trying with npx...": "%s konnte nicht gefunden werden. Versuche mit npx...", 18 | "command not found: %s": "Programm konnte nicht gefunden werden: %s", 19 | "options": "Optionen", 20 | "command": "Befehl", 21 | "version": "Version", 22 | "command-arg": "Befehlsargument", 23 | "command-string": "Befehlszeichenkette", 24 | "shell": "Shell", 25 | "package": "Paket", 26 | "npx: installed %s in %ss": "npx: Installierte %s in %ss", 27 | "Suppress output from npx itself. Subcommands will not be affected.": "Unterdrücke Output von npx. Unterbefehle sind nicht davon betroffen.", 28 | "Extra node argument when calling a node binary.": "Extra node Argument, wenn eine node ausführbare Binärdatei gerufen ist." 29 | } 30 | -------------------------------------------------------------------------------- /locales/en.json: -------------------------------------------------------------------------------- 1 | { 2 | "Execute binaries from npm packages.\n%s": "Execute binaries from npm packages.\n%s", 3 | "Package to be installed.": "Package to be installed.", 4 | "Location of the npm cache.": "Location of the npm cache.", 5 | "Skip installation if a package is missing.": "Skip installation if a package is missing.", 6 | "Path to user npmrc.": "Path to user npmrc.", 7 | "Execute string as if inside `npm run-script`.": "Execute string as if inside `npm run-script`.", 8 | "Shell to execute the command with, if any.": "Shell to execute the command with, if any.", 9 | "Generate shell code to use npx as the \"command not found\" fallback.": "Generate shell code to use npx as the \"command not found\" fallback.", 10 | "Ignores existing binaries in $PATH, or in the local project. This forces npx to do a temporary install and use the latest version.": "Ignores existing binaries in $PATH, or in the local project. This forces npx to do a temporary install and use the latest version.", 11 | "npm binary to use for internal operations.": "npm binary to use for internal operations.", 12 | "For the full documentation, see the manual page for npx(1).": "For the full documentation, see the manual page for npx(1).", 13 | "Unable to guess a binary name from %s. Please use --package.": "Unable to guess a binary name from %s. Please use --package.", 14 | "\nERROR: You must supply a command.\n": "\nERROR: You must supply a command.\n", 15 | "Command failed: %s %s": "Command failed: %s %s", 16 | "Install for %s failed with code %s": "Install for %s failed with code %s", 17 | "%s not found. Trying with npx...": "%s not found. Trying with npx...", 18 | "command not found: %s": "command not found: %s", 19 | "options": "options", 20 | "command": "command", 21 | "version": "version", 22 | "command-arg": "command-arg", 23 | "command-string": "command-string", 24 | "shell": "shell", 25 | "package": "package", 26 | "npx: installed %s in %ss": "npx: installed %s in %ss", 27 | "Suppress output from npx itself. Subcommands will not be affected.": "Suppress output from npx itself. Subcommands will not be affected.", 28 | "Extra node argument when calling a node binary.": "Extra node argument when calling a node binary.", 29 | "Always spawn a child process to execute the command.": "Always spawn a child process to execute the command." 30 | } -------------------------------------------------------------------------------- /locales/es.json: -------------------------------------------------------------------------------- 1 | { 2 | "Execute binaries from npm packages.\n%s": "Ejecuta comandos de paquetes de npm.\n%s", 3 | "Package to be installed.": "Paquete para instalar.", 4 | "Location of the npm cache.": "Ruta del cache de npm.", 5 | "Skip installation if a package is missing.": "Salta el paso de instalación si el paquete no está presente.", 6 | "Path to user npmrc.": "Ruta al npmrc del usuario.", 7 | "Execute string as if inside `npm run-script`.": "Ejecuta el argumento como si estuviera dentro de `npm run-script`.", 8 | "Shell to execute the command with, if any.": "Shell con el que se ejecutará el comando, si alguno.", 9 | "Generate shell code to use npx as the \"command not found\" fallback.": "Genera código de shell para usar npx como el repliegue cuando el comando no existe.", 10 | "Ignores existing binaries in $PATH, or in the local project. This forces npx to do a temporary install and use the latest version.": "Ignora comandos en $PATH, o en el proyecto local. Esto obliga a npx a hacer una instalación temporanea y usar la version más reciente del comando.", 11 | "npm binary to use for internal operations.": "Comando de npm que se usará para operaciones internas de npx.", 12 | "For the full documentation, see the manual page for npx(1).": "Para documentación completa, véase la pagina del manual npx(1).", 13 | "Unable to guess a binary name from %s. Please use --package.": "No se pudo adivinar el nombre del comando usando %s. Por favor usa --package.", 14 | "\nERROR: You must supply a command.\n": "\nERROR: Debes proveer un comando.\n", 15 | "Command failed: %s %s": "Comando fracasó: %s %s", 16 | "Install for %s failed with code %s": "La instalación de %s fracasó con código %s", 17 | "%s not found. Trying with npx...": "%s no existe. Tratando con npx...", 18 | "command not found: %s": "comando no existe: %s", 19 | "options": "opciones", 20 | "command": "comando", 21 | "version": "versión", 22 | "command-arg": "argumento-de-comando", 23 | "command-string": "texto-de-comando", 24 | "shell": "shell", 25 | "package": "paquete", 26 | "npx: installed %s in %ss": "npx: instaló %s en %ss", 27 | "Suppress output from npx itself. Subcommands will not be affected.": "Suprimir producción de npx. Sub-comandos no serán afectados." 28 | } 29 | -------------------------------------------------------------------------------- /locales/fr.json: -------------------------------------------------------------------------------- 1 | { 2 | "Execute binaries from npm packages.\n%s": "Exécutez des binaires à partir de paquets npm.\n%s", 3 | "Package to be installed.": "Paquet à installer.", 4 | "Location of the npm cache.": "Chemin où est situé le cache de npm.", 5 | "Skip installation if a package is missing.": "Passer l'installation si un paquet est manquant.", 6 | "Path to user npmrc.": "Chemin du fichier npmrc de l'utilisateur(-trice).", 7 | "Execute string as if inside `npm run-script`.": "Exécuter la chaine de caractère comme avec `npm run-script`.", 8 | "Shell to execute the command with, if any.": "Shell à utiliser pour exécuter la commande, s'il y en a un.", 9 | "Generate shell code to use npx as the \"command not found\" fallback.": "Générer le code du shell pour utiliser npx comme solution de rechange à \"command not found\".", 10 | "Ignores existing binaries in $PATH, or in the local project. This forces npx to do a temporary install and use the latest version.": "Ignorer les binaires dans le $PATH ou dans le projet local. Cela force npm à réaliser une installation temporaire et à utiliser la dernière version.", 11 | "npm binary to use for internal operations.": "Binaire de npm à utiliser pour les opérations internes.", 12 | "For the full documentation, see the manual page for npx(1).": "Pour la documentation complète, consultez la page du manuel pour npx(1).", 13 | "Unable to guess a binary name from %s. Please use --package.": "Impossible de deviner le nom du binaire de %s, utilisez --package s'il vous plaît.", 14 | "\nERROR: You must supply a command.\n": "\nERREUR : Vous devez fournir une commande.\n", 15 | "Command failed: %s %s": "La commande a échoué : %s %s", 16 | "Install for %s failed with code %s": "L'installation de %s a échoué avec le code %s", 17 | "%s not found. Trying with npx...": "%s n'a pas été trouvé. Essai avec npx...", 18 | "command not found: %s": "Commande non trouvée : %s", 19 | "options": "options", 20 | "command": "commande", 21 | "version": "version", 22 | "command-arg": "arguments-de-la-commande", 23 | "command-string": "chaîne-de-caractères-de-la-commande", 24 | "shell": "shell", 25 | "package": "paquet", 26 | "npx: installed %s in %ss": "npx : %s installé(s) en %ss", 27 | "Suppress output from npx itself. Subcommands will not be affected.": "Supprimer la sortie générée par npx. Les sous-commandes ne seront pas affectées." 28 | } 29 | -------------------------------------------------------------------------------- /locales/id.json: -------------------------------------------------------------------------------- 1 | { 2 | "Execute binaries from npm packages.\n%s": "Jalankan berkas-berkas binari darpi paket-paket npm.\n%s", 3 | "Package to be installed.": "Paket yang akan dipasang.", 4 | "Location of the npm cache.": "Lokasi dari cache npm.", 5 | "Skip installation if a package is missing.": "Lewati pemasangan jika paket tidak ditemukan.", 6 | "Path to user npmrc.": "Jalur ke npmrc milik pengguna.", 7 | "Execute string as if inside `npm run-script`.": "Jalankan string seperti ada di dalam `npm run-script`.", 8 | "Shell to execute the command with, if any.": "Shell untuk menjalankan sebuah perintah, jika ada.", 9 | "Generate shell code to use npx as the \"command not found\" fallback.": "Membangkitkan kode shell untuk menggunakan npx sebagai cadangan dari \"perintah tidak ditemukan\" .", 10 | "Ignores existing binaries in $PATH, or in the local project. This forces npx to do a temporary install and use the latest version.": "Jangan hiraukan berkas-berkas binari yang ada di $PATH, atau yang ada di proyek lokal. Ini memaksa npx untuk melakukan pemasangan sementara dan menggunakan versi yang terakhir.", 11 | "npm binary to use for internal operations.": "Binari npm yang digunakan untuk operasi internal.", 12 | "For the full documentation, see the manual page for npx(1).": "Untuk dokumentasi lengkap, mohon baca laman manual untuk npx(1).", 13 | "Unable to guess a binary name from %s. Please use --package.": "Tidak dapat menebak nama binari dari %s. Mohon gunakan --package.", 14 | "\nERROR: You must supply a command.\n": "\nGALAT: Anda harus menyediakan sebuah perintah.\n", 15 | "Command failed: %s %s": "Perintah tidak berhasil: %s %s", 16 | "Install for %s failed with code %s": "Pemasangan untuk %s tidak berhasil dengan kode %s", 17 | "%s not found. Trying with npx...": "%s tidak ditemukan. Mencoba dengan npx...", 18 | "command not found: %s": "Perintah tidak ditemukan: %s", 19 | "options": "opsi-opsi", 20 | "command": "perintah", 21 | "version": "versi", 22 | "command-arg": "arg-perintah", 23 | "command-string": "string-perintah", 24 | "shell": "shell", 25 | "package": "paket", 26 | "npx: installed %s in %ss": "npx: %s terpasang di %ss", 27 | "Suppress output from npx itself. Subcommands will not be affected.": "Hilangkan keluaran dari npx itu sendiri. Sub-sub perintah tidak akan terpengaruh.", 28 | "Extra node argument when calling a node binary.": "Argumen node ekstra ketika memanggil binari node." 29 | } -------------------------------------------------------------------------------- /locales/it.json: -------------------------------------------------------------------------------- 1 | { 2 | "Execute binaries from npm packages.\n%s": "Esegui il binario del pacchetto npm.\n%s", 3 | "Package to be installed.": "Pacchetto da installare.", 4 | "Location of the npm cache.": "Percorso della cache npm.", 5 | "Skip installation if a package is missing.": "Salta l'installazione se un pacchetto non è disponibile.", 6 | "Path to user npmrc.": "Percorso utente per npmrc.", 7 | "Execute string as if inside `npm run-script`.": "Esegui l'argomento come se fosse all'interno di `npm run-script`.", 8 | "Shell to execute the command with, if any.": "Shell con cui eseguire il comando, se presente.", 9 | "Generate shell code to use npx as the \"command not found\" fallback.": "Generare un codice di shell per usare npx come ripiego quando il comando non esiste.", 10 | "Ignores existing binaries in $PATH, or in the local project. This forces npx to do a temporary install and use the latest version.": "Ignora i binari esistenti in $PATH, oppure nel progetto locale. Questo forza temporaneamente npx a installare e usare l'ultima versione.", 11 | "npm binary to use for internal operations.": "Binario npm da usare per le operazioni interne.", 12 | "For the full documentation, see the manual page for npx(1).": "Per la documentazione completa, vedere la pagina del manuale npx(1).", 13 | "Unable to guess a binary name from %s. Please use --package.": "Impossibile supporre il nome del binario da %s. Prego usare --package.", 14 | "\nERROR: You must supply a command.\n": "\nERRORE: E necessario fornire un comando.\n", 15 | "Command failed: %s %s": "Comando fallito: %s %s", 16 | "Install for %s failed with code %s": "Installazione di %s fallita con codice %s", 17 | "%s not found. Trying with npx...": "%s non trovato. Prova con npx...", 18 | "command not found: %s": "comando non trovato: %s", 19 | "options": "opzioni", 20 | "command": "comando", 21 | "version": "versione", 22 | "command-arg": "argomento-del-comando", 23 | "command-string": "stringa-di-comando", 24 | "shell": "shell", 25 | "package": "pacchetto", 26 | "npx: installed %s in %ss": "npx: installato %s in %ss", 27 | "Suppress output from npx itself. Subcommands will not be affected.": "Sopprimere l'output da npx stesso. I sottocomandi non saranno interessati." 28 | } 29 | -------------------------------------------------------------------------------- /locales/ja.json: -------------------------------------------------------------------------------- 1 | { 2 | "Execute binaries from npm packages.\n%s": "npmパッケージのバイナリを実行します。", 3 | "Package to be installed.": "インストールするパッケージ。", 4 | "Location of the npm cache.": "npmのキャッシュへのパス。", 5 | "Skip installation if a package is missing.": "パッケージがない場合は、インストールをスキップします。", 6 | "Path to user npmrc.": "ユーザーのnpmrcへのパス。", 7 | "Execute string as if inside `npm run-script`.": "「npm run-script」の内部にあるかのように文字列を実行します。", 8 | "Shell to execute the command with, if any.": "コマンドを実行するシェル（存在する場合）。", 9 | "Generate shell code to use npx as the \"command not found\" fallback.": "\"コマンドが見つかりません\" フォールバックとして使用するコードを生成します。", 10 | "Ignores existing binaries in $PATH, or in the local project. This forces npx to do a temporary install and use the latest version.": "$PATH、または既存のローカルプロジェクトのバイナリを無視します。 これにより、npxは一時的にインストールを行い、最新バージョンを使用します。", 11 | "npm binary to use for internal operations.": "npmのバイナリを内部操作に使用します。", 12 | "For the full documentation, see the manual page for npx(1).": "詳しくは、npx(1)のマニュアルページを参照してください。", 13 | "Unable to guess a binary name from %s. Please use --package.": "%sからバイナリ名を推測できません。 --packageを使用してください。", 14 | "\nERROR: You must supply a command.\n": "\nエラー： コマンドを入力する必要があります。\n", 15 | "Command failed: %s %s": "コマンドが失敗しました： %s %s", 16 | "Install for %s failed with code %s": "コード%sで%sのインストールに失敗しました", 17 | "%s not found. Trying with npx...": "%sが見つかりません。 npxで試してみて...", 18 | "command not found: %s": "コマンドが見つかりません： %s", 19 | "options": "オプション", 20 | "command": "コマンド", 21 | "version": "バージョン", 22 | "command-arg": "コマンドの引数", 23 | "command-string": "コマンドの文字列", 24 | "shell": "シェル", 25 | "package": "パッケージ", 26 | "npx: installed %s in %ss": "npx: %s個のパッケージを%s秒でインストールしました。", 27 | "Suppress output from npx itself. Subcommands will not be affected.": "npx自体の標準出力を抑止します。 サブコマンドは影響を受けません。" 28 | } 29 | -------------------------------------------------------------------------------- /locales/ko.json: -------------------------------------------------------------------------------- 1 | { 2 | "Execute binaries from npm packages.\n%s": "npm 패키지에서 바이너리를 실행합니다.\n%s", 3 | "Package to be installed.": "설치할 패키지.", 4 | "Location of the npm cache.": "npm 캐시의 위치.", 5 | "Skip installation if a package is missing.": "패키지가 없으면 설치를 건너뜁니다.", 6 | "Path to user npmrc.": "사용자 npmrc의 경로.", 7 | "Execute string as if inside `npm run-script`.": "문자열이 `npm run-script`안에 있는 것처럼 실행합니다.", 8 | "Shell to execute the command with, if any.": "명령을 실행할 셸 (존재하는 경우).", 9 | "Generate shell code to use npx as the \"command not found\" fallback.": "\"명령을 찾을 수 없습니다\" 대신 npx가 사용되도록 셸 코드를 생성합니다.", 10 | "Ignores existing binaries in $PATH, or in the local project. This forces npx to do a temporary install and use the latest version.": "$PATH나 로컬 프로젝트에 있는 바이너리를 무시합니다. 이는 npx가 최신 버전을 임시로 설치해서 사용하도록 강제합니다.", 11 | "npm binary to use for internal operations.": "내부 작업에 사용할 npm 바이너리.", 12 | "For the full documentation, see the manual page for npx(1).": "전체 문서는 npx(1) 매뉴얼 페이지를 보세요.", 13 | "Unable to guess a binary name from %s. Please use --package.": "%s에서 바이너리 이름을 추측할 수 없습니다. --package를 사용해 주세요.", 14 | "\nERROR: You must supply a command.\n": "\nERROR: 명령을 제공해야 합니다.\n", 15 | "Command failed: %s %s": "명령이 실패했습니다: %s %s", 16 | "Install for %s failed with code %s": "%s 설치가 오류 코드 %s로 실패했습니다", 17 | "%s not found. Trying with npx...": "%s 을 찾을 수 없습니다. npx로 시도합니다...", 18 | "command not found: %s": "명령을 찾을 수 없습니다: %s", 19 | "options": "옵션", 20 | "command": "명령", 21 | "version": "버전", 22 | "command-arg": "명령-인자", 23 | "command-string": "명령-문자열", 24 | "shell": "셸", 25 | "package": "패키지", 26 | "npx: installed %s in %ss": "npx: %s개의 패키지를 %s초만에 설치했습니다.", 27 | "Suppress output from npx itself. Subcommands will not be affected.": "npx의 출력을 감춥니다. 하위 명령은 영향을 받지 않습니다.", 28 | "Extra node argument when calling a node binary.": "node 바이너리를 호출할 때 사용하는 추가 node 인자." 29 | } 30 | -------------------------------------------------------------------------------- /locales/nb.json: -------------------------------------------------------------------------------- 1 | { 2 | "Execute binaries from npm packages.\n%s": "Kjør binærfiler fra npm-pakker.\n%s", 3 | "Package to be installed.": "Pakken som skal installeres.", 4 | "Location of the npm cache.": "Hvor npm-cachen er.", 5 | "Skip installation if a package is missing.": "La være å installere dersom pakken mangler.", 6 | "Path to user npmrc.": "Sti til brukerens npmrc.", 7 | "Execute string as if inside `npm run-script`.": "Kjør streng som om den var inni `npm run-script`.", 8 | "Shell to execute the command with, if any.": "Skall å kjøre kommandoen med, hvis noe.", 9 | "Generate shell code to use npx as the \"command not found\" fallback.": "Generer skallkode for å bruke npx som \"kommandoen finnes ikke\" fallback.", 10 | "Ignores existing binaries in $PATH, or in the local project. This forces npx to do a temporary install and use the latest version.": "Ignorerer eksisterende binærfiler i $PATH eller i det lokale prosjektet. Dette tvinger npx til å installere siste versjon av pakken midlertidig.", 11 | "npm binary to use for internal operations.": "npm-binærfil som skal brukes for interne operasjoner.", 12 | "For the full documentation, see the manual page for npx(1).": "For hele dokumentasjonen, se brukermanualen for npx(1).", 13 | "Unable to guess a binary name from %s. Please use --package.": "Klarer ikke å gjette en binærfils navn ut fra %s. Vennligst bruk --package.", 14 | "\nERROR: You must supply a command.\n": "\nFEIL: Du må legge ved en kommando.\n", 15 | "Command failed: %s %s": "Kommando feilet: %s %s", 16 | "Install for %s failed with code %s": "Installasjon for %s feilet med kode %s", 17 | "%s not found. Trying with npx...": "Kunne ikke finne%s. Prøver med npx...", 18 | "command not found: %s": "kommando ikke funnet: %s", 19 | "options": "innstillinger", 20 | "command": "kommando", 21 | "version": "versjon", 22 | "command-arg": "kommando-argument", 23 | "command-string": "kommando-streng", 24 | "shell": "skall", 25 | "package": "pakke", 26 | "npx: installed %s in %ss": "npx: installerte %s på %ss", 27 | "Suppress output from npx itself. Subcommands will not be affected.": "Skjul kommandoer fra npx. Sub-kommandoer vil ikke berøres.", 28 | "Extra node argument when calling a node binary.": "Ekstra node-argument når en node-binærfil blir kalt." 29 | } 30 | -------------------------------------------------------------------------------- /locales/nl.json: -------------------------------------------------------------------------------- 1 | { 2 | "Execute binaries from npm packages.\n%s": "Voer een programma van een npm package uit.\n%s", 3 | "Package to be installed.": "De te installeren package.", 4 | "Location of the npm cache.": "Plaats van de npm cache.", 5 | "Skip installation if a package is missing.": "Sla installatie over als een package nog niet geïnstalleerd is.", 6 | "Path to user npmrc.": "Pad naar je npmrc.", 7 | "Execute string as if inside `npm run-script`.": "Voer de tekst uit, alsof het `npm run-script` was.", 8 | "Shell to execute the command with, if any.": "De shell te gebruiken met dit commando, indien nodig.", 9 | "Generate shell code to use npx as the \"command not found\" fallback.": "Genereer shell-code als vervanging bij \"command not found\".", 10 | "Ignores existing binaries in $PATH, or in the local project. This forces npx to do a temporary install and use the latest version.": "Negeer bestaande programmas in $PATH, of in het lokale prject. Dit forceert npx om een tijdelijke installatie te doen en de laatste versie te gebruiken.", 11 | "npm binary to use for internal operations.": "npm programma te gebuiken voor interne operaties.", 12 | "For the full documentation, see the manual page for npx(1).": "Voor de volledige documentatie, raadpleeg de man pagina van npx(1).", 13 | "Unable to guess a binary name from %s. Please use --package.": "Vond geen programmanaam voor %S. Probeer opnieuw met --package.", 14 | "\nERROR: You must supply a command.\n": "\nFOUT: Je moet een commando ingeven.\n", 15 | "Command failed: %s %s": "Commando mislukt: %s %s", 16 | "Install for %s failed with code %s": "De installatie van %s is mislukt met code %s", 17 | "%s not found. Trying with npx...": "%s werd niet gevonden. Probeert nu met npx…", 18 | "command not found: %s": "programma werd niet gevonden in %s", 19 | "options": "opties", 20 | "command": "commando", 21 | "version": "versie", 22 | "command-arg": "commandoargumenten", 23 | "command-string": "commandotekst", 24 | "shell": "shell", 25 | "package": "package", 26 | "npx: installed %s in %ss": "npx: heeft %s in %ss geïnstalleerd", 27 | "Suppress output from npx itself. Subcommands will not be affected.": "Geef geen uitvoer voor npx zelf. Heeft geen invoed op subcommando's", 28 | "Extra node argument when calling a node binary.": "Extra argumenten voor node, wanner een node-programma gebruikt wordt" 29 | } 30 | -------------------------------------------------------------------------------- /locales/nn.json: -------------------------------------------------------------------------------- 1 | { 2 | "Execute binaries from npm packages.\n%s": "Køyr binærfiler frå npm-pakkar.\n%s", 3 | "Package to be installed.": "Pakken som skal bli installert.", 4 | "Location of the npm cache.": "Kvar npm-mellomlagringa ligg.", 5 | "Skip installation if a package is missing.": "La være å installere viss pakken manglar.", 6 | "Path to user npmrc.": "Sti til brukaren sin npmrc-fil.", 7 | "Execute string as if inside `npm run-script`.": "Køyr streng som om den var inni `npm run-script`.", 8 | "Shell to execute the command with, if any.": "Skall å køyre kommandoen med, viss noe.", 9 | "Generate shell code to use npx as the \"command not found\" fallback.": "Generer skallkode for å bruke npx som \"kommandoen finst ikkje\" fallback.", 10 | "Ignores existing binaries in $PATH, or in the local project. This forces npx to do a temporary install and use the latest version.": "Ignorerer eksisterende binærfilar i $PATH eller i det lokale prosjektet. Dette tvingar npx til å installere siste versjon av pakken midlertidig.", 11 | "npm binary to use for internal operations.": "npm-binærfil som skal brukes for interne operasjonar.", 12 | "For the full documentation, see the manual page for npx(1).": "For heile dokumentasjonen, sjå brukarmanualen for npx(1).", 13 | "Unable to guess a binary name from %s. Please use --package.": "Klarar ikkje å gjette ein binærfil sitt namn ut frå %s. Vennligst bruk --package.", 14 | "\nERROR: You must supply a command.\n": "\nFEIL: Du må legge ved ein kommando.\n", 15 | "Command failed: %s %s": "Kommando feilte: %s %s", 16 | "Install for %s failed with code %s": "Installasjon for %s feilte med kode %s", 17 | "%s not found. Trying with npx...": "Kunne ikkje finne%s. Prøver med npx...", 18 | "command not found: %s": "kommando ikkje funnet: %s", 19 | "options": "innstillinger", 20 | "command": "kommando", 21 | "version": "versjon", 22 | "command-arg": "kommando-argument", 23 | "command-string": "kommando-streng", 24 | "shell": "skall", 25 | "package": "pakke", 26 | "npx: installed %s in %ss": "npx: installerte %s på %ss", 27 | "Suppress output from npx itself. Subcommands will not be affected.": "Skjul kommandoer frå npx. Sub-kommandoer vil ikkje rørast.", 28 | "Extra node argument when calling a node binary.": "Ekstra node-argument når ein node-binærfil blir kalt." 29 | } 30 | -------------------------------------------------------------------------------- /locales/no.json: -------------------------------------------------------------------------------- 1 | { 2 | "Execute binaries from npm packages.\n%s": "Kjør binærfiler fra npm-pakker.\n%s", 3 | "Package to be installed.": "Pakken som skal installeres.", 4 | "Location of the npm cache.": "Hvor npm-cachen er.", 5 | "Skip installation if a package is missing.": "La være å installere dersom pakken mangler.", 6 | "Path to user npmrc.": "Sti til brukerens npmrc.", 7 | "Execute string as if inside `npm run-script`.": "Kjør streng som om den var inni `npm run-script`.", 8 | "Shell to execute the command with, if any.": "Skall å kjøre kommandoen med, hvis noe.", 9 | "Generate shell code to use npx as the \"command not found\" fallback.": "Generer skallkode for å bruke npx som \"kommandoen finnes ikke\" fallback.", 10 | "Ignores existing binaries in $PATH, or in the local project. This forces npx to do a temporary install and use the latest version.": "Ignorerer eksisterende binærfiler i $PATH eller i det lokale prosjektet. Dette tvinger npx til å installere siste versjon av pakken midlertidig.", 11 | "npm binary to use for internal operations.": "npm-binærfil som skal brukes for interne operasjoner.", 12 | "For the full documentation, see the manual page for npx(1).": "For hele dokumentasjonen, se brukermanualen for npx(1).", 13 | "Unable to guess a binary name from %s. Please use --package.": "Klarer ikke å gjette en binærfils navn ut fra %s. Vennligst bruk --package.", 14 | "\nERROR: You must supply a command.\n": "\nFEIL: Du må legge ved en kommando.\n", 15 | "Command failed: %s %s": "Kommando feilet: %s %s", 16 | "Install for %s failed with code %s": "Installasjon for %s feilet med kode %s", 17 | "%s not found. Trying with npx...": "Kunne ikke finne%s. Prøver med npx...", 18 | "command not found: %s": "kommando ikke funnet: %s", 19 | "options": "innstillinger", 20 | "command": "kommando", 21 | "version": "versjon", 22 | "command-arg": "kommando-argument", 23 | "command-string": "kommando-streng", 24 | "shell": "skall", 25 | "package": "pakke", 26 | "npx: installed %s in %ss": "npx: installerte %s på %ss", 27 | "Suppress output from npx itself. Subcommands will not be affected.": "Skjul kommandoer fra npx. Sub-kommandoer vil ikke berøres.", 28 | "Extra node argument when calling a node binary.": "Ekstra node-argument når en node-binærfil blir kalt." 29 | } 30 | -------------------------------------------------------------------------------- /locales/pl.json: -------------------------------------------------------------------------------- 1 | { 2 | "Execute binaries from npm packages.\n%s": "Uruchamia pliki wykonywalne (binarki) z paczek npm.\n%s", 3 | "Package to be installed.": "Paczka do zainstalowania.", 4 | "Location of the npm cache.": "Lokalizacja cache npm.", 5 | "Skip installation if a package is missing.": "Pomiń instalacje w przypadku braku paczki.", 6 | "Path to user npmrc.": "Ścieżka do pliku npmrc.", 7 | "Execute string as if inside `npm run-script`.": "Wykonaj polecenie jak gdyby znajdowało się w `npm run-script`.", 8 | "Shell to execute the command with, if any.": "Shell do wykonania polecenia, jeśli potrzeba.", 9 | "Generate shell code to use npx as the \"command not found\" fallback.": "Wynegeruj kod dla shell-a aby używać npx zamiast \"nie znaleziono polecenia\".", 10 | "Ignores existing binaries in $PATH, or in the local project. This forces npx to do a temporary install and use the latest version.": "Ignoruje istniejące paczki w $PATH lub lokalnym projekcie. Wymusza na npx tymczasową instalację i użycie najnowszej wersji.", 11 | "npm binary to use for internal operations.": "Ścieżka do binarki npm używanej przez npx.", 12 | "For the full documentation, see the manual page for npx(1).": "Dla pełnej dokumentacji zobacz manual dla npx(1).", 13 | "Unable to guess a binary name from %s. Please use --package.": "Nie udało się ustalić binarki dla %s. Proszę użyć --package.", 14 | "\nERROR: You must supply a command.\n": "\nERROR: Musisz podać polecenie.\n", 15 | "Command failed: %s %s": "Polecenie się nie powiodło: %s %s", 16 | "Install for %s failed with code %s": "Instalacja %s nie udała się, kod błędu: %s", 17 | "%s not found. Trying with npx...": "%s: nie znaleziono polecenia. Próba uruchomienia przy użyciu npx...", 18 | "command not found: %s": "nie znaleziono polecenia: %s", 19 | "options": "opcje", 20 | "command": "polecenie", 21 | "version": "wersja", 22 | "command-arg": "argument polecenia", 23 | "command-string": "tekst polecenia", 24 | "shell": "shell", 25 | "package": "paczka", 26 | "npx: installed %s in %ss": "npx: zainstalowano %s w %ss", 27 | "Suppress output from npx itself. Subcommands will not be affected.": "Wycisza wyjście z npx. Nie dotyczy podprocesów.", 28 | "Extra node argument when calling a node binary.": "Dodatkowe argumenty przekazywane do node." 29 | } -------------------------------------------------------------------------------- /locales/pt_BR.json: -------------------------------------------------------------------------------- 1 | { 2 | "Execute binaries from npm packages.\n%s": "Executa comandos de módulos npm.\n%s", 3 | "Package to be installed.": "Pacote para ser instalado.", 4 | "Location of the npm cache.": "Localização da cache npm.", 5 | "Skip installation if a package is missing.": "Pular instalação se um pacote está faltando.", 6 | "Path to user npmrc.": "Localização do npmrc do usuário.", 7 | "Execute string as if inside `npm run-script`.": "Executa string como se estivesse dentro de `npm run-script`.", 8 | "Shell to execute the command with, if any.": "Terminal para executar o comando, se tiver.", 9 | "Generate shell code to use npx as the \"command not found\" fallback.": "Gera código de terminal para usar npx no lugar quando comando não existir (\"command not found\").", 10 | "Ignores existing binaries in $PATH, or in the local project. This forces npx to do a temporary install and use the latest version.": "Ignora comandos no $PATH ou no projeto atual. Isto obriga npx a fazer uma instalação temporária e usar a última versão.", 11 | "npm binary to use for internal operations.": "Comando npm usado para operações internas.", 12 | "For the full documentation, see the manual page for npx(1).": "Para documentação completa, veja a página do manual npx(1).", 13 | "Unable to guess a binary name from %s. Please use --package.": "Não foi possível advinhar o nome do comando usando %s. Por favor, use --package.", 14 | "\nERROR: You must supply a command.\n": "\nERRO: Você deve suprir um comando.\n", 15 | "Command failed: %s %s": "Comando fracassou: %s %s", 16 | "Install for %s failed with code %s": "Instalação de %s falhou com código %s", 17 | "%s not found. Trying with npx...": "%s não existe. Tentando com npx...", 18 | "command not found: %s": "comando não existe: %s", 19 | "options": "opções", 20 | "command": "comando", 21 | "version": "versão", 22 | "command-arg": "argumento-de-comando", 23 | "command-string": "string-de-comando", 24 | "shell": "terminal", 25 | "package": "pacote", 26 | "npx: installed %s in %ss": "npx: instalou %s em %ss", 27 | "Suppress output from npx itself. Subcommands will not be affected.": "Omitir resultado de npx. Sub-comandos não serão afetados." 28 | } 29 | -------------------------------------------------------------------------------- /locales/ro.json: -------------------------------------------------------------------------------- 1 | { 2 | "Execute binaries from npm packages.\n%s": "Rulează executabilele binare din pachetele npm.\n%s", 3 | "Package to be installed.": "Pachetul care va fi instalat.", 4 | "Location of the npm cache.": "Locația cache-ului npm.", 5 | "Skip installation if a package is missing.": "Sari peste instalare dacă lipsește un pachet.", 6 | "Path to user npmrc.": "Calea către fișierul npmrc al utilizatorului.", 7 | "Execute string as if inside `npm run-script`.": "Execută string-ul ca și cum ar fi în `npm run-script`.", 8 | "Shell to execute the command with, if any.": "Shell-ul cu care să fie executată comandă, dacă există.", 9 | "Generate shell code to use npx as the \"command not found\" fallback.": "Generează cod shell pentru a folosi npx drept fallback pentru \"comanda nu a fost găsită\".", 10 | "Ignores existing binaries in $PATH, or in the local project. This forces npx to do a temporary install and use the latest version.": "Ignoră executabilele binare existente din $PATH, sau din proiectul local. Aceasta forțează npx să facă o instalare temporară și să folosească ultima versiune.", 11 | "npm binary to use for internal operations.": "Executabilul binar npm care să fie folosit pentru operaţiunile interne.", 12 | "For the full documentation, see the manual page for npx(1).": "Pentru documentația completă, vedeți pagina de manual pentru npx(1).", 13 | "Unable to guess a binary name from %s. Please use --package.": "Imposibil de ghicit numele executabilului binar pentru %s. Vă rugăm folosiți --package.", 14 | "\nERROR: You must supply a command.\n": "\nEROARE: Trebuie să specifici o comandă.\n", 15 | "Command failed: %s %s": "Comanda a eșuat: %s %s", 16 | "Install for %s failed with code %s": "Procesul de instalare pentru %s a eșuat cu codul %s", 17 | "%s not found. Trying with npx...": "%s nu a fost găsită. Încercare cu npx...", 18 | "command not found: %s": "comanda nu a fost găsită: %s", 19 | "options": "opțiuni", 20 | "command": "comandă", 21 | "version": "versiune", 22 | "command-arg": "comandă-argument", 23 | "command-string": "comandă-string", 24 | "shell": "shell", 25 | "package": "pachet", 26 | "npx: installed %s in %ss": "npx: instalat %s în %ss", 27 | "Suppress output from npx itself. Subcommands will not be affected.": "Suprimă outputul de la npx însăși. Subcomenzile nu vor fi afectate." 28 | } 29 | -------------------------------------------------------------------------------- /locales/ru.json: -------------------------------------------------------------------------------- 1 | { 2 | "Execute binaries from npm packages.\n%s": "Выполняйте скрипты из npm пакетов.\n%s", 3 | "Package to be installed.": "Пакет, который будет установлен.", 4 | "Location of the npm cache.": "Расположение npm кеша.", 5 | "Skip installation if a package is missing.": "Пропустить установку, если пакет отсутствует.", 6 | "Path to user npmrc.": "Передать пользователя в npmrc.", 7 | "Execute string as if inside `npm run-script`.": "Выполнить скрипт как внутри `npm run-script`.", 8 | "Shell to execute the command with, if any.": "Shell, чтобы выполнить команду, если необходимо.", 9 | "Generate shell code to use npx as the \"command not found\" fallback.": "Создает код для shell, чтобы использовать npx при \"command not found\".", 10 | "Ignores existing binaries in $PATH, or in the local project. This forces npx to do a temporary install and use the latest version.": "Игнорирует все существующие скрипты в $PATH или локальном проекте. Что заставляет npx использовать временную установку и использовать последние версии.", 11 | "npm binary to use for internal operations.": "npm файл для использования во внутренних операциях.", 12 | "For the full documentation, see the manual page for npx(1).": "Полная документация доступна в мануале npx(1).", 13 | "Unable to guess a binary name from %s. Please use --package.": "Невозможно угадать команду из %s. Пожалуйста, используйте --package.", 14 | "\nERROR: You must supply a command.\n": "\nERROR: Нужно указать команду.\n", 15 | "Command failed: %s %s": "Ошибка: %s %s", 16 | "Install for %s failed with code %s": "Установка %s завершилась с кодом ошибки %s", 17 | "%s not found. Trying with npx...": "%s не найдено. Пробуем с npx...", 18 | "command not found: %s": "команда не найдена: %s", 19 | "options": "опции", 20 | "command": "команда", 21 | "version": "версия", 22 | "command-arg": "аргумент", 23 | "command-string": "команда-строка", 24 | "shell": "shell", 25 | "package": "пакет", 26 | "npx: installed %s in %ss": "npx: установлен %s в %ss", 27 | "Suppress output from npx itself. Subcommands will not be affected.": "Отключить вывод npx. Поведение подкоманд не будет изменено." 28 | } 29 | -------------------------------------------------------------------------------- /locales/sr.json: -------------------------------------------------------------------------------- 1 | { 2 | "Execute binaries from npm packages.\n%s": "Izvršavam binarne pakete iz npm packages.\n%s", 3 | "Package to be installed.": "Paket će biti instaliran.", 4 | "Location of the npm cache.": "Lokacija npm keša.", 5 | "Skip installation if a package is missing.": "Preskoci instalaciju ako paket nedostaje.", 6 | "Path to user npmrc.": "Putanja do korisnikovog npmrc.", 7 | "Execute string as if inside `npm run-script`.": "Izvrši string kao da se nalazi unutar `npm run-script`.", 8 | "Shell to execute the command with, if any.": "Skripta izvršava komandu sa, ako postoji.", 9 | "Generate shell code to use npx as the \"command not found\" fallback.": "Napravi kod u Terminalu koji će koristiti npx kao zamenu za \"komanda nije pronađena\".", 10 | "Ignores existing binaries in $PATH, or in the local project. This forces npx to do a temporary install and use the latest version.": "Ignoriše postojeće binarne pakete u $PATH, ili u lokalnom projektu. Ovo će naterati npx da izvrši privremenu instalaciju i koristi najnoviju verziju.", 11 | "npm binary to use for internal operations.": "npm binarni paket za upotrebu u lokalnim operacijama.", 12 | "For the full documentation, see the manual page for npx(1).": "Za kompletnu dokumentaciju, pogledajte stranicu sa uputstvima za npx(1).", 13 | "Unable to guess a binary name from %s. Please use --package.": "Ne možemo da pogodimo ime binarnog paketa iz %s. Molimo koristite --package.", 14 | "\nERROR: You must supply a command.\n": "\nERROR: Morate uneti komandu.\n", 15 | "Command failed: %s %s": "Komanda nije uspela: %s %s", 16 | "Install for %s failed with code %s": "Instalacija za %s nije uspela sa kodom %s", 17 | "%s not found. Trying with npx...": "%s nije pronadjen. Pokušavam sa npx...", 18 | "command not found: %s": "komanda nije pronadjena: %s", 19 | "options": "opcije", 20 | "command": "komanda", 21 | "version": "verzija", 22 | "command-arg": "command-arg", 23 | "command-string": "command-string", 24 | "shell": "shell", 25 | "package": "paket", 26 | "npx: installed %s in %ss": "npx: instaliran %s u %ss", 27 | "Suppress output from npx itself. Subcommands will not be affected.": "Zabranjen izlaz iz samog npx. Na podkomande neće biti uticaja..", 28 | "Extra node argument when calling a node binary.": "Dodatni node argument kada pozivate node binarni." 29 | } -------------------------------------------------------------------------------- /locales/tr.json: -------------------------------------------------------------------------------- 1 | { 2 | "Execute binaries from npm packages.\n%s": "npm paketlerinden program çalıştırın.\n%s", 3 | "Package to be installed.": "Yüklenecek paketin adı.", 4 | "Location of the npm cache.":"npm önbelleğinin yeri.", 5 | "Skip installation if a package is missing.": "Eğer eksik paket varsa yükleme adımını atla.", 6 | "Path to user npmrc.": "Kullanıcının npmrc dosyasının yeri.", 7 | "Execute string as if inside `npm run-script`.": "Komutu 'npm run-script' kapsamında çalıştır.", 8 | "Shell to execute the command with, if any.": "Komutların çalıştırılacağı shell.", 9 | "Generate shell code to use npx as the \"command not found\" fallback.": "Komut eğer 'command not found' hatası veriyorsa, komutu npx üzerinden bir daha dene.", 10 | "Ignores existing binaries in $PATH, or in the local project. This forces npx to do a temporary install and use the latest version.": "$PATH ve lokal projede tanımlanmış programları pas geçer. Bu sayede, npx yeni bir yükleme yapar ve en son versiyonu kullanır.", 11 | "npm binary to use for internal operations.": "Bu programın çalıştırılmasında kullanılacak npm.", 12 | "For the full documentation, see the manual page for npx(1).": "Tamamını okumak için 'man npx'.", 13 | "Unable to guess a binary name from %s. Please use --package.": "%s için hangi npm paketi bilemedim. Lütfen --package kullanın.", 14 | "\nERROR: You must supply a command.\n": "\nHATA: Argüman vermelisiniz.\n", 15 | "Command failed: %s %s": "Komut çalıştırılamadı: %s %s", 16 | "Install for %s failed with code %s": "%s yüklenirken %s kodlu bir hata oluştu. Yükleme sonlandırıldı.", 17 | "%s not found. Trying with npx...": "%s bulunamadı. npx ile deniyorum...", 18 | "command not found": "komut bulunamadı", 19 | "options": "seçenekler", 20 | "command": "komut", 21 | "version": "versiyon", 22 | "command-arg": "argümanlar", 23 | "command-string": "argümanlar", 24 | "shell": "shell", 25 | "package": "paket", 26 | "npx": "npx", 27 | "Suppress output from npx itself. Subcommands will not be affected.": "npx çıktısını durdur. Alt komutlar etkilenmez." 28 | } 29 | -------------------------------------------------------------------------------- /locales/uk.json: -------------------------------------------------------------------------------- 1 | { 2 | "Execute binaries from npm packages.\n%s": "Виконуйте скрипти з npm пакетів.\n%s", 3 | "Package to be installed.": "Пакет, який буде встановлено.", 4 | "Location of the npm cache.": "Розташування npm кешу.", 5 | "Skip installation if a package is missing.": "Пропустити встановлення, якщо пакет відсутній.", 6 | "Path to user npmrc.": "Шлях до npmrc файлу користувача.", 7 | "Execute string as if inside `npm run-script`.": "Виконати рядок наче в `npm run-script`.", 8 | "Shell to execute the command with, if any.": "Shell для виконання команди, якщо є.", 9 | "Generate shell code to use npx as the \"command not found\" fallback.": "Генерує shell скрипт для використання npx як фолбеку для \"command not found\".", 10 | "Ignores existing binaries in $PATH, or in the local project. This forces npx to do a temporary install and use the latest version.": "Ігнорує існуючі бінарники в $PATH, чи в локальному проекті. Це змусить npx виконати тимчасове встановлення з використанням останньої версії.", 11 | "npm binary to use for internal operations.": "npm файл для використання у внутрішніх операціях.", 12 | "For the full documentation, see the manual page for npx(1).": "Повну документацію дивіться в мануалі npx(1).", 13 | "Unable to guess a binary name from %s. Please use --package.": "Неможливо визначити ім'я бінарника з %s. Будь ласка, використовуйте --package.", 14 | "\nERROR: You must supply a command.\n": "\nПОМИЛКА: Ви повинні вказати команду.\n", 15 | "Command failed: %s %s": "Невдала команда: %s %s", 16 | "Install for %s failed with code %s": "Невдале встановлення %s з кодом помилки %s", 17 | "%s not found. Trying with npx...": "%s не знайдено. Спробуємо з npx...", 18 | "command not found: %s": "команда не знайдена: %s", 19 | "options": "опції", 20 | "command": "команда", 21 | "version": "версія", 22 | "command-arg": "команда-аргумент", 23 | "command-string": "команда-рядок", 24 | "shell": "shell", 25 | "package": "пакет", 26 | "npx: installed %s in %ss": "npx: встановлено %s за %sс", 27 | "Suppress output from npx itself. Subcommands will not be affected.": "Вимкнути вивід npx. Поведінка підкоманд не буде змінена.", 28 | "Extra node argument when calling a node binary.": "Додатковий node аргумент під час виклику node бібліотеки." 29 | } 30 | -------------------------------------------------------------------------------- /locales/zh_CN.json: -------------------------------------------------------------------------------- 1 | { 2 | "Execute binaries from npm packages.\n%s": "从 npm 的可执行包执行命令\n%s", 3 | "Package to be installed.": "包安装的路径", 4 | "Location of the npm cache.": "npm 缓存路径", 5 | "Skip installation if a package is missing.": "如果有包缺失，跳过安装", 6 | "Path to user npmrc.": "当前用户的 npmrc 路径", 7 | "Execute string as if inside `npm run-script`.": "像执行 `npm run-script` 一样执行一个字符串", 8 | "Shell to execute the command with, if any.": "执行命令用到的解释器，可选", 9 | "Generate shell code to use npx as the \"command not found\" fallback.": "产生“找不到命令”的错误码", 10 | "Ignores existing binaries in $PATH, or in the local project. This forces npx to do a temporary install and use the latest version.": "忽略 $PATH 或工程里已有的可执行文件，这会强制使 npx 临时安装一次，并且使用其最新的版本", 11 | "npm binary to use for internal operations.": "为了执行内部操作的 npm 可执行文件", 12 | "For the full documentation, see the manual page for npx(1).": "可以通过 npx(1) 的手册找到完整说明文档", 13 | "Unable to guess a binary name from %s. Please use --package.": "无法推测出可执行文件名的来源 %s，请使用 --package", 14 | "\nERROR: You must supply a command.\n": "\n错误：您必须提供一个命令\n", 15 | "Command failed: %s %s": "执行失败：%s %s", 16 | "Install for %s failed with code %s": "安装 %s 失败，错误代码：%s", 17 | "%s not found. Trying with npx...": "找不到 %s，请尝试使用 npx...", 18 | "command not found: %s": "找不到命令：%s", 19 | "options": "选项", 20 | "command": "命令", 21 | "version": "版本", 22 | "command-arg": "命令的参数", 23 | "command-string": "命令的字符串", 24 | "shell": "命令行解释器", 25 | "package": "包", 26 | "npx: installed %s in %ss": "npx: %s 安装成功，用时 %s 秒", 27 | "Suppress output from npx itself. Subcommands will not be affected.": "隐藏 npx 的输出，子命令不会受到影响", 28 | "Extra node argument when calling a node binary.": "调用 node 二进制时使用额外的 node 参数。" 29 | } 30 | -------------------------------------------------------------------------------- /locales/zh_TW.json: -------------------------------------------------------------------------------- 1 | { 2 | "Execute binaries from npm packages.\n%s": "從 npm 套件的執行檔執行指令\n%s", 3 | "Package to be installed.": "套件安装的路徑", 4 | "Location of the npm cache.": "npm 快取路徑", 5 | "Skip installation if a package is missing.": "當套件遺失時，略過安裝", 6 | "Path to user npmrc.": "目前使用者的 npmrc 路徑", 7 | "Execute string as if inside `npm run-script`.": "以 `npm run-script` 的方式執行一個字串", 8 | "Shell to execute the command with, if any.": "執行指令所使用的殼層(Shell)，選用", 9 | "Generate shell code to use npx as the \"command not found\" fallback.": "當 npx 找不到指令時，產生殼層(Shell)指令，並執行之", 10 | "Ignores existing binaries in $PATH, or in the local project. This forces npx to do a temporary install and use the latest version.": "將會讓 npx 忽略 $PATH 環境變數或專案內已有的執行檔，並暫時安裝及使用最新版本的執行檔", 11 | "npm binary to use for internal operations.": "指定 npx 內部執行使用的 npm 執行檔", 12 | "For the full documentation, see the manual page for npx(1).": "參考 npx(1) 的文件以取得完整的說明", 13 | "Unable to guess a binary name from %s. Please use --package.": "無法從 %s 推測執行檔名稱，請使用 --package 參數", 14 | "\nERROR: You must supply a command.\n": "\n錯誤：您必須輸入一個指令\n", 15 | "Command failed: %s %s": "指令執行失敗：%s %s", 16 | "Install for %s failed with code %s": "安裝 %s 失敗，錯誤代碼：%s", 17 | "%s not found. Trying with npx...": "找不到 %s，請嘗試使用 npx...", 18 | "command not found: %s": "找不到指令：%s", 19 | "options": "選項", 20 | "command": "指令", 21 | "version": "版本", 22 | "command-arg": "指令的參數", 23 | "command-string": "指令字串", 24 | "shell": "殼層(Shell)", 25 | "package": "套件", 26 | "npx: installed %s in %ss": "npx: %s 安裝成功，花費 %s 秒", 27 | "Suppress output from npx itself. Subcommands will not be affected.": "隱藏 npx 的輸出，不影響子指令", 28 | "Extra node argument when calling a node binary.": "當呼叫 node 執行檔時，提供的額外參數" 29 | } 30 | -------------------------------------------------------------------------------- /package.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "libnpx", 3 | "version": "10.2.4", 4 | "description": "support library for npx -- an tool for executing npm-based packages.", 5 | "main": "index.js", 6 | "man": "./libnpx.1", 7 | "files": [ 8 | "*.js", 9 | "libnpx.1", 10 | "locales" 11 | ], 12 | "scripts": { 13 | "bin": "make bin", 14 | "publish-bin": "npm run bin && cd bin && npm publish", 15 | "docs": "tail -n +2 README.md | marked-man --manual 'User Commands' --version \"$npm_package_name@$npm_package_version\" > $npm_package_name.1", 16 | "prerelease": "npm t && npm run docs", 17 | "postrelease": "npm publish && git push --follow-tags", 18 | "pretest": "standard *.js test bin/*.js locales", 19 | "release": "standard-version -s", 20 | "test": "cross-env NPX_UPDATE_LOCALE_FILES=true LC_ALL=en nyc --all -- tap -J test/*.js" 21 | }, 22 | "repository": "https://github.com/npm/npx", 23 | "keywords": [ 24 | "npm", 25 | "npm exec", 26 | "shell", 27 | "scripts", 28 | "npm bin", 29 | "cli" 30 | ], 31 | "author": { 32 | "name": "Kat Marchán", 33 | "email": "kzm@sykosomatic.org", 34 | "twitter": "maybekatz" 35 | }, 36 | "license": "ISC", 37 | "dependencies": { 38 | "dotenv": "^5.0.1", 39 | "npm-package-arg": "^6.0.0", 40 | "rimraf": "^2.6.2", 41 | "safe-buffer": "^5.1.0", 42 | "update-notifier": "^2.3.0", 43 | "which": "^1.3.0", 44 | "y18n": "^4.0.0", 45 | "yargs": "^14.2.3" 46 | }, 47 | "devDependencies": { 48 | "cross-env": "^5.1.3", 49 | "json": "^9.0.6", 50 | "marked-man": "^0.2.1", 51 | "mkdirp": "^0.5.1", 52 | "npm": "^5.7.1", 53 | "nyc": "^11.4.1", 54 | "require-inject": "^1.4.0", 55 | "standard": "^11.0.0", 56 | "standard-version": "^4.3.0", 57 | "tacks": "^1.2.6", 58 | "tap": "^11.1.2" 59 | }, 60 | "config": { 61 | "nyc": { 62 | "exclude": [ 63 | "node_modules/**", 64 | "test/**" 65 | ] 66 | } 67 | }, 68 | "engines": { 69 | "node": ">=4" 70 | } 71 | } 72 | -------------------------------------------------------------------------------- /parse-args.js: -------------------------------------------------------------------------------- 1 | 'use strict' 2 | 3 | let npa 4 | const path = require('path') 5 | 6 | module.exports = parseArgs 7 | function parseArgs (argv, defaultNpm) { 8 | argv = argv || process.argv 9 | if (argv.length > 2 && argv[2][0] !== '-') { 10 | // fast-path around arg parsing! Don't even need to load yargs here. 11 | return fastPathArgs(argv, defaultNpm) 12 | } 13 | 14 | npa = require('npm-package-arg') 15 | 16 | const parser = yargsParser(argv, defaultNpm) 17 | 18 | const opts = parser.getOptions() 19 | const bools = new Set(opts.boolean) 20 | 21 | let cmdIndex 22 | let hasDashDash 23 | for (let i = 2; i < argv.length; i++) { 24 | const opt = argv[i] 25 | if (opt === '--') { 26 | hasDashDash = true 27 | break 28 | } else if (opt === '--node-arg' || opt === '-n') { 29 | argv[i] = `${opt}=${argv[i + 1]}` 30 | argv.splice(i + 1, 1) 31 | } else if (opt[0] === '-') { 32 | if ( 33 | // --no-install needs to be special-cased because we're abusing 34 | // yargs a bit in order to get the --help text right. 35 | opt !== '--no-install' && 36 | !bools.has(opt.replace(/^--?(no-)?/i, '')) && 37 | opt.indexOf('=') === -1 38 | ) { 39 | i++ 40 | } 41 | } else { 42 | cmdIndex = i 43 | break 44 | } 45 | } 46 | if (cmdIndex) { 47 | const parsed = parser.parse(argv.slice(0, cmdIndex)) 48 | const parsedCmd = npa(argv[cmdIndex]) 49 | parsed.command = parsed.package && parsedCmd.type !== 'directory' 50 | ? argv[cmdIndex] 51 | : guessCmdName(parsedCmd) 52 | parsed.isLocal = parsedCmd.type === 'directory' 53 | parsed.cmdOpts = argv.slice(cmdIndex + 1) 54 | if (typeof parsed.package === 'string') { 55 | parsed.package = [parsed.package] 56 | } 57 | parsed.packageRequested = !!parsed.package 58 | parsed.cmdHadVersion = parsed.package || parsedCmd.type === 'directory' 59 | ? false 60 | : parsedCmd.name !== parsedCmd.raw 61 | const pkg = parsed.package || [argv[cmdIndex]] 62 | parsed.p = parsed.package = pkg.map(p => npa(p).toString()) 63 | return parsed 64 | } else { 65 | const parsed = parser.parse(argv) 66 | if (typeof parsed.package === 'string') { 67 | parsed.package = [parsed.package] 68 | } 69 | // -c *requires* -p, because the -c string should not be touched by npx 70 | if (parsed.call && parsed.package) { 71 | parsed.packageRequested = !!parsed.package 72 | parsed.cmdHadVersion = false 73 | const pkg = parsed.package 74 | parsed.p = parsed.package = pkg.map(p => npa(p).toString()) 75 | } else if (parsed.call && !parsed.package) { 76 | parsed.packageRequested = false 77 | parsed.cmdHadVersion = false 78 | parsed.p = parsed.package = [] 79 | } else if (hasDashDash) { 80 | const splitCmd = parsed._.slice(2) 81 | const parsedCmd = npa(splitCmd[0]) 82 | parsed.command = parsed.package 83 | ? splitCmd[0] 84 | : guessCmdName(parsedCmd) 85 | parsed.cmdOpts = splitCmd.slice(1) 86 | parsed.packageRequested = !!parsed.package 87 | parsed.cmdHadVersion = parsed.package 88 | ? false 89 | : parsedCmd.name !== parsedCmd.raw 90 | const pkg = parsed.package || [splitCmd[0]] 91 | parsed.p = parsed.package = pkg.map(p => npa(p).toString()) 92 | } 93 | return parsed 94 | } 95 | } 96 | 97 | function fastPathArgs (argv, defaultNpm) { 98 | let parsedCmd 99 | let pkg 100 | if (argv[2].match(/^[a-z0-9_-]+$/i)) { 101 | parsedCmd = { registry: true, name: argv[2], raw: argv[2] } 102 | pkg = [`${argv[2]}@latest`] 103 | } else { 104 | npa = require('npm-package-arg') 105 | parsedCmd = npa(argv[2]) 106 | if (parsedCmd.type === 'directory') { 107 | pkg = [] 108 | } else { 109 | pkg = [parsedCmd.toString()] 110 | } 111 | } 112 | return { 113 | command: guessCmdName(parsedCmd), 114 | cmdOpts: argv.slice(3), 115 | packageRequested: false, 116 | isLocal: parsedCmd.type === 'directory', 117 | cmdHadVersion: ( 118 | parsedCmd.name !== parsedCmd.raw && 119 | parsedCmd.type !== 'directory' 120 | ), 121 | package: pkg, 122 | p: pkg, 123 | shell: false, 124 | noYargs: true, 125 | npm: defaultNpm || 'npm' 126 | } 127 | } 128 | 129 | parseArgs.showHelp = () => require('yargs').showHelp() 130 | 131 | module.exports._guessCmdName = guessCmdName 132 | function guessCmdName (spec) { 133 | if (typeof spec === 'string') { 134 | if (!npa) { npa = require('npm-package-arg') } 135 | spec = npa(spec) 136 | } 137 | if (spec.scope) { 138 | return spec.name.slice(spec.scope.length + 1) 139 | } else if (spec.registry) { 140 | return spec.name 141 | } else if (spec.hosted && spec.hosted.project) { 142 | return spec.hosted.project 143 | } else if (spec.type === 'git') { 144 | const match = spec.fetchSpec.match(/([a-z0-9-]+)(?:\.git)?$/i) 145 | return match[1] 146 | } else if (spec.type === 'directory') { 147 | return spec.raw 148 | } else if (spec.type === 'file' || spec.type === 'remote') { 149 | let ext = path.extname(spec.fetchSpec) 150 | if (ext === '.gz') { 151 | ext = path.extname(path.basename(spec.fetchSpec, ext)) + ext 152 | } 153 | return path.basename(spec.fetchSpec, ext).replace(/-\d+\.\d+\.\d+(?:-[a-z0-9.\-+]+)?$/i, '') 154 | } 155 | 156 | console.error(Y()`Unable to guess a binary name from ${spec.raw}. Please use --package.`) 157 | return null 158 | } 159 | 160 | function yargsParser (argv, defaultNpm) { 161 | const usage = ` 162 | npx [${Y()`options`}] <${Y()`command`}>[@${Y()`version`}] [${Y()`command-arg`}]... 163 | 164 | npx [${Y()`options`}] [-p|--package <${Y()`package`}>]... <${Y()`command`}> [${Y()`command-arg`}]... 165 | 166 | npx [${Y()`options`}] -c '<${Y()`command-string`}>' 167 | 168 | npx --shell-auto-fallback [${Y()`shell`}] 169 | ` 170 | 171 | return require('yargs') 172 | .usage(Y()`Execute binaries from npm packages.\n${usage}`) 173 | .option('package', { 174 | alias: 'p', 175 | type: 'string', 176 | describe: Y()`Package to be installed.` 177 | }) 178 | .option('cache', { 179 | type: 'string', 180 | describe: Y()`Location of the npm cache.` 181 | }) 182 | .option('always-spawn', { 183 | describe: Y()`Always spawn a child process to execute the command.`, 184 | type: 'boolean' 185 | }) 186 | .option('no-install', { 187 | type: 'boolean', 188 | describe: Y()`Skip installation if a package is missing.` 189 | }) 190 | .option('userconfig', { 191 | type: 'string', 192 | describe: Y()`Path to user npmrc.` 193 | }) 194 | .option('call', { 195 | alias: 'c', 196 | type: 'string', 197 | describe: Y()`Execute string as if inside \`npm run-script\`.` 198 | }) 199 | .option('shell', { 200 | alias: 's', 201 | type: 'string', 202 | describe: Y()`Shell to execute the command with, if any.`, 203 | default: false 204 | }) 205 | .option('shell-auto-fallback', { 206 | choices: ['', 'bash', 'fish', 'zsh'], 207 | describe: Y()`Generate shell code to use npx as the "command not found" fallback.`, 208 | requireArg: false, 209 | type: 'string' 210 | }) 211 | .option('ignore-existing', { 212 | describe: Y()`Ignores existing binaries in $PATH, or in the local project. This forces npx to do a temporary install and use the latest version.`, 213 | type: 'boolean' 214 | }) 215 | .option('quiet', { 216 | alias: 'q', 217 | describe: Y()`Suppress output from npx itself. Subcommands will not be affected.`, 218 | type: 'boolean' 219 | }) 220 | .option('npm', { 221 | describe: Y()`npm binary to use for internal operations.`, 222 | type: 'string', 223 | default: defaultNpm || 'npm' 224 | }) 225 | .option('node-arg', { 226 | alias: 'n', 227 | type: 'string', 228 | describe: Y()`Extra node argument when calling a node binary.` 229 | }) 230 | .version() 231 | .alias('version', 'v') 232 | .help() 233 | .alias('help', 'h') 234 | .epilogue(Y()`For the full documentation, see the manual page for npx(1).`) 235 | } 236 | 237 | var _y 238 | function Y () { 239 | if (!_y) { _y = require('./y.js') } 240 | return _y 241 | } 242 | -------------------------------------------------------------------------------- /test/auto-fallback.js: -------------------------------------------------------------------------------- 1 | 'use strict' 2 | 3 | const child = require('../child.js') 4 | const exec = require('child_process').exec 5 | const path = require('path') 6 | const test = require('tap').test 7 | 8 | const NPX_BIN = child.escapeArg(path.join(__dirname, 'util', 'npx-bin.js')) 9 | 10 | test('not called with option', (t) => 11 | exec(`node ${NPX_BIN}`, (err, stdout, stderr) => { 12 | t.equal(err.code, 1) 13 | t.notOk(stdout) 14 | t.match(stderr, /--shell-auto-fallback/g) 15 | t.end() 16 | }) 17 | ) 18 | 19 | test('detect: SHELL ~= fish', (t) => 20 | exec(`node ${NPX_BIN} --shell-auto-fallback`, { 21 | env: { 22 | SHELL: '/usr/bin/fish' 23 | } 24 | }, (err, stdout, stderr) => { 25 | if (err) { throw err } 26 | t.match(stdout, /function __fish_command_not_found/) 27 | t.notOk(stderr) 28 | t.end() 29 | }) 30 | ) 31 | 32 | test('detect: SHELL ~= bash', (t) => 33 | exec(`node ${NPX_BIN} --shell-auto-fallback`, { 34 | env: { 35 | SHELL: '/bin/bash' 36 | } 37 | }, (err, stdout, stderr) => { 38 | if (err) { throw err } 39 | t.match(stdout, /command_not_found_handle\(/) 40 | t.notOk(stderr) 41 | t.end() 42 | }) 43 | ) 44 | 45 | test('detect: SHELL ~= zsh', (t) => 46 | exec(`node ${NPX_BIN} --shell-auto-fallback`, { 47 | env: { 48 | SHELL: '/usr/local/bin/zsh' 49 | } 50 | }, (err, stdout, stderr) => { 51 | if (err) { throw err } 52 | t.match(stdout, /command_not_found_handler\(/) 53 | t.notOk(stderr) 54 | t.end() 55 | }) 56 | ) 57 | 58 | test('detect: no SHELL', (t) => 59 | exec(`node ${NPX_BIN} --shell-auto-fallback`, { 60 | env: {} 61 | }, (err, stdout, stderr) => { 62 | t.equal(err.code, 1) 63 | t.notOk(stdout) 64 | t.match(stderr, /Only .+ shells are supported :\(/) 65 | t.end() 66 | }) 67 | ) 68 | 69 | test('detect: SHELL ~= unsupported', (t) => 70 | exec(`node ${NPX_BIN} --shell-auto-fallback`, { 71 | env: { 72 | SHELL: '/sbin/nope' 73 | } 74 | }, (err, stdout, stderr) => { 75 | t.equal(err.code, 1) 76 | t.notOk(stdout) 77 | t.match(stderr, /Only .+ shells are supported :\(/) 78 | t.end() 79 | }) 80 | ) 81 | 82 | test('given: fish', (t) => 83 | exec(`node ${NPX_BIN} --shell-auto-fallback fish`, (err, stdout, stderr) => { 84 | if (err) { throw err } 85 | t.match(stdout, /function __fish_command_not_found/) 86 | t.notOk(stderr) 87 | t.end() 88 | }) 89 | ) 90 | 91 | test('given: bash', (t) => 92 | exec(`node ${NPX_BIN} --shell-auto-fallback bash`, (err, stdout, stderr) => { 93 | if (err) { throw err } 94 | t.match(stdout, /command_not_found_handle\(/) 95 | t.notOk(stderr) 96 | t.end() 97 | }) 98 | ) 99 | 100 | test('given: zsh', (t) => 101 | exec(`node ${NPX_BIN} --shell-auto-fallback zsh`, (err, stdout, stderr) => { 102 | if (err) { throw err } 103 | t.match(stdout, /command_not_found_handler\(/) 104 | t.notOk(stderr) 105 | t.end() 106 | }) 107 | ) 108 | 109 | test('given: unsupported', (t) => 110 | exec(`node ${NPX_BIN} --shell-auto-fallback nope`, (err, stdout, stderr) => { 111 | t.equal(err.code, 1) 112 | t.notOk(stdout) 113 | t.match(stderr, /Invalid values:\s+Argument: shell-auto-fallback/) 114 | t.end() 115 | }) 116 | ) 117 | -------------------------------------------------------------------------------- /test/child.js: -------------------------------------------------------------------------------- 1 | 'use strict' 2 | 3 | const test = require('tap').test 4 | 5 | const child = require('../child.js') 6 | const requireInject = require('require-inject') 7 | 8 | test('escapeArg on *nix', t => { 9 | const origPlatform = process.platform 10 | Object.defineProperty(process, 'platform', {value: 'linux'}) 11 | t.equal(child.escapeArg('foo'), 'foo', 'standard arg left intact') 12 | t.equal(child.escapeArg('foo bar'), '\'foo bar\'', '\'-escaped on *nix') 13 | t.equal( 14 | child.escapeArg('/foo bar/baz\'quux.JPg', true), 15 | '\'/foo bar/baz\'"\'"\'quux.JPg\'', 16 | 'paths escaped as usual' 17 | ) 18 | Object.defineProperty(process, 'platform', {value: origPlatform}) 19 | t.done() 20 | }) 21 | 22 | test('escapeArg on win32', t => { 23 | const origPlatform = process.platform 24 | Object.defineProperty(process, 'platform', {value: 'win32'}) 25 | t.equal(child.escapeArg('foo'), '"foo"', 'standard arg escaped') 26 | t.equal(child.escapeArg('foo bar'), '"foo bar"', '"-escaped on win32') 27 | t.equal( 28 | child.escapeArg('C:\\Foo bar\\baz\'"\\quux.JPg', true), 29 | 'C:\\"Foo bar"\\baz\'"\\quux.JPg', 30 | 'paths escaped as usual' 31 | ) 32 | Object.defineProperty(process, 'platform', {value: origPlatform}) 33 | t.done() 34 | }) 35 | 36 | test('exec', t => { 37 | const child = requireInject('../child.js', { 38 | 'child_process': { 39 | exec (cmd, opts, cb) { 40 | if (opts.fail) { 41 | cb(new Error('exec failure requested')) 42 | } else { 43 | cb(null, {cmd, opts}) 44 | } 45 | } 46 | } 47 | }) 48 | const origPlatform = process.platform 49 | return child.exec('cmd', ['arg1', 'arg2'], {opt: 1}).then(ret => { 50 | t.equal(ret.cmd, 'cmd arg1 arg2', 'command string concatenated') 51 | t.deepEqual(ret.opts, {opt: 1}, 'options received!') 52 | Object.defineProperty(process, 'platform', {value: 'linux'}) 53 | return child.exec('/foo bar/baz .quux\\', ['arg1', 'arg 2']) 54 | }).then(ret => { 55 | t.equal(ret.cmd, "'/foo bar/baz .quux\\' arg1 arg 2", 'unix-style escapes') 56 | Object.defineProperty(process, 'platform', {value: 'win32'}) 57 | return child.exec('C:\\foo bar\\baz .quux\\a', ['arg1', 'arg 2']) 58 | }).then(ret => { 59 | t.equal(ret.cmd, 'C:\\"foo bar"\\"baz .quux"\\a arg1 arg 2', 'win32-style escapes') 60 | Object.defineProperty(process, 'platform', {value: origPlatform}) 61 | }).then(() => { 62 | return child.exec('fail', [], {fail: true}).then(() => { 63 | throw new Error('was supposed to fail') 64 | }, err => { 65 | t.equal(err.message, 'exec failure requested', 'got error') 66 | }) 67 | }) 68 | }) 69 | 70 | test('exec (integration)', t => { 71 | return child.exec('node', ['-p', '1+1']).then(stdout => { 72 | t.equal(stdout.trim(), '2', 'node ran successfully') 73 | return child.exec('node', ['-e', '"process.exit(123)"']).then(() => { 74 | throw new Error('was not supposed to succeed') 75 | }, err => { 76 | t.equal(err.exitCode, 123, 'got the exit code from subproc') 77 | }) 78 | }) 79 | }) 80 | 81 | test('spawn', t => { 82 | return child.spawn('node', ['-p', '1+1']).then(res => { 83 | t.deepEqual(res, { 84 | code: 0, 85 | stdout: '2\n', 86 | stderr: '' 87 | }) 88 | return child.spawn('node', ['-e', 'process.exit(123)']).then(() => { 89 | throw new Error('was not supposed to succeed') 90 | }, err => { 91 | t.equal(err.exitCode, 123, 'got the exit code from ') 92 | }) 93 | }) 94 | }) 95 | 96 | test('runCommand with command arg', t => { 97 | return child.runCommand('node', { 98 | cmdOpts: ['-p', '1+1'], 99 | stdio: 'pipe' 100 | }).then(res => { 101 | t.deepEqual(res, { 102 | code: 0, 103 | stdout: '2\n', 104 | stderr: '' 105 | }) 106 | return child.runCommand('node', { 107 | cmdOpts: ['-e', 'process.exit(123)'] 108 | }).then(() => { 109 | throw new Error('was not supposed to succeed') 110 | }, err => { 111 | t.equal(err.exitCode, 123, 'got the exit code from subproc') 112 | }) 113 | }).then(() => { 114 | return child.runCommand('./not-a-command-at-all', { 115 | stdio: 'pipe' 116 | }).then(() => { 117 | throw new Error('was not supposed to succeed') 118 | }, err => { 119 | if (process.platform === 'win32') { 120 | t.match(err.message, /Command failed/, 'error message reports failure') 121 | t.match(err.stderr, /not recognized as an internal or external command/, 'stderr reports command not found') 122 | } else { 123 | t.match(err.message, /command not found/, 'error message reports ENOENT') 124 | t.equal(err.exitCode, 127, '"not found" has code 127') 125 | } 126 | }) 127 | }) 128 | }) 129 | 130 | test('runCommand with opts.command', t => { 131 | return child.runCommand(null, { 132 | command: 'node', 133 | cmdOpts: ['-p', '1+1'], 134 | stdio: 'pipe' 135 | }).then(res => { 136 | t.deepEqual(res, { 137 | code: 0, 138 | stdout: '2\n', 139 | stderr: '' 140 | }) 141 | }) 142 | }) 143 | 144 | test('runCommand with opts.call and opts.shell', { 145 | skip: process.platform === 'win32' && 'Windows passes different flags to shell' 146 | }, t => { 147 | // Starting from node 12.17.x, the fact that spawn-wrap generates 148 | // an extensionless file causes an ERR_UNKNOWN_FILE_EXTENSION error. 149 | // Previous versions of node didn't throw. Updating nyc to 15.x.x fixes 150 | // this, but we can't update because it breaks on Node 6 which we 151 | // currently support. 152 | const version = process.version.replace('v', '').split('.').map(n => +n) 153 | if (version[0] > 12 || version[0] === 12 && version[1] >= 17) { 154 | t.end() 155 | } else { 156 | return child.runCommand(null, { 157 | shell: 'node', 158 | call: './child.js', 159 | stdio: 'pipe' 160 | }).then(res => { 161 | t.deepEqual(res, { 162 | code: 0, 163 | stdout: '', 164 | stderr: '' 165 | }) 166 | }) 167 | } 168 | }) 169 | -------------------------------------------------------------------------------- /test/get-prefix.js: -------------------------------------------------------------------------------- 1 | 'use strict' 2 | 3 | const os = require('os') 4 | const path = require('path') 5 | const requireInject = require('require-inject') 6 | const Tacks = require('tacks') 7 | const test = require('tap').test 8 | const testDir = require('./util/test-dir.js')(__filename) 9 | 10 | const Dir = Tacks.Dir 11 | const File = Tacks.File 12 | 13 | const getPrefix = require('../get-prefix.js') 14 | 15 | test('navigates out of `node_modules` without fs nav', t => { 16 | return getPrefix( 17 | path.join(testDir, 'node_modules', 'node_modules') 18 | ).then(val => { 19 | t.equal(val, testDir, 'navigates out of node_modules') 20 | }) 21 | }) 22 | 23 | test('detects if currently in an npm package using package.json', t => { 24 | const fixture = new Tacks(Dir({ 25 | 'package.json': File({name: 'foo', version: '1.2.3'}) 26 | })) 27 | fixture.create(testDir) 28 | return getPrefix(testDir).then(prefix => { 29 | t.equal(prefix, testDir, 'current dir worked out') 30 | }) 31 | }) 32 | 33 | test('detects if currently in an npm package using node_modules', t => { 34 | const fixture = new Tacks(Dir({ 35 | 'node_modules': Dir({}) 36 | })) 37 | fixture.create(testDir) 38 | return getPrefix(testDir).then(prefix => { 39 | t.equal(prefix, testDir, 'current dir worked out') 40 | }) 41 | }) 42 | 43 | test('returns false if no package was found in parent dirs', t => { 44 | // Hopefully folks' tmpdir isn't inside an npm package ;) 45 | const tmp = os.tmpdir() 46 | return getPrefix(tmp).then(prefix => { 47 | t.equal(prefix, false, 'returned the false') 48 | }) 49 | }) 50 | 51 | test('navigates up the filesystem until it finds a package', t => { 52 | const fixture = new Tacks(Dir({ 53 | 'node_modules': Dir({}), 54 | 'a': Dir({'b': Dir({'c': Dir({'d': Dir({})})})}) 55 | })) 56 | fixture.create(testDir) 57 | return getPrefix(path.join(testDir, 'a', 'b', 'c')).then(prefix => { 58 | t.equal(prefix, testDir, 'navigated all the way up') 59 | }) 60 | }) 61 | 62 | test('doesn\'t go too far while navigating up', t => { 63 | const fixture = new Tacks(Dir({ 64 | 'node_modules': Dir({}), 65 | 'a': Dir({'node_modules': Dir({}), 'b': Dir({'c': Dir({'d': Dir({})})})}) 66 | })) 67 | fixture.create(testDir) 68 | return getPrefix(path.join(testDir, 'a', 'b', 'c')).then(prefix => { 69 | t.equal(prefix, path.join(testDir, 'a'), 'stopped before root') 70 | }) 71 | }) 72 | 73 | test('fileExists unit', t => { 74 | const fileExists = requireInject('../get-prefix.js', { 75 | fs: { 76 | stat (todo, cb) { 77 | if (todo === 'exists') { 78 | cb(null, {name: 'yay'}) 79 | } else if (todo === 'enoent') { 80 | const err = new Error('not found') 81 | err.code = 'ENOENT' 82 | cb(err) 83 | } else { 84 | cb(new Error('idk')) 85 | } 86 | } 87 | } 88 | })._fileExists 89 | return Promise.all([ 90 | fileExists('exists'), 91 | fileExists('enoent'), 92 | fileExists('kaboom').then(() => { 93 | throw new Error('nope') 94 | }, err => err) 95 | ]).then(results => { 96 | t.deepEqual(results[0], {name: 'yay'}, 'existing stat returned') 97 | t.notOk(results[1], 'missing file succeeds with falsy') 98 | t.match(results[2].message, /^idk$/, 'other errors thrown') 99 | }) 100 | }) 101 | 102 | test('isRootPath unit', t => { 103 | const isRoot = getPrefix._isRootPath 104 | t.ok(isRoot('C:\\', 'win32'), 'detected root on windows') 105 | t.notOk(isRoot('C:\\foo', 'win32'), 'detected non-root on windows') 106 | t.ok(isRoot('/', 'darwin'), 'detected root on darwin') 107 | t.notOk(isRoot('/foo', 'darwin'), 'detected non-root on darwin') 108 | t.ok(isRoot('/', 'linux'), 'detected root on linux') 109 | t.notOk(isRoot('/foo', 'linux'), 'detected non-root on linux') 110 | t.done() 111 | }) 112 | -------------------------------------------------------------------------------- /test/guess-command-name.js: -------------------------------------------------------------------------------- 1 | 'use strict' 2 | 3 | const test = require('tap').test 4 | 5 | const guessCmdName = require('../parse-args.js')._guessCmdName 6 | 7 | test('guesses unscoped registry binaries', t => { 8 | t.equal(guessCmdName('foo'), 'foo') 9 | t.done() 10 | }) 11 | 12 | test('guesses scoped registry binaries', t => { 13 | t.equal(guessCmdName('@user/foo'), 'foo') 14 | t.done() 15 | }) 16 | 17 | test('guesses hosted git binaries', t => { 18 | t.equal(guessCmdName('user/foo'), 'foo') 19 | t.equal(guessCmdName('git+ssh://git@github.com:user/foo.git#semver:^1'), 'foo') 20 | t.done() 21 | }) 22 | 23 | test('guesses git binaries', t => { 24 | t.equal(guessCmdName('git+ssh://myhost.com:user/foo.git#semver:^1'), 'foo') 25 | t.equal(guessCmdName('git://myhost.com:foo'), 'foo') 26 | t.done() 27 | }) 28 | 29 | test('leaves local directory/file commands intact', t => { 30 | t.equal(guessCmdName('./foo'), './foo') 31 | t.equal(guessCmdName('./dir/foo'), './dir/foo') 32 | t.equal(guessCmdName('../../../dir/foo'), '../../../dir/foo') 33 | t.equal( 34 | guessCmdName('C:\\Program Files\\node\\foo'), 35 | 'C:\\Program Files\\node\\foo' 36 | ) 37 | t.done() 38 | }) 39 | 40 | test('guesses remote tarballs', t => { 41 | t.equal(guessCmdName('https://registry.npmjs.org/foo/-/foo-1.2.3.tgz'), 'foo') 42 | t.equal(guessCmdName('http://registry.npmjs.org/foo/-/foo-1.2.3-prerelease.5+buildnum.tgz'), 'foo') 43 | t.equal(guessCmdName('https://github.com/tarball/blah/foo.tar.gz'), 'foo') 44 | t.done() 45 | }) 46 | 47 | test('guesses local tarballs', t => { 48 | t.equal(guessCmdName('./foo-1.2.3.tgz'), 'foo') 49 | t.equal(guessCmdName('./dir/foo.tar.gz'), 'foo') 50 | t.equal(guessCmdName('C:\\Program Files\\dir/foo-bar.tar.gz'), 'foo-bar') 51 | t.done() 52 | }) 53 | 54 | test('warns when something could not be guessed', t => { 55 | const oldErr = console.error 56 | console.error = str => { 57 | t.match(str, /Unable to guess a binary name/) 58 | } 59 | guessCmdName({}) 60 | console.error = oldErr 61 | t.done() 62 | }) 63 | -------------------------------------------------------------------------------- /test/index.js: -------------------------------------------------------------------------------- 1 | 'use strict' 2 | 3 | const Buffer = require('safe-buffer').Buffer 4 | 5 | const child = require('../child.js') 6 | const path = require('path') 7 | const requireInject = require('require-inject') 8 | const test = require('tap').test 9 | 10 | const main = require('../index.js') 11 | 12 | const isWindows = process.platform === 'win32' 13 | 14 | const NPX_PATH = path.resolve(__dirname, 'util', 'npx-bin.js') 15 | const NPM_PATH = path.resolve(__dirname, '..', 'node_modules', 'npm', 'bin', 'npm-cli.js') 16 | 17 | const NPX_ESC = isWindows ? child.escapeArg(NPX_PATH) : NPX_PATH 18 | 19 | test('npx --always-spawn', t => { 20 | return child.spawn('node', [ 21 | NPX_ESC, '--always-spawn', 'echo-cli', 'hewwo' 22 | ], {stdio: 'pipe'}).then(res => { 23 | t.equal(res.stdout.trim(), 'hewwo') 24 | }) 25 | }) 26 | 27 | test('npx --always-spawn resolves promise after command is executed', t => { 28 | const _runCommand = child.runCommand 29 | const parsed = main.parseArgs([ 30 | process.argv[0], 31 | '[fake arg]', 32 | '--always-spawn', 33 | 'echo-cli', 34 | 'hewwo' 35 | ], NPM_PATH) 36 | child.runCommand = (command, opts) => { 37 | child.runCommand = _runCommand 38 | return Promise.resolve([command, opts]) 39 | } 40 | return main(parsed) 41 | .then(args => { 42 | const command = args[0] 43 | const opts = args[1] 44 | t.ok(command.includes('node'), 'node executes the command') 45 | t.equal(opts.alwaysSpawn, true, 'set opts.alwaysSpawn') 46 | t.equal(opts.command, 'echo-cli', 'set opts.command') 47 | t.ok(opts.cmdOpts[0].includes('echo-cli'), 'set opts.cmdOpts[0]') 48 | t.equal(opts.cmdOpts[1], 'hewwo', 'set opts.cmdOpts[1]') 49 | }) 50 | }) 51 | 52 | test('npx --shell-auto-fallback', t => { 53 | return child.spawn('node', [ 54 | NPX_ESC, '--shell-auto-fallback', 'zsh' 55 | ], {stdio: 'pipe'}).then(res => { 56 | t.equal(res.code, 0, 'command succeeded') 57 | t.match( 58 | res.stdout, /command_not_found_handler\(\)/, 'got shell code in output' 59 | ) 60 | }) 61 | }) 62 | 63 | test('npx no command', t => { 64 | return child.spawn('node', [ 65 | NPX_ESC 66 | ], {stdio: 'pipe'}).then(res => { 67 | throw new Error('Should not have succeeded') 68 | }, err => { 69 | t.equal(err.exitCode, 1, 'got 1 as exit code') 70 | t.match( 71 | err.stderr, 72 | /ERROR: You must supply a command/, 73 | 'got a useful error message' 74 | ) 75 | t.match(err.stderr, /Execute binaries from npm/, 'npx help printed') 76 | }) 77 | }) 78 | 79 | test('npx existing subcommand', { 80 | skip: isWindows && 'Windows fail this test when run via nyc, but not when run directly' 81 | }, t => { 82 | return child.spawn('node', [ 83 | NPX_ESC, 'which', 'npm' 84 | ], {stdio: 'pipe'}).then(res => { 85 | t.notOk(res.stderr, 'no stderr output') 86 | t.ok(res.stdout.trim(), 'got output from command') 87 | }) 88 | }) 89 | 90 | test('execCommand unit', { 91 | skip: isWindows && 'need a workaround for obnoxious auto-open of .md file on Windows' 92 | }, t => { 93 | let whichBin = path.resolve( 94 | __dirname, '..', 'node_modules', '.bin', 'which' 95 | ) 96 | if (isWindows) { 97 | whichBin += '.CMD' 98 | } 99 | return main._execCommand(null, { 100 | command: path.resolve(__dirname, '..', 'README.md') 101 | }).then(res => { 102 | if (isWindows) { 103 | t.equal(res.code, 0, 'cmd.exe opened the file via its associated executable and returned success') 104 | } else { 105 | throw new Error('should not have succeeded') 106 | } 107 | }, err => { 108 | t.equal( 109 | typeof err.code, 'string', 'get a regular crash when the arg is invalid' 110 | ) 111 | }).then(() => { 112 | const oldCode = process.exitCode 113 | delete process.exitCode 114 | return main._execCommand(null, { 115 | stdio: 'pipe', 116 | command: whichBin 117 | }).then(() => { 118 | t.equal(process.exitCode, 1, 'set code without crashing, on cmd fail') 119 | process.exitCode = oldCode 120 | }) 121 | }) 122 | }) 123 | 124 | test('installPackages unit', t => { 125 | const installPkgs = requireInject('../index.js', { 126 | '../child.js': { 127 | spawn (npmPath, args) { 128 | if (args[2] === 'fail') { 129 | return Promise.reject(new Error('fail')) 130 | } else if (args[2] === 'codefail') { 131 | const err = new Error('npm failed') 132 | err.exitCode = 123 133 | return Promise.reject(err) 134 | } else if (args[2] === 'pathTest') { 135 | return Promise.resolve({ 136 | stdout: JSON.stringify(npmPath) 137 | }) 138 | } else { 139 | return Promise.resolve({ 140 | stdout: JSON.stringify([].slice.call(arguments)) 141 | }) 142 | } 143 | }, 144 | escapeArg (arg) { 145 | if (arg === '/f@ke_/path to/node') { 146 | return '\'/f@ke_/path to/node\'' 147 | } else if (arg === 'C:\\f@ke_\\path to\\node') { 148 | return '"C:\\f@ke_\\path to\\node"' 149 | } 150 | return arg 151 | } 152 | } 153 | })._installPackages 154 | return installPkgs(['installme@latest', 'file:foo'], 'myprefix', { 155 | npm: NPM_PATH 156 | }).then(deets => { 157 | t.deepEqual(deets[1], [ 158 | NPM_PATH, 159 | 'install', 'installme@latest', 'file:foo', 160 | '--global', 161 | '--prefix', 'myprefix', 162 | '--loglevel', 'error', 163 | '--json' 164 | ], 'args to spawn were correct for installing requested package') 165 | t.deepEqual(deets[2].stdio, [0, 'pipe', 2], 'default stdio settings correct') 166 | return installPkgs(['fail'], 'myprefix', { 167 | npm: NPM_PATH 168 | }).then(() => { 169 | throw new Error('should not have succeeded') 170 | }, err => { 171 | t.equal(err.message, 'fail', 'non-process failure reported intact') 172 | }) 173 | }).then(() => { 174 | return installPkgs(['codefail'], 'myprefix', { 175 | npm: NPM_PATH 176 | }).then(() => { 177 | throw new Error('should not have succeeded') 178 | }, err => { 179 | t.match( 180 | err.message, 181 | /Install for .*codefail.* failed with code 123/, 182 | 'npm install failure has helpful error message' 183 | ) 184 | t.equal(err.exitCode, 123, 'error has exitCode') 185 | }) 186 | }).then(() => { 187 | const nodePath = process.argv[0] 188 | process.argv[0] = isWindows ? 'C:\\f@ke_\\path to\\node' : '/f@ke_/path to/node' 189 | return installPkgs(['pathTest'], 'myprefix', { 190 | npm: NPM_PATH 191 | }).then((npmPath) => { 192 | process.argv[0] = nodePath 193 | if (isWindows) { 194 | t.equal(npmPath, '"C:\\f@ke_\\path to\\node"', 'incorrectly escaped path win32') 195 | } else { 196 | t.equal(npmPath, '/f@ke_/path to/node', 'incorrectly escaped path *nix') 197 | } 198 | }, (e) => { 199 | process.argv[0] = nodePath 200 | throw new Error('should not have failed') 201 | }) 202 | }) 203 | }) 204 | 205 | test('getEnv', t => { 206 | return main._getEnv({npm: NPM_PATH}).then(env => { 207 | t.ok(env, 'got the env') 208 | t.equal(env.npm_package_name, 'libnpx', 'env has run-script vars') 209 | }) 210 | }) 211 | 212 | test('getNpmCache', t => { 213 | const userconfig = 'blah' 214 | const getCache = requireInject('../index.js', { 215 | '../child.js': { 216 | exec (cmd, args) { 217 | return Promise.resolve(`${cmd} ${args.join(' ')}\n`) 218 | }, 219 | escapeArg (arg, asPath) { 220 | return `${arg}-escaped-as-path-${!!asPath}` 221 | } 222 | } 223 | })._getNpmCache 224 | return getCache({npm: NPM_PATH}).then(cache => { 225 | t.equal(cache, `${process.argv[0]} ${NPM_PATH}-escaped-as-path-false config get cache --parseable`, 'requests cache from npm') 226 | return getCache({npm: NPM_PATH, userconfig}) 227 | }).then(cache => { 228 | t.equal( 229 | cache, 230 | `${process.argv[0]} ${NPM_PATH}-escaped-as-path-false config get cache --parseable --userconfig ${ 231 | userconfig 232 | }-escaped-as-path-true`, 233 | 'added userconfig if option present' 234 | ) 235 | }) 236 | }) 237 | 238 | test('findNodeScript', t => { 239 | return main._findNodeScript(NPX_PATH).then(script => { 240 | if (isWindows) { 241 | t.notOk(script, 'win32 never detects Node scripts like this') 242 | } else { 243 | t.equal(script, NPX_PATH, 'existing returned as-is on *nix') 244 | } 245 | return main._findNodeScript(__filename).then(script => { 246 | t.notOk(script, 'files that are not standalone node scripts are false') 247 | }) 248 | }).then(() => { 249 | return main._findNodeScript(null).then(bool => { 250 | t.notOk(bool, 'no node script found if existing is null') 251 | }) 252 | }).then(() => { 253 | return main._findNodeScript(NPX_PATH, {isLocal: true}).then(script => { 254 | t.equal(script, NPX_PATH, 'resolved dir dep to index.js') 255 | }) 256 | }).then(() => { 257 | const findScript = requireInject('../index.js', { 258 | fs: { 259 | stat (file, cb) { 260 | cb(null, { 261 | isDirectory () { return !file.indexOf('./') } 262 | }) 263 | }, 264 | open (file, perm, cb) { 265 | cb(null, file) 266 | }, 267 | read (fd, buf, offset, length, position, cb) { 268 | if (fd === 'fail') { 269 | cb(new Error('fail')) 270 | } else { 271 | Buffer.from(fd).copy(buf) 272 | cb(null) 273 | } 274 | }, 275 | close (fd, cb) { 276 | cb() 277 | } 278 | } 279 | })._findNodeScript 280 | return findScript('fail').then(f => { 281 | if (isWindows) { 282 | t.notOk(f, 'win32 gives no fucks') 283 | } else { 284 | throw new Error('should have failed') 285 | } 286 | }, err => { 287 | t.equal(err.message, 'fail', 'close error rethrown') 288 | }) 289 | }) 290 | }) 291 | 292 | test('npx with custom installer stdio', t => { 293 | const NPX_PATH = path.resolve(__dirname, 'util', 'npx-bin-inherit-stdio.js') 294 | const NPX_ESC = isWindows ? child.escapeArg(NPX_PATH) : NPX_PATH 295 | 296 | return child.spawn('node', [ 297 | NPX_ESC, 'say-shalom@1.2.7' 298 | ], {stdio: 'pipe'}).then(res => { 299 | t.equal(res.code, 0, 'command succeeded') 300 | t.match( 301 | res.stdout.toString(), /"added":/, 'installer output printed directly to console' 302 | ) 303 | t.end() 304 | }) 305 | }) 306 | 307 | test('noisy npx with --quiet arg on windows', { 308 | skip: !isWindows && 'Only on Windows does the path to the downloaded module get printed' 309 | }, t => { 310 | return child.spawn('node', [ 311 | NPX_ESC, '--quiet', 'echo-cli', 'hewwo' 312 | ], {stdio: 'pipe'}).then(res => { 313 | t.equal(res.stdout.trim(), 'hewwo') 314 | t.end() 315 | }) 316 | }) 317 | 318 | test('nice error message when no binaries on windows', { 319 | skip: !isWindows && 'Only on Windows is the error message inscrutable' 320 | }, t => { 321 | return child.spawn('node', [ 322 | NPX_ESC, '0' 323 | ], {stdio: 'pipe'}).then(res => { 324 | throw new Error('Should not have succeeded') 325 | }, err => { 326 | t.equal(err.stderr.split('\n')[1].trim(), 'command not found: 0') 327 | t.end() 328 | }) 329 | }) 330 | 331 | test('--node-arg works on Windows', { 332 | skip: !isWindows && 'Only on Windows does --node-arg have issues' 333 | }, t => { 334 | return child.spawn('node', [ 335 | NPX_ESC, '--quiet', 336 | '--node-arg', '--no-deprecation', 337 | 'echo-cli', 'hewwo' 338 | ], {stdio: 'pipe'}).then(res => { 339 | t.equal(res.stdout.trim(), 'hewwo') 340 | t.end() 341 | }) 342 | }) 343 | -------------------------------------------------------------------------------- /test/parse-args.js: -------------------------------------------------------------------------------- 1 | 'use strict' 2 | 3 | const test = require('tap').test 4 | 5 | const parseArgs = require('../parse-args.js') 6 | 7 | function mockParse () { 8 | return parseArgs(['/node', '/npx'].concat([].slice.call(arguments))) 9 | } 10 | 11 | test('parses basic command', t => { 12 | const parsed = mockParse('foo') 13 | t.equal(parsed.command, 'foo') 14 | t.deepEqual(parsed.package, ['foo@latest']) 15 | t.equal(parsed.packageRequested, false) 16 | t.equal(parsed.cmdHadVersion, false) 17 | t.equal(parsed.npm, 'npm') 18 | t.deepEqual(parsed.cmdOpts, []) 19 | t.done() 20 | }) 21 | 22 | test('parses command with version', t => { 23 | const parsed = mockParse('foo@1.2.3') 24 | t.equal(parsed.command, 'foo') 25 | t.deepEqual(parsed.package, ['foo@1.2.3']) 26 | t.equal(parsed.packageRequested, false) 27 | t.equal(parsed.cmdHadVersion, true) 28 | t.done() 29 | }) 30 | 31 | test('parses command opts', t => { 32 | const parsed = mockParse('foo', 'a', 'b') 33 | t.equal(parsed.command, 'foo') 34 | t.deepEqual(parsed.package, ['foo@latest']) 35 | t.equal(parsed.packageRequested, false) 36 | t.equal(parsed.cmdHadVersion, false) 37 | t.deepEqual(parsed.cmdOpts, ['a', 'b']) 38 | t.done() 39 | }) 40 | 41 | test('parses scoped package command opts', t => { 42 | const parsed = mockParse('@user/foo', 'a', 'b') 43 | t.equal(parsed.command, 'foo') 44 | t.deepEqual(parsed.package, ['@user/foo@latest']) 45 | t.equal(parsed.packageRequested, false) 46 | t.equal(parsed.cmdHadVersion, false) 47 | t.deepEqual(parsed.cmdOpts, ['a', 'b']) 48 | t.done() 49 | }) 50 | 51 | test('ignores options after command', t => { 52 | const parsed = mockParse('foo', '-p', 'bar', 'a', 'b') 53 | t.equal(parsed.command, 'foo') 54 | t.deepEqual(parsed.package, ['foo@latest']) 55 | t.equal(parsed.packageRequested, false) 56 | t.equal(parsed.cmdHadVersion, false) 57 | t.deepEqual(parsed.cmdOpts, ['-p', 'bar', 'a', 'b']) 58 | t.done() 59 | }) 60 | 61 | test('assumes unknown args before cmd have values and ignores them', t => { 62 | const parsed = mockParse('-p', 'bar', '--blahh', 'arg', '--ignore-existing', 'foo', 'a', 'b') 63 | t.equal(parsed.command, 'foo') 64 | t.deepEqual(parsed.package, ['bar@latest']) 65 | t.equal(parsed.packageRequested, true) 66 | t.equal(parsed.cmdHadVersion, false) 67 | t.deepEqual(parsed.cmdOpts, ['a', 'b']) 68 | t.done() 69 | }) 70 | 71 | test('parses package option', t => { 72 | const parsed = mockParse('-p', 'bar', 'foo', 'a', 'b') 73 | t.equal(parsed.command, 'foo') 74 | t.deepEqual(parsed.package, ['bar@latest']) 75 | t.equal(parsed.packageRequested, true) 76 | t.equal(parsed.cmdHadVersion, false) 77 | t.deepEqual(parsed.cmdOpts, ['a', 'b']) 78 | t.done() 79 | }) 80 | 81 | test('parses multiple package options', t => { 82 | const parsed = mockParse('-p', 'baz@1.2.3', '-p', 'bar', 'foo', 'a', 'b') 83 | t.equal(parsed.command, 'foo') 84 | t.deepEqual(parsed.package, ['baz@1.2.3', 'bar@latest']) 85 | t.equal(parsed.packageRequested, true) 86 | t.equal(parsed.cmdHadVersion, false) 87 | t.deepEqual(parsed.cmdOpts, ['a', 'b']) 88 | t.done() 89 | }) 90 | 91 | test('does not parse -c', t => { 92 | const parsed = mockParse('-c', 'foo a b') 93 | t.deepEqual(parsed.command, null, 'stays unparsed') 94 | t.deepEqual(parsed.package, []) 95 | t.equal(parsed.packageRequested, false) 96 | t.equal(parsed.cmdHadVersion, false) 97 | t.deepEqual(parsed.cmdOpts, null) 98 | t.done() 99 | }) 100 | 101 | test('uses -p even with -c', t => { 102 | const parsed = mockParse('-c', 'foo a b', '-p', 'bar') 103 | t.deepEqual(parsed.command, null) 104 | t.deepEqual(parsed.package, ['bar@latest']) 105 | t.equal(parsed.packageRequested, true) 106 | t.equal(parsed.cmdHadVersion, false) 107 | t.deepEqual(parsed.cmdOpts, null) 108 | t.done() 109 | }) 110 | 111 | test('-p prevents command parsing', t => { 112 | const parsed = mockParse('-p', 'pkg', 'foo@1.2.3', 'a', 'b') 113 | t.equal(parsed.command, 'foo@1.2.3') 114 | t.deepEqual(parsed.package, ['pkg@latest']) 115 | t.equal(parsed.packageRequested, true) 116 | t.equal(parsed.cmdHadVersion, false) 117 | t.deepEqual(parsed.cmdOpts, ['a', 'b']) 118 | t.done() 119 | }) 120 | 121 | test('-- stops option parsing but still does command', t => { 122 | const parsed = mockParse('--', '-foo', 'a', 'b') 123 | t.equal(parsed.command, '-foo') 124 | t.deepEqual(parsed.package, ['-foo@latest']) 125 | t.equal(parsed.packageRequested, false) 126 | t.equal(parsed.cmdHadVersion, false) 127 | t.deepEqual(parsed.cmdOpts, ['a', 'b']) 128 | t.done() 129 | }) 130 | 131 | test('-- still respects -p', t => { 132 | const parsed = mockParse('-p', 'bar', '--', '-foo', 'a', 'b') 133 | t.equal(parsed.command, '-foo') 134 | t.deepEqual(parsed.package, ['bar@latest']) 135 | t.equal(parsed.packageRequested, true) 136 | t.equal(parsed.cmdHadVersion, false) 137 | t.deepEqual(parsed.cmdOpts, ['a', 'b']) 138 | t.done() 139 | }) 140 | 141 | test('allows configuration of npm binary', t => { 142 | const parsed = mockParse('--npm', './mynpm', 'foo') 143 | t.equal(parsed.npm, './mynpm') 144 | t.done() 145 | }) 146 | 147 | test('treats directory-type commands specially', t => { 148 | let parsed = mockParse('./foo') 149 | t.equal(parsed.command, './foo') 150 | t.deepEqual(parsed.package, []) 151 | t.equal(parsed.packageRequested, false) 152 | t.equal(parsed.cmdHadVersion, false) 153 | t.ok(parsed.isLocal) 154 | parsed = mockParse('-p', 'x', '../foo/bar.sh') 155 | t.equal(parsed.command, '../foo/bar.sh') 156 | t.ok(parsed.isLocal) 157 | t.deepEqual(parsed.package, ['x@latest']) 158 | t.equal(parsed.packageRequested, true) 159 | t.equal(parsed.cmdHadVersion, false) 160 | t.done() 161 | }) 162 | 163 | test('-n and --node-arg special parsing rules', t => { 164 | const command = 'command' 165 | t.like( 166 | mockParse('-n=--foo', command), 167 | {command, nodeArg: '--foo'} 168 | ) 169 | t.like( 170 | mockParse('-n', '--foo', command), 171 | {command, nodeArg: '--foo'} 172 | ) 173 | t.like( 174 | mockParse('--node-arg=--foo', command), 175 | {command, nodeArg: '--foo'} 176 | ) 177 | t.like( 178 | mockParse('--node-arg', '--foo', command), 179 | {command, nodeArg: '--foo'} 180 | ) 181 | t.like( 182 | mockParse('-n', '--foo', '-n', '--bar', '-n', 'baz', command), 183 | {command, nodeArg: ['--foo', '--bar', 'baz']} 184 | ) 185 | t.like( 186 | mockParse('--node-arg', '--foo', '--node-arg', '--bar', '--node-arg', 'baz', command), 187 | {command, nodeArg: ['--foo', '--bar', 'baz']} 188 | ) 189 | t.like( 190 | mockParse('-n', '--foo', '--node-arg', '--bar', '-n=baz', command), 191 | {command, nodeArg: ['--foo', '--bar', 'baz']} 192 | ) 193 | t.like( 194 | mockParse('-n', '-n', command), 195 | {command, nodeArg: '-n'} 196 | ) 197 | t.like( 198 | mockParse('--node-arg', '--node-arg', command), 199 | {command, nodeArg: '--node-arg'} 200 | ) 201 | t.like( 202 | mockParse(command, '--node-arg', 'blah'), 203 | {command, nodeArg: undefined, cmdOpts: ['--node-arg', 'blah']} 204 | ) 205 | t.done() 206 | }) 207 | -------------------------------------------------------------------------------- /test/util.js: -------------------------------------------------------------------------------- 1 | 'use strict' 2 | 3 | const test = require('tap').test 4 | 5 | test('promisify with existing util.promisify', t => { 6 | const promisify = require('../util.js').promisify 7 | const util = require('util') 8 | const origProm = util.promisify 9 | util.promisify = x => x 10 | t.equal(promisify('success'), 'success', 'used existing promisify fn') 11 | util.promisify = origProm 12 | t.done() 13 | }) 14 | 15 | test('promisify without existing util.promisify', t => { 16 | const promisify = require('../util.js').promisify 17 | const util = require('util') 18 | const origProm = util.promisify 19 | util.promisify = null 20 | const promisified = promisify((a, cb) => { 21 | if (a) { 22 | cb(null, a) 23 | } else { 24 | cb(new Error('fail')) 25 | } 26 | }) 27 | const p = promisified('yay') 28 | util.promisify = origProm 29 | t.ok(p.then, 'got a thenable') 30 | return p.then(val => { 31 | t.equal(val, 'yay', 'value passed through successfully') 32 | return promisified(false).then(() => { 33 | throw new Error('should have failed') 34 | }, err => { 35 | t.equal(err.message, 'fail', 'got the error!') 36 | }) 37 | }) 38 | }) 39 | -------------------------------------------------------------------------------- /test/util/npx-bin-inherit-stdio.js: -------------------------------------------------------------------------------- 1 | #!/usr/bin/env node 2 | 3 | const npx = require('../../index.js') 4 | const path = require('path') 5 | 6 | const NPM_PATH = path.join(__dirname, '../..', 'node_modules', 'npm', 'bin', 'npm-cli.js') 7 | 8 | const npxOpts = Object.assign({}, npx.parseArgs(process.argv, NPM_PATH), { 9 | installerStdio: 'inherit' 10 | }) 11 | npx(npxOpts) 12 | -------------------------------------------------------------------------------- /test/util/npx-bin.js: -------------------------------------------------------------------------------- 1 | #!/usr/bin/env node 2 | 3 | const npx = require('../../index.js') 4 | const path = require('path') 5 | 6 | const NPM_PATH = path.join(__dirname, '../..', 'node_modules', 'npm', 'bin', 'npm-cli.js') 7 | 8 | npx(npx.parseArgs(process.argv, NPM_PATH)) 9 | -------------------------------------------------------------------------------- /test/util/test-dir.js: -------------------------------------------------------------------------------- 1 | 'use strict' 2 | 3 | const mkdirp = require('mkdirp') 4 | const path = require('path') 5 | const rimraf = require('rimraf') 6 | const tap = require('tap') 7 | 8 | const cacheDir = path.resolve(__dirname, '../cache') 9 | 10 | module.exports = testDir 11 | function testDir (filename) { 12 | const base = path.basename(filename, '.js') 13 | const dir = path.join(cacheDir, base) 14 | tap.beforeEach(cb => { 15 | reset(dir, err => { 16 | if (err) { throw err } 17 | cb() 18 | }) 19 | }) 20 | if (!process.env.KEEPCACHE) { 21 | tap.tearDown(() => { 22 | process.chdir(__dirname) 23 | // This is ok cause this is the last 24 | // thing to run in the process 25 | rimraf(dir, () => {}) 26 | }) 27 | } 28 | return dir 29 | } 30 | 31 | module.exports.reset = reset 32 | function reset (testDir, cb) { 33 | process.chdir(__dirname) 34 | rimraf(testDir, function (err) { 35 | if (err) { return cb(err) } 36 | mkdirp(testDir, function (err) { 37 | if (err) { return cb(err) } 38 | process.chdir(testDir) 39 | cb() 40 | }) 41 | }) 42 | } 43 | -------------------------------------------------------------------------------- /util.js: -------------------------------------------------------------------------------- 1 | 'use strict' 2 | 3 | module.exports.promisify = promisify 4 | function promisify (f) { 5 | const util = require('util') 6 | if (util.promisify) { 7 | return util.promisify(f) 8 | } else { 9 | return function () { 10 | return new Promise((resolve, reject) => { 11 | f.apply(this, [].slice.call(arguments).concat((err, val) => { 12 | err ? reject(err) : resolve(val) 13 | })) 14 | }) 15 | } 16 | } 17 | } 18 | -------------------------------------------------------------------------------- /y.js: -------------------------------------------------------------------------------- 1 | 'use strict' 2 | 3 | const path = require('path') 4 | const yargs = require('yargs') 5 | const y18n = require('y18n')({ 6 | directory: path.join(__dirname, 'locales'), 7 | locale: yargs.locale(), 8 | updateFiles: process.env.NPX_UPDATE_LOCALE_FILES === 'true' 9 | }) 10 | 11 | module.exports = yTag 12 | function yTag (parts) { 13 | let str = '' 14 | parts.forEach((part, i) => { 15 | str += part 16 | if (arguments.length > i + 1) { 17 | str += '%s' 18 | } 19 | }) 20 | return y18n.__.apply(null, [str].concat([].slice.call(arguments, 1))) 21 | } 22 | --------------------------------------------------------------------------------