adaiasmagdiel/httpxfetch

A Python wrapper for the JavaScript fetch function, designed to streamline the process of reverse engineering APIs.

httpxfetch

httpxfetch is a Python wrapper for the JavaScript fetch function, designed to streamline the process of reverse engineering APIs. The primary goal of this project is to simplify testing and data inspection by allowing users to copy the fetch requests generated by browser developer tools, paste them into their Python code, and execute them seamlessly.

Installation

You can install httpxfetch using pip:

pip install httpxfetch

Quick Start

from httpxfetch import fetch

# Example: Making a GET request
response = fetch('https://api.example.com/data')
print(response.status_code)
print(response.json())

Features

• Simplified Testing: Copy and paste fetch requests from browser developer tools into your Python code for easy testing and data exploration.

• Wrapper for HTTPX: Utilizes the powerful httpx library to perform HTTP requests in Python.

• JSON Handling: Automatically converts the request body to a JSON string using the JSON.stringify equivalent function.

Usage

from httpxfetch import fetch, JSON

# Example: Making a POST request with JSON payload
url = 'https://api.example.com/data'
options = {
    'method': 'post',
    'headers': {'Content-Type': 'application/json'},
    'body': JSON.stringify({'key': 'value'}),
}

response = fetch(url, options)
print(response.status_code)
print(response.json())

Return Type

The fetch function returns an instance of the httpx.Response class. All methods available in the httpx.Response class can be applied to the result of the fetch function.

Disclaimer

The project intentionally includes some redundant steps, such as converting the fetch body to a string before loading it as a dictionary. This is done to minimize the effort required, providing a convenient function to simulate JSON.stringify for ease of use.

Contributing

Contributions are welcome! Feel free to open issues, submit pull requests, or provide suggestions to improve the project.

License

This project is licensed under the MIT License - see the LICENSE file for details.