Quantifiers

OneOrMore

Bases: RegexComponent

A regex component that matches one or more occurrences of the supplied regex components.

Source code in src/pyregexbuilder/quantifiers.py

class OneOrMore(RegexComponent):
    """
    A regex component that matches one or more occurrences of the supplied regex components.
    """

    def __init__(
        self, *components: str | RegexComponent, greed: Greed = Greed.GREEDY
    ) -> None:
        self._regex = rf"(?:{self.parse(*components)})+{greed.value}"

Optionally

Bases: RegexComponent

A regex component that matches zero or one occurrences of the supplied regex components.

Source code in src/pyregexbuilder/quantifiers.py

class Optionally(RegexComponent):
    """
    A regex component that matches zero or one occurrences of the supplied regex components.
    """

    def __init__(
        self, *components: str | RegexComponent, greed: Greed = Greed.GREEDY
    ) -> None:
        self._regex = rf"(?:{self.parse(*components)})?{greed.value}"

Repeat

Bases: RegexComponent

A regex component that matches the specified number of occurrences of the supplied regex components.

Source code in src/pyregexbuilder/quantifiers.py

class Repeat(RegexComponent):
    """
    A regex component that matches the specified number of occurrences of the supplied regex components.
    """

    def __init__(
        self,
        *components: str | RegexComponent,
        count: int | None = None,
        minimum: int | None = None,
        maximum: int | None = None,
        greed: Greed = Greed.GREEDY,
    ) -> None:
        if (count and (minimum or maximum)) or not (any((count, minimum, maximum))):
            raise RegexBuilderException(
                "Must specify either `count` OR `minimum` and/or `maximum`."
            )

        if count:
            self._regex = rf"(?:{self.parse(*components)}{{{count}}})"
        else:
            m = minimum if minimum else ""
            n = maximum if maximum else ""
            self._regex = rf"(?:{self.parse(*components)}){{{m},{n}}}{greed.value}"

ZeroOrMore

Bases: RegexComponent

A regex component that matches zero or more occurrences of the supplied regex components.

Source code in src/pyregexbuilder/quantifiers.py

class ZeroOrMore(RegexComponent):
    """
    A regex component that matches zero or more occurrences of the supplied regex components.
    """

    def __init__(
        self, *components: str | RegexComponent, greed: Greed = Greed.GREEDY
    ) -> None:
        self._regex = rf"(?:{self.parse(*components)})*{greed.value}"