This repository contains a set of templates to be used when creating .NET projects from the dotnet new command line interface.
You can use this guide to understand the options available to you when generating a project using the templates
The current version of the package contains the following templates.
| Name | Short name |
|---|---|
| ASP.NET Core API | emg-web-api |
| Batch JobProcessor | emg-batch-jobprocessor |
| Hosted Service | emg-hosted-service |
| Lambda Event Function | emg-lambda-event |
| Lambda RequestResponse Function | emg-lambda-requestresponse |
| Test Project | emg-test-lib |
| Windows Service | emg-windows-service |
dotnet new emg-web-api
This template creates a REST API hosted by a ASP.NET Core application.
The following packages are added by default:
EMG.Extensions.AspNetCore.Authentication.JWTEMG.Extensions.AspNetCore.Filters.ErrorEMG.Extensions.Logging.Loggly
You can customize the application by providing the following parameters
--configure-awsadds the basic setup for AWS services--nybusadds support for sending messages with Nybus v1--nybus-bridgeadds support for sending messages via the NybusBridge to Nybus v0 applications--wcf-discoveryadds support for discovering WCF services
dotnet new emg-batch-jobprocessor
This template creates a console application that can be used to process AWS Batch jobs.
dotnet new emg-hosted-service
This template creates a Hosted Service application. The runtime is selected depending on which workloads are selected.
The application can be customized with the following parameters:
--add-nybus Currentadds support for hosting Nybus v1.x handlers--add-nybus Legacyadds support for hosting Nybus v0.x handlers. Requires .NET Framework 4.8--add-wcfadds support for hosting WCF services. Requires .NET Framework 4.8--add-awsadds basic setup to AWS services--force-net48forces the runtime to be .NET Framework 4.8 even if the application could run on .NET Core 3.1
dotnet new emg-lambda-event
This template creates a AWS Lambda function that reacts to event and does not return a response.
dotnet new emg-lambda-requestresponse
This template creates a AWS Lambda function that reacts to event and then returns a response.
dotnet new emg-test-lib
This template creates a unit-test project using NUnit 3.x.
It also has references to
AutoFixtureMoqAutoFixture.NUnit3AutoFixture.AutoMoqAutoFixture.Idioms
The project will contain a specialization of AutoDataAttribute that configures the Moq glue library for AutoFixture.
dotnet new emg-windows-service
This template creates a Windows Service application based on TopShelf.
The application can be customized with the following parameters:
--add-nybus Currentadds support for hosting Nybus v1.x handlers--add-nybus Legacyadds support for hosting Nybus v0.x handlers--add-wcfadds support for hosting WCF services--add-awsadds basic setup to AWS services
If your application needs to be hosted in a Docker container, please use the emg-hosted-service with the same parameters.
You can install the templates in this package by running the following command:
dotnet new -i EMG.Templates
Alternatively, you can check out the repository and install the package by running the following command in the folder where you checked out the repository:
dotnet new -i .\content\
To update the templates to the latest version, simply reinstall the package as specified in the section above.
To uninstall the templates, you can use the command suggested by the dotnet new -u command.
Example:
C:\Development\EMG\Templates\content
Templates:
[EMG] Batch JobProcessor (emg-batch-jobprocessor) C#
[EMG] Lambda Event Function (emg-lambda-event) C#
[EMG] Hosted Service (emg-hosted-service) C#
[EMG] Lambda RequestResponse Function (emg-lambda-requestresponse) C#
[EMG] Test Project (emg-test-lib) C#
[EMG] ASP.NET Core API (emg-web-api) C#
[EMG] Windows Service (emg-windows-service) C#
Uninstall Command:
dotnet new -u C:\Development\EMG\Templates\content