Filesystem (fs): Readme
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
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:
- mkdirs and mkdirsSync to make directories like needed (including parent ones)
- find and findSync to get a list of files or directories
- copy and copySync to deep copy directories with files
- remove and removeSync to remove a file entry with all it’s children, if existing
- move and moveSync to move a file to another position
- npmbin and npmbinSync to find a binary in the module or it’s parent
- tempdir and tempdirSync to create a temporary directory
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
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.