0.1.0 • Published 6 years ago
express-rest-fs v0.1.0
ExpressRestFs
Let's RESTify your filesystem
Usage
./bin/expose [path] [port]
will serve path (~ by default) at port (8000 by default).
As expressRestFs has been built as an express middleware, you can use it in your existing express application.
var express = require("express");
var app = express();
var expressRestFs = require("express-rest-fs");
app.use("/fs", expressRestFs({ basepath: "/home/" }));
/* your routing definition */
app.listen(8000);
The code above will serve your home
directory under /fs
url.
Exposed API
action | verb | operation | note |
---|---|---|---|
List Directory | GET | readdir | |
Retrieve file | GET | read | |
Stat file | GET | stat | must use ?stat |
Create File | POST | write | |
Create Directory | POST | mkdir | file name must finish with / |
Append to File | PUT | write | |
Update file timestamps | PATCH | utimes | |
Remove a file or directory | DELETE | unlink |
TODO:
- Testing
- Rethink status codes/responses
- Caching headers
- Resume
- ...