unstale

pypi / curl-cffi

curl-cffi

What changed in curl-cffi 0.15 to 0.17, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-29.

2 breaking3 security8 new APIs and options1 performance2 behavior and defaults1 tooling11 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@unstale/cli 0.2.9 on npm

curl-cffi 0.1720 changes

Breaking changes 2

  • A CurlError is raised when curl_mime_data fails.

    0.17.0release notes

  • Setting trust_env=False now ignores proxy environment variables.

    0.17.0release notes

Security 2

  • The bundled brotli version was updated to mitigate the http2shell issue.

    0.17.0release notes

  • certifi was updated to remove the compromised eMudhra certificate.

    0.17.0release notes

New APIs and options 7

  • CurlProxyType is added for HTTP/3 proxies.

    0.17.0release notes

  • CurlShare lets sessions share DNS and TLS caches across threads.

    0.17.0release notes

  • Session and AsyncSession gain a dns option.

    0.17.0release notes

  • Nine new fingerprints are available for developers to use.

    0.17.0release notes

  • WebSockets support permessage-deflate.

    0.17.0release notes

  • Response.json() supports a path argument.

    0.17.0release notes

  • Session gains a cache_backend property.

    0.17.0release notes

Performance 1

Behavior and default changes 2

Fixes and other changes 6

  • Charset handling now tolerates quoted, spaced, and case-insensitive values.

    0.17.0release notes

  • Quotes in server-set cookie values are preserved.

    0.17.0release notes

  • Error reporting falls back to curl_easy_strerror when the error buffer is empty.

    0.17.0release notes

  • Response.json() falls back to stdlib json when keyword arguments are passed.

    0.17.0release notes

  • A race condition in response getinfo during streaming is fixed.

    0.17.0release notes

  • WebSocket proxy and verify options are fixed.

    0.17.0release notes

curl-cffi 0.167 changes

New APIs and options 1

  • Adds support for the TLS trust_anchors extension in Chrome 152, usable with the chrome 152 target or vanilla curlopts.

    0.16.3release notes

Tooling 1

  • Android wheels are shipped per CPython minor, including CPython 3.14.

    0.16.2release notes

Fixes and other changes 5

  • Fixes tls_signed_cert_timestamps not being applied.

    0.16.3release notes

  • Active socket information is fixed on Win64.

    0.16.2release notes

  • RequestData is parameterized, improving its type annotations for stream requests.

    0.16.2release notes

  • The Session.request return annotation is restored.

    0.16.2release notes

  • The runtime typing_extensions dependency is avoided.

    0.16.2release notes

curl-cffi 0.151 changes

Security 1

  • curl_cffi: Redirect-based SSRF leads to internal network access in curl_cffi (with TLS impersonation bypass)

    0.15.0security advisory