An error occurred when parsing the doc comment - cannot parse petstore? seems odd

[jkone27]

just testing on official pestore version 2 and 3 of openapi seems not able to parse?

#r "nuget:Testcontainers"
#r "nuget:SwaggerProvider"
open DotNet.Testcontainers.Builders
open DotNet.Testcontainers.Containers
open SwaggerProvider
open System

type PetStoreTypes = OpenApiClientProvider<"https://petstore.swagger.io/v2/swagger.json">

let container = 
        new ContainerBuilder()
        |> fun x -> x.WithImage("openapitools/openapi-petstore")
        |> fun x -> x.WithPortBinding(8080, true)
        |> fun x -> x.WithWaitStrategy(
                Wait.ForUnixContainer().UntilHttpRequestIsSucceeded(
                        fun r -> r.ForPort(8080)
                )
        )
        |> fun x -> x.Build()


let _ = container.StartAsync().ConfigureAwait(false).GetAwaiter().GetResult()

[jkone27]

maybe having an integration test run always against latest open API specs could help to avoid regressions...
https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/examples/v3.0/petstore.yaml

[sergey-tihon]

Your sample uses OpenApiClientProvider that is designed for OpenApi schemas (V3), but not all V2 ones.

When you find such a case you have two options:

1. Try SwaggerClientProvider
2. Find the same schema in V3 format (or convert)

Can you try https://petstore3.swagger.io/api/v3/openapi.json ?

maybe having an integration test run always against latest open API specs could help to avoid regressions...

I did it in the past and it is annoying, when you try to merge PR, update dependencies or fix a bug, but CI is broken because of some issue in the external schema.