gh-133046: Reformat the `ast` module docstring (GH-133050)

* Fix formatting in module docstring for `ast` https://github.com/python/cpython/issues/133046
* #133046 ast docstring: remove header, dedent, 80-char width.
* Keep existing wrapping

---------

Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
This commit is contained in:
Hunter Hogan 2025-04-27 16:35:56 -05:00 committed by GitHub
parent 28a2fd031e
commit 6d53b75283
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -1,28 +1,24 @@
""" """
ast The `ast` module helps Python applications to process trees of the Python
~~~ abstract syntax grammar. The abstract syntax itself might change with
each Python release; this module helps to find out programmatically what
the current grammar looks like and allows modifications of it.
The `ast` module helps Python applications to process trees of the Python An abstract syntax tree can be generated by passing `ast.PyCF_ONLY_AST` as
abstract syntax grammar. The abstract syntax itself might change with a flag to the `compile()` builtin function or by using the `parse()`
each Python release; this module helps to find out programmatically what function from this module. The result will be a tree of objects whose
the current grammar looks like and allows modifications of it. classes all inherit from `ast.AST`.
An abstract syntax tree can be generated by passing `ast.PyCF_ONLY_AST` as A modified abstract syntax tree can be compiled into a Python code object
a flag to the `compile()` builtin function or by using the `parse()` using the built-in `compile()` function.
function from this module. The result will be a tree of objects whose
classes all inherit from `ast.AST`.
A modified abstract syntax tree can be compiled into a Python code object Additionally various helper functions are provided that make working with
using the built-in `compile()` function. the trees simpler. The main intention of the helper functions and this
module in general is to provide an easy to use interface for libraries
that work tightly with the python syntax (template engines for example).
Additionally various helper functions are provided that make working with :copyright: Copyright 2008 by Armin Ronacher.
the trees simpler. The main intention of the helper functions and this :license: Python License.
module in general is to provide an easy to use interface for libraries
that work tightly with the python syntax (template engines for example).
:copyright: Copyright 2008 by Armin Ronacher.
:license: Python License.
""" """
from _ast import * from _ast import *