Package Exports

simple-package-meta
simple-package-meta/source/main.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (simple-package-meta) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

simple-package-meta

Easy access to information about the running package.

Background
Install
Usage
API
Contributing
License

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

SEE LICENSE IN LICENSE

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