File: stream.py

package info (click to toggle)
python-jsonpath 2.0.2-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 1,028 kB
  • sloc: python: 9,473; makefile: 6
file content (97 lines) | stat: -rw-r--r-- 3,090 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
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
"""Step through a stream of tokens."""

from __future__ import annotations

from typing import Iterable

from .exceptions import JSONPathSyntaxError
from .token import TOKEN_EOF
from .token import TOKEN_WHITESPACE
from .token import Token


class TokenStream:
    """Step through a stream of tokens."""

    def __init__(self, token_iter: Iterable[Token]):
        self.tokens = list(token_iter)
        self.pos = 0
        path = self.tokens[0].path if self.tokens else ""
        self.eof = Token(TOKEN_EOF, "", -1, path)

    def __str__(self) -> str:  # pragma: no cover
        return f"current: {self.current}\nnext: {self.peek}"

    def current(self) -> Token:
        """Return the token at the current position in the stream."""
        try:
            return self.tokens[self.pos]
        except IndexError:
            return self.eof

    def next(self) -> Token:
        """Return the token at the current position and advance the pointer."""
        try:
            token = self.tokens[self.pos]
            self.pos += 1
            return token
        except IndexError:
            return self.eof

    def peek(self, offset: int = 1) -> Token:
        """Return the token at current position plus the offset.

        Does not advance the pointer.
        """
        try:
            return self.tokens[self.pos + offset]
        except IndexError:
            return self.eof

    def eat(self, kind: str, message: str | None = None) -> Token:
        """Assert tge type if the current token and advance the pointer."""
        token = self.next()
        if token.kind != kind:
            raise JSONPathSyntaxError(
                message or f"expected {kind}, found {token.kind!r}",
                token=token,
            )
        return token

    def expect(self, *typ: str) -> None:
        """Raise an exception of the current token is not in `typ`."""
        token = self.current()
        if token.kind not in typ:
            if len(typ) == 1:
                _typ = repr(typ[0])
            else:
                _typ = f"one of {typ!r}"
            raise JSONPathSyntaxError(
                f"expected {_typ}, found {token.kind!r}",
                token=token,
            )

    def expect_peek(self, *typ: str) -> None:
        """Raise an exception of the current token is not in `typ`."""
        token = self.peek()
        if token.kind not in typ:
            if len(typ) == 1:
                _typ = repr(typ[0])
            else:
                _typ = f"one of {typ!r}"
            raise JSONPathSyntaxError(
                f"expected {_typ}, found {token.kind!r}",
                token=token,
            )

    def expect_peek_not(self, typ: str, message: str) -> None:
        """Raise an exception if the next token kind of _typ_."""
        if self.peek().kind == typ:
            raise JSONPathSyntaxError(message, token=self.peek())

    def skip_whitespace(self) -> bool:
        """Skip whitespace."""
        if self.current().kind == TOKEN_WHITESPACE:
            self.pos += 1
            return True
        return False