Bug 2349452

Summary: python-astdoc fails to build with Python 3.14: 3 doctests fail, e.g.: Expected: <ast.Name object at 0x...> Got: Name(id='int', ctx=Load())
Product: [Fedora] Fedora Reporter: Karolina Surma <ksurma>
Component: python-astdocAssignee: Davide Cavalca <davide>
Status: NEW --- QA Contact:
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: rawhideCC: davide, fti-bugs, ksurma, mhroncok, mkdocs-sig
Target Milestone: ---Flags: fti-bugs: needinfo? (davide)
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 2322407, 2339432, 2339435, 2342559    

Description Karolina Surma 2025-03-03 09:16:26 UTC
python-astdoc fails to build with Python 3.14.0a5.

_____________________ [doctest] astdoc.ast._iter_defaults ______________________
294 
295 Yields:
296     ast.expr | None: The default values for the parameters, or None
297     for parameters that do not have a default value.
298 
299 Examples:
300     >>> import ast
301     >>> src = "def func(a, b=2, c=3): pass"
302     >>> node = ast.parse(src).body[0]
303     >>> list(_iter_defaults(node))  # doctest: +ELLIPSIS
Expected:
    [None, <ast.Constant object at 0x...>, <ast.Constant object at 0x...>]
Got:
    [None, Constant(value=2, kind=None), Constant(value=3, kind=None)]

/builddir/build/BUILD/python-astdoc-1.0.0-build/astdoc-1.0.0/src/astdoc/ast.py:303: DocTestFailure
____________________ [doctest] astdoc.ast._iter_parameters _____________________
251     positional-only, positional-or-keyword, keyword-only, or variable).
252 
253 Examples:
254     >>> import ast
255     >>> src = "def func(a, b: int, *args, c: str, d=5, **kwargs): pass"
256     >>> node = ast.parse(src).body[0]
257     >>> args = list(_iter_parameters(node))
258     >>> args[0]
259     ('a', None, <_ParameterKind.POSITIONAL_OR_KEYWORD: 1>)
260     >>> args[1]  # doctest: +ELLIPSIS
Expected:
    ('b', <ast.Name object at 0x...>, <_ParameterKind.POSITIONAL_OR_KEYWORD: 1>)
Got:
    ('b', Name(id='int', ctx=Load()), <_ParameterKind.POSITIONAL_OR_KEYWORD: 1>)

/builddir/build/BUILD/python-astdoc-1.0.0-build/astdoc-1.0.0/src/astdoc/ast.py:260: DocTestFailure
_____________________ [doctest] astdoc.ast.get_assign_type _____________________
207         to extract the type annotation.
208 
209 Returns:
210     ast.expr | None: The type annotation of the assignment node if found,
211         otherwise None.
212 
213 Examples:
214     >>> import ast
215     >>> node = ast.parse("x: int = 1").body[0]
216     >>> get_assign_type(node)  # doctest: +ELLIPSIS
Expected:
    <ast.Name object at 0x...>
Got:
    Name(id='int', ctx=Load())

/builddir/build/BUILD/python-astdoc-1.0.0-build/astdoc-1.0.0/src/astdoc/ast.py:216: DocTestFailure

=========================== short test summary info ============================
FAILED src/astdoc/ast.py::astdoc.ast._iter_defaults
FAILED src/astdoc/ast.py::astdoc.ast._iter_parameters
FAILED src/astdoc/ast.py::astdoc.ast.get_assign_type
======================== 3 failed, 389 passed in 2.65s =========================

https://docs.python.org/3.14/whatsnew/3.14.html

For the build logs, see:
https://copr-be.cloud.fedoraproject.org/results/@python/python3.14/fedora-rawhide-x86_64/08693200-python-astdoc/

For all our attempts to build python-astdoc with Python 3.14, see:
https://copr.fedorainfracloud.org/coprs/g/python/python3.14/package/python-astdoc/

Testing and mass rebuild of packages is happening in copr.
You can follow these instructions to test locally in mock if your package builds with Python 3.14:
https://copr.fedorainfracloud.org/coprs/g/python/python3.14/

Let us know here if you have any questions.

Python 3.14 is planned to be included in Fedora 43.
To make that update smoother, we're building Fedora packages with all pre-releases of Python 3.14.
A build failure prevents us from testing all dependent packages (transitive [Build]Requires),
so if this package is required a lot, it's important for us to get it fixed soon.

We'd appreciate help from the people who know this package best,
but if you don't want to work on this now, let us know so we can try to work around it on our side.

Comment 1 Karolina Surma 2025-06-11 15:56:09 UTC
*** Bug 2371800 has been marked as a duplicate of this bug. ***

Comment 2 Fedora Fails To Install 2025-06-20 19:51:35 UTC
Hello,

Please note that this comment was generated automatically by https://pagure.io/releng/blob/main/f/scripts/ftbfs-fti/follow-policy.py
If you feel that this output has mistakes, please open an issue at https://pagure.io/releng/

This package fails to install and maintainers are advised to take one of the following actions:

 - Fix this bug and close this bugzilla once the update makes it to the repository.
   (The same script that posted this comment will eventually close this bugzilla
   when the fixed package reaches the repository, so you don't have to worry about it.)

or

 - Move this bug to ASSIGNED if you plan on fixing this, but simply haven't done so yet.

or

 - Orphan the package if you no longer plan to maintain it.


If you do not take one of these actions, the process at https://docs.fedoraproject.org/en-US/fesco/Fails_to_build_from_source_Fails_to_install/#_package_removal_for_long_standing_ftbfs_and_fti_bugs will continue.
This package may be orphaned in 7+ weeks.
This is the first reminder (step 3) from the policy.

Don't hesitate to ask for help on https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org/ if you are unsure how to fix this bug.