Logging docs still reference the httpcore logger, but the shipped loggers are httpcore2.*

[aldbr]

Summary

docs/logging.md still tells users to configure the httpcore logger, but since the
package rename (#138) the transport loggers shipped in httpcore2 are all under the
httpcore2 hierarchy:

httpx2/src/httpcore2/httpcore2/_sync/connection.py

Line 22 in c4e73cf

logger = logging.getLogger("httpcore2.connection")

httpx2/src/httpcore2/httpcore2/_sync/http2.py

Line 24 in c4e73cf

logger = logging.getLogger("httpcore2.http2")

httpx2/src/httpcore2/httpcore2/_sync/http11.py

Line 27 in c4e73cf

logger = logging.getLogger("httpcore2.http11")

(same for the _async variants)

It looks like the docs rename sweep (#973) updated httpx to httpx2 on that page but left the httpcore references untouched.

Impact

The LOGGING_CONFIG dictionary example on the logging page registers a logger named
'httpcore'. Anyone copying it gets the httpx2 INFO lines but silently no transport-level
debug output at all.

Reproduction

import logging
import httpx2

logging.basicConfig(format="%(name)s - %(message)s", level=logging.DEBUG)
httpx2.get("https://www.example.com")

emits records from httpx2, httpcore2.connection and httpcore2.http11, nothing from
httpcore:

httpcore2.connection - connect_tcp.started host='www.example.com' port=443 ...
httpcore2.http11 - send_request_headers.started request=<Request [b'GET']>
httpx2 - HTTP Request: GET https://www.example.com "HTTP/1.1 200 OK"

Affected spots

• docs/logging.md
• Potentially docs/advanced/extensions.md? Still mentioning httpcore and mentioning representations of it.

Assisted by Claude on this one.
Cheers

[darekwojciechowski]

You're right. The loggers moved with the rename and that page got missed, so people register a logger nothing writes to.

The real names are httpcore2.connection, httpcore2.http11, httpcore2.http2 and httpcore2.proxy. Registering the parent catches all of them:

"loggers": {
    "httpx2": {"handlers": ["default"], "level": "DEBUG"},
    "httpcore2": {"handlers": ["default"], "level": "DEBUG"},
}

To see what your install actually ships, no guessing:

import logging, httpx2
httpx2.get("https://www.example.com")
print(sorted(logging.root.manager.loggerDict))

The extensions.md mentions are trickier — some of those name the upstream project, not an importable module, so that page needs reading line by line rather than a find-and-replace.