[FEATURE] Convert Tuple attribute of pydantic model to List in json schema

Is your feature request related to a problem

I have a model Foo to be used as response class:

from pydantic import BaseModel 

class Foo(BaseModel):
    span: Tuple[int, int]

@app.get("/", response_class=Foo)
async def main():
    return Foo(span=(1, 2))

However, this generates empty typed json schema:

I want Foo to be generated [interger] in json shcema.

The solution you would like

Tuple is converted to List in json schema.

Describe alternatives you’ve considered

Rewrite Foo.span type annotation to List[int].

[tiangolo]

The thing is that OpenAPI explicitly forbids lists with multiple sub-schemas (tuples). So, you can’t declare tuples with OpenAPI even though you can with JSON Schema.

If you need to have tuples in your model (i.e. you can’t declare it as a list) the best way to go would probably be as @dmontagu says by adding a schema_extra method that updates the schema.

[dmontagu]

Thanks for following up. Yeah I’m not sure what the best thing to do is here. Given how much there is to support I’m generally okay with it if we just properly support what’s the same in both JSON Schema and OpenAPI. I’d be open to changing the behavior (or trying to get it changed anyway) given enough interest. Or if @tiangolo thinks it’s best.

You can manually override the generated schema using Config.schema_extra so I would just do that for now if you need this (maybe with a utility function if you want to do it in many places).