Python doesn't honor x-ms-enum values field

[matthchr]

According to here there is a values collection supported on enums, for specifying doc-strings for the individual enum values (among other things). But the generated Python code doesn't actually use these doc strings at all.

For example, this snippet of Swagger (from the Azure Batch swagger specification):

            "values": [
              {
                "value": "currentuser",
                "description": "Certificates should be installed to the CurrentUser certificate store.",
                "name": "currentUser"
              },
              {
                "value": "localmachine",
                "description": "Certificates should be installed to the LocalMachine certificate store.",
                "name": "localMachine"
              }
            ]
          }

generates this Python code:

class CertificateStoreLocation(Enum):
    current_user = "currentuser"
    local_machine = "localmachine"

It should generate something that looks like this:

class CertificateStoreLocation(Enum):
    """Certificates should be installed to the CurrentUser certificate store."""
    current_user = "currentuser"
    """Certificates should be installed to the LocalMachine certificate store."""
    local_machine = "localmachine"

[matthchr]

@annatisch @lmazuel

[lmazuel]

Tried different syntax:

class StatusLevelTypes(str, Enum):

    info = "Info"
    """This is the info tool box"""
    warning = "Warning"
    error = "Error"

gives

[lmazuel]

Tried too:

class StatusLevelTypes(str, Enum):

    info = "Info"  #: This is the info tool box
    warning = "Warning"
    error = "Error"

gives:

[lmazuel]

Tried:

class StatusLevelTypes(str, Enum):
    """
    :cvar info: This is the info tool box
    """
    info = "Info"
    warning = "Warning"
    error = "Error"

gives:

[matthchr]

@alfpark Since you asked about this -- we have to resolve this bug and then the comments will come back (on the Enum instead of the method).

Thanks for finding the issue.

[lmazuel]

Fixed in Autorest.Python 3.0.43 using #: syntax