Metadata-Version: 1.1
Name: jpath-finder
Version: 1.0.1
Summary: An implementation of Json Path for python.
Home-page: https://github.com/wapwallace/jpath_finder
Author: William Alvarez
Author-email: alvarezpw@gmail.com
License: Apache 2.0
Description: Python JSONPath
        =====================================================
        
        An implementation of JsonPath for python with a good performance.
        
        About
        -----
        
        This library was created based on the `<https://github.com/h2non/jsonpath-ng>` library.
        
        The following changes were made in order to improve the execution time and decrease memory usage:
        
        - Refactor in the JsonPath classes.
        - The datum_in_context class was removed.
        - Add new functionality like slice, sum, avg, and, or.
        - The Parser and Lexer method's were changed to static methods.
        - Remove update and filter methods, this library just implement the find method.
        - Add new error classes.
        
        
        Quick Start
        -----------
        
        To install, use pip:
        
        .. code:: bash
        
            $ pip install jpath-finder
        
        
        Usage
        -----
        Basic usage:
        
        .. code:: python
        
            $ python
            >>> from jpath_finder.jpath_parser import find
        
            # find("jsonpath", json_data)
            # Easy way to extract values through jsonpath.
            >>> find("foo[*].baz", {"foo": [{"baz": 1}, {"baz": 2}]})
            [1, 2]
        
            # Also we can use an index '1' from a list or string.
            >>> find("foo[1].baz", {"foo": [{"baz": 1}, {"baz": 2}]})
            [2]
        
            >>> find("foo[1][1:6]", {"foo": ["The example", "String example"]})
            ['tring']
        
            >>> find("foo..baz", {"foo": [{"baz": 1}, {"baz": 2}]})
            [1, 2]
        
            # debug=True if you can log the error.
            # find("jsonpath", json_data, debug=True)
            >>> find("[2]", 123, debug=True)
            JPathNodeError: Invalid Path [2] for 123
            []
        
            # debug=False by default
            # find("jsonpath", json_data)
            >>> find("[2]", 123)
            []
        
            # Note: if you have a custom_logger, it needs a debug method like "custom_logger.debug(message)".
            # find("[2]", 123, logger=custom_logger, debug=True)
        
        
        JSONPath Syntax
        ---------------
        
        +--------------+-------------+----------------------------------------------+
        | name         | Syntax      | Example                                      |
        +==============+=============+==============================================+
        | Root         |"$"          | * $.objects                                  |
        +--------------+-------------+----------------------------------------------+
        | This         |"@"          | * $.objects[?(@.name=="foo")]                |
        +--------------+-------------+----------------------------------------------+
        | Descendant   |".."         | * $.objects..price                           |
        +--------------+-------------+----------------------------------------------+
        | Union        |"|"          | * $.objects_1 | $.objects_2                  |
        +--------------+-------------+----------------------------------------------+
        | Fields       |[0-9a-zA-Z]  | * $.objects.price.value                      |
        +--------------+-------------+----------------------------------------------+
        | Index        |[0-9]        | * $.objects[3].value                         |
        +--------------+-------------+----------------------------------------------+
        | AllIndex     |"[*]"        | * $.objects[*].cost                          |
        +--------------+-------------+----------------------------------------------+
        | Slice        |"[2:6:2]"    | * $.objects[2:20:3].cost                     |
        +--------------+-------------+----------------------------------------------+
        | Sorted       |"`sorted`"   | * $.objects.`sorted`                         |
        +--------------+-------------+----------------------------------------------+
        | len          |"`len`"      | * $.objects.`len`                            |
        +--------------+-------------+----------------------------------------------+
        | sum          |"`sum`"      | * $.objects.`sum`                            |
        +--------------+-------------+----------------------------------------------+
        | avg          |"`avg`"      | * $.objects.`avg`                            |
        +--------------+-------------+----------------------------------------------+
        | filter       |"[?(expr)]"  | * $.objects[?(@some_field > 5)]              |
        |              |             | * $.objects[?(some_field = "foobar")]        |
        |              |             | * $.objects[?(some_field != "foobar")]       |
        |              |             | * $.objects[?(some_field>5&other<2|other=3)] |
        +--------------+-------------+----------------------------------------------+
        | arithmetic   |"+"          | - $.foo + "_" + $.bar                        |
        |              |"*"          | - $.foo * 12                                 |
        |              |             | - $.objects[*].cow + $.objects[*].cat        |
        +--------------+-------------+----------------------------------------------+
        
        
        Contributors
        ------------
        
        This package is authored and maintained by:
        
        -  `William Alvarez <https://github.com/wapwallace>`
        
        
        Copyright and License
        ---------------------
        
        Copyright 2013 - Kenneth Knowles
        
        Copyright 2017 - Tomas Aparicio
        
        Copyright 2020 - William Alvarez
        
        Licensed under the Apache License, Version 2.0 (the "License"); you may
        not use this file except in compliance with the License. You may obtain
        a copy of the License at
        
        ::
        
            http://www.apache.org/licenses/LICENSE-2.0
        
        Unless required by applicable law or agreed to in writing, software
        distributed under the License is distributed on an "AS IS" BASIS,
        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
        See the License for the specific language governing permissions and
        limitations under the License.
        
Keywords: jpath_finder
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.7
