Skip to content

TracebackException.lineno changes from str to int after format() when a keyword typo suggestion is found #162296

Open

Description

@simonnelse

Bug report

For a SyntaxError, TracebackException stores lineno and end_lineno as strings. When the keyword typo suggestion ("Did you mean 'while'?") triggers during formatting, both attributes are replaced with ints.

import sys
import traceback

print(sys.version)

try:
    compile("whille True:\n    pass\n", "example.py", "exec")
except SyntaxError as exc:
    te = traceback.TracebackException.from_exception(exc)

print("before format():", repr(te.lineno), repr(te.end_lineno))
"".join(te.format())
print("after format(): ", repr(te.lineno), repr(te.end_lineno))

On main:

3.16.0a2+dev (remotes/origin/HEAD:d456158, Nov 19 2026, 22:08:35) [GCC 13.3.0]
before format(): '1' '1'
after format():  1 1

On 3.14:

3.14.6 (main, Jul 18 2026, 17:01:31) [Clang 22.1.3 ]
before format(): '1' '1'
after format():  1 1

On 3.13.18 both stay '1', since there are no keyword suggestions there.

The constructor does self.lineno = str(lno), but TracebackException._find_keyword_typos() later assigns self.lineno = start[0] and self.end_lineno = end[0], which are ints from the tokenizer.

The printed traceback is fine, so most people won't notice this. It only shows up if your code reads the attributes directly. For example, te.lineno == '1' is True before calling format() and False after.

It also affects equality: two TracebackException objects created from the same exception compare equal, but stop being equal after you format one of them.

I think the two assignments should be wrapped in str() to match the constructor. I'm happy to send a PR with a test if that's the right direction. The docs don't currently state the type of these attributes, so that could be clarified at the same time.

CPython versions tested on:

CPython main branch

Operating systems tested on:

macOS

Activity

  1. added
    stdlibStandard Library Python modules in the Lib/ directory
    on Nov 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    stdlibStandard Library Python modules in the Lib/ directorytype-bugAn unexpected behavior, bug, or error

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions