Differences between revisions 1 and 23 (spanning 22 versions)
Revision 1 as of 2019-10-30 10:58:08
Size: 1413
Editor: chapoton
Comment:
Revision 23 as of 2019-11-17 13:33:29
Size: 2033
Editor: egourgoulhon
Comment:
Deletions are marked like this. Additions are marked like this.
Line 3: Line 3:
!SageMath has been running under '''Python 2''' since the beginning, until version 8.9. !SageMath has been running on top of '''Python 2''' since the beginning, until version 8.9, released in september 2019.
Line 5: Line 5:
Starting from version 9.0 (to be released later in 2019), !SageMath will be running on top of '''Python 3'''. Starting from version 9.0 (to be released later in 2019 or early 2020), !SageMath will be running on top of '''Python 3'''.
Line 7: Line 7:
The change from Python2 to Python3 has already been made by all major scientific software based on Python, including !NumPy, !SciPy and !Jupyter. It becomes more and more common for scientific Python software to work only under Python3. Moreover, the official end of life for Python2 is the end of 2019. The change from Python 2 to Python 3 has already been made by all major scientific software based on Python, including !NumPy, !SciPy and Jupyter. It becomes more and more common for scientific Python software to work only under Python 3. Moreover, the official end of life for Python 2 is the end of 2019 (see the [[https://pythonclock.org/|countdown]])
Line 9: Line 9:
For all these reasons, it is necessary for Sagemath to switch to Python 3. After a lot of work and a lot of time, this is now possible and will be done in the 9.0 version. Python 3 has some major backward incompatibilities with Python2, and adapting !SageMath code from Python 2 to Python 3 takes some care and some work. Some basic instructions for doing that can be found in the following wiki pages
Line 11: Line 11:
This will not be without pain for the users of sage. Python 3 has some major backward incompatibilities with Python2, and adapting the code takes some care and some work.  * [[Python3-compatible code]] (for developers)
 * [[Python3-user]] (for users)
Line 13: Line 14:
Some basic instructions can be found in [[Python3-compatible??]] More complete instructions for porting code can be found in the official [[https://docs.python.org/dev/howto/pyporting.html|Python documentation]].
Line 17: Line 18:
=== Old notebooks === == Old notebooks ==
Line 19: Line 20:
The "legacy Sage notebook", which was used by Sage for a long time, has been replaced by the Jupyter notebook XXX years ago. Because the legacy notebook is no longer maintained, it is not compatible with Python 3 and will not be available in versions 9.0 and higher of SageMath. The "legacy notebook", which was used by !SageMath for a long time, has been replaced by the Jupyter notebook since 2015. Because the legacy notebook is no longer maintained, it is not compatible with Python 3 and will not be available in versions 9.0 and higher of !SageMath.
Line 21: Line 22:
All people that still have old-style notebooks are urged to migrate them to Jupyter notebooks now. All people that still have old-style notebooks are urged to migrate them to Jupyter notebooks now, by running the command
{{{
sage -n export
}}}

== Compiling with Python 2 ==

After version 9.0, if you really want so, you can still build and use !SageMath with '''Python 2''', as follows.
{{{
make configure
./configure --with-python=2
make build
}}}
Beware that you will need to call the second line again if you ever call "make distclean".

This will work until version 9.1 at least. Then the backward compatibility with Python 2 will no longer be ensured.

Summary of the Python 3 switch

SageMath has been running on top of Python 2 since the beginning, until version 8.9, released in september 2019.

Starting from version 9.0 (to be released later in 2019 or early 2020), SageMath will be running on top of Python 3.

The change from Python 2 to Python 3 has already been made by all major scientific software based on Python, including NumPy, SciPy and Jupyter. It becomes more and more common for scientific Python software to work only under Python 3. Moreover, the official end of life for Python 2 is the end of 2019 (see the countdown)

Python 3 has some major backward incompatibilities with Python2, and adapting SageMath code from Python 2 to Python 3 takes some care and some work. Some basic instructions for doing that can be found in the following wiki pages

More complete instructions for porting code can be found in the official Python documentation.

Some more specific details follow.

Old notebooks

The "legacy notebook", which was used by SageMath for a long time, has been replaced by the Jupyter notebook since 2015. Because the legacy notebook is no longer maintained, it is not compatible with Python 3 and will not be available in versions 9.0 and higher of SageMath.

All people that still have old-style notebooks are urged to migrate them to Jupyter notebooks now, by running the command

sage -n export

Compiling with Python 2

After version 9.0, if you really want so, you can still build and use SageMath with Python 2, as follows.

make configure
./configure --with-python=2
make build

Beware that you will need to call the second line again if you ever call "make distclean".

This will work until version 9.1 at least. Then the backward compatibility with Python 2 will no longer be ensured.

Python3-Switch (last edited 2021-02-09 13:32:40 by chapoton)