psf / requests

The repository describes itself as 'A simple, yet elegant, HTTP library.' — that wording is the author's metadata, not an independent assessment. Observed GitHub topics include http, client, cookies, python, and python-requests. Platform metadata records Python as the primary language, Apache-2.0 as the license, and a LICENSE file at the repository root. It also records 54,298 stargazers (as of 2026-09-14) and a latest release v2.34.2 published 2026-05-14. The analyzed snapshot contains 130 files, and important entrypoint files src/requests/certs.py and src/requests/help.py place the Python package under src/requests/. A documentation homepage, https://requests.readthedocs.io/en/latest/, is listed in the metadata.

The analyzer reports three entrypoints: __main__ guards in src/requests/certs.py and src/requests/help.py, plus tests/testserver/server.py flagged as likely executable by a filename heuristic. In certs.py, the guarded line is print(where()); the recorded execution path stops right there, at the unresolved symbols where and print. In help.py, the guard calls main(). Recorded bounded paths run from __main__ into main() and info(): info reaches platform.system and platform.release, while main() also reaches json.dumps and print. Every recorded path terminates at an external/unresolved boundary rather than resolving into local code.

The analyzer marks docs, src, and tests as top-level subsystem directories, and its summary describes the code as organized around docs, ext, src, and tests. The analysis recorded 3,080 static relations: 2,566 calls and 514 imports; 501 resolve locally and 2,579 stay external or unresolved. The most-connected modules by static call degree are:

• src/requests/utils.py: 52 incoming / 44 outgoing; src/requests/compat.py: 52 incoming / 1 outgoing.
• src/requests/sessions.py: 11 incoming / 57 outgoing; src/requests/models.py: 5 incoming / 54 outgoing; src/requests/adapters.py: 3 incoming / 38 outgoing.
• src/requests/cookies.py: 30 incoming / 20 outgoing; src/requests/exceptions.py: 37 incoming / 2 outgoing. The degree pattern suggests utils.py, compat.py, and exceptions.py are widely referenced helpers and error definitions, while sessions.py, models.py, and adapters.py call outward more than they are called in. These labels come from static call degree, not runtime measurement.

The only parsed dependency record is Sphinx==7.2.6, listed under docs/requirements.txt with scope runtime. The repository contains 3 build/dependency manifest files, but the analyzer parses only requirements-style manifests and skips pyproject.toml dependency tables, so the full runtime dependency set is not established here. The analysis counts 42 test or test-like files. tests/testserver/server.py provides a local test server, defining Server, TLSServer, and consume_socket_content. tests/test_lowlevel.py, labeled an orchestration candidate with 0 incoming and 32 outgoing calls, contains tests such as test_chunked_upload and test_digestauth_only_on_4xx. tests/test_requests.py defines a TestRequests class plus TestCaseInsensitiveDict and TestTimeout.

1. Start with README.md, pyproject.toml, setup.py, and LICENSE — analyzer-classified project-level important files that frame the project, its packaging, and its license.
2. Read src/requests/exceptions.py next: it defines RequestException and named cases such as HTTPError, ConnectionError, SSLError, Timeout, ConnectTimeout, and ReadTimeout.
3. Read src/requests/models.py for Request, PreparedRequest, and Response.
4. Read src/requests/sessions.py for Session, SessionRedirectMixin, and the session() function, then src/requests/adapters.py for BaseAdapter and HTTPAdapter. Module-role data supports this order: exceptions.py and utils.py are heavily referenced (37 and 52 incoming calls), while sessions.py, models.py, and adapters.py call outward more than they are called in (11 in/57 out, 5/54, 3/38). The analyzer's learning-path guidance is to start from manifests and important symbols, then trace bounded execution paths and inspect unresolved boundaries before changing code.

2,579 of the 3,080 recorded relations remain external or unresolved, so most callee targets in this snapshot do not resolve to local code. The analysis is static only: reflection, runtime dependency injection, dynamic imports, monkey-patching, generated code, framework runtime wiring, and dynamic dispatch are not resolved. Install, run, and build inference is partial, installation commands were not run or confirmed, and what the code does at runtime is not established by this packet. Dependency evidence is limited to requirements-style manifests; pyproject.toml dependency tables were not parsed. README claim extraction is line-based and may capture code lines instead of prose, so README-derived statements are author claims at most.

cookies.py centers on RequestsCookieJar with helpers create_cookie, morsel_to_cookie, cookiejar_from_dict, extract_cookies_to_jar, and get_cookie_header, plus a CookieConflictError. utils.py groups general-purpose helpers such as super_len, get_netrc_auth, parse_list_header, parse_dict_header, extract_zipped_paths, atomic_open, and to_key_val_list. compat.py defines _resolve_char_detection, and adapters.py defines _urllib3_request_context alongside BaseAdapter and HTTPAdapter.