# th-workshop

**Repository Path**: mirrors_stevemao/th-workshop

## Basic Information

- **Project Name**: th-workshop
- **Description**: Template Haskell Workshop
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-26
- **Last Updated**: 2025-09-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Template Haskell Workshop

This is the repository for a Template Haskell workshop. See [the proposal](doc/proposal.md) for the original
inspiration.

## Setup

[Markdown Unlit](https://hackage.haskell.org/package/markdown-unlit) is a GHC plugin for rendering Markdown as Literate
Haskell. Exercises in this workshop are written in Markdown, so we need to install the package.

```bash
stack install markdown-unlit
```

The `src` folder contains "solved" functions which will be necessary for completing the exercises.

```bash
stack build --fast # compile the solved functions
```

Also recommend keeping a tab open to the docs for Template Haskell:
https://www.stackage.org/lts-14.22/package/template-haskell-2.14.0.0

## Exercises

The first two exercises are exploratory in GHCi to get a feel of how Template Haskell works. The next exercises go into
more detail about how to define and test generated code.

* [Exercise01](exercises/Exercise01.md) explores "hello world" and TH nuances
* [Exercise02](exercises/Exercise02.md) helps create helper functions for inspection of a type's constructors at compile
  time.
* [Exercise03](exercises/Exercise03.md) uses the helper functions to generate instances for an enumeration.
* [Exercise04](exercises/Exercise04.md) demonstrates how to test the generated instances in Hspec.

Start in the `exercises` folder and fill in the `TODO` parts of each exercise.