2024 Source Generator Rewrite

[aspriddell]

This update essentially rewrites most of the library to be more consise and easier to use.

Major Changes

Moving to semantic versioning

From now on, the project will use semantic versioning due to source generators being liable to breaking mixed libraries (as some may now have source-generated request building methods)

This will be release v4.0.0:

• v1 was the integrated Dragon6 edition
• v2 was the separately packaged one
• v3 was the one being replaced

(Breaking) Older NuGet packages will be delisted to maintain correct versioning in IDEs

Serializer class name changes

• ApiSystemJsonSerializer is now ApiJsonSerializer (and is supplied within the main data project)
• ApiHtmlSerializer is now HtmlSerializer
• ApiJsonSerializer is now NewtonsoftJsonSerializer

ApiRequest changes

• ApiRequests must be partial to use source generation (if the source generator is excluded, this can be ignored)
• internal and private members will be ignored
• Most properties have been removed for decorators/other applications
  • This will be documented in a migration guide
• Path has changed to RequestPath
• Method has been renamed to RequestMethod and now supplies HttpMethod (class) instead of Method (enum)
• [QueryParameter]/[FormParameter] has been removed and replaced with [RequestParameter(ParameterType.Query, "name"]/[RequestParameter(ParameterType.Form, "name"]
• Multipart form support has been added via class decorator
• ApiDownloadRequest class has been removed and replaced in favour of using ApiRequest and ApiClient.PerformDownload(request, destinationStream)`.

ApiClient changes

• HttpClient is now a singleton and is created once
• Default handler is now platform-specific with all enabling automatic decompression of responses and no cookies
• Clients will now default to HTTP/1.1 and try to upgrade to the newest version supported by the server and client (upto HTTP/3)
• Added new PerformDownload method for downloading files to a predefined stream
• Headers now returns a HttpRequestHeaders, the old header container has been removed

Migration Guide and Docs need to be written before a v4.0.0 release ()