https://github.com/python/cpython/commit/6d53b752831c453da115dd4ce54a0d121d9990cd commit: 6d53b752831c453da115dd4ce54a0d121d9990cd branch: main author: Hunter Hogan <hunterho...@users.noreply.github.com> committer: gpshead <g...@krypto.org> date: 2025-04-27T14:35:56-07:00 summary:
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-tur...@users.noreply.github.com> files: M Lib/ast.py diff --git a/Lib/ast.py b/Lib/ast.py index 507fec5f2d3890..aa788e6eb62c4f 100644 --- a/Lib/ast.py +++ b/Lib/ast.py @@ -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. - - An abstract syntax tree can be generated by passing `ast.PyCF_ONLY_AST` as - a flag to the `compile()` builtin function or by using the `parse()` - 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 - using the built-in `compile()` function. - - Additionally various helper functions are provided that make working with - 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). - - - :copyright: Copyright 2008 by Armin Ronacher. - :license: Python License. +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. + +An abstract syntax tree can be generated by passing `ast.PyCF_ONLY_AST` as +a flag to the `compile()` builtin function or by using the `parse()` +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 +using the built-in `compile()` function. + +Additionally various helper functions are provided that make working with +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). + +:copyright: Copyright 2008 by Armin Ronacher. +:license: Python License. """ from _ast import * _______________________________________________ Python-checkins mailing list -- python-checkins@python.org To unsubscribe send an email to python-checkins-le...@python.org https://mail.python.org/mailman3/lists/python-checkins.python.org/ Member address: arch...@mail-archive.com
