Apizr 4.1.0

.NET Standard 2.0
NuGet\Install-Package Apizr -Version 4.1.0
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.
dotnet add package Apizr --version 4.1.0
<PackageReference Include="Apizr" Version="4.1.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Apizr --version 4.1.0
#r "nuget: Apizr, 4.1.0"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install Apizr as a Cake Addin
#addin nuget:?package=Apizr&version=4.1.0

// Install Apizr as a Cake Tool
#tool nuget:?package=Apizr&version=4.1.0

Apizr

Refit based web api client management, but resilient (retry, connectivity, cache, auth, log, priority, etc...)

Read - Documentation Browse - Source

History

The Apizr project was motivated by this 2015 famous blog post about resilient networking.

Its main focus was to address at least everything explained into this article, meanning:

  • Easy access to restful services
  • Work offline with cache management
  • Handle errors with retry pattern and global catching
  • Handle request priority
  • Check connectivity
  • Fast development time
  • Easy maintenance
  • Reuse existing libraries

But also, some more core features like:

  • Trace http traffic
  • Handle authentication

And more integration/extension independent optional features like:

  • Choose cache, log and connectivity providers
  • Register it as an MS DI extension
  • Integrate with Shiny
  • Map model with DTO
  • Use Mediator pattern
  • Use Optional pattern

The list is not exhaustive, there’s more, but what we wanted was playing with all of it with as less code as we could, not worrying about plumbing things and being sure everything is wired and handled by design or almost.

Inspired by Refit.Insane.PowerPack, we wanted to make it simple to use, mixing attribute decorations and fluent configuration.

Also, we built this lib to make it work with any .Net Standard 2.0 compliant platform, so we could use it seamlessly from any kind of app, with or without DI goodness.

Libraries

Change Log - Mar 30, 2022

Project Current Upcoming
Apizr NuGet NuGet Pre Release
Apizr.Extensions.Microsoft.DependencyInjection NuGet NuGet Pre Release
Apizr.Extensions.Microsoft.Caching NuGet NuGet Pre Release
Apizr.Integrations.Akavache NuGet NuGet Pre Release
Apizr.Integrations.MonkeyCache NuGet NuGet Pre Release
Apizr.Integrations.Fusillade NuGet NuGet Pre Release
Apizr.Integrations.MediatR NuGet NuGet Pre Release
Apizr.Integrations.Optional NuGet NuGet Pre Release
Apizr.Integrations.AutoMapper NuGet NuGet Pre Release

Install the NuGet package of your choice:

  • Apizr package comes with the For and CrudFor static instantiation approach (which you can register in your DI container then)
  • Apizr.Extensions.Microsoft.DependencyInjection package extends your IServiceCollection with AddApizr, AddApizrFor and AddApizrCrudFor registration methods
  • Apizr.Extensions.Microsoft.Caching package brings an ICacheHandler method mapping implementation for MS Extensions Caching
  • Apizr.Integrations.Akavache package brings an ICacheHandler method mapping implementation for Akavache
  • Apizr.Integrations.MonkeyCache package brings an ICacheHandler method mapping implementation for MonkeyCache
  • Apizr.Integrations.Fusillade package enables request priority management using Fusillade
  • Apizr.Integrations.MediatR package enables request auto handling with mediation using MediatR
  • Apizr.Integrations.Optional package enables Optional result from mediation requests (requires MediatR integration) using Optional.Async
  • Apizr.Integrations.AutoMapper package enables auto mapping for mediation requests (requires MediatR integration and could work with Optional integration) using AutoMapper

Apizr core package make use of well known nuget packages to make the magic appear:

Package Features
Refit Auto-implement web api interface and deal with HttpClient
Polly Apply some policies like Retry, CircuitBreaker, etc...
Microsoft.Extensions.Logging.Abstractions Delegate logging layer to MS Extensions Logging

It also comes with some handling interfaces to let you provide your own services for:

  • Caching with ICacheHandler, which comes with its default VoidCacheHandler (no cache), but also with:
    • InMemoryCacheHandler & DistributedCacheHandler: MS Extensions Caching methods mapping interface (Integration package referenced above), meaning you can provide any compatible caching engine
    • AkavacheCacheHandler: Akavache methods mapping interface (Integration package referenced above)
    • MonkeyCacheHandler: MonkeyCache methods mapping interface (Integration package referenced above)
  • Logging As Apizr relies on official MS ILogger interface, you may want to provide any compatible logging engine (built-in DebugLogger activated by default)
  • Connectivity with IConnectivityHandler, which comes with its default VoidConnectivityHandler (no connectivity check)
  • Mapping with IMappingHandler, which comes with its default VoidMappingHandler (no mapping conversion), but also with:
    • AutoMapperMappingHandler: AutoMapper mapping methods mapping interface (Integration package referenced above)
Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows
.NET Core netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1
.NET Standard netstandard2.0 netstandard2.1
.NET Framework net461 net462 net463 net47 net471 net472 net48
MonoAndroid monoandroid
MonoMac monomac
MonoTouch monotouch
Tizen tizen40 tizen60
Xamarin.iOS xamarinios
Xamarin.Mac xamarinmac
Xamarin.TVOS xamarintvos
Xamarin.WatchOS xamarinwatchos
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (5)

Showing the top 5 NuGet packages that depend on Apizr:

Package Downloads
Apizr.Extensions.Microsoft.DependencyInjection

Refit based web api client management, but resilient (retry, connectivity, cache, auth, log, priority...)

Apizr.Integrations.Akavache

Refit based web api client management, but resilient (retry, connectivity, cache, auth, log, priority...)

Apizr.Integrations.MonkeyCache

Refit based web api client management, but resilient (retry, connectivity, cache, auth, log, priority...)

Apizr.Integrations.AutoMapper

Refit based web api client management, but resilient (retry, connectivity, cache, auth, log, priority...)

Apizr.Integrations.Fusillade

Refit based web api client management, but resilient (retry, connectivity, cache, auth, log, priority...)

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
4.1.0 319 5/2/2022
4.0.0 761 3/30/2022
4.0.0-preview.2 70 3/15/2022
4.0.0-preview.1 64 2/15/2022
3.0.0 1,521 3/12/2021
2.0.0 734 1/4/2021
1.9.0 729 11/19/2020
1.8.1 789 10/22/2020
1.8.0 837 10/22/2020
1.7.0 836 10/19/2020
1.6.0 829 10/9/2020
1.5.0 872 7/31/2020
1.4.2 805 7/24/2020
1.4.1 801 7/21/2020
1.4.0 836 7/17/2020
1.3.0 851 7/9/2020
1.2.0 760 7/3/2020
1.1.0 592 6/22/2020
1.0.0 649 6/17/2020