Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/forbeslindesay/lsr
Recursive readdir (`ls -R`)
https://github.com/forbeslindesay/lsr
filesystem
Last synced: 16 days ago
JSON representation
Recursive readdir (`ls -R`)
- Host: GitHub
- URL: https://github.com/forbeslindesay/lsr
- Owner: ForbesLindesay
- License: mit
- Created: 2013-08-04T04:40:49.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2017-07-06T08:31:15.000Z (over 7 years ago)
- Last Synced: 2024-10-20T04:42:34.336Z (24 days ago)
- Topics: filesystem
- Language: TypeScript
- Size: 9.77 KB
- Stars: 10
- Watchers: 4
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# lsr
Recursive readdir (`ls -R`)
[](https://travis-ci.org/ForbesLindesay/lsr)
[](https://david-dm.org/ForbesLindesay/lsr)
[](https://www.npmjs.com/package/lsr)
## Installation
npm install lsr
## Usage
```js
const {lsrSync, lsrAsync, lsrStream} = require('lsr');
// Synchronous
console.dir(lsrSync(__dirname))
// Promise
lsrAsync(__dirname).then(function (res) {
console.dir(res)
})
// Stream
lsrStream(__dirname).pipe(getPath()).pipe(process.stdout)
```
## API
Each file system entry is represented by a [Stat](http://nodejs.org/api/fs.html#fs_class_fs_stats) object with the additional properties:
- `name`: the file name (e.g. `foo.txt`)
- `path`: the relative path to the file (e.g. `./subdir/foo.txt`). This is always separated by `/` regardless of platform.
- `fullPath`: the full path to the file (e.g. `c:\\basedir\\foo.txt` or `/basedir/foo.txt`). This is separated by the correct path separater for the platform.
### lsrAsync(dir, options, callback)
Recursively lists the files and folders and calls the callback exactly once with the error or null as the first argument and an array of file system entries as the second argument.
Options:
- ignoreErrors - if any stat calls result in an error, simply ignore that item
- filter - a function that is called with a file sytem entry as its only argument and should return `true` to include that entry and any sub-entries in the result and `false` otherwise
- filterPath - a function that is called with the `path` property of the file system entry (before the call to `fs.stat`) as its only argument and should return `true` to include that entry and any sub-entries in the result and `false` otherwise
If the callback is ommitted, a promise is returned instead.
### lsrSync(dir, options)
Recursively lists the files and folders and returns an array of file system entries.
Options:
- ignoreErrors - if any stat calls result in an error, simply ignore that item
- filter - a function that is called with a file sytem entry as its only argument and should return `true` to include that entry and any sub-entries in the result and `false` otherwise
- filterPath - a function that is called with the `path` property of the file system entry (before the call to `fs.stat`) as its only argument and should return `true` to include that entry and any sub-entries in the result and `false` otherwise
### lsrStream(dir, options)
Recursively lists the files and folders and returns a stream of file system entries.
Options:
- ignoreErrors - if any stat calls result in an error, simply ignore that item
- filter - a function that is called with a file sytem entry as its only argument and should return `true` to include that entry and any sub-entries in the result and `false` otherwise
- filterPath - a function that is called with the `path` property of the file system entry (before the call to `fs.stat`) as its only argument and should return `true` to include that entry and any sub-entries in the result and `false` otherwise
- highWaterMark - the maximum number of file system entries to buffer before it should stop calling `readdir` and `stat` while it waits for the consuming stream to catch up
## License
MIT