A double-entry bookkeeping system developed for use at SwingTix.ca.
Python Makefile
Switch branches/tags
Latest commit 2035099 Feb 5, 2016 @g-- g-- bump to 0.0.6
Permalink
Failed to load latest commit information.
swingtix bump to 0.0.6 Feb 5, 2016
tests
.gitignore
CHANGES.rst
DEVELOP.rst
INSTALL.rst 0.0.1 release: third-party and project support Dec 19, 2013
LICENSE 0.0.1 release: third-party and project support Dec 19, 2013
MANIFEST.in Removing files from the manifest that don't exist Sep 21, 2014
Makefile Version bumping makefile Feb 5, 2016
README.rst
manage.py 0.0.1 release: third-party and project support Dec 19, 2013
setup.py Add future to install_requires Sep 2, 2015

README.rst

SwingTix Bookkeeper

A double-entry bookkeeping system originally developed for SwingTix.

Hello, World

You'll need a django project. If you don't have one handy, you can make an empty one following the first steps of the django tutorial. Afterwards, edit <yourproject>/settings.py to add "swingtix.bookkeeper" to INSTALLED_APPS and run:

$ python manage.py syncdb

Then you're ready to start exploring using the shell:

$ python manage.py shell

First, let's create a couple of accounts:

>>> from swingtix.bookkeeper.models import BookSet, Account

>>> book = BookSet(description="my book")
>>> book.save()

>>> revenue  = Account(bookset=book, name="revenue", positive_credit=True)
>>> revenue.save()
>>> bank     = Account(bookset=book, name="bank",    positive_credit=False)
>>> bank.save()
>>> expense  = Account(bookset=book, name="expense", positive_credit=False)
>>> expense.save()

Then you can use them:

>>> book = BookSet.objects.get(description="my book")
>>> revenue = book.get_account("revenue")
>>> bank    = book.get_account("bank")
>>> expense = book.get_account("expense")

#Someone pays you can advance.  Yay!
>>> bank.debit(120.00, revenue, "our first sale")
(<AccountEntry: 120 >, <AccountEntry: -120 >)

#but now you have to do some work.  The local coffee shop has free wifi..
>>> bank.credit(2.20, expense, "coffee")
(<AccountEntry: -2 >, <AccountEntry: 2 >)

>>> bank.balance()
Decimal('117.80')
>>> expense.balance()
Decimal('2.20')
>>> revenue.balance()
Decimal('120.00')