Dev

A .NET tool designed to simplify common development tasks for .NET projects.

Installation

You can install the tool globally using the .NET CLI:

dotnet tool install --global HC.Dev

To update to the latest version:

dotnet tool update --global HC.Dev

Features

Launch Solution or Project

The default command launches the current solution in your default IDE or project in Visual Studio Code.

dev
# or
dev launch

Bump Version

Bumps the version of all projects in the current solution or the current project.

dev bump [major|minor|patch|revision]

The bump command supports the following options:

• major: Increments the major version (e.g., 1.0.0 → 2.0.0)
• minor: Increments the minor version (e.g., 1.0.0 → 1.1.0) - Default
• patch: Increments the patch version (e.g., 1.0.0 → 1.0.1)
• revision: Increments the revision version (e.g., 1.0.0.0 → 1.0.0.1)

Bump and Commit Version

Bumps the version of all projects in the current solution or the current project and creates a git commit and tag for the new version.

dev bump-commit [major|minor|patch|revision]

The bump-commit command supports the following options:

• major: Increments the major version (e.g., 1.0.0 → 2.0.0)
• minor: Increments the minor version (e.g., 1.0.0 → 1.1.0) - Default
• patch: Increments the patch version (e.g., 1.0.0 → 1.0.1)
• revision: Increments the revision version (e.g., 1.0.0.0 → 1.0.0.1)

This command will:

1. Update the version in the .csproj or all projects in the .sln.
2. Stage the changes using git add.
3. Create a commit with the message build: {version}.
4. Tag the commit with the new version.

Build Solution or Project

Builds the current solution or project in Release mode.

dev build

If a build.cmd (Windows) or build.sh (Linux/macOS) file exists in the same directory, it will be used instead.

Frontend Building

Runs the Vidyano frontend builder in the current directory using Docker.

dev frontend

This command uses the ghcr.io/stevehansen/vidyano-frontend-builder Docker image to build your frontend.

Clean working directory

Removes build output from the current directory.

dev clean

Help

Displays help information.

dev help

Custom Commands

If a commands.json file exists in the current directory, it defines the available commands. Each entry can either reference a built-in command or specify processes to run on Windows and non-Windows systems. A command can be marked as the default using "default": true.

Placeholders {sln}, {project} and {dir} in the command lines are replaced with the detected solution file, project file and current directory.

When no default is specified and you run dev without arguments, the tool lists all commands found in commands.json.

Command Aliases

The following aliases are available for commonly used commands:

Alias	Command
b	build
c	clean
h	help
f	frontend
v	bump
vc	bump-commit

Combining Commands

You can combine multiple commands using the + operator to execute them sequentially:

# Build then run frontend
dev b+f

# Clean, build, then run frontend
dev c+b+f

# Using full command names
dev clean+build+frontend

When combining commands, execution stops if any command fails.

License

This project is licensed under the MIT License. See the LICENSE file for details.