Fen.Client 1.0.1

There is a newer version of this package available.
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                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Fen.Client" Version="1.0.1" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Fen.Client --version 1.0.1                
#r "nuget: Fen.Client, 1.0.1"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// 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 the JsonSerializationSettings in the service's MvcJsonOptions.

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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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!