The packunused package
This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.
This simple CLI tool allows to find out which of the packages listed as build-depends in a Cabal package description file are redundant.
packunused works by taking advantage of GHC's -ddump-minimal-imports feature which creates .import files for each compiled module containing a minimal set of explicit import declarations. These .import files together with Cabal's generated package configuration meta-data is analyzed by packunused to detect potentially redundant package dependencies.
In order to use packunused you have to configure the package as usual. See the example session below:
cabal clean rm *.imports cabal configure -O0 --disable-library-profiling cabal build --ghc-option=-ddump-minimal-imports packunused
The -O0 --disable-library-profiling options are just to speed up compilation. In some cases you might want to pass additional options to the configure step, such as --enable-benchmark or --enable-tests.
When run, packunused prints a report to standard output listing its findings for each component built. The following is an example for the packunused package itself, with a redundant dependency added for demonstration on purpose:
detected package components ~~~~~~~~~~~~~~~~~~~~~~~~~~~ - executable(s): packunused (component names suffixed with '*' are not configured to be built) executable(packunused) ~~~~~~~~~~~~~~~~~~~~~~ The following package depencencies seem redundant: - criterion-0.6.2.0-9dd4d764629a47662168743b2dfda9bc
|Versions||0.1.0.0, 0.1.0.1, 0.1.0.1, 0.1.1.0, 0.1.1.1, 0.1.1.2, 0.1.1.3, 0.1.1.4|
|Change log||None available|
|Dependencies||base (>=4.5 && <4.7), Cabal (>=1.14 && <1.17), cmdargs (==0.10.*), directory (>=1.1 && <1.3), filepath (==1.3.*), haskell-src-exts (>=1.13 && <1.15) [details]|
|Author||Herbert Valerio Riedel <firstname.lastname@example.org>|
|Maintainer||Herbert Valerio Riedel <email@example.com>|
|Source repository||head: git clone https://github.com/hvr/packunused.git|
|Uploaded||Sun Oct 13 12:48:30 UTC 2013 by HerbertValerioRiedel|
- packunused-0.1.0.1.tar.gz [browse] (Cabal source package)
- Package description (included in the package)
For package maintainers and hackage trustees