simple-package-meta

0.0.3 • Public • Published

simple-package-meta

standard-readme compliant Semantic Versioning 2.0.0 Conventional Commits License ci Coverage Status npm

Easy access to information about the running package.

Table of Contents

Background

A simple sort of convenience, sort of learning ECMAscript module package which takes a URL or an object like from import.meta and returns an object with information about the file like its name, version, directories and the nearest package.json.

Install

Using pnpm:

pnpm add --save simple-package-meta

It can, of course, also be installed by NPM or Yarn using the normal methods.

Usage

import getPackageMeta from 'simple-package-meta'; //The default is just the getPackageMeta function
import * as PackageMetaNS from 'simple-package-meta'; //The whole namespace

var meta_info = getPackageMeta( import.meta ); //Same as PackageMetaNS.getPackageMeta

API

The package comprises a single constructor and two functions.

new PackageMeta( object ); //Can take either a URL string, a URL object or an `import.meta`-like object

This creates a new PackageMeta object albeit lacking some information which requires blocking operations; this is made available by importing the entire module namespace with the name PackageMetaNS.PackageMeta() and is intended mainly just for debugging or extending the object as generally you're better off using one of the following helper functions.

getPackageMeta( object )

The default export, this asynchronously returns a complete PackageMeta object of the structure:

{
	name: '',
	version: '',
	packageJSON: {},
	url: '',
	filename: '',
	dirname: '',
	paths: {
		packageDirectory: '',
		data: '',
		config: '',
		cache: '',
		log: '',
		temp: ''
	}
}
PackageMetaNS.getPackageMetaSync( object )

Same as above except synchronous.

Contributing

Changes are tracked in CHANGELOG.md.

License

MIT ©2022 Anadian

SEE LICENSE IN LICENSE

Creative Commons LicenseThis project's documentation is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

Package Sidebar

Install

npm i simple-package-meta

Weekly Downloads

322

Version

0.0.3

License

MIT

Unpacked Size

120 kB

Total Files

9

Last publish

Collaborators

  • anad