{"maintainers":[{"name":"phated","email":"blaine.bublitz@gmail.com"}],"keywords":[],"dist-tags":{"latest":"1.1.0"},"author":{"name":"JS CLI Team","url":"https://github.com/js-cli"},"description":"Find a file given a declaration of locations","readme":"# Fined [![Build Status][travis-img]][travis-url] [![Build Status][appveyor-img]][appveyor-url] [![Coverage][coveralls-img]][coveralls-url]\n\n> Find a file given a declaration of locations\n\n[![NPM][npm-img]][npm-url]\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\n## License\n\nMIT\n\n[npm-img]: https://nodei.co/npm/fined.png\n[npm-url]: https://nodei.co/npm/fined/\n[travis-img]: https://travis-ci.org/js-cli/fined.svg?branch=master\n[travis-url]: https://travis-ci.org/js-cli/fined\n[appveyor-img]: https://ci.appveyor.com/api/projects/status/github/js-cli/fined?branch=master&svg=true\n[appveyor-url]: https://ci.appveyor.com/project/js-cli/fined\n[coveralls-img]: https://coveralls.io/repos/github/js-cli/fined/badge.svg?branch=master\n[coveralls-url]: https://coveralls.io/github/js-cli/fined?branch=master\n","repository":{"type":"git","url":"git+https://github.com/js-cli/fined.git"},"bugs":{"url":"https://github.com/js-cli/fined/issues"},"license":"MIT","versions":{"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","tarball":"http://nexus.dui88.com:8081/nexus/content/repositories/npm-registry/fined/-/fined-1.0.0.tgz"},"_npmOperationalInternal":{"host":"packages-12-west.internal.npmjs.com","tmp":"tmp/fined-1.0.0.tgz_1466036520327_0.7560944678261876"},"directories":{}},"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","tarball":"http://nexus.dui88.com:8081/nexus/content/repositories/npm-registry/fined/-/fined-1.0.1.tgz"},"_npmOperationalInternal":{"host":"packages-16-east.internal.npmjs.com","tmp":"tmp/fined-1.0.1.tgz_1466298091660_0.526061441283673"},"directories":{}},"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","tarball":"http://nexus.dui88.com:8081/nexus/content/repositories/npm-registry/fined/-/fined-1.0.2.tgz"},"_npmOperationalInternal":{"host":"packages-12-west.internal.npmjs.com","tmp":"tmp/fined-1.0.2.tgz_1475705448430_0.6886874639894813"},"directories":{}},"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","tarball":"http://nexus.dui88.com:8081/nexus/content/repositories/npm-registry/fined/-/fined-1.1.0.tgz"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/fined-1.1.0.tgz_1497815142655_0.9839172274805605"},"directories":{}}},"name":"fined","contributors":[{"name":"Takayuki Sato","email":"sttk.xslet@gmail.com"},{"name":"Blaine Bublitz","email":"blaine.bublitz@gmail.com"}],"time":{"modified":"2017-06-18T19:45:42.755Z","created":"2016-06-16T00:22:00.735Z","1.0.0":"2016-06-16T00:22:00.735Z","1.0.1":"2016-06-19T01:01:34.307Z","1.0.2":"2016-10-05T22:10:48.684Z","1.1.0":"2017-06-18T19:45:42.755Z"},"readmeFilename":"README.md","homepage":"https://github.com/js-cli/fined#readme"}