Metadata-Version: 2.4
Name: metaengine-protobuf-httpx
Version: 1.0.0
Summary: Generate idiomatic Python (Pydantic v2 + httpx) gRPC-Connect clients and models from Protocol Buffers definitions. 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/protobuf-httpx
Project-URL: Issues, https://github.com/meta-engine/protobuf-httpx/issues
Project-URL: Changelog, https://github.com/meta-engine/protobuf-httpx/blob/main/CHANGELOG.md
Keywords: protobuf,protocol-buffers,grpc,connect,codegen,code-generator,protobuf-codegen,pydantic,httpx,client,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-protobuf-httpx

Generate idiomatic **Python** clients and models from **Protocol Buffers** definitions —
Pydantic v2 models and an async `httpx` client speaking the gRPC-Connect protocol, with
optional docstrings and `@dataclass` models.

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-protobuf-httpx
```

## Usage

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

| Argument / Option | Description |
|---|---|
| `input` | Protobuf `.proto` file path (or inline `.proto` content) |
| `output` | Output directory for generated Python files |
| `--documentation` | Generate docstring comments |
| `--dataclass` | Generate `@dataclass` models instead of Pydantic v2 models |
| `--verbose` | Enable verbose logging |

### Example

```bash
metaengine-protobuf-httpx ./service.proto ./generated --documentation
```

## Supported platforms

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

## License

MIT
