Skip to content

Commit

Permalink
Document how to switch python version for 5.x
Browse files Browse the repository at this point in the history
Focus is on rebuilding venv (which are bound to a specific python minor
version).

Ref spiral-project#483
Ref spiral-project#571
  • Loading branch information
JocelynDelalande authored and zorun committed Jul 26, 2020
1 parent 2cace54 commit b8af9b2
Show file tree
Hide file tree
Showing 2 changed files with 33 additions and 0 deletions.
2 changes: 2 additions & 0 deletions docs/installation.rst
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
.. _installation:

Installation
############

Expand Down
31 changes: 31 additions & 0 deletions docs/upgrade.rst
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,37 @@ Version-specific instructions
When upgrading from a major version to another, you **must** follow special
instructions:

4.x → 5.x
---------

Switch to a supported version of Python
+++++++++++++++++++++++++++++++++++++++

.. note:: If you are already using Python ≥ 3.6, you can skip this section, no
special action is required.

If you were running IHateMoney using Python < 3.6, you must, **before** upgrading:

1. Ensure to have a Python ≥ 3.6 available on your system
2. Rebuild your virtualenv (if any). It will *not* alter your database nor configuration. For example, if your virtualenv is in `/home/john/ihatemoney/`::

rm -rf /home/john/ihatemoney
pyhton3 -m venv /home/john/ihatemoney
source /home/john/ihatemoney/bin/activate

You might need to ``pip install`` additional dependencies if you are using one
or several of the following deployment options :

- Gunicorn (Nginx)
- MySQL
- PostgreSQL

If so, pick the ``pip`` commands to use in the relevant section(s) of
:ref:`installation`.

Then follow :ref:`general-procedure` from step 1. in order to complete the update.


2.x → 3.x
---------

Expand Down

0 comments on commit b8af9b2

Please sign in to comment.