{"_id":"fined","_rev":"1832041","name":"fined","description":"Find a file given a declaration of locations.","dist-tags":{"latest":"2.0.0"},"maintainers":[{"name":"phated","email":"blaine.bublitz@gmail.com"}],"time":{"modified":"2021-12-02T01:56:18.000Z","created":"2016-06-16T00:22:00.735Z","2.0.0":"2021-10-31T19:57:36.721Z","1.2.0":"2019-04-21T13:15:21.480Z","1.1.1":"2018-12-10T21:05:00.117Z","1.1.0":"2017-06-18T19:45:42.755Z","1.0.2":"2016-10-05T22:10:48.684Z","1.0.1":"2016-06-19T01:01:34.307Z","1.0.0":"2016-06-16T00:22:00.735Z"},"users":{},"author":{"name":"Gulp Team","email":"team@gulpjs.com","url":"https://gulpjs.com/"},"repository":{"type":"git","url":"git+https://github.com/gulpjs/fined.git"},"versions":{"2.0.0":{"name":"fined","version":"2.0.0","description":"Find a file given a declaration of locations.","author":{"name":"Gulp Team","email":"team@gulpjs.com","url":"https://gulpjs.com/"},"contributors":[{"name":"Takayuki Sato","email":"sttk.xslet@gmail.com"},{"name":"Blaine Bublitz","email":"blaine.bublitz@gmail.com"}],"repository":{"type":"git","url":"git+https://github.com/gulpjs/fined.git"},"license":"MIT","engines":{"node":">= 10.13.0"},"main":"index.js","scripts":{"lint":"eslint .","pretest":"npm run lint","test":"nyc mocha --async-only"},"dependencies":{"expand-tilde":"^2.0.2","is-plain-object":"^5.0.0","object.defaults":"^1.1.0","object.pick":"^1.3.0","parse-filepath":"^1.0.2"},"devDependencies":{"eslint":"^7.32.0","eslint-config-gulp":"^5.0.1","eslint-plugin-node":"^11.1.0","expect":"^27.3.1","mocha":"^8.4.0","nyc":"^15.1.0"},"nyc":{"reporter":["lcov","text-summary"]},"prettier":{"singleQuote":true},"keywords":["find","lookup","config"],"gitHead":"5e810a6ad3320b3bfac72e6284aafc2ac01cf213","bugs":{"url":"https://github.com/gulpjs/fined/issues"},"homepage":"https://github.com/gulpjs/fined#readme","_id":"fined@2.0.0","_nodeVersion":"14.18.0","_npmVersion":"7.24.2","dist":{"shasum":"6846563ed96879ce6de6c85c715c42250f8d8089","size":3419,"noattachment":false,"key":"/fined/-/fined-2.0.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/fined/download/fined-2.0.0.tgz"},"_npmUser":{"name":"phated","email":"blaine.bublitz@gmail.com"},"directories":{},"maintainers":[{"name":"phated","email":"blaine.bublitz@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/fined_2.0.0_1635710256532_0.0651638656937017"},"_hasShrinkwrap":false,"publish_time":1635710256721,"_cnpm_publish_time":1635710256721},"1.2.0":{"name":"fined","version":"1.2.0","description":"Find a file given a declaration of locations.","author":{"name":"Gulp Team","email":"team@gulpjs.com","url":"http://gulpjs.com/"},"contributors":[{"name":"Takayuki Sato","email":"sttk.xslet@gmail.com"},{"name":"Blaine Bublitz","email":"blaine.bublitz@gmail.com"}],"repository":{"type":"git","url":"git+https://github.com/gulpjs/fined.git"},"license":"MIT","engines":{"node":">= 0.10"},"main":"index.js","scripts":{"lint":"eslint .","pretest":"npm run lint","test":"mocha --async-only","cover":"istanbul cover _mocha --report lcovonly","coveralls":"npm run cover && istanbul-coveralls"},"dependencies":{"expand-tilde":"^2.0.2","is-plain-object":"^2.0.3","object.defaults":"^1.1.0","object.pick":"^1.2.0","parse-filepath":"^1.0.1"},"devDependencies":{"eslint":"^2.13.0","eslint-config-gulp":"^3.0.1","expect":"^1.20.2","istanbul":"^0.4.3","istanbul-coveralls":"^1.0.3","mocha":"^3.5.3"},"keywords":["find","lookup","config"],"gitHead":"936f3ab1a950196d43923aef84ecf5f90f95ac92","bugs":{"url":"https://github.com/gulpjs/fined/issues"},"homepage":"https://github.com/gulpjs/fined#readme","_id":"fined@1.2.0","_npmVersion":"6.4.1","_nodeVersion":"10.15.1","_npmUser":{"name":"phated","email":"blaine.bublitz@gmail.com"},"dist":{"shasum":"d00beccf1aa2b475d16d423b0238b713a2c4a37b","size":3453,"noattachment":false,"key":"/fined/-/fined-1.2.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/fined/download/fined-1.2.0.tgz"},"maintainers":[{"name":"phated","email":"blaine.bublitz@gmail.com"}],"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/fined_1.2.0_1555852521341_0.6117296652106905"},"_hasShrinkwrap":false,"publish_time":1555852521480,"_cnpm_publish_time":1555852521480},"1.1.1":{"name":"fined","version":"1.1.1","description":"Find a file given a declaration of locations.","author":{"name":"Gulp Team","email":"team@gulpjs.com","url":"http://gulpjs.com/"},"contributors":[{"name":"Takayuki Sato","email":"sttk.xslet@gmail.com"},{"name":"Blaine Bublitz","email":"blaine.bublitz@gmail.com"}],"repository":{"type":"git","url":"git+https://github.com/gulpjs/fined.git"},"license":"MIT","engines":{"node":">= 0.10"},"main":"index.js","scripts":{"lint":"eslint .","pretest":"npm run lint","test":"mocha --async-only","cover":"istanbul cover _mocha --report lcovonly","coveralls":"npm run cover && istanbul-coveralls"},"dependencies":{"expand-tilde":"^2.0.2","is-plain-object":"^2.0.3","object.defaults":"^1.1.0","object.pick":"^1.2.0","parse-filepath":"^1.0.1"},"devDependencies":{"eslint":"^2.13.0","eslint-config-gulp":"^3.0.1","expect":"^1.20.2","istanbul":"^0.4.3","istanbul-coveralls":"^1.0.3","mocha":"^3.5.3"},"keywords":["find","lookup","config"],"gitHead":"704dc9fbbb1f8f1258725d74f38cbd0f51e21dce","bugs":{"url":"https://github.com/gulpjs/fined/issues"},"homepage":"https://github.com/gulpjs/fined#readme","_id":"fined@1.1.1","_npmVersion":"5.6.0","_nodeVersion":"8.11.1","_npmUser":{"name":"phated","email":"blaine.bublitz@gmail.com"},"dist":{"shasum":"95d88ff329123dd1a6950fdfcd321f746271e01f","size":3419,"noattachment":false,"key":"/fined/-/fined-1.1.1.tgz","tarball":"http://registry.cnpm.dingdandao.com/fined/download/fined-1.1.1.tgz"},"maintainers":[{"name":"phated","email":"blaine.bublitz@gmail.com"}],"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/fined_1.1.1_1544475899977_0.4561961895419131"},"_hasShrinkwrap":false,"publish_time":1544475900117,"_cnpm_publish_time":1544475900117},"1.1.0":{"name":"fined","version":"1.1.0","description":"Find a file given a declaration of locations","author":{"name":"JS CLI Team","url":"https://github.com/js-cli"},"contributors":[{"name":"Takayuki Sato","email":"sttk.xslet@gmail.com"},{"name":"Blaine Bublitz","email":"blaine.bublitz@gmail.com"}],"repository":{"type":"git","url":"git+https://github.com/js-cli/fined.git"},"license":"MIT","engines":{"node":">= 0.10"},"main":"index.js","files":["index.js","LICENSE"],"scripts":{"lint":"eslint . && jscs .","pretest":"npm run lint","test":"mocha --async-only","cover":"istanbul cover _mocha --report lcovonly","coveralls":"npm run cover && istanbul-coveralls"},"dependencies":{"expand-tilde":"^2.0.2","is-plain-object":"^2.0.3","object.defaults":"^1.1.0","object.pick":"^1.2.0","parse-filepath":"^1.0.1"},"devDependencies":{"eslint":"^1.7.3","eslint-config-gulp":"^2.0.0","expect":"^1.19.0","istanbul":"^0.4.3","istanbul-coveralls":"^1.0.3","jscs":"^2.3.5","jscs-preset-gulp":"^1.0.0","mocha":"^2.4.5"},"keywords":[],"gitHead":"02513d1f0fad7412d2d29349ff8f55e87156b7db","bugs":{"url":"https://github.com/js-cli/fined/issues"},"homepage":"https://github.com/js-cli/fined#readme","_id":"fined@1.1.0","_shasum":"b37dc844b76a2f5e7081e884f7c0ae344f153476","_from":".","_npmVersion":"2.15.2","_nodeVersion":"0.10.41","_npmUser":{"name":"phated","email":"blaine.bublitz@gmail.com"},"maintainers":[{"name":"phated","email":"blaine.bublitz@gmail.com"}],"dist":{"shasum":"b37dc844b76a2f5e7081e884f7c0ae344f153476","size":3215,"noattachment":false,"key":"/fined/-/fined-1.1.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/fined/download/fined-1.1.0.tgz"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/fined-1.1.0.tgz_1497815142655_0.9839172274805605"},"directories":{},"publish_time":1497815142755,"_hasShrinkwrap":false,"_cnpm_publish_time":1497815142755},"1.0.2":{"name":"fined","version":"1.0.2","description":"Find a file given a declaration of locations","author":{"name":"JS CLI Team","url":"https://github.com/js-cli"},"contributors":[{"name":"Takayuki Sato","email":"t110000508260@yahoo.co.jp"},{"name":"Blaine Bublitz","email":"blaine.bublitz@gmail.com"}],"repository":{"type":"git","url":"git+https://github.com/js-cli/fined.git"},"license":"MIT","engines":{"node":">= 0.10"},"main":"index.js","files":["index.js","LICENSE"],"scripts":{"lint":"eslint . && jscs index.js test/","pretest":"npm run lint","test":"mocha --async-only","cover":"istanbul cover _mocha --report lcovonly","coveralls":"npm run cover && istanbul-coveralls"},"dependencies":{"expand-tilde":"^1.2.1","lodash.assignwith":"^4.0.7","lodash.isempty":"^4.2.1","lodash.isplainobject":"^4.0.4","lodash.isstring":"^4.0.1","lodash.pick":"^4.2.1","parse-filepath":"^1.0.1"},"devDependencies":{"eslint":"^1.7.3","eslint-config-gulp":"^2.0.0","expect":"^1.19.0","istanbul":"^0.4.3","istanbul-coveralls":"^1.0.3","jscs":"^2.3.5","jscs-preset-gulp":"^1.0.0","mocha":"^2.4.5"},"keywords":[],"gitHead":"850b8dde2e520878a7ff62b9a6b4a45c82d19889","bugs":{"url":"https://github.com/js-cli/fined/issues"},"homepage":"https://github.com/js-cli/fined#readme","_id":"fined@1.0.2","_shasum":"5b28424b760d7598960b7ef8480dff8ad3660e97","_from":".","_npmVersion":"2.15.2","_nodeVersion":"0.10.41","_npmUser":{"name":"phated","email":"blaine.bublitz@gmail.com"},"maintainers":[{"name":"phated","email":"blaine.bublitz@gmail.com"}],"dist":{"shasum":"5b28424b760d7598960b7ef8480dff8ad3660e97","size":3231,"noattachment":false,"key":"/fined/-/fined-1.0.2.tgz","tarball":"http://registry.cnpm.dingdandao.com/fined/download/fined-1.0.2.tgz"},"_npmOperationalInternal":{"host":"packages-12-west.internal.npmjs.com","tmp":"tmp/fined-1.0.2.tgz_1475705448430_0.6886874639894813"},"directories":{},"publish_time":1475705448684,"_cnpm_publish_time":1475705448684,"_hasShrinkwrap":false},"1.0.1":{"name":"fined","version":"1.0.1","description":"Find a file given a declaration of locations","author":{"name":"JS CLI Team","url":"https://github.com/js-cli"},"contributors":[{"name":"Takayuki Sato","email":"t110000508260@yahoo.co.jp"},{"name":"Blaine Bublitz","email":"blaine.bublitz@gmail.com"}],"repository":{"type":"git","url":"git+https://github.com/js-cli/fined.git"},"license":"MIT","engines":{"node":">= 0.10"},"main":"index.js","files":["index.js","LICENSE"],"scripts":{"lint":"eslint . && jscs index.js test/","pretest":"npm run lint","test":"mocha --async-only","cover":"istanbul cover _mocha --report lcovonly","coveralls":"npm run cover && istanbul-coveralls"},"dependencies":{"expand-tilde":"^1.2.1","lodash.assignwith":"^4.0.7","lodash.isarray":"^4.0.0","lodash.isempty":"^4.2.1","lodash.isplainobject":"^4.0.4","lodash.isstring":"^4.0.1","lodash.pick":"^4.2.1","parse-filepath":"^1.0.1"},"devDependencies":{"eslint":"^1.7.3","eslint-config-gulp":"^2.0.0","expect":"^1.19.0","istanbul":"^0.4.3","istanbul-coveralls":"^1.0.3","jscs":"^2.3.5","jscs-preset-gulp":"^1.0.0","mocha":"^2.4.5"},"keywords":[],"gitHead":"3ce625446110cb0942b3787e91541bd1e35cd804","bugs":{"url":"https://github.com/js-cli/fined/issues"},"homepage":"https://github.com/js-cli/fined#readme","_id":"fined@1.0.1","_shasum":"c48af9ab5a8e0f400a0375e84154c37674dabfd4","_from":".","_npmVersion":"2.15.2","_nodeVersion":"0.10.41","_npmUser":{"name":"phated","email":"blaine.bublitz@gmail.com"},"maintainers":[{"name":"phated","email":"blaine.bublitz@gmail.com"}],"dist":{"shasum":"c48af9ab5a8e0f400a0375e84154c37674dabfd4","size":3228,"noattachment":false,"key":"/fined/-/fined-1.0.1.tgz","tarball":"http://registry.cnpm.dingdandao.com/fined/download/fined-1.0.1.tgz"},"_npmOperationalInternal":{"host":"packages-16-east.internal.npmjs.com","tmp":"tmp/fined-1.0.1.tgz_1466298091660_0.526061441283673"},"directories":{},"publish_time":1466298094307,"_cnpm_publish_time":1466298094307,"_hasShrinkwrap":false},"1.0.0":{"name":"fined","version":"1.0.0","description":"Find a file given a declaration of locations","author":{"name":"JS CLI Team","url":"https://github.com/js-cli"},"contributors":[{"name":"Takayuki Sato","email":"t110000508260@yahoo.co.jp"},{"name":"Blaine Bublitz","email":"blaine.bublitz@gmail.com"}],"repository":{"type":"git","url":"git+https://github.com/js-cli/fined.git"},"license":"MIT","engines":{"node":">= 0.10"},"main":"index.js","files":["index.js","LICENSE"],"scripts":{"lint":"eslint . && jscs index.js test/","pretest":"npm run lint","test":"mocha --async-only","cover":"istanbul cover _mocha --report lcovonly","coveralls":"npm run cover && istanbul-coveralls"},"dependencies":{"expand-tilde":"^1.2.1","lodash.assignwith":"^4.0.7","lodash.isarray":"^4.0.0","lodash.isempty":"^4.2.1","lodash.isplainobject":"^4.0.4","lodash.isstring":"^4.0.1","lodash.pick":"^4.2.1","parse-filepath":"^1.0.1"},"devDependencies":{"eslint":"^1.7.3","eslint-config-gulp":"^2.0.0","expect":"^1.19.0","istanbul":"^0.4.3","istanbul-coveralls":"^1.0.3","jscs":"^2.3.5","jscs-preset-gulp":"^1.0.0","mocha":"^2.4.5"},"keywords":[],"gitHead":"de8a00e67995e458c2caab6b328480d42044f36f","bugs":{"url":"https://github.com/js-cli/fined/issues"},"homepage":"https://github.com/js-cli/fined#readme","_id":"fined@1.0.0","_shasum":"c6d6ee6438d9949c2e75f66d346384d1b3a631a4","_from":".","_npmVersion":"2.15.2","_nodeVersion":"0.10.41","_npmUser":{"name":"phated","email":"blaine.bublitz@gmail.com"},"maintainers":[{"name":"phated","email":"blaine.bublitz@gmail.com"}],"dist":{"shasum":"c6d6ee6438d9949c2e75f66d346384d1b3a631a4","size":3229,"noattachment":false,"key":"/fined/-/fined-1.0.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/fined/download/fined-1.0.0.tgz"},"_npmOperationalInternal":{"host":"packages-12-west.internal.npmjs.com","tmp":"tmp/fined-1.0.0.tgz_1466036520327_0.7560944678261876"},"directories":{},"publish_time":1466036520735,"_cnpm_publish_time":1466036520735,"_hasShrinkwrap":false}},"readme":"<p align=\"center\">\n  <a href=\"http://gulpjs.com\">\n    <img height=\"257\" width=\"114\" src=\"https://raw.githubusercontent.com/gulpjs/artwork/master/gulp-2x.png\">\n  </a>\n</p>\n\n# fined\n\n[![NPM version][npm-image]][npm-url] [![Downloads][downloads-image]][npm-url] [![Build Status][ci-image]][ci-url] [![Coveralls Status][coveralls-image]][coveralls-url]\n\nFind a file given a declaration of locations.\n\n## Usage\n\n```js\nvar fined = require('fined');\n\nfined({ path: 'path/to/file', extensions: ['.js', '.json'] });\n// => { path: '/absolute/path/to/file.js', extension: '.js' }  (if file exists)\n// => null  (if file does not exist)\n\nvar opts = {\n  name: '.app',\n  cwd: '.',\n  extensions: {\n    rc: 'default-rc-loader',\n    '.yml': 'default-yml-loader',\n  },\n};\n\nfined({ path: '.' }, opts);\n// => { path: '/absolute/of/cwd/.app.yml', extension: { '.yml': 'default-yml-loader' } }\n\nfined({ path: '~', extensions: { rc: 'some-special-rc-loader' } }, opts);\n// => { path: '/User/home/.apprc', extension: { 'rc': 'some-special-rc-loader' } }\n```\n\n## API\n\n### fined(pathObj, opts) => object | null\n\n#### Arguments:\n\n- **pathObj** [string | object] : a path setting for finding a file.\n- **opts** [object] : a plain object supplements `pathObj`.\n\n  `pathObj` and `opts` can have same properties:\n\n  - **path** [string] : a path string.\n  - **name** [string] : a basename.\n  - **extensions**: [string | array | object] : extensions.\n  - **cwd**: a base directory of `path` and for finding up.\n  - **findUp**: [boolean] : a flag to find up.\n\n#### Return:\n\nThis function returns a plain object which consists of following properties if a file exists otherwise null.\n\n- **path** : an absolute path\n- **extension** : a string or a plain object of extension.\n\n## License\n\nMIT\n\n<!-- prettier-ignore-start -->\n[downloads-image]: https://img.shields.io/npm/dm/fined.svg?style=flat-square\n[npm-url]: https://www.npmjs.com/package/fined\n[npm-image]: https://img.shields.io/npm/v/fined.svg?style=flat-square\n\n[ci-url]: https://github.com/gulpjs/fined/actions?query=workflow:dev\n[ci-image]: https://img.shields.io/github/workflow/status/gulpjs/fined/dev?style=flat-square\n\n[coveralls-url]: https://coveralls.io/r/gulpjs/fined\n[coveralls-image]: https://img.shields.io/coveralls/gulpjs/fined/master.svg\n<!-- prettier-ignore-end -->\n","_attachments":{},"homepage":"https://github.com/gulpjs/fined#readme","bugs":{"url":"https://github.com/gulpjs/fined/issues"},"license":"MIT"}