An SQL-backed store for the Annotator using Flask []
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
annotator [store][s+]: implement search properly (ported from old code) and add… Feb 18, 2011
db Save to an SQLite database instead Dec 10, 2010
.gitignore [gitignore][xs]: ignore *.pyc. Feb 18, 2011 Fix killer README typo! Feb 18, 2011
annotator.cfg.example Correct example config mountpoint Jun 9, 2011 Add command line interface to create and fetch consumers Dec 31, 2010
requirements Fix error when no TEST_CONSUMER defined in config. Jun 9, 2011

Annotator Store

This is a backend store for the Annotator.

Getting going

You'll need a recent version of python (>=2.6). This code relies on the flask and elixir libraries.

The quickest way to get going assumes you have the pip and virtualenv tools installed (protip: easy_install virtualenv will get them both). Run the following in the repository root:

pip -E pyenv install -r requirements
source pyenv/bin/activate
cp annotator.cfg.example annotator.cfg

You should see something like:

* Running on
* Restarting with reloader...

The annotation store, a JSON-speaking REST API, will be mounted at http://localhost:5000/store/annotations. You can test this by running:

$ curl -i http://localhost:5000/store/annotations
HTTP/1.0 200 OK
Content-Type: application/json
Access-Control-Allow-Origin: *
Access-Control-Expose-Headers: Location
Access-Control-Allow-Methods: GET, POST, PUT, DELETE
Access-Control-Max-Age: 86400
Content-Length: 2
Server: Werkzeug/0.6.2 Python/2.6.1
Date: Fri, 10 Dec 2010 11:44:33 GMT


The "[]" at the end indicates the empty list for your annotations. There are no annotations currently in the store. See the Annotator repository for details on getting an annotator talking to this backend.

Running tests

Running pip -E pyenv install -r requirements or similar, as described above, should have installed nose for you. In the virtualenv, you should be able to run the tests as follows:

$ nosetests
Ran 21 tests in 0.502s


Please open an issue if you find that the tests don't all pass on your machine, making sure to include the output of pip freeze.