Support nullable properties with references

[aelij]

Currently if we set nullable: true a property with a reference, the nullable attribute is not emitted. For example:

schema:
  $ref: '#/definitions/Foo'
  nullable: true # not emitted

This can be useful when the nullability is per-property and not per-definition. So the reference schema can only be emitted once, and used both in nullable and non-nullable properties.

[darrelmiller]

This is not supported in OpenAPI v3. It will be possible in V3.1

[darrelmiller]

However, you can do this with an oneOf construct.

schema:
  oneOf:
    - $ref: '#/definitions/Foo'
    - nullable: true # not emitted

[aelij]

Thanks!