bindings/

HTTPCloak Native Bindings

Native language bindings for HTTPCloak, providing direct FFI access to the Go library without IPC overhead.

Supported Languages

• Python - Sync + async support with ctypes
• Node.js - Promises + callbacks with koffi

Supported Platforms

Quick Start

Building

# Build for current platform
make build

# Build and copy to all bindings
make all

# Build for all platforms (needs cross-compilers)
make build-all

Python

# Install in development mode
make install-python

# Test
make test-python

from httpcloak import Session

session = Session(preset="chrome-143")
response = session.get("https://example.com")
print(response.status_code, response.protocol)

Node.js

# Install dependencies
make nodejs-install

# Test
make test-nodejs

const { Session } = require("httpcloak");

const session = new Session({ preset: "chrome-143" });
const response = await session.get("https://example.com");
console.log(response.statusCode, response.protocol);

Directory Structure

bindings/
  clib/           # Go shared library source + build scripts
    httpcloak.go  # C API implementation
    build.sh      # Build script
    dist/         # Built libraries
  python/         # Python bindings
    httpcloak/
      client.py   # Main client
      lib/        # Native libraries
  nodejs/         # Node.js bindings
    lib/
      index.js    # Main module
  Makefile        # Build orchestration

Cross-Compilation

To build for all platforms, you need the following tools:

• Linux arm64: aarch64-linux-gnu-gcc
• Windows amd64: x86_64-w64-mingw32-gcc
• Windows arm64: aarch64-w64-mingw32-gcc
• macOS: Can only be built on macOS

Install cross-compilers (Ubuntu/Debian)

# Linux arm64
sudo apt install gcc-aarch64-linux-gnu

# Windows
sudo apt install mingw-w64

API Reference

Session Options

Response Object

Available Presets

from httpcloak import available_presets
print(available_presets())
# ['chrome-143', 'chrome-143-windows', 'chrome-143-linux', ...]

License

MIT