Skip to content

Latest commit

 

History

History
76 lines (54 loc) · 3 KB

README.md

File metadata and controls

76 lines (54 loc) · 3 KB
Raw

python-cronet

python-cronet is a library to use Chromium's network stack from Python.

The library is currently in alpha stage.

What is Cronet

Cronet is the networking stack of Chromium put into a library for use on Android. It offers an easy-to-use, high performance, standards-compliant, and secure way to perform HTTP requests.

The Chromium team also provides a native version of the library(not officially supported) which allows you to use it in desktop/server operating systems like Linux, macOS and Windows.

The main benefits of using cronet as an HTTP client are:

  • You get to use the same high quality code that runs on Chromium.
  • Support for the latest protocols like QUIC and compression formats.
  • Concurrency support by performing asynchronous requests.
  • Has the same TLS fingerprint as Chrome, meaning that Cloudflare and other bot detection systems can't block your requests based on it.
  • It's much more lightweight on system resources compared to headless Chrome(although it doesn't support executing javascript).

Installation

For the time being the only supported platform is linux-x86-64. The plan is to also support windows and macOS.

pip install python-cronet

Example usage

The library provides an asynchronous API:

import asyncio
import cronet

async def main():
    with cronet.Cronet() as cr:
        # GET request
        response = await cr.get("https://httpbin.org/get")
        print(f"GET request: {response.url}, {response.status_code}")
        print(f"Response JSON: {response.json()}")

        # GET request with query parameters
        params = {"param1": "value1", "param2": "value2"}
        response = await cr.get("https://httpbin.org/get", params=params)
        print(f"GET request with params: {response.url}, {response.status_code}")
        print(f"Response JSON: {response.json()}")

        # POST request with form data
        data = {"key1": "value1", "key2": "value2"}
        response = await cr.post("https://httpbin.org/post", data=data)
        print(f"POST request: {response.url}, {response.status_code}")
        print(f"Response JSON: {response.json()}")

        # PUT request with JSON data
        json_data = {"key1": "value1", "key2": "value2"}
        response = await cr.put("https://httpbin.org/put", json=json_data)
        print(f"PUT request: {response.url}, {response.status_code}")
        print(f"Response JSON: {response.json()}")

        # PATCH request with custom headers
        headers = {"X-Custom-Header": "MyValue"}
        response = await cr.patch("https://httpbin.org/patch", headers=headers)
        print(f"PATCH request: {response.url}, {response.status_code}")
        print(f"Response JSON: {response.json()}")

        # DELETE request
        response = await cr.delete("https://httpbin.org/delete")
        print(f"DELETE request: {response.url}, {response.status_code}")
        print(f"Response JSON: {response.json()}")


asyncio.run(main())