NSmithy.Templates 0.10.1

Preview: NSmithy is in preview; expect some API changes before 1.0.

NSmithy

Docs · Examples · Design Docs · smithy.io

Smithy toolkit for .NET.

Development

The recommended way to work on this repo is with Nix and devenv.

1. Install Nix (recommended: Determinate Nix) and devenv.

2. Optionally install direnv to activate the dev environment automatically when entering the directory (direnv allow). Without it, run devenv shell manually.

3. Use the just recipes to build, test, and package:

   just          # list all available recipes
   just build    # build the codegen JAR and .NET solution
   just test     # run the test suite
   just fmt      # format all code
   just docs     # start the documentation dev server
   just ci       # run the full CI pipeline locally
   

Related Projects

• Smithy: The IDL and protocol framework NSmithy is built on.
• smithy4s: Scala codegen from Smithy models and the main inspiration for NSmithy.
• alloy: Smithy extensions used by NSmithy for simpleRestJson and gRPC.
• smithy-go / smithy-typescript: Official Smithy codegen plugins for Go and TypeScript.
• TypeSpec: Microsoft's alternative API description language, with first-party .NET emitters.