Function _parse_content_length

ggshield/core/plugin/client.py:47–66

Parse ``Content-Length`` and surface malformed values as PluginAPIError. ``int(response.headers.get("Content-Length", 0))`` raises a raw ``TypeError``/``ValueError`` on a malformed header — those don't match the ``except requests.RequestException`` arms in the download methods and l

(response: "requests.Response", *, what: str)

def _parse_content_length(response: "requests.Response", *, what: str) -> int:
    """Parse ``Content-Length`` and surface malformed values as PluginAPIError.

    ``int(response.headers.get("Content-Length", 0))`` raises a raw
    ``TypeError``/``ValueError`` on a malformed header — those don't match
    the ``except requests.RequestException`` arms in the download methods
    and leak past the typed-error contract that callers depend on.
    """
    # Missing header defaults to "0" and passes the size cap silently,
    # because the streaming reader (``_iter_with_size_cap``) enforces the
    # real bound while bytes flow in. Do not "harden" this default to
    # raise — well-behaved upstreams that omit the header on small
    # responses would then fail for no reason.
    raw = response.headers.get("Content-Length", "0")
    try:
        return int(raw)
    except (TypeError, ValueError) as exc:
        raise PluginAPIError(
            f"Malformed Content-Length header for {what}: {raw!r}"
        ) from exc


_DEFAULT_PORTS = {"http": 80, "https": 443}