1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
|
{
"_args": [
[
{
"type": "tag",
"registry": true,
"raw": "npm-package-arg@latest",
"name": "npm-package-arg",
"escapedName": "npm-package-arg",
"rawSpec": "latest",
"saveSpec": null,
"fetchSpec": "latest"
},
"/Users/rebecca/code/npm"
]
],
"_from": "npm-package-arg@latest",
"_id": "npm-package-arg@5.0.1",
"_inCache": true,
"_location": "/npm-package-arg",
"_nodeVersion": "7.7.4",
"_npmOperationalInternal": {
"host": "packages-18-east.internal.npmjs.com",
"tmp": "tmp/npm-package-arg-5.0.1.tgz_1492211885788_0.7383633449207991"
},
"_npmUser": {
"name": "iarna",
"email": "me@re-becca.org"
},
"_npmVersion": "4.5.0",
"_phantomChildren": {},
"_requested": {
"type": "tag",
"registry": true,
"raw": "npm-package-arg@latest",
"name": "npm-package-arg",
"escapedName": "npm-package-arg",
"rawSpec": "latest",
"saveSpec": null,
"fetchSpec": "latest"
},
"_requiredBy": [
"#USER",
"/",
"/init-package-json",
"/npm-registry-client"
],
"_resolved": "https://registry.npmjs.org/npm-package-arg/-/npm-package-arg-5.0.1.tgz",
"_shasum": "09a816e3f45a549e3ddaf33e9bae5e7b31077872",
"_shrinkwrap": null,
"_spec": "npm-package-arg@latest",
"_where": "/Users/rebecca/code/npm",
"author": {
"name": "Isaac Z. Schlueter",
"email": "i@izs.me",
"url": "http://blog.izs.me/"
},
"bugs": {
"url": "https://github.com/npm/npm-package-arg/issues"
},
"dependencies": {
"hosted-git-info": "^2.4.2",
"osenv": "^0.1.4",
"semver": "^5.1.0",
"validate-npm-package-name": "^3.0.0"
},
"description": "Parse the things that can be arguments to `npm install`",
"devDependencies": {
"standard": "9.0.2",
"tap": "^10.3.0"
},
"directories": {
"test": "test"
},
"dist": {
"shasum": "09a816e3f45a549e3ddaf33e9bae5e7b31077872",
"tarball": "https://registry.npmjs.org/npm-package-arg/-/npm-package-arg-5.0.1.tgz"
},
"files": [
"npa.js"
],
"gitHead": "c85a786857bcc51a6587bf980d724b82d3d4151d",
"homepage": "https://github.com/npm/npm-package-arg",
"license": "ISC",
"main": "npa.js",
"maintainers": [
{
"name": "iarna",
"email": "me@re-becca.org"
},
{
"name": "isaacs",
"email": "i@izs.me"
},
{
"name": "othiym23",
"email": "ogd@aoaioxxysz.net"
},
{
"name": "zkat",
"email": "kat@sykosomatic.org"
}
],
"name": "npm-package-arg",
"optionalDependencies": {},
"readme": "# npm-package-arg\n\nParses package name and specifier passed to commands like `npm install` or\n`npm cache add`, or as found in `package.json` dependency sections.\n\n## EXAMPLES\n\n```javascript\nvar assert = require(\"assert\")\nvar npa = require(\"npm-package-arg\")\n\n// Pass in the descriptor, and it'll return an object\ntry {\n var parsed = npa(\"@bar/foo@1.2\")\n} catch (ex) {\n …\n}\n```\n\n## USING\n\n`var npa = require('npm-package-arg')`\n\n### var result = npa(*arg*[, *where*])\n\n* *arg* - a string that you might pass to `npm install`, like:\n`foo@1.2`, `@bar/foo@1.2`, `foo@user/foo`, `http://x.com/foo.tgz`,\n`git+https://github.com/user/foo`, `bitbucket:user/foo`, `foo.tar.gz`,\n`../foo/bar/` or `bar`. If the *arg* you provide doesn't have a specifier\npart, eg `foo` then the specifier will default to `latest`.\n* *where* - Optionally the path to resolve file paths relative to. Defaults to `process.cwd()`\n\n**Throws** if the package name is invalid, a dist-tag is invalid or a URL's protocol is not supported.\n\n### var result = npa.resolve(*name*, *spec*[, *where*])\n\n* *name* - The name of the module you want to install. For example: `foo` or `@bar/foo`.\n* *spec* - The specifier indicating where and how you can get this module. Something like:\n`1.2`, `^1.7.17`, `http://x.com/foo.tgz`, `git+https://github.com/user/foo`,\n`bitbucket:user/foo`, `file:foo.tar.gz` or `file:../foo/bar/`. If not\nincluded then the default is `latest`.\n* *where* - Optionally the path to resolve file paths relative to. Defaults to `process.cwd()`\n\n**Throws** if the package name is invalid, a dist-tag is invalid or a URL's protocol is not supported.\n\n## RESULT OBJECT\n\nThe objects that are returned by npm-package-arg contain the following\nkeys:\n\n* `type` - One of the following strings:\n * `git` - A git repo\n * `tag` - A tagged version, like `\"foo@latest\"`\n * `version` - A specific version number, like `\"foo@1.2.3\"`\n * `range` - A version range, like `\"foo@2.x\"`\n * `file` - A local `.tar.gz`, `.tar` or `.tgz` file.\n * `directory` - A local directory.\n * `remote` - An http url (presumably to a tgz)\n* `registry` - If true this specifier refers to a resource hosted on a\n registry. This is true for `tag`, `version` and `range` types.\n* `name` - If known, the `name` field expected in the resulting pkg.\n* `scope` - If a name is something like `@org/module` then the `scope`\n field will be set to `@org`. If it doesn't have a scoped name, then\n scope is `null`.\n* `escapedName` - A version of `name` escaped to match the npm scoped packages\n specification. Mostly used when making requests against a registry. When\n `name` is `null`, `escapedName` will also be `null`.\n* `rawSpec` - The specifier part that was parsed out in calls to `npa(arg)`,\n or the value of `spec` in calls to `npa.resolve(name, spec).\n* `saveSpec` - The normalized specifier, for saving to package.json files.\n `null` for registry dependencies.\n* `fetchSpec` - The version of the specifier to be used to fetch this\n resource. `null` for shortcuts to hosted git dependencies as there isn't\n just one URL to try with them.\n* `gitRange` - If set, this is a semver specifier to match against git tags with\n* `gitCommittish` - If set, this is the specific committish to use with a git dependency.\n* `hosted` - If `from === 'hosted'` then this will be a `hosted-git-info`\n object. This property is not included when serializing the object as\n JSON.\n* `raw` - The original un-modified string that was provided. If called as\n `npa.resolve(name, spec)` then this will be `name + '@' + spec`.\n",
"readmeFilename": "README.md",
"repository": {
"type": "git",
"url": "git+https://github.com/npm/npm-package-arg.git"
},
"scripts": {
"test": "standard && tap -J --coverage test/*.js"
},
"version": "5.0.1"
}
|
