Installation

Prerequisites

• .Net 8.0 SDK

Docker and dotnet ef are needed for setting up your database and running your integration tests.

• Docker
• dotnet ef

Getting Started

1. Install the Craftsman tool globally. This is going to be the workhorse behind all of our commands. Make sure to close your powershell/command prompt/terminal windows after your initial install!

   dotnet tool install -g craftsman

   If you are using private NuGet sources you may need to temporarily disable them to properly install the tool. Unfortunately, the dotnet sdk doesn't have a –nuget-source parameter for dotnet tool install commands yet, though I have a feature request pending if you'd like to track its progress.`

2. Run any of the below for a list of available commands

   craftsman
   craftsman list
   craftsman -h
   craftsman --help

3. That's it! Now let's look at an example to see it in action.

You can also run craftsman new example to create one of several example projects.

Updating Craftsman

To update to the latest version of Craftsman, you can run:

dotnet tool update -g craftsman

Troubleshooting

Depending on your nuget setup, you might get an issue with your nuget source along the lines of this:

/usr/local/share/dotnet/sdk/6.0.100/NuGet.targets(130,5): warning : Your request could not be authenticated by the GitHub Packages service. Please ensure your access token is valid and has the appropriate scopes configured.

To resolve this, you can disable and reenable your nuget source and you should be good to go:

dotnet nuget list source

Should return something like this:

Registered Sources:
  1.  nuget.org [Enabled]
      https://api.nuget.org/v3/index.json

Then you want to disable and reenable it:

dotnet nuget disable source nuget.org
dotnet nuget enable source nuget.org