Skip to content

feat: add Builder as unified entry point#2044

Open
DerManoMann wants to merge 5 commits into
zircote:masterfrom
DerManoMann:openapi-builder
Open

feat: add Builder as unified entry point#2044
DerManoMann wants to merge 5 commits into
zircote:masterfrom
DerManoMann:openapi-builder

Conversation

@DerManoMann

@DerManoMann DerManoMann commented Jul 7, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Introduce Builder class as the recommended entry point for generating OpenAPI specs
  • Builder\Result wraps output with toJson()/toYaml()/toArray()/saveAs(), plus collected warnings()/errors()
  • withGenerator() hook for advanced Generator configuration (processors, config, analysers)
  • Migrate CLI GenerateCommand to use Builder internally
  • Add docs: reference page, generating guide updated, sidebar entry
  • Tests updated to use Builder where appropriate

Related to #1953

DerManoMann and others added 3 commits July 9, 2026 13:10
Introduces Builder with withGenerator() escape hatch for classic mode
configuration, and Builder\Result with collected validation log entries.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Migrate GenerateCommand to use Builder with withGenerator() hook for
processor/config customization. Add saveAs() to Result for file output.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
DerManoMann and others added 2 commits July 9, 2026 14:10
Replace direct Generator usage with Builder in ExamplesTest, ScratchTest,
ContextTest, AugmentParametersTest, and CleanUnusedComponentsPerformanceTest.
Add Result::openApi() accessor for tests that need the underlying annotation.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
The CLI command sets its own ConsoleLogger explicitly, so this only
affects programmatic usage where silent-by-default is preferred.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant