iSharkFly-Open
/
python-peps
mirror of https://github.com/python/peps.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

PEP 626 - slight word and grammar changes (#1532)

This commit is contained in:
Ethan Furman 2020-07-17 12:16:39 -07:00 committed by GitHub
parent 97354461ac
commit 9ff31b067f
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 5 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
pep-0626.rst
View File

@ -44,7 +44,7 @@ Rather than attempt to fix the ``co_lnotab`` attribute, a new method
``co_lines()`` will be added, which returns an iterator over bytecode offsets and source code lines. ``co_lines()`` will be added, which returns an iterator over bytecode offsets and source code lines.
Ensuring that the bytecode is annotated correctly to enable accurate line number information means that Ensuring that the bytecode is annotated correctly to enable accurate line number information means that
some bytecodes must be marked as artificial, and not having a line number. some bytecodes must be marked as artificial, and not have a line number.
Some care must be taken not to break existing tooling. Some care must be taken not to break existing tooling.
To minimize breakage, the ``co_lnotab`` attribute will be retained, but lazily generated on demand. To minimize breakage, the ``co_lnotab`` attribute will be retained, but lazily generated on demand.
@ -72,14 +72,14 @@ The f_lineno attribute
'''''''''''''''''''''' ''''''''''''''''''''''
* When a frame object is created, the ``f_lineno`` will be set to the line * When a frame object is created, the ``f_lineno`` will be set to the line
at which the function, or class is defined. For modules it will be set to zero. at which the function or class is defined. For modules it will be set to zero.
* The ``f_lineno`` attribute will be updated to match the line number about to be executed, * The ``f_lineno`` attribute will be updated to match the line number about to be executed,
even if tracing is turned off and no event is generated. even if tracing is turned off and no event is generated.
The new co_lines() method of code objects The new co_lines() method of code objects
''''''''''''''''''''''''''''''''''''''''' '''''''''''''''''''''''''''''''''''''''''
The ``co_lines()`` method will return an iterator which yields tupled of values, The ``co_lines()`` method will return an iterator which yields tuples of values,
each representing the line number of a range of bytecodes. Each tuple will consist of three values: each representing the line number of a range of bytecodes. Each tuple will consist of three values:
* ``start`` -- The offset (inclusive) of the start of the bytecode range * ``start`` -- The offset (inclusive) of the start of the bytecode range
@ -122,8 +122,8 @@ Any tools that parse the ``co_lnotab`` attribute of code objects will need to mo
Tools that use ``sys.settrace`` will be unaffected, except in cases where the "line" events they receive are more accurate. Tools that use ``sys.settrace`` will be unaffected, except in cases where the "line" events they receive are more accurate.
Examples of code for which the sequence of trace events which will change Examples of code for which the sequence of trace events will change
''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
In the following examples, events are listed as "name", ``f_lineno`` pairs. In the following examples, events are listed as "name", ``f_lineno`` pairs.