Oxpecker.OpenApi
1.0.0
dotnet add package Oxpecker.OpenApi --version 1.0.0
NuGet\Install-Package Oxpecker.OpenApi -Version 1.0.0
<PackageReference Include="Oxpecker.OpenApi" Version="1.0.0" />
paket add Oxpecker.OpenApi --version 1.0.0
#r "nuget: Oxpecker.OpenApi, 1.0.0"
// Install Oxpecker.OpenApi as a Cake Addin #addin nuget:?package=Oxpecker.OpenApi&version=1.0.0 // Install Oxpecker.OpenApi as a Cake Tool #tool nuget:?package=Oxpecker.OpenApi&version=1.0.0
render_with_liquid: false
Oxpecker.OpenApi
Oxpecker.OpenApi
extends Oxpecker
framework with functionality to automatically generate OpenApi spec from code.
Nuget package dotnet add package Oxpecker.OpenApi
Usages example:
open Oxpecker
open Oxpecker.OpenApi
let endpoints = [
// addOpenApi supports passing detailed configuration
POST [
route "/product" (text "Product posted!")
|> addOpenApi (OpenApiConfig(
requestBody = RequestBody(typeof<Product>),
responseBodies = [| ResponseBody(typeof<string>) |],
configureOperation = (fun o -> o.OperationId <- "PostProduct"; o)
))
]
// addOpenApiSimple is a shortcut for simple cases
GET [
routef "/product/{%i}" (
fun id ->
products
|> Array.find (fun f -> f.Id = num)
|> json
)
|> configureEndpoint _.WithName("GetProduct")
|> addOpenApiSimple<int, Product>
]
// such route won't work with OpenAPI, since HTTP method is not specified
route "/hello" <| text "Hello, world!"
]
Configuration
ASP.NET Core 8
Since Oxpecker.OpenApi
works on top of Microsoft.AspNetCore.OpenApi
and Swashbuckle.AspNetCore
packages, you need to do standard steps:
let configureApp (appBuilder: IApplicationBuilder) =
appBuilder
.UseRouting()
.Use(errorHandler)
.UseOxpecker(endpoints)
.UseSwagger() // for json OpenAPI endpoint
.UseSwaggerUI() // for viewing Swagger UI
.Run(notFoundHandler)
let configureServices (services: IServiceCollection) =
services
.AddRouting()
.AddOxpecker()
.AddEndpointsApiExplorer() // use the API Explorer to discover and describe endpoints
.AddSwaggerGen() // swagger dependencies
|> ignore
[<EntryPoint>]
let main args =
let builder = WebApplication.CreateBuilder(args)
configureServices builder.Services
let app = builder.Build()
configureApp app
app.Run()
0
ASP.NET Core 9
Since Oxpecker.OpenApi
works on top of Microsoft.AspNetCore.OpenApi
and Swashbuckle.AspNetCore
packages, you need to do standard steps:
let configureApp (appBuilder: IApplicationBuilder) =
appBuilder
.UseRouting()
.Use(errorHandler)
.UseOxpecker(endpoints)
.Run(notFoundHandler)
let configureServices (services: IServiceCollection) =
services
.AddRouting()
.AddOxpecker()
.AddOpenApi() // OpenAPI dependencies
|> ignore
[<EntryPoint>]
let main args =
let builder = WebApplication.CreateBuilder(args)
configureServices builder.Services
let app = builder.Build()
configureApp app
app.MapOpenApi() |> ignore // for json OpenAPI endpoint
app.Run()
0
APIs
To make endpoints discoverable by OpenApi, you need to call one of the following functions: addOpenApi
or addOpenApiSimple
on the endpoint.
NOTE: you don't have to describe routing parameters when using those functions, they will be inferred from the route template automatically.
addOpenApi
This method is used to add OpenApi metadata to the endpoint. It accepts OpenApiConfig
object with the following optional parameters:
type OpenApiConfig (?requestBody : RequestBody,
?responseBodies : ResponseBody seq,
?configureOperation : OpenApiOperation -> OpenApiOperation) =
// ...
Response body schema will be inferred from the types passed to requestBody
and responseBodies
parameters. Each ResponseBody
object in sequence must have different status code.
configureOperation
parameter is a function that allows you to do very low-level modifications the OpenApiOperation
object.
addOpenApiSimple
This method is a shortcut for simple cases. It accepts two generic type parameters - request and response, so the schema can be inferred from them.
let addOpenApiSimple<'Req, 'Res> = ...
If your handler doesn't accept any input, you can pass unit
as a request type (works for response as well).
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net8.0
- FSharp.Core (>= 9.0.100)
- Microsoft.AspNetCore.OpenApi (>= 8.0.1)
- Oxpecker (>= 1.0.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Major release