small doc changes

    handler.formatter = StructuredFormatter(

        structured_formatter_config=StructuredFormatterConfig(

            dumps_fn=make_friendly_dump_fn(

                # Enable colours only if the handler pointed to a teletype.

                # Enable colours only if the handler is pointed to a teletype.

                colours=isinstance(handler, logging.StreamHandler) and handler.stream.isatty()

            ),

        )

   {..., "message": "no context"}

Modifications only apply to the current scope. Once the scope ends, all

modifications are lost.

modifications are rolled back.

.. testcode::

Configuration

-------------

Configuration, including `logging.config.fileConfig` and `logging.config.dictConfig`, works just like it does

in the standard library, allowing to set up stdlib logging and ``logstruct`` in one go.

.. _logger_config:

Logger configuration

with a `logging.Logger` with the same name, that logger should be configured as in the `official

docs <https://docs.python.org/3/library/logging.config.html#module-logging.config>`_.

`logging.config.fileConfig` and `logging.config.dictConfig` configuration works just like it does in

the standard library.

.. _formatter_usage:

.. _formatter_configuration:

Formatter configuration

^^^^^^^^^^^^^^^^^^^^^^^

A `StructuredFormatter` is configured using `StructuredFormatterConfig`.

A `StructuredFormatter` is configured using `StructuredFormatterConfig`. It can be either supplied directly

via the ``structured_formatter_config`` argument to `StructuredFormatter` or loaded from data.

Logstruct provides two default configs: `logstruct.CONFIG_FORMATTED_MESSAGE` and

`logstruct.CONFIG_RAW_MESSAGE`, which can be used directly or copied to derive custom configuration.

`StructuredFormatterConfig` reference

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. list-table:: `StructuredFormatterConfig` attributes

    :header-rows: 1

    *   - `uses_time <StructuredFormatterConfig.uses_time>`

        - ``True``

        - Determines if the current time should be assigned to ``LogRecord.asctime``.

        - Determines if current time should be assigned to ``LogRecord.asctime``.

    *   - `log_fields <StructuredFormatterConfig.log_fields>`

        - `DEFAULT_LOG_FIELDS`

    {"task": null}

Highly customised configuration example

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. _highly-customised-configuration-example:

`StructuredFormatterConfig` example

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

The following example defines completely custom configuration, featuring: