ats-pkg: A build tool for ATS

This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.

[maintain] [Publish]

A collection of scripts to simplify building ATS projects.

[Skip to Readme]


Change log
Dependencies ansi-wl-pprint, ats-pkg, base (>=4.10 && <5), binary, bytestring, bzlib, Cabal (>=, cli-setup, composition-prelude (>=, containers (>=0.6), dependency (>=, dhall (>=1.27.0), directory (>=, file-embed (>=0.0.9), filemanip, filepath, http-client, http-client-tls, language-ats (>=, lzma, microlens, mtl, optparse-applicative, parallel-io, process, shake (>=0.17), shake-ats (>=, shake-c (>=, shake-ext (>=, tar, temporary, text, unix, unix-compat, zip-archive, zlib [details]
License BSD-3-Clause
Copyright Copyright: (c) 2018-2019 Vanessa McHale
Author Vanessa McHale
Category Development, ATS
Bug tracker
Source repo head: git clone
Uploaded by vmchale at 2019-11-07T17:18:31Z



Manual Flags


Enable `-Werror`


Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info


Maintainer's Corner

For package maintainers and hackage trustees

Readme for ats-pkg-

[back to package description]


Build Status Windows build status Hackage CI Hackage Dependencies of latest version on Hackage

This is a build system for ATS written in Haskell and configured with Dhall. It is not fully working, but the configuration format is now stable.

atspkg works quite well as a build system, and acceptably well as a package manager.

Features & Non-Features

Things that atspkg will do for you:

Things that atspkg will not do for you:


As an example, the following will install polyglot:

atspkg remote

As you can see, this greatly simplifies distribution and testing of programs written in ATS.



The easiest way to install is via a script, viz.

curl -sSl | sh -s

Thereafter, you can run

atspkg upgrade

to upgrade to the latest release.


If that doesn't work, you can download Cabal and GHC and install with

cabal update
cabal new-install ats-pkg --symlink-bindir ~/.local/bin --happy-options='-gcsa' --alex-options='-g'

Note that $HOME/.local/bin will need to be on your PATH.

Quick Start

Install pi with

curl -LSfs | sh -s -- --git vmchale/project-init

Initialize an ATS project with

pi new ats project

Then build & run it:

cd project
atspkg run


You can find several examples with explanation here.

Global Configuration

atspkg is configured via a file in $HOME/.config/atspkg/config.dhall. You can set a custom package set as follows:

let version = "master"

let cfg =
  { defaultPkgs = "${version}/ats-pkg/pkgs/pkg-set.dhall"
  , path = ([] : Optional Text)
  , githubUsername = "vmchale"
  , filterErrors = False
in cfg

I recommend setting version to whichever branch your version of atspkg was built from.