[Feature] Support enumNames-like setting to generate enum with custom names

[songzhi]

There's basically tow options.The first is use another field likeenumNames:string[] in OpenApiSchema to generate enums with custom names.
Schema like this:

"state": {
    "title": "State",
    "enum": [
        0,
        1,
        2
    ],
    "type": "integer",
    "default": 0,
    "enumNames": ["initial", "working", "finished"]
}

Generated code:

enum state {
  INITIAL = 0,
  WORKING = 1,
  FINISHED = 2
}

But enumNames is not a valid openapi schema field.
Another option is expanding the getEnumFromDescription.

[ferdikoomen]

there is a nice thread here OAI/OpenAPI-Specification#681 some client support the x-enum-varnames. The x- props are extension props in the V3 spec. That might be a semi-supported way to do it.

[ferdikoomen]

The code is not hard, I will have a look soon!

[ferdikoomen]

@songzhi would the following SPEC work for you?

Example with x-enum-varnames and x-enum-descriptions

{
    "EnumWithStrings": {
        "description": "This is a simple enum with strings",
        "enum": [
            0,
            1,
            2
        ],
        "x-enum-varnames": [
            "Success",
            "Warning"
            "Error"
        ],
        "x-enum-descriptions": [
            "Used when the status of something is successful",
            "Used when the status of something has a warning"
            "Used when the status of something has an error"
        ]
    }
}

[songzhi]

@ferdikoomen It's works for me. Thanks for this.

[ferdikoomen]

Alright, i will try to implement this in the upcoming days. Keep you posted

[ferdikoomen]

I pushed some changes to the master branch, did not publish a new version yet. Feel free to have a look, i will do some final testing tomorrow.

[ferdikoomen]

New version has been pushed (0.1.16) with support for enums