Phase 4: Generator Tooling

Phase 4: Generator — Scaffold Vendor Integrations from OpenAPI Specs

Status: ❌ Not Started
Depends on: Phase 3 completion

Objective

Reduce the effort to add a new vendor from days to hours by auto-generating vendor definitions, client code, CLI commands, and documentation from OpenAPI specifications.

Deliverables

  • netapi vendor scaffold <spec-url> command

  • Reads OpenAPI/Swagger spec, generates:

    • Vendor definition YAML (~/.config/netapi/vendors/<name>.yml)

    • Client class skeleton (netapi/vendors/<name>/client.py)

    • CLI command group (netapi/cli/<name>.py)

    • Documentation pages (overview, auth, endpoints)

    • Nav entries

  • Template customization for non-standard APIs

  • Validation: netapi vendor validate <name> checks generated artifacts

Success Criteria

Given a public OpenAPI spec URL, a user can generate a working vendor integration with a single command and have usable CLI commands within minutes.