Metadata-Version: 2.0
Name: adamalib
Version: 0.1.0
Summary: Adama Library
Home-page: https://github.com/Arabidopsis-Information-Portal/adamalib
Author: John Gentle
Author-email: jgentle@tacc.utexas.edu
License: BSD
Download-URL: https://github.com/Arabidopsis-Information-Portal/adamalib
Keywords: adamalib
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Requires-Dist: PyYAML (==3.11)
Requires-Dist: decorator (==3.4.2)
Requires-Dist: lxml (==3.4.4)
Requires-Dist: networkx (==1.9.1)
Requires-Dist: prov (==1.3.1)
Requires-Dist: py (==1.4.26)
Requires-Dist: pytest (==2.6.4)
Requires-Dist: python-dateutil (==2.4.2)
Requires-Dist: requests (==2.6.0)
Requires-Dist: six (==1.9.0)
Requires-Dist: wheel (==0.24.0)

===============================
Adama Library
===============================

`Adamalib` provides a Python library/SDK for interacting with Adama_.
It is designed to be used as a standalone library in the user's local machine to develop Adama microservices.

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

Use `pip`::

  pip install git+git://github.com/Arabidopsis-Information-Portal/adamalib.git

It'll be moved to PyPI as soon as it reaches some stability.

As an alternative, see `using adamalib in Docker`_  below.


Using adamalib in Docker
========================

This repository includes a ``Dockerfile`` and a ``docker-compose.yml``
file, which allows a zero installation version of ``adamalib``.

The only requirement is Docker_ and `docker-compose`_, most likely
already installed in your system.

Then, clone this repository and execute ``docker-compose`` as follows:

.. code-block:: bash

   $ git clone https://github.com/Arabidopsis-Information-Portal/adamalib.git
   $ cd adamalib
   $ docker-compose build
   $ docker-compose up

(a bug in ``docker-compose`` requires doing the steps ``build`` and ``up`` separately. 
In the future, only ``up`` will be necessary.)

Navigate to http://localhost:8888 and access the Jupyter_ notebook
with password ``adamalib``.  The notebook ``Example.ipynb`` contains a
full example of use.  The notebook ``Provenance.ipynb`` contains an example of
accessing provenance information from Python.

**Note**: If you are running on a Mac with ``boot2docker``, substitute ``localhost`` by 
the output of:

.. code-block:: bash

   $ boot2docker ip


License
=======

Free software: MIT license

.. _Adama: https://github.com/Arabidopsis-Information-Portal/adama
.. _Docker: https://docs.docker.com/installation/#installation
.. _docker-compose: https://docs.docker.com/compose/install/
.. _using adamalib in Docker: https://github.com/Arabidopsis-Information-Portal/adamalib#using-adamalib-in-docker
.. _Jupyter: http://ipython.org/


