Cabal comes in two parts, the cabal executable (which is in the
cabal-install package) and the Cabal library (which is in the Cabal
package).
These instructions copy the cabal executable to $HOME/bin which is
assumed to be on your $PATH. If you have an alternative location where
you prefer to put executables, then use that instead.
$ VER=1.24.0.2 # or 2.0.0.1 if using 8.2.2 or higher.
$ wget https://hackage.haskell.org/package/cabal-install-${VER}/cabal-install-${VER}.tar.gz
$ tar xf cabal-install-${VER}.tar.gz
$ cd cabal-install-${VER}
$ EXTRA_CONFIGURE_OPTS="" ./bootstrap.sh --sandbox --no-doc
# $HOME/bin is assumed to exist and be on your $PATH
$ cp .cabal-sandbox/bin/cabal $HOME/bin/cabal
If you followed the advanced instructions here for installing multiple GHC versions, then you will need to repeat this step for each of the GHC versions that you have installed.
In order for custom Setup.hs files to operate correctly, cabal-install
needs the Cabal library it was built against available in the user (or
the global) package database.
If you installed a different cabal-install than the one above, or you
didn’t use the bootstrap.sh script, then make sure you run cabal
--version to double check the version of the Cabal library that you
need.
# double-check that we're installing the right version of the Cabal library
$ cabal --version
cabal-install version 1.24.0.2
using version 1.24.2.0 of the Cabal library
# make sure we're not in a sandbox, jumping to $HOME is a safe bet
$ cd
$ cabal install Cabal-1.24.2.0
If you need to install a newer Cabal library, you don’t need to remove the old one, they should live side-by-side happily.
If you want to make sure that nothing messes with your user package database, it can be helpful to set it to read-only. Just remember to make it writable if you ever need to install a newer Cabal library.
$ chmod -R -w $HOME/.ghc/x86_64-darwin-<GHC_VERSION>/package.conf.d
To make it writable again:
$ chmod -R +w $HOME/.ghc/x86_64-darwin-<GHC_VERSION>/package.conf.d
When running ./mafia quick or ./mafia watch, you may see something like the following from a fresh checkout:
Arbitrary.hs:55:11:
No instance for (Arbitrary time-1.4.2:Data.Time.Clock.UTC.UTCTime)
Run ghc-pkg list:
/usr/local/lib/ghc-7.8.4/package.conf.d
Cabal-1.18.1.5
...
/Users/<USER>/.ghc/x86_64-darwin-7.8.4/package.conf.d
Cabal-1.22.3.0
...
If there are extra packages in the .ghc packages directory, other than Cabal-*, then unregister them:
$ ghc-pkg list --user | grep -v 'package.conf.d' | grep -v 'Cabal-' | xargs ghc-pkg unregister