.. _tutorial:

Usage
-----

Basic integration
=================

To get going with ``ecto``, you need the following simple CMake steps


.. toctree::
    :maxdepth: 1

    client_usage.rst

Tutorials
=========

These tutorials walk through the basic usage of ecto.

.. toctree::
    :maxdepth: 1

    tutorials/hello.rst
    tutorials/plasms.rst
    tutorials/lifecycle.rst
    tutorials/tendrils_spore.rst

Techniques
==========

So you now have a basic understanding and you should follow the following guidelines to code with ``ecto`` perfectly :)

.. toctree::
    :maxdepth: 1

    techniques/python-packages
    techniques/autoregister.rst
    techniques/ecto_cells.rst
    techniques/black_box.rst

Tips and Tricks
===============

With great flexibility comes great tips and tricks. The following info might help code faster and exploit ``ecto`` and its tools fully.

.. toctree::
    :maxdepth: 1

    tips/connections.rst
    tips/optional-inputs.rst
    tips/argparse.rst
    tips/ectodoc.rst


Using External Tools
====================

Ecto was developed to interoperate with classic C++/Python development tools.

.. toctree::
    :maxdepth: 1

    external/ipython
    external/debugging
    external/valgrind

Advanced Usage
==============

Well, what is I want to do for loops ? or integrate with Python better ? or not use Python ? Well, that section is for you.


.. toctree::
    :maxdepth: 1

    advanced/wrapping_enums.rst
    advanced/yaml.rst
    advanced/serialization.rst
    advanced/pure_cpp.rst

..  advanced/strands.rst - threading inside a single graph got deprecated so this is no longer relevant.