Hey folks! I’m trying to find a library to generate swagger/openapi specification based on elixir code (typed structs or type definitions). Unfortunately I can’t find anything… I’m new in elixir and phoenix. I want to generate swagger/openapi describing REST API. This should be a common problem, I’…

Hey @ddoronin Take a look at GitHub - open-api-spex/open_api_spex: Open API Specifications for Elixir Plug applications · GitHub

if you’re willing to wait a few weeks, my company is releasing an open-source framework for OpenAPI that takes a document-centric view (it uses the OpenAPI schema as a central source of truth and there are no additional DSLs to learn). We just pushed it to a private repo for one release worth of va…

@ityonemo I agree that the schema to code approach is better, because documentation/schema becomes a single source of truth for both back-end and front-end! I would love to see your solution! Feel free to publish a link to your library here, or DM me https://www.linkedin.com/in/ddoronin/

I’ll post it here in addition to a general announcement on the board.

As far as I’m concerned it’s ready, but my now former boss has to approve some licensing things, I think. It’s in his best interest to do it, because I imagine he’ll get free support on the library if he open-sources it :man_shrugging: .

I’m also really hyped for something like this to be open sourced and would love to work on it ! Any news @ityonemo ?

So I kept trying to contact my former boss but he said nothing, so I’ll have to rewrite it. There will be some news on this front soon.

@ityonemo any news one it? Let me know if you need help with testing it.

the JsonSchema parsing major refactor is done, though I’m doing one more re-refactor presently =D, and the OpenAPI compiler is in progress here: GitHub - E-xyza/Apical: OpenAPI Compiler for Elixir · GitHub The OpenAPI parts are going MUCH smoother than I expected, I’m currently working on marshall…

Just to follow up on this thread, Apical has now been published on hex.pm

Elixir Programming Language Forum

How to generate Swagger/OpenAPI specification for Phoenix REST

Questions & Help Questions

ddoronin April 28, 2022, 2:56pm 6

@ityonemo any updates about your OpenAPI framework??