metaengine-graphql-httpx 1.0.0

Generate idiomatic Python (Pydantic v2 + httpx) clients and models from GraphQL schemas. Self-contained — no .NET install required.

metaengine-graphql-httpx

Generate idiomatic Python clients and models from a GraphQL schema (SDL) — Pydantic v2 models and an async httpx client, with bearer/basic auth, retries, timeouts, error handling, custom headers, fragments, @oneOf inputs, and optional docstrings.

Powered by MetaEngine. The wheel is self-contained: it bundles a platform-native runner, so no .NET installation is required.

Install

pip install metaengine-graphql-httpx

Usage

metaengine-graphql-httpx <input> <output> [options]

Argument / Option	Description
input	GraphQL schema file path (SDL) or inline SDL content
output	Output directory for generated Python files
--fragments	Emit reusable named fragments for object-type selections
--one-of-inputs	Generate idiomatic @oneOf input types (tagged-union inputs)
--custom-scalar <Scalar>=<target>	Map a GraphQL custom scalar to a Python type (repeatable). Targets: str, int, float, bool, datetime, Any
--bearer-auth <ENV>	Bearer token from env var (e.g. API_TOKEN)
--basic-auth <USER_ENV>=<PASS_ENV>	Basic auth from env vars
--retries <n>	Enable retries with exponential backoff; value sets max attempts
--timeout <s>	Request timeout in seconds for all operations
--error-handling	Smart error handling based on HTTP status semantics
--custom-header <Header>=<ENV>	Static header from env var (repeatable)
--base-url-env <ENV>	Environment variable name for base URL (default: API_BASE_URL)
--sync-methods	Generate synchronous service methods alongside the async client
--middleware	Generate httpx transport middleware infrastructure
--documentation	Generate docstring comments from SDL descriptions
--camel-case-aliases	Generate camelCase field aliases for Pydantic models
--options-threshold <n>	Parameter count at which a method switches to an options object (default: 4)
--service-suffix <name>	Service naming suffix (default: Service)
--verbose	Enable verbose logging

Example

metaengine-graphql-httpx ./schema.graphql ./generated --fragments --documentation --retries 3

Supported platforms

Pre-built wheels are published for Linux (x86_64, aarch64), macOS (Apple Silicon + Intel), and Windows (x64).

License

MIT