pm-info/README.md

A simple utility to get the package manager information which used in the project

<div style="text-align: center;" align="center">

# pm-info

A simple utility to get the package manager information which used in the project

[![NPM version][npm-image]][npm-url]
[![Codacy Badge][codacy-image]][codacy-url]
[![Test coverage][codecov-image]][codecov-url]
[![npm download][download-image]][download-url]
[![License][license-image]][license-url]

[![Sonar][sonar-image]][sonar-url]

</div>

## Install

```bash
# use pnpm
$ pnpm install -D pm-info

# use yarn
$ yarn add -D pm-info

# use npm
$ npm install -D pm-info
```

## Usage

use import

```js
import { pmInfo, pmInfoSync } from 'pm-info'

pmInfo()
// or
pmInfoSync()
```

use require

```js
const { pmInfo, pmInfoSync } = require('pm-info')

pmInfo()
// or
pmInfoSync()
```

## API reference

- Usage: `pmInfo(cwd)` & `pmInfoSync(cwd)`
- Parameters:

<div class="table-prop">

| Param | Description  | Type     | Optional value | Required | Default value |
| ----- | ------------ | -------- | -------------- | -------- | ------------- |
| cwd   | running path | `string` | -              | `false`  | -             |

</div>

- Types:

```ts
declare type ModulesYML = Record<string, unknown> & {
  packageManager: string
}

declare function normalizePMSpec(pm: string): PackageManager

declare interface PackageManager {
  name: string
  version?: string
}

declare function pmInfo(cwd?: string): Promise<PackageManager | null>

declare function pmInfoSync(cwd?: string): PackageManager | null
```

- Demos:

1. simple use

```ts
import { pmInfo, pmInfoSync } from 'pm-info'

pmInfo().then(info => {
  console.log('The package manager is: ', info) // { name: 'pnpm', version: '7.26.1' } | null
})
console.log('The package manager is: ', pmInfoSync()) // { name: 'pnpm', version: '7.26.1' } | null
```

## Issues & Support

Please open an issue [here](https://github.com/saqqdy/node-kit/issues).

## License

[MIT](LICENSE)

[npm-image]: https://img.shields.io/npm/v/pm-info.svg?style=flat-square
[npm-url]: https://npmjs.org/package/pm-info
[codacy-image]: https://app.codacy.com/project/badge/Grade/f70d4880e4ad4f40aa970eb9ee9d0696
[codacy-url]: https://www.codacy.com/gh/saqqdy/pm-info/dashboard?utm_source=github.com&utm_medium=referral&utm_content=saqqdy/pm-info&utm_campaign=Badge_Grade
[codecov-image]: https://img.shields.io/codecov/c/github/saqqdy/pm-info.svg?style=flat-square
[codecov-url]: https://codecov.io/github/saqqdy/pm-info?branch=master
[download-image]: https://img.shields.io/npm/dm/pm-info.svg?style=flat-square
[download-url]: https://npmjs.org/package/pm-info
[license-image]: https://img.shields.io/badge/License-MIT-blue.svg
[license-url]: LICENSE
[sonar-image]: https://sonarcloud.io/api/project_badges/quality_gate?project=saqqdy_node-kit
[sonar-url]: https://sonarcloud.io/dashboard?id=saqqdy_node-kit