Source code for svg_path_editor.sub_path_bounds

# This file is part of https://github.com/KurtBoehm/svg-path-editor.
#
# This Source Code Form is subject to the terms of the Mozilla Public
# License, v. 2.0. If a copy of the MPL was not distributed with this
# file, You can obtain one at https://mozilla.org/MPL/2.0/.

from .svg import SvgPath




def find_previous_move_to(svg: SvgPath, index: int) -> int:
    """
    Find the index of the nearest preceding ``M`` command.

    :param svg: Path whose items are inspected.
    :param index: Starting index (inclusive) from which to search backwards.
    :return: Index of the previous ``M`` item, or ``0`` if none is found.
    """
    i = index
    while i > 0 and svg.path[i].get_type(True) != "M":
        i -= 1
    return i





def find_next_move_to(svg: SvgPath, index: int) -> int:
    """
    Find the index of the next ``M`` command after the given item.

    :param svg: Path whose items are inspected.
    :param index: Starting index (exclusive) from which to search forwards.
    :return: Index of the next ``M`` item, or ``len(svg.path)`` if none is found.
    """
    i = index + 1
    while i < len(svg.path) and svg.path[i].get_type(True) != "M":
        i += 1
    return i





def get_sub_path_bounds(svg: SvgPath, index: int | None = None) -> tuple[int, int]:
    """
    Compute the half-open slice bounds of the subpath containing a given item.

    :param svg: Path whose subpath bounds are computed.
    :param index:
        Item index inside the target subpath, or ``None`` to get bounds of
        the entire path.
    :return: ``(start, end)`` indices suitable for slicing ``svg.path[start:end]``.
    """
    start = 0 if index is None else find_previous_move_to(svg, index)
    end = len(svg.path) if index is None else find_next_move_to(svg, index)
    return start, end