DigitalEngine.TemplateTool 1.1.5

EngineTemplate CLI Tool

A command-line tool for generating features in Engine Template projects.

Installation

Install globally:

dotnet tool install -g DigitalEngine.TemplateTool

Or update to latest version:

dotnet tool update -g DigitalEngine.TemplateTool

Commands

add-feature

Generate a new feature with handler, provider, client and endpoint.

dotnet digitalengine add-feature <FeatureName>

The tool will prompt you for:

• Engine name (auto-detected from project structure)
• HTTP method (MapGet or MapPost)
• Route pattern (e.g., policy/{policyNumber})
• Function name (e.g., GetPolicyByPolicyNumber)
• Endpoint type (User, Base, Service, Admin, or Custom)
• Authorization roles (multi-select)

What Gets Generated:

For MapPost:

• {Feature}Handler.cs - Endpoint handler
• I{Feature}Provider.cs - Provider interface
• {Feature}Provider.cs - Provider implementation
• {Function}Request.cs - Request model
• {Function}Response.cs - Response model
• Endpoint mapping in EndpointMappingExtensions.cs
• DI registration in DependencyInjectionSetup.cs
• Client method in appropriate client file

For MapGet:

• Same as above, but without Request model

Client Generation:

• Base/User/Custom endpoints → {Engine}Client.cs
• Admin endpoints → {Engine}AdminClient.cs
• Service endpoints → {Engine}ServiceClient.cs

Example:

dotnet digitalengine add-feature Policy

add-config

Generate IOptions configuration classes from appsettings.json.

dotnet digitalengine add-config

The tool will:

1. Read your appsettings.json file
2. Display top-level configuration sections (excludes system sections like Serilog, ConnectionStrings)
3. Let you multi-select which sections to generate
4. Create POCO classes in {Engine}.Api/Models/Config/
5. Register them in DependencyInjectionSetup.cs with services.Configure<T>()

Supports nested objects:

For this appsettings.json:

{
  "GoogleMaps": {
    "ApiUrls": {
      "DirectionsUrl": "https://routes.googleapis.com",
      "PlacesUrl": "https://places.googleapis.com"
    },
    "Autogen": {
      "ApiKey": ""
    }
  }
}

Generates:

public class GoogleMapsOptions
{
    public GoogleMapsApiUrls ApiUrls { get; set; }
    public GoogleMapsAutogen Autogen { get; set; }
}

public class GoogleMapsApiUrls
{
    public string DirectionsUrl { get; set; }
    public string PlacesUrl { get; set; }
}

public class GoogleMapsAutogen
{
    public string ApiKey { get; set; }
}

Example:

dotnet digitalengine add-config
# Select: Redis, GoogleMaps, Exceptionless

undo

Remove a generated feature and all its files.

dotnet digitalengine undo <FeatureName>

The tool will:

1. Ask for confirmation
2. Delete all generated files (Handler, Provider, Interface, Models)
3. Remove endpoint mappings from EndpointMappingExtensions.cs
4. Remove DI registrations from DependencyInjectionSetup.cs
5. Remove client methods from client files
6. Clean up unused using statements

Example:

dotnet digitalengine undo Policy
# Confirm: Yes

Other Commands

Help

dotnet digitalengine --help
dotnet digitalengine add-feature --help

Version

dotnet digitalengine --version

Testing

The tool includes integration tests:

cd DigitalEngine.TemplateTool.Tests
dotnet test