# Build Systems à la Carte

[![Hackage version](https://img.shields.io/hackage/v/build.svg?label=Hackage)](https://hackage.haskell.org/package/build) [![Build status](https://img.shields.io/github/actions/workflow/status/snowleopard/build/ci.yml?branch=main)](https://github.com/snowleopard/build/actions)

This project provides an executable framework for developing and comparing build systems, viewing them as
related points in landscape rather than as isolated phenomena. The code derives from the ICFP 2018 paper
["Build Systems à la Carte"](https://dl.acm.org/citation.cfm?id=3236774)
([PDF](https://dl.acm.org/ft_gateway.cfm?id=3236774)).

## Getting Started

You may be interested to:

* Run `stack test` to execute all the provided build systems on a very simple example.
* Look at the [HTML documentation](https://hackage.haskell.org/package/build) of all modules for the last release,
  or generate it yourself using `stack haddock`.
* Read the code, particularly [Build.System](src/Build/System.hs), which is the concrete implementation of
  all build systems.

## Related Material

* Blog post [on the motivation behind the project](https://blogs.ncl.ac.uk/andreymokhov/cloud-and-dynamic-builds/).
* Blog post [on the task abstraction](https://blogs.ncl.ac.uk/andreymokhov/the-task-abstraction/).
* Blog post [reviewing how the paper was written](https://neilmitchell.blogspot.com/2018/07/inside-paper-build-systems-la-carte.html).
* Talk [by Neil on this paper and Shake](https://ndmitchell.com/#shake_18_may_2018).
* A talk on build systems
  [by Andrey](https://github.com/snowleopard/build/releases/download/icfp-final/build-systems-slides-andrey.pdf).