deprecated_api_requests_to_httpx

Documentation Index

Fetch the complete documentation index at: https://docs.refactron.dev/llms.txt

Use this file to discover all available pages before exploring further.

​

What it does

​

Detector pattern

• import requests
• from requests import <name>
• requests.<method>(...) call expressions

​

Preconditions

1. httpx is not already imported in the file (avoid double-imports / shadowing).
2. The file only touches the safe httpx drop-in surface — the HTTP verb helpers get / post / put / delete / patch / head / options / request. If it references any other requests API — exception classes like Timeout or ConnectionError, Session, the requests.exceptions submodule — the transform refuses the whole file via the unsafe-api-surface precondition. httpx diverges there (httpx.Timeout is a config class, not an exception; there is no httpx.ConnectionError — it is ConnectError), so a blind rename would emit code that breaks at runtime.
3. Cross-file: no external file in the project references <this_module>.requests in any context. The check covers:
   • import this_module; print(this_module.requests) (attribute reads).
   • from unittest.mock import patch; patch("this_module.requests.get", ...) (string-target mock patches — these would silently break post-rename).

​

Before / after

import requests


def fetch_json(url):
    try:
        response = requests.get(url, timeout=5)
        return response.json()
    except Exception as exc:
        return {"error": str(exc)}


def submit(url, payload):
    try:
        response = requests.post(url, json=payload, timeout=5)
        return response.json()
    except Exception as exc:
        return {"error": str(exc)}

​

Edge cases handled

• Both import requests and from requests import get forms.
• All HTTP-method call sites (requests.get, .post, .put, .delete, etc.).
• Cross-file string-target mocks (patch("module.requests.get", ...)).

​

Edge cases NOT handled (skip via precondition)

• File already imports httpx (manual migration probably in progress).
• An external file in the project patches or references <module>.requests.
• Files using requests API outside the safe verb set — exception classes (Timeout, ConnectionError, HTTPError), Session, requests.exceptions. Blocked by the unsafe-api-surface precondition rather than rewritten into runtime-broken code — httpx’s exception and client surface is not a drop-in for requests.