eggfetch-python 0.1.4

Python sync and asyncio bindings for the eggfetch HTTP engine (Rust core via PyO3; Python users install from PyPI)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

"""HTTPX2 2.12.0-compatible Headers for eggfetch.

Subclasses the 0.28.1-compatible Headers with ``|``, ``|=`` merge
operators matching httpx2==2.12.0 (case-insensitive replacement,
duplicate handling, operand-type validation) while preserving redaction.
"""

from __future__ import annotations

import typing

from eggfetch.compat.httpx._headers import Headers as _BaseHeaders

if typing.TYPE_CHECKING:
    from collections.abc import Mapping


class Headers(_BaseHeaders):
    """Headers with httpx2 merge operators."""

    def __or__(self, other: Mapping[str, str]) -> Headers:
        if not isinstance(other, typing.Mapping):
            try:
                from collections.abc import Mapping as _Mapping

                if not isinstance(other, _Mapping):
                    return NotImplemented
            except Exception:
                return NotImplemented
        merged = self.copy()
        # copy() returns base-class instance; re-wrap as httpx2 Headers.
        wrapped = Headers(encoding=merged.encoding)
        wrapped._items = list(merged._items)
        wrapped.update(other)
        return wrapped

    def __ror__(self, other: Mapping[str, str]) -> Headers:
        from collections.abc import Mapping as _Mapping

        if not isinstance(other, _Mapping):
            return NotImplemented
        merged = Headers(other)
        merged.update(self)
        return merged

    def __ior__(self, other) -> Headers:
        self.update(other)
        return self


__all__ = ["Headers"]