Cabal

This Cabal Git repository contains the following main packages:

• Cabal: the Cabal library package (license)
• Cabal-syntax: the .cabal file format library (license)
• cabal-install: the package containing the cabal tool (license)
• cabal-install-solver: the package containing the solver component of the cabal tool (license)

The canonical upstream repository is located at https://github.com/haskell/cabal.

Ways to get the cabal-install binary

1. GHCup (preferred): get GHCup using the directions on its website and run:

   ghcup install --set cabal latest
   

2. Download from official website: the cabal-install binary download for your platform should contain the cabal executable.

Getting unreleased versions of cabal-install: gives you a chance to try out yet-unreleased features. Currently, we only provide binaries for x86_64 platforms.

1. GitHub preview release built from the tip of the master branch: download from GitHub or use this GHCup command to install:

   ghcup install cabal -u https://github.com/haskell/cabal/releases/download/cabal-head/cabal-head-Linux-x86_64.tar.gz head
   

   Replace "Linux" with "Windows" or "macOS" as appropriate.

2. Even more cutting-edge binaries built from pull requests are always available from the Validate worklow page on GitHub, at the very bottom of the page.

Ways to build cabal-install for everyday use

1. With cabal-install: if you have a pre-existing version of cabal-install, run:

   cabal install cabal-install
   

   to get the latest version of cabal-install. (You may want to cabal update first.)

2. From Git: again with a pre-existing version of cabal-install, you can install the latest version from the Git repository. Clone the Git repository, move to its root, and run:

   cabal install --project-file=cabal.project.release cabal-install
   

3. Bootstrapping: if you don't have a pre-existing version of cabal-install, look into the bootstrap directory.

Build for hacking and contributing to cabal

Refer to CONTRIBUTING.md.