I am setting up an automation, and wanted to ask if there is an API to import Vorto models. Right now, it looks like it is only possible via the website (https://vorto.eclipse.org/#/import).
At https://www.eclipse.org/vorto/swagger/ there is a 'Vorto Importer Plugin API'. I guess this API is only for importing plugins as the name suggests.
If this is not available, are there any plans to implement such a function?
currently the Repository API of Vorto 0.11 does not support to import models via REST. It is a pure read-only REST API. You can "only" import models via the Repository Web Interface (https://vorto.eclipse.org)
However there is a GitHub issue about your request: https://github.com/eclipse/vorto/issues/1667 and it will be available in 0.12 Release, which is planned for end of august.
The Vorto Importer Plugin API is an API to implement an Importer Plugin that you can register with the Vorto Repository. An Importer plugin could for example be a Web Of Things or JSON Schema Plugin, that converts these 3rd party descriptors to Vorto Information Models. As I understand your question, that is not what you wanna do :)
Related
One of my project is using Apache Wicket 6.x and I have some API (resources) using wicketstuff-rest and it is working perfectly.
But for my API documentations, I am maintaining a google document for these APIs. Problem is that whenever there are changes in any of the API, or even on new APIs... I need to update this API documentation. Chances are, this documentation may not be updated.
On my other springboot projects, I am using swagger and the API documentation can be viewed via swagger-ui.
I wonder if I can use swagger-ui with existing apache wicket 6.x project so that whenever there are new API(s) or any change on the existing API(s)... it will reflect in swagger-ui without the need to maintain any API documentation.
What I currently search is swagger2markup, but this seems to be old and I am having problems with the setup and there are very few resources on how to set this up.
Anyone who successfully setup swagger-ui with apache wicket rest?
Care to share resource/links on tutorials or how to setup swagger-ui on apache wicket rest?
Thanks!
I don't have an easy solution for you with Swagger but if you use Spring already then you could use Spring REST Docs to generate the documentation from the unit tests.
I am new to swaggerhub so please explain me from basics.
In our project we are using springfox swagger and need to generate swaggerhub api specification.
How can I achieve this? Please let me know in detail or share reference links.
Your question is a little confusing. What do you mean by "swaggerhub api specification"?
Swagger is the documentation specification/tools used to work with the document spec. SwaggerHub is a design and collaboration tools for creating and maintaining Swagger documents.
SwaggerHub hosts Swagger documents, they work together rather than independently.
If you're creating Swagger documents and want to upload them to SwaggerHub automatically, you can do that using the SwaggerHub CLI or Registry API tools:
CLI: https://github.com/SmartBear/swaggerhub-cli
Registry API: https://app.swaggerhub.com/apis-docs/swagger-hub/registry-api/1.0.62
I have a project with a Nest.js API and an Angular SPA. The DTOs used by the SPA to communicate with the API are in a separate project called Models and I'm using it as a dependency. In that way, I only need to change the DTO in one place, and can reuse them in both projects.
I've been trying to document my API with Swagger using #nestjs/swagger. This lib requires me to use decorators in my DTOs if I want their attributes to be shown in Swagger.
When I do that, everything works as expected in my API, but the Angular SPA breaks because it doesn't has the #nestjs/swagger dependency. Even after installing it as dependency for the app, it still requires me to install #nestjs/common, express, mime, send, etc. and I shouldn't install all of those backend related dependencies to my app just for the sake of documentation.
Do you guys have any idea how to overcome this issue or other tips about documentation generation for APIs with Nest.js?
I'm using Dart, and i want to implements swagger-ui, as a web on my proyect.
I have the json/yaml file of my API and that API running on local.
The JS+Css+Html Option of swagger-ui works fine, but, is there a way to generate a web like this in Dart?
I guess I am confused what you want to do.
Dart has it's own documentation generator, dartdoc, that works out of the box for any package. I don't know of any support for swagger or if it offers any particular advantages for Dart users.
An example for args package:
https://www.dartdocs.org/documentation/args/0.13.7/index.html
I am working on a grails project and i need a plugin to extract an email attachment from a Gmail account.
My colleague said something about Java Mail API but i am not actually sure about how to integrate the api with grails.
Is there any other plugin or workaround to extract an email attachment from a gmail account?
Thanks.
While not specific to extracting attachments from GMail, the Grails Routing plugin would definitely be worth evaluating. It integrates Apache Camel into your Grails services and controllers and provides a very easy way to create routes. You can then add the following dependency to your grails-app/BuildConfig.groovy file:
// replace x.x.x with version used by the Grails Routing plugin
runtime("org.apache.camel:camel-mail:x.x.x")
In the documentation for the Mail component you will an example of grabbing attachments from GMail and there is also this blog entry by Mr Haki that shows an example using the older Grails Camel plugin (Routing plugin supercedes it).
While I haven't used Camel for this purpose, I have used it on a few projects and would recommend it as a possible solution. It is a very powerful integration tool and can really make it very easy to do some pretty complicated things.