@mnrendra/read-package

Read the package.json file from any sub-directory in your project.

Install

npm i @mnrendra/read-package

Usage

Using CommonJS:

const { readPackage, readPackageSync } = require('@mnrendra/read-package')

// Asynchronously
readPackage().then(({ name, version }) => {
  console.log('asynchronously:', name, version)
})

// Synchronously
const { name, version } = readPackageSync()
console.log('synchronously:', name, version)

Using ES Module:

import { readPackage, readPackageSync } from '@mnrendra/read-package'

// Asynchronously
readPackage().then(({ name, version }) => {
  console.log('asynchronously:', name, version)
})

// Synchronously
const { name, version } = readPackageSync()
console.log('synchronously:', name, version)

Examples

1. Read the package.json file in your development project:

Assuming your project's ~/project-name/package.json file is as follows:

{
  "name": "project-name",
  "version": "1.0.0"
}

Then, you can access and read the ~/project-name/package.json file from any directory within your project. Here are some examples:

• Read from ~/project-name/src/index.js:

const { readPackage } = require('@mnrendra/read-package')

// Synchronously
const { name, version } = readPackageSync()
console.log('synchronously:', name, version) // Output: synchronously: project-name 1.0.0

• Read from ~/project-name/src/any-directory/index.mjs:

import { readPackageSync } from '@mnrendra/read-package'

// Asynchronously
readPackage().then(({ name, version }) => {
  console.log('asynchronously:', name, version) // Output: asynchronously: project-name 1.0.0
})

2. Read the package.json file in your published module:

Assuming your module is installed in the /consumer/node_modules/module-name/ directory and the package.json file for your module located at /consumer/node_modules/module-name/package.json is as follows:

{
  "name": "module-name",
  "version": "1.0.0"
}

Then, you can access and read your package.json file from any directory within your module. Here are some examples:

• Read from /consumer/node_modules/module-name/dist/index.js:

"use strict";
const { readPackage } = require('@mnrendra/read-package');

// Synchronously
const { name, version } = readPackageSync();
console.log('synchronously:', name, version); // Output: synchronously: module-name 1.0.0

• Read from /consumer/node_modules/module-name/dist/any-directory/index.js:

"use strict";
const { readPackage } = require('@mnrendra/read-package');

// Asynchronously
readPackage().then(({ name, version }) => {
  console.log('asynchronously:', name, version); // Output: asynchronously: module-name 1.0.0
});

Types

import type {
  Package // @mnrendra/types-package
} from '@mnrendra/read-package'

• Package: @mnrendra/read-package

License

MIT

Author

@mnrendra