RestCodeGen

Generate Python clients from OpenAPI specifications with ease

🚀 Overview

RestCodeGen is a powerful tool for automatically generating Python client libraries from OpenAPI 3 specifications. It streamlines the process of interacting with REST APIs, allowing developers and testers to quickly integrate with services that provide OpenAPI documentation.

✨ Key Features

• Easy Client Generation: Create Python clients with a single command
• Async Support: Generate both synchronous and asynchronous clients
• Selective API Generation: Choose specific API tags to include
• Type Hints: All generated code includes proper type annotations

📦 Installation

RestCodeGen requires Python 3.10 or higher. Install it using pip:

pip install restcodegen

Or with Poetry:

poetry add restcodegen

🔧 Usage

Basic Command

restcodegen generate -u "http://example.com/openapi.json" -s "my-service" -a false

Command Parameters

Example

Examples

Generate a client for the Petstore API with default templates:

restcodegen generate -u "https://petstore3.swagger.io/api/v3/openapi.json" -s "petstore" -a false

Generate a client using custom templates:

restcodegen generate -u "https://petstore3.swagger.io/api/v3/openapi.json" -s "petstore" -a false -td ./custom_templates

Generate a client into a custom output directory (imports will follow this base path):

restcodegen generate -u "https://petstore3.swagger.io/api/v3/openapi.json" -s "petstore" -o framework/internal

Custom Templates

You can provide your own Jinja2 templates to customize the generated code. Place your template files in a directory and specify the path using the --templates-dir (-td) option. The following template files are supported:

• api_client.jinja2 - Main API client template
• header.jinja2 - File header template (for license and imports)
• apis_init.jinja2 - Data model template

To customize the output, copy the default templates from the package's templates directory and modify them as needed.

Output Directory and Imports

When you specify --output-dir (-o), the generated package structure is created under that directory, for example:

framework/
  internal/
    petstore/
      apis/
      models/

All generated imports are based on the base path you provide (e.g. framework.internal.petstore...). If -o is not provided, the default base path is clients/http.

📁 Generated Structure

After successful execution, a client library will be created with the following structure:

└── clients                      
     └── http     
        ├── schemas               # OpenAPI 3.0.0 schemas for all generated APIs                   
        └── service_name          # Service name     
            ├── apis              # API client classes                    
            └── models            # Pydantic models   

💻 Using the Generated Client

The generated client includes built-in logging with structlog and supports custom HTTPX clients:

from httpx import Client
from clients.http.petstore import PetApi

# Create and use the client
if __name__ == '__main__':
    # Use the httpx client or httpx.AsyncClient() for async mode
    api_client = Client(base_url="https://petstore3.swagger.io/api/v3")
    
    # Initialize the API
    pet_api = PetApi(api_client)
    
    # Make API calls
    response = pet_api.get_pet_pet_id(pet_id=1)
    print(response)

🔄 Development Workflow

1. Install development dependencies:

   poetry install
   

2. Run tests:

   poetry run pytest
   

3. Check code quality:

   poetry run ruff check .
   poetry run mypy .
   

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Contributing

Contributions are welcome! Feel free to open issues or submit pull requests.

📬 Contact

For questions or feedback, please open an issue in the repository.

RestCodeGen - Making API integration simple and efficient