Nomadic People Migration
    Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

    readdirpublic

    readdir.js

    A Node.js utility module to read the contents of a directory with support for Ant style filtering to easily order the results - particularly useful for any order specific build system.

    Node.js

    Install using npm npm install readdir then use with require:

    var directoryContents = require('readdir').readSync('some_path/');
    

    Usage

    The readSync( path, [filters, [options]]) method can accept a path that is either absolute or relative to the current working directory.

    Filters can be supplied as an array of strings that are Ant style expressions that any file found in the path directory must satisfy, use a * to signify any file in the current directory or ** to signify any file in the current or any sub directory. If the filter contains a / then the file path must also include a path, so */* would mean any file of a directory that is a direct sub-directory of the path directory and */** would be any file that is in any subdirectory of the path directory.

    To select just one type of file, add a file extension suffix to the filter (eg: **.js to pick any JavaScript file in the path directory).

    If the options argument is supplied, it should be a number representing the sum of any options you want to apply:

    ABSOLUTE_PATHS changes the return value so that each item in the array is an absolute path instead of relative to the path directory.

    CASELESS_SORT sort the return array as a case insensitive sort

    CASE_SORT sort the return array as a case sensitive sort

    INCLUDE_DIRECTORIES include the names of directories in the results returned, including just directories can be done by using the filter ['*/'], note that directory names will have a trailing slash to identify them from files that have no extension

    INCLUDE_HIDDEN includes files in directories that have a . prefix, note that this doesn't impact whether files with a . prefix are returned (ie: .gitignore would be listed, but .git/* would not)

    NON_RECURSIVE prevents the automatic recursion so only the current directory is scanned

    Examples

    With filters:

    var readDir = require('readdir');
    
    // an array of all JavaScript files in some_path/
    readDir.readSync( 'some_path/', ['**.js'] );
    

    With ordering of results using filters:

    var readDir = require('readdir');
    
    // an array of all JavaScript files in some_path/ with base.js first, then all core then anything else
    var filesArray = readDir.readSync( 'some_path/', ['base.js', 'core/**.js', '**.js'] );
    
    // an array of all JavaScript files in some_path/ with base.js first, then all core then anything else
    readDir.read( 'some_path/', ['base.js', 'core/**.js', '**.js'], function (err, filesArray) {
       // err either null or an error instance
       // filesArray the same as the return value from readSync
    });
    

    With options

    var readDir = require('readdir');
    
    // an array of all files in some_path/ as absolute file paths
    readDir.readSync( 'some_path/', null, readDir.ABSOLUTE_PATHS );
    
    // an array of all files in some_path/ as absolute file paths sorted without case
    readDir.read( 'some_path/', readDir.ABSOLUTE_PATHS + readDir.CASELESS_SORT, function (err, allFiles) {});
    
    // an array of just directory names directly under some_path
    readDir.read( 'some_path/', ['*/'], readDir.INCLUDE_DIRECTORIES + readDir.NON_RECURSIVE,
      function (err, allFiles) {});
    

    Keywords

    install

    npm i readdir

    Downloadsweekly downloads

    2,665

    version

    0.1.0

    license

    MIT

    repository

    githubgithub

    last publish

    collaborators

    • avatar