| /*! |
| * detect-file <https://github.com/doowb/detect-file> |
| * |
| * Copyright (c) 2016-2017, Brian Woodward. |
| * Released under the MIT License. |
| */ |
| |
| 'use strict'; |
| |
| var fs = require('fs'); |
| var path = require('path'); |
| |
| /** |
| * Detect the given `filepath` if it exists. |
| * |
| * ```js |
| * var res = detect('package.json'); |
| * console.log(res); |
| * //=> "package.json" |
| * |
| * var res = detect('fake-file.json'); |
| * console.log(res) |
| * //=> null |
| * ``` |
| * |
| * @param {String} `filepath` filepath to detect. |
| * @param {Object} `options` Additional options. |
| * @param {Boolean} `options.nocase` Set this to `true` to force case-insensitive filename checks. This is useful on case sensitive file systems. |
| * @return {String} Returns the detected filepath if it exists, otherwise returns `null`. |
| * @api public |
| */ |
| |
| module.exports = function detect(filepath, options) { |
| if (!filepath || (typeof filepath !== 'string')) { |
| return null; |
| } |
| if (fs.existsSync(filepath)) { |
| return path.resolve(filepath); |
| } |
| |
| options = options || {}; |
| if (options.nocase === true) { |
| return nocase(filepath); |
| } |
| return null; |
| }; |
| |
| /** |
| * Check if the filepath exists by falling back to reading in the entire directory. |
| * Returns the real filepath (for case sensitive file systems) if found. |
| * |
| * @param {String} `filepath` filepath to check. |
| * @return {String} Returns found filepath if exists, otherwise null. |
| */ |
| |
| function nocase(filepath) { |
| filepath = path.resolve(filepath); |
| var res = tryReaddir(filepath); |
| if (res === null) { |
| return null; |
| } |
| |
| // "filepath" is a directory, an error would be |
| // thrown if it doesn't exist. if we're here, it exists |
| if (res.path === filepath) { |
| return res.path; |
| } |
| |
| // "filepath" is not a directory |
| // compare against upper case later |
| // see https://nodejs.org/en/docs/guides/working-with-different-filesystems/ |
| var upper = filepath.toUpperCase(); |
| var len = res.files.length; |
| var idx = -1; |
| |
| while (++idx < len) { |
| var fp = path.resolve(res.path, res.files[idx]); |
| if (filepath === fp || upper === fp) { |
| return fp; |
| } |
| var fpUpper = fp.toUpperCase(); |
| if (filepath === fpUpper || upper === fpUpper) { |
| return fp; |
| } |
| } |
| |
| return null; |
| } |
| |
| /** |
| * Try to read the filepath as a directory first, then fallback to the filepath's dirname. |
| * |
| * @param {String} `filepath` path of the directory to read. |
| * @return {Object} Object containing `path` and `files` if succesful. Otherwise, null. |
| */ |
| |
| function tryReaddir(filepath) { |
| var ctx = { path: filepath, files: [] }; |
| try { |
| ctx.files = fs.readdirSync(filepath); |
| return ctx; |
| } catch (err) {} |
| try { |
| ctx.path = path.dirname(filepath); |
| ctx.files = fs.readdirSync(ctx.path); |
| return ctx; |
| } catch (err) {} |
| return null; |
| } |