‼️ Remove deorecated NestedTokens and nest_tokens

Already replaced by `SyntaxTreeNode`

Author: chrisjsewell

markdown_it/token.py

@@ -157,67 +157,3 @@ def from_dict(cls, dct: MutableMapping[str, Any]) -> Token:
         if token.children:
             token.children = [cls.from_dict(c) for c in token.children]  # type: ignore[arg-type]
         return token
-
-
-@attr.s(slots=True)
-class NestedTokens:
-    """A class that closely resembles a Token,
-    but for a an opening/closing Token pair, and their containing children.
-    """
-
-    opening: Token = attr.ib()
-    closing: Token = attr.ib()
-    children: list[Token | NestedTokens] = attr.ib(factory=list)
-
-    def __getattr__(self, name):
-        return getattr(self.opening, name)
-
-    def attrGet(self, name: str) -> None | str | int | float:
-        """Get the value of attribute `name`, or null if it does not exist."""
-        return self.opening.attrGet(name)
-
-
-def nest_tokens(tokens: list[Token]) -> list[Token | NestedTokens]:
-    """Convert the token stream to a list of tokens and nested tokens.
-
-    ``NestedTokens`` contain the open and close tokens and a list of children
-    of all tokens in between (recursively nested)
-    """
-    warnings.warn(
-        "`markdown_it.token.nest_tokens` and `markdown_it.token.NestedTokens`"
-        " are deprecated. Please migrate to `markdown_it.tree.SyntaxTreeNode`",
-        DeprecationWarning,
-    )
-
-    output: list[Token | NestedTokens] = []
-
-    tokens = list(reversed(tokens))
-    while tokens:
-        token = tokens.pop()
-
-        if token.nesting == 0:
-            token = token.copy()
-            output.append(token)
-            if token.children:
-                # Ignore type checkers because `nest_tokens` doesn't respect
-                # typing of `Token.children`. We add `NestedTokens` into a
-                # `list[Token]` here.
-                token.children = nest_tokens(token.children)  # type: ignore
-            continue
-
-        assert token.nesting == 1, token.nesting
-
-        nested_tokens = [token]
-        nesting = 1
-        while tokens and nesting != 0:
-            token = tokens.pop()
-            nested_tokens.append(token)
-            nesting += token.nesting
-        if nesting != 0:
-            raise ValueError(f"unclosed tokens starting {nested_tokens[0]}")
-
-        child = NestedTokens(nested_tokens[0], nested_tokens[-1])
-        output.append(child)
-        child.children = nest_tokens(nested_tokens[1:-1])
-
-    return output

tests/test_api/test_token.py

@@ -1,6 +1,6 @@
 import warnings
 
-from markdown_it.token import NestedTokens, Token, nest_tokens
+from markdown_it.token import Token
 
 
 def test_token():
@@ -36,33 +36,3 @@ def test_token():
 def test_serialization():
     token = Token("name", "tag", 0, children=[Token("other", "tag2", 0)])
     assert token == Token.from_dict(token.as_dict())
-
-
-def test_nest_tokens():
-    tokens = nest_tokens(
-        [
-            Token("start", "", 0),
-            Token("open", "", 1),
-            Token("open_inner", "", 1),
-            Token("inner", "", 0),
-            Token("close_inner", "", -1),
-            Token("close", "", -1),
-            Token("end", "", 0),
-        ]
-    )
-    assert [t.type for t in tokens] == ["start", "open", "end"]
-    assert isinstance(tokens[0], Token)
-    assert isinstance(tokens[1], NestedTokens)
-    assert isinstance(tokens[2], Token)
-
-    nested = tokens[1]
-    assert nested.opening.type == "open"
-    assert nested.closing.type == "close"
-    assert len(nested.children) == 1
-    assert nested.children[0].type == "open_inner"
-
-    nested2 = nested.children[0]
-    assert nested2.opening.type == "open_inner"
-    assert nested2.closing.type == "close_inner"
-    assert len(nested2.children) == 1
-    assert nested2.children[0].type == "inner"