Return a unified diff string between each cell in notebooks `a` and `b`.

Whether node is an arithmetic or a binary arithmetic expression

Return True if the given leaf starts an async def/for/with statement. Note that `async def` can be either an `async_stmt` or `async_funcdef`,

Given a `LN`, determines whether it's an atom `node` with invisible parens. Useful in dedupe-ing and normalizing parens.

Return True iff `leaf` is part of a slice with non-trivial exprs.

Return True if `node` holds an empty tuple.

Is this line converted from fmt off/skip code? If first_leaf_matches is not None, it only returns True if the first leaf of converted

Return True if the given leaf starts an import statement.

Returns whether this leaf is part of type annotations.

Return True iff `node` could be a 'dotted name' decorator This function takes the node of the 'namedexpr_test' of the new decorator grammar a

Return True iff `node` is a trailer valid in a simple decorator

Return the priority of the `leaf` delimiter, given a line break after it. The delimiter priorities returned here are from those delimiters that w

Return the priority of the `leaf` delimiter, given a line break before it. The delimiter priorities returned here are from those delimiters that

Return True if `node` holds a tuple that contains a walrus operator.

Return True iff `node` is of the shape ( test := test )

Return True if the given leaf starts a with or async with statement.

Return True if `node` holds a `yield` or `yield from` expression.

Given a string with source, return the lib2to3 Node.

Splits string into lines and expands only leading tabs (following the normal Python rules)

The uncompromising code formatter.

Main program, when run as a script: produce grammar pickle files. Calls load_grammar for each argument, a path to a grammar text file.

Return a consistently formatted comment from the given `content` string. All comments (except for "##", "#!", "#:", '#'") should have a single

Mask IPython magics so content becomes parseable Python code. For example, %matplotlib inline 'foo' becomes "25716

Does this pattern exactly match a sequence of nodes?

Return maximum delimiter priority inside `node`. This is specific to atoms with contents contained in a pair of parentheses. If `node` isn't

See `maybe_increment_for_loop_variable` above for explanation.

See `maybe_increment_lambda_arguments` above for explanation.

Return the number of extra empty lines before and after the `current_line`. This is for separating `def`, `async def` and `class` with extra

In a for loop, or comprehension, the variables are often unpacks. To avoid splitting on the comma in this situation, increase the depth of

In a lambda expression, there might be more than one argument. To avoid splitting on the comma in this situation, increase the depth of

Convert content between `# fmt: off`/`# fmt: on` into standalone comments.

Normalizes numeric (float, int, and complex) literals. All letters used in the representation are normalized to lowercase.

Replace hex codes in Unicode escape sequences with lowercase representation.

Return an empty context manager. To be used like `nullcontext` in Python 3.7.

A subclass can define this as a hook for optimizations. Returns either self or another node with the same effect.

Parse the .c file written by pgen. (Internal) The file looks as follows. The first two lines are always this: #include "pgenheader

Parse the .h file written by pgen. (Internal) This file is a sequence of #define statements defining the nonterminals of the grammar

Parse a pyproject toml file, pulling out relevant parts for Black. If parsing fails, will raise a tomllib.TOMLDecodeError.

Parse a specifier string (i.e. ``">=3.7,<3.10"``) to a list of TargetVersion. If parsing fails, will raise a packaging.specifiers.InvalidSpecifie

Parse a version string (i.e. ``"3.7"``) to a list of TargetVersion. If parsing fails, will raise a packaging.version.InvalidVersion error. If

Parse a stream and return the syntax tree.

Parse a stream and return the syntax tree.

Make Click not crash on Python 3.6 with LANG=C. On certain misconfigured environments, Python 3 selects the ASCII encoding as the default whi

Exit if there is no `src` provided for formatting

Custom Split Map Getter Method Returns: * A list of the custom splits that are mapped to @string, if any exist.

Return a post-order iterator for the tree. This must be implemented by the concrete subclass.

Return if the `node` and its previous siblings match types against the provided list of tokens; the provided `node`has its type matched against th

Put trailing semicolon back if cell originally had it. Mirrors the logic in `quiet` from `IPython.core.displayhook`, but uses ``tokenize_rt``

Reformat and print out `content` without spawning child processes. Similar to `reformat_one`, but for string content. `fast`, `write_bac

Reformat multiple files using a ProcessPoolExecutor.

Reformat a single file under `src` without spawning child processes. `fast`, `write_back`, and `mode` options are passed to :func:`format_fil

Remove the trailing comma and moves the comments attached to it.

Remove trailing semicolon from Jupyter notebook cell. For example, fig, ax = plt.subplots() ax.plot(x_data, y_data); # plot dat

Recursively hide optional parens in `with` statements.

Replace cell magic with token. Note that 'src' will already have been processed by IPython's TransformerManager().transform_cell. Exampl

Replace magics within body of cell. Note that 'src' will already have been processed by IPython's TransformerManager().transform_cell. E

Split line into many lines, starting with the last matching bracket pair. If the split was by optional parentheses, attempt splitting without the

Run formatting of `sources` in parallel using the provided `executor`. (Use ProcessPoolExecutors for actual parallelism.) `write_back`, `fas

Prepare for parsing. This *must* be called before starting to parse. The optional argument is an alternative start symbol; it

Shift a token. (Internal)

Should `line` be immediately split with `delimiter_split()` after RHS?