How To Start a Saturn Project

[scorelocity]

Followed instructions on How To Start page exactly and when I run:

dotnet fake build -t run

I get the following error:

Could not execute because the specified command or file was not found.

Am I missing a global install of Fake or is something wrong with the local tools install, or something else?

Originally posted by @scorelocity in #348

Are you able to run this?

dotnet --list-sdks

[scorelocity]

Yes:

6.0.301 [/usr/share/dotnet/sdk]

[scorelocity]

Seems that Fake is not being installed. It appears that fake-cli was removed from dotnet-tools.json in the Saturn template in this commit:

SaturnFramework/Saturn.Template@9e46b28

and therefore not being installed as part of

dotnet tool restore

Does it need to be installed some other way?

I think it does not need to be installed. Previously it was used to facilitate the building of the project.

I thought that it would be possible to run this template by:

# after installing the template and instantiating a sample project
# ...
dotnet run --project ./src/SaturnSample/

But it's throwing a bunch of errors.

Hum, those errors are related to the BooksViews, BooksRepository and BooksController. My guess is that after the upgrade that removed Fake (probably due to .NET incompatibilities), the feature of creating View/Repository/Controller automatically through the CLI started creating outdated files which does not compile.

❯ dotnet run --project ./src/SaturnSample/
    ~/SaturnSample/src/SaturnSample/Books/BooksViews.fs(4,14): error FS0039: The namespace 'GiraffeViewEngine' is not defined. [~/SaturnSample/src/SaturnSample/SaturnSample.fsproj]
    ~/SaturnSample/src/SaturnSample/Books/BooksViews.fs(10,7): error FS0039: The value or constructor 'div' is not defined. Maybe you want one of the following:   dict   Edit [~/SaturnSample/src/SaturnSample/SaturnSample.fsproj]
    ~/SaturnSample/src/SaturnSample/Books/BooksViews.fs(40,18): error FS0039: The value or constructor 'section' is not defined. Maybe you want one of the following:   Action [~/SaturnSample/src/SaturnSample/SaturnSample.fsproj]
    ~/SaturnSample/src/SaturnSample/Books/BooksViews.fs(45,7): error FS0039: The value or constructor 'div' is not defined. Maybe you want one of the following:   dict   Edit [~/SaturnSample/src/SaturnSample/SaturnSample.fsproj]
    ~/SaturnSample/src/SaturnSample/Books/BooksViews.fs(57,18): error FS0039: The value or constructor 'section' is not defined. Maybe you want one of the following:   Action [~/SaturnSample/src/SaturnSample/SaturnSample.fsproj]
    ~/SaturnSample/src/SaturnSample/Books/BooksViews.fs(61,7): error FS0039: The value or constructor 'div' is not defined. Maybe you want one of the following:   dict   Edit [~/SaturnSample/src/SaturnSample/SaturnSample.fsproj]
    ~/SaturnSample/src/SaturnSample/Books/BooksViews.fs(67,7): error FS0039: The value or constructor 'div' is not defined. Maybe you want one of the following:   dict   Edit [~/SaturnSample/src/SaturnSample/SaturnSample.fsproj]
    ~/SaturnSample/src/SaturnSample/Books/BooksViews.fs(81,7): error FS0039: The value or constructor 'div' is not defined. Maybe you want one of the following:   dict   Edit [~/SaturnSample/src/SaturnSample/SaturnSample.fsproj]
    ~/SaturnSample/src/SaturnSample/Books/BooksViews.fs(91,7): error FS0039: The value or constructor 'div' is not defined. Maybe you want one of the following:   dict   Edit [~/SaturnSample/src/SaturnSample/SaturnSample.fsproj]
    ~/SaturnSample/src/SaturnSample/Books/BooksViews.fs(102,18): error FS0039: The value or constructor 'section' is not defined. Maybe you want one of the following:   Action [~/SaturnSample/src/SaturnSample/SaturnSample.fsproj]
    ~/SaturnSample/src/SaturnSample/Books/BooksRepository.fs(6,27): error FS0039: The namespace 'ContextInsensitive' is not defined. [~/SaturnSample/src/SaturnSample/SaturnSample.fsproj]
    ~/SaturnSample/src/SaturnSample/Books/BooksController.fs(4,27): error FS0039: The namespace 'ContextInsensitive' is not defined. [~/SaturnSample/src/SaturnSample/SaturnSample.fsproj]

The build failed. Fix the build errors and run again.

[scorelocity]

Yes, I'm getting the same errors when using dotnet run.

@scorelocity try doing this:

1. Update the BooksView.fs file. Switch open Giraffe.GiraffeViewEngine for open Giraffe.ViewEngine.
2. Update the Books.Repository.fs. Delete the open FSharp.Control.Tasks.ContextInsensitive.
3. Update the Books.Controller.fs. Delete the open FSharp.Control.Tasks.ContextInsensitive.

After those changes, try the dotnet run again.

[scorelocity]

Yes, that seemed to work. Since this workaround didn't match any docs or README, I wonder if this should be an issue in the Saturn.Template project (I opened it here because I did not know what the problem was). It's also not clear if Saturn is intentionally moving away from Fake.

Anyways, @vgajo , thank you for your help.

I created a PR to fix the template in Saturn.Cli repository, so we don't need to manually delete and switch some instructions.

We need to work later in the docs.

Please keep this issue open, while we don't have a PR to fix it (you can create it if you want).

[64J0]

I created this PR ^ to update the how-to-start guide. You can find more details reading its description.

[precisemath]

I created this PR: #364 as a part of this discussion. It changes GiraffeViewEngine to Giraffe.ViewEngine.

[mrakgr]

I am having issues opening the template project as well. I got it to run, but am wondering why Ionide can't open the project to give me type inference. Right now I am trying to open it in Visual Studio, and I see that it is complaining that Saturn_sample.fsproj is not there. I am looking in the directory and see that it is named Saturn-sample.fsproj.

[mrakgr]

I've edited the solution file by hand to fix this. I wonder if there is a way to delete and regenerate the solution automatically?