Updating README to reflect new tooling

This commit is contained in:
zakx 2017-04-10 22:57:13 +02:00
parent 428015ecf5
commit d27c68e4ee

View File

@ -4,18 +4,22 @@ Open Source Inventory Management System
[![Build Status](https://travis-ci.org/inventree/InvenTree.svg?branch=master)](https://travis-ci.org/inventree/InvenTree)
## Installation
When first installing InvenTree, initial database configuration must be performed. This is handled by the `install.py` script, which performs the following actions:
It is recommended to set up a clean Python 3.4+ virtual environment first:
`mkdir ~/.env && python3 -m venv ~/.env/InvenTree && source ~/.env/InvenTree/bin/activate`
1. Installs required django packages (requires [pip](https://pypi.python.org/pypi/pip))
You can then continue running `make setup` (which will be replaced by a proper setup.py soon). This will do the following:
1. Installs required Python dependencies (requires [pip](https://pypi.python.org/pypi/pip), should be part of your virtual environment by default)
1. Performs initial database setup
1. Updates database tables for all InvenTree components
This script can also be used to update the installation if changes have been made to the database configuration.
This command can also be used to update the installation if changes have been made to the database configuration.
To create an initial user account, run the command `python InvenTree/manage.py createsuperuser`
To create an initial user account, run the command `make superuser`.
## Documentation
For project code documentation, refer to the online [documentation](http://inventree.readthedocs.io/en/latest/) (auto-generated)
## Coding Style
All python code should conform to the [PEP 8](https://www.python.org/dev/peps/pep-0008/) style guide. Run the *pep_check.py* script which will compare all source (.py) files against the PEP 8 style.
If you'd like to contribute, install our development dependencies using `make develop`.
All Python code should conform to the [PEP 8](https://www.python.org/dev/peps/pep-0008/) style guide. Run `make style` which will compare all source (.py) files against the PEP 8 style. Tests can be run using `make test`.