Metadata-Version: 2.4
Name: metaengine-openapi-httpx
Version: 1.0.0
Summary: Generate idiomatic Python (Pydantic v2 + httpx) clients and models from OpenAPI specifications. Self-contained — no .NET install required.
Author: José A. Saldaña Pérez
License: MIT
Project-URL: Homepage, https://metaengine.eu
Project-URL: Repository, https://github.com/meta-engine/openapi-httpx
Project-URL: Issues, https://github.com/meta-engine/openapi-httpx/issues
Project-URL: Changelog, https://github.com/meta-engine/openapi-httpx/blob/main/CHANGELOG.md
Keywords: openapi,swagger,codegen,code-generator,openapi-generator,pydantic,httpx,client,api,metaengine
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Code Generators
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# metaengine-openapi-httpx

Generate idiomatic **Python** clients and models from an **OpenAPI** specification —
Pydantic v2 models and an async `httpx` client, with optional docstrings, validation,
and camelCase field aliases.

Powered by [MetaEngine](https://metaengine.eu). The wheel is **self-contained**: it bundles
a platform-native runner, so **no .NET installation is required**.

## Install

```bash
pip install metaengine-openapi-httpx
```

## Usage

```bash
metaengine-openapi-httpx <input> <output> [options]
```

| Argument / Option | Description |
|---|---|
| `input` | OpenAPI specification file path or URL |
| `output` | Output directory for generated Python files |
| `--include-tags <tags>` | Only generate operations with these tags (comma-separated) |
| `--service-suffix <name>` | Service naming suffix (default: `Service`) |
| `--options-threshold <n>` | Parameter count at which a method switches to an options object (default: `4`) |
| `--camel-case-aliases` | Generate camelCase field aliases for Pydantic models |
| `--documentation` | Generate docstring comments |
| `--strict-validation` | Enable strict OpenAPI validation |
| `--verbose` | Enable verbose logging |

### Example

```bash
metaengine-openapi-httpx ./petstore.json ./generated --camel-case-aliases --documentation
```

## Supported platforms

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

## License

MIT
