.. image:: https://img.shields.io/pypi/v/django-erp-framework.svg :target: https://pypi.org/project/django-erp-framework
.. image:: https://img.shields.io/pypi/pyversions/django-erp-framework.svg :target: https://pypi.org/project/django-erp-framework
.. image:: https://img.shields.io/readthedocs/django-erp-framework :target: https://django-erp-framework.readthedocs.io/
.. image:: https://img.shields.io/codecov/c/github/ra-systems/django-erp-framework :target: https://codecov.io/gh/ra-systems/django-erp-framework
A light-weight, effective, Django based framework to create various business applications, resource planing and management systems.
Offers a ready made platform where you can start to create data entry pages and attach various reports to them.
.. code-block:: console
$ pip install django-erp-framework
OR
$ pip install -e git+https://github.com/RamezIssac/django-erp-framework.git#egg=django-erp-framework@develop
Check out the getting started <https://django-erp-framework.readthedocs.io/en/latest/getting_started/index.html>
_ on Read The Docs.
You can checkout a demo application here <https://my-shop.django-erp-framework.com>
_.
Code is available on Github <https://github.com/RamezIssac/my-shop>
_.
.. image:: https://github.com/RamezIssac/django-erp-framework/blob/develop/docs/source/_static/widgets.png?raw=true :alt: Homepage :align: center
Available on Read The Docs <https://django-erp-framework.readthedocs.io/en/latest/>
_
Please Proceed to the tutorial Create a sales application Part 1 <https://django-erp-framework.readthedocs.io/en/latest/getting_started/index.html>
_
The reporting engine of this framework is released as a separate package django-slick-reporting <https://pypi.org/project/django-slick-reporting/>
_.
To run the test suite, first, create and activate a virtual environment. Then clone the repo, install the test requirements and run the tests::
# 1. Clone and install requirements
$ git clone git+git@github.com:ra-systems/django-erp-framework.git
$ cd tests
$ pip install -e ..
$ pip install -r requirements.txt
# 2. Set the test database connection details in the environment
$ export DATABASE_NAME=<database name>
$ export DATABASE_USER=<database user>
$ export DATABASE_PASSWORD=<database password if any>
# 3. Run the tests
$ ./runtests.py
# And for Coverage report
$ coverage run --include=../* runtests.py [-k]
$ coverage html
For more information on contributing, we honor Django's guidelines <https://docs.djangoproject.com/en/dev/internals/contributing/writing-code/unit-tests/>
_.