Add `explode_split` to documentation

diff --git a/black.py b/black.py
index e899f7f0908a022baa92e2c2a205de44c99d47a0..5458198b17560621545fdcb0d15a4c32fcdb6522 100644 (file)
--- a/black.py
+++ b/black.py
@@ -1984,13 +1984,14 @@ def standalone_comment_split(line: Line, py36: bool = False) -> Iterator[Line]:
 def explode_split(
     line: Line, py36: bool = False, omit: Collection[LeafID] = ()
 ) -> Iterator[Line]:
 def explode_split(
     line: Line, py36: bool = False, omit: Collection[LeafID] = ()
 ) -> Iterator[Line]:

-    """Split by RHS and immediately split contents by a delimiter."""
+    """Split by rightmost bracket and immediately split contents by a delimiter."""

     new_lines = list(right_hand_split(line, py36, omit))
     if len(new_lines) != 3:
         yield from new_lines
         return
 
     yield new_lines[0]
     new_lines = list(right_hand_split(line, py36, omit))
     if len(new_lines) != 3:
         yield from new_lines
         return
 
     yield new_lines[0]

+

     try:
         yield from delimiter_split(new_lines[1], py36)
     except CannotSplit:
     try:
         yield from delimiter_split(new_lines[1], py36)
     except CannotSplit:

diff --git a/docs/reference/reference_functions.rst b/docs/reference/reference_functions.rst
index 40d9665138cd6de9919ee2814d8571c4e2df8a1a..d0ded95e4a6d1110640786b431832dbde973f94d 100644 (file)
--- a/docs/reference/reference_functions.rst
+++ b/docs/reference/reference_functions.rst
@@ -60,6 +60,8 @@ Split functions
 
 .. autofunction:: black.delimiter_split
 
 
 .. autofunction:: black.delimiter_split
 

+.. autofunction:: black.explode_split
+

 .. autofunction:: black.left_hand_split
 
 .. autofunction:: black.right_hand_split
 .. autofunction:: black.left_hand_split
 
 .. autofunction:: black.right_hand_split