cabal repl コマンドについて

cabal repl コマンドは

• ghci, ghc --interactive
• stack repl, stack ghci

などと同じように cabal で REPL 環境を実行するためのコマンドです。

cabal プロジェクト内で実行する場合と、cabal プロジェクト外で実行する場合で挙動が少し異なります。

$ cabal -V
cabal-install version 3.2.0.0
compiled using version 3.2.0.0 of the Cabal library

cabal install コマンドについて

• stack install と全く同じ動作をする cabal コマンドは cabal install all:exes です。

今回利用した cabal と stack のバージョンは以下の通りです。

$ cabal -V
cabal-install version 3.0.0.0
compiled using version 3.0.0.0 of the Cabal library 

$ stack --version
Version 2.1.3, Git revision 636e3a759d51127df2b62f90772def126cdf6d1f (7735 commits) x86_64 hpack-0.31.2

この記事では stack install コマンドと cabal install コマンドの挙動の違いなどについて調査した結果等をまとめています。

stack で管理されたプロジェクトを cabal でビルドするために

Haskell のビルドツールといえば cabal と stack です。ちょっと前までは cabal より stack の方が流行っていたのですが、最近は開発も落ち着いているようであまり動きがありません。それよりも cabal の nix-style local build が非常に使いやすく、近頃では stack から cabal に移行しているプロジェクトも多くあります。

stack を使っていて改善したら良いなぁと思う部分としては、新しい GHC やライブラリをすぐに使おうと思っても LTS や nightly に入っていないため使えなかったり、Backpack が未だに使えなかったりするところでしょうか。

ただ、ビルドの再現性という点においては stack の方が優秀だと思っているので今は両方使っています。(index-state と freeze ファイルを組み合わせれば cabal でも再現性が保証されそうな気がしますが、どうなんだろう)

今回は stack で管理されたプロジェクトを確実に cabal でビルドするための方法についてまとめました。

• Why Not Both? に載ってた Stackage の使い方の紹介でもあります。

cabal の build-tool-depends フィールド

cabal の build-tool-depends というフィールドが便利だったので紹介します。

テストを書くときに hspec-discover や tasty-discover などを使う場合、このフィールドを設定しておくことで依存している実行ファイルを自動的にダウンロードして使ってくれます。

$ cabal --version
cabal-install version 3.0.0.0
compiled using version 3.0.0.0 of the Cabal library 

Memo - unexpected At most 9 numbers are allowed per version number part

GHC-8.8 への移行中に GitHub Actions で以下のようなエラーが発生しました。

proj/dist-newstyle/src/barbies-6f24224e2c384e2f/barbies.cabal:2:31: error:
unexpected At most 9 numbers are allowed per version number part

    1 | name:           barbies
    2 | version:        1.999999999999
      |                               ^

##[error]Process completed with exit code 1.

初めて見るエラーだったのでメモとして残しておきます。

cabal-fmt の紹介

はじめに

cabal-fmt でできること。

• cabal ファイルの整形
• フォルダを指定して自動でモジュールを expand できる
• 以下のフィールドをアルファベット順で自動的に並べ替え&重複を削除
  • exposed-modules
  • other-modules
  • default-extensions
  • other-extensions
  • build-depends

λ cabal-fmt --version
0.1.1.1

λ cabal -V
cabal-install version 3.0.0.0
compiled using version 3.0.0.0 of the Cabal library

# 使い方
λ cabal-fmt <proj>.cabal -i

作者の記事: ANN: cabal-fmt

cabal build で package.yaml を使う

はじめに

最近少しずつ cabal を使うようになりました。

そのため、stack と cabal のどちらを使ってもビルドできるようにプロジェクトを修正していたのですが、cabal ファイルの取り扱いが難しかったのでメモ程度に残しておきます。

方針としては cabal コマンドの実行時にフックを仕掛けて hpack を使って package.yaml から cabal ファイルを生成しようという感じです。

$ cabal --numeric-version
2.4.1.0