documentation: add instructions for direnv

This commit is contained in:
Antoine Bartuccio 2019-10-08 00:59:19 +02:00
parent 5c3c14ab37
commit a766f7137c
Signed by: klmp200
GPG Key ID: E7245548C53F904B
4 changed files with 37 additions and 0 deletions

1
.envrc Normal file
View File

@ -0,0 +1 @@
source ./env/bin/activate

View File

@ -52,6 +52,7 @@ Bienvenue sur la documentation du Sith de l'AE
misc/md_syntax
misc/helpers
misc/direnv
misc/prod
Documentations complémentaires

31
doc/misc/direnv.rst Normal file
View File

@ -0,0 +1,31 @@
.. _direnv:
Utiliser direnv
===============
Pour éviter d'avoir à sourcer l'environnement à chaque fois qu'on rentre dans le projet, il est possible d'utiliser l'utilitaire `direnv <https://direnv.net/>`__.
.. sourcecode:: bash
# Installation de l'utilitaire
# Debian et Ubuntu
sudo apt install direnv
# Mac
brew install direnv
# Installation dans la config
# Si sur bash
echo 'eval "$(direnv hook bash)"' >> ~/.bashrc
# Si sur ZSH
echo 'eval "$(direnv hook zsh)"' >> ~/.zshrc
exit # On redémarre le terminal
# Une fois dans le dossier du projet site AE
direnv allow .
Une fois que cette configuration a été appliquée, aller dans le dossier du site applique automatiquement l'environnement virtuel, cela fait beaucoup moins de temps perdu pour tout le monde.
Direnv est un utilitaire très puissant et qui peut s'avérer pratique dans bien des situations, n'hésitez pas à aller vous renseigner plus en détail sur celui-ci.

View File

@ -51,6 +51,10 @@ Installer le projet
# Prépare la base de donnée
./manage.py setup
.. note::
Pour éviter d'avoir à utiliser la commande source sur le virtualenv systématiquement, il est possible de consulter :ref:`direnv`.
Configuration pour le développement
-----------------------------------