File: conversion_limitations.rst

package info (click to toggle)
python-future 0.18.2-6
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 4,264 kB
  • sloc: python: 43,246; makefile: 136; sh: 29
file content (27 lines) | stat: -rw-r--r-- 1,104 bytes parent folder | download | duplicates (7)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
.. _futurize-limitations:

Known limitations
-----------------

``futurize`` and ``pasteurize`` are useful to automate much of the
work of porting, particularly the boring repetitive text substitutions. They also
help to flag which parts of the code require attention.

Nevertheless, ``futurize`` and ``pasteurize`` are still incomplete and make
some mistakes, like 2to3, on which they are based. Please report bugs on
`GitHub <https://github.com/PythonCharmers/python-future/>`_. Contributions to
the ``lib2to3``-based fixers for ``futurize`` and ``pasteurize`` are
particularly welcome! Please see :ref:`contributing`.

``futurize`` doesn't currently make the following change automatically:

1. Strings containing ``\U`` produce a ``SyntaxError`` on Python 3. An example is::

       s = 'C:\Users'.

   Python 2 expands this to ``s = 'C:\\Users'``, but Python 3 requires a raw
   prefix (``r'...'``). This also applies to multi-line strings (including
   multi-line docstrings).

Also see the tests in ``future/tests/test_futurize.py`` marked
``@expectedFailure`` or ``@skip`` for known limitations.