Multiple fixes and improvements

[ahopkins]

1. Fixes [Bug] Even after excluding an endpoint from doc, it still shows the route on swagger, although not the contents of it. #240
2. Fixes Can't handle duplicate path #239
3. Adds exclude to OAS3
4. Adds openapi.definition decorator to OAS3
5. Adds support for reading from annotated class models
6. Adds specification.raw() method to OAS3 for adding specs directly

Here is an example of how the definition decorator could be used:

class Name:
    first_name: str
    last_name: str


class User:
    name: Name


@app.post("/path")
@openapi.definition(
    operation="opeID",
    summary="This is a summary",
    description="This is a description",
    tag=["one", "two"],
    document="http://127.0.0.1:9999/doc",
    # body=RequestBody(content=User),
    body=RequestBody(User, True, "Hello"),
    # body=RequestBody({"application/json": {"name": str}}),
    # body={"*/*": User},
    parameter=Parameter("foo", int),
    # parameter={"required": True, "name": "something"},
    response=[
        Response(User, status=201),
        Response(Name, status=400),
    ],
    # response={"application/json": User
)
async def post_test(request):
    return json({"hello": "world"})

[artcg]

👍 nice thanks for that, looks like some good changes, nice to see some more robust tests as well