Skip to content

Add support for document $self property (OAI 3.2.0) #28

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 9 commits into from
Sep 30, 2025
Merged

Add support for document $self property (OAI 3.2.0) #28

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
0a2c16c
Initial plan
Copilot Sep 30, 2025
4991360
Add $self property to OpenApiDocument with serialization/deserializat…
Copilot Sep 30, 2025
585903d
Add tests for $self property serialization and deserialization
Copilot Sep 30, 2025
5f06b5a
Complete $self property implementation with passing tests
Copilot Sep 30, 2025
518abac
Apply suggestions from code review
baywet Sep 30, 2025
82a4229
Add deserialization support for $self in V31 and V32 deserializers an…
Copilot Sep 30, 2025
91d3626
Add deserialization unit tests for $self property in V31 and V32
Copilot Sep 30, 2025
5ec066a
Merge branch 'feat/oai-3-2-support' into copilot/fix-441fec3f-fb43-40…
baywet Sep 30, 2025
ee26c50
chore: updates benchmark results
baywet Sep 30, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions ...ark/BenchmarkDotNet.Artifacts/results/performance.Descriptions-report-github.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ WarmupCount=3
```
| Method | Mean | Error | StdDev | Gen0 | Gen1 | Gen2 | Allocated |
|------------- |---------------:|-------------:|-------------:|-----------:|-----------:|----------:|-------------:|
| PetStoreYaml | 519.5 μs | 807.9 μs | 44.29 μs | 62.5000 | 11.7188 | - | 387.37 KB |
| PetStoreJson | 234.0 μs | 166.2 μs | 9.11 μs | 40.0391 | 7.8125 | - | 249.52 KB |
| GHESYaml | 1,120,391.4 μs | 912,897.7 μs | 50,039.00 μs | 65000.0000 | 21000.0000 | 3000.0000 | 384510.39 KB |
| GHESJson | 585,492.8 μs | 734,663.2 μs | 40,269.37 μs | 40000.0000 | 16000.0000 | 3000.0000 | 245982.27 KB |
| PetStoreYaml | 677.8 μs | 3,027.4 μs | 165.94 μs | 62.5000 | 11.7188 | - | 387.38 KB |
| PetStoreJson | 224.0 μs | 158.9 μs | 8.71 μs | 40.0391 | 8.7891 | - | 249.52 KB |
| GHESYaml | 1,064,084.8 μs | 345,144.4 μs | 18,918.53 μs | 65000.0000 | 21000.0000 | 3000.0000 | 384510.46 KB |
| GHESJson | 597,184.6 μs | 692,020.9 μs | 37,932.00 μs | 40000.0000 | 16000.0000 | 3000.0000 | 245983.02 KB |
8 changes: 4 additions & 4 deletions performance/benchmark/BenchmarkDotNet.Artifacts/results/performance.Descriptions-report.csv
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
Method,Job,AnalyzeLaunchVariance,EvaluateOverhead,MaxAbsoluteError,MaxRelativeError,MinInvokeCount,MinIterationTime,OutlierMode,Affinity,EnvironmentVariables,Jit,LargeAddressAware,Platform,PowerPlanMode,Runtime,AllowVeryLargeObjects,Concurrent,CpuGroups,Force,HeapAffinitizeMask,HeapCount,NoAffinitize,RetainVm,Server,Arguments,BuildConfiguration,Clock,EngineFactory,NuGetReferences,Toolchain,IsMutator,InvocationCount,IterationCount,IterationTime,LaunchCount,MaxIterationCount,MaxWarmupIterationCount,MemoryRandomization,MinIterationCount,MinWarmupIterationCount,RunStrategy,UnrollFactor,WarmupCount,Mean,Error,StdDev,Gen0,Gen1,Gen2,Allocated
PetStoreYaml,ShortRun,False,Default,Default,Default,Default,Default,Default,11111111,Empty,RyuJit,Default,X64,8c5e7fda-e8bf-4a96-9a85-a6e23a8c635c,.NET 8.0,False,True,False,True,Default,Default,False,False,False,Default,Default,Default,Default,Default,Default,Default,Default,3,Default,1,Default,Default,Default,Default,Default,Default,16,3,519.5 μs,807.9 μs,44.29 μs,62.5000,11.7188,0.0000,387.37 KB
PetStoreJson,ShortRun,False,Default,Default,Default,Default,Default,Default,11111111,Empty,RyuJit,Default,X64,8c5e7fda-e8bf-4a96-9a85-a6e23a8c635c,.NET 8.0,False,True,False,True,Default,Default,False,False,False,Default,Default,Default,Default,Default,Default,Default,Default,3,Default,1,Default,Default,Default,Default,Default,Default,16,3,234.0 μs,166.2 μs,9.11 μs,40.0391,7.8125,0.0000,249.52 KB
GHESYaml,ShortRun,False,Default,Default,Default,Default,Default,Default,11111111,Empty,RyuJit,Default,X64,8c5e7fda-e8bf-4a96-9a85-a6e23a8c635c,.NET 8.0,False,True,False,True,Default,Default,False,False,False,Default,Default,Default,Default,Default,Default,Default,Default,3,Default,1,Default,Default,Default,Default,Default,Default,16,3,"1,120,391.4 μs","912,897.7 μs","50,039.00 μs",65000.0000,21000.0000,3000.0000,384510.39 KB
GHESJson,ShortRun,False,Default,Default,Default,Default,Default,Default,11111111,Empty,RyuJit,Default,X64,8c5e7fda-e8bf-4a96-9a85-a6e23a8c635c,.NET 8.0,False,True,False,True,Default,Default,False,False,False,Default,Default,Default,Default,Default,Default,Default,Default,3,Default,1,Default,Default,Default,Default,Default,Default,16,3,"585,492.8 μs","734,663.2 μs","40,269.37 μs",40000.0000,16000.0000,3000.0000,245982.27 KB
PetStoreYaml,ShortRun,False,Default,Default,Default,Default,Default,Default,11111111,Empty,RyuJit,Default,X64,8c5e7fda-e8bf-4a96-9a85-a6e23a8c635c,.NET 8.0,False,True,False,True,Default,Default,False,False,False,Default,Default,Default,Default,Default,Default,Default,Default,3,Default,1,Default,Default,Default,Default,Default,Default,16,3,677.8 μs,"3,027.4 μs",165.94 μs,62.5000,11.7188,0.0000,387.38 KB
PetStoreJson,ShortRun,False,Default,Default,Default,Default,Default,Default,11111111,Empty,RyuJit,Default,X64,8c5e7fda-e8bf-4a96-9a85-a6e23a8c635c,.NET 8.0,False,True,False,True,Default,Default,False,False,False,Default,Default,Default,Default,Default,Default,Default,Default,3,Default,1,Default,Default,Default,Default,Default,Default,16,3,224.0 μs,158.9 μs,8.71 μs,40.0391,8.7891,0.0000,249.52 KB
GHESYaml,ShortRun,False,Default,Default,Default,Default,Default,Default,11111111,Empty,RyuJit,Default,X64,8c5e7fda-e8bf-4a96-9a85-a6e23a8c635c,.NET 8.0,False,True,False,True,Default,Default,False,False,False,Default,Default,Default,Default,Default,Default,Default,Default,3,Default,1,Default,Default,Default,Default,Default,Default,16,3,"1,064,084.8 μs","345,144.4 μs","18,918.53 μs",65000.0000,21000.0000,3000.0000,384510.46 KB
GHESJson,ShortRun,False,Default,Default,Default,Default,Default,Default,11111111,Empty,RyuJit,Default,X64,8c5e7fda-e8bf-4a96-9a85-a6e23a8c635c,.NET 8.0,False,True,False,True,Default,Default,False,False,False,Default,Default,Default,Default,Default,Default,Default,Default,3,Default,1,Default,Default,Default,Default,Default,Default,16,3,"597,184.6 μs","692,020.9 μs","37,932.00 μs",40000.0000,16000.0000,3000.0000,245983.02 KB
10 changes: 5 additions & 5 deletions performance/benchmark/BenchmarkDotNet.Artifacts/results/performance.Descriptions-report.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<html lang='en'>
<head>
<meta charset='utf-8' />
<title>performance.Descriptions-20250930-095804</title>
<title>performance.Descriptions-20250930-135612</title>

<style type="text/css">
table { border-collapse: collapse; display: block; width: 100%; overflow: auto; }
Expand All @@ -26,10 +26,10 @@
<table>
<thead><tr><th>Method</th><th>Mean </th><th>Error </th><th>StdDev</th><th>Gen0</th><th>Gen1</th><th>Gen2</th><th>Allocated</th>
</tr>
</thead><tbody><tr><td>PetStoreYaml</td><td>519.5 &mu;s</td><td>807.9 &mu;s</td><td>44.29 &mu;s</td><td>62.5000</td><td>11.7188</td><td>-</td><td>387.37 KB</td>
</tr><tr><td>PetStoreJson</td><td>234.0 &mu;s</td><td>166.2 &mu;s</td><td>9.11 &mu;s</td><td>40.0391</td><td>7.8125</td><td>-</td><td>249.52 KB</td>
</tr><tr><td>GHESYaml</td><td>1,120,391.4 &mu;s</td><td>912,897.7 &mu;s</td><td>50,039.00 &mu;s</td><td>65000.0000</td><td>21000.0000</td><td>3000.0000</td><td>384510.39 KB</td>
</tr><tr><td>GHESJson</td><td>585,492.8 &mu;s</td><td>734,663.2 &mu;s</td><td>40,269.37 &mu;s</td><td>40000.0000</td><td>16000.0000</td><td>3000.0000</td><td>245982.27 KB</td>
</thead><tbody><tr><td>PetStoreYaml</td><td>677.8 &mu;s</td><td>3,027.4 &mu;s</td><td>165.94 &mu;s</td><td>62.5000</td><td>11.7188</td><td>-</td><td>387.38 KB</td>
</tr><tr><td>PetStoreJson</td><td>224.0 &mu;s</td><td>158.9 &mu;s</td><td>8.71 &mu;s</td><td>40.0391</td><td>8.7891</td><td>-</td><td>249.52 KB</td>
</tr><tr><td>GHESYaml</td><td>1,064,084.8 &mu;s</td><td>345,144.4 &mu;s</td><td>18,918.53 &mu;s</td><td>65000.0000</td><td>21000.0000</td><td>3000.0000</td><td>384510.46 KB</td>
</tr><tr><td>GHESJson</td><td>597,184.6 &mu;s</td><td>692,020.9 &mu;s</td><td>37,932.00 &mu;s</td><td>40000.0000</td><td>16000.0000</td><td>3000.0000</td><td>245983.02 KB</td>
</tr></tbody></table>
</body>
</html>
2 changes: 1 addition & 1 deletion performance/benchmark/BenchmarkDotNet.Artifacts/results/performance.Descriptions-report.json
View file
Open in desktop

Large diffs are not rendered by default.

60 changes: 30 additions & 30 deletions ...mark/BenchmarkDotNet.Artifacts/results/performance.EmptyModels-report-github.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,33 +10,33 @@ Job=ShortRun IterationCount=3 LaunchCount=1
WarmupCount=3

```
| Method | Mean | Error | StdDev | Gen0 | Allocated |
|---------------------------- |-----------:|--------------:|------------:|-------:|----------:|
| EmptyApiCallback | 4.611 ns | 0.2382 ns | 0.0131 ns | 0.0051 | 32 B |
| EmptyApiComponents | 13.590 ns | 110.3530 ns | 6.0488 ns | 0.0166 | 104 B |
| EmptyApiContact | 3.928 ns | 0.2265 ns | 0.0124 ns | 0.0076 | 48 B |
| EmptyApiDiscriminator | 4.299 ns | 4.3753 ns | 0.2398 ns | 0.0064 | 40 B |
| EmptyDocument | 788.076 ns | 3,490.5215 ns | 191.3273 ns | 0.1802 | 1136 B |
| EmptyApiEncoding | 4.699 ns | 17.2697 ns | 0.9466 ns | 0.0089 | 56 B |
| EmptyApiExample | 4.683 ns | 9.1504 ns | 0.5016 ns | 0.0089 | 56 B |
| EmptyApiExternalDocs | 3.800 ns | 0.6940 ns | 0.0380 ns | 0.0064 | 40 B |
| EmptyApiHeader | 5.206 ns | 4.1726 ns | 0.2287 ns | 0.0127 | 80 B |
| EmptyApiInfo | 5.543 ns | 8.5164 ns | 0.4668 ns | 0.0127 | 80 B |
| EmptyApiLicense | 4.144 ns | 0.4410 ns | 0.0242 ns | 0.0076 | 48 B |
| EmptyApiLink | 4.812 ns | 1.1268 ns | 0.0618 ns | 0.0115 | 72 B |
| EmptyApiMediaType | 4.947 ns | 16.1280 ns | 0.8840 ns | 0.0089 | 56 B |
| EmptyApiOAuthFlow | 4.350 ns | 2.3894 ns | 0.1310 ns | 0.0089 | 56 B |
| EmptyApiOAuthFlows | 4.997 ns | 11.8078 ns | 0.6472 ns | 0.0089 | 56 B |
| EmptyApiOperation | 70.028 ns | 67.7802 ns | 3.7153 ns | 0.0598 | 376 B |
| EmptyApiParameter | 5.850 ns | 3.8821 ns | 0.2128 ns | 0.0153 | 96 B |
| EmptyApiPathItem | 4.779 ns | 3.1709 ns | 0.1738 ns | 0.0102 | 64 B |
| EmptyApiPaths | 68.199 ns | 16.6646 ns | 0.9134 ns | 0.0395 | 248 B |
| EmptyApiRequestBody | 4.329 ns | 3.7170 ns | 0.2037 ns | 0.0076 | 48 B |
| EmptyApiResponse | 5.995 ns | 28.4117 ns | 1.5573 ns | 0.0102 | 64 B |
| EmptyApiResponses | 61.406 ns | 18.1159 ns | 0.9930 ns | 0.0395 | 248 B |
| EmptyApiSchema | 19.435 ns | 34.0416 ns | 1.8659 ns | 0.0650 | 408 B |
| EmptyApiSecurityRequirement | 13.501 ns | 14.6594 ns | 0.8035 ns | 0.0166 | 104 B |
| EmptyApiSecurityScheme | 6.749 ns | 6.3253 ns | 0.3467 ns | 0.0153 | 96 B |
| EmptyApiServer | 5.764 ns | 9.8387 ns | 0.5393 ns | 0.0089 | 56 B |
| EmptyApiServerVariable | 4.275 ns | 1.0822 ns | 0.0593 ns | 0.0076 | 48 B |
| EmptyApiTag | 4.191 ns | 1.4517 ns | 0.0796 ns | 0.0076 | 48 B |
| Method | Mean | Error | StdDev | Gen0 | Allocated |
|---------------------------- |-----------:|-----------:|-----------:|-------:|----------:|
| EmptyApiCallback | 4.828 ns | 6.435 ns | 0.3527 ns | 0.0051 | 32 B |
| EmptyApiComponents | 6.520 ns | 9.088 ns | 0.4981 ns | 0.0166 | 104 B |
| EmptyApiContact | 4.413 ns | 10.508 ns | 0.5760 ns | 0.0076 | 48 B |
| EmptyApiDiscriminator | 4.401 ns | 3.087 ns | 0.1692 ns | 0.0064 | 40 B |
| EmptyDocument | 528.141 ns | 519.009 ns | 28.4486 ns | 0.1822 | 1144 B |
| EmptyApiEncoding | 5.046 ns | 14.821 ns | 0.8124 ns | 0.0089 | 56 B |
| EmptyApiExample | 5.190 ns | 2.976 ns | 0.1631 ns | 0.0089 | 56 B |
| EmptyApiExternalDocs | 4.430 ns | 8.570 ns | 0.4698 ns | 0.0064 | 40 B |
| EmptyApiHeader | 6.005 ns | 12.071 ns | 0.6617 ns | 0.0127 | 80 B |
| EmptyApiInfo | 6.108 ns | 9.581 ns | 0.5252 ns | 0.0127 | 80 B |
| EmptyApiLicense | 5.106 ns | 5.930 ns | 0.3251 ns | 0.0076 | 48 B |
| EmptyApiLink | 5.468 ns | 5.850 ns | 0.3207 ns | 0.0115 | 72 B |
| EmptyApiMediaType | 5.382 ns | 7.645 ns | 0.4190 ns | 0.0089 | 56 B |
| EmptyApiOAuthFlow | 10.300 ns | 70.612 ns | 3.8705 ns | 0.0089 | 56 B |
| EmptyApiOAuthFlows | 6.232 ns | 12.654 ns | 0.6936 ns | 0.0089 | 56 B |
| EmptyApiOperation | 112.000 ns | 177.327 ns | 9.7199 ns | 0.0598 | 376 B |
| EmptyApiParameter | 8.392 ns | 26.414 ns | 1.4478 ns | 0.0153 | 96 B |
| EmptyApiPathItem | 8.074 ns | 43.179 ns | 2.3668 ns | 0.0102 | 64 B |
| EmptyApiPaths | 100.150 ns | 108.226 ns | 5.9322 ns | 0.0395 | 248 B |
| EmptyApiRequestBody | 4.110 ns | 1.149 ns | 0.0630 ns | 0.0076 | 48 B |
| EmptyApiResponse | 4.860 ns | 1.099 ns | 0.0603 ns | 0.0102 | 64 B |
| EmptyApiResponses | 93.849 ns | 294.979 ns | 16.1688 ns | 0.0395 | 248 B |
| EmptyApiSchema | 20.206 ns | 20.946 ns | 1.1481 ns | 0.0650 | 408 B |
| EmptyApiSecurityRequirement | 14.111 ns | 34.042 ns | 1.8660 ns | 0.0166 | 104 B |
| EmptyApiSecurityScheme | 8.667 ns | 14.076 ns | 0.7715 ns | 0.0153 | 96 B |
| EmptyApiServer | 7.689 ns | 46.200 ns | 2.5324 ns | 0.0089 | 56 B |
| EmptyApiServerVariable | 4.385 ns | 4.847 ns | 0.2657 ns | 0.0076 | 48 B |
| EmptyApiTag | 4.780 ns | 5.955 ns | 0.3264 ns | 0.0076 | 48 B |
Loading