An open API service indexing awesome lists of open source software.

https://github.com/genocs/genocs-library-cli

Part of the Genocs framework repositories: .NET CLI for template installation and project bootstrapping.
https://github.com/genocs/genocs-library-cli

Last synced: 27 days ago
JSON representation

Part of the Genocs framework repositories: .NET CLI for template installation and project bootstrapping.

Awesome Lists containing this project

README

          

# Genocs CLI

![Genocs Library Banner](assets/genocs-library-banner_v2.png)

[![GitHub](https://img.shields.io/github/license/Genocs/genocs-library-cli?color=2da44e&style=flat-square)](https://github.com/Genocs/genocs-library-cli/blob/main/LICENSE)
[![.NET build and test](https://github.com/Genocs/genocs-library-cli/actions/workflows/build-and-test.yml/badge.svg)](https://github.com/Genocs/genocs-library-cli/actions/workflows/build-and-test.yml)
[![NuGet](https://img.shields.io/nuget/v/Genocs.CLI.svg)](https://www.nuget.org/packages/Genocs.CLI)
[![NuGet Downloads](https://img.shields.io/nuget/dt/Genocs.CLI.svg)](https://www.nuget.org/packages/Genocs.CLI)
[![Discord](https://img.shields.io/discord/1106846706512953385?color=%237289da&label=Discord&logo=discord&logoColor=%237289da&style=flat-square)](https://discord.com/invite/fWwArnkV)
[![Twitter](https://img.shields.io/twitter/follow/genocs?color=1DA1F2&label=Twitter&logo=Twitter&style=flat-square)](https://twitter.com/genocs)


Genocs Library Logo

## Introduction

Genocs CLI is a **dotnet tool** that helps you install and use Genocs templates.
These templates help you bootstrap microservices and other solution types quickly.

## Supported runtime

Genocs CLI runs on .NET 10.

## Documentation

- [Genocs CLI docs](https://learn.fiscanner.net/cli/)
- [Microsoft - .NET tools](https://learn.microsoft.com/en-us/dotnet/core/tools/global-tools)
- [Changelog](https://github.com/genocs/genocs-library-cli/blob/main/CHANGELOG.md)

---

Useful commands

```bash
# List installed tools
dotnet tool list -g

# Get the list of templates
dotnet new list

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

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

# Uninstall the tool
dotnet tool uninstall -g genocs.cli
```

Useful commands for local development

```bash
cd ./src
# build the project
dotnet build genocs.cli.csproj

# Pack the tool (to be deployed on nuget)
dotnet pack genocs.cli.csproj -p:PackageVersion={semver} --output nupkg
dotnet pack genocs.cli.csproj --output nupkg

# Run the tool to install templates
dotnet run -f net10.0 --project ./src/genocs.cli.csproj -- install

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

CLI commands:

```bash
genocs version
genocs install
# aliases: genocs i | genocs update | genocs u

genocs blazor new
genocs webapi new
genocs worker new
genocs cleanapi new
genocs angular new
genocs react new
```

Run tests locally:

```bash
dotnet test genocs.cli.slnx
```
## License

This project is licensed with the [MIT license](LICENSE).

## Community

- Discord [@genocs](https://discord.com/invite/fWwArnkV)
- Facebook Page [@genocs](https://facebook.com/Genocs)
- Youtube Channel [@genocs](https://youtube.com/c/genocs)

## Support

Has this Project helped you learn something New? or Helped you at work?

Here are a few ways by which you can support.

- ⭐ Leave a star!
- 🥇 Recommend this project to your colleagues.
- 🦸 Do consider endorsing me on LinkedIn for ASP.NET Core - [Connect via LinkedIn](https://www.linkedin.com/in/giovanni-emanuele-nocco-b31a5169/)
- ☕ If you want to support this project in the long run, consider [buying me a coffee](https://www.buymeacoffee.com/genocs)!

[![buy-me-a-coffee](https://raw.githubusercontent.com/Genocs/genocs-library-cli/main/assets/buy-me-a-coffee.png "buy me a coffee")](https://www.buymeacoffee.com/genocs)

## Code Contributors

This project exists thanks to all the people who contribute. [Submit your PR and join the team!](CONTRIBUTING.md)

[![genocs contributors](https://contrib.rocks/image?repo=Genocs/genocs-library-cli "genocs contributors")](https://github.com/genocs/genocs-library-cli/graphs/contributors)

## Financial Contributors

Become a financial contributor and help me sustain the project.

**Support the Project** on [Opencollective](https://opencollective.com/genocs)