node-dir

WebJar for node-dir

License

License

MIT
GroupId

GroupId

org.webjars.npm
ArtifactId

ArtifactId

node-dir
Last Version

Last Version

0.1.17
Release Date

Release Date

Type

Type

jar
Description

Description

node-dir
WebJar for node-dir
Project URL

Project URL

http://webjars.org
Source Code Management

Source Code Management

https://github.com/fshost/node-dir

Download node-dir

How to add to project

<!-- https://jarcasting.com/artifacts/org.webjars.npm/node-dir/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>node-dir</artifactId>
    <version>0.1.17</version>
</dependency>
// https://jarcasting.com/artifacts/org.webjars.npm/node-dir/
implementation 'org.webjars.npm:node-dir:0.1.17'
// https://jarcasting.com/artifacts/org.webjars.npm/node-dir/
implementation ("org.webjars.npm:node-dir:0.1.17")
'org.webjars.npm:node-dir:jar:0.1.17'
<dependency org="org.webjars.npm" name="node-dir" rev="0.1.17">
  <artifact name="node-dir" type="jar" />
</dependency>
@Grapes(
@Grab(group='org.webjars.npm', module='node-dir', version='0.1.17')
)
libraryDependencies += "org.webjars.npm" % "node-dir" % "0.1.17"
[org.webjars.npm/node-dir "0.1.17"]

Dependencies

compile (1)

Group / Artifact Type Version
org.webjars.npm : minimatch jar [3.0.2,4)

Project Modules

There are no modules declared in this project.

Build Status

node-dir

A lightweight Node.js module with methods for some common directory and file operations, including asynchronous, non-blocking methods for recursively getting an array of files, subdirectories, or both, and methods for recursively, sequentially reading and processing the contents of files in a directory and its subdirectories, with several options available for added flexibility if needed.

Table of Contents

installation

npm install node-dir

usage

methods

For the sake of brevity, assume that the following line of code precedes all of the examples.

var dir = require('node-dir');

readFiles( dir, [options], fileCallback, [finishedCallback] )

readFilesStream( dir, [options], streamCallback, [finishedCallback] )

Sequentially read the content of each file in a directory, passing the contents to a callback, optionally calling a finished callback when complete. The options and finishedCallback arguments are not required.

Valid options are:

  • encoding: file encoding (defaults to 'utf8')
  • exclude: a regex pattern or array to specify filenames to ignore
  • excludeDir: a regex pattern or array to specify directories to ignore
  • match: a regex pattern or array to specify filenames to operate on
  • matchDir: a regex pattern or array to specify directories to recurse
  • recursive: whether to recurse subdirectories when reading files (defaults to true)
  • reverse: sort files in each directory in descending order
  • shortName: whether to aggregate only the base filename rather than the full filepath
  • sort: sort files in each directory in ascending order (defaults to true)
  • doneOnErr: control if done function called on error (defaults to true)

A reverse sort can also be achieved by setting the sort option to 'reverse', 'desc', or 'descending' string value.

readFilesStream examples

// display contents of files in this script's directory
dir.readFiles(__dirname,
    function(err, content, next) {
        if (err) throw err;
        console.log('content:', content);
        next();
    },
    function(err, files){
        if (err) throw err;
        console.log('finished reading files:', files);
    });

// display contents of huge files in this script's directory
dir.readFilesStream(__dirname,
    function(err, stream, next) {
        if (err) throw err;
        var content = '';
        stream.on('data',function(buffer) {
            content += buffer.toString();
        });
        stream.on('end',function() {
            console.log('content:', content);
            next();
        });
    },
    function(err, files){
        if (err) throw err;
        console.log('finished reading files:', files);
    });

// match only filenames with a .txt extension and that don't start with a `.´
dir.readFiles(__dirname, {
    match: /.txt$/,
    exclude: /^\./
    }, function(err, content, next) {
        if (err) throw err;
        console.log('content:', content);
        next();
    },
    function(err, files){
        if (err) throw err;
        console.log('finished reading files:',files);
    });

// exclude an array of subdirectory names
dir.readFiles(__dirname, {
    exclude: ['node_modules', 'test']
    }, function(err, content, next) {
        if (err) throw err;
        console.log('content:', content);
        next();
    },
    function(err, files){
        if (err) throw err;
        console.log('finished reading files:',files);
    });


// the callback for each file can optionally have a filename argument as its 3rd parameter
// and the finishedCallback argument is optional, e.g.
dir.readFiles(__dirname, function(err, content, filename, next) {
        console.log('processing content of file', filename);
        next();
    });

files( dir, callback )

Asynchronously iterate the files of a directory and its subdirectories and pass an array of file paths to a callback.

dir.files(__dirname, function(err, files) {
    if (err) throw err;
    console.log(files);
});

files( dir, {sync:true} )

Synchronously iterate the files of a directory and its subdirectories and pass an array of file paths to a callback.

var files = dir.files(__dirname, {sync:true});
console.log(files);

promiseFiles( dir, callback )

Asynchronously iterate the files of a directory and its subdirectories and pass an array of file paths to a callback.

dir.promiseFiles(__dirname)
.then((files)=>{
    console.log(files);
})
.catch(e=>console.error(e))

Note that for the files and subdirs the object returned is an array, and thus all of the standard array methods are available for use in your callback for operations like filters or sorting. Some quick examples:

dir.files(__dirname, function(err, files) {
    if (err) throw err;
    // sort ascending
    files.sort();
    // sort descending
    files.reverse();
    // include only certain filenames
    files = files.filter(function (file) {
       return ['allowed', 'file', 'names'].indexOf(file) > -1;
    });
    // exclude some filenames
    files = files.filter(function (file) {
        return ['exclude', 'these', 'files'].indexOf(file) === -1;
    });
});

Also note that if you need to work with the contents of the files asynchronously, please use the readFiles method. The files and subdirs methods are for getting a list of the files or subdirs in a directory as an array.

subdirs( dir, callback )

Asynchronously iterate the subdirectories of a directory and its subdirectories and pass an array of directory paths to a callback.

dir.subdirs(__dirname, function(err, subdirs) {
    if (err) throw err;
    console.log(subdirs);
});

paths(dir, [combine], callback )

Asynchronously iterate the subdirectories of a directory and its subdirectories and pass an array of both file and directory paths to a callback.

Separated into two distinct arrays (paths.files and paths.dirs)

dir.paths(__dirname, function(err, paths) {
    if (err) throw err;
    console.log('files:\n',paths.files);
    console.log('subdirs:\n', paths.dirs);
});

Combined in a single array (convenience method for concatenation of the above)

dir.paths(__dirname, true, function(err, paths) {
    if (err) throw err;
    console.log('paths:\n',paths);
});

API Docs

files(dir, type, callback, options)

  • dir - directory path to read
  • type='file'
    • 'file' returns only file listings
    • 'dir' returns only directory listings
    • 'all' returns {dirs:[], files:[]}
    • 'combine' returns []
  • callback -
  • options
    • sync=false - results are returned inline and no callbacks are used
    • shortName=false - instead of fullpath file names, just get the names
    • recursive=true - traverse through all children of given path

License

MIT licensed (See LICENSE.txt)

Versions

Version
0.1.17