Metadata-Version: 1.1
Name: chembl-beaker
Version: 0.2.7
Summary: RDKit in the Bottle on Tornado
Home-page: https://www.ebi.ac.uk/chembl/
Author: Michal Nowotka
Author-email: mnowotka@ebi.ac.uk
License: CC BY-SA 3.0
Description: chembl_beaker
        ======
        
        .. image:: https://upload.wikimedia.org/wikipedia/commons/thumb/c/c3/Beaker.svg/200px-Beaker.svg.png
            :alt: logo
        
        .. image:: https://pypip.in/v/chembl_beaker/badge.png
            :target: https://crate.io/packages/chembl_beaker/
            :alt: Latest PyPI version
            
        What is Beaker?
        --------
        
        This is chembl_beaker package developed at `Chembl <https://www.ebi.ac.uk/chembl/>`_ group, `EMBL-EBI <https://www.ebi.ac.uk/>`_, Cambridge, UK.
        
        This is wrapper for `RDKit <http://www.rdkit.org/>`_ and `OSRA <http://cactus.nci.nih.gov/osra/>`_, which exposes following RDKit functions:
        
         * Format convertion
         * Fingerprints
         * Descriptors
        
        As a portable lightweight webserver, speaking REST. This particular implementation wraps RDKit in `Bottle <http://bottlepy.org/docs/dev/>`_ on `Tornado <http://www.tornadoweb.org/en/stable/>`_.
        
        Where is it used?
        --------
        
        Beaker is used in `Clippy <https://github.com/madgpap/chembl_clippy>`_ project but can be used as a standalone web server as well.
        
        Software dependencies
        --------
        
         * `RDKit <http://www.rdkit.org/>`_
         * `OSRA <http://cactus.nci.nih.gov/osra/>`_
         * `Bottle <http://bottlepy.org/docs/dev/>`_
         * `Tornado <http://www.tornadoweb.org/en/stable/>`_
        
        Installation
        --------
        
        The best way to install beaker is to use `PIP`:
        
            ``pip install chembl_beaker``
            
        This command will install latest stable version with Bottle and Tornado. RDKit and OSRA must be installed separately.
        You can of course clone development version from github but it's not guaranteed to be working.
        
        Configuration
        --------
        By default configuration is stored in ``beaker.conf`` file, located in current directory. You can specify location of
        configuration file using ``--config (-c)`` parameter when running beaker. Configuration file format is standard ``*.ini``.
        Beaker is distributed with example configuration file named ``beaker.conf.sample``.
        
         * **debug** - run bottle server in debug mode (True/False, default ``True``)
         * **bottle_port** - number of porn on which Bottle server is listening for connections (integer, default ``8080``)
         * **bottle_host** - hostname of Bottle server (string, default ``localhost``)
         * **server_middleware** - networking middleware library used by Bottle (string, default ``tornado``)
         * **osra_binaries_location** - path to OSRA binary you want to use for compound recognition (string, default ``/usr/bin/osra``)
        
        Running
        --------
        If you want to play with beaker run ``python run_beaker.py``
        If you want to run beaker in production you should do this using virtualenv, uWSGI and NGINX as described `here <http://fclef.wordpress.com/2013/01/12/bottle-virtualenv-uwsgi-nginx-installation-on-ubuntu-12-04-1-lts/>`_. Other standard python deployment stacks will work as well.
        
        More info and help
        --------
        
        More information can be found in `web based presentation <http://mnowotka.github.io/presentations/beaker>`_. You can always email the author: mmmnow@gmail.com
        
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: Creative Commons :: Attribution-ShareAlike 3.0 Unported
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Scientific/Engineering :: Chemistry
