Introducing Django Ledger, a powerful double entry accounting system designed for financially driven applications using the Django Web Framework. Developed by lead developer Miguel Sanda, this system offers a simplified, high-level API, making it easier for users to navigate the complexities of accounting.
If you have prior experience with Django, you'll find this software even more effective. And, for those interested in contributing, consider joining our new discord channel for further collaboration and discussions.
Access the latest documentation and QuickStart guide here. Also, you may download the QuickStart Jupyter Notebook here.
Feel free to initiate an Issue describing your new feature request.
Finance and Accounting is a complicated subject. Django Ledger stands out from other Django projects due to its focus on providing a developer-friendly accounting engine and a reliable, extensible API for financially driven applications. The project requires expertise in Python, Django programming, finance, and accounting. In essence, the project is seeking assistance from individuals with the specific skill set needed to contribute effectively.
The project is actively seeking contributors with financial and/or accounting experience. Prior accounting experience is a big plus for potential contributors. If you have the relevant experience and want to contribute, feel free to reach out to me or submit your pull request.
You can find the contribution guidelines at the specified link. The project welcomes anyone interested in making a contribution.
Django Ledger is a Django application. If you haven't, you need working knowledge of Django and a working Django project before you can use Django Ledger. A good place to start is here.
Make sure you refer to the django version you are using.
The easiest way to start is to use the zero-config Django Ledger starter template. See details here. Otherwise, you may create your project from scratch.
To create a new Django Ledger project:
Make sure you have the latest version of python here (recommended).
Install Django:
pip install django
pip install pipenv
django-admin startproject django_ledger_project && cd django_ledger_project
pipenv install django
pipenv install django-ledger[graphql,pdf]
pipenv shell
INSTALLED_APPS = [
...,
'django_ledger',
...,
]
python manage.py migrate
python manage.py createsuperuser
from django.urls import include, path
urlpatterns = [
...,
path('ledger/', include('django_ledger.urls', namespace='django_ledger')),
...,
]
python manage.py runserver
Django Ledger comes with a basic development environment already configured under __dev_env/__ folder not to be used for production environments. If you want to contribute to the project perform the following steps:
git clone https://github.com/arrobalytics/django-ledger.git && cd django-ledger
pip install -U pipenv
pipenv install
If using a specific version of Python you may specify the path.
pipenv install --python PATH_TO_INTERPRETER
pipenv shell
python manage.py migrate
python manage.py createsuperuser
python manage.py runserver
Navigate to your projects directory.
Give executable permissions to entrypoint.sh
sudo chmod +x entrypoint.sh
Add host '0.0.0.0' into ALLOWED_HOSTS in settings.py.
Build the image and run the container.
docker compose up --build
docker ps
Select container id of running container and execute following command
docker exec -it containerId /bin/sh
python manage.py createsuperuser
After setting up your development environment you may run tests.
python manage.py test django_ledger