deepjs

Atomic tools for better programming

#deepjs

deepjs core (this lib) provides a set of quite atomic tools for better programming.

Alone, deepjs core library does not provides anything but nice, fast and lightweight tools that allow you to develop your OWN application faster.

Above all, it will help you in design, architecture and concurrent run-time management of your OWN app.

Based on Layered and Chained Programmation approach, it provides, uses and mixes :

  • Layered Aspect Oriented Programmation
  • Query Based Programmation including Code Sheet
  • Object Capability Model (or Management)
  • Full promised and chained asynch management
  • Homogeneous HTTP/Rest ressources management
  • Modularisation by Protocol approach
  • Concurrent context management

It works both server side and browser side. Its aim is to be totaly unobstrusive, ergonomic as possible and usable with any other js lib/framework. It wants also to be absolutly homogeneous (isomorphic) between server and browser sides.

As jquery (that is highly unobstrusive and ergonomic) works on standard DOM objects, deepjs works with any standard js objects and functions, and has a minimal footprint.

Real huge thanks, amoung others, to Kris Zyp and all his incredible work on promises, json-schema, compositions, RQL, OCM, Persvr, etc. Thanks also a lot to his bunch of articles on Thin-Server, No-SQL, mVC, etc. and all those realy smart architecural considerations that lead us trough our research...

deepjs : made with love.

 
var http = require('http');
var deep = require('deepjs'); // the core 
require('deep-restful'); // homogeneous restful API 
require('deep-restful/lib/collection'); // simple memory collection 
 
deep.Collection("myobjects", []);
 
var titles = ["hello", "deepjs", "world"];
var count = 0;
 
http.createServer(function (reqresponse) {
    deep
    .restful("myobjects")
    .post({ title:titles[++count%3], count:count })
    .get(String(req.url).substring(1))
    .done(function(res){
        response.writeHead(200, {'Content-Type': 'application/json'});
        response.end(JSON.stringify(res));
    })
    .fail(function(error){
        console.log("error : ", error.toString());
        response.writeHead(error.status || 500, {'Content-Type': 'application/json'});
        response.end(JSON.stringify(error));
    });
})
.listen(1337, '127.0.0.1');
 
console.log('Server running at http://127.0.0.1:1337/');
 

Then, open your browser, go to http://127.0.0.1:1337/, refresh few times, and try :

http://127.0.0.1:1337/an_id_of_an_item_in_collection or http://127.0.0.1:1337/?title=deepjs or http://127.0.0.1:1337/?count=lt=2

 
    //-----------------Models 
    var land = {
        location : "pls override this value with your own location",
        watering : function () {
            console.log("Water is applied on all the land");
        }
    };
    //-----------------Aspects 
    var orchard = {
        plants : [{uri:"appletree",growSpeed:10}],
        watering : deep.compose.after(function () {
            console.log("We put some mulch after watering");
        })
    };
 
    var kitchenGarden = {
        plants : [{uri:"carrots",growSpeed:6}],
        watering : deep.compose.before(function () {
            console.log("We protect seedlings before watering");
        })
    };
    //-----------------Implement 
 
    var myOwnLand = {
        location : "Sao Francisco do Guaporé",
        plants : [{uri:"grass",growSpeed:2}]
    };
 
    deep(myOwnLand)
    .bottom(land)
    .up(orchard,kitchenGarden)
    //Query based object modelisation 
    .query("/plants/*").up({
        size : 0,
        grow : function () {
            this.size += this.growSpeed;
        },
        prune : function (heightpruned) {
            this.size -= heightpruned;
        }
    });
 
 
    console.log("myOwnLand is : ", myOwnLand);
    myOwnLand.watering();
 
    //Query based object manipulation 
    deep(myOwnLand)
    .query("/plants/*")
    .run("grow")
    .query("/plants/*?size=gt=5")
    .run("prune",[2]);
 
    console.log("myOwnLand is : ", myOwnLand);
 

See tutorials page for details. (warning : documentation partially deprecated. offical website is on the way...;))