GitLocker: The Coding Marketplace

Description:

jpathfinder 1.0.1

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:
$ pip install jpath-finder

Usage
Basic usage:
$ 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
“|”

.objects1|.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.