search

gomorpheus / morpheus-sdk-op

Several client SDKs for the Morpheus API generated from the provided OpenAPI specification
0 stars 0 forks source link

readme

Morpheus SDK

Experimental. Based on version 6.2.1

Some SDKs can not be generated.

There are currently many issues with the generated SDKs that have been built.

Using the Morpheus OpenAPI specification to generate SDK's for popular client languages.

Uses the OpenAPI Generator to build the SDKs via Docker.

Uses v5.0.0 to work past some issues, v6.0.0 works allows Python to be generated and Powershell partially.

Included language targets and their status below.

Language Generates Tested Good Comment
Go ✅ ✅ ❌ Issue #2, Issue #3
JavaScript ✅ ❌
Java ✅ ❌
Groovy ✅ ❌
Python ✅ ❌ Builds with 6.0.0
PHP ✅ ❌ Issue #2
PowerShell 🤷 ❌ OpenAPI 6.0.0 outputs much of it, but errors

Using

This is experimental. At this time it runs only against the main branch of the API specfication.

There's no automation on this currently, so to generate the SDKs use the Makefile which uses Docker.

Build bundled.yaml

To obtain the latest complete spec we need to clone Morpheus OpenAPI repo and build the bundled.yaml. A version of the compiled bundled.yaml is included in the with this repository

All the commands in the Makefile target bundled.yaml. This command clones the repo and builds the file.

make bundled

Validate

make validate

List Generators

Returns list of generators and their status. Use to create new SDK builds in the Makefile

make list-generators

Make SDK

Consult the Makefile

## Create the Javascript SDK
make javascript-sdk

Todo