doc/book/pyramid/index.rst
author Denis Laxalde <denis.laxalde@logilab.fr>
Fri, 05 Apr 2019 17:58:19 +0200
changeset 12567 26744ad37953
parent 12096 b8bfcab1a91c
child 12819 053329493511
permissions -rw-r--r--
Drop python2 support This mostly consists in removing the dependency on "six" and updating the code to use only Python3 idioms. Notice that we previously used TemporaryDirectory from cubicweb.devtools.testlib for compatibility with Python2. We now directly import it from tempfile.

Pyramid
=======

:mod:`cubicweb.pyramid` provides a way to bind a CubicWeb data repository to a
Pyramid WSGI web application.

It can be used in two different ways:

-   Through the :ref:`pyramid command <cubicweb-ctl_pyramid>` or through
    :func:`cubicweb.pyramid.wsgi_application` WSGI application factory, one can
    run an ``all-in-one`` CubicWeb instance with the web part served by a
    Pyramid application. This is referred to as the *backwards compatible
    mode*.

-   Through the ``pyramid`` configuration type, one can setup a CubicWeb
    instance which repository can be used from within a Pyramid application.
    Such an instance may be launched through ``pserve`` or any WSGI server as
    would any plain Pyramid application.


Narrative Documentation
=======================

.. toctree::
    :maxdepth: 2

    quickstart
    ctl
    settings
    auth
    profiling

Api Documentation
=================

.. toctree::
    :maxdepth: 2
    :glob:

    ../../api/pyramid