gh-133367: Add missing options to ast CLI

Author: donBarbos

Doc/library/ast.rst

@@ -29,7 +29,7 @@ compiled into a Python code object using the built-in :func:`compile` function.
 
 .. _abstract-grammar:
 
-Abstract Grammar
+Abstract grammar
 ----------------
 
 The abstract grammar is currently defined as follows:
@@ -2159,7 +2159,7 @@ Async and await
    occurrences of the same value (e.g. :class:`ast.Add`).
 
 
-:mod:`ast` Helpers
+:mod:`ast` helpers
 ------------------
 
 Apart from the node classes, the :mod:`ast` module defines these utility functions
@@ -2484,7 +2484,7 @@ and classes for traversing abstract syntax trees:
 
 .. _ast-compiler-flags:
 
-Compiler Flags
+Compiler flags
 --------------
 
 The following flags may be passed to :func:`compile` in order to change
@@ -2533,7 +2533,7 @@ effects on the compilation of a program:
 
 .. _ast-cli:
 
-Command-Line Usage
+Command-line usage
 ------------------
 
 .. versionadded:: 3.9
@@ -2572,6 +2572,19 @@ The following options are accepted:
 
    Indentation of nodes in AST (number of spaces).
 
+.. option:: --feature-version <version>
+
+   Minor version (int) or 3.x tuple (e.g., 3.10).
+
+.. option:: -o <level>
+            --optimize <level>
+
+   Optimization level for parser.
+
+.. option:: --show-empty
+
+   Show empty lists and fields in dump output.
+
 If :file:`infile` is specified its contents are parsed to AST and dumped
 to stdout.  Otherwise, the content is read from stdin.
 

Doc/whatsnew/3.14.rst

@@ -1991,6 +1991,10 @@ ast
   Use :attr:`!ast.Constant.value` instead.
   (Contributed by Alex Waygood in :gh:`119562`.)
 
+* Added new ``--feature-version``, ``--optimize``, ``--show-empty`` options to
+  command-line interface.
+  (Contributed by Semyon Moroz in :gh:`133367`.)
+
 asyncio
 -------
 

Lib/ast.py

@@ -643,6 +643,14 @@ def main():
                              'column offsets')
     parser.add_argument('-i', '--indent', type=int, default=3,
                         help='indentation of nodes (number of spaces)')
+    parser.add_argument('--feature-version',
+                        type=str, default=None, metavar='VERSION',
+                        help='minor version (int) or 3.x tuple (e.g., 3.10)')
+    parser.add_argument('-o', '--optimize',
+                        type=int, default=-1, metavar='LEVEL',
+                        help='optimization level for parser (default -1)')
+    parser.add_argument('--show-empty', default=False, action='store_true',
+                        help='show empty lists and fields in dump output')
     args = parser.parse_args()
 
     if args.infile == '-':
@@ -652,8 +660,22 @@ def main():
         name = args.infile
         with open(args.infile, 'rb') as infile:
             source = infile.read()
-    tree = parse(source, name, args.mode, type_comments=args.no_type_comments)
-    print(dump(tree, include_attributes=args.include_attributes, indent=args.indent))
+
+    # Process feature_version
+    feature_version = None
+    if args.feature_version:
+        if '.' in args.feature_version:
+            major_minor = tuple(map(int, args.feature_version.split('.', 1)))
+            if len(major_minor) != 2 or major_minor[0] != 3:
+                parser.error("--feature-version must be 3.x tuple (e.g., 3.10)")
+            feature_version = major_minor
+        else:
+            feature_version = int(args.feature_version)
+
+    tree = parse(source, name, args.mode, type_comments=args.no_type_comments,
+                 feature_version=feature_version, optimize=args.optimize)
+    print(dump(tree, include_attributes=args.include_attributes,
+               indent=args.indent, show_empty=args.show_empty))
 
 if __name__ == '__main__':
     main()

Misc/NEWS.d/next/Library/2025-05-04-13-40-05.gh-issue-133367.E5nl2u.rst

@@ -0,0 +1,2 @@
+Add ``--feature-version``, ``--optimize``, ``--show-empty`` flags for
+:mod:`ast` command-line interface. Patch by Semyon Moroz.