A lexical analyser generator for Haskell
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc Add docbook xml path as currently found in Arch linux. This should al… Aug 28, 2017
examples examples: populate .gitignore and sync Makeilfe with tests/ Oct 16, 2016
gen-alex-sdist Make bootstrapping even easier by avoiding custom Setup.hs Feb 10, 2018
src remove quickcheck properties which are not exported/used anywhere Mar 25, 2018
templates Fix shadowing warnings Sep 5, 2017
tests Try to fix "runghc ./Setup test" May 24, 2018
.gitignore Don't need to ignore tempaltes in the root dir any more May 24, 2018
.mailmap .mailmap: new file to help GIT deal with incomplete/broken author info May 30, 2012
.travis.yml Improve Makefile Mar 29, 2018
CHANGELOG.md 3.2.4 Mar 29, 2018
LICENSE copyright date updates Aug 4, 2011
Makefile Improve Makefile Mar 29, 2018
NOTE.txt UTF-8 support from Jean-Philippe Bernardy and Alan Zimmerman. Jul 11, 2011
README.md Improve Makefile Mar 29, 2018
Setup.hs Make bootstrapping even easier by avoiding custom Setup.hs Feb 10, 2018
TODO TODO: add a couple of sub-items, fix a typo May 30, 2012
alex.cabal 3.2.4 Mar 29, 2018
alex.spec some 2.2 updates Oct 23, 2007
build-windows-dist.sh add script for building the Windows dist Jan 9, 2007
cabal.project Make bootstrapping even easier by avoiding custom Setup.hs Feb 10, 2018
make-sdist.sh special sdist steps aren't necessary now Oct 13, 2008
stack.yaml add stack file Sep 28, 2017
test.hs Fix compiler warnings in generated code Jul 31, 2016


Alex: A Lexical Analyser Generator

Build Status

Alex is a Lex-like tool for generating Haskell scanners. For complete documentation, see the doc directory.

Alex version 2.0 has changed fairly considerably since version 1.x, and the syntax is almost completely different. For a detailed list of changes, see the release notes in the documentation.

Alex is now covered by a BSD-Style licence; see the licence file in the 'doc' directory for details.

The sources are in the 'src' directory and the documentation in the 'doc' directory; various examples are in the 'examples' subdirectory.

The source code in the 'src' and 'examples' directories is intended for a Haskell 98 compiler with hierarchical modules. It should work with GHC >= 5.04.

Build Instructions

If you just want to use Alex, you can download or install (via cabal install alex) an Alex release from Hackage; also note that distributions such as the Haskell Platform and other package manager-based distributions provide packages for Alex. Moreover, recent versions of cabal will automatically install the required version of alex based on build-tools/build-tool-depends declarations.

Read on if you want to build Alex directly from Git.

Alex is built using GHC & Cabal; so first install GHC and cabal-install-2.0 (or later).

Since Alex itself is implemented in terms of an Alex scanner, bootstrapping Alex is a bit tricky:

You need to have the build-tools alex and happy manually installed; either via your system package manager distribution, the Haskell Platform, or e.g. via (run this outside the Git repository!):

$ cabal install alex happy

which installs them into ${HOME}/.cabal/bin by default (make sure they're in your $PATH for the next steps!).

Variant A

First you need to generate the pre-processed templates via

$ cabal new-run gen-alex-sdist

(otherwise cabal install will complain about "data/AlexTemplate: copyFile: does not exist (No such file or directory)")

And then you can install alex simply by invoking

$ cabal install

from inside the Git folder.

Variant B

Alternatively, you can use the Makefile which automates the steps of producing a self-contained pre-bootstrapped source distribution with pre-generated lexer/scanners (and which also performs the cabal new-run gen-alex-sdist pre-preprocessing step):

$ make sdist
$ cabal install dist/alex-*.tar.gz

For convenience, there's also a make sdist-test target which builds the source source tarball and runs the test-suite from within the source dist.

Contributing & Reporting Issues

Please report any bugs or comments at https://github.com/simonmar/alex/issues

Share and enjoy,

Chris Dornan: cdornan@arm.com

Isaac Jones: ijones@syntaxpolice.org

Simon Marlow: simonmar@microsoft.com