The penny package

[Tags: bsd3, library]

Penny is a double-entry accounting system. You keep your records in a plain-text file, and Penny gives you useful reports in your UNIX shell.

For more information, please see

[Skip to ReadMe]


Change logchangelog
Dependenciesaction-permutations (>= && <, anonymous-sums (>=, base (>= && <4.8), bytestring (>= && <0.11), cereal (>= && <0.5), containers (>= && <0.6), contravariant (>= && <0.5), either (>=3.4.1 && <4.2), matchers (>= && <0.19), multiarg (>= && <, ofx (>= && <0.5), old-locale (>= && <1.1), parsec (>=3.1.3 && <3.2), penny (==, prednote (>= && <0.23), QuickCheck (==2.6.*), rainbow (>= && <, rainbox (>= && <0.5), random (>= && <1.1), random-shuffle (==0.0.4), semigroups (>=0.9.2 && <0.14), split (>=0.2.2 && <0.3), text (>= && <1.2), time (==1.4.*), transformers (>= [details]
Copyright2012-2014 Omari Norman.
AuthorOmari Norman
CategoryConsole, Finance
Home page
Source repositoryhead: git clone git://
Executablespenny-reconcile, penny-reprint, penny-diff, penny-selloff, penny, penny-gibberish
UploadedThu Apr 17 14:38:06 UTC 2014 by OmariNorman
Downloads2072 total (26 in last 30 days)
0 []
StatusDocs available [build log]
Successful builds reported [all 1 reports]




build-gibberishBuild the penny-gibberish executableDisabledAutomatic
build-pennyBuild the penny executableEnabledAutomatic
build-selloffBuild the penny-selloff executableEnabledAutomatic
build-diffBuild the penny-diff executableEnabledAutomatic
build-reprintBuild the penny-reprint executableEnabledAutomatic
build-reconcileBuild the penny-reconcile executableEnabledAutomatic
debugturns on some debugging optionsDisabledAutomatic
testenables QuickCheck testsDisabledAutomatic
incabalenables imports that only Cabal makes availableEnabledAutomatic

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info


Maintainers' corner

For package maintainers and hackage trustees

Readme for penny-

Penny - double-entry accounting

Penny is a double-entry accounting system which is inspired by, but incompatible with, Ledger, which is available at


Penny is:



cabal install will take care of all Haskell dependencies for you; however, there are also at least two C libraries you will need to install as Penny depends on other Haskell libraries that use these C libraries. You will need to make sure you have the "development" package installed if you use many Linux distributions; a few distributors, such as Arch, Slackware, and Gentoo, generally don't ship separate "development" packages so that won't apply to you. The C libraries are:

Haskell compiler

You will need to get the Glasgow Haskell Compiler. Most Linux distributors package it, or you might be able to get it from the GHC website. Penny has been tested with GHC versions 7.4.1 and 7.6.3; any version between those two versions should also work.

Cabal tool

The Cabal tool will help you get the Haskell dependencies you need.

An easy way to get both GHC and the Cabal tool is to get the Haskell Platform. Currently, versions 2013.2.0.0 or version 2012.4.0.0 should both work.

Penny itself

To install Penny, just do:

cabal update
cabal install --enable-tests penny

I encourage you to run the tests, so the above commands will do that, but if you want to skip them, instead just do

cabal install penny


To install the manual pages and the documentation, you need to find the downloaded archive. Typically this is at $HOME/.cabal/packages/ Unpack this archive and look inside. Run

sh install-docs

It will install the manual pages to $PREFIX/share/man and the other documentation to $PREFIX/share/doc/penny. By default $PREFIX is /usr/local; you can change this by editing the install-docs file and changing the PREFIX variable.

To remove the manual pages and the documentation, run

sh install-docs remove

The first thing you will want to look at is the manual page penny-basics(7). Then you will want to examine the starter.pny file in the examples directory, which will show you how to write a ledger file. penny-suite(7) will then direct you to other documentation that may interest you.

Penny on the Web

Find Penny on Hackage at

and on Github at

and web pages are here:

(I am going to phase out the separate web pages in favor of files in the main source code tree.)

Development and bugs

If you find any bugs or if you wish to contribute, please use Github (preferred) or send email to (which works just as well as Github, but if everything else is equal for you and you would flip a coin to determine which contact method to use, then please use Github.)

Version numbers

Versions are numbered like this: A.B.C.D. All regular releases that are ready for use have only even numbers for each of A, B, C, and D. Development releases have an odd number in at least one of A, B, C, or D.

A is currently 0 and probably won't change soon.

I change B whenever I make a breaking change in the library, which is quite often; or

I change C when I add functions to the library; or

I change D when I fix bugs, add documentation, or make adjustments to the specification of which packages Penny depends on.

Dependency documentation and bugs

Since the Haskell libraries Penny depends upon can move along quickly, and because Haskell packages can weave complex dependency graphs, sometimes Penny might not build for you. There is no silver bullet solution to this; if you have build problems, please report them to me via email or Github. Also, note that there are two files in the Penny package that can help you diagnose issues:

Test status

Build Status