mirror of
https://github.com/shelljs/shelljs.git
synced 2026-01-18 16:03:37 +00:00
117 lines
3.4 KiB
JavaScript
117 lines
3.4 KiB
JavaScript
var path = require('path');
|
|
var fs = require('fs');
|
|
var common = require('./common');
|
|
var glob = require('glob');
|
|
|
|
var globPatternRecursive = path.sep + '**' + path.sep + '*';
|
|
|
|
//@
|
|
//@ ### ls([options,] [path, ...])
|
|
//@ ### ls([options,] path_array)
|
|
//@ Available options:
|
|
//@
|
|
//@ + `-R`: recursive
|
|
//@ + `-A`: all files (include files beginning with `.`, except for `.` and `..`)
|
|
//@ + `-d`: list directories themselves, not their contents
|
|
//@ + `-l`: list objects representing each file, each with fields containing `ls
|
|
//@ -l` output fields. See
|
|
//@ [fs.Stats](https://nodejs.org/api/fs.html#fs_class_fs_stats)
|
|
//@ for more info
|
|
//@
|
|
//@ Examples:
|
|
//@
|
|
//@ ```javascript
|
|
//@ ls('projs/*.js');
|
|
//@ ls('-R', '/users/me', '/tmp');
|
|
//@ ls('-R', ['/users/me', '/tmp']); // same as above
|
|
//@ ls('-l', 'file.txt'); // { name: 'file.txt', mode: 33188, nlink: 1, ...}
|
|
//@ ```
|
|
//@
|
|
//@ Returns array of files in the given path, or in current directory if no path provided.
|
|
function _ls(options, paths) {
|
|
options = common.parseOptions(options, {
|
|
'R': 'recursive',
|
|
'A': 'all',
|
|
'a': 'all_deprecated',
|
|
'd': 'directory',
|
|
'l': 'long'
|
|
});
|
|
|
|
if (options.all_deprecated) {
|
|
// We won't support the -a option as it's hard to image why it's useful
|
|
// (it includes '.' and '..' in addition to '.*' files)
|
|
// For backwards compatibility we'll dump a deprecated message and proceed as before
|
|
common.log('ls: Option -a is deprecated. Use -A instead');
|
|
options.all = true;
|
|
}
|
|
|
|
if (!paths)
|
|
paths = ['.'];
|
|
else
|
|
paths = [].slice.call(arguments, 1);
|
|
|
|
var list = [];
|
|
|
|
function pushFile(abs, relName, stat) {
|
|
if (process.platform === 'win32')
|
|
relName = relName.replace(/\\/g, '/');
|
|
if (options.long) {
|
|
stat = stat || fs.lstatSync(abs);
|
|
list.push(addLsAttributes(relName, stat));
|
|
} else {
|
|
// list.push(path.relative(rel || '.', file));
|
|
list.push(relName);
|
|
}
|
|
}
|
|
|
|
paths.forEach(function(p) {
|
|
var stat;
|
|
|
|
try {
|
|
stat = fs.lstatSync(p);
|
|
} catch (e) {
|
|
common.error('no such file or directory: ' + p, true);
|
|
return;
|
|
}
|
|
|
|
// If the stat succeeded
|
|
if (stat.isDirectory() && !options.directory) {
|
|
if (options.recursive) {
|
|
// use glob, because it's simple
|
|
glob.sync(p + globPatternRecursive, { dot: options.all })
|
|
.forEach(function (item) {
|
|
pushFile(item, path.relative(p, item));
|
|
});
|
|
} else if (options.all) {
|
|
// use fs.readdirSync, because it's fast
|
|
fs.readdirSync(p).forEach(function (item) {
|
|
pushFile(path.join(p, item), item);
|
|
});
|
|
} else {
|
|
// use fs.readdirSync and then filter out secret files
|
|
fs.readdirSync(p).forEach(function (item) {
|
|
if (item[0] !== '.')
|
|
pushFile(path.join(p, item), item);
|
|
});
|
|
}
|
|
} else {
|
|
pushFile(p, p, stat);
|
|
}
|
|
});
|
|
|
|
// Add methods, to make this more compatible with ShellStrings
|
|
return new common.ShellString(list, common.state.error);
|
|
}
|
|
|
|
function addLsAttributes(path, stats) {
|
|
// Note: this object will contain more information than .toString() returns
|
|
stats.name = path;
|
|
stats.toString = function() {
|
|
// Return a string resembling unix's `ls -l` format
|
|
return [this.mode, this.nlink, this.uid, this.gid, this.size, this.mtime, this.name].join(' ');
|
|
};
|
|
return stats;
|
|
}
|
|
|
|
module.exports = _ls;
|