AvroConvert 3.4.12

<p align="center"> <img alt="SolTechnology-logo" src="./docs/logo.png" width="200"> </p>

<h2 align="center"> AvroConvert </h2>

<p align="center"> <a> Rapid Avro serializer for C# .NET </a> </p>

<p align="center"> <a href="https://github.com/AdrianStrugala/AvroConvert"><img src="https://img.shields.io/github/stars/AdrianStrugala/AvroConvert.svg?label=%E2%AD%90%20Stars%20%E2%AD%90&color=yellow&style=flat&logo=github"></a> <a href="https://adrianstrugala.github.io/AvroConvert/"><img src="https://img.shields.io/badge/AvroConvertOnline-Try%20Now-blue.svg?logo=google-chrome"></a> <br> <a href="https://www.nuget.org/packages/AvroConvert"><img src="https://img.shields.io/nuget/v/AvroConvert.svg?logo=nuget"></a> <a href="https://github.com/AdrianStrugala/AvroConvert/actions/workflows/build&test.yml"><img src="https://github.com/AdrianStrugala/AvroConvert/actions/workflows/build&test.yml/badge.svg"></a> <a href="https://www.nuget.org/packages/AvroConvert"><img src="https://img.shields.io/nuget/dt/AvroConvert.svg?label=NuGet%20Downloads&logo=nuget&color=blue"></a> <br>

</p>

Docs

Apache Avro format documentation

First steps with Avro in the .NET

AvroConvert documentation

Benefits

Avro format combines readability of JSON and data compression of binary serialization.

Introducing Avro to the projects brings three main benefits:

• Reduction of data size and storage cost
• Decrease of the communication time and the network traffic between microservices
• Increased security - the data is not visible in plain text format

Article describing Avro format specification and Avro API idea: https://www.c-sharpcorner.com/blogs/avro-rest-api-as-the-evolution-of-json-based-communication-between-mic

Conclusion: <br> Using Avro for communication between your services significantly reduces data size and network traffic. Additionally choosing encoding (compression algorithm) can improve the results even further.

Full Changelog

Features

• Serialization

 byte[] avroObject = AvroConvert.Serialize(object yourObject);

<br/>

• Deserialization

CustomClass deserializedObject = AvroConvert.Deserialize<CustomClass>(byte[] avroObject);

<br/>

• Read schema from Avro object

string schemaInJsonFormat = AvroConvert.GetSchema(byte[] avroObject)

<br/>

• Deserialization of large collection of Avro objects one by one

using (var reader = AvroConvert.OpenDeserializer<CustomClass>(new MemoryStream(avroObject)))
{
    while (reader.HasNext())
    {
        var item = reader.ReadNext();
        // process item
    }
}

• Generation of C# models from Avro file or schema

  string resultModel = AvroConvert.GenerateModel(avroObject);

• Conversion of Avro to JSON directly

  var resultJson = AvroConvert.Avro2Json(avroObject);

Extended list: <br>

1. Serialization of .NET object to Avro format
   • Standard
   • Excluding header
2. Deserialization of Avro data to .NET object
   • Standard
   • Excluding header
   • Processing collection items one by one
3. Other Avro data related operations
   • Merge Avro objects
   • JSON to Avro conversion
   • Avro to JSON conversion
4. Schema related
   • Get schema from Avro data
   • Generate schema from .NET object
   • Generate .NET model from Avro data or schema
   • Generate Avro schema for JSON data

Full documentation

License

AvroConvert is licensed under the CC BY-NC-SA 3.0 license.

For commercial use, please purchase a license.

Contribution

We want to improve AvroConvert as much as possible. If you have any idea, found next possible feature, optimization opportunity or better way for integration, leave a comment or pull request.

Thank you a million to all the contributors to the library, including those that raise issues, started conversations, and those who send pull requests. Thank you!

These amazing people have contributed to AvroConvert:

<a href="https://github.com/AdrianStrugala/AvroConvert/graphs/contributors"> <img src="https://contrib.rocks/image?repo=AdrianStrugala/AvroConvert" /> </a>

Related Work

• - online Avro Schema to C# model converter

• - Library containing functionalities, which enable communication between microservices via Http using Avro data format

• - Library containing components needed for Confluent Kafka integration

• Avro API article