dct 0.0.7

dct (Dotnet CLI Tool)

A .NET global CLI tool to rapidly generate CQRS and Clean Architecture components such as commands, queries, handlers, classes, and interfaces. Streamline your development workflow and enforce best practices with customizable templates and configuration.

Features

• Generate CQRS artifacts: commands, queries, handlers
• Create classes and interfaces with a single command
• Initialize default config and templates
• Fully customizable via templates and configuration
• Fast, scriptable, and easy to use

Installation

After publishing to NuGet, install globally with:

dotnet tool install -g dct

Getting Started

Before using dct, you must initialize and configure it in your project:

dct init

This command creates a .dct folder in your project root, containing all templates and a .dct-config file. All code generation is based on these templates and your configuration. You can customize the templates and .dct/.dct-config to fit your project's needs. With proper configuration, dct can generate any artifact or file structure you require.

Usage

Show version

dct --version

Initialize configuration and templates (required before first use)

dct init

Generate an artifact (command, query, handler, class, interface, or any custom template)

dct create <artifact> <path>

• <artifact>: Type of artifact to generate (e.g., command, query, handler, class, interface, or any custom template name)
• <path>: Target path or name for the generated file(s)

Examples

Customization

Configuration

Customize generation by editing the .dct/.dct-config file in your project root. Example:

{
  "templatePaths": {
    "command": "./dct-templates/command.scriban",
    "query": "./dct-templates/query.scriban",
    "handler": "./dct-templates/handler.scriban"
  }
}

Templates

You can override default templates or add your own by placing them in the .dct/Templates/ directory. Supported templates include:

• command.scriban
• handler.scriban
• query.scriban
• Any custom template you define

Edit these files to match your coding standards and patterns. The tool will use your configuration and templates to generate code exactly as you need.

Development

Dependencies

• Spectre.Console.Cli
• Scriban

License

MIT License

© 2024 Mikheil Berishvili. See LICENSE for details.