You will need couchdb to make it run:
apt-get install couchdb
The first time you push the couch, the coconut db will be created for you. You can also create a new database using futon, the handy couchdb GUI by clicking here: futon on localhost, or by running this curl command:
curl -X PUT http://localhost:5984/coconut
To get Coconut working you need to put the files in this directory into a couchdb database. You can accomplish this by using the couchapp tool.
apt-get install couchapp
Now we can use couchapp to push the files into your database:
couchapp push
Now you can point your browser at the Coconut
You may wish to customise the .couchapprc file to point to different targets.
CouchDB, Backbone.js, backbone-couchdb, json, fermented eyebrow sweat, fairy dust.
All of the backbone models and views have their own file and are in app/models and app/views respectively. app/app.js is responsible for tying it all together.
You can put json forms into the _docs directory and they will be added to your couch when you do a couchapp push.
FormView loads the form.template.html, which provides the formElements div, where each form element is appended. FormView's render function loops through each of the formElements using the addOne function. AddOne sets up the table and inserts new rows when a formelement's closeRow == "true". It also renders a few other special widgets, such as headers and hidden fields. Most form elements are inserted using the following code:
currentParent.append((new FormElementView({model: formElement})).render().el);
Note how the currentParentName is saved in FormView's currentParentName field - this shows where the element should be appended.
FormElementView renders each element inside a td using the form-element-template, which calls the {{{renderWidget}}} tag. Handlebars.registerHelper("renderWidget"... in formElementRender.js uses the relevant template based on the inputType for the element. Each widget is pre-compiled before the loop:
inputTextWidgetCompiledHtml = Handlebars.compile($("#inputTextWidget").html());
datepickerWidgetCompiledHtml = Handlebars.compile($("#datepickerWidget").html());
checkboxWidgetCompiledHtml = Handlebars.compile($("#checkboxWidget").html());
Look at the index2.html example. Each widget has its own handlebars.js template (see inputTextWidget).
<script id="dropdownWidget" type="text/x-handlebars-template">
{{#dropdown enumerations}}
{{/dropdown}}
</script>
Performance test is at http://jsperf.com/test-pre-compiling-handlebars-js-templates
In the current example, the forms are PatientRegistration and ArrestDocket.js.
app.js constructs the Backbone.Router. List the routes in the routes method:
routes: {
"home": "home", // #home
"newPatient": "newPatient", // #newPatient
"arrestDocket": "arrestDocket", // #arrestDocket
"*actions": "defaultRoute" // matches http://example.com/#anything-here
}
and create a method for each route:
newPatient: function () {
registration = new Form({_id: "PatientRegistration"});
registration.fetch({
success: function(model){
(new FormView({model: model})).render();
}
});
},
Incident id's are generated using update_seq by doing a GET on the db and (TBD) appending it to the site ID; however, I am slightly concerned about concurrentcy issues. But this would not happen on a couch instance on a mobile phone.
var info = $.couch.db(Backbone.couch_connector.config.db_name).info(
{
success : function(resp){
console.log("info: " + JSON.stringify(resp));
var doc_count = resp["doc_count"];
var doc_del_count = resp["doc_del_count"];
var assignedId = doc_count + doc_del_count;
console.log("assignedId: " + assignedId);
formData.assignedId = assignedId;
// now save it... See FormView.js
}
http://wiki.apache.org/couchdb/HTTP_database_API
Generating sequences in CouchDB goes against the grain of couch; note that this approach is only good per instance. Useful discussion here:
Also considered getting a substring of the sequential uuid - truncate the first 24 characters. More info on sequential uuids:
It's a pain to run 'couchapp push' everytime you make a change. Mike wrote a little watchr script that watches for changes to any relevant files and then automatically pushes them into your couch. To get it you need to install rubygems and watchr:
apt-get install rubygems
gem install watchr
Check out the project's issues. Please help me fix issues and add any problem that you come across.