site_opytex/theme/node_modules/detect-file/index.js

110 lines
2.7 KiB
JavaScript
Raw Normal View History

/*!
* 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;
}