sfcode
An Online Competing and Development Environment
|
npm-pick-manifest
is a standalone implementation of npm's semver range resolution algorithm.
$ npm install --save npm-pick-manifest
The npm-pick-manifest team enthusiastically welcomes contributions and project participation! There's a bunch of things you can do if you want to contribute! The ContributorGuide" has all the information you need for everything from reporting bugs to contributing entire new features. Please don't hesitate to jump in if you'd like to, or even ask us questions if something isn't clear.
Returns the manifest that matches selector
, or throws an error.
Packuments are anything returned by metadata URLs from the npm registry. That is, they're objects with the following shape (only fields used by npm-pick-manifest
included):
The algorithm will follow npm's algorithm for semver resolution, and only tag
, range
, and version
selectors are supported.
The function will throw ETARGET
if there was no matching manifest, and ENOVERSIONS
if the packument object has no valid versions in versions
.
If opts.defaultTag
is provided, it will be used instead of latest
. That is, if that tag matches the selector, it will be used, even if a higher available version matches the range.
If opts.enjoyBy
is provided, it should be something that can be passed to new Date(x)
, such as a Date
object or a timestamp string. It will be used to filter the selected versions such that only versions less than or equal to enjoyBy
are considered.
If opts.includeDeprecated
passed in as true, deprecated versions will be selected. By default, deprecated versions other than defaultTag
are ignored.