{"bugs":{"url":"https://github.com/zkochan/npm-package-arg/issues"},"dist":{"shasum":"8f4d582be16532fc15313a6bc7f0066e1dc0abac","tarball":"https://registry.npmjs.org/@zkochan/npm-package-arg/-/npm-package-arg-2.0.0.tgz","fileCount":4,"integrity":"sha512-v42ycaFkH8tYQfxtmnxvMdC3zRB75lwPyfiRy2Rz7F2pv3gqAsSHXHUYbmU93SzjIiHLNtj5UhoYFZwkZP22yw==","signatures":[{"sig":"MEQCIGGiM8tPlZrn93tMvWk21nB/Fp6gv+4UqcTtO34YHRfQAiA73NuGKImnfmW/G1nIh6GZovkjlNjcQoBOZUX67FL01Q==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":13752,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJerdQ2CRA9TVsSAnZWagAAYZ8P/1KbG30jjLYU4is8OaO+\n1fcqs4WYOLAuQ09YUrGW4lMVcwCCkp+dMqdgyKCjOsx/gZVmQd/sjkYVLMYy\n/X5ASVU2w8Z8VNA10aNGvZrlBfM3AqOParFbZZh36h3zis6J/TRb9TnQ8N4H\n8iPB88bPXTmCJ95qUg/Jttrllg08RifU9JbuHuIoDMAsmYEf9zX3tux6ThxE\ncDwCvKeOu7WVqSgcA368Brmfr7c2i7Il0nsJqbQgSd+tT5gSYXDTZlA7VbZl\nYbF+E4Se8X69jRMtjxbcdzeu8io9tR6aT6bDhsJ89ui9fmJEGCmpg7AeYv4H\ngDOliHFuWRj/kd4K29caGNkpOIoVnnAk1Sve3iRrWsIOh5mQFev5GDYeOUpB\n6GELaLq6x8Bo7HhsuBmQkhSjFZSJHogkHCct8LDcGPboF4mqBYGKJ5rv7uOy\nnrvdd6jVeYOB+K6RRjZirs8eeSunPoErgeZoqaSJLGJp7puvBFNs9vuUVxA6\nP/RvYw+DfU4oaYpyS3pGhh55BLvVYFxxUi/BgTZTPoITjmvmzvJww3jGwpJ3\n3u+Hh+QHB4Lvvx83J2Pcs+EkwXCzbWKrFb+P246c/GG3gbVu8xxEPaA4V8UN\nGSDVlxo7hZQ6gBgmG2eFNXN6OnLur9vvUoUbD1UyTgxmzq+De7ntkbRd8NNB\nRhf8\r\n=2eDu\r\n-----END PGP SIGNATURE-----\r\n"},"main":"npa.js","name":"@zkochan/npm-package-arg","author":{"url":"http://blog.izs.me/","name":"Isaac Z. Schlueter","email":"i@izs.me"},"readme":"# @zkochan/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(\"@zkochan/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('@zkochan/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 @zkochan/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","engines":{"node":">=10.13"},"gitHead":"e276ab22578d2e98b8f300ba020d988a4221af04","license":"ISC","scripts":{"test":"standard && tap -J --coverage test/*.js"},"_npmUser":{"name":"zkochan","email":"z@kochan.io"},"homepage":"https://github.com/zkochan/npm-package-arg","repository":{"url":"git+https://github.com/zkochan/npm-package-arg.git","type":"git"},"_npmVersion":"6.14.4","description":"Parse the things that can be arguments to `npm install`","directories":{"test":"test"},"maintainers":[{"name":"zkochan","email":"z@kochan.io"}],"_nodeVersion":"12.14.1","dependencies":{"semver":"^7.3.2","hosted-git-info":"^3.0.4","validate-npm-package-name":"^3.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"tap":"^14.10.7","standard":"14.3.3"},"_npmOperationalInternal":{"tmp":"tmp/npm-package-arg_2.0.0_1588450358461_0.5815261461184185","host":"s3://npm-registry-packages"},"_id":"@zkochan/npm-package-arg@2.0.0","version":"2.0.0"}