zopyx_gridfs 
============

This is a tiny GridFS (MongoDB) to web gateway based on the Pyramid 
web framework.

Installation
============

* requires Python 2.6
* create a virtualized environment using virtualenv
* inside the virtualenv environment::

    bin/easy_install zopyx_gridfs


* Create a ``server.ini`` configuration file containing::

    [app:zopyx_gridfs]
    use = egg:zopyx_gridfs
    reload_templates = true
    debug_authorization = false
    debug_notfound = false
    debug_routematch = false
    debug_templates = true
    default_locale_name = en
    # MongoDB specific configurations
    mongo_host = localhost
    mongo_port = 27017
    database = test

    [pipeline:main]
    pipeline =
        egg:WebError#evalerror
        zopyx_gridfs

    [server:main]
    use = egg:Paste#http
    host = 0.0.0.0
    port = 6543

    # Begin logging configuration

    [loggers]
    keys = root

    [handlers]
    keys = console

    [formatters]
    keys = generic

    [logger_root]
    level = INFO
    handlers = console

    [handler_console]
    class = StreamHandler
    args = (sys.stderr,)
    level = NOTSET
    formatter = generic

    [formatter_generic]
    format = %(asctime)s %(levelname)-5.5s [%(name)s][%(threadName)s] %(message)s


* Start the GridFS server using (this will start a HTTP
  server on localhost:6543)::

    bin/paster serve server.ini


Usage:
======

You can access file stored inside GridFS through HTTP::

   http://localhost:6543/?filename=<filename>&collection=<collectionname>

``collection`` is optional and defaults to ``files```.
The server will return a 404 response if the requested file could not be found.


Author
======

| ZOPYX Limited
| c/o Andreas Jung
| Charlottenstr. 37/1
| D-72070 Tuebingen, Germany
| www.zopyx.com
| info@zopyx.com
