penny: Extensible double-entry accounting system

[ bsd3, console, finance, library ] [ Propose Tags ]

Penny is a double-entry accounting system. It is inspired by, but incompatible with, John Wiegley's Ledger, which is available at http://ledger-cli.org/. Installing this package with cabal install will install the executable program and the necessary libraries.

Non-features / disadvantages:

Unfortunately running "cabal install" will not install the documentation, so you will need to find the downloaded archive (usually in "$HOME.cabalpackageshackage.haskell.orgpenny") and unpack it to see the documentation. You will want to start by reading the README file, which will point you to additional documentation and how to install it if you wish.


[Skip to Readme]
Versions [faq] 0.24.0.0, 0.26.0.0, 0.28.0.0, 0.30.0.0, 0.30.0.2, 0.32.0.0, 0.32.0.2, 0.32.0.4, 0.32.0.6, 0.32.0.8, 0.32.0.10
Dependencies action-permutations (==0.0.0.0), anonymous-sums (==0.2.*), base (==4.6.*), bytestring (>=0.10.0.2), cereal (>=0.3.5.2), containers (>=0.4.2.1), either (>=3.4.1), matchers (==0.14.*), multiarg (==0.24.*), ofx (==0.4.*), old-locale (>=1.0.0.5), parsec (>=3.1.3), penny, prednote (==0.18.*), pretty-show (>=1.5), QuickCheck (>=2.5), rainbow (==0.6.*), random (>=1.0.1.1), random-shuffle (==0.0.4), semigroups (>=0.9.2), split (>=0.2.2), text (>=0.11.3.1), time (>=1.4.0.1), transformers (>=0.3.0.0) [details]
License BSD-3-Clause
Copyright 2012-2014 Omari Norman.
Author Omari Norman
Maintainer omari@smileystation.com
Category Console, Finance
Home page http://www.github.com/massysett/penny
Bug tracker omari@smileystation.com
Source repo head: git clone git://github.com/massysett/penny.git
Uploaded by OmariNorman at Fri Feb 14 02:23:55 UTC 2014
Distributions NixOS:0.32.0.10
Executables penny-reconcile, penny-reprint, penny-diff, penny-selloff, penny, penny-gibberish
Downloads 4388 total (8 in the last 30 days)
Rating (no votes yet) [estimated by rule of succession]
Your Rating
  • λ
  • λ
  • λ
Status Hackage Matrix CI
Docs available [build log]
Successful builds reported [all 1 reports]

Modules

[Index]

Flags

NameDescriptionDefaultType
build-gibberish

Build the penny-gibberish executable

DisabledAutomatic
build-penny

Build the penny executable

EnabledAutomatic
build-selloff

Build the penny-selloff executable

EnabledAutomatic
build-diff

Build the penny-diff executable

EnabledAutomatic
build-reprint

Build the penny-reprint executable

EnabledAutomatic
build-reconcile

Build the penny-reconcile executable

EnabledAutomatic
debug

turns on some debugging options

DisabledAutomatic
test

enables QuickCheck tests

DisabledAutomatic
incabal

enables imports that only Cabal makes available

EnabledAutomatic

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

Downloads

Maintainer's Corner

For package maintainers and hackage trustees


Readme for penny-0.32.0.0

[back to package description]

Welcome to Penny, double-entry accounting.

Penny's web pages are at:

http://massysett.github.com/penny

http://hackage.haskell.org/package/penny

http://github.com/massysett/penny

Versions that contain at least one odd number are development versions. They are not posted to Hackage. I try to keep the master branch in compilable shape. However, development versions may not pass all tests, and in particular they may have out of date or incomplete documentation.

Releases consist of code of reasonable quality. All of the groups in their release numbers are even.

Penny is licensed under the MIT license, see the LICENSE file.

To install the latest release, "cabal install penny" should work. To also build test executables, run "cabal install -ftest penny". That will give you two additional executables: penny-test, which when run will test a bunch of QuickCheck properties, and penny-gibberish, which prints a random, but valid, ledger file.

To install the manual pages and the documentation, 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.

Though I do use this program to maintain all my financial records, it is still relatively new and no one but me has tested it. Use at your own risk.

Dependencies

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:

  • pcre - http://www.pcre.org/ - on Debian GNU/Linux systems this package is called libpcre3-dev

  • curses - on GNU systems this is known as ncurses, http://www.gnu.org/software/ncurses/ Perhaps other, non-GNU curses implementations will work as well; I do not know. On Debian GNU/Linux systems, install libncurses5-dev.

Build Status