hfs 0.1.6 → 0.26.2

package/admin-server.js

@@ -1,212 +0,0 @@
-/**
- * @fileOverview This serves the back-end GUI and all it needs to perform server-side actions. 
- * @author Massimo Melina <a@rejetto.com> 
- */ 
-var http = require('http');
-var socket_io = require('socket.io');
-var serving = require('./lib/serving');
-
-exports.start = function(listenOn) {
-    srv.listen(listenOn.port, listenOn.ip, function(){
-        dbg('listening on port '+listenOn.port);
-    });
-}
-
-var srv = http.createServer(function(httpReq,httpRes){
-    if (!serving.parseUrl(httpReq)) return;
-
-    /*
-    var peer = httpReq.socket.address(); //  bug: currently peer.port is our listening port, while we want to show the port of the socket serving the connection 
-    dbg('serving '+peer.address+':'+peer.port+' '+httpReq.url);
-    */
-
-    if (serving.serveStatic(httpReq, httpRes)) return; // access to the special 'static' folder
-    if (httpReq.uri == '/') {
-        serving.serveFile('static/backend.html', httpRes);
-        return;
-    }
-    serve404(httpRes); // we serve nothing else
-});
-
-srv.on('error', function(err){
-    switch (err.code) {
-        case 'EADDRINUSE':
-            return dbg('port '+listenOn.port+' busy');
-    }
-});
-
-/* converts FileNode to an object that's ready to be streamed to the back-end.
-    @param {number} depth specifies how many levels of children should be included in the structure.
-    @param {function} cb is necessary if you specify a depth that's more than zero
-    @return the object representing the FileNode if no depth is specified. Otherwise the returning turns into
-        an async fashion and you need to specify a callback to retrieve the result.    
-*/
-function nodeToObject(fnode, depth, cb) {
-    assert(!cb || typeof cb == 'function', 'cb');
-    if (!fnode) {
-        if (cb) cb(false);
-        return false;
-    }
-    assert(fnode instanceof vfsLib.FileNode, 'fnode');
-
-    var res = ceLib.extenduptolevel({name:fnode.name}, fnode, 1); // make a copy of the whole object without recurring, and overwriting the getter 'name'
-    delete res._parent;  // this makes a circular reference
-    delete res.children; // in case we want the true listing, not just the children  
-    delete res.customName;
-    // save bandwidth by not sending some empty properties
-    if (res.deletedItems
-    && !res.deletedItems.length) {
-        delete res.deletedItems; 
-    }
-    if (!res.resource) {
-        delete res.resource;
-    }
-    // depth is not required, or not possible, our job ends here
-    if (!depth
-    || !fnode.isFolder()) {
-        if (cb) cb(res);
-        return res;    
-    }
-    // this is necessarily an async procedure: require a callback
-    assert(cb, 'cb');
-    // recur on children
-    fnode.dir(function(items){
-        res.children = [];
-        async.forEach(items.getProperties(), function(e, doneThis){
-            nodeToObject(e, depth-1, function(obj){
-                res.children.push(obj);
-                doneThis();
-            });                    
-        }, cb.bind(this,res));
-    });
-} // nodeToObject
-
-/*
-    SET UP SOCKET.IO
-*/
-
-var io = exports.io = socket_io.listen(srv);
-serving.setupSocketIO(io);
-io.sockets.on('connection', function(socket){
-    
-    socket.on('vfs.get', function onGet(data, cb) {
-        if (serving.ioError(!data ? data
-            : typeof data.uri != 'string' ? 'uri'
-            : null, cb)) return;
-            
-        vfs.fromUrl(data.uri, function(fnode) {
-            nodeToObject(fnode, data.depth, cb);                
-        });
-    });
-
-    // set properties of a vfs item
-    socket.on('vfs.set', function onSet(data, cb){
-        // assertions
-        if (serving.ioError(!data ? 'data'
-            : typeof data.uri != 'string' ? 'uri'
-            : null, cb)) return;
-            
-        vfs.fromUrl(data.uri, function(fnode) {
-            if (!fnode) {
-                serving.ioError('not found');
-                return;
-            }
-            if (data.name) {
-                if (serving.ioError(typeof data.name != 'string' ? 'name' : null, cb)) return;
-                fnode.name = data.name;
-                serving.ioOk(cb);
-            }
-            else if (data.resource) {
-                if (serving.ioError(typeof data.resource != 'string' ? 'resource' : null, cb)) return;
-                fnode.set(data.resource, serving.ioOk.bind(this,cb));
-            }
-            notifyVfsChange(socket, fnode.getURI().excludeTrailing('/'));
-        });
-    });
-    
-    // add an item to the vfs
-    socket.on('vfs.add', function onAdd(data, cb){
-        // assertions
-        if (serving.ioError(!data ? 'data'
-            : typeof data.uri !== 'string' ? 'uri'
-            : typeof data.resource !== 'string' ? 'resource'
-            : null, cb)) return;
-
-        vfs.fromUrl(data.uri, function(fnode) {
-            if (!fnode) {
-                serving.ioError('uri not found', cb);
-                return;
-            }
-            var already = fnode.getChildByName(path.basename(data.resource)); // check if it already exists
-            if (already) {
-                serving.ioError('already exists', cb);
-                return;
-            }            
-            fnode.add(data.resource, function(newNode){
-                serving.ioOk(cb, {item:nodeToObject(newNode)});
-                notifyVfsChange(socket, data.uri);
-            });  
-        });
-    });
-    
-    // delete item, make it non-existent in the VFS
-    socket.on('vfs.delete', function onRemove(data, cb){
-        // assertions
-        if (serving.ioError(!data ? 'data'
-            : typeof data.uri !== 'string' ? 'uri'
-            : null, cb)) return;
-
-        vfs.fromUrl(data.uri, function(fnode){
-            if (!fnode) {
-                serving.ioError('uri not found', cb)
-                return;
-            }
-            fnode.getFolder(function(folder){
-                fnode.delete();
-                // if we just deleted a dynamic item, the GUI may need an extra refresh
-                serving.ioOk(cb, {
-                    dynamicItem: fnode.isTemp() && path.basename(fnode.resource)+(fnode.isFolder() ? '/' : ''), // trailing slash to denote folders
-                    folderDeletedCount: folder.deletedItems ? folder.deletedItems.length : 0
-                });
-                notifyVfsChange(socket, folder.getURI()); 
-            });
-        });
-    });
-
-    // restore a temp item that was deleted
-    socket.on('vfs.restore', function onRestore(data, cb){
-        // assertions
-        if (serving.ioError(!data ? 'data'
-            : typeof data.uri !== 'string' ? 'uri'
-            : typeof data.resource !== 'string' ? 'resource'
-            : null, cb)) return;
-
-        vfs.fromUrl(data.uri, function(fnode){
-            if (!fnode) {
-                serving.ioError('uri not found', cb)
-                return;
-            }
-            if (!fnode.restoreDeleted(data.resource)) {
-                serving.ioError('failed');
-                return;
-            }
-            fnode.createFileNodeFromRelativeUri(data.resource, function(child){
-                serving.ioOk(cb, {item:child});
-                notifyVfsChange(socket, fnode.getURI());
-            });
-        });
-    });
-    
-    socket.on('info.get', function onInfo(data, cb){
-        serving.ioOk(cb, {caseSensitiveFileNames:misc.caseSensitiveFileNames});
-    });
-    
-});
-
-notifyVfsChange = function(socket, uri) {
-    dbg('vfs.changed');
-    [socket.broadcast, require('./file-server').io.sockets].forEach(function(o){
-        o.emit('vfs.changed', {uri:uri});
-    });
-}; // notifyVfsChange
-

package/cli.js

@@ -1,33 +0,0 @@
-/**
- * @fileOverview command line interface to the server 
- * @author Massimo Melina <a@rejetto.com> 
- */ 
-require('./lib/common');
-var socket_io = require('socket.io-client');
-
-// read arguments
-var v = process.argv;
-if (v.length < 3) { // quick help
-    log('Usage: node '+path.basename(v[1])+' <path>');
-    return;
-}  
-var fpath = v[2];
-var under = v.length < 4 ? '/' : v[3];
-
-// connect to admin-server 
-var socket = socket_io.connect('http://localhost:88'); 
-socket.on('connect', function () {
-    // ask to add this file
-    socket.emit('vfs.add', {uri:under, resource:fpath, depth:1}, function(data){
-        if (!data) {
-            log('communication error');
-            process.exit(1);
-        }
-        if (!data.ok) {
-            log('error: '+(data.error || 'generic'));
-            process.exit(2);
-        } 
-        socket.disconnect();
-        process.exit(0);
-    });
-});

package/file-server.js

@@ -1,100 +0,0 @@
-/**
- * @fileOverview This serves the front-end GUI and all it needs to perform server-side actions. 
- * @author Massimo Melina <a@rejetto.com> 
- */ 
-var http = require('http');
-var socket_io = require('socket.io');
-var serving = require('./lib/serving');
-
-exports.start = function(listenOn) {
-    listeningOn = listenOn;
-    srv.listen(listenOn.port, listenOn.ip, function onListen(){
-        dbg('listening on port '+listenOn.port);
-    });
-};
-
-/*
-   SET UP THE HTTP SERVER
-*/
-
-var listeningOn; // keep track of the tcp coordinates we are currently accepting requests 
-
-var srv = http.createServer(function(httpReq,httpRes){
-    if (!serving.parseUrl(httpReq)) return;        
-
-    var peer = httpReq.socket.address();
-    dbg('serving '+peer.address+':'+peer.port+' '+httpReq.url);
-
-    serving.serveStatic(httpReq, httpRes)
-        || serveFromVFS(httpReq, httpRes);
-
-});
-
-srv.on('error', function(err){
-    switch (err.code) {
-        case 'EADDRINUSE':
-            return dbg('port '+listeningOn.port+' busy');
-    }
-});
-
-/*
-    SET UP SOCKET.IO
-*/
-
-var io = exports.io = socket_io.listen(srv);
-serving.setupSocketIO(io);
-io.sockets.on('connection', function(socket){
-    //** sequences like these may be better with Step(). Try 
-    socket.on('get list', function onGetList(data, cb){
-        vfs.fromUrl(data.path, function(fnode) {
-            getReplyForFolder(fnode, serving.ioOk.bind(this,cb));  
-        });
-    });
-});
-
-//////////////////////////////
-
-function getReplyForFolder(folder, cb) {
-    if (!folder) {
-        return cb({error:'not found'});
-    }
-    folder.dir(function(items){
-        assert(items, 'items');                
-        // convert items to a simpler format
-        items.forEach(function(f,name){
-            // we'll use short key names to save bandwidth on common fieldnames.
-            var it = items[name] = {};
-            // type
-            it.t = f.itemKind.replace('virtual ',''); // this is a quick and dirty method to get value as file|folder|link
-            // size
-            if (f.isOnDisk())
-                it.s = f.stats.size;
-        });//forEach
-
-        cb({items:items});    
-    });//dir
-} // getReplyForFolder
-
-function serveFromVFS(httpReq, httpRes) {
-    vfs.fromUrl(httpReq.uri, function urlCB(node){
-        if (!node) {
-            httpRes.writeHead(404);
-            return httpRes.end();
-        }
-
-        if (node.isFile()) {
-            return serving.serveFile(node.resource, httpRes, node.stats.size);  
-        }
-        
-        assert(node.isFolder(), 'must be folder');
-        // force trailing slash
-        if (httpReq.url.substr(-1) != '/') { 
-            httpRes.writeHead(301, {
-                'Location': httpReq.url+'/'
-            });
-            return httpRes.end();
-        }
-        
-        serving.serveFile('static/frontend.html', httpRes)
-    });
-} // serveFromVFS

package/lib/common.js

@@ -1,10 +0,0 @@
-require('./extending');
-GLOBAL.path = require('path');
-GLOBAL.util = require('util');
-GLOBAL.os = require('os');
-GLOBAL.fs = require('fs');
-GLOBAL.assert = require('assert');
-GLOBAL.ceLib = require('cloneextend');
-GLOBAL.misc = require('./misc');
-GLOBAL.vfsLib = require('./vfs');
-GLOBAL.async = require('async');

package/lib/extending.js

@@ -1,158 +0,0 @@
-///////// EXTENDING FUNCTION
-
-/** as function.bind(), but additional parameters are prepended instead of appended 
- * @return {function} proxied function
- */ 
-Function.prototype.prebind = function(){
-    var args = Array.prototype.slice.call(arguments);
-    var scope = args.shift();
-    var fun = this;  
-    return function(){
-        var moreArgs = Array.prototype.slice.call(arguments);
-        fun.apply(scope, moreArgs.concat(args));
-    };
-};
-
-///////// EXTENDING STRING
-
-/* return a new string filling "this" with arguments' values.
-    The filling is done in place of strings in this form {key} or this other form {key|parameter}.
-    If first argument is an object, then "key" is used as field name (i.e. property) of the object.
-    Otherwise "key" should be a number, and it's the argument's index (zero-based).  
-    As stated before, keys can have a parameter. If such parameter is in the form \d*-\d* then these numbers
-    denote a range of characters to extract (i.e. a substring). Otherwise the parameter is a property name for
-    the value (that must be an object or an array in this case).
-*/
-String.prototype.format = function() {
-    var args = arguments;
-    if (typeof args[0] == 'object')
-        args = args[0];
-    return this.replace(/\{([-_ a-z0-9]+)(\|([^}]+))?\}/gi, function(){
-        var ret = args[arguments[1]];
-        var par = arguments[3]; 
-        if (par) {
-            var v = /(\d*)-(\d*)/.exec(par); // is it in the "range" form?
-            if (v) ret = ret.substring(v[1]-1 || 0, v[2] || ret.length); // extract the substring in range 
-            else ret = ret[par]; // get property
-        }
-        return ret; 
-    });
-};
-
-String.prototype.repeat = function(n) {
-    var r = '';
-    for (var i=0; i<n; i++) r += this;
-    return r;
-};
-
-String.prototype.count = function(sub) {
-    return this.split(sub).length-1;
-};
-
-String.prototype.ss = function(from, to) {
-    return this.substring(from<0 ? this.length-from : from, to<0 ? this.length+to : to);
-};
-
-String.prototype.pad = function(lngt, filler) {
-    return (filler || ' ').repeat(Math.max(0,lngt - this.length)) + this;
-};
-
-String.prototype.escapeRegExp = function() {
-    return this.replace(/[-[\]{}()*+?.,\\^$|#\s]/g, '\\$&');
-};
-
-String.prototype.startsBy = function(sub, caseInsensitive) {
-    return 0 <= this.search(new RegExp('^'+sub.escapeRegExp(), caseInsensitive ? 'i' : ''));  
-};
- 
-String.prototype.endsBy = function(sub, caseInsensitive) {
-    return 0 <= this.search(new RegExp(sub.escapeRegExp()+'$', caseInsensitive ? 'i' : ''));  
-};
-
-String.prototype.includeLeading = function(sub) { return this.startsBy(sub) ? this : sub+this }; 
-String.prototype.includeTrailing = function(sub) { return this.endsBy(sub) ? this : this+sub };
-// if in the following function the casting to string is not made, the resulting typeof is 'object' instead of 'string' (causing problems in some cases, e.g. using path.join)
-String.prototype.excludeLeading = function(sub) { return this.startsBy(sub) ? this.slice(sub.length) : ''+this }; 
-String.prototype.excludeTrailing = function(sub) { return this.endsBy(sub) ? this.slice(0,-sub.length) : ''+this }; 
-
-// handy shortcuts
-String.prototype.low = String.prototype.toLowerCase;
-String.prototype.up = String.prototype.toUpperCase;
-
-// case insensitive test
-String.prototype.same = function(s){
-    return typeof s === 'string' 
-        && this.length === s.length 
-        && this.low() === s.low()
-}; // String.same
-
-String.prototype.in = function(s) {
-    switch (typeof s) {
-        case 'array':
-        case 'string': return s.indexOf(this) >= 0;
-        default: return false;
-    }    
-}; // String.in  
-
-///////// EXTENDING OBJECT
-
-function extendObject(key, value) {
-    Object.defineProperty(Object.prototype, key, {
-        enumerable: false,    
-        value: value
-    });
-} // extendObject
-
-extendObject('getKeyOf', function(value) {
-    for (var i in this)
-        if (this.hasOwnProperty(i) 
-        && this[i] === value)
-            return i;
-    return null; 
-}); // Object.getKeyOf
-
-extendObject('forEach', function(cb) {
-    for (var i in this)
-        if (this.hasOwnProperty(i))
-            cb.call(this, this[i], i);
-}); // Object.forEach
-
-extendObject('isIn', function(vals) {
-    if (arguments.length == 1) {
-        return Array.isArray(vals)
-            ? vals.indexOf(this) >= 0
-            : vals.keyOf(this) !== null;   
-    }
-    for (var i in arguments)    
-        if (arguments[i] == this)
-            return true;
-    return false;    
-}); // Object.isIn
-
-extendObject('extend', function(from) {
-    var props = Object.getOwnPropertyNames(from);
-    var dest = this;
-    props.forEach(function(name) {
-        var setter = dest.__lookupSetter__(name);
-        if (setter) {        
-            setter.call(dest, from[name]);
-        }
-        else if (name in dest) {
-            var destination = Object.getOwnPropertyDescriptor(from, name);
-            Object.defineProperty(dest, name, destination);
-        }
-        else {
-            dest[name] = from[name];
-        }
-    });
-    return this;
-}); // Object.extend
-
-
-extendObject('getProperties', function(){
-    var res = [];
-    for (var i in this)
-        if (this.hasOwnProperty(i))
-            res.push(this[i]);
-    return res; 
-}); // Object.getProperties

package/lib/mime.js

@@ -1,19 +0,0 @@
-var types = exports.types = {
-    'jpg,jpeg': 'image/jpeg',
-    'gif': 'image/gif',
-    'png': 'image/png',
-    'css': 'text/css',
-    'js' : 'text/javascript',
-    'avi': 'video/avi',
-    'html': 'text/html', 
-};
-
-exports.fromFile = function(file){
-    var ext = path.extname(file).substr(1).low();
-    for (var w in types) {
-        if (w.split(',').indexOf(ext) >= 0) {
-            return types[w];
-        }
-    }
-    return false;
-}; // fromFile

package/lib/misc.js

@@ -1,75 +0,0 @@
-//// PROJECT-WIDE FUNCTIONS
-
-ceLib = require('cloneextend');
-
-////// FIRST, UTILITIES WE WANT TO BE GLOBAL
-
-GLOBAL.ABCifB = function(a,b,c) { return b ? ''+a+b+(c||'') : ''; } 
-
-// like console.log but better: outputs multiple parameters and returns first one, so you can concatenate
-GLOBAL.log = function() {
-    var last;
-    for (var k in arguments) {
-        console.log(last = arguments[k]);
-    }
-    return last;
-}; // log
-
-// outputs to console and to a file (that's cleared at first writing). If 2 parameters are supplied, the first is a label to the data. 
-GLOBAL.dbg = function(/*pre, */s) {
-    var pre = '';
-    if (arguments.length === 2) {
-        pre = arguments[0]+': ';
-        s = arguments[1];
-    }
-    var self = arguments.callee;
-    if (!self.once) {
-        self.once = 1;
-        self.fn = 'dbg.txt';
-        try { fs.unlinkSync(self.fn); } // this happens only once, who cares if it's blocking
-        catch(err) {}
-    }
-    var stream = fs.createWriteStream(self.fn, {flags:'a'});
-    stream.write(pre+s+"\n");
-    stream.end();
-    console.log('DBG) ', pre, s);
-    return s;
-}; // dbg
-
-// used as a weaker assert() that doesn't stop execution
-GLOBAL.warning = function(condition, message){ if (!condition) dbg('Condition not met',message) };
-
-/*
-meant to implement Enum's. You can pass every value as a separate parameter, or as a single parameter with space as a separator.
-It returns an object with enum's values as keys, and coupled values are a "nicer".
-*/
-GLOBAL.Enum = function() {
-    var a = (arguments.length === 1) ? arguments[0].split(' ') : arguments;
-    var res = {};
-    for (var i=0,l=a.length; i<l; ++i) {
-        res[a[i]] = a[i].toLowerCase().replace('_',' '); // valore descrittivo, utile per eventuali output
-    }
-    return res; 
-}; // Enum
-
-// type-independent size calculation (currently accepting array's and object's)
-GLOBAL.sizeOf = function(o) {
-    if (util.isArray(o))
-        return o.length;
-    return Object.keys(o).length;  
-}; // sizeOf
-
-exports.clone = ceLib.clone; 
-//exports.extend = ceLib.extend.bind(ceLib);   we are currently using {}.extend instead of this 
-
-exports.isWindows = os.platform() === 'win32';
-exports.caseSensitiveFileNames = !exports.isWindows;
-
-exports.sameFileName = function(a,b) {
-    return exports.caseSensitiveFileNames ? a === b : a && a.same(b);
-}; // sameFileName
-
-exports.round = function(v, decimals) {
-    decimals = Math.pow(10, decimals||0);
-    return Math.round(v*decimals)/decimals;
-} // round

package/lib/serving.js

@@ -1,81 +0,0 @@
-require('./common');
-var mime = require('./mime');
-var url = require('url');
-
-exports.serveFile = serveFile = function(file, httpRes, size, mime_) {
-    fs.exists(file, function(exists) {
-        if (!exists) {
-            serve404(httpRes);
-            return;
-        }
-        var stream = fs.createReadStream(file);
-        var headers = {
-            'Content-Type': mime_ || mime.fromFile(file) || 'application/octet-stream'
-        };
-        if (size) {
-            headers['Content-Length'] = size;
-        }
-        httpRes.writeHead(200, headers);
-        stream.pipe(httpRes);
-    });
-}; // serveFile
-
-exports.serve404 = serve404 = function(httpRes) {
-    httpRes.writeHead(404);
-    httpRes.end();
-} // serve404
-
-exports.serveStatic = function(httpReq, httpRes) {
-    if (httpReq.uri.substr(0,3) === '/~/') {
-        serveFile('static'+httpReq.uri.substr(2), httpRes);
-        return true;
-    }
-    return false;
-}; // serveStatic
-
-exports.parseUrl = function(httpReq) {
-    httpReq.parsedUrl = url.parse(httpReq.url, true);
-    with (httpReq.parsedUrl) pathname = decodeURI(pathname);
-    httpReq.uri = httpReq.parsedUrl.pathname; // a shortcut, since this is often accessed 
-
-    // check for directory crossing
-    if (httpReq.uri.indexOf('..') >= 0) {
-        httpRes.writeHead(500);
-        httpRes.end('Xdir');
-        return false;
-    }
-    
-    return true;
-}; // parseUrl
-
-// a standardized way to report an assertions' errors over socket.io
-exports.ioError = function(message, cb, more) {
-    if (!cb) return;
-    assert(typeof cb === 'function', 'cb');
-    if (message) {
-        if (cb) cb({ok:false, error:message}.extend(more||{}));
-        return true;
-    }
-    return false;    
-}; // ioError 
-
-exports.ioOk = ioOk = function(cb, more) {
-    if (!cb) return;
-    assert(typeof cb === 'function', 'cb');
-    cb({ok:true}.extend(more||{}));
-}; // ioOk
-
-exports.setupSocketIO = function(io) {
-    io.enable('browser client minification');  // send minified client
-    io.enable('browser client etag');          // apply etag caching logic based on version number
-    io.enable('browser client gzip');          // gzip the file
-    io.set('log level', 1);                    // reduce logging
-    // this next command is giving a warning. Disabled for now.
-    /*io.set('transports', [                     // enable all transports (optional if you want flashsocket)
-        'websocket'
-      , 'flashsocket'
-      , 'htmlfile'
-      , 'xhr-polling'
-      , 'jsonp-polling'
-    ]);*/
-}; // setupSocketIO