https://github.com/ChrisMarinos/FSharpKoans
A simple, fun, and interactive way to learn the F# language through testing.
https://github.com/ChrisMarinos/FSharpKoans
Last synced: 5 months ago
JSON representation
A simple, fun, and interactive way to learn the F# language through testing.
- Host: GitHub
- URL: https://github.com/ChrisMarinos/FSharpKoans
- Owner: ChrisMarinos
- License: other
- Created: 2011-03-29T16:39:37.000Z (about 14 years ago)
- Default Branch: fsharp
- Last Pushed: 2024-02-22T15:38:45.000Z (about 1 year ago)
- Last Synced: 2024-08-04T01:19:25.245Z (9 months ago)
- Language: F#
- Homepage:
- Size: 482 KB
- Stars: 1,281
- Watchers: 61
- Forks: 671
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: License.txt
Awesome Lists containing this project
- awesome-by-example - FSharpKoans: A simple, fun, and interactive way to learn the F# language through testing
README
[](https://gitpod.io/#https://github.com/ChrisMarinos/FSharpKoans)
# Functional Koans - F# #
Inspired by EdgeCase's fantastic [Ruby koans](http://github.com/edgecase/ruby_koans),
the goal of the F# koans is to teach you F# through testing.
When you first run the koans, you'll be presented with a runtime error and a
stack trace indicating where the error occurred. Your goal is to make the
error go away. As you fix each error, you should learn something about
the F# language and functional programming in general.
Your journey towards F# enlightenment starts in the AboutAsserts.fs file. These
koans will be very simple, so don't overthink them! As you progress through
more koans, more and more F# syntax will be introduced which will allow
you to solve more complicated problems and use more advanced techniques.
### Running with GitHub Codespaces
[GitHub Codespaces](https://github.com/features/codespaces) is a free platform to run F# Koans completely in your browser, no install or setup required! Just go
to https://github.com/ChrisMarinos/FSharpKoans/codespaces and click "New CodeSpace"
### Running with Docker
To launch in watch mode using docker run the following command;
`$ ./docker.sh`
### Prerequisites
The F# Koans needs [.NET 6.0](https://dotnet.microsoft.com/download) to be built and run. Make sure that you have installed it before building the project. This is the long-term support release of .NET that many modern F# and .NET applications use.
Additionally, the project provides [Visual Studio Code](https://code.visualstudio.com/) configuration for running.
To be able to run F# projects in Visual Studio Code, the
[Ionide plugin](https://marketplace.visualstudio.com/items?itemName=Ionide.Ionide-fsharp) should be also installed.
### Running the Koans from the command line (.Net Core)
1. To build the Koans, run `dotnet build` command in the project root.
2. To run the Koans, run `dotnet run --project FSharpKoans/FSharpKoans.fsproj` in the root directory or `dotnet run` in `FSharpKoans` project directory.
### Running the Koans in Visual Studio Code
1. Open the project directory in Visual Studio Code with Ionide-fsharp plugin installed
and press F5 to build and launch the Koans (some time is needed to build the project before launch).
### Running the Koans from a Devcontainer
1. Install the Remote - Containers extension in Visual Studio Code.
2. Open the directory inside a Devcontainer.
3. Open a terminal and start using the Koans.
### Using dotnet-watch
You can also use [dotnet-watch](https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/tutorials/dotnet-watch.md) to have your changes reloaded automatically.
To do so, navigate into `FSharpKoans` directory and run `dotnet watch run`. Now, after you change the project code, it will be automatically reloaded and tests rerun.