oyster/README.rst

32 lines
876 B
ReStructuredText
Raw Normal View History

2011-07-28 18:47:43 +00:00
======
oyster
======
oyster is a service for tracking regularly-accessed pages, a sort of proactive cache.
2011-09-20 21:15:15 +00:00
Oyster intends to provide a command line client for interacting with the list of tracked documents and web frontend for viewing the status and retrieving data. Behind the scenes it uses a celery queue to manage the documents it is tasked with keeping up to date.
2011-07-28 18:47:43 +00:00
oyster was created by James Turk for `Sunlight Labs <http://sunlightlabs.com>`_.
Source is available via `GitHub <http://github.com/sunlightlabs/oyster/>`_
## ADD PyPI link after release
Installation
============
Requirements
------------
* python 2.7
* mongodb 1.8
* pymongo 1.11
2011-09-20 20:16:55 +00:00
* scrapelib 0.5.5
Usage
=====
* Run celeryd with beat ``celeryd -B --config=oyster.celeryconfig``
* Run oyster HTTP portal ``python oyster/web.py``
2011-09-20 20:16:55 +00:00
* Use oyster.client.Client to add new documents & query the store