Skip to content

Releases: Azure/azure-functions-openapi-extension

v2.0.0-preview2: Update

27 Jan 10:22
Compare
Choose a tag to compare
Pre-release

Release Notes

Breaking Changes

No breaking changes

Changes & Fixes

No changes or fixes other than v1.5.1


What's Changed

  • Update sample app that applies v1.5.0 by @justinyoo in #528
  • add TimeSpanObjectTypeVisitor by @sinantutan in #524
  • Allow object types to be marked as nullable by @lalo3k in #504
  • Fix issue with DocumentHelperExceptions.GetOpenApiParameters not forwarding the OpenAPI schema version. by @jstoker in #503
  • Fix handling of 'Required' fields for Newtonsoft by @William-Froelich in #506
  • Flexibility to choose Microsoft.AspNetcore.App on the isolate worker by @justinyoo in #547

New Contributors

Full Changelog: v2.0.0-preview1...v2.0.0-preview2

v1.5.1: Update

27 Jan 09:53
Compare
Choose a tag to compare

Release Notes

  • Bug fixes and enhancements

Changes & Fixes

  • #547 Flexibility to choose Microsoft.AspNetcore.App on the isolate worker #536 #534
  • #524 add TimeSpanObjectTypeVisitor #401
  • #506 Fix handling of 'Required' fields for Newtonsoft #402 #336
  • #504 Allow object types to be marked as nullable
  • #503 Fix issue with DocumentHelperExceptions.GetOpenApiParameters not forwarding the OpenAPI schema version

What's Changed

  • Update sample app that applies v1.5.0 by @justinyoo in #528
  • add TimeSpanObjectTypeVisitor by @sinantutan in #524
  • Allow object types to be marked as nullable by @lalo3k in #504
  • Fix issue with DocumentHelperExceptions.GetOpenApiParameters not forwarding the OpenAPI schema version. by @jstoker in #503
  • Fix handling of 'Required' fields for Newtonsoft by @William-Froelich in #506
  • Flexibility to choose Microsoft.AspNetcore.App on the isolate worker by @justinyoo in #547

New Contributors

Full Changelog: v1...v1.5.1

v2.0.0-preview1: Update

23 Dec 05:19
Compare
Choose a tag to compare
Pre-release

Release Notes

Breaking Changes

  • OpenApiHttpTriggerAuthorization has now been included to OpenApiConfigurationOptions.
  • OpenApiConfigurationOptions.IncludeRequestingHostName has now been changed to OpenApiConfigurationOptions.ExcludeRequestingHost.

Changes & Fixes

  • #526 Update OpenApiSettings
  • #477 V2/ Merge OpenApiHttpTriggerAuthorization with OpenApiConfigurationOptions
  • #397 Change IncludeRequestingHostName to ExcludeRequestingHost #393 #390

v1.5.0: Update

23 Dec 01:10
Compare
Choose a tag to compare

Release Notes

  • .NET 7 support for out-of-proc worker
  • OpenAPI settings from environment variables injected out-of-the-box
  • More authN scenarios including Azure EasyAuth is now possible
  • GitHub Actions to generate OpenAPI documents within the CI/CD pipeline
  • Both PowerShell and bash shell script are available for generic CI/CD pipelines other than GitHub Actions
  • DevContainer support including GitHub Codespaces

Changes & Fixes


What's Changed

Full Changelog: v1...v1.5.0

v1.4.0: Update

23 Aug 02:15
Compare
Choose a tag to compare

Release Notes

Bug fixes and enhancements

Changes & Fixes

  • #476 Add delegate OpenApiHttpTriggerAuthorization to be more configurable #458 #434
  • #466 More DI feature for OpenApiConfigurationOptions #458 #430
  • #464 Update the version of NuGet packages for test projects
  • #463 Add more test cases for OpenApiHttpTriggerContext
  • #435 Support dynamic OpenApiHttpTriggerAuthorization #458 #434
  • #432 Support dynamic OpenApiConfigurationOptions #458 #430
  • #429 Fix null reference exception
  • #426 Distinct same types
  • #424 Only add unique openApiReferenceIds to the exported types #407
  • #415 Fixed invalid urls when include whitespace in "OpenApi__HostNames" option #411
  • #385 Fix: OAuth redirect url is invalid #384

What's Changed

New Contributors

Full Changelog: v1.3.0...v1.4.0

v1.3.0: Update - Unintentional Breaking Change

28 Mar 08:58
Compare
Choose a tag to compare

Release Notes

Bug fixes and enhancements

Breaking Changes

Although it was unintentional, a breaking change has been introduced to this release, which was overlooked.

  • #344 Allow IDocument to be modified before rendering #376 #340

Changes & Fixes

  • #395 Update GetTypesFromReferencedFunctionApps #387 #377
  • #392 Update properties to be virtual on DefaultOpenApiConfigurationOptions #391
  • #388 Lenght => Length
  • #383 Funktion key from config gets overwritten by function key in url #382
  • #381 Ignore failure during assembly loading #377 #373

New Contributors

Full Changelog: v1.2.0...v1.3.0

v1.2.0: Update

25 Feb 08:34
Compare
Choose a tag to compare

Release Notes

Bug fixes and enhancements

Changes & Fixes

  • #362 Do not consider abstract classes in configuration options
  • #368 Update logic for isolated worker #365
  • #367 multipart/form-data in OpenAPI v2 Rendering Workaround (Interim) #365
  • #364 Fix RecursiveObjectTypeVisitor to filter duplicated field names #356
  • #361 Add method to load types from referenced function app #351 #132

Full Changelog: v1.1.0...v1.2.0

v1.1.0: Update

11 Feb 10:10
Compare
Choose a tag to compare

Release Notes

Bug fixes and enhancements

  • The out-of-proc worker extension now explicitly targets both .NET 5 and 6.

Changes & Fixes

  • #358 Refactor sample apps for .NET 6 in-proc/out-of-proc
  • #330 Allow relative URL being used as base URL
  • #329 Deprecated feature implementation #319
  • #318 Resolve TypeLoadException for QueryCollection #296
  • #311 Support Required attribute #226
  • #310 Fixes: Enum of type byte is ignored #309
  • #301 Fix: OpenAPI attributes are not getting picked up if they are in a referenced class library project #298
  • #297 Add a HideDocument flag akin to HideSwaggerUI

New Contributors 🎉🎉🎉

Full Changelog: v1.0.0...v1.1.0

v1.0.0: General Availability

06 Nov 00:21
Compare
Choose a tag to compare

Release Notes

🎉🎉🎉 General Availability of Azure Functions OpenAPI Extension v1.0.0 🎉🎉🎉

Changes & Fixes

  • #308 Fix the API prefix overly trimmed #307
  • #288 Uint16 bug fix
  • #287 Fix uint32 error
  • #268 Fixed throwing StackOverflowException when contains exception class #251
  • #263 Fix Data Member Attribute json Serialized Model Casing Applied #212
  • #260 Add integration testing for Uri Object Type #143

Known Issues

Missing .dll Files

Due to the Azure Functions Runtime limitation, sometimes some of .dll files are removed while publishing the function app. In this case, try the following workaround with your function app .csproj file.

<Project Sdk="Microsoft.NET.Sdk">
  ...
  <PropertyGroup>
    ...
    <_FunctionsSkipCleanOutput>true</_FunctionsSkipCleanOutput>
  </PropertyGroup>
  ...
</Project>

Empty Swagger UI When Deployed through Azure Pipelines

Swagger UI Error When Empty Project Referenced

v0.9.0-preview: Update

08 Oct 02:24
Compare
Choose a tag to compare

Release Notes

Bug fixes and enhancements

BREAKING CHANGES

IT NOW SUPPORTS .NET 6 IN BOTH IN-PROC AND OUT-OF-PROC WORKER!

Changes & Fixes

  • #255 Additional authentication mechanism for Swagger UI and OpenAPI doc #232
  • #253 HTTP/HTTPS in Swagger UI + oauth2+redirect.html #215 #244
  • #247 Update type extension methods to detect broader range of arrays and dictionaries #245
  • #246 Fix "could not resolve reference error" #186 #160 121
  • #243 OpenAPI query string/path parameter examples #139
  • #234 Support "Base Object (root of all classes)" type #108
  • #233 list of recursive models #156
  • #230 Update ListObjectTypeVisitor to include HashSet #229
  • #224 Add ByteType Support #194 #179 #150 #136 #97 #96 #18
  • #221 Tag filtering for Swagger UI and OpenAPI document #177 #140
  • #218 fixed that fails to use a model with a property named Aliases #167 #105
  • #217 Scan all .deps.json files and determine root project #172 #122
  • #208 fix Nullable DateTime type to display as date format in specification #193
  • #195 Add extension for QueryCollection

New Contributors

Thanks for contributions! Without community's supports, this project wouldn't be improving.