The Crystal Programming Language Forum

Openapi-generator: generate a document using annotations

Hello there :slight_smile:

I never posted in the forum before but I’ve been lurking around for some time. I’m a relatively new user of the language and it’s been a few months that I’ve started programming with it.

I’ve liked it so much that I’m now using it in my day to day work, building a web back-end (relying on Amber) for my company that will be ready for production in a couple of months.

So thanks a bunch to the core team and all the contributors for this wonderful language :bowing_man:!

One thing I noticed is that I could not find a shard to generate an OpenAPI file based on the Model and Controller definitions. (especially having a single source of truth - which is the model properties types and that gets reflected to the openapi document automatically)

So I created one, sharing it here just in case someone is interested:

5 Likes

I have created a new framework to prevent to write this boilerplate, for the big part: https://github.com/ricr-web/ricr

I have created a new framework to prevent to write this boilerplate, for the big part: https://github.com/ricr-web/ricr

That’s cool, but it’s not exactly the same thing :wink:.

openapi-generator is flexible and can adapt to any web framework, including Amber which I am using.

this is awesome! Thank you for posting this.

1 Like