python-jsonpath 0.10.1__py3-none-any.whl → 0.10.3__py3-none-any.whl

jsonpath/__about__.py

@@ -1,4 +1,4 @@
 # SPDX-FileCopyrightText: 2023-present James Prior <jamesgr.prior@gmail.com>
 #
 # SPDX-License-Identifier: MIT
-__version__ = "0.10.1"
+__version__ = "0.10.3"

jsonpath/filter.py

@@ -623,7 +623,19 @@ class FunctionExtension(FilterExpression):
                 if func.arg_types[idx] != ExpressionType.NODES and isinstance(
                     arg, NodeList
                 ):
-                    _args.append(arg.values_or_singular())
+                    if len(arg) == 0:
+                        # If the query results in an empty nodelist, the
+                        # argument is the special result Nothing.
+                        _args.append(UNDEFINED)
+                    elif len(arg) == 1:
+                        # If the query results in a nodelist consisting of a
+                        # single node, the argument is the value of the node
+                        _args.append(arg[0].obj)
+                    else:
+                        # This should not be possible as a non-singular query
+                        # would have been rejected when checking function
+                        # well-typedness.
+                        _args.append(arg)
                 else:
                     _args.append(arg)
             return _args

jsonpath/function_extensions/length.py

@@ -1,7 +1,9 @@
 """The standard `length` function extension."""
 from collections.abc import Sized
-from typing import Optional
+from typing import Union
 
+from jsonpath.filter import UNDEFINED
+from jsonpath.filter import _Undefined
 from jsonpath.function_extensions import ExpressionType
 from jsonpath.function_extensions import FilterFunction
 
@@ -12,9 +14,13 @@ class Length(FilterFunction):
     arg_types = [ExpressionType.VALUE]
     return_type = ExpressionType.VALUE
 
-    def __call__(self, obj: Sized) -> Optional[int]:
-        """Return an object's length, or `None` if the object does not have a length."""
+    def __call__(self, obj: Sized) -> Union[int, _Undefined]:
+        """Return an object's length.
+
+        If the object does not have a length, the special _Nothing_ value is
+        returned.
+        """
         try:
             return len(obj)
         except TypeError:
-            return None
+            return UNDEFINED

jsonpath/lex.py

@@ -66,10 +66,34 @@ if TYPE_CHECKING:
 
 
 class Lexer:
-    """Tokenize a JSONPath string."""
+    """Tokenize a JSONPath string.
+
+    Some customization can be achieved by subclassing _Lexer_ and setting
+    class attributes. Then setting `lexer_class` on a `JSONPathEnvironment`.
+
+    Attributes:
+        key_pattern: The regular expression pattern used to match mapping
+            keys/properties.
+        logical_not_pattern: The regular expression pattern used to match
+            logical negation tokens. By default, `not` and `!` are
+            equivalent.
+        logical_and_pattern: The regular expression pattern used to match
+            logical _and_ tokens. By default, `and` and `&&` are equivalent.
+        logical_or_pattern: The regular expression pattern used to match
+            logical _or_ tokens. By default, `or` and `||` are equivalent.
+    """
 
     key_pattern = r"[\u0080-\uFFFFa-zA-Z_][\u0080-\uFFFFa-zA-Z0-9_-]*"
 
+    # `not` or !
+    logical_not_pattern = r"(?:not|!)"
+
+    # && or `and`
+    logical_and_pattern = r"(?:&&|and)"
+
+    # || or `or`
+    logical_or_pattern = r"(?:\|\||or)"
+
     def __init__(self, *, env: JSONPathEnvironment) -> None:
         self.env = env
 
@@ -85,15 +109,6 @@ class Lexer:
             r"(?::\s*(?P<G_LSLICE_STEP>\-?\d*))?"
         )
 
-        # `not` or !
-        self.logical_not_pattern = r"(?:not|!)"
-
-        # && or `and`
-        self.bool_and_pattern = r"(?:&&|and)"
-
-        # || or `or`
-        self.bool_or_pattern = r"(?:\|\||or)"
-
         # /pattern/ or /pattern/flags
         self.re_pattern = r"/(?P<G_RE>.+?)/(?P<G_RE_FLAGS>[aims]*)"
 
@@ -114,8 +129,8 @@ class Lexer:
             (TOKEN_FLOAT, r"-?\d+\.\d*(?:e[+-]?\d+)?"),
             (TOKEN_INT, r"-?\d+(?P<G_EXP>e[+\-]?\d+)?\b"),
             (TOKEN_DDOT, r"\.\."),
-            (TOKEN_AND, self.bool_and_pattern),
-            (TOKEN_OR, self.bool_or_pattern),
+            (TOKEN_AND, self.logical_and_pattern),
+            (TOKEN_OR, self.logical_or_pattern),
             (TOKEN_ROOT, re.escape(self.env.root_token)),
             (TOKEN_SELF, re.escape(self.env.self_token)),
             (TOKEN_KEY, re.escape(self.env.key_token)),

jsonpath/parse.py

@@ -158,7 +158,7 @@ class Parser:
         TOKEN_LG: PRECEDENCE_RELATIONAL,
         TOKEN_LT: PRECEDENCE_RELATIONAL,
         TOKEN_NE: PRECEDENCE_RELATIONAL,
-        TOKEN_NOT: PRECEDENCE_LOGICALRIGHT,
+        TOKEN_NOT: PRECEDENCE_PREFIX,
         TOKEN_OR: PRECEDENCE_LOGICAL,
         TOKEN_RE: PRECEDENCE_RELATIONAL,
         TOKEN_RPAREN: PRECEDENCE_LOWEST,
@@ -180,7 +180,7 @@ class Parser:
         TOKEN_RE: "=~",
     }
 
-    SINGULAR_QUERY_COMPARISON_OPERATORS = frozenset(
+    COMPARISON_OPERATORS = frozenset(
         [
             "==",
             ">=",
@@ -446,6 +446,7 @@ class Parser:
                 )
 
             if stream.peek.kind != TOKEN_RBRACKET:
+                # TODO: error message .. expected a comma or logical operator
                 stream.expect_peek(TOKEN_COMMA)
                 stream.next_token()
 
@@ -499,9 +500,7 @@ class Parser:
         assert tok.kind == TOKEN_NOT
         return PrefixExpression(
             operator="!",
-            right=self.parse_filter_selector(
-                stream, precedence=self.PRECEDENCE_LOGICALRIGHT
-            ),
+            right=self.parse_filter_selector(stream, precedence=self.PRECEDENCE_PREFIX),
         )
 
     def parse_infix_expression(
@@ -512,10 +511,7 @@ class Parser:
         right = self.parse_filter_selector(stream, precedence)
         operator = self.BINARY_OPERATORS[tok.kind]
 
-        self._raise_for_non_singular_query(left, tok)  # TODO: store tok on expression
-        self._raise_for_non_singular_query(right, tok)
-
-        if operator in self.SINGULAR_QUERY_COMPARISON_OPERATORS:
+        if self.env.well_typed and operator in self.COMPARISON_OPERATORS:
             self._raise_for_non_comparable_function(left, tok)
             self._raise_for_non_comparable_function(right, tok)
 
@@ -667,26 +663,18 @@ class Parser:
 
         return token.value
 
-    def _raise_for_non_singular_query(
-        self, expr: FilterExpression, token: Token
-    ) -> None:
-        if (
-            self.env.well_typed
-            and isinstance(expr, Path)
-            and not expr.path.singular_query()
-        ):
-            raise JSONPathSyntaxError(
-                "non-singular query is not comparable", token=token
-            )
-
     def _raise_for_non_comparable_function(
         self, expr: FilterExpression, token: Token
     ) -> None:
-        if not self.env.well_typed or not isinstance(expr, FunctionExtension):
-            return
-        func = self.env.function_extensions.get(expr.name)
-        if (
-            isinstance(func, FilterFunction)
-            and func.return_type != ExpressionType.VALUE
-        ):
-            raise JSONPathTypeError(f"result of {expr.name}() is not comparable", token)
+        if isinstance(expr, Path) and not expr.path.singular_query():
+            raise JSONPathTypeError("non-singular query is not comparable", token=token)
+
+        if isinstance(expr, FunctionExtension):
+            func = self.env.function_extensions.get(expr.name)
+            if (
+                isinstance(func, FilterFunction)
+                and func.return_type != ExpressionType.VALUE
+            ):
+                raise JSONPathTypeError(
+                    f"result of {expr.name}() is not comparable", token
+                )

{python_jsonpath-0.10.1.dist-info → python_jsonpath-0.10.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: python-jsonpath
-Version: 0.10.1
+Version: 0.10.3
 Summary: JSONPath, JSON Pointer and JSON Patch for Python.
 Project-URL: Documentation, https://jg-rp.github.io/python-jsonpath/
 Project-URL: Issues, https://github.com/jg-rp/python-jsonpath/issues
@@ -36,6 +36,9 @@ A flexible JSONPath engine for Python with JSON Pointer and JSON Patch.
   <a href="https://github.com/jg-rp/python-jsonpath/actions">
     <img src="https://img.shields.io/github/actions/workflow/status/jg-rp/python-jsonpath/tests.yaml?branch=main&label=tests&style=flat-square" alt="Tests">
   </a>
+  <a href="https://pypi.org/project/python-jsonpath">
+    <img alt="PyPI - Downloads" src="https://img.shields.io/pypi/dm/python-jsonpath?style=flat-square">
+  </a>
   <br>
   <a href="https://pypi.org/project/python-jsonpath">
     <img src="https://img.shields.io/pypi/v/python-jsonpath.svg?style=flat-square" alt="PyPi - Version">

{python_jsonpath-0.10.1.dist-info → python_jsonpath-0.10.3.dist-info}/RECORD

@@ -1,14 +1,14 @@
-jsonpath/__about__.py,sha256=Q8tvcfeI8V3W2SG92pUmdmY29ZOPlI8LEgmMT73xNoY,133
+jsonpath/__about__.py,sha256=RPhvY8Ls3nFAxAsmj87zrfksIIJaJ6PYlv7USsbgxvg,133
 jsonpath/__init__.py,sha256=VyX-rbLzz-g-2khpIKPE4Xg92LidBatcuNllQkCKl-c,2022
 jsonpath/__main__.py,sha256=6Y5wOE7U-MHymopXOsxofaY30tVZYPGTJO0L4vytoUw,61
 jsonpath/_data.py,sha256=JEpu5Kg0_kgxYKUilBcHVdTmPxf3-Vc0NgaW6olsqyY,577
 jsonpath/cli.py,sha256=scpWfJXl1jLQ80ZyXqMCu8JtRgZUXluC11x6OkC4oeA,10026
 jsonpath/env.py,sha256=uEgcZHkdzdXjbmk_OsaEjK1nTxgaceORI77DYMleOmA,20675
 jsonpath/exceptions.py,sha256=5n-9vaKTu5asWllHT0IN-824ewcNCyQIyKvQ58TERVk,4351
-jsonpath/filter.py,sha256=WWZiyHi5S2LlTXr4wtCD9tW4YXIsV5UeExAq3ISixG0,19840
-jsonpath/lex.py,sha256=yxfAlcARsX7JQIvqghY8WtXWkc2rrI099AIGMLQiur4,9267
+jsonpath/filter.py,sha256=oJ0M2D0UZ_Y5AkcVgaNuvm9P6vB2Gl7JVuyZBjICEG0,20511
+jsonpath/lex.py,sha256=YcNFNiKPEabcFA5A3wmwQj0P5SliSJSZiH9X-xFaQTA,9981
 jsonpath/match.py,sha256=_5ds2mEM0jBmo8uBuLA39o8ulKPs5_QvBQ373RduwGo,3369
-jsonpath/parse.py,sha256=qyYeuL-Ixl0qrZ6THko43OpdjW4sPMCvyEVP87zQxwY,23541
+jsonpath/parse.py,sha256=u3Tw6aWTnhWy19W4RfR_tTi1zEolovGPJHjEi5CUPno,23231
 jsonpath/patch.py,sha256=V_BiRr20qyByBNppBeA0e2I1nfbPJ_svPspDubMzA20,21350
 jsonpath/path.py,sha256=qQrmSfrUn19dNJtFVK6xHw-FTABX6BZpStiWWkR711c,14344
 jsonpath/pointer.py,sha256=YvfNAp5qADiqJGuTE1jvPrtCTVyyDk9rlT2xJB9SjtE,22234
@@ -22,13 +22,13 @@ jsonpath/function_extensions/count.py,sha256=FzTOkOLa01PFFSR1wjkDEOyBr_ZC_6yrNfF
 jsonpath/function_extensions/filter_function.py,sha256=B6z-02xO6CtNghLN92Acr_UmeiWwJaRDLCOTMcPOrfg,834
 jsonpath/function_extensions/is_instance.py,sha256=qm9m3UpKJew7qsuSQ5dEem7Ybo4jhCM1uf12wre0SRg,1760
 jsonpath/function_extensions/keys.py,sha256=vNdIV8xqr1LMG6RLJwb6iA5-VXgYSZu6CqprXEs6rYM,364
-jsonpath/function_extensions/length.py,sha256=8lNCX838dqEQVRgfZduRhN_NsLtBM8JvtxPgPFZ8y-Y,641
+jsonpath/function_extensions/length.py,sha256=Z9gtz0zhzT1_8LzzHm1TRhJlMWT5yEsqNtQCuWg14I0,786
 jsonpath/function_extensions/match.py,sha256=KjsH33fCFGonp2RV__FuaeIOTwLLcvgaaCi0juyEl-U,712
 jsonpath/function_extensions/search.py,sha256=O11fnkHlbvf0QPrLISYfhlPXBvVPBr-U8V0dGbd614Y,710
 jsonpath/function_extensions/typeof.py,sha256=yCAj9zOqSnam1mfHCGolNHWDmsBOvU3rAhbZDYycx50,1780
 jsonpath/function_extensions/value.py,sha256=fQMbPUV87Jn1nOwAlBpTeLmLIG5ejH0XQBOM_SR-Us4,721
-python_jsonpath-0.10.1.dist-info/METADATA,sha256=-UIlWZwpkSRtYphX5XkGcDk8UUKJCGNPgZANDhT6dT4,5004
-python_jsonpath-0.10.1.dist-info/WHEEL,sha256=9QBuHhg6FNW7lppboF2vKVbCGTVzsFykgRQjjlajrhA,87
-python_jsonpath-0.10.1.dist-info/entry_points.txt,sha256=xvbWnAebJyOMI_9ugK0xrpFRlwmEsAJD2kNHU0Dvscc,43
-python_jsonpath-0.10.1.dist-info/licenses/LICENSE.txt,sha256=u7PksAQGI1QYWcERHeauMseZ4XAzDKUrKW8Z4wbeU1k,1101
-python_jsonpath-0.10.1.dist-info/RECORD,,
+python_jsonpath-0.10.3.dist-info/METADATA,sha256=Q9aCV13AWBWjRYXGUX6W8_PUocqCkhsjaDC9LFzvXQA,5169
+python_jsonpath-0.10.3.dist-info/WHEEL,sha256=9QBuHhg6FNW7lppboF2vKVbCGTVzsFykgRQjjlajrhA,87
+python_jsonpath-0.10.3.dist-info/entry_points.txt,sha256=xvbWnAebJyOMI_9ugK0xrpFRlwmEsAJD2kNHU0Dvscc,43
+python_jsonpath-0.10.3.dist-info/licenses/LICENSE.txt,sha256=u7PksAQGI1QYWcERHeauMseZ4XAzDKUrKW8Z4wbeU1k,1101
+python_jsonpath-0.10.3.dist-info/RECORD,,