2to3: update grammar and examples (#5431)

Fixed some glaring mistakes in grammar and added a new example.
manned-org
bl-ue 2021-04-11 10:18:57 -04:00 committed by GitHub
parent ed9f1a3a98
commit 974a20f166
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 13 additions and 9 deletions

View File

@ -1,9 +1,9 @@
# 2to3
> Automated Python 2 to 3 code translation.
> Automated Python 2 to 3 code conversion.
> More information: <https://docs.python.org/3/library/2to3.html>.
- Display changes that would be performed:
- Display the changes that would be performed without performing them (dry-run):
`2to3 {{path/to/file.py}}`
@ -11,18 +11,22 @@
`2to3 --write {{path/to/file.py}}`
- Convert a specified Python 2 feature to Python 3:
- Convert specific Python 2 language features to Python 3:
`2to3 --write {{file.py}} --fix={{raw_input}} --fix={{print}}`
`2to3 --write {{path/to/file.py}} --fix={{raw_input}} --fix={{print}}`
- Convert all features except *raw_input* the specified ones to Python 3:
- Convert all Python 2 language features except the specified ones to Python 3:
`2to3 --nofix={{raw_input}} --fix={{print}} example.py`
`2to3 --write {{path/to/file.py}} --nofix={{has_key}} --nofix={{isinstance}}`
- Display the list of available transformation features:
- Display a list of all available language features that can be converted from Python 2 to Python 3:
`2to3 --list-fixes`
- Convert an entire directory:
- Convert all Python 2 files in a directory to Python 3:
`2to3 --output-dir={{path/to/code_python3_version}} --write-unchanged-files --nobackups {{path/to/code_python2_version}}`
`2to3 --output-dir={{path/to/python3_directory}} --write-unchanged-files --nobackups {{path/to/python2_directory}}`
- Run 2to3 with multiple threads:
`2to3 --processes={{4}} --output-dir={{path/to/python3_directory}} --write --nobackups --no-diff {{path/to/python2_directory}}`