file-system — Simplified file system

This module make file opertaion apis simple, you don't need to care the dir exits. and the api is same as node's filesystem. This is no exists time cost for this plugin.

1var fs = require('file-system');
2
3fs.mkdir('1/2/3/4/5', [mode], function(err) {});
4fs.mkdirSync('1/2/3/4/5', [mode]);
5fs.writeFile('path/test.txt', 'aaa', function(err) {})

install

npm install file-system --save

API

.fs

file extend node fs origin methods, and overwrite some methods with next list chart

1var file = require('file-system');
2var fs = require('fs');
3
4file.readFile === fs.readFile // true

.mkdir

The api is same as node's mkdir

.mkdirSync

The api is same as node's mkdir

.writeFile

The api is same as node's writeFile

.writeFileSync

The api is same as node's writeFile

.fileMatch

The api equal file-match

.copyFile(srcpath, destpath, options)

Asynchronously copy a file into newpath

• {string} srcpath required
• {string} destpath required
• {object} options
  • {string} options.encoding [options.encoding=utf8]
  • {function} options.done(err)
  • {function} options.process(content)
    The process argument must return processed content

1fs.copyFile('deom.png', 'dest/demo.png', {
2  done: function(err) {
3    console.log('done');
4  }
5});

.copyFileSync(srcpath, destpath, options)

The api same as copyFile, but it's synchronous

1fs.copyFileSync('demo.png', 'dest/demo.png');
2fs.copyFileSync('demo.css', 'dest/demo.css', {
3  process: function(contents) {
4    return contents;
5  }
6})

.recurse(dirpath, filter, callback)

Recurse into a directory, executing callback for each file and folder. if the filename is undefiend, the callback is for folder, otherwise for file.

• {string} dirpath required
• {string|array|function} filter
  If the filter is function, executing callback for all files and folder
• {function} callback(filepath, filename, relative)

1fs.recurse('path', function(filepath, relative, filename) { });
2
3fs.recurse('path', [
4  '*.css',
5  '**/*.js', 
6  'path/*.html',
7  '!**/path/*.js'
8], function(filepath, relative, filename) {  
9  if (filename) {
10  // it's file
11  } else {
12  // it's folder
13  }
14});
15
16//  Only using files
17fs.recurse('path', function(filepath, relative, filename) {  
18  if (!filename) return;
19});

filter params description

.recurseSync(dirpath, filter, callback)

The api is same as recurse, but it is synchronous

1fs.recurseSync('path', function(filepath, relative, filename) {
2  
3});
4
5fs.recurseSync('path', ['**/*.js', 'path/**/*.html'], function(filepath, relative, filename) {
6  
7});

.rmdirSync(dirpath)

Recurse into a directory, remove all of the files and folder in this directory.

1fs.rmdirSync('path');

.copySync(dirpath, destpath, options)

Recurse into a directory, copy all files into dest.

• {string} dirpath required
• {string} destpath required
• {object} options
  • {string|array} options.filter
  • {function} options.process(contents, filepath, relative)
    If custom the destpath, return object, otherwise return content
  • {string|array} options.noProcess

1fs.copySync('path', 'dest', { clear: true });
2
3fs.copySync('src', 'dest/src');
4
5fs.copySync('src', 'dest/src', { filter: ['*.js', 'path/**/*.css'] });
6
7fs.copySync('path', 'dest', { 
8  noProcess: '**/*.{jpg, png}',            // Don't process images
9  process: function(contents, filepath, relative) {
10    // only process file content
11    return contents;
12    // or custom destpath
13    return {
14      contents: '',
15      filepath: ''
16    };
17  } 
18});
19
20//Handler self files
21fs.copySync('path', 'path', { filter: ['*.html.js'], process: function(contents, filepath) {} });

.base64

Deprecated, move to base64

.base64Sync

Deprecated, move to base64Sync