mirror of
https://github.com/ae-utbm/sith.git
synced 2024-11-26 02:54:20 +00:00
Add black for sublime text in contributing
This commit is contained in:
parent
66957750ba
commit
d2fe9e56cf
@ -17,43 +17,76 @@ Ensuite, tu fais :
|
|||||||
`git clone https://ae-dev.utbm.fr/ae/Sith.git`
|
`git clone https://ae-dev.utbm.fr/ae/Sith.git`
|
||||||
Avec cette commande, tu clones le sith AE dans le dossier courant.
|
Avec cette commande, tu clones le sith AE dans le dossier courant.
|
||||||
|
|
||||||
|
```bash
|
||||||
cd Sith
|
cd Sith
|
||||||
virtualenv --clear --python=python3 env_sith
|
virtualenv --clear --python=python3 env_sith
|
||||||
source env_sith/bin/activate
|
source env_sith/bin/activate
|
||||||
pip install -r requirements.txt
|
pip install -r requirements.txt
|
||||||
|
```
|
||||||
|
|
||||||
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
|
||||||
echo "DEBUG=True" > sith/settings_custom.py
|
echo "DEBUG=True" > sith/settings_custom.py
|
||||||
echo 'EXTERNAL_RES = "False"' >> sith/settings_custom.py
|
echo 'EXTERNAL_RES = "False"' >> sith/settings_custom.py
|
||||||
echo 'SITH_URL = "localhost:8000"' >> sith/settings_custom.py
|
echo 'SITH_URL = "localhost:8000"' >> sith/settings_custom.py
|
||||||
|
```
|
||||||
|
|
||||||
Enfin, il s'agit de créer la base de donnée de test lors de la première utilisation
|
Enfin, il s'agit de créer la base de donnée de test lors de la première utilisation
|
||||||
|
|
||||||
|
```bash
|
||||||
./manage.py setup
|
./manage.py setup
|
||||||
|
```
|
||||||
|
|
||||||
Et pour lancer le sith, tu fais `python3 manage.py runserver`
|
Et pour lancer le sith, tu fais `python3 manage.py runserver`
|
||||||
|
|
||||||
Voilà, c'est le sith AE. Il y a des issues dans le gitlab qui sont à régler. Si tu as un domaine qui t'intéresse, une appli que tu voudrais développer, n'hésites pas et contacte-nous.
|
Voilà, c'est le sith AE. Il y a des issues dans le gitlab qui sont à régler. Si tu as un domaine qui t'intéresse, une appli que tu voudrais développer, n'hésites pas et contacte-nous.
|
||||||
Va, et que l'AE soit avec toi.
|
Va, et que l'AE soit avec toi.
|
||||||
|
|
||||||
Black
|
# Black
|
||||||
------------------
|
|
||||||
Pour uniformiser le formattage du code nous utilisons [Black](https://github.com/ambv/black). Cela permet d'avoir le même codestyle et donc le codereview prend moins de temps. Tout etant dans le même format, il est plus facile pour chacun de comprendre le code de chacun ! Cela permet aussi d'éviter des erreurs (y parait 🤷♀️).
|
Pour uniformiser le formattage du code nous utilisons [Black](https://github.com/ambv/black). Cela permet d'avoir le même codestyle et donc le codereview prend moins de temps. Tout étant dans le même format, il est plus facile pour chacun de comprendre le code de chacun ! Cela permet aussi d'éviter des erreurs (y parait 🤷♀️).
|
||||||
|
|
||||||
Installation de black:
|
Installation de black:
|
||||||
|
|
||||||
cd Sith
|
```bash
|
||||||
virtualenv --clear --python=python3 env_sith
|
|
||||||
source env_sith/bin/activate
|
|
||||||
pip install black
|
pip install black
|
||||||
|
```
|
||||||
|
|
||||||
Sous VsCode:
|
## Sous VsCode:
|
||||||
|
Attention, pour VsCode, Black doit être installé dans votre virtualenv !
|
||||||
Ajouter ces deux lignes dans les settings de VsCode
|
Ajouter ces deux lignes dans les settings de VsCode
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
"python.formatting.provider": "black",
|
"python.formatting.provider": "black",
|
||||||
"editor.formatOnSave": true,
|
"editor.formatOnSave": true
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Sous Sublime Text
|
||||||
|
Il faut installer le plugin [sublack](https://packagecontrol.io/packages/sublack) depuis Package Control.
|
||||||
|
|
||||||
|
Il suffit ensuite d'ajouter dans les settings du projet (ou en global)
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"sublack.black_on_save": true
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
Si vous utilisez le plugin [anaconda](http://damnwidget.github.io/anaconda/), pensez à modifier les paramètres du linter pep8 pour éviter de recevoir des warnings dans le formatage de black
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"pep8_ignore": [
|
||||||
|
"E203",
|
||||||
|
"E266",
|
||||||
|
"E501",
|
||||||
|
"W503"
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
Sites et doc cools
|
Sites et doc cools
|
||||||
------------------
|
------------------
|
||||||
|
Loading…
Reference in New Issue
Block a user