Ion Object Mapper for .NET
This is the Ion Object Mapper for .NET, which is a convenience library built to assist developers when dealing with data that's in the format of Amazon Ion. It is used to easily transform C# classes and objects into Ion format and vice-versa.
Requirements
.NET
The Ion Object Mapper targets .NET Core 3.1. Please see the link below for more information on compatibility:
Getting Started
See the Cookbook for a simple usage guide.
Spec
See the Spec for a detailed specification of the Ion Object Mapper.
Contributing
If you are interested in contributing to the Ion Object Mapper, please take a look at CONTRIBUTING.
Development
Setup
Assuming that you have .NET Core SDK version 3.1 or later installed from the Microsoft .NET downloads site, use the below command to clone the repository.
$ git clone https://github.com/amzn/ion-object-mapper-dotnet.git
$ cd ion-object-mapper-dotnet
Changes can now be made in the repository.
The project currently uses default dotnet CLI tools, you can build the project simply by:
$ dotnet build
Running Tests
You can run the unit tests by:
$ dotnet test Amazon.IonObjectMapper.Test
You can also run the performance tests by:
$ dotnet test Amazon.IonObjectMapper.PerformanceTest
Documentation
DocFX is used for documentation. Please see the link below for more detail to install DocFX
You can generate the docstring HTML locally by running the following in the root directory of this repository:
$ docfx docs/docfx.json --serve
Security
See CONTRIBUTING for more information.
License
This project is licensed under the Apache-2.0 License.