Filesystem (fs): Readme

GitHub watchers GitHub stars GitHub forks

npm package latest version Travis status Coveralls status Gemnasium status GitHub issues

Like some other packages this module adds functions to the node.js fs package. It’s designed as a drop-in replacement. It uses alsograceful-fs to normalize behavior across different platforms and environments, and to make filesystem access more resilient to errors.

This package combines features found in a lot of other packages together without including too much. Most methods are very customizable using options.

  • drop in replacement for node’s fs module
  • powerful find method
  • recursive file handling functions
  • complete asynchronous and synchronous
  • additional methods

It is one of the modules of the Alinex Namespace following the code standards defined in the General Docs.

Read the complete documentation under https://alinex.github.io/node-fs.

Install

NPM Downloads

See theVersion changes for a list of changes in recent versions.

The easiest way is to let npm add the module directly to your modules (from within you node modules directory):

Shell Script
npm install alinex-fs --save

Usage

To use this enhanced filesystem library change your require line from:

CoffeeScript Code
fs = require 'fs'

to the following:

CoffeeScript Code
fs = require 'alinex-fs'

After this you may use the standard functions and the following extended functions:

The methods find, copy and remove supports multiple options to filter the files they work on.

Like you see all the extended functions use the same naming convention as the node core, making the use nearly natural.

License

© Copyright 2014-2016 Alexander Schilling

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.