=======================
Installation for Python
=======================
The following guides explain how to install a version
of E2C that enables you to write applications in Python.

Installation via pip
====================
.. code-block:: bash

   $ pip install e2c

Getting from source
===================
The project is hosted on `GitLab`_

.. _GitLab: https://gitlab.com/elastic-event-components/e2c


.. code-block:: bash

   $ git@gitlab.com:elastic-event-components/e2c.git


See `INSTALL`_ for instructions on how to install E2c.

.. _INSTALL: https://gitlab.com/elastic-event-components/e2c/blob/master/INSTALL.md

Run a short program
===================

.. highlight:: python

>>> config = (
        '.run -- action',
        'action.out -- print')

>>> import e2c

>>> graph = e2c.Graph(config)
>>> graph.actor('action',
...     lambda data, out: out(data))
>>> graph.actor('print',
...     lambda data: print(data))

>>> graph.run('Hello, E2C')

If the system outputs the following, then you are ready to start writing E2C programs:

.. code-block:: bash

    $ Hello, E2C

Dependencies
============
- `Python 3.6`_
- `Graphviz`_

.. _Python 3.6: https://docs.python.org/3/
.. _Graphviz: https://www.graphviz.org/