X-Git-Url: http://git.rot13.org/?p=angular-mojolicious.git;a=blobdiff_plain;f=README;h=9dfe96b195270af45f7e3547e1a408b35be12e95;hp=442a5271e3e02ccb4dcf5559af383ae54771dda0;hb=00f4fc390e4d8e1247f3e815ba5c20765dc17020;hpb=6dbe337c654165cd9decf462b2280d9fb7ccc8fd diff --git a/README b/README index 442a527..9dfe96b 100644 --- a/README +++ b/README @@ -13,8 +13,30 @@ This is my attempt to implement REST API described at: http://docs.getangular.com/REST.Basic -using simple in-memory model for experimenting with local datasets using - +using CouchDB HTTP view API + +http://wiki.apache.org/couchdb/HTTP_view_API + +to provide storage for experimenting with local datasets using angular $resource API. +You can also query CouchDB views $xhr("JSON", ...) in angular through angular-server.pl + + +At it's current stage it provides support for angular $resource get, query and $save + +http://angularjs.org/Service:$resource + + +Replication of data between instances using angular REST API can be done with: + + # create local CouchDB database + curl -X PUT http://localhost:5984/test + + ./angular-replicate.pl \ + http://dpavlin.getangular.com/data/conference \ + http://localhost:3000/data/test + +Replication is currently good only for initial import of data since it doesn't +support incremental replication and dies if data is allready present. Installation: @@ -36,10 +58,42 @@ Start it with: Angular examples available: - template/Cookbook - examples from wiki working against github version of angular -- template/Work - conference submission example using mojolicious REST API server +- template/conferece - conference submission example using mojolicious REST API server +- public/app/conference - new application layout with latest example confernce submission + + curl -X PUT http://localhost:5984/conference/_design/symposium \ + -d @public/app/conference/_design/symposium + + + +CouchDB examples: + + couchdb-changes.pl - simple _changes feed watcher using Mojo::Client documented at + + http://wiki.apache.org/couchdb/HTTP_database_API#Changes + + + couchdb-trigger.pl - FSM document with hook for user-defiend triggers + + trigger/shell.pm - execute shell commands + trigger/email.pm - skeleton for sending e-email + trigger/KinoSearch.pm - full-text search + + $ curl -X PUT http://localhost:5984/trigger_demo + {"ok":true} + + $ ./couchdb-trigger.pl http://localhost:5984/trigger_demo trigger/shell.pm + + $ curl -X PUT http://localhost:5984/trigger_demo/t1 -d '{"trigger":{"command":"notify-send CouchDB t1"}}' + + + couchdb-external-kinosearch.pl - external searcher for KinoSearch indexes + (configuration for CouchDB is included at end of file) -Planned features: +Roadmap: -- data persistence, probably to CouchDB (currently all data is stored in-memory) -- run queries against data using REST API (currently only simple get is supported) ++ implement angular-server.pl which implements REST API supported by $resource in angular ++ persistency to local CouchDB, and use views to query data ++ implement CouchDB _changes and FSM inside document as base for queue or triggers +- tests