CLI WIZARD

Generate modern CLIs from OpenAPI specifications.

Table of Contents

• Features
• Installation
• Usage
• Configuration
• Commands
• Issues
• License

Features

Code Generation

• Generate complete Python CLI projects from OpenAPI v3 specifications
• Automatic command grouping based on OpenAPI tags
• Automatic help generation for all commands
• Clean, colored terminal output
• --debug flag for verbose logging
• Built-in API client with configurable base URL and timeout
• SSL/TLS support with custom CA certificate bundles
• --ca-file option to specify custom CA certificates at runtime
• --no-verify-ssl flag to disable certificate verification

Customization

• YAML-based configuration for full customization
• Configurable output directory and package name
• Tag inclusion/exclusion filters
• Custom command naming via TagMapping and CommandMapping
• Customizable splash screen with color support
• Configurable logging with colors, file output, and rotation

Developer Experience

• Generated projects are pip-installable out of the box
• Auto-generated pyproject.toml, README.md, and VERSION
• Resources (CA certs, splash files) bundled in the package
• Profile management for storing credentials and settings

Installation

pip install cli-wizard

Usage

Step 1: Prepare Your OpenAPI Specification

Ensure you have an OpenAPI v3 specification file (JSON or YAML format). For example, openapi.yaml:

openapi: 3.0.0
info:
  title: My API
  version: 1.0.0
paths:
  /users:
    get:
      operationId: listUsers
      summary: List all users
      tags:
        - Users
      responses:
        '200':
          description: OK

Step 2: Create a Configuration File

Create a cli-wizard.yaml file with your CLI settings. At minimum, you need PackageName and DefaultBaseUrl:

# Required parameters
PackageName: "my-cli"
DefaultBaseUrl: "https://api.example.com"

# Optional: customize the splash screen
SplashFile: "splash.txt"
SplashColor: "#00FFFF"

# Optional: filter which tags to include
IncludeTags:
  - Users
  - Products

Step 3: Generate the CLI

Run the generate command:

cli-wizard generate --openapi openapi.yaml --config cli-wizard.yaml --output my-cli

This creates a complete Python CLI project in the my-cli directory.

Step 4: Install the Generated CLI

Navigate to the generated project and install it:

pip install -e my-cli

Step 5: Use Your CLI

Your CLI is now ready to use:

my-cli --help
my-cli users list-users

Configuration

See configuration reference for full documentation. See the examples directory for complete configuration examples.

Commands

cli-wizard generate

Generate a CLI from an OpenAPI specification and configuration file.

cli-wizard generate [OPTIONS]

Options:

• --openapi, -o - Path to OpenAPI spec file (default: openapi.yaml)
• --config, -c - Path to config YAML file (default: cli-wizard.yaml)
• --output, -d - Output directory for generated CLI (default: cli)
• --working-dir, -w - Working directory for resolving relative paths

Issues

Please report any issues or feature requests on the GitHub Issues page.

License

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