regex (4)

re_escape

re_escape(string: str, re_type: Literal['python', 'posix_basic'] = 'python') -> str

Escape all regular expressions special characters from STRING.

Example

Jinja call:

{{ "[abc]" | re_escape }}

Result: \[abc\]

DocStrings

Parameters:

Name	Type	Description	Default
string	str	The string to escape	required
re_type	Literal['python', 'posix_basic']	The escape type	'python'

Source code in src/jinjarope/regexfilters.py

def re_escape(string: str, re_type: Literal["python", "posix_basic"] = "python") -> str:
    """Escape all regular expressions special characters from STRING.

    Filter adapted from Ansible

    Args:
        string: The string to escape
        re_type: The escape type
    """
    match re_type:
        case "python":
            return re.escape(string)
        case "posix_basic":
            # list of BRE special chars:
            return re_replace(string, r"([].[^$*\\])", r"\\\1")
        case _:
            msg = f"Invalid regex type ({re_type})"
            raise NotImplementedError(msg)

re_findall

re_findall(value: str, regex: str, *, ignorecase: bool = False, multiline: bool = False) -> list[typing.Any]

Perform re.findall and return the list of matches.

Example

Jinja call:

{{ "strings" | re_findall("s") }}

Result: ['s', 's']

DocStrings

Parameters:

Name	Type	Description	Default
value	str	The text to search in	required
regex	str	The regex to use for searching	required
ignorecase	bool	Whether char casing should be ignored	False
multiline	bool	Whether to perform a multi-line search	False

Source code in src/jinjarope/regexfilters.py

def re_findall(
    value: str,
    regex: str,
    *,
    ignorecase: bool = False,
    multiline: bool = False,
) -> list[Any]:
    """Perform re.findall and return the list of matches.

    Filter adapted from Ansible

    Args:
        value: The text to search in
        regex: The regex to use for searching
        ignorecase: Whether char casing should be ignored
        multiline: Whether to perform a multi-line search
    """
    flags = 0
    if ignorecase:
        flags |= re.I
    if multiline:
        flags |= re.M
    return re.findall(regex, value, flags)

re_replace

re_replace(value: str = '', pattern: str = '', replacement: str = '', *, ignorecase: bool = False, multiline: bool = False, count: int = 0) -> str

Perform a re.sub returning a string.

Example

Jinja call:

{{ "abc" | re_replace("b", "d") }}

Result: adc

DocStrings

Parameters:

Name	Type	Description	Default
value	str	The value to search-replace.	''
pattern	str	The regex pattern to use	''
replacement	str	The replacement pattern to use	''
ignorecase	bool	Whether to ignore casing	False
multiline	bool	Whether to do a multiline regex search	False
count	int	Amount of maximum substitutes.	0

Source code in src/jinjarope/regexfilters.py

def re_replace(
    value: str = "",
    pattern: str = "",
    replacement: str = "",
    *,
    ignorecase: bool = False,
    multiline: bool = False,
    count: int = 0,
) -> str:
    """Perform a `re.sub` returning a string.

    Filter adapted from Ansible

    Args:
        value: The value to search-replace.
        pattern: The regex pattern to use
        replacement: The replacement pattern to use
        ignorecase: Whether to ignore casing
        multiline: Whether to do a multiline regex search
        count: Amount of maximum substitutes.
    """
    flags = 0
    if ignorecase:
        flags |= re.I
    if multiline:
        flags |= re.M
    pat = re.compile(pattern, flags=flags)
    output, _subs = pat.subn(replacement, value, count=count)
    return output

re_search

re_search(value: str, regex: str, *args: str, ignorecase: bool = False, multiline: bool = False) -> list[str] | None | str

Perform re.search and return the list of matches or a backref.

Example

Jinja call:

{{ "string" | re_search("tri") }}

Result: tri

DocStrings

Parameters:

Name	Type	Description	Default
value	str	The text to search in	required
regex	str	The regex to use for searching	required
args	str	Optional back references to return	()
ignorecase	bool	Whether char casing should be ignored	False
multiline	bool	Whether to perform a multi-line search	False

Source code in src/jinjarope/regexfilters.py

def re_search(
    value: str,
    regex: str,
    *args: str,
    ignorecase: bool = False,
    multiline: bool = False,
) -> list[str] | None | str:
    """Perform re.search and return the list of matches or a backref.

    Filter adapted from Ansible

    Args:
        value: The text to search in
        regex: The regex to use for searching
        args: Optional back references to return
        ignorecase: Whether char casing should be ignored
        multiline: Whether to perform a multi-line search
    """
    groups = list()
    for arg in args:
        if arg.startswith("\\g"):
            if match := re.match(r"\\g<(\S+)>", arg):
                groups.append(match.group(1))
        elif arg.startswith("\\"):
            if match := re.match(r"\\(\d+)", arg):
                groups.append(int(match.group(1)))
        else:
            msg = "Unknown argument"
            raise FilterArgumentError(msg)

    flags = 0
    if ignorecase:
        flags |= re.I
    if multiline:
        flags |= re.M
    if match := re.search(regex, value, flags):
        if not groups:
            return match.group()
        return [match.group(item) for item in groups]
    return None