doc/book/pyramid/ctl.rst
author Denis Laxalde <denis.laxalde@logilab.fr>
Mon, 06 Mar 2017 14:19:20 +0100
changeset 12008 7694dcf5ad30
parent 11631 faf279e33298
child 12521 cb68c985ee01
permissions -rw-r--r--
[etwist] Do not call repository's start_looping_tasks anymore and warn about this We are about to drop this method from Repository class and replace it by a blocking alternative. This is not compatible with how things currently work in a Twisted server implementation. So do not start repository "looping tasks" in Twisted server anymore and issue a warning about this. If someone is interested in restoring the "all-in-one" behavior where the repository runs within a Twisted server, they may start by implementing repository looping tasks using a Twisted mechanism such as, e.g., http://twistedmatrix.com/documents/current/core/howto/time.html and eventually provide the repository with a compatible scheduler instance so that is can register its periodic tasks. At the moment, we lack resources to do this (and maintain the Twisted server of CubicWeb in general). Related to #17057223.

.. _cubicweb-ctl_pyramid:

The 'pyramid' command
=====================

.. program:: cubicweb-ctl pyramid

The 'pyramid' command is a replacement for the 'start' command of :ref:`cubicweb-ctl`.
It provides the same options and a few other ones.

.. note::

    The 'pyramid' command is provided by the ``pyramid`` cube.

Options
-------


.. option:: --no-daemon

    Run the server in the foreground.

.. option:: --debug-mode

    Activate the repository debug mode (logs in the console and the debug
    toolbar). Implies :option:`--no-daemon`.

    Also force the following pyramid options:

    .. code-block:: ini
    
        pyramid.debug_authorization = yes
        pyramid.debug_notfound = yes
        pyramid.debug_routematch = yes
        pyramid.reload_templates = yes

.. option:: -D, --debug

    Equals to :option:`--debug-mode` :option:`--no-daemon` :option:`--reload`

.. option:: --reload

    Restart the server if any source file is changed

.. option:: --reload-interval=RELOAD_INTERVAL

    Interval, in seconds, between file modifications checks [current: 1]

.. option:: -l <log level>, --loglevel=<log level>

    Set the loglevel. debug if -D is set, error otherwise

.. option:: -p, --profile

    Enable profiling. See :ref:`profiling`.

.. option:: --profile-output=PROFILE_OUTPUT

    Profiling output file (default: "program.prof")

.. option:: --profile-dump-every=N

    Dump profile stats to ouput every N requests (default: 100)