File: parsers.py

package info (click to toggle)
python-openapi-core 0.22.0-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 2,104 kB
  • sloc: python: 19,979; makefile: 44
file content (73 lines) | stat: -rw-r--r-- 2,326 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
# Allow writing union types as X | Y in Python 3.9
from __future__ import annotations

import re
from dataclasses import dataclass


@dataclass(frozen=True)
class PathMatchResult:
    """Result of path parsing."""

    named: dict[str, str]


class PathParser:
    """Parses path patterns with parameters into regex and matches against URLs."""

    _PARAM_PATTERN = r"[^/]*"

    def __init__(
        self, pattern: str, pre_expression: str = "", post_expression: str = ""
    ) -> None:
        self.pattern = pattern
        self._group_to_name: dict[str, str] = {}

        regex_body = self._compile_template_to_regex(pattern)
        self._expression = f"{pre_expression}{regex_body}{post_expression}"
        self._compiled = re.compile(self._expression)

    def search(self, text: str) -> PathMatchResult | None:
        """Searches for a match in the given text."""
        match = self._compiled.search(text)
        return self._to_result(match)

    def parse(self, text: str) -> PathMatchResult | None:
        """Parses the entire text for a match."""
        match = self._compiled.fullmatch(text)
        return self._to_result(match)

    def _compile_template_to_regex(self, template: str) -> str:
        parts: list[str] = []
        i = 0
        group_index = 0
        while i < len(template):
            start = template.find("{", i)
            if start == -1:
                parts.append(re.escape(template[i:]))
                break
            end = template.find("}", start + 1)
            if end == -1:
                raise ValueError(f"Unmatched '{{' in template: {template!r}")

            parts.append(re.escape(template[i:start]))
            param_name = template[start + 1 : end]
            group_name = f"g{group_index}"
            group_index += 1
            self._group_to_name[group_name] = param_name
            parts.append(f"(?P<{group_name}>{self._PARAM_PATTERN})")
            i = end + 1

        return "".join(parts)

    def _to_result(
        self, match: re.Match[str] | None
    ) -> PathMatchResult | None:
        if match is None:
            return None
        return PathMatchResult(
            named={
                param_name: match.group(group_name)
                for group_name, param_name in self._group_to_name.items()
            },
        )