The 2021-01-11 release notes have been updated.
Dropping support for Python 2
Date: 2021-01-11
Optional per env: required on all environments
CommCare Version Dependency
This change is not known to be dependent on any particular version of CommCare.
Change Context
Python 3.6 is supported and now the preferred version to use. In anticipation of dropping Python 2 support, an error will be displayed when running commands with Python 2. Instructions for upgrading to Python 3 are provided in the error message. An option is provided to temporarily revert to Python 2 (see update steps for details).
Python 2 support will end on 2021-03-04.
Details
Pip versions greater than 21.0 are not compatible with Python 2. To avoid dependency issues, we urge you to upgrade your environment to Python 3.6 as soon as possible. Python 2 should only serve as a backup if any issues are encountered while using Python 3.
Steps to update
Setup Python 3
- Create a new Python-3.6-based virtualenv
- Run
pip install -r requirements3.txt - Run
pip install -e . - Run
rm src/commcare_cloud.egg-info/requires.txt - Run
manage-commcare-cloud install
If you encounter a problem using Python 3, you can temporarily revert back to Python 2 by activating a Python 2 virtualenv and appending this option to your command: --force-commcare-cloud-to-use-python2.
Ensure your Python 2 virtualenv is setup properly with these commands:
- Activate Python-2.7-based virtualenv (create if necessary)
- Run
pip install -r requirements.txt - Run
pip install -e . - Run
rm src/commcare_cloud.egg-info/requires.txt - Run
manage-commcare-cloud install
About these release notes
If you run your own CommCare instance, these release notes are for you. As always, see CommCare Cloud | Official toolkit for deploying and maintaining CommCare server environment for the most up to date release notes and release note history.
These release notes are not simply for your information, they are instructions for you to follow.
Each change includes manual steps for you to follow to apply changes to your environment configuration or infrastructure that will allow you to be on the latest versions of commcare-cloud and commcare-hq.
Inside the instructions for applying the maintenance for each change, it will tell you whether there are any environments it may not be necessary for. When in doubt, apply the steps for every change.