NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
NuGet, #359 most downloaded on NuGet
A fluent, portable URL builder. To make HTTP calls off the fluent chain, check out Flurl.Http.
Latest stable
4.0.0
Last release 3 years ago
no release in 18 months
Release timing varies
gaps range from 3 weeks to 10 months
Most releases are documented
notes for 29 of 44 stable releases
Nothing withdrawn
no release was ever pulled
13 years old
62 releases · first in 2014
Drag across the ruler to compare, or tap a release to open it.
AppendQueryParams method/overloads ( #688 ), thx @Marusyk !
This is a significant release with many breaking changes. Please read carefully. An upgrade guide has also been added to the documentation.
Newtonsoft.Json in favor of System.Text.Json (#517)
dynamic-returning JSON methods (#699)
FlurlHttp static object completely overhauled, now mostly just responsible for client caching associated with "clientless" usage patternConfigure and ConfigureRequest methods renamed to WithSettingsSettingsSettings.ConnectionLeaseTimeout removed (#703)WithClient extension methods removed (#590)CancellationToken moved to last arg everywhere that it isn't (#702)AllowHttpStatus now takes int instead of HttpStatusCode args (#785)GetStreamAsync defaults to unbuffered behavior (#630)IFlurlClient.Settings and IFlurlRequest.Settings container objects are read-onlyIFlurlClient.HttpMessageHandler removedFlurlCall.RedirectedFrom moved to IFlurlRequest (accessible via FlurlCall.Request.RedirectedFrom)FlurlResponse ctor takes a FlurlCall instead of an HttpResponseMessageFlurlRequest.Client is no longer instantiated on demand by just referencing the property. If it hasn't been set explicitly, or (more common) by calling FlurlClient.Request, it will remain null until the request is sentIHttpSettingsContainer renamed to ISettingsContainer, and its Headers property moved to (new) IHeadersContainer (#773)FakeHttpMessageHandler, TestHttpClientFactory, and TestFlurlHttpSettings types all removedCookieJar (#758)Settings.HttpVersion (#639)AllowRealHttp now reverts to original HttpClient, eliminating certain quirks (#683)ShouldHaveCalled false negative with URL ending with ? (#721)Your coding agent can read these notes before it upgrades. Set up the MCP server →
First-class support for persisting and restoring CookieJar
CookieJar (#758)Settings.HttpVersion (#639)ConfigureRequest renamed to WithSettings (#764)IHttpClientFactory (#736)AllowRealHttp now reverts to original HttpClient, eliminating certain quirks (#683)Full Changelog: https://github.com/tmenier/Flurl/compare/Flurl.3.0.7...Flurl.Http.4.0.0-pre4
AppendQueryParams method/overloads (#688), thx @Marusyk!SetQueryParams with collection, duplicate keys should append not overwrite (#370)Full Changelog: https://github.com/tmenier/Flurl/compare/Flurl.3.0.7...Flurl.4.0.0-pre4
Retain trailing ? or # if specified in original string
? or # if specified in original string (#734)Create symbols package for upload to nuget.org (#601, thx @gitfool)
Nothing published for this version
BUGFIX: SetQueryParams + IEnumerable model prop
SetQueryParams + IEnumerable model prop (#672)Bug - SetQueryParams using object with nullable properties
Bug - SetQueryParams using object with nullable properties (#669)
Minor bug fixes for SetQueryParams (#641 & #632)
Minor bug fixes for SetQueryParams (#641 & #632)
Trim whitespace from start and end of Url
net472 target to avoid unnecessary package dependency (#616)BUGFIX: Parsing bug when host contains upper-case characters.
StatusCode (nullable int) property added to FlurlHttpException (#565)FlurlCall.Succeeded error when Response is null (#573)FlurlHttpException.Message when Call is null (#579)FlurlResponse introduced, primarily to enable inspecting response and deserializing body in separate steps.
FlurlResponse introduced, primarily to enable inspecting response and deserializing body in separate steps. (#354)HttpTest.ForCallsTo(...).AllowRealHttp() for allowing real calls to be made in a test for specific URLs or any other request conditions. (#225)Flurl.Url and string are now also available on System.Uri. (#489)PostAsync, PutAsync, and PatchAsync now optional. (#515)Making HTTP calls
HttpResponseMessage (such GetAsync, PostAsync, etc) now return FlurlResponse. If you're using GetJsonAsync or chaining ReceiveXXX methods, this shouldn't break anything. (#354)HttpCall is now FlurlCall, and several properties of FlurlCall and FlurlHttpException were moved or renamed. (#488)CapturedStringContent constructors. (#452)Headers
IFlurlRequest.Headers and IFlurlClient.Headers. (#541)HttpRequestMessage.GetHeaderValue and HttpResponseMessage.GetHeaderValue extension methods removed. (#553)Content-Type header for text parts allowed but not defaulted. (#452)Cookie request header and Set-Cookie response headers are always visible in Headers collection of request and response. (#506)Cookies
CookiesEnabled removed at all settings levels. (#506)Cookies, WithCookie and WithCookies removed from IFlurlClient. Use CookieSession instead. (#506)IFlurlRequest.Cookies is now read-only IEnumerable<(string Name, string Value)>. Use WithCookies instead. (#506)Testing
* wildcard to the beginning or end if you need partial match behavior. (#323)HttpTest.ResponseQueue public property has been removed. Underlying queue implementation changed significantly to support new features, and hopefully accessing it directly isn't needed. Use RespondWith methods to build the queues.HttpCallAssertion. (#483)Other
UseCookies and AllowAutoRedirect are disabled on the default HttpClientHandler . Any custom factory-provided handler must do the same if Flurl's new cookie and redirect features are required. (#500 & #506)HttpClient caching strategy based on host, scheme, and port, rather than just host. (#550)Flurl 3.0 contains a major rewrite of the URL building/parsing engine. It brings Flurl.Url's feature set more in line with System.Uri, while also addressing some of its quirks.
New Url properties (#440)
Scheme (read/write)UserInfo (read/write)Host (read/write)Port (read/write)Authority (read-only, UserInfo + Host + Port)Root (read-only, Scheme + Authority)PathSegments (modifiable)IsRelative (read-only)IsSecureScheme (read-only, true for https or wss)All URL-building extension methods currently on string now available on System.Uri (#489)
New fluent builder methods on Flurl.Url, System.Uri, and string:
RemovePathSegment() (removes the last segment)RemovePath()RemoveQuery()Reset() (restores Url to its original state as constructed, NOT available on string)Support for relative URLs (#407)
Parameterless constructor for Url (#518)
New static utility method: Url.ParsePathSegments(string) (assumes entire string is the path portion of a URL)
Url.QueryParams (#555)Url.Path changed to be more in line with the formal definition. Previously it included everything (scheme, host, etc.) up to the query string. It now starts after the host/port, including the leading / if present.Url.IsValid() instance method was removed. It was confusing in the case of relative URLs since arguably any string could be considered a valid relative URL. Check the IsRelative property instead. (Static Url.IsValid(string) method is still available but, same a before, returns true only for valid absolute URLs.)Bug fixes:
Url.ToUri() now works for relative URLs (#407)Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
- Bug when decoding encoded +
+ (#437)Added Url ctor that takes a Uri
- Overridden Url.Equals method (#337) - Url.ToUri() method
Url.Equals method (#337)Url.ToUri() method (#339)SetQueryParam with array should add multiple QueryParameters (#301, #276)
QueryParamCollection.Merge (#301)Nothing published for this version
Add target for .NET Standard 2.0
Nothing published for this version
Nothing published for this version
BREAKING: Better URL encoding/decoding methods
+ (#258)Avoid "Uri string is too long" error when possible
fullyEncode arg added to AppendPathSegment (#253)BREAKING: Serialize dates to ISO 8601 when using DateTime or DateTimeOffset as values of query string params, etc
DateTime or DateTimeOffset as values of query string params, etc (#249)Dropping PCL target, adding .NET Standard 1.0
Dropping PCL target, adding .NET Standard 1.0
Improved ConnectionLeaseTimeout implementation
ConnectionLeaseTimeout implementation (#330)HttpResponseMessage (#329)ConfigureClient method to IFlurlClientFactory (#356)CancelationToken to DownloadFileAsync (#360)WithRequestUrlEncoded method to HttpCallAssertion (#347)Nothing published for this version
This release focuses on enhancements to exception handling:
This release focuses on enhancements to exception handling:
FlurlHttpException.Message (#297)FlurlParsingException, can be handled globally (#299)FlurlHttpException.GetResponseString & GetResponseJson replaced by async equivalents (#300)HttpCall.ErrorResponseBody removed (#300)ShouldHaveCalled..WithContentType when body is empty (#285)SetQueryParam and SetQueryParams for adding query params with just a name and no value (#164)NullValueHandling setting to other overloads of SetQueryParam and SetQueryParams. Possible values: NameOnly, Remove (default), Ignore.Url.Path is writeable.Nothing published for this version
WithHeader should exclude/remove header if value is null
WithHeader should exclude/remove header if value is null (#282)Add target for .NET Standard 2.0
HttpTest for MSTest runner (#207)TestFlurlClientFactory (#269)Url.Combine("http://root.com", "segment", "endpoint?x=1", "y=2", "#foo") => http://root.com/segment/endpoint?x=1&y=2#foo (#95)
Nothing published for this version
Nothing published for this version
Target .NET Platform Standard 1.4
FlurlHttp.ConfigureClient takes Action<FlurlClient> instead of Action<FlurlHttpSettings> (#247)DownloadFileAsync favors filename in Content-Disposition header over last URL segment when fileName arg isn't provided by user (#240)DateTime or DateTimeOffset is passed as header value or URL-encoded content value, it is serialized to ISO 8601 (#249)Nothing published for this version
This is big. See #205 for details and motivations.
This is big. See #205 for details and motivations.
HttpClient (single instance per host) by default when not managing FlurlClient explicitly (#144)IFlurlClientFactory and FlurlClientFactoryBase allow for easily customizing caching/reuse strategyIFlurlClientFactory implementation (#226)ConnectionLeaseTimeout setting to deal with potential DNS issue (#222)FlurlRequest object implicitly created instead of FlurlClient in fluent expressionsHeaders available at both request and client level (#157)WithHeaders, etc) can be called in any order in fluent expressions (#211)FlurlClient.Request method for fluently building a request off a client (#211)FlurlClient.BaseUrl property to (optionally) build all requests off of (#211)WithTimeout specific to a single requestSettings available on FlurlRequest, FlurlClient, HttpTest, and FlurlHttp (global) level, each inheriting defaults from a level up (https://github.com/tmenier/Flurl/issues/205#issuecomment-326699902)BeforeCall / BeforeCallAsync (#213)FlurlHttpException.Message (#217)HttpTest assertions: WithHeader / WithoutHeader (#223)IFlurlClient moved to IFlurRequest, and all fluent extension methods on Url and string that previously returned IFlurlClient now return IFlurlRequest (Typical usages shouldn't break, but custom extensions should be updated to follow this new pattern)FlurlClient.Url removed (superseded by FlurlRequest.Url)FlurlClient.WithUrl removed (superseded by FlurlClient.Request)FlurlClient.ConfigureClient renamed to FlurlClient.ConfigureConfigureClient extensions on IFlurlRequest, Url, and string replaced by ConfigureRequestUrl.ConfigureHttpClient removedFlurlHttpSettings.DefaultTimeout replaced by FlurlHttpSettings.Timeout (like other settings, it's the "default" when defined at client or global level)FlurlClient.Clone removedFlurlClient constructors removedFlurlHttpSettings.Clone removedFlurlHttpSettings.AutoDispose removed (auto-dispose behavior no longer supported because short-lived clients is not a recommended practice)IHttpClientFactory.CreateClient no longer takes a Url arg (more relevant to IFlurlClientFactory.Get, where caching strategy should be defined)HttpCall.Url removed (superseded by HttpCall.FlurlRequest.UrlHttpCall.Settings removed (superseded by HttpCall.FlurlRequest.SettingsWithHeaders(object) converts underscores in property names to hyphens in header names by default (#44)HttpClientHandler is wrapped in DelegatingHandler (#202)This release includes a major rewrite of parts of the core URL parser in support of a few new features and to address several issues and edge cases.
#) via Url.Fragment and fluent SetFragment(string) and RemoveFragment methods on both Url and string. (#29)QueryParamCollection now inherits from List<QueryParameter> and therefore supports in-place sorting, etc. (#78)SetQueryParam(string, string, bool) overload with isEncoded argument that allows declaring the value to already be encoded, hence avoiding double-encoding. Related, if string passed to Url constructor has a query, it is assumed to be already encoded. (#56)object can be used with AppendPathSegment(s), avoiding need for explicit string cast. (#60)QueryParamCollection no longer implements IDictionary. It still supports some of the same methods such as ContainsKey and this[name] getter/setter, but others didn't make since as the collection is more list-like than dictionary-like.QueryParamCollection no longer has a Parse method. Query parsing can only be done by creating a Url object and inspecting the QueryParams property.string.IsUrl() extension method replaced by Url.IsValid(string) static method and Url.IsValid() instance method.Refactored message handler so it never returns null
HttpCall.RequestBody and content is not CapturedStringContent (#169)Nothing published for this version
Added more variations of query param asserts
HttpTest.ShouldHaveMadeACall() and HttpTest.ShouldNotHaveMadeACall()HttpCallAssertion.Without(Func<HttpCall, bool> match) for testing "not" conditionsHttpCall.Url is now a Flurl.Url object instead of a string (non-breaking since Url implicitly converts to string)HttpTest works with tests running in parallel in .NET 4.5 and .NET Standard (including .NET Core)
HttpTest works with tests running in parallel in .NET 4.5 and .NET Standard (including .NET Core) (#67)IFlurlClient interface for better IoC and mocking support (#146)FlurlClient constructors for better DI support (#146)AutoDispose property moved from FlurlClient to FlurlHttpSettings.Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Update .NET Core support to 1.0.1
Nothing published for this version
Nothing published for this version
This is a major release with numerous enhancements and several breaking changes:
This is a major release with numerous enhancements and several breaking changes:
Send*Async methods with variable HTTP verb for atypical scenarios. (#111, #91)SendAsync extension on Url and string to match core FlurlClient.SendAsyncPostAsync, PutAsync, and PatchAsync have an HttpContent argument, which can be null.HttpCompletionOption argument.FlurlHttpSettings.CookiesEnabled to allow globally enabling cookies instead of just per client.WithOAuthBearerToken and WithBasicAuth on HttpCallAssertion. (#73)FlurlClient.GetCookies() (read-only) dictionary replaced by FlurlClient.Cookies dictionary, which can also be written to for sending. (WithCookies fluent methods still supported and recommended.)HttpTest.RespondWith and HttpTest.RespondWithJson have different parameter order, supporting more options but fewer overloads: ([string or object] body, int status = 200, object headers = null, object cookies = null)Thanks to @kroniak and @engenb for lots of help with this release!
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.