list-contents

Description

list-contents is a module that returns a list of paths to the subfolders and subfiles of the specified location.

• Any bugs found? Give me to know on [e-mail] or on GitHub
• Also check out file-assistant package that creates, copies or moves the folders and files into the specified path or modifies the files' content according to the given [Array] object (or .json file path) instructions.
• Changes:
  • v3.*.* The callback function object.error property has been replaced with object.inaccessible property. If the file or folder is inaccessible, it is pushed into object.inaccessible array [see below]. Unlike object.error, if the file or folder is inaccessible, it does not stop retrieving the further files and folders. After retrieving all children items, the callback function returns the object with dirs, files and inaccessible [Array] properties.

Installation

npm install list-contents

const list = require('list-contents');

Usage

list(path,callback)

path [String]

• It should indicate the path to the chosen directory, which subfolders and subfiles should be listed

If the path, eg. './dist/styles' is inaccessible itself, the callback function will return object:
{files:[], dirs:[], inaccessible:[ './' ], path:'./dist/styles'}

callback [Function]

• the [Object] argument is passed through callback function. It has 4 properties:
  • error [Boolean|Error] v2.*.*
null if the path is valid, otherwise [Error] object
  • dirs [Array]
    The list of all subfolders' paths of the specified path argument
  • files [Array]
    The list of all subfiles' paths of the specified path argument
  • inaccessible [Array] v3.*.*
    The list of all unrecognized or inaccessible children's paths of the specified path argument
  • path [String]
    The path that was given as path parameter

const list = require('list-contents');

list("./dist",(o)=>{
  if(o.error) throw o.error;
  console.log('Folders: ', o.dirs);
  console.log('Files: ', o.files);
});

Samples

Assuming that "./dist" path contains the following subfolders and subfiles:

dist
 ├ scripts
 │  ├ index.js
 │  └ ajax.js
 ├ styles
 │  ├ css   
 │  │  ├ layout.css
 │  │  └ media.css
 │  └ scss
 │     └ mixins.scss
 └ templates
    ├ main.html
    ├ menubar.html
    ├ login.html
    └ contact.html

the module will pass the following object through the callback function:

{
  error: null,
  path: "./dist",
  dirs: [
    'scripts',
    'templates',
    'styles',
    'styles/css',
    'styles/scss'
  ],
  files: [
    'scripts/ajax.js',
    'scripts/index.js',
    'templates/contact.html',
    'templates/login.html',
    'templates/main.html',
    'templates/menubar.html',
    'styles/css/layout.css',
    'styles/css/media.css',
    'styles/scss/mixins.scss'
  ]
}