find-file-up

find-file-up

Find a file, starting with the given cwd and recursively searching up one directory until it's found (or we run out of directories). Async and sync.

Install

Install with npm

$ npm i find-file-up --save

Usage

var findFile = require('find-file-up');

async

// find `foo.txt` starting at the given directory
findFile('foo.txt', '.', function(err, fp) {
  //=> /Users/jonschlinkert/dev/find-file-up/fixtures/foo.txt
});

// search user home
findFile('foo.txt', '~/', function(err, fp) {
  //=> /Users/jonschlinkert/foo.txt
});

sync

var file = findFile.sync('foo.txt', 'a/b/c/');

Related projects

• load-module-pkg: Load the package.json for any project currently installed in node_modules. | homepage
• load-pkg: Loads the package.json from the root of the user's current project. | homepage
• look-up: Faster drop-in replacement for find-up and findup-sync. | homepage
• module-root: Get the resolved path the root directory of any npm package locally installed in node_modules. | homepage

Running tests

Install dev dependencies:

$ npm i -d && npm test

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Author

Jon Schlinkert

• github/jonschlinkert
• twitter/jonschlinkert

License

Copyright © 2015 Jon Schlinkert Released under the MIT license.

---

This file was generated by verb on December 20, 2015.