File system API for
Q when/defer-style promises


THE API
-------

open(path, flags, charset)

read(path, flags, charset)

write(path, content, flags, charset)

append(path, content, flags, charset) NOT TESTED

copy(source, target) NOT IMPLEMENTED

list(path)

listTree(path, guard_opt(path, stat))

listDirectoryTree(path)

glob(pattern) NOT IMPLEMENTED

match(pattern, file) NOT IMPLEMENTED

makeDirectory(path)

makeTree(path) NOT TESTED

remove(path) NOT TESTED

removeTree(path) NOT TESTED

link(source, taget) NOT TESTED (probably safe)

chown(path, uid, gid) NOT TESTED (probably safe)

chmod(path, mode) NOT TESTED (probably safe)

stat(path)

statLink(path) NOT TESTED

statFd(fd) NOT TESTED

exists(path)

isFile(path)

isDirectory(path)

lastModified(path)

split(path)

join(paths)
join(...paths)

resolve(...paths)

normal(...paths)

absolute(path)

canonical(path)

contains(parent, child)

relativeFromFile(source, target)

relativeFromDirectory(source, target)

isAbsolute(path)

isRelative(path)

isRoot(path)

root(path)

directory(path)

base(path, extension)

extension(path)

reroot(path_opt)

toObject(path_opt)

ROOT

    `/` on Unix
    `\` on Windows

SEPARATOR

    `/` on Unix
    `\` on Windows

ALT_SEPARATOR

    undefined on Unix
    `/` on Windows


Copyright 2009, 2010 Kristopher Michael Kowal
MIT License (enclosed)