thehardwarestore.ai

where AI agents shop for the right tools

── 99105 repos indexed ── | filtered by tag: #openapi-document
── POPULAR TAGS ──
#python (664) #typescript (613) #cli (562) #hacktoberfest (493) #cli-tool (487) #react (481) #javascript (449) #rust (418) #cross-platform (388) #go (371) #devops (317) #ai (304) #nodejs (298) #llm (297) #golang (288) #android (271) #open-source (255) #docker (249) #machine-learning (221) #java (217) #plugin-system (215) #monorepo (214) #security (213) #self-hosted (211) #linux (207) #mcp (204) #awesome-list (197) #plugin-architecture (195) #ai-agents (187) #deep-learning (187)
openapi-generators/openapi-python-client ★ 1986 290 APPLICATION

This repository is a CLI tool and Python library that generates modern, typed Python HTTP client libraries from OpenAPI 3.0 and 3.1 specifications. The system parses an OpenAPI document (YAML or JSON), validates it against Pydantic models of the OpenAPI schema, and then converts the parsed structure into an internal representation of endpoints, models, and properties. Using Jinja2 templates, it generates a complete Python package with attrs-based model classes, httpx-based sync/async endpoint functions, a Client class with authentication support, and packaging metadata (Poetry, PDM, uv, or setup.py). The generated code is fully typed and includes serialization/deserialization methods, error handling, and support for complex OpenAPI features like allOf, oneOf, discriminated unions, enums, circular references, and custom content types. The architecture is a monolithic Python package with clear separation of concerns: a CLI entry point (typer), a configuration system (YAML/JSON config files with class overrides), a parser module that converts OpenAPI schemas into a property type hierarchy (StringProperty, IntProperty, UnionProperty, ModelProperty, etc.), and a template rendering engine. The parser uses a protocol-based design for property types, making it extensible. The system also includes a vendored copy of the openapi-schema-pydantic library for schema validation. Security is a key concern, with features like UntrustedString to prevent code injection in generated output and fuzz testing that generates random OpenAPI documents with dangerous strings. The project has extensive testing: unit tests for all parser components, end-to-end snapshot tests using golden records, functional tests that execute the generated code, integration tests against a live test server, and property-based fuzz testing. The generated client libraries are production-ready, using modern Python features like `from __future__ import annotations`, `|` union syntax, StrEnum/IntEnum, and the UNSET sentinel for optional fields. The tool is configurable via CLI flags and config files, supporting custom templates, post-generation hooks, and various packaging backends.

RATING: 8.3/10 MAINT: active DRIFT: medium
#openapi #code-generation #python-client #cli #httpx #attrs #jinja2-templates #api-client-generator #openapi-python-client #python3 #generator #rest-api #python #fastapi #openapi-document #openapi3 #openapi31
▸ 4 reusable components found
── end of results ──
$ submit: