NanoByte.CodeGeneration 0.4.0

.NET Standard 2.0
dotnet add package NanoByte.CodeGeneration --version 0.4.0
NuGet\Install-Package NanoByte.CodeGeneration -Version 0.4.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.
<PackageReference Include="NanoByte.CodeGeneration" Version="0.4.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add NanoByte.CodeGeneration --version 0.4.0
#r "nuget: NanoByte.CodeGeneration, 0.4.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 NanoByte.CodeGeneration as a Cake Addin
#addin nuget:?package=NanoByte.CodeGeneration&version=0.4.0

// Install NanoByte.CodeGeneration as a Cake Tool
#tool nuget:?package=NanoByte.CodeGeneration&version=0.4.0

NanoByte Code Generation

Build NuGet API documentation
A thin wrapper around the Roslyn API to simplify generating C# code.

This can be used to implement things like code generators for Swagger/OpenAPI Spec, ORMs, etc. using a type-safe interface rather than simple string templating.

While you can use the Rosyln API directly, its immutable and thread-safe design can make using it somewhat verbose and cumbersome. This library provides a simpler (but also less flexible) wrapper.

Usage

Add a reference to the NanoByte.CodeGeneration NuGet package to your project. You can then generate a class like this:

var myClass = new CSharpClass(new CSharpIdentifier("MyNamespace", "MyClass"))
{
    Description = "My class",
    Properties =
    {
        new CSharpProperty(CSharpIdentifier.String, "MyProperty")
        {
            Description = "My property",
            HasSetter = true
        }
    }
};
myClass.WriteToFile("MyClass.cs");

Take a look at the documentation for more features, such as interfaces and attributes.

Building

The source code is in src/, config for building the API documentation is in doc/ and generated build artifacts are placed in artifacts/. The source code does not contain version numbers. Instead the version is determined during CI using GitVersion.

To build run .\build.ps1 or ./build.sh (.NET SDK is automatically downloaded if missing using 0install).

Contributing

We welcome contributions to this project such as bug reports, recommendations and pull requests.

This repository contains an EditorConfig file. Please make sure to use an editor that supports it to ensure consistent code style, file encoding, etc.. For full tooling support for all style and naming conventions consider using JetBrains' ReSharper or Rider products.

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 net7.0 net7.0-android net7.0-ios net7.0-maccatalyst net7.0-macos net7.0-tvos net7.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 net481
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

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
0.4.0 359 11/13/2021
0.3.1 263 3/3/2021
0.3.0 465 4/13/2020
0.2.3 365 4/3/2020
0.2.2 333 4/3/2020
0.2.1 400 4/3/2020
0.2.0 394 4/3/2020
0.1.1 366 4/2/2020
0.1.0 384 4/1/2020