read-package-names

Read package names (including scoped packages) from a directory.

• Synopsis
• Details
• API
  • Functions
    • default

Synopsis

await readPackageNames("node_modules"); // ["pg-structure", "@babel/runtime", ...]
await readPackageNames("node_modules", { scope: "babel" }); // ["@babel/runtime", "@babel/template", ...]
await readPackageNames("node_modules", { prefix: "pg" }); // ["pg-structure", "pg-generator", "@user/pg-promise", ...]
await readPackageNames("node_modules", { scope: "user", prefix: "pg" }); // ["@user/pg-promise", ...]

Details

Reads all package names in a directory by reading all entries in the given directory and all sub entries in directories starting with the "@" sign.

API

Functions

default

▸ default(cwd: string, options?: { prefix?: string | string[] ; scope?: string | string[] ; silent?: boolean }): Promise<string[]>

Reads all package names from a directory.

Example

await readPackageNames("node_modules"); // ["pg-structure", "@babel/runtime", ...]
await readPackageNames("node_modules", { scope: "babel" }); // ["@babel/runtime", "@babel/template", ...]
await readScopedPackageNames("node_modules", { scope: "not-found" }); // []
await readScopedPackageNames("node_modules", { scope: "not-found", silent: false }); // Throws `ENOENT`
await readPackageNames("node_modules", { prefix: "pg" }); // ["pg-structure", "pg-generator", "@user/pg-promise", ...]

Parameters:

| Name | Type | Description | | :---------------- | :--------------------- | :------------------------------------------------------------------------------------------------------------------------------ | | cwd | string | is the directory to read package names from. | | options | object | are options. | | options.prefix? | string | string[] | reads only packages beginning with a prefix or one of the prefixes. Prefix is joined with a dash (e.g. "pg" -> "pg-structure"). | | options.scope? | string | string[] | reads only packages from a scope or one of the scopes. | | options.silent? | boolean | prevents errors caused by not-found directories. |

Returns: Promise<string[]>

the list of package names including scoped packages.

Defined in: read-package-names.ts:95