Remora.Rest.Core 2.2.1

Prefix Reserved
.NET 6.0 This package targets .NET 6.0. The package is compatible with this framework or higher. .NET Standard 2.1 This package targets .NET Standard 2.1. The package is compatible with this framework or higher. 
dotnet add package Remora.Rest.Core --version 2.2.1                

                    
                

            
NuGet\Install-Package Remora.Rest.Core -Version 2.2.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="Remora.Rest.Core" Version="2.2.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add Remora.Rest.Core --version 2.2.1                

                    
                

            
#r "nuget: Remora.Rest.Core, 2.2.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 Remora.Rest.Core as a Cake Addin
#addin nuget:?package=Remora.Rest.Core&version=2.2.1

// Install Remora.Rest.Core as a Cake Tool
#tool nuget:?package=Remora.Rest.Core&version=2.2.1

Remora.Rest

Remora.Rest is a compact helper library for building REST API wrappers, giving you the tools you need to rapidly create robust, highly configurable wrappers of your own.

The library is somewhat opinionated, and it does target a single subset of REST API types - those whose payloads (error or otherwise) are JSON-serialized. For these use cases, however, the library is quite adept at what it does.

Quickstart

At its core, the library expects you to do two things - one, to access the REST endpoints through a configured RestHttpClient<TError>, and two, to define the entities in the API model through an interface/implementation combination.

var services = new ServiceCollection();

var clientBuilder = services
    .AddRestHttpClient<RestHttpClient<ErrorPayloadType>>();

// Perform HttpClient configuration (adding Polly policies, setting default
// request headers, etc)
clientBuilder...

// Configure API model types
services.Configure<JsonSerializerOptions>(clientBuilder.Name, options => 
{
    options.AddDataObjectConverter<IModelType, ModelType>();
});

After you've set up your client and your types, you can then inject an instance of RestHttpClient<TError> into your actual API wrapper type (the instance is transient, so you can treat it the same as any HttpClient you'd normally inject).

public class MyWrapper
{
    private readonly RestHttpClient<ErrorPayloadType> _restClient;
    
    public MyWrapper(RestHttpClient<ErrorPayloadType> restClient)
    {
        _restClient = restClient;
    }
}

More detailed documentation will hopefully be available in the future; in the meantime, check out Remora.Discord, for which this project was originally developed - it pushes all available functionality to its limits, and serves as a relatively comprehensive demonstration of what you can do with the library.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  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 is compatible.  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 is compatible.  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 netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.1 is compatible. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen60 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.

  • .NETStandard 2.1

    • No dependencies.

  • net6.0

    • No dependencies.

  • net7.0

    • No dependencies.

  • net8.0

    • No dependencies.

NuGet packages (6)

Showing the top 5 NuGet packages that depend on Remora.Rest.Core:

Package Downloads
Remora.Discord.API.Abstractions

Interface definitions of Discord's API
Remora.Rest

Core functionality of basic REST-focused API tooling, allowing you to easily build new wrappers around your favourite services.
VTP.RemoraHelpSystem

Provides a simple, modular help system for Remora.Discord.
VTP.Remora.Views

A (currently POC) library to implement views (e.g. MVC) into the Remora.Discord library.
VTP.Remora.Discord.Builders

Adds builders to make Remora.Discord slightly easier to use.

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on Remora.Rest.Core:

Repository Stars
Remora/Remora.Discord
A data-oriented C# Discord library, focused on high-performance concurrency and robust design.
Version Downloads Last updated
2.2.1 58,924 11/20/2023
2.2.0 101,550 2/26/2023
2.1.0 10,156 12/28/2022
2.0.5 6,948 11/20/2022
2.0.4 31,837 8/19/2022
2.0.3 656 8/3/2022
2.0.2 86,570 4/19/2022
2.0.1 24,875 2/20/2022
2.0.0 75,590 11/26/2021
1.0.0 3,997 11/14/2021

Update nuget packages and SDK.