Function parse_dict_header

src/werkzeug/http.py:364–436

Parse a list header using :func:`parse_list_header`, then parse each item as a ``key=value`` pair. .. code-block:: python parse_dict_header('a=b, c="d, e", f') {"a": "b", "c": "d, e", "f": None} This is the reverse of :func:`dump_header`. If a key does not have a

(value: str)

def parse_dict_header(value: str) -> dict[str, str | None]:
    class="st">"""Parse a list header using :func:`parse_list_header`, then parse each item as a
    ``key=value`` pair.

    .. code-block:: python

        parse_dict_header(&class="cm">#x27;a=b, c=class="st">"d, e", f')
        {class="st">"a": class="st">"b", class="st">"c": class="st">"d, e", class="st">"f": None}

    This is the reverse of :func:`dump_header`.

    If a key does not have a value, it is ``None``.

    This handles charsets for values as described in
    `RFC 2231 <https://www.rfc-editor.org/rfc/rfc2231class="cm">#section-3>`__. Only ASCII, UTF-8,
    and ISO-8859-1 charsets are accepted, otherwise the value remains quoted.

    :param value: The header value to parse.

    .. versionchanged:: 3.2
        An empty dict is returned if the value contains an unclosed quoted
        string.

    .. versionchanged:: 3.0
        Passing bytes is not supported.

    .. versionchanged:: 3.0
        The ``cls`` argument is removed.

    .. versionchanged:: 2.3
        Added support for ``key*=charset&class="cm">#x27;'value`` encoded items.

    .. versionchanged:: 0.9
       The ``cls`` argument was added.
    class="st">"""
    result: dict[str, str | None] = {}

    for item in parse_list_header(value):
        key, has_value, value = item.partition(class="st">"=")
        key = key.strip()

        if not key:
            class="cm"># =value is not valid
            continue

        if not has_value:
            result[key] = None
            continue

        value = value.strip()
        encoding: str | None = None

        if key[-1] == class="st">"*":
            class="cm"># key*=charsetclass="st">''value becomes key=value, where value is percent encoded
            class="cm"># adapted from parse_options_header, without the continuation handling
            key = key[:-1]
            match = _charset_value_re.match(value)