Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/prikhi/AcornAccounting

A Django-based Accounting System for Egalitarian Communities
https://github.com/prikhi/AcornAccounting

accounting community django egalitarian python

Last synced: 24 days ago
JSON representation

A Django-based Accounting System for Egalitarian Communities

Lists

README

        

=================
Acorn Accounting
=================

.. ATTENTION::
This project is no longer actively used or maintained. Future work is being
done on a `new project that integrates with QuickBooks Desktop
`_.

Acorn Accounting is an Open Source Double Entry Accounting System written using
Python and Django.

Acorn Accounting is targeted towards egalitarian communities with needs such
as paying stipends, entering town trips and tracking membership.

.. image:: https://travis-ci.org/prikhi/AcornAccounting.svg?branch=develop
:target: https://travis-ci.org/prikhi/AcornAccounting
:alt: Test Status

.. image:: https://coveralls.io/repos/prikhi/AcornAccounting/badge.svg?branch=develop
:target: https://coveralls.io/r/prikhi/AcornAccounting?branch=develop
:alt: Code Coverage

.. image:: https://readthedocs.org/projects/acornaccounting/badge/?version=develop
:target: http://acornaccounting.readthedocs.org/en/develop/?badge=develop
:alt: Documentation Status

Quickstart
===========

Install virtualenv::

$ pip install virtualenv virtualenvwrapper

Configure virtualenvwrapper::

$ export WORKON_HOME=~/.virtualenvs
$ mkdir -p $WORKON_HOME
$ source /usr/bin/virtualenvwrapper.sh # Or add this to your .bashrc

Create a new virtual environment::

$ mkvirtualenv AcornAccounting
$ workon AcornAccounting

Install the prerequisites::

$ pip install --no-binary django -r requirements/local.txt

Specify some environmental variables::

$ export DJANGO_SECRET_KEY="A Random 50 Character String"
$ export DB_NAME=""
$ export DB_USER=""

Create all necessary tables::

$ python manage.py syncdb --settings=accounting.settings.local
$ python manage.py migrate --settings=accounting.settings.local

Run the development server::

$ cd acornaccounting
$ python manage.py runserver --settings=accounting.settings.local

You can omit the ``settings`` flag by setting the ``DJANGO_SETTINGS_MODULE``
environmental variable::

$ export DJANGO_SETTINGS_MODULE=accounting.settings.local
$ python manage.py runserver

Running Tests
==============

Install the prerequisites::

$ pip install -r requirements/test.txt

Run the tests::

$ cd acornaccounting
$ py.test

To continuously run tests when source files change::

$ ptw

Building the Full Documentation
================================

Install the prerequisites::

$ pip install -r requirements/local.txt

Build the documentation::

$ cd docs
$ make html

The HTML files will be output to the ``docs/build/html`` directory.