hug VS connexion

Hug

What's the use case? I was thinking about this exact issue because my product ships several CLI tools, but I wasn't convinced it would be worth the effort.

An OpenAPI specification describes an HTTP interface, and I see it as useful because it makes it easier to write code in language-of-choice to generate HTTP requests (by generating client libraries from the OpenAPI spec).

For a CLI, the interface is the command-line. Usually people type these commands, or they end up in bash scripts, or sometimes they get called from programming language of choice by shelling out to the CLI. So I could see a use case for a CLI spec, which would make it easier to generate client libraries (which would shell out to the CLI)... but it seems a little niche.

Or maybe, as input to a documentation tool (like Swagger docs). I would imagine if you're using a CLI library like Python's Click, most of that data is already there. Click Parameters documentation: https://click.palletsprojects.com/en/8.1.x/parameters/

Or maybe, you could start from the spec and then generate code which enforces it. So any changes pass through the spec, which would make it easy to write code (server and client-side) / documentation / changelogs. Some projects like this: Guardrail (Scala) https://github.com/guardrail-dev/guardrail , and Connexion (Python) https://github.com/spec-first/connexion .

But without this ecosystem of tooling, documenting your CLI in a specification didn't really seem worth the effort. Of course, that's a bootstrapping problem.

Connexion is a framework on top of Flask that automagically handles HTTP requests defined using OpenAPI/Swagger.

I recommend you create a OpenAPI Specification and implement a python module that you expose via connexion or on the cli via click(for easy testing).

I'm here because Swagger-CodeGen created flask-Connexion boilerplate for python.

Personally we just prov them using librouteros and flask-connexion/openapi.

The reason im using py sqla for mvc i look at flask-admin for api i look at connexion, here a tutorial if your interested.

https://connexion.readthedocs.io/en/latest/ - check Connexion, it is a framework on top of flask with swagger etc.

https://connexion.readthedocs.io/en/latest/ check this :)