Typing of deployment's payload field

[msw-kialo]

GitHub deployments API includes a payload field. That can be JSON payload (either as string or directly embedded).

It is currently documented as:

payload:
  oneOf:
    - type: object
      additionalProperties: true
    - type: string
      description: JSON payload with extra information about the deployment.
      default: ''

it is currently typed as

class ReposOwnerRepoDeploymentsPostBodyPropPayloadOneof0Type(TypedDict):
    """ReposOwnerRepoDeploymentsPostBodyPropPayloadOneof0"""


class WebhookDeploymentCreatedPropDeploymentPropPayloadOneof0(GitHubModel):
    """WebhookDeploymentCreatedPropDeploymentPropPayloadOneof0"""

Both represent the type: object aspect, but ignore additionalProperties: true. This makes the field useless (as they only allow to encode an empty json object).

For pydantic extra=allow is needed:

class WebhookDeploymentCreatedPropDeploymentPropPayloadOneof0(GitHubModel):
    """WebhookDeploymentCreatedPropDeploymentPropPayloadOneof0"""

	model_config = {"extra": "allow"}

I am not so sure about ReposOwnerRepoDeploymentsPostBodyPropPayloadOneof0Type. I think, it needs to be encoded as a normal dict[str, ...] as TypedDicts have currently no way to allow for extra keys.

(I can try to create a PR but I am not familiar with the code base at the moment).

[yanyongyu]

Actually, there is a ExtraGitHubModel can be inheritted. It allows extra fields. additional properties option is partially supported. I need to check the codegen to locate the root reason of this issue. Maybe the parser or the template cause this.

[yanyongyu]

It seems the schema is

without additionalProperties. Where did you get the schema from?

We can make a schema patch to fix this.

[msw-kialo]

I looked at https://github.com/github/rest-api-description/blob/main/descriptions/api.github.com/api.github.com.2022-11-28.yaml.

However, I only checked paths./repos/{owner}/{repo}/deployments.post.requestBody.content.application/json.schema.properties.payload (line 28964) and components.schemas.deployment.properties.payload (line 80860).
I see now that components.schemas.webhook-deployment-created.properties.deployment.properties.payload (line 106974) and components.schemas.webhook-deployment-status-created.properties.deployment.properties.payload (line 110250) indeed does not specify additionalProperties (even so they are returned if the deployment is created with them).
I checked the online documentation https://docs.github.com/en/webhooks/webhook-events-and-payloads#deployment (but they only specific object or string).

I reported this upstream: github/rest-api-description#4421