Skip to content

Conversation

@IEvangelist
Copy link
Member

@IEvangelist IEvangelist commented Sep 5, 2023

Summary

Content for the Microsoft.Extensions.Http.AutoClient NuGet package.

Fixes #36947


Internal previews

📄 File 🔗 Preview link
docs/fundamentals/networking/http/http-autoclient.md Use the REST API HTTP client generator
docs/fundamentals/networking/http/httpclient.md Make HTTP requests with the HttpClient

@IEvangelist IEvangelist requested a review from a team as a code owner September 5, 2023 18:29
@dotnet-bot dotnet-bot added this to the September 2023 milestone Sep 5, 2023
@ghost ghost added okr-freshness OKR: Freshness of content okr-curation OKR: Curate content to remove outdated recommendations labels Sep 5, 2023
@IEvangelist IEvangelist closed this Sep 5, 2023
@IEvangelist IEvangelist reopened this Sep 5, 2023
@IEvangelist IEvangelist marked this pull request as draft September 6, 2023 15:55
Copy link
Member

@BillWagner BillWagner left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I had a couple small nits, but this is ready to go.

@IEvangelist IEvangelist marked this pull request as ready for review September 6, 2023 16:51
@IEvangelist IEvangelist marked this pull request as draft September 6, 2023 17:57
@IEvangelist IEvangelist marked this pull request as ready for review September 25, 2023 14:43
@IEvangelist IEvangelist marked this pull request as draft September 26, 2023 13:31
@IEvangelist IEvangelist marked this pull request as ready for review September 29, 2023 19:27
@IEvangelist IEvangelist merged commit 486d2fd into dotnet:main Sep 29, 2023
IEvangelist added a commit to IEvangelist/docs that referenced this pull request Oct 2, 2023
* Auto rest content

* Added to the TOC

* Fix warnings

* Now the xref is better

* Minor clean up

* More updateS

* Update docs/fundamentals/networking/http/http-autoclient.md

Co-authored-by: Bill Wagner <wiwagn@microsoft.com>

* Use primary ctor

* Clean up

* Major clean up and edit pass

* Rename link to article

* Apply suggestions from code review

Co-authored-by: Bill Wagner <wiwagn@microsoft.com>

* Snippets

* Remove un-used usings

* Remove incorrect alert

* touch csproj

* Adjust heading

* Add note about experimental API

---------

Co-authored-by: Bill Wagner <wiwagn@microsoft.com>
@valentinmarinro
Copy link

Hi @IEvangelist what is the status of Microsoft.Extensions.Http.AutoClient it will still be shipped or it is discontinued, we are already using it in a production ready application and I really love it, but if it will be discontinued I will need to find alternative solutions.

@gewarren
Copy link
Contributor

@joperezr FYI

@joperezr
Copy link
Member

Hi @valentinmarinro, thanks for your question. We decided to not ship Microsoft.Extensions.AutoClient. You should consider using Refit library instead. The API surface is super similar so it should feel familiar and it should also be very straight forward to port your existing code.

@valentinmarinro
Copy link

@joperezr thank you for the quick answer, any reasons why, it looked so beautiful and AOT compatible

@joperezr
Copy link
Member

Main reason was the one shared above, which is when we had a closer look on Refit and reached out to the maintainers of it, it felt like its features were very closely-aligned with AutoClient, so it didn't make sense to introduce a new library when there was an existing one that would meet the same needs. In terms of the AOT-compatibility, we also discussed with the maintainers the possibility of helping Refit become AOT compatible by swapping their use of reflection for source-gen like AutoClient instead, and they seemed to be okay with us contributing that.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dotnet-fundamentals/svc networking/subsvc okr-curation OKR: Curate content to remove outdated recommendations okr-freshness OKR: Freshness of content

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Fundamentals] Document HTTP AutoClient library

6 participants