Fen.Client
1.0.1
See the version list below for details.
dotnet add package Fen.Client --version 1.0.1
NuGet\Install-Package Fen.Client -Version 1.0.1
<PackageReference Include="Fen.Client" Version="1.0.1" />
paket add Fen.Client --version 1.0.1
#r "nuget: Fen.Client, 1.0.1"
// Install Fen.Client as a Cake Addin #addin nuget:?package=Fen.Client&version=1.0.1 // Install Fen.Client as a Cake Tool #tool nuget:?package=Fen.Client&version=1.0.1
FEN.Client is a NuGet package containing configurations and customizations that cause an HttpClient
to meet the standards of the Fulfiller Enablement squad. This is an opinionated library, and reflects those practices that FEN considers best. If you have a business need to do something other than what this library provides, you may want to choose something else.
Why You Want It
FEN.Client contains opinionated configuration on many significant HttpClient
aspects:
- Authentication
- Caching of Authentication
- Logging
- Serialization and Deserialization
Most importantly, it allows for declarative configuration of what it takes to communicate with Cimpress services on the Platform. There's a certain amount of overhead or boilerplate required to do that, and this library aims to minimize it.
How You Use It
Import the NuGet package “Fen.Client” in your preferred way.
If you are using this library in an ASP.NET Core service, an AddHttpClient
extension method has been provided that can be called from the service's ConfigureServices
method in the startup class. Configuration is provided by the following types via dependency injection:
IOptions<Auth0Options>
, which is provided by the standard configuration infrastructure.ILogger
, which is provided by the standard logging infrastructure.IDistributedCache
, which can be configured to operate in a distributed or local way by the standard caching infrastructure.MediaTypeFormatter
, which is ideally configured from theJsonSerializationSettings
in the service'sMvcJsonOptions
.
If the application is not an ASP.NET Core, these dependencies can be passed via the constructors of the classes Auth0AuthenticatingHandler
and V1.Auth0AuthenticatingHandler
. The HttpClient
itself can be constructed in many ways from this point, but the recommended pattern is to pass the handlers to the HttpClientFactory.Create(params DelegatingHandler[])
method. (It saves a lot of tedious work hooking the handlers up to one another.) Because delegating handlers operate like client middleware, the order in which these handlers are applied matters. For the Platform, apply the V1 handler first.
HttpClientFactory.Create(v1Auth0Handler, auth0Handler);
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp1.0 was computed. netcoreapp1.1 was computed. netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard1.1 is compatible. netstandard1.2 was computed. netstandard1.3 was computed. netstandard1.4 was computed. netstandard1.5 was computed. netstandard1.6 was computed. netstandard2.0 was computed. netstandard2.1 was computed. |
.NET Framework | net45 was computed. net451 was computed. net452 was computed. net46 was computed. net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen30 was computed. tizen40 was computed. tizen60 was computed. |
Universal Windows Platform | uap was computed. uap10.0 was computed. |
Windows Phone | wpa81 was computed. |
Windows Store | netcore was computed. netcore45 was computed. netcore451 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 1.1
- Microsoft.AspNet.WebApi.Client (>= 5.2.3)
- Microsoft.Extensions.Caching.Abstractions (>= 1.1.2)
- Microsoft.Extensions.Logging.Abstractions (>= 1.1.2)
- Microsoft.Extensions.Options (>= 1.1.2)
- NETStandard.Library (>= 1.6.1)
- Newtonsoft.Json (>= 9.0.1)
- Sprache (>= 2.1.0)
- System.Collections.Immutable (>= 1.4.0)
- System.ValueTuple (>= 4.4.0)
NuGet packages (2)
Showing the top 2 NuGet packages that depend on Fen.Client:
Package | Downloads |
---|---|
Fen.Coam
Standardized COAM conventions, from the opinions of the Fulfiller Enablement team. |
|
Fen.Client.Prepress
Standardized HttpClient conventions for Prepress services, from the opinions of the Fulfiller Enablement team. |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
9.1.0 | 2,496 | 1/23/2023 |
9.0.0 | 2,794 | 4/19/2022 |
9.0.0-pre4 | 695 | 4/14/2022 |
9.0.0-pre3 | 589 | 4/13/2022 |
9.0.0-pre2 | 605 | 4/12/2022 |
9.0.0-pre1 | 642 | 4/8/2022 |
8.0.2 | 5,565 | 1/26/2021 |
8.0.1 | 1,084 | 1/25/2021 |
8.0.0 | 1,087 | 1/22/2021 |
7.0.0 | 6,290 | 10/31/2019 |
6.4.2 | 11,613 | 5/28/2019 |
6.4.1 | 1,581 | 5/3/2019 |
6.4.0 | 4,910 | 2/18/2019 |
6.3.0 | 1,491 | 1/30/2019 |
6.2.1 | 1,588 | 12/11/2018 |
6.1.0 | 32,767 | 10/11/2018 |
6.1.0-pre1 | 1,100 | 10/8/2018 |
6.0.1 | 8,881 | 8/20/2018 |
6.0.0 | 3,937 | 8/17/2018 |
5.0.0 | 1,659 | 7/26/2018 |
4.0.2 | 63,766 | 7/12/2018 |
4.0.1 | 2,302 | 6/7/2018 |
4.0.0 | 1,412 | 6/6/2018 |
4.0.0-preview2 | 1,306 | 6/6/2018 |
4.0.0-preview1 | 1,331 | 6/6/2018 |
3.0.0 | 3,073 | 5/15/2018 |
2.0.0 | 13,403 | 1/26/2018 |
1.0.1 | 5,668 | 12/12/2017 |
⁃ Everything is new!