Is it possible to generate an OpenAPI YAML file from annotated source files via the openapi-generator-maven-plugin and the generator openapi-yaml?
The Maven plugin as well as CLI tool require an input-spec and only generate from that, not from soruce files. I've searched the (sadly sparse :() documentation and so far found nothing.
Additionally, if this isn't possible (which is likely I guess), is there any other possibility? This project is sadly non-Spring so using springdoc is no alternative.
Thanks!
Related
I want to use doxygen with my project to generate documentation.
All "normal" dependencies of my project are managed by vcpkg and I was hoping that I can use doxygen this way as well, although it is not a lib that I link against, but a tool that I process my files with.
There seems to be some need for this, as this issue seems to be posted and some solution is merged.
When I dig further I found that there is a function called vcpkg_find_acquire_program that can specifically be called with doxygen argument. However, all examples are using portfile.cmake which my project does not have.
In my project I use:
vcpkg.json that acts as a manifest file. I specify the project name, version, dependencies. But I cannot put doxygen in the dependency list, because there is no doxygen portfile
CMakeLists.txt where I can specify that I require doxygen, but cmake won't manage downloading/installing it for me. It's vcpkg's job.
CMakeSettings.json where I specify build configurations
...and that is about it in terms of project configuration. So, where should I put that vcpkg_find_acquire_program? Or is there a different way?
I'm trying to build a Vert.X app using Scala, and generating the routes using an OpenAPI 3 spec through the OpenAPI3RouterFactory.
I need to generate the models described in my spec as Scala classes.
Is there any simple and straightforward way to accomplish this?
I'm using SBT to build my app, and I've already tried some sbt codegen plugins for Swagger, but none of them seem to work.
With vertx-web-api-contract, Router and validation handlers are generated at runtime, so you don't need to generate the routes. You can just start using the Router factory and mount the handlers you want as if it would be a Vert.x Web Router. If you want to bootstrap a new project there is a community tool called vertx-starter, but there is no Scala support now
Talking about the models, what you can do is organize your OpenAPI specification in different files, putting all data model definitions under a specific directory like spec/models (You can find a good guide here). Then you can configure jsonschema2pojo (sbt plugin) to generate a Scala case class for each schema inside that directory. Then, if you want to repack the spec in a single file, you can configure tools like swagger-cli to run during the compilation and pack the spec back in a single file
I have to manipulate my OWL file with Scala language. therefore, I found that scowl: https://github.com/phenoscape/scowl facilitates this task. I'm working with Lunix and Virtual Machine.
my questions are:
how to download scowl in Lunix with command line?
how to upload my owl file from github in Lunix?
Thanks in advance
I am the author of Scowl. It is meant to be used as a library in your Scala application. So you would add it as a dependency in your build file, whether you are using SBT or Maven or something else. It's available from Maven Central, and instructions are in the Scowl readme. I'm not sure what you mean by uploading your OWL file. Scowl provides a domain-specific language in Scala to allow you to manipulate OWL axioms in a readable way.
I am looking for a tool that reads the java file with swagger annotation and generates that API JSON spec file? Please do let me know if there is already one.
You can use swaggerdocgen Maven plugin to generate Swagger documents in the both JSON and YAML formats. This is assuming that you are able to use Maven for your application.
You can find more information about swaggerdocgen plugin here: https://github.com/WASdev/tool.swagger.docgen
Basically, you need to create a WAR Maven project and add your application files there. Then as part of running mvn package, the Swagger document will be generated in the 'Target' directory of your project.
Where can I find dtd, xsd or whatever, that eclipse uses to validate ant build.xml file?
EDIT:
Actually eclipse is validating build.ini for referential integrity and I am interested to know how is it doing so. Is it using schematron or there is some more elegant way to do it?
There seems to be no official dtd (this link provides information why not and how to create an incomplete version). If you google for ant.dtd you will find information on this topic and also a link to an unofficial work-in-progress version.
So there must be more eclipse magic (or whatever) in validating/parsing the build.xml - I unfortunately do not know about it.