Metadata-Version: 2.1
Name: pybel-cx
Version: 0.1.2.dev0
Summary: A PyBEL extension for interconversion with CX
Home-page: https://github.com/pybel/pybel-cx
Author: Charles Tapley Hoyt
Author-email: charles.hoyt@scai.fraunhofer.de
Maintainer: Charles Tapley Hoyt
Maintainer-email: charles.hoyt@scai.fraunhofer.de
License: MIT License
Keywords: Biological Expression Language,BEL,Systems Biology,Networks Biology
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Requires-Dist: pybel (>=0.11.3)
Requires-Dist: ndex2
Requires-Dist: requests
Requires-Dist: click

PyBEL-CX |build| |coverage| |documentation|
===========================================
A PyBEL extension for interconversion with CX.

Installation |pypi_version| |python_versions| |pypi_license|
------------------------------------------------------------
PyBEL-CX can be installed easily from `PyPI <https://pypi.python.org/pypi/pybel-cx>`_ with the following code in
your favorite terminal:

.. code-block:: sh

    $ python3 -m pip install pybel-cx

or from the latest code on `GitHub <https://github.com/pybel/pybel-cx>`_ with:

.. code-block:: sh

   $ python3 -m pip install git+https://github.com/pybel/pybel-cx.git

Command Line Usage
------------------
PyBEL-CX installs two command line utilities: ``bel_to_cx`` and ``cx_to_bel``.

CX to BEL
~~~~~~~~~
Running this script has the caveat that the CX document should conform to the schema created by PyBEL-CX.

.. code-block:: sh

   $ cat my_network.cx | cx_to_bel > my_network.bel

BEL to CX
~~~~~~~~~
.. code-block:: sh

   $ cat my_network.bel | bel_to_cx > my_network.cx

Since this operation can be expensive, PyBEL caches namespace resources. The ``-c`` flag can be used to specify a
database connection string to use a high performance RDBMS instead of the default SQLite. For example, if you would
like to use MySQL, this database string will look something like
``mysql+pymysql://<username>:<password>@<host>/<dbname>?charset=utf8[&<options>]``. Be sure to ``pip install`` the
connector, which is ``pymysql`` in this example.

.. code-block:: sh

   $ pip install pymysql
   $ cat my_network.bel | bel_to_cx -c "mysql+pymysql://root:root@localhost/mydb?charset=utf8" > my_network.cx

More documentation on connection strings at http://pybel.readthedocs.io/en/latest/manager.html#pybel.manager.BaseManager.from_connection.

.. |build| image:: https://travis-ci.com/pybel/pybel-cx.svg?branch=master
    :target: https://travis-ci.com/pybel/pybel-cx
    :alt: Build Status

.. |coverage| image:: https://codecov.io/gh/pybel/pybel-cx/coverage.svg?branch=master
    :target: https://codecov.io/gh/pybel/pybel-cx?branch=master
    :alt: Coverage Status

.. |documentation| image:: http://readthedocs.org/projects/pybel-cx/badge/?version=latest
    :target: https://pybel.readthedocs.io/projects/cx/en/latest/?badge=latest
    :alt: Documentation Status

.. |python_versions| image:: https://img.shields.io/pypi/pyversions/pybel-cx.svg
    :alt: Stable Supported Python Versions

.. |pypi_version| image:: https://img.shields.io/pypi/v/pybel-cx.svg
    :alt: Current version on PyPI

.. |pypi_license| image:: https://img.shields.io/pypi/l/pybel-cx.svg
    :alt: MIT License


