diff options
| author | Jocelyn Delalande <jocelyn@crapouillou.net> | 2020-07-26 19:55:44 +0200 |
|---|---|---|
| committer | zorun <github@bitsofnetworks.org> | 2020-07-26 20:14:59 +0200 |
| commit | 55bce593f04b64a383e300ae9967ce690f95c70d (patch) | |
| tree | 7996604f20b4040404b41e8ef1d239583640ee17 /docs/installation.rst | |
| parent | 48fabc346fd98d55eb44715e1a61e3feeb73de44 (diff) | |
| download | ihatemoney-mirror-55bce593f04b64a383e300ae9967ce690f95c70d.zip ihatemoney-mirror-55bce593f04b64a383e300ae9967ce690f95c70d.tar.gz ihatemoney-mirror-55bce593f04b64a383e300ae9967ce690f95c70d.tar.bz2 | |
Use venv module rather than virtualenv
- simpler to use
- lighter dependency (or no dependency at all, depending on python distribution)
- retrocompatible
virtualenv package from pip to acheive virtual environment feature is no longer
needed, except for projects which need to support py2, which is no longer our
case.
Also, reword "virtualenv" to "virtual environment" in doc, to avoid confusion
with pip package name.
Ref #483
Diffstat (limited to 'docs/installation.rst')
| -rw-r--r-- | docs/installation.rst | 18 |
1 files changed, 9 insertions, 9 deletions
diff --git a/docs/installation.rst b/docs/installation.rst index 4d37af8..b33fb55 100644 --- a/docs/installation.rst +++ b/docs/installation.rst @@ -21,9 +21,9 @@ Requirements * **Python**: either 3.6, 3.7 or 3.8 will work. * **A Backend**: to choose among MySQL, PostgreSQL, SQLite or Memory. -* **Virtualenv** (recommended): `virtualenv` package under Debian/Ubuntu. +* **Virtual environment** (recommended): `python3-venv` package under Debian/Ubuntu. -We recommend to use `virtualenv <https://pypi.python.org/pypi/virtualenv>`_ but +We recommend to use `virtual environment <https://docs.python.org/3/tutorial/venv.html>`_ but it will work without if you prefer. If wondering about the backend, SQLite is the simplest and will work fine for @@ -33,16 +33,16 @@ most small to medium setups. .. _virtualenv-preparation: -Prepare virtualenv (recommended) -================================ +Prepare virtual environment (recommended) +========================================= Choose an installation path, here `/home/john/ihatemoney`. -Create a virtualenv:: +Create a virtual environment:: - virtualenv -p /usr/bin/python3 /home/john/ihatemoney + python3 -m venv /home/john/ihatemoney -Activate the virtualenv:: +Activate the virtual environment:: source /home/john/ihatemoney/bin/activate @@ -74,7 +74,7 @@ Configure database with MySQL/MariaDB (optional) apt install python3-dev libssl-dev -2. Install PyMySQL (within your virtualenv):: +2. Install PyMySQL (within your virtual environment):: pip install 'PyMySQL>=0.9,<0.10' @@ -87,7 +87,7 @@ Configure database with PostgreSQL (optional) .. note:: Only required if you use Postgresql. -1. Install python driver for PostgreSQL (from within your virtualenv):: +1. Install python driver for PostgreSQL (from within your virtual environment):: pip install psycopg2 |