Warnings in management-api documentation lead to incorrectly generated clients

[jhauckisst]

Bug Report

Describe the Bug

Warnings:

• Unused model: JsonArray
• Unused model: JsonValue
• Unused model: JsonObject

These warnings show up when the eclipse-edc-bot-management-api-0.6.0-resolved.yaml (Source: swaggerhub.com) is used with the openAPI-Generator (JAR Version 7.4.0) and the command "validate".

Similar warnings also show up on swaggerhub.com:
Line 2170, Definition was declared but never used in document
Line 2190, Definition was declared but never used in document

Expected Behavior

No warnings in the management-api document about unused models

Observed Behavior

Warnings:

• Unused model: JsonArray
• Unused model: JsonValue
• Unused model: JsonObject

Context Information

Warnings in versions:

• management-api 0.6.0
• management-api 0.5.1
• management-api 0.5.0

Detailed Description

When trying to generate a python client with the openAPI-generator and the above mentioned management-api document, errors are present in the generated client. The errors are syntax errors and are linked to the JsonArray and JsonValue classes.
If the definitions of JsonArray, JsonValue and JsonObject are removed from the management-api document these syntax errors are not generated in the python client.

[github-actions]

Thanks for your contribution 🔥 We will take a look asap 🚀

[ndr-brt]

those are unfortunately generated by the swagger documentation generator tool we're using, I remember I did a short investigation looking for excluding them but I didn't find a way to do it.

A general suggestion here is to avoid generated clients because they don't typically work well with json-ld.
There are some open source client implementations already available, it could worth taking a glance:

• Java: https://github.com/Think-iT-Labs/edc-connector-client-java
• TypeScript: https://github.com/Think-iT-Labs/edc-connector-client

PS: please note that swaggerhub has been deprecated by the EDC, we're now publishing the ui to github pages:

• https://eclipse-edc.github.io/Connector/openapi/management-api (current stable version)
• https://eclipse-edc.github.io/Connector/openapi/management-api/0.6.0 (to select a different version)

[github-actions]

This issue is stale because it has been open for 14 days with no activity.

[github-actions]

This issue was closed because it has been inactive for 7 days since being marked as stale.