python-jsonpath 1.3.2__tar.gz → 2.0.1__tar.gz

{python_jsonpath-1.3.2 → python_jsonpath-2.0.1}/.gitignore

@@ -78,7 +78,9 @@ ENV/
 # IDE
 .vscode/
 .idea/
-python-jsonpath.iml
+*.iml
+*.ipr
+.junie
 
 # Dev utils
 dev.py

{python_jsonpath-1.3.2 → python_jsonpath-2.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-jsonpath
-Version: 1.3.2
+Version: 2.0.1
 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
@@ -8,6 +8,7 @@ Project-URL: Source, https://github.com/jg-rp/python-jsonpath
 Author-email: James Prior <jamesgr.prior@gmail.com>
 License-Expression: MIT
 License-File: LICENSE.txt
+Keywords: JSON,JSON Patch,JSON Path,JSON Pointer,JSONPath,RFC 9535
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -21,6 +22,9 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
 Requires-Python: >=3.8
+Provides-Extra: strict
+Requires-Dist: iregexp-check>=0.1.4; extra == 'strict'
+Requires-Dist: regex; extra == 'strict'
 Description-Content-Type: text/markdown
 
 <h1 align="center">Python JSONPath</h1>
@@ -91,9 +95,9 @@ conda install -c conda-forge python-jsonpath
 
 ## Related projects
 
-- [JSONPath RFC 9535](https://github.com/jg-rp/python-jsonpath-rfc9535) - A Python implementation of JSONPath that follows RFC 9535 much more strictly. If you require maximum interoperability with JSONPath implemented in other languages - at the expense of extra features - choose [jsonpath-rfc9535](https://pypi.org/project/jsonpath-rfc9535/) over [python-jsonpath](https://pypi.org/project/python-jsonpath/).
+- [JSONPath RFC 9535](https://github.com/jg-rp/python-jsonpath-rfc9535) - A minimal, slightly cleanr Python implementation of RFC 9535. If you're not interested JSONPath sytax beyond that defined in RFC 9535, you might choose [jsonpath-rfc9535](https://pypi.org/project/jsonpath-rfc9535/) over [python-jsonpath](https://pypi.org/project/python-jsonpath/).
 
-  jsonpath-rfc9535 matches RFC 9535's JSONPath model internally and is careful to use the spec's terminology. It also includes utilities for verifying and testing the [JSONPath Compliance Test Suite](https://github.com/jsonpath-standard/jsonpath-compliance-test-suite). Most notably the nondeterministic behavior of some JSONPath selectors.
+  jsonpath-rfc9535 also includes utilities for verifying and testing the [JSONPath Compliance Test Suite](https://github.com/jsonpath-standard/jsonpath-compliance-test-suite). Most notably the nondeterministic behavior of some JSONPath selectors.
 
 - [JSON P3](https://github.com/jg-rp/json-p3) - RFC 9535 implemented in TypeScript. JSON P3 does not include all the non-standard features of Python JSONPath, but does define some optional [extra syntax](https://jg-rp.github.io/json-p3/guides/jsonpath-extra).
 

{python_jsonpath-1.3.2 → python_jsonpath-2.0.1}/README.md

@@ -66,9 +66,9 @@ conda install -c conda-forge python-jsonpath
 
 ## Related projects
 
-- [JSONPath RFC 9535](https://github.com/jg-rp/python-jsonpath-rfc9535) - A Python implementation of JSONPath that follows RFC 9535 much more strictly. If you require maximum interoperability with JSONPath implemented in other languages - at the expense of extra features - choose [jsonpath-rfc9535](https://pypi.org/project/jsonpath-rfc9535/) over [python-jsonpath](https://pypi.org/project/python-jsonpath/).
+- [JSONPath RFC 9535](https://github.com/jg-rp/python-jsonpath-rfc9535) - A minimal, slightly cleanr Python implementation of RFC 9535. If you're not interested JSONPath sytax beyond that defined in RFC 9535, you might choose [jsonpath-rfc9535](https://pypi.org/project/jsonpath-rfc9535/) over [python-jsonpath](https://pypi.org/project/python-jsonpath/).
 
-  jsonpath-rfc9535 matches RFC 9535's JSONPath model internally and is careful to use the spec's terminology. It also includes utilities for verifying and testing the [JSONPath Compliance Test Suite](https://github.com/jsonpath-standard/jsonpath-compliance-test-suite). Most notably the nondeterministic behavior of some JSONPath selectors.
+  jsonpath-rfc9535 also includes utilities for verifying and testing the [JSONPath Compliance Test Suite](https://github.com/jsonpath-standard/jsonpath-compliance-test-suite). Most notably the nondeterministic behavior of some JSONPath selectors.
 
 - [JSON P3](https://github.com/jg-rp/json-p3) - RFC 9535 implemented in TypeScript. JSON P3 does not include all the non-standard features of Python JSONPath, but does define some optional [extra syntax](https://jg-rp.github.io/json-p3/guides/jsonpath-extra).
 

{python_jsonpath-1.3.2 → python_jsonpath-2.0.1}/jsonpath/__about__.py

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

python_jsonpath-2.0.1/jsonpath/__init__.py

@@ -0,0 +1,365 @@
+# SPDX-FileCopyrightText: 2023-present James Prior <jamesgr.prior@gmail.com>
+#
+# SPDX-License-Identifier: MIT
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+from typing import AsyncIterable
+from typing import Iterable
+from typing import List
+from typing import Optional
+from typing import Union
+
+from ._types import JSON
+from ._types import JSONData
+from ._types import JSONScalar
+from .env import JSONPathEnvironment
+from .exceptions import JSONPatchError
+from .exceptions import JSONPatchTestFailure
+from .exceptions import JSONPathError
+from .exceptions import JSONPathIndexError
+from .exceptions import JSONPathNameError
+from .exceptions import JSONPathSyntaxError
+from .exceptions import JSONPathTypeError
+from .exceptions import JSONPointerError
+from .exceptions import JSONPointerIndexError
+from .exceptions import JSONPointerKeyError
+from .exceptions import JSONPointerResolutionError
+from .exceptions import JSONPointerTypeError
+from .exceptions import RelativeJSONPointerError
+from .exceptions import RelativeJSONPointerIndexError
+from .exceptions import RelativeJSONPointerSyntaxError
+from .filter import UNDEFINED
+from .fluent_api import Projection
+from .fluent_api import Query
+from .lex import Lexer
+from .match import JSONPathMatch
+from .match import NodeList
+from .parse import Parser
+from .patch import JSONPatch
+from .path import CompoundJSONPath
+from .path import JSONPath
+from .pointer import JSONPointer
+from .pointer import RelativeJSONPointer
+from .pointer import resolve
+
+if TYPE_CHECKING:
+    from .match import FilterContextVars
+
+
+__all__ = (
+    "compile",
+    "CompoundJSONPath",
+    "findall_async",
+    "findall",
+    "finditer_async",
+    "finditer",
+    "JSONPatch",
+    "JSONPatchError",
+    "JSONPatchTestFailure",
+    "JSONPath",
+    "JSONPathEnvironment",
+    "JSONPathError",
+    "JSONPathIndexError",
+    "JSONPathMatch",
+    "JSONPathNameError",
+    "JSONPathSyntaxError",
+    "JSONPathTypeError",
+    "JSONPointer",
+    "JSONPointerError",
+    "JSONPointerIndexError",
+    "JSONPointerKeyError",
+    "JSONPointerResolutionError",
+    "JSONPointerTypeError",
+    "Lexer",
+    "NodeList",
+    "match",
+    "Parser",
+    "Projection",
+    "query",
+    "Query",
+    "RelativeJSONPointer",
+    "RelativeJSONPointerError",
+    "RelativeJSONPointerIndexError",
+    "RelativeJSONPointerSyntaxError",
+    "resolve",
+    "JSON",
+    "JSONData",
+    "JSONScalar",
+    "UNDEFINED",
+)
+
+
+# For convenience and to delegate to strict or non-strict environments.
+DEFAULT_ENV = JSONPathEnvironment()
+_STRICT_ENV = JSONPathEnvironment(strict=True)
+
+
+def compile(path: str, *, strict: bool = False) -> Union[JSONPath, CompoundJSONPath]:  # noqa: A001
+    """Prepare a path string ready for repeated matching against different data.
+
+    Arguments:
+        path: A JSONPath as a string.
+        strict: When `True`, compile the path for strict compliance with RFC 9535.
+
+    Returns:
+        A `JSONPath` or `CompoundJSONPath`, ready to match against some data.
+            Expect a `CompoundJSONPath` if the path string uses the _union_ or
+            _intersection_ operators.
+
+    Raises:
+        JSONPathSyntaxError: If _path_ is invalid.
+        JSONPathTypeError: If filter functions are given arguments of an
+            unacceptable type.
+    """
+    return _STRICT_ENV.compile(path) if strict else DEFAULT_ENV.compile(path)
+
+
+def findall(
+    path: str,
+    data: JSONData,
+    *,
+    filter_context: Optional[FilterContextVars] = None,
+    strict: bool = False,
+) -> List[object]:
+    """Find all objects in _data_ matching the JSONPath _path_.
+
+    If _data_ is a string or a file-like objects, it will be loaded
+    using `json.loads()` and the default `JSONDecoder`.
+
+    Arguments:
+        path: The JSONPath as a string.
+        data: A JSON document or Python object implementing the `Sequence`
+            or `Mapping` interfaces.
+        filter_context: Arbitrary data made available to filters using
+            the _filter context_ selector.
+        strict: When `True`, compile and evaluate with strict compliance with
+            RFC 9535.
+
+    Returns:
+        A list of matched objects. If there are no matches, the list will
+            be empty.
+
+    Raises:
+        JSONPathSyntaxError: If the path is invalid.
+        JSONPathTypeError: If a filter expression attempts to use types in
+            an incompatible way.
+    """
+    return (
+        _STRICT_ENV.findall(path, data, filter_context=filter_context)
+        if strict
+        else DEFAULT_ENV.findall(path, data, filter_context=filter_context)
+    )
+
+
+async def findall_async(
+    path: str,
+    data: JSONData,
+    *,
+    filter_context: Optional[FilterContextVars] = None,
+    strict: bool = False,
+) -> List[object]:
+    """Find all objects in _data_ matching the JSONPath _path_.
+
+    If _data_ is a string or a file-like objects, it will be loaded
+    using `json.loads()` and the default `JSONDecoder`.
+
+    Arguments:
+        path: The JSONPath as a string.
+        data: A JSON document or Python object implementing the `Sequence`
+            or `Mapping` interfaces.
+        filter_context: Arbitrary data made available to filters using
+            the _filter context_ selector.
+        strict: When `True`, compile and evaluate with strict compliance with
+            RFC 9535.
+
+    Returns:
+        A list of matched objects. If there are no matches, the list will
+            be empty.
+
+    Raises:
+        JSONPathSyntaxError: If the path is invalid.
+        JSONPathTypeError: If a filter expression attempts to use types in
+            an incompatible way.
+    """
+    return (
+        await _STRICT_ENV.findall_async(path, data, filter_context=filter_context)
+        if strict
+        else await DEFAULT_ENV.findall_async(path, data, filter_context=filter_context)
+    )
+
+
+def finditer(
+    path: str,
+    data: JSONData,
+    *,
+    filter_context: Optional[FilterContextVars] = None,
+    strict: bool = False,
+) -> Iterable[JSONPathMatch]:
+    """Generate `JSONPathMatch` objects for each match of _path_ in _data_.
+
+    If _data_ is a string or a file-like objects, it will be loaded using
+    `json.loads()` and the default `JSONDecoder`.
+
+    Arguments:
+        path: The JSONPath as a string.
+        data: A JSON document or Python object implementing the `Sequence`
+            or `Mapping` interfaces.
+        filter_context: Arbitrary data made available to filters using
+            the _filter context_ selector.
+        strict: When `True`, compile and evaluate with strict compliance with
+            RFC 9535.
+
+    Returns:
+        An iterator yielding `JSONPathMatch` objects for each match.
+
+    Raises:
+        JSONPathSyntaxError: If the path is invalid.
+        JSONPathTypeError: If a filter expression attempts to use types in
+            an incompatible way.
+    """
+    return (
+        _STRICT_ENV.finditer(path, data, filter_context=filter_context)
+        if strict
+        else DEFAULT_ENV.finditer(path, data, filter_context=filter_context)
+    )
+
+
+async def finditer_async(
+    path: str,
+    data: JSONData,
+    *,
+    filter_context: Optional[FilterContextVars] = None,
+    strict: bool = False,
+) -> AsyncIterable[JSONPathMatch]:
+    """Find all objects in _data_ matching the JSONPath _path_.
+
+    If _data_ is a string or a file-like objects, it will be loaded
+    using `json.loads()` and the default `JSONDecoder`.
+
+    Arguments:
+        path: The JSONPath as a string.
+        data: A JSON document or Python object implementing the `Sequence`
+            or `Mapping` interfaces.
+        filter_context: Arbitrary data made available to filters using
+            the _filter context_ selector.
+        strict: When `True`, compile and evaluate with strict compliance with
+            RFC 9535.
+
+    Returns:
+        A list of matched objects. If there are no matches, the list will
+            be empty.
+
+    Raises:
+        JSONPathSyntaxError: If the path is invalid.
+        JSONPathTypeError: If a filter expression attempts to use types in
+            an incompatible way.
+    """
+    return (
+        await _STRICT_ENV.finditer_async(path, data, filter_context=filter_context)
+        if strict
+        else await DEFAULT_ENV.finditer_async(path, data, filter_context=filter_context)
+    )
+
+
+def match(
+    path: str,
+    data: JSONData,
+    *,
+    filter_context: Optional[FilterContextVars] = None,
+    strict: bool = False,
+) -> Union[JSONPathMatch, None]:
+    """Return a `JSONPathMatch` instance for the first object found in _data_.
+
+    `None` is returned if there are no matches.
+
+    Arguments:
+        path: The JSONPath as a string.
+        data: A JSON document or Python object implementing the `Sequence`
+            or `Mapping` interfaces.
+        filter_context: Arbitrary data made available to filters using
+            the _filter context_ selector.
+        strict: When `True`, compile and evaluate with strict compliance with
+            RFC 9535.
+
+    Returns:
+        A `JSONPathMatch` object for the first match, or `None` if there were
+            no matches.
+
+    Raises:
+        JSONPathSyntaxError: If the path is invalid.
+        JSONPathTypeError: If a filter expression attempts to use types in
+            an incompatible way.
+    """
+    return (
+        _STRICT_ENV.match(path, data, filter_context=filter_context)
+        if strict
+        else DEFAULT_ENV.match(path, data, filter_context=filter_context)
+    )
+
+
+def query(
+    path: str,
+    data: JSONData,
+    *,
+    filter_context: Optional[FilterContextVars] = None,
+    strict: bool = False,
+) -> Query:
+    """Return a `Query` iterator over matches found by applying _path_ to _data_.
+
+    `Query` objects are iterable.
+
+    ```
+    for match in jsonpath.query("$.foo..bar", data):
+        ...
+    ```
+
+    You can skip and limit results with `Query.skip()` and `Query.limit()`.
+
+    ```
+    matches = (
+        jsonpath.query("$.foo..bar", data)
+        .skip(5)
+        .limit(10)
+    )
+
+    for match in matches
+        ...
+    ```
+
+    `Query.tail()` will get the last _n_ results.
+
+    ```
+    for match in jsonpath.query("$.foo..bar", data).tail(5):
+        ...
+    ```
+
+    Get values for each match using `Query.values()`.
+
+    ```
+    for obj in jsonpath.query("$.foo..bar", data).limit(5).values():
+        ...
+    ```
+
+    Arguments:
+        path: The JSONPath as a string.
+        data: A JSON document or Python object implementing the `Sequence`
+            or `Mapping` interfaces.
+        filter_context: Arbitrary data made available to filters using
+            the _filter context_ selector.
+        strict: When `True`, compile and evaluate with strict compliance with
+            RFC 9535.
+
+    Returns:
+        A query iterator.
+
+    Raises:
+        JSONPathSyntaxError: If the path is invalid.
+        JSONPathTypeError: If a filter expression attempts to use types in
+            an incompatible way.
+    """
+    return (
+        _STRICT_ENV.query(path, data, filter_context=filter_context)
+        if strict
+        else DEFAULT_ENV.query(path, data, filter_context=filter_context)
+    )

python_jsonpath-2.0.1/jsonpath/_types.py

@@ -0,0 +1,31 @@
+from __future__ import annotations
+
+from io import IOBase
+from typing import Any
+from typing import Mapping
+from typing import Sequence
+from typing import Union
+
+JSONScalar = Union[str, int, float, bool, None]
+"""A scalar JSON-like value.
+
+This includes primitive types that can appear in JSON:
+string, number, boolean, or null.
+"""
+
+JSON = Union[JSONScalar, Sequence[Any], Mapping[str, Any]]
+"""A JSON-like data structure.
+
+This covers scalars, sequences (e.g. lists, tuples), and mappings (e.g.
+dictionaries with string keys). Values inside may be untyped (`Any`) rather
+than recursively constrained to `JSON` for flexibility.
+"""
+
+JSONData = Union[str, IOBase, JSON]
+"""Input representing JSON content.
+
+Accepts:
+- a JSON-like object (`JSON`),
+- a raw JSON string,
+- or a file-like object containing JSON data.
+"""

{python_jsonpath-1.3.2 → python_jsonpath-2.0.1}/jsonpath/cli.py

@@ -1,4 +1,5 @@
 """JSONPath, JSON Pointer and JSON Patch command line interface."""
+
 import argparse
 import json
 import sys
@@ -59,6 +60,15 @@ def path_sub_command(parser: argparse.ArgumentParser) -> None:  # noqa: D103
         help="Disables filter expression well-typedness checks.",
     )
 
+    parser.add_argument(
+        "--strict",
+        action="store_true",
+        help=(
+            "Compile and evaluate JSONPath expressions with strict "
+            "compliance with RFC 9535."
+        ),
+    )
+
 
 def pointer_sub_command(parser: argparse.ArgumentParser) -> None:  # noqa: D103
     parser.set_defaults(func=handle_pointer_command)
@@ -248,6 +258,7 @@ def handle_path_command(args: argparse.Namespace) -> None:  # noqa: PLR0912
         path = jsonpath.JSONPathEnvironment(
             unicode_escape=not args.no_unicode_escape,
             well_typed=not args.no_type_checks,
+            strict=args.strict,
         ).compile(query)
     except JSONPathSyntaxError as err:
         if args.debug:
@@ -289,7 +300,6 @@ def handle_pointer_command(args: argparse.Namespace) -> None:
     if args.pointer is not None:
         pointer = args.pointer
     else:
-        # TODO: is a property with a trailing newline OK?
         pointer = args.pointer_file.read().strip()
 
     try: