fs.io

fs.io 提供基于Promise(Q Promise)的文件、目录操作类库

api参考.net Framework System.IO命名空间下的

http://msdn.microsoft.com/en-us/library/System.IO(v=vs.110).aspx

File FileInfo 和Directory类

使用方法

	var file = require('fs.io').file;
	var dict = require('fs.io').directory;
	file.copy(from,to)
		.done(function(){})
		.fail(function(){});
	...

file

file.copy(src, dest, isOverride)

src 源路径

dest 目标路径

isOverride 是否覆盖目标文件

** 该api，使用ncp库进行复制 **

file.delete(path)

path 文件路径

file.isExists(path)

path 文件路径

promise在done函数从参数返回是否存在

	file.isExists("d:/saa.txt").done(function(exists){
		if(exists){

		}
	})

file.move(src, dest)

src 源路径 dest 目标路径

file.getLastAccessTime(path)

获取最后访问时间

file.getLastModifyTime(path)

获取文件最后修改时间

file.getCreateTime(path)

获取文件创建时间

file.read(path)

注意该函数返回值Stream.Readable对象

file.readAllText(path)

读取文件的所有内容

file.write(path)

注意该函数返回Stream.Wriable对象

file.writeAllText(path, text)

path 文件路径 text 写入文件内容

file.appendText(path, text)

往文件结尾写入文本，如果文件不存在，则创建文件

directory

directory.createDirectory(path)

根据提供路径创建目录结构，路径中如果有任何目录不存在，则创建相应的目录

path 可为相对路径或绝对路径

directory.delete(path, recursive)

删除文件目录，删非空目录时，recursive为true

directory.isExists(path)

目录是否存在，在resolve函数中，返回目录是否存在

directory.move(srcDir, destDir, override)

移动源目录到指定路径， overrid 可选，为true时覆盖目标路径内容

该函数封装fs-extra类库的move函数

directory.isDirectory(path)

指定路径是否为目录

directory.getDirectories(path, pattern)

pattern 目录搜索模式，支持 glob搜索方式，可选项，默认返回根目录下的第一级子目录，即 pattern = "*"

	directory.getDirectories("tmp/","**/*");//返回所有子目录
	directory.getDirectories("tmp/","**/abc*");//返回abc开头的所有子目录

directory.getFiles(path, pattern)

获取文件夹下所有文件路径，返回所有符合条件的文件地址

pattern 文件搜索模式，默认为 **/*.*，即返回所有文件

	directory.getFiles("path");//返回所有文件
	directory.getFiles("path","*.js");//返回根目录的js文件
	directory.getFiles("path","**/*.js");//返会目录下的所有js文件

FileInfo

FileInfo 包含以下属性

fullName 文件路径
name 文件名
extension 文件扩展名
directoryName 目录名
isStatReady stats通过异步获取，此属性标示stats是否请求完毕
createTime 文件创建时间
lastAccessTime 文件最后访问时间
lastModifyTime 文件修改时间
length 文件大小

类函数

isExists() 文件是否存在
copyTo(destPath) 文件拷贝
moveTo(destPath) 文件转移
openRead() 以Readable流形式打开
openText() 读取文件内容
openWrite() 以Writeable流形式打开
writeAllText(text) 写入文本
appendText(text) 附加文本
delete() 文件删除

daddybh/fs.io