Metadata-Version: 2.1
Name: pybel-cx
Version: 0.1.0
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

PyBEL-CX
========
A PyBEL extension for interconversion with CX

Installation
------------
Before this is deployed to PyPI, it can be installed 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.


