CLI

Introduction #

The Genocs CLI (Command Line Interface) tool is a powerful and versatile command-line utility that enables developers to efficiently build, test, and run applications. It provides a unified experience across different services inside your platform. It allow developers to create applications with ease. With its extensive set of commands, the genocs CLI tool simplifies the development process by automating tasks such as project management, dependency resolution, and deployment. It is an essential tool for modern developers, offering productivity, and scalability in application development.

Genocs CLI is the dotnet tool that allow you to use the genocs templates. Genocs templates are dotnet template that will help you to setup quickly and easily services in your environment.

Genocs tool is based on Microsoft - dotnet tools. Here where you can find the official Documentation:

• Microsoft - dotnet tools

Supported runtime #

Genocs CLI can be used on both .NET 8.

How to install #

To install the tool the only think you have to do is to take it from NuGet, install it into your global, that’s it.

dotnet tool install -g genocs.cli

Useful commands #

# Get the list of tool
dotnet tool list

# Get the list of templates
# Remember templates are the actual component that allows you to scaffold the service solution.
dotnet new list

# Install from nuget
dotnet tool install -g genocs.cli

# Update the tool
dotnet tool update -g genocs.cli

# Uninstall cache
dotnet tool uninstall -g genocs.cli

Install templates #

Genocs contains a bunch of templates that you can use to build a complete set of services from scratch.

The picture shows the console log upon the template are installed.

The Templates #

Uninstall templates #

To uninstall the templates you can use the following command:

# Get the templates list
dotnet new uninstall

# Follow the command line instruction
# or run the commands below
dotnet new uninstall Genocs.CleanArchitectureTemplate
dotnet new uninstall Genocs.WebApiTemplate
dotnet new uninstall Genocs.MicroserviceTemplate
dotnet new uninstall Genocs.Microservice.Template

blazor #

To create a blazor portal use one of these commands

# To build a blazor portal 
genocs blazor new <Company.Project.Service>

# (SOON) To build a clean architecture blazor portal 
genocs cleanblazor new <Company.Project.Service>

WebAPI #

# To build a web api architecture webapi 
genocs webapi new <Company.Project.Service>

# Another option to build a clen architecture webapi 
genocs cleanapi new <Company.Project.Service>

# To build a microservice webapi with multitentant support
genocs microservice  <Company.Project.Service>

The solution #

You can find the solution on GitHub:

genocs-library-cli

You are free to fork or to clone it. Then you can update it at your own pace.

Useful commands to work on your own #

# build the project 
dotnet build ./src/genocs.cli.csproj

# Pack the tool (to be deployed on nuget) 
dotnet pack

# Run the tool to install the templates using the net8 as runtime
dotnet run -f net8.0 --project ./src/genocs.cli.csproj genocs -i

# Run the tool to install the templates (some as above with cd command)
cd ./src
dotnet run -f net8.0 genocs -i

# Install the tool from local folder to the global cache
dotnet tool install --global --add-source ./src/nupkg genocs.cli