diff options
Diffstat (limited to 'FOSS/Python/Dependencies/future-0.18.2/docs/conversion_limitations.rst')
| -rw-r--r-- | FOSS/Python/Dependencies/future-0.18.2/docs/conversion_limitations.rst | 27 |
1 files changed, 27 insertions, 0 deletions
diff --git a/FOSS/Python/Dependencies/future-0.18.2/docs/conversion_limitations.rst b/FOSS/Python/Dependencies/future-0.18.2/docs/conversion_limitations.rst new file mode 100644 index 0000000..c2b1530 --- /dev/null +++ b/FOSS/Python/Dependencies/future-0.18.2/docs/conversion_limitations.rst @@ -0,0 +1,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. |