repl-alliance

An aggregation of GHC plugins, all of which enhance REPL based development workflows by providing IDE-like functionality, with little to no overhead.

Includes

• pinned-warnings
  • View warnings for the current GHCi session on demand
  • Automatically fix redundant import warnings
• auto-split
  • Automatic case splitting
  • Enumerate all fields in record construction
• auto-import
  • Automatically add import statements based on configuration
• auto-extract
  • Extract a segment of code as a top level function declaration
• auto-export
  • Add a declaration to the module export list
• ghci-quickfix
  • Generate a file containing diagnostics produced during compilation for use with vim's quickfix system
  • This plugin is disabled by default, you must enable it by passing -fplugin-opt ReplAlliance:--quickfix or alternatively set the environment variable GHCI_QUICKFIX_ENABLED=true.

Usage

This plugin is intended to be used with GHCi or adjacent utilities such as ghcid and ghciwatch as a development tool, not as a package dependency.

Stack Projects

To use with a stack project (you may need to add ghci-quickfix to your extra-deps first):

stack repl my-project --package repl-alliance --ghci-options='-fplugin ReplAlliance'

Cabal Projects

To use with a cabal project (you may need to run cabal update first):

cabal repl my-project --build-depends repl-alliance --repl-options='-fplugin ReplAlliance'

Compatibility

All plugins included in repl-alliance aim to support the four latest major GHC releases.