tn-fp-haskell-course

This is the home of the TPs for the functional programming course of Telecom Nancy

Containerized setup (Docker)

The fastest way to get a working environment is to use the docker image published by CI. Haskell tooling and this project’s dependencies are included; your clone of the repository is mounted at /workspaces/tn-fp-haskell-course.

vscode

In vscode (with the Dev Containers extension): open the repository root, then run Dev Containers: Reopen in Container from the command palette (Ctrl/Cmd+Shift+P). vscode reads .devcontainer/devcontainer.json, pulls the image and mounts your clone.

Without vscode

Run the image manually:

docker pull ghcr.io/smelc/tn-fp-haskell-course:latest
docker run -it --rm -v "$(pwd):/workspaces/tn-fp-haskell-course" -w /workspaces/tn-fp-haskell-course -p 8000:8000 -p 6419:6419 ghcr.io/smelc/tn-fp-haskell-course:latest bash

In both cases

The image is not refreshed automatically. When told to adopt a new version, do:

docker pull ghcr.io/smelc/tn-fp-haskell-course:latest

then, in vscode, run Dev Containers: Rebuild Container from the command palette.

From a terminal inside the container you can then run e.g.:

cabal run -v0 TP4.hs

You can run the REPL as follows:

cabal repl TP1.hs

Direct setup on your host (Dockerless)

To reproduce a working environment, from the repository root, do:

• Install the Haskell installer with ghcup: curl --proto '=https' --tlsv1.2 -sSf https://get-ghcup.haskell.org | sh This will ask questions:
  • Answer P to update your PATH automatically.
  • Answer Y to install IDE tooling (haskell-language-server).
  • Answer N to install stack, since this project uses the simpler cabal build tool
• Install the System requirements. If you are on Linux, this is something like sudo apt install build-essential curl libffi-dev etc.. (see the link for the exact list of packages to install).
• Run ghcup install ghc 9.10.3 and then ghcup set ghc 9.10.3 to set the expected compiler version.
• Run cabal build all. This will take a while as this repository depends on a number of fat libraries. Brew some coffee meanwhile.

At this point, everything should be set to work on the command line, for example try:

cabal run -v0 TP4.hs

You should get as output:

pyEval "1 + 3" returned: 4

Now you can continue with the IDE configuration:

• Install vscode and the Haskell extension.
• Launch vscode from the terminal (code . &), from this repository’s root. If vscode asks you to install the Haskell Language Server, say yes.
• Happy Haskell hacking! To experiment, hack in one of the TP*.hs files; see the first line for how to execute them.

This site is open source. Improve this page.