fs-path

fs-path
========

---

$3

Recurcively scan files or scan files by a filter.

Callback break tow arguments: err, list

``js
var fsPath = require('fs-path');

fsPath.find('/usr/local', function(err, list){
console.log(list.dirs);
console.log(list.files);
});
`

The value list is an object has two keys:

`js
{
dirs: [
'/usr/local/test'
'/usr/local/test/abc'
],
files: [
'/usr/local/aaa.png',
'/usr/local/test/bbb.gif',
'/usr/local/test/abc/ddd.html'
]
}
`

If you set a filter to map the files or directories, you can do like this:

`js
var fsPath = require('fs-path');

fsPath.find('/usr/local', function(filepath, stats, filename){
if(stats === 'file' && /\.png$/.test(filename)){
return false;
}
return true;
}, function(err, list){
console.log(list.dirs);
console.log(list.files);
});
`

filter has 3 arguments:

* filepath: the full path of the file or directory
* stats: the type of file or directory, has two value: file, directory
* filename: the name of the file or directory

It will return the list:

`js
{
dirs: [
'/usr/local/test'
'/usr/local/test/abc'
],
files: [
'/usr/local/test/bbb.gif',
'/usr/local/test/abc/ddd.html'
]
}
`

$3

Sync version of find(). Throws exception on error.

$3

Recursively make, if the parent path not exists, it'll create the directory automatically.

`js
var fsPath = require('fs-path');

fsPath.mkdir('/usr/local/test1/test2/test3', function(err){
console.log('ok');
});
`

$3

Sync version of mkdir(). Throws exception on error.

$3

Copy a file or directory to other path, if the parent path not exists, it'll create the directory automatically.

`js
var fsPath = require('fs-path');

fsPath.copy('/usr/local/test1/test2/test3', '/usr/local/aaaa', function(err){
console.log('ok');
});
`

$3

Sync version of copy(). Throws exception on error.

$3

Delete a file or directory.

`js
var fsPath = require('fs-path');

fsPath.remove('/usr/local/test1/test2/test3', function(err){
console.log('ok');
});
`

$3

Sync version of remove(). Throws exception on error.

$3

Write a file a file or directory.

Encoding is optional, default is 'utf-8'.

`js
var fsPath = require('fs-path');

fsPath.writeFile('/usr/local/1.html', content function(err){
console.log('ok');
});
``

$3

Sync version of writeFile(). Throws exception on error.