node package manager

findup-sync

findup-sync Build Status NPM version

Find the first file matching a given pattern in the current directory or the nearest ancestor directory.

Matching is done with micromatch, please report any matching related issues on that repository.

Install with npm

npm i findup-sync --save

Usage

var findup = require('findup-sync');
findup(patternOrPatterns [, micromatchOptions]);
 
// Start looking in the CWD. 
var filepath1 = findup('{a,b}*.txt');
 
// Start looking somewhere else, and ignore case (probably a good idea). 
var filepath2 = findup('{a,b}*.txt', {cwd: '/some/path', nocase: true});
  • patterns {String|Array}: Glob pattern(s) or file path(s) to match against.
  • options {Object}: Options to pass to micromatch. Note that if you want to start in a different directory than the current working directory, specify a cwd property here.
  • returns {String}: Returns the first matching file.

Running tests

Install dev dependencies:

npm i -d && npm test

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt

For bugs and feature requests, please create an issue.

Release History

2017-08-07 - v2.0.0 - Drop node 0.8 support, Bump all dependencies (including some Majors)
2017-04-18 - v1.0.0 - Major bump from stable 0.4.3
2015-01-30 - v0.4.0 - Refactored, not also uses micromatch instead of minimatch.
2015-09-14 - v0.3.0 - updated glob to ~5.0.
2014-12-17 - v0.2.1 - Updated to glob 4.3.
2014-12-16 - v0.2.0 - Removed lodash, updated to glob 4.x.
2014-03-14 - v0.1.3 - Updated dependencies.
2013-03-08 - v0.1.2 - Updated dependencies. Fixed a Node 0.9.x bug. Updated unit tests to work cross-platform.
2012-11-15 - v0.1.1 - Now works without an options object.
2012-11-01 - v0.1.0 - Initial release.

Authors

"Cowboy" Ben Alman

License

Copyright (c) 2012-2016 "Cowboy" Ben Alman
Released under the MIT license

We ♥ your boss

Selectively mirror the npm registry inside your firewall. Filter packages based on security, licensing, code quality and more. Build awesome stuff faster. Try npm Enterprise for free…

how? learn more

Collaborators list

Stats

Try it out

Keywords

file, find, find-up, findup, glob, match, pattern, resolve, search

Dependencies (4)

detect-file, is-glob, micromatch, resolve-dir

Dependents (357)

broccoli, pattern-manager, gobble, grunt-if-contains, grunt-better-build-number, ava-webpack, alp-node, sp-load, panto-cli, check-dependencies, boiler-utils, boiler-config-base, kexcel, grunt-dots-compile, panqibao, grunt-dot-compile, chrome-extension-scripts, tslint-multi, freshrepl, generator-aspnetpostgresql, waigo, arch3, crust-io, check-dependencies-simple, broccoli-brocfile-loader, bitters, module-root, nltco-load-grunt-parent-tasks, gulp-pipeline, myself, semver-tags, matchdep, broccoli-jscs, @mechanicalhuman/get-root, itbldz, grunt-cli-extra, hog-cli, kerman, load-grunt-parent-tasks, grunt-fh-build, @nxus/core, iotor-lm, ano-lm, gulp-npm-check, grunt-dev-update, webplatform, sass-dev-server, naver-bower, dnsme-ddns-updater, grunt-castle, and more