| .. _python-language-reference: |
| |
| Python Language Reference Coverage |
| ================================== |
| |
| This is a 1:1 mapping of the features listed in https://docs.python.org/3/reference/ and their |
| support in TorchScript. The categorizations are as follows: |
| |
| |
| .. list-table:: |
| :header-rows: 1 |
| |
| * - Section |
| - Status |
| - Note |
| * - `1. Introduction <https://docs.python.org/3/reference/introduction.html>`_ |
| - Not Relevant |
| - |
| * - `1.1. Alternate Implementations <https://docs.python.org/3/reference/introduction.html#alternate-implementations>`_ |
| - Not Relevant |
| - |
| * - `1.2. Notation <https://docs.python.org/3/reference/introduction.html#notation>`_ |
| - Not Relevant |
| - |
| * - `2. Lexical analysis <https://docs.python.org/3/reference/lexical_analysis.html#>`_ |
| - Not Relevant |
| - |
| * - `2.1. Line structure <https://docs.python.org/3/reference/lexical_analysis.html#line-structure>`_ |
| - Not Relevant |
| - |
| * - `2.1.1. Logical lines <https://docs.python.org/3/reference/lexical_analysis.html#logical-lines>`_ |
| - Not Relevant |
| - |
| * - `2.1.2. Physical lines <https://docs.python.org/3/reference/lexical_analysis.html#physical-lines>`_ |
| - Supported |
| - |
| * - `2.1.3. Comments <https://docs.python.org/3/reference/lexical_analysis.html#comments>`_ |
| - Supported |
| - |
| * - `2.1.4. Encoding declarations <https://docs.python.org/3/reference/lexical_analysis.html#encoding-declarations>`_ |
| - Not Supported |
| - TorchScript explicitly don't support unicode |
| * - `2.1.5. Explicit line joining <https://docs.python.org/3/reference/lexical_analysis.html#explicit-line-joining>`_ |
| - Supported |
| - |
| * - `2.1.6. Implicit line joining <https://docs.python.org/3/reference/lexical_analysis.html#implicit-line-joining>`_ |
| - Supported |
| - |
| * - `2.1.7. Blank lines <https://docs.python.org/3/reference/lexical_analysis.html#blank-lines>`_ |
| - Supported |
| - |
| * - `2.1.8. Indentation <https://docs.python.org/3/reference/lexical_analysis.html#indentation>`_ |
| - Supported |
| - |
| * - `2.1.9. Whitespace between tokens <https://docs.python.org/3/reference/lexical_analysis.html#whitespace-between-tokens>`_ |
| - Not Relevant |
| - |
| * - `2.2. Other tokens <https://docs.python.org/3/reference/lexical_analysis.html#other-tokens>`_ |
| - Not Relevant |
| - |
| * - `2.3. Identifiers and keywords <https://docs.python.org/3/reference/lexical_analysis.html#identifiers>`_ |
| - Supported |
| - |
| * - `2.3.1. Keywords <https://docs.python.org/3/reference/lexical_analysis.html#keywords>`_ |
| - Supported |
| - |
| * - `2.3.2. Reserved classes of identifiers <https://docs.python.org/3/reference/lexical_analysis.html#reserved-classes-of-identifiers>`_ |
| - Supported |
| - |
| * - `2.4. Literals <https://docs.python.org/3/reference/lexical_analysis.html#literals>`_ |
| - Not Relevant |
| - |
| * - `2.4.1. String and Bytes literals <https://docs.python.org/3/reference/lexical_analysis.html#string-and-bytes-literals>`_ |
| - Supported |
| - |
| * - `2.4.2. String literal concatenation <https://docs.python.org/3/reference/lexical_analysis.html#string-literal-concatenation>`_ |
| - Supported |
| - |
| * - `2.4.3. Formatted string literals <https://docs.python.org/3/reference/lexical_analysis.html#formatted-string-literals>`_ |
| - Partially Supported |
| - |
| * - `2.4.4. Numeric literals <https://docs.python.org/3/reference/lexical_analysis.html#numeric-literals>`_ |
| - Supported |
| - |
| * - `2.4.5. Integer literals <https://docs.python.org/3/reference/lexical_analysis.html#integer-literals>`_ |
| - Supported |
| - |
| * - `2.4.6. Floating point literals <https://docs.python.org/3/reference/lexical_analysis.html#floating-point-literals>`_ |
| - Supported |
| - |
| * - `2.4.7. Imaginary literals <https://docs.python.org/3/reference/lexical_analysis.html#imaginary-literals>`_ |
| - Not Supported |
| - |
| * - `2.5. Operators <https://docs.python.org/3/reference/lexical_analysis.html#operators>`_ |
| - Partially Supported |
| - Not supported: ``<<``, ``>>``, ``:=`` |
| * - `2.6. Delimiters <https://docs.python.org/3/reference/lexical_analysis.html#delimiters>`_ |
| - Partially Supported |
| - Not supported: ``**=``, ``<<=``, ``>>=``, ``%=``, ``^=``, ``@=``, ``&=``, ``//=``, ``%`` operator for some types (e.g. ``str``\ ) |
| * - `3. Data model <https://docs.python.org/3/reference/datamodel.html#>`_ |
| - Not Relevant |
| - |
| * - `3.1. Objects, values and types <https://docs.python.org/3/reference/datamodel.html#objects-values-and-types>`_ |
| - Not Relevant |
| - |
| * - `3.2. The standard type hierarchy <https://docs.python.org/3/reference/datamodel.html#the-standard-type-hierarchy>`_ |
| - Partially Supported |
| - Not supported: NotImplemented, Ellipsis, numbers.Complex, bytes, byte arrays, sets, frozen sets, generators, coroutines, async generators, modules, I/O objects, internal objects, slice objects ( though slicing is supported), classmethod |
| * - `3.3. Special method names <https://docs.python.org/3/reference/datamodel.html#special-method-names>`_ |
| - Supported |
| - |
| * - `3.3.1. Basic customization <https://docs.python.org/3/reference/datamodel.html#basic-customization>`_ |
| - Partially Supported |
| - Not supported: ``__new__`` , ``__del__`` , ``__bytes__`` , ``__format__`` , ``__hash__`` , |
| * - `3.3.2. Customizing attribute access <https://docs.python.org/3/reference/datamodel.html#customizing-attribute-access>`_ |
| - Not Supported |
| - |
| * - `3.3.2.1. Customizing module attribute access <https://docs.python.org/3/reference/datamodel.html#customizing-module-attribute-access>`_ |
| - Not Supported |
| - |
| * - `3.3.2.2. Implementing Descriptors <https://docs.python.org/3/reference/datamodel.html#implementing-descriptors>`_ |
| - Not Supported |
| - |
| * - `3.3.2.3. Invoking Descriptors <https://docs.python.org/3/reference/datamodel.html#invoking-descriptors>`_ |
| - Not Supported |
| - |
| * - `3.3.2.4. __slots__ <https://docs.python.org/3/reference/datamodel.html#slots>`_ |
| - Not Supported |
| - |
| * - `3.3.2.4.1. Notes on using __slots__ <https://docs.python.org/3/reference/datamodel.html#notes-on-using-slots>`_ |
| - Not Supported |
| - |
| * - `3.3.3. Customizing class creation <https://docs.python.org/3/reference/datamodel.html#customizing-class-creation>`_ |
| - Not Supported |
| - |
| * - `3.3.3.1. Metaclasses <https://docs.python.org/3/reference/datamodel.html#metaclasses>`_ |
| - Not Supported |
| - |
| * - `3.3.3.2. Resolving MRO entries <https://docs.python.org/3/reference/datamodel.html#resolving-mro-entries>`_ |
| - Not Supported |
| - ``super()`` is not supported |
| * - `3.3.3.3. Determining the appropriate metaclass <https://docs.python.org/3/reference/datamodel.html#determining-the-appropriate-metaclass>`_ |
| - Not relevant |
| - |
| * - `3.3.3.4. Preparing the class namespace <https://docs.python.org/3/reference/datamodel.html#preparing-the-class-namespace>`_ |
| - Not relevant |
| - |
| * - `3.3.3.5. Executing the class body <https://docs.python.org/3/reference/datamodel.html#executing-the-class-body>`_ |
| - Not relevant |
| - |
| * - `3.3.3.6. Creating the class object <https://docs.python.org/3/reference/datamodel.html#creating-the-class-object>`_ |
| - Not relevant |
| - |
| * - `3.3.3.7. Uses for metaclasses <https://docs.python.org/3/reference/datamodel.html#uses-for-metaclasses>`_ |
| - Not relevant |
| - |
| * - `3.3.4. Customizing instance and subclass checks <https://docs.python.org/3/reference/datamodel.html#customizing-instance-and-subclass-checks>`_ |
| - Not Supported |
| - |
| * - `3.3.5. Emulating generic types <https://docs.python.org/3/reference/datamodel.html#emulating-generic-types>`_ |
| - Not Supported |
| - |
| * - `3.3.6. Emulating callable objects <https://docs.python.org/3/reference/datamodel.html#emulating-callable-objects>`_ |
| - Supported |
| - |
| * - `3.3.7. Emulating container types <https://docs.python.org/3/reference/datamodel.html#emulating-container-types>`_ |
| - Partially Supported |
| - Some magic methods not supported (e.g. ``__iter__`` ) |
| * - `3.3.8. Emulating numeric types <https://docs.python.org/3/reference/datamodel.html#emulating-numeric-types>`_ |
| - Partially Supported |
| - Magic methods with swapped operands not supported (``__r*__``) |
| * - `3.3.9. With Statement Context Managers <https://docs.python.org/3/reference/datamodel.html#with-statement-context-managers>`_ |
| - Not Supported |
| - |
| * - `3.3.10. Special method lookup <https://docs.python.org/3/reference/datamodel.html#special-method-lookup>`_ |
| - Not relevant |
| - |
| * - `3.4. Coroutines <https://docs.python.org/3/reference/datamodel.html#coroutines>`_ |
| - Not Supported |
| - |
| * - `3.4.1. Awaitable Objects <https://docs.python.org/3/reference/datamodel.html#awaitable-objects>`_ |
| - Not Supported |
| - |
| * - `3.4.2. Coroutine Objects <https://docs.python.org/3/reference/datamodel.html#coroutine-objects>`_ |
| - Not Supported |
| - |
| * - `3.4.3. Asynchronous Iterators <https://docs.python.org/3/reference/datamodel.html#asynchronous-iterators>`_ |
| - Not Supported |
| - |
| * - `3.4.4. Asynchronous Context Managers <https://docs.python.org/3/reference/datamodel.html#asynchronous-context-managers>`_ |
| - Not Supported |
| - |
| * - `4. Execution model <https://docs.python.org/3/reference/executionmodel.html#>`_ |
| - Not Relevant |
| - |
| * - `4.1. Structure of a program <https://docs.python.org/3/reference/executionmodel.html#structure-of-a-program>`_ |
| - Not Relevant |
| - |
| * - `4.2. Naming and binding <https://docs.python.org/3/reference/executionmodel.html#naming-and-binding>`_ |
| - Not Relevant |
| - Names are bound at compile time in TorchScript |
| * - `4.2.1. Binding of names <https://docs.python.org/3/reference/executionmodel.html#binding-of-names>`_ |
| - Not Relevant |
| - See ``global`` and ``nonlocal`` statements section |
| * - `4.2.2. Resolution of names <https://docs.python.org/3/reference/executionmodel.html#resolution-of-names>`_ |
| - Not Relevant |
| - See ``global`` and ``nonlocal`` statements section |
| * - `4.2.3. Builtins and restricted execution <https://docs.python.org/3/reference/executionmodel.html#builtins-and-restricted-execution>`_ |
| - Not Relevant |
| - |
| * - `4.2.4. Interaction with dynamic features <https://docs.python.org/3/reference/executionmodel.html#interaction-with-dynamic-features>`_ |
| - Not Supported |
| - Python values cannot be captured |
| * - `4.3. Exceptions <https://docs.python.org/3/reference/executionmodel.html#exceptions>`_ |
| - Partially Supported |
| - See ``try`` and ``raise`` statement section |
| * - `5. The import system <https://docs.python.org/3/reference/import.html>`_ |
| - Not Relevant |
| - |
| * - `6. Expressions <https://docs.python.org/3/reference/expressions.html#>`_ |
| - Not Relevant |
| - See expressions section |
| * - `6.1. Arithmetic conversions <https://docs.python.org/3/reference/expressions.html#arithmetic-conversions>`_ |
| - Supported |
| - |
| * - `6.2. Atoms <https://docs.python.org/3/reference/expressions.html#atoms>`_ |
| - Not Relevant |
| - |
| * - `6.2.1. Identifiers (Names) <https://docs.python.org/3/reference/expressions.html#atom-identifiers>`_ |
| - Supported |
| - |
| * - `6.2.2. Literals <https://docs.python.org/3/reference/expressions.html#literals>`_ |
| - Partially Supported |
| - ``bytesliteral``\ , ``imagnumber`` not supported |
| * - `6.2.3. Parenthesized forms <https://docs.python.org/3/reference/expressions.html#parenthesized-forms>`_ |
| - Supported |
| - |
| * - `6.2.4. Displays for lists, sets and dictionaries <https://docs.python.org/3/reference/expressions.html#displays-for-lists-sets-and-dictionaries>`_ |
| - Partially Supported |
| - Not supported: comprehension ifs, async iterators |
| * - `6.2.5. List displays <https://docs.python.org/3/reference/expressions.html#list-displays>`_ |
| - Supported |
| - |
| * - `6.2.6. Set displays <https://docs.python.org/3/reference/expressions.html#set-displays>`_ |
| - Not Supported |
| - |
| * - `6.2.7. Dictionary displays <https://docs.python.org/3/reference/expressions.html#dictionary-displays>`_ |
| - Supported |
| - dict() constructor with kwargs doesn't work, dict comprehensions, dictionary unpacking |
| * - `6.2.8. Generator expressions <https://docs.python.org/3/reference/expressions.html#generator-expressions>`_ |
| - Not Supported |
| - |
| * - `6.2.9. Yield expressions <https://docs.python.org/3/reference/expressions.html#yield-expressions>`_ |
| - Not Supported |
| - |
| * - `6.2.9.1. Generator-iterator methods <https://docs.python.org/3/reference/expressions.html#generator-iterator-methods>`_ |
| - Not Supported |
| - |
| * - `6.2.9.2. Examples <https://docs.python.org/3/reference/expressions.html#examples>`_ |
| - Not Supported |
| - |
| * - `6.2.9.3. Asynchronous generator functions <https://docs.python.org/3/reference/expressions.html#asynchronous-generator-functions>`_ |
| - Not Supported |
| - |
| * - `6.2.9.4. Asynchronous generator-iterator methods <https://docs.python.org/3/reference/expressions.html#asynchronous-generator-iterator-methods>`_ |
| - Not Supported |
| - |
| * - `6.3. Primaries <https://docs.python.org/3/reference/expressions.html#primaries>`_ |
| - Supported |
| - |
| * - `6.3.1. Attribute references <https://docs.python.org/3/reference/expressions.html#attribute-references>`_ |
| - Supported |
| - |
| * - `6.3.2. Subscriptions <https://docs.python.org/3/reference/expressions.html#subscriptions>`_ |
| - Supported |
| - |
| * - `6.3.3. Slicings <https://docs.python.org/3/reference/expressions.html#slicings>`_ |
| - Partially Supported |
| - Tuple slicing with stride is not supported |
| * - `6.3.4. Calls <https://docs.python.org/3/reference/expressions.html#calls>`_ |
| - Partially Supported |
| - Args unpack / kwargs unpack is not supported |
| * - `6.4. Await expression <https://docs.python.org/3/reference/expressions.html#await-expression>`_ |
| - Not Supported |
| - |
| * - `6.5. The power operator <https://docs.python.org/3/reference/expressions.html#the-power-operator>`_ |
| - Supported |
| - |
| * - `6.6. Unary arithmetic and bitwise operations <https://docs.python.org/3/reference/expressions.html#unary-arithmetic-and-bitwise-operations>`_ |
| - Partially Supported |
| - Some bitwise operators are not implemented for primitive types (e.g. ``~x`` where ``x`` is an ``int`` is not currently supported) |
| * - `6.7. Binary arithmetic operations <https://docs.python.org/3/reference/expressions.html#binary-arithmetic-operations>`_ |
| - Partially Supported |
| - See delimiters section |
| * - `6.8. Shifting operations <https://docs.python.org/3/reference/expressions.html#shifting-operations>`_ |
| - Not Supported |
| - |
| * - `6.9. Binary bitwise operations <https://docs.python.org/3/reference/expressions.html#binary-bitwise-operations>`_ |
| - Supported |
| - |
| * - `6.10. Comparisons <https://docs.python.org/3/reference/expressions.html#comparisons>`_ |
| - Supported |
| - |
| * - `6.10.1. Value comparisons <https://docs.python.org/3/reference/expressions.html#value-comparisons>`_ |
| - Partially Supported |
| - Dictionary equality checks are not currently supported |
| * - `6.10.2. Membership test operations <https://docs.python.org/3/reference/expressions.html#membership-test-operations>`_ |
| - Partially Supported |
| - Not supported for TorchScript classes |
| * - `6.10.3. Identity comparisons <https://docs.python.org/3/reference/expressions.html#is-not>`_ |
| - Supported |
| - |
| * - `6.11. Boolean operations <https://docs.python.org/3/reference/expressions.html#boolean-operations>`_ |
| - Supported |
| - |
| * - `6.12. Conditional expressions <https://docs.python.org/3/reference/expressions.html#conditional-expressions>`_ |
| - Supported |
| - |
| * - `6.13. Lambdas <https://docs.python.org/3/reference/expressions.html#lambda>`_ |
| - Not Supported |
| - |
| * - `6.14. Expression lists <https://docs.python.org/3/reference/expressions.html#expression-lists>`_ |
| - Partially Supported |
| - Iterable unpacking not supported |
| * - `6.15. Evaluation order <https://docs.python.org/3/reference/expressions.html#evaluation-order>`_ |
| - Supported |
| - |
| * - `6.16. Operator precedence <https://docs.python.org/3/reference/expressions.html#operator-precedence>`_ |
| - Supported |
| - |
| * - `7. Simple statements <https://docs.python.org/3/reference/simple_stmts.html#>`_ |
| - Supported |
| - |
| * - `7.1. Expression statements <https://docs.python.org/3/reference/simple_stmts.html#expression-statements>`_ |
| - Supported |
| - |
| * - `7.2. Assignment statements <https://docs.python.org/3/reference/simple_stmts.html#assignment-statements>`_ |
| - Supported |
| - |
| * - `7.2.1. Augmented assignment statements <https://docs.python.org/3/reference/simple_stmts.html#augmented-assignment-statements>`_ |
| - Partially Supported |
| - See delimiters section |
| * - `7.2.2. Annotated assignment statements <https://docs.python.org/3/reference/simple_stmts.html#annotated-assignment-statements>`_ |
| - Supported |
| - |
| * - `7.3. The assert statement <https://docs.python.org/3/reference/simple_stmts.html#the-assert-statement>`_ |
| - Partially Supported |
| - Exception message is not customizable |
| * - `7.4. The pass statement <https://docs.python.org/3/reference/simple_stmts.html#the-pass-statement>`_ |
| - Supported |
| - |
| * - `7.5. The del statement <https://docs.python.org/3/reference/simple_stmts.html#the-del-statement>`_ |
| - Not Supported |
| - |
| * - `7.6. The return statement <https://docs.python.org/3/reference/simple_stmts.html#the-return-statement>`_ |
| - Supported |
| - Some other features of returning (e.g. behavior with try..finally) are unsupported |
| * - `7.7. The yield statement <https://docs.python.org/3/reference/simple_stmts.html#the-yield-statement>`_ |
| - Not Supported |
| - |
| * - `7.8. The raise statement <https://docs.python.org/3/reference/simple_stmts.html#the-raise-statement>`_ |
| - Partially Supported |
| - Exception message is not customizable |
| * - `7.9. The break statement <https://docs.python.org/3/reference/simple_stmts.html#the-break-statement>`_ |
| - Supported |
| - Some other features of returning (e.g. behavior with try..finally) are unsupported |
| * - `7.10. The continue statement <https://docs.python.org/3/reference/simple_stmts.html#the-continue-statement>`_ |
| - Supported |
| - Some other features of returning (e.g. behavior with try..finally) are unsupported |
| * - `7.11. The import statement <https://docs.python.org/3/reference/simple_stmts.html#the-import-statement>`_ |
| - Not Supported |
| - |
| * - `7.11.1. Future statements <https://docs.python.org/3/reference/simple_stmts.html#future-statements>`_ |
| - Not Supported |
| - |
| * - `7.12. The global statement <https://docs.python.org/3/reference/simple_stmts.html#the-global-statement>`_ |
| - Not Supported |
| - |
| * - `7.13. The nonlocal statement <https://docs.python.org/3/reference/simple_stmts.html#the-nonlocal-statement>`_ |
| - Not Supported |
| - |
| * - `8. Compound statements <https://docs.python.org/3/reference/compound_stmts.html#>`_ |
| - Irrelevant |
| - |
| * - `8.1. The if statement <https://docs.python.org/3/reference/compound_stmts.html#the-if-statement>`_ |
| - Supported |
| - |
| * - `8.2. The while statement <https://docs.python.org/3/reference/compound_stmts.html#the-while-statement>`_ |
| - Partially Supported |
| - while..else is not supported |
| * - `8.3. The for statement <https://docs.python.org/3/reference/compound_stmts.html#the-for-statement>`_ |
| - Partially Supported |
| - for..else is not supported |
| * - `8.4. The try statement <https://docs.python.org/3/reference/compound_stmts.html#the-try-statement>`_ |
| - Not Supported |
| - |
| * - `8.5. The with statement <https://docs.python.org/3/reference/compound_stmts.html#the-with-statement>`_ |
| - Partially Supported |
| - ``__exit__`` is always called with ``exc_type``, ``exc_value``, and ``traceback`` set to None, even if an exception was raised, and ``__exit__``'s return value is ignored. |
| * - `8.6. Function definitions <https://docs.python.org/3/reference/compound_stmts.html#function-definitions>`_ |
| - Not Supported |
| - |
| * - `8.7. Class definitions <https://docs.python.org/3/reference/compound_stmts.html#class-definitions>`_ |
| - Not Supported |
| - |
| * - `8.8. Coroutines <https://docs.python.org/3/reference/compound_stmts.html#coroutines>`_ |
| - Not Supported |
| - |
| * - `8.8.1. Coroutine function definition <https://docs.python.org/3/reference/compound_stmts.html#coroutine-function-definition>`_ |
| - Not Supported |
| - |
| * - `8.8.2. The async for statement <https://docs.python.org/3/reference/compound_stmts.html#the-async-for-statement>`_ |
| - Not Supported |
| - |
| * - `8.8.3. The async with statement <https://docs.python.org/3/reference/compound_stmts.html#the-async-with-statement>`_ |
| - Not Supported |
| - |
| * - `9. Top-level components <https://docs.python.org/3/reference/toplevel_components.html#>`_ |
| - Not Relevant |
| - |
| * - `9.1. Complete Python programs <https://docs.python.org/3/reference/toplevel_components.html#complete-python-programs>`_ |
| - Not Relevant |
| - |
| * - `9.2. File input <https://docs.python.org/3/reference/toplevel_components.html#file-input>`_ |
| - Not Relevant |
| - |
| * - `9.3. Interactive input <https://docs.python.org/3/reference/toplevel_components.html#interactive-input>`_ |
| - Not Relevant |
| - |
| * - `9.4. Expression input <https://docs.python.org/3/reference/toplevel_components.html#expression-input>`_ |
| - Not Relevant |
| - |
