klmp200/Sith
1
0
Fork 0
mirror of https://github.com/ae-utbm/sith.git synced 2024-11-22 14:13:21 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update contributing and readme to xapian dependency

Browse Source
This commit is contained in:
Antoine Bartuccio 2018-12-05 22:15:20 +01:00
parent aba4207423
commit 824060bc7a
Signed by: klmp200
GPG Key ID: E7245548C53F904B
2 changed files with 32 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
CONTRIBUTING.md
View File

@ -19,11 +19,13 @@ Avec cette commande, tu clones le sith AE dans le dossier courant.
```bash ```bash
cd Sith cd Sith
virtualenv --clear --python=python3 env_sith virtualenv --system-site-packages --python=python3 env_sith
source env_sith/bin/activate source env_sith/bin/activate
pip install -r requirements.txt pip install -r requirements.txt
``` ```
Attention aux dépendances système, à voir dans le README.md
Maintenant, faut passer le sith en mode debug dans le fichier de settings personnalisé. Maintenant, faut passer le sith en mode debug dans le fichier de settings personnalisé.
```bash ```bash

22
README.md
View File

@ -9,12 +9,14 @@
To start working on the project, just run the following commands: To start working on the project, just run the following commands:
```bash
git clone https://ae-dev.utbm.fr/ae/Sith.git git clone https://ae-dev.utbm.fr/ae/Sith.git
cd Sith cd Sith
virtualenv --clear --python=python3 env virtualenv --system-site-packages --python=python3 env
source env/bin/activate source env/bin/activate
pip install -r requirements.txt pip install -r requirements.txt
./manage.py setup ./manage.py setup
```
To start the simple development server, just run `python3 manage.py runserver` To start the simple development server, just run `python3 manage.py runserver`
@ -36,17 +38,25 @@ already.
You can check all of them with: You can check all of them with:
``` ```bash
sudo apt install libmysqlclient-dev libssl-dev libjpeg-dev zlib1g-dev python3-dev libffi-dev python3-dev libgraphviz-dev pkg-config python3-xapian sudo apt install libmysqlclient-dev libssl-dev libjpeg-dev zlib1g-dev python3-dev libffi-dev python3-dev libgraphviz-dev pkg-config python3-xapian
``` ```
On macos, you will need homebrew
```bash
brew install --build-from-source xapian --with-python
```
If it doesn't work it's because it need [this pull request](https://github.com/Homebrew/homebrew-core/pull/34835) to be validated.
The development is done with sqlite, but it is advised to set a more robust DBMS for production (Postgresql for example) The development is done with sqlite, but it is advised to set a more robust DBMS for production (Postgresql for example)
### Collecting statics for production: ### Collecting statics for production:
We use scss in the project. In development environment (DEBUG=True), scss is compiled every time the file is needed. For production, it assumes you have already compiled every files and to do so, you need to use the following commands : We use scss in the project. In development environment (DEBUG=True), scss is compiled every time the file is needed. For production, it assumes you have already compiled every files and to do so, you need to use the following commands :
``` ```bash
./manage.py collectstatic # To collect statics ./manage.py collectstatic # To collect statics
./manage.py compilestatic # To compile scss in those statics ./manage.py compilestatic # To compile scss in those statics
``` ```
@ -75,9 +85,9 @@ appropriate group fields, or the right method to check user permissions.
#### Counting the number of line of code #### Counting the number of line of code
``` ```bash
# apt install cloc sudo apt install cloc
$ cloc --exclude-dir=doc,env . cloc --exclude-dir=doc,env .
``` ```
#### Updating doc/SYNTAX.md #### Updating doc/SYNTAX.md