OpenApi Generator

[daniel-sc]

I created a (simple) OpenApi generator for Flight: OpenAPITools/openapi-generator#18406

Feedback and improvements welcome :)

[n0nag0n]

Hey there! This is awesome! I made a couple comments on the PR.

[n0nag0n]

Made a little blurb here and here

[daniel-sc]

@n0nag0n thanks! One minor correction - you wrote

Blog post written by Daniel Schreiber on how to use the OpenAPI Generator with FlightPHP to generate API documentation.

I think this is misleading, as this is not about generation of "API documentation" but the opposite way - you manually define your API documentation (or it is given) and generate php flight stubs + models from it?

[n0nag0n]

Ok, wow it was late and I just accepted what Copilot did. Shame on me. :) But I did have some more time to go through the blog post and I think there's a couple things to clear up.

I think there's supposed to be a composer require in there somewhere? In the blog post you mention RegisterRoutes::registerRoutes() but I can't quite figure out where that line of code came from. I don't understand how the UserApi class registers an actual route for Flight::route() or if that's still a manual step. Also one other quick thing since this is an API, I've created a new method called Flight::jsonHalt() which is exactly like halt, but in JSON format.

[daniel-sc]

@n0nag0n thanks for the feedback! I updated the blog post - would you mind checking again, if it is (more) understandable now?

[n0nag0n]

Ahh yes, that makes more sense now, thank you!