diff options
| author | Karl O. Pinc <kop@meme.com> | 2018-11-24 08:10:47 -0600 |
|---|---|---|
| committer | Karl O. Pinc <kop@meme.com> | 2018-11-24 08:10:47 -0600 |
| commit | 6ca75ed314188de40a8676bf1258762bc9522b91 (patch) | |
| tree | 872f9d4480740d81183d1efeb27ec4ff4b05ca8f /docs/narr/logging.rst | |
| parent | 27c82826d669e4b381328643f84ccfff5bcba16e (diff) | |
| download | pyramid-6ca75ed314188de40a8676bf1258762bc9522b91.tar.gz pyramid-6ca75ed314188de40a8676bf1258762bc9522b91.tar.bz2 pyramid-6ca75ed314188de40a8676bf1258762bc9522b91.zip | |
Use numbered list instead of a paragraph per Steve Piercy
Diffstat (limited to 'docs/narr/logging.rst')
| -rw-r--r-- | docs/narr/logging.rst | 12 |
1 files changed, 8 insertions, 4 deletions
diff --git a/docs/narr/logging.rst b/docs/narr/logging.rst index 8ae8469de..58bd2d4ec 100644 --- a/docs/narr/logging.rst +++ b/docs/narr/logging.rst @@ -43,10 +43,14 @@ The logging-related sections in the file configure logging when you run ``pserve .. index:: pair: logging; startup -On :ref:`startup <the_startup_process>` the ``pserve`` command :ref:`configures logging <startup_logging_initialization>` using the ``.ini`` file given to it. -If the ``.ini`` file contains a ``[loggers]`` section (all of the cookiecutter-generated ``.ini`` files do) ``pserve`` calls the :func:`pyramid.paster.setup_logging` function. -The :func:`setup_logging` function is a thin wrapper around the :func:`logging.config.fileConfig`. -When ``setup_logging`` is passed the ``ini`` file given on the ``pserve`` command line it reads the file and configures logging. +If the configuration ``.ini`` file, specified when invoking ``pserve``, contains a ``[loggers]`` section then on :ref:`startup <the_startup_process>` the following process takes place: + +#. The ``pserve`` command calls the :func:`pyramid.paster.setup_logging` function, passing the ``.ini`` file. + +#. ``setup_logging`` is a thin wrapper which calls the Python standard library's :func:`logging.config.fileConfig`. + +#. :func:`logging.config.fileConfig` reads the logging configuration from the ``.ini`` file and configures logging. + Default logging configuration is provided in both the default ``development.ini`` and the ``production.ini`` files. If you use our cookiecutter to generate a Pyramid project with the name of the package as ``hello_world``, then the logging configuration |
