haskell-ci - CI generator for multiple GHC versions
At the moment haskell-ci
support GitHub Actions workflow generation.
There is also legacy Travis-CI configuration generator, which is unmaintained.
haskell-ci
relies on hvr-ppa
or ghcup
to install GHC
and cabal-install
.
-
Step 1: Clone and install this project in/from any directory
$ git clone https://github.com/haskell-CI/haskell-ci.git $ cd haskell-ci $ cabal install haskell-ci:exe:haskell-ci
or
cabal install haskell-ci
-
Step 2: Change directories to your project:
$ cd path/to/your-project
-
Step 3: Edit your project's
*.cabal
file to add atested-with
line, such as this one:$ cat your-project.cabal ... tested-with: GHC ==9.6.3 || ==9.4.8 || ==9.2.8 ...
Add as many or as few GHC versions to test as you want.
-
Step 4: Generate a workflow file for your project:
$ # You run the following command from your project's directory, even $ # though it references the script from the `haskell-ci` project $ haskell-ci github your-project.cabal
Note: If you have multiple local Cabal projects that you wish to build together using a
cabal.project
file, pass that file to haskell-ci instead:$ haskell-ci github cabal.project
The
haskell-ci
tool looks at theTested-With
line in your*.cabal
files and generates a configuration that tests each compiler version you listed in parallel. -
Step 5: Create a pull request with your new CI configuration.
... or push directly to your main branch if you feel lucky.
Sometimes you may need to regenerate CI script, for example, when adding new compiler version to
tested-with
. You may simply runhaskell-ci regenerate
.