ProtoBufJsonConverter 0.2.0-preview-04

.NET 6.0 .NET Standard 2.0 .NET Framework 4.6.2

This is a prerelease version of ProtoBufJsonConverter.

There is a newer version of this package available.
See the version list below for details.

dotnet add package ProtoBufJsonConverter --version 0.2.0-preview-04

NuGet\Install-Package ProtoBufJsonConverter -Version 0.2.0-preview-04

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="ProtoBufJsonConverter" Version="0.2.0-preview-04" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

paket add ProtoBufJsonConverter --version 0.2.0-preview-04

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: ProtoBufJsonConverter, 0.2.0-preview-04"

#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 ProtoBufJsonConverter as a Cake Addin
#addin nuget:?package=ProtoBufJsonConverter&version=0.2.0-preview-04&prerelease

// Install ProtoBufJsonConverter as a Cake Tool
#tool nuget:?package=ProtoBufJsonConverter&version=0.2.0-preview-04&prerelease

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

ProtoBufJsonConverter

This project uses protobuf-net to:

Convert a protobuf message to a JSON string using the proto definition file.
Convert a protobuf message to an object using the proto definition file.
Convert a JSON string or an object to a protobuf message using the proto definition file.

Usage

Proto Definition

syntax = "proto3";

// Package name
package greet;

// The greeting service definition.
service Greeter {
  rpc SayHello (HelloRequest) returns (HelloReply);
}

// The request message containing the user's name.
message HelloRequest {
  string name = 1;
}

// The response message containing the greetings
message HelloReply {
  string message = 1;
}

1️⃣ Convert ProtoBuf `byte[]` to a JSON `string`

Code

var protoDefinition = "...". // See above

var bytes = Convert.FromBase64String("CgRzdGVm");

var request = new ConvertToJsonRequest(protoDefinition, "greet.HelloRequest", bytes);

var converter = new Converter();

var json = await converter.ConvertAsync(request);

JSON

{"name":"stef"}

1️⃣ Convert ProtoBuf `byte[]` to an object

Code

var protoDefinition = "...". // See above

var bytes = Convert.FromBase64String("CgRzdGVm");

var request = new ConvertToObjectRequest(protoDefinition, "greet.HelloRequest", bytes);

var converter = new Converter();

var @object = await converter.ConvertAsync(request);

3️⃣ Convert JSON `string` to a ProtoBuf `byte[]`

Code

var protoDefinition = "...". // See above

var json = @"{""name"":""stef""}";

var request = new ConvertToProtoBufRequest(protoDefinition, "greet.HelloRequest", json);

var converter = new Converter();

var protobuf = await converter.ConvertAsync(request);

4️⃣ Convert any `object` to a ProtoBuf `byte[]`

Code

var protoDefinition = "...". // See above

var obj = new
{
    name = "stef"
};

var request = new ConvertToProtoBufRequest(protoDefinition, "greet.HelloRequest", obj);

var converter = new Converter();

var protobuf = await converter.ConvertAsync(request);

5️⃣ Convert any `object` to a ProtoBuf `byte[]` including the Grpc Header

Code

var protoDefinition = "...". // See above

var obj = new
{
    name = "stef"
};

var request = new ConvertToProtoBufRequest(protoDefinition, "greet.HelloRequest", obj)
    .WithGrpcHeader();

var converter = new Converter();

var protobufWithGrpcHeader = await ConvertAsync.Convert(request);

Using in Blazor WebAssembly

In order to use this library in a Blazor WebAssembly application, you need to provide a specific Blazor implementation for the IMetadataReferenceService, the BlazorWasmMetadataReferenceService.

Convert ProtoBuf `byte[]` to a JSON `string`

Dependency Injection

public class Program
{
    public static async Task Main(string[] args)
    {
        // ...

        // Add AddSingleton registrations for the IMetadataReferenceService and IConverter
        builder.Services.AddSingleton<IMetadataReferenceService, BlazorWasmMetadataReferenceService>();
        builder.Services.AddSingleton<IConverter, Converter>();

        await builder.Build().RunAsync();
    }
}

Blazor Page

public partial class Home
{
    [Inject]
    public required IConverter Converter { get; set; }

    private State _state = State.None;
    private string _protoDefinition = "..."; // See above
    private string _messageType = "greet.HelloRequest";
    private ConvertType _selectedConvertType = ConvertType.ToJson;
    private string _protobufAsBase64 = "CgRzdGVm";
    private bool _skipGrpcHeader = true;
    private bool _addGrpcHeader = true;
    private string _json = string.Empty;


    private async Task OnClick()
    {
        await ConvertToJsonAsync();
    }

    private async Task ConvertToJsonAsync()
    {
        _json = string.Empty;

        var bytes = Convert.FromBase64String(_protobufAsBase64);

        var convertToJsonRequest = new ConvertToJsonRequest(_protoDefinition, _messageType, bytes)
            .WithSkipGrpcHeader(_skipGrpcHeader)
            .WithJsonConverterOptions(new JsonConverterOptions { WriteIndented = true });

        _json = await Converter.ConvertAsync(convertToJsonRequest);
    }
}

For a full example, see examples/ProtoBufJsonConverter.Blazor.

Examples

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 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	netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed.
.NET Standard	netstandard2.0 is compatible. netstandard2.1 is compatible.
.NET Framework	net461 was computed. net462 is compatible. 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	tizen40 was computed. 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.

.NETFramework 4.6.2
- JsonConverter.Newtonsoft.Json (>= 0.5.0)
- MetadataReferenceService.Default (>= 0.0.1)
- Microsoft.CodeAnalysis.CSharp (>= 4.8.0)
- protobuf-net (>= 3.2.30)
- protobuf-net.Reflection (>= 3.2.12)
- Stef.Validation (>= 0.1.1)
.NETStandard 2.0
- JsonConverter.Newtonsoft.Json (>= 0.5.0)
- MetadataReferenceService.Default (>= 0.0.1)
- Microsoft.CodeAnalysis.CSharp (>= 4.8.0)
- protobuf-net (>= 3.2.30)
- protobuf-net.Reflection (>= 3.2.12)
- Stef.Validation (>= 0.1.1)
.NETStandard 2.1
- JsonConverter.Newtonsoft.Json (>= 0.5.0)
- MetadataReferenceService.Default (>= 0.0.1)
- Microsoft.CodeAnalysis.CSharp (>= 4.8.0)
- protobuf-net (>= 3.2.30)
- protobuf-net.Reflection (>= 3.2.12)
- Stef.Validation (>= 0.1.1)
net6.0
- JsonConverter.Newtonsoft.Json (>= 0.5.0)
- MetadataReferenceService.Default (>= 0.0.1)
- Microsoft.CodeAnalysis.CSharp (>= 4.8.0)
- protobuf-net (>= 3.2.30)
- protobuf-net.Reflection (>= 3.2.12)
- Stef.Validation (>= 0.1.1)

NuGet packages (2)

Showing the top 2 NuGet packages that depend on ProtoBufJsonConverter:

Package	Downloads
WireMock.Net Lightweight Http Mocking Server for .Net, inspired by WireMock from the Java landscape.	21.7M
WireMock.Net.ProtoBuf ProtoBuf and gRPC support for WireMock.Net	55

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on ProtoBufJsonConverter:

Repository	Stars
WireMock-Net/WireMock.Net WireMock.Net is a flexible product for stubbing and mocking web HTTP responses using advanced request matching and response templating. Based on the functionality from http://WireMock.org, but extended with more functionality.	1.4K

Version	Downloads	Last updated
0.5.0	200,657	10/17/2024
0.5.0-preview-01	78	10/17/2024
0.4.0	139	10/15/2024
0.4.0-preview-09	86	10/14/2024
0.4.0-preview-08	153	9/23/2024
0.4.0-preview-07	136	9/4/2024
0.4.0-preview-06	109	9/3/2024
0.4.0-preview-05	85	9/2/2024
0.4.0-preview-04	85	9/2/2024
0.4.0-preview-03	77	9/2/2024
0.4.0-preview-02	128	8/5/2024
0.4.0-preview-01	59	8/4/2024
0.3.0	2,543,037	3/6/2024
0.2.0	211,405	2/9/2024
0.2.0-preview-04	137	1/31/2024
0.2.0-preview-03	94	1/27/2024
0.2.0-preview-01	97	1/25/2024
0.1.0	234	1/6/2024
0.0.6	325	12/28/2023
0.0.5	181	12/27/2023
0.0.4	192	12/25/2023
0.0.3	183	12/23/2023
0.0.2	146	12/22/2023

See CHANGELOG.md

ProtoBufJsonConverter 0.2.0-preview-04

ProtoBufJsonConverter

This project uses protobuf-net to:

Usage

Proto Definition

1️⃣ Convert ProtoBuf byte[] to a JSON string

Code

JSON

1️⃣ Convert ProtoBuf byte[] to an object

Code

3️⃣ Convert JSON string to a ProtoBuf byte[]

Code

4️⃣ Convert any object to a ProtoBuf byte[]

Code

5️⃣ Convert any object to a ProtoBuf byte[] including the Grpc Header

Code

Using in Blazor WebAssembly

Convert ProtoBuf byte[] to a JSON string

Dependency Injection

Blazor Page

Examples

.NETFramework 4.6.2

.NETStandard 2.0

.NETStandard 2.1

net6.0

NuGet packages (2)

GitHub repositories (1)

1️⃣ Convert ProtoBuf `byte[]` to a JSON `string`

1️⃣ Convert ProtoBuf `byte[]` to an object

3️⃣ Convert JSON `string` to a ProtoBuf `byte[]`

4️⃣ Convert any `object` to a ProtoBuf `byte[]`

5️⃣ Convert any `object` to a ProtoBuf `byte[]` including the Grpc Header

Convert ProtoBuf `byte[]` to a JSON `string`