Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bendingbender/yarpm
CLI tool to run npm scripts with either npm, pnpm, or yarn, depending on how it was started
https://github.com/bendingbender/yarpm
cli cross-platform nodejs npm npm-package npm-scripts pnpm yarn
Last synced: 17 days ago
JSON representation
CLI tool to run npm scripts with either npm, pnpm, or yarn, depending on how it was started
- Host: GitHub
- URL: https://github.com/bendingbender/yarpm
- Owner: BendingBender
- License: mit
- Created: 2017-02-17T13:56:59.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2022-12-27T10:57:04.000Z (almost 2 years ago)
- Last Synced: 2024-10-15T09:57:12.972Z (22 days ago)
- Topics: cli, cross-platform, nodejs, npm, npm-package, npm-scripts, pnpm, yarn
- Language: JavaScript
- Homepage:
- Size: 101 KB
- Stars: 44
- Watchers: 2
- Forks: 9
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# yarpm
[![NPM version][npm-version]][npm-url]
[![NPM downloads][npm-downloads]][npm-url]
[![NPM total downloads][npm-total-downloads]][npm-url]
[![Test results][github-actions-tests]][github-actions-tests-url]
## Summary
A CLI tool to run npm scripts with either `npm`, `pnpm` or `yarn`, depending on how it was started. Useful for setups
where some team members use `npm` while others use `pnpm` or `yarn`, especially when Windows and Unix-like systems are
used across the team.
This tool is a helper to run scripts from `package.json`. Just substitute all `npm`, `pnpm` or `yarn` calls with `yarpm`
and you're good to go:
```json
{
"scripts": {
"start": "yarpm run build",
"build": "tsc index.ts"
}
}
```
When running the `start` script with `yarn start`, the dependent `build` script will be spawned with `yarn`:
```bash
~/test$ yarn start
yarn start v1.22.5
$ yarpm run build
$ tsc index.ts
✨ Done in 2.27s.
```
Running the same script with `npm start` will result in the dependent `build` being run with `npm`:
```bash
~/test$ npm start
> [email protected] start /home/me/test
> yarpm run build
> [email protected] build /home/me/test
> tsc index.ts
```
## What this tool is _not_
This tool is not meant to be an abstraction layer for calling `npm`, `pnpm` or `yarn`. It will pass **all** arguments
it receives unfiltered to the chosen package manager. You'll have to make sure that the package manager commands you use
are compatible with all the package managers you want your commands to work with.
## Installation
```bash
$ npm install yarpm --save-dev
# or
$ pnpm add yarpm --save-dev
# or
$ yarn add yarpm --dev
```
## CLI Commands
The `yarpm` package provides 3 CLI commands:
- [yarpm](#yarpm-1)
- [yarpm-pnpm](#yarpm-pnpm)
- [yarpm-yarn](#yarpm-yarn)
The main command is `yarpm`.
### yarpm
This command is an in-place substitute for places in `package.json` where `npm`, `pnpm` or `yarn` is being used
explicitly. It reads the `npm_execpath` environment variable to determine the path to the currently used package
manager. This env var is only set when running `yarpm` as a script. If `yarpm` is used without being embedded
in a script, it will **always** choose `npm`.
### yarpm-pnpm
This command can be used in places where you are not in control of how your script is being started, for example when
using `husky` to run a script as a git hook. This script will **always** prefer `pnpm` over `npm` unless `pnpm` is not
available. Only then will it fall back to `npm`.
### yarpm-yarn
This command can be used in places where you are not in control of how your script is being started, for example when
using `husky` to run a script as a git hook. This script will **always** prefer `yarn` over `npm` unless `yarn` is not
available. Only then will it fall back to `npm`.
## Node API
The `yarpm` package provides a node API.
```js
const yarpm = require('yarpm');
const promise = yarpm(argv, options);
```
- **argv** `string[]` -- The argument list to pass to npm/pnpm/yarn.
- **options** `object|undefined`
- **options.npmPath** `string` -
The path to npm/pnpm/yarn.
Default is `process.env.npm_execpath` if set, `npm` otherwise.
- **options.env** `object` -
Sets the environment key-value pairs, replaces the default usage of process.env to spawn child process.
- **options.stdin** `stream.Readable|null` --
A readable stream to send messages to stdin of child process.
If this is `null` or `undefined`, ignores it.
If this is `process.stdin`, inherits it.
Otherwise, makes a pipe.
Default is `null`.
Set to `process.stdin` in order to send from stdin.
- **options.stdout** `stream.Writable|null` --
A writable stream to receive messages from stdout of child process.
If this is `null` or `undefined`, cannot send.
If this is `process.stdout`, inherits it.
Otherwise, makes a pipe.
Default is `null`.
Set to `process.stdout` in order to print to stdout.
- **options.stderr** `stream.Writable|null` --
A writable stream to receive messages from stderr of child process.
If this is `null` or `undefined`, cannot send.
If this is `process.stderr`, inherits it.
Otherwise, makes a pipe.
Default is `null`.
Set to `process.stderr` in order to print to stderr.
`yarpm` returns a promise will be _resolved_ when the spawned process exits, **_regardless of the exit code_**.
The promise will be _rejected_ in case of an internal error inside of `yarpm`.
The promise is resolved with an object with the following 2 properties: `spawnArgs` and `code`.
The `spawnArgs` property contains the array of parameters that were passed to spawn the sub-process.
The `code` property is the exit code of the sub-process.
```js
yarpm(['install']).then((result) => {
console.log(`${result.spawnArgs} -- ${result.code}`);
// if executed as a package.json script via yarn: /usr/share/yarn/bin/yarn.js,install -- 0
});
```
## Changelog
https://github.com/BendingBender/yarpm/blob/master/CHANGELOG.md
## Contributing
Clone the repo and make a pull request. Thank you for contributing!
### Bug Reports or Feature Requests
Please use GitHub Issues.
## License
[MIT](https://github.com/BendingBender/yarpm/blob/master/LICENSE)
[npm-url]: https://www.npmjs.com/package/yarpm
[npm-version]: https://shields.io/npm/v/yarpm.svg
[npm-downloads]: https://shields.io/npm/dm/yarpm.svg
[npm-total-downloads]: https://shields.io/npm/dt/yarpm?label=total+downloads
[github-actions-tests]: https://img.shields.io/github/actions/workflow/status/BendingBender/yarpm/tests.yml?branch=master
[github-actions-tests-url]: https://github.com/BendingBender/yarpm/actions?query=workflow%3A%22Run+Tests%22