Metadata-Version: 2.1
Name: JSONPath-Lite
Version: 0.0.4
Summary: A light weight json path utility for Python
Home-page: https://github.com/StephenDiscenza/jsonpath-lite-for-python
Author: Steve Discenza
Author-email: stephendiscenza@gmail.com
Project-URL: Bug Tracker, https://github.com/StephenDiscenza/jsonpath-lite-for-python/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.0
Description-Content-Type: text/markdown
License-File: LICENSE

# jsonpath-lite
A very light weight utility which parses and uses JSONPath expressions for simple interactions with the Python data structures representing a JSON document.

## Usage
Say you have this JSON:
```
{
    "Things": [
        {
            "Name": "Thing1",
            "Value": "Dog"
        }
    ]
}
```
If you want to get the value of a Thing Named Thing1:  
`get_json_item(JSON Document, '$.Things[?Name="Thing1"].Value')`

If you want to update the value of the Thing Named Thing1 to Cat:  
`update_json_element(JSON Document, '$.Things[?Name="Thing1"].Value', 'Cat')`

If you want to add a new Thing:  
`write_new_json_element(JSON Document, '$.Things', {"Name": "Thing2", "Value": "Manbearpig"})`  
The arguments are: the JSON like object, path to the location of the new item, value of the new item, name of the new item.  
Note that a value is not supplied for newElementName since we are adding a new item to a list (array).

If you want to add a new field to one of the Things:  
`write_new_json_element(JSON Document, $.Things[?Name="Thing1"], True, "IsAGoodBoy")`

## Installation
With pip:
`pip install JSONPath-Lite`  
Otherwise you can just grab the JSONPathLite package from this repo and import it in your project. 

## Notes
This project came to be out of a need to find and manipulate specific pieces of data within a large highly nested JSON structure. As such, it is designed to stop searching and return the first match for a given path. The functionality of returning all matches for a given path will be added at some point in the future. 
