json-duplicate-keys 2024.2.21__tar.gz → 2024.4.20__tar.gz

json-duplicate-keys-2024.4.20/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 TP Cyber Security
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

json-duplicate-keys-2024.4.20/MANIFEST.in

@@ -0,0 +1 @@
+include requirements.txt

{json-duplicate-keys-2024.2.21 → json-duplicate-keys-2024.4.20}/PKG-INFO

@@ -1,21 +1,21 @@
 Metadata-Version: 2.1
 Name: json-duplicate-keys
-Version: 2024.2.21
+Version: 2024.4.20
 Summary: Flatten/ Unflatten and Load(s)/ Dump(s) JSON File/ Object with Duplicate Keys
 Home-page: https://github.com/truocphan/json-duplicate-keys
 Author: TP Cyber Security
 Author-email: tpcybersec2023@gmail.com
 License: MIT
-Description: # JSON Duplicate Keys
+Description: # JSON Duplicate Keys - PyPI
         Flatten/ Unflatten and Load(s)/ Dump(s) JSON File/ Object with Duplicate Keys
         
         <p align="center">
-            <a href="https://github.com/truocphan/json_duplicate_keys/releases/"><img src="https://img.shields.io/github/release/truocphan/json_duplicate_keys" height=30></a>
-        	<a href="#"><img src="https://img.shields.io/github/downloads/truocphan/json_duplicate_keys/total" height=30></a>
-        	<a href="#"><img src="https://img.shields.io/github/stars/truocphan/json_duplicate_keys" height=30></a>
-        	<a href="#"><img src="https://img.shields.io/github/forks/truocphan/json_duplicate_keys" height=30></a>
-        	<a href="https://github.com/truocphan/json_duplicate_keys/issues?q=is%3Aopen+is%3Aissue"><img src="https://img.shields.io/github/issues/truocphan/json_duplicate_keys" height=30></a>
-        	<a href="https://github.com/truocphan/json_duplicate_keys/issues?q=is%3Aissue+is%3Aclosed"><img src="https://img.shields.io/github/issues-closed/truocphan/json_duplicate_keys" height=30></a>
+            <a href="https://github.com/truocphan/json-duplicate-keys/releases/"><img src="https://img.shields.io/github/release/truocphan/json-duplicate-keys" height=30></a>
+        	<a href="#"><img src="https://img.shields.io/github/downloads/truocphan/json-duplicate-keys/total" height=30></a>
+        	<a href="#"><img src="https://img.shields.io/github/stars/truocphan/json-duplicate-keys" height=30></a>
+        	<a href="#"><img src="https://img.shields.io/github/forks/truocphan/json-duplicate-keys" height=30></a>
+        	<a href="https://github.com/truocphan/json-duplicate-keys/issues?q=is%3Aopen+is%3Aissue"><img src="https://img.shields.io/github/issues/truocphan/json-duplicate-keys" height=30></a>
+        	<a href="https://github.com/truocphan/json-duplicate-keys/issues?q=is%3Aissue+is%3Aclosed"><img src="https://img.shields.io/github/issues-closed/truocphan/json-duplicate-keys" height=30></a>
         	<a href="https://pypi.org/project/json-duplicate-keys/" target="_blank"><img src="https://img.shields.io/badge/pypi-3775A9?style=for-the-badge&logo=pypi&logoColor=white" height=30></a>
         	<a href="https://www.facebook.com/61550595106970" target="_blank"><img src="https://img.shields.io/badge/Facebook-1877F2?style=for-the-badge&logo=facebook&logoColor=white" height=30></a>
         	<a href="https://twitter.com/TPCyberSec" target="_blank"><img src="https://img.shields.io/badge/Twitter-1DA1F2?style=for-the-badge&logo=twitter&logoColor=white" height=30></a>
@@ -265,6 +265,27 @@ Description: # JSON Duplicate Keys
         ```
         ---
         
+        ### JSON_DUPLICATE_KEYS.filter_values(`value`, `separator`="||", `parse_index`="$", `ordered_dict`=False)
+        
+        - `value`:
+        - `separator`:
+        - `parse_index`:
+        - `ordered_dict`:
+        ```python
+        import json_duplicate_keys as jdks
+        
+        Jstr = '{"author": "truocphan", "version": "22.3.3", "version": "latest", "release": [{"version": "latest"}], "snapshot": {"author": "truocphan", "version": "22.3.3", "release": [{"version": "latest"}]}}'
+        
+        JDKSObject = jdks.loads(Jstr)
+        
+        print(JDKSObject.filter_values("latest").dumps())
+        # OUTPUT: {"version": "latest", "release||$0$||version": "latest", "snapshot||release||$0$||version": "latest"}
+        
+        print(JDKSObject.dumps())
+        # OUTPUT: {"author": "truocphan", "version": "22.3.3", "version": "latest", "release": [{"version": "latest"}], "snapshot": {"author": "truocphan", "version": "22.3.3", "release": [{"version": "latest"}]}}
+        ```
+        ---
+        
         ### JSON_DUPLICATE_KEYS.dumps(`dupSign_start`="{{{", `dupSign_end`="}}}", `_isDebug_`=False, `skipkeys`=False, `ensure_ascii`=True, `check_circular`=True, `allow_nan`=True, `cls`=None, `indent`=None, `separators`=None, `default`=None, `sort_keys`=False)
         _Serialize a JSON object to a JSON format string_
         - `dupSign_start`: 
@@ -364,6 +385,15 @@ Description: # JSON Duplicate Keys
         print(JDKSObject.getObject())
         # OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': 'latest', 'release': [{'version': 'latest'}], 'snapshot': {'author': 'truocphan', 'version': '22.3.3', 'release': [{'version': 'latest'}]}}
         ```
+        ---
+        
+        ## CHANGELOG
+        #### [json-duplicate-keys v2024.4.20](https://github.com/truocphan/json-duplicate-keys/tree/2024.4.20)
+        - **New**: _filter_values_
+        - **Updated**: _filter_keys_
+        
+        #### [json-duplicate-keys v2024.3.24](https://github.com/truocphan/json-duplicate-keys/tree/2024.3.24)
+        - **Updated**: _normalize_key_, _loads_, _get_, _set_, _update_, _delete_
         ---
 Keywords: TPCyberSec,json,duplicate keys,json duplicate keys,flatten,unflatten
 Platform: UNKNOWN

json-duplicate-keys-2024.4.20/README.md

@@ -0,0 +1,389 @@
+# JSON Duplicate Keys - PyPI
+Flatten/ Unflatten and Load(s)/ Dump(s) JSON File/ Object with Duplicate Keys
+
+<p align="center">
+    <a href="https://github.com/truocphan/json-duplicate-keys/releases/"><img src="https://img.shields.io/github/release/truocphan/json-duplicate-keys" height=30></a>
+	<a href="#"><img src="https://img.shields.io/github/downloads/truocphan/json-duplicate-keys/total" height=30></a>
+	<a href="#"><img src="https://img.shields.io/github/stars/truocphan/json-duplicate-keys" height=30></a>
+	<a href="#"><img src="https://img.shields.io/github/forks/truocphan/json-duplicate-keys" height=30></a>
+	<a href="https://github.com/truocphan/json-duplicate-keys/issues?q=is%3Aopen+is%3Aissue"><img src="https://img.shields.io/github/issues/truocphan/json-duplicate-keys" height=30></a>
+	<a href="https://github.com/truocphan/json-duplicate-keys/issues?q=is%3Aissue+is%3Aclosed"><img src="https://img.shields.io/github/issues-closed/truocphan/json-duplicate-keys" height=30></a>
+	<a href="https://pypi.org/project/json-duplicate-keys/" target="_blank"><img src="https://img.shields.io/badge/pypi-3775A9?style=for-the-badge&logo=pypi&logoColor=white" height=30></a>
+	<a href="https://www.facebook.com/61550595106970" target="_blank"><img src="https://img.shields.io/badge/Facebook-1877F2?style=for-the-badge&logo=facebook&logoColor=white" height=30></a>
+	<a href="https://twitter.com/TPCyberSec" target="_blank"><img src="https://img.shields.io/badge/Twitter-1DA1F2?style=for-the-badge&logo=twitter&logoColor=white" height=30></a>
+	<a href="https://github.com/truocphan" target="_blank"><img src="https://img.shields.io/badge/GitHub-100000?style=for-the-badge&logo=github&logoColor=white" height=30></a>
+	<a href="mailto:tpcybersec2023@gmail.com" target="_blank"><img src="https://img.shields.io/badge/Gmail-D14836?style=for-the-badge&logo=gmail&logoColor=white" height=30></a>
+	<a href="https://www.buymeacoffee.com/truocphan" target="_blank"><img src="https://img.shields.io/badge/Buy_Me_A_Coffee-FFDD00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=black" height=30></a>
+</p>
+
+## Installation
+#### From PyPI:
+```console
+pip install json-duplicate-keys
+```
+#### From Source:
+```console
+git clone https://github.com/truocphan/json-duplicate-keys.git --branch <Branch/Tag>
+cd json-duplicate-keys
+python setup.py build
+python setup.py install
+```
+
+## Basic Usage
+### normalize_key(`name`, `dupSign_start`="{{{", `dupSign_end`="}}}", `_isDebug_`=False)
+_Normalize Key name_
+- `name`: key name
+- `dupSign_start`: 
+- `dupSign_end`: 
+- `_isDebug_`: Show/ Hide debug error messages
+```python
+import json_duplicate_keys as jdks
+
+print(jdks.normalize_key("version{{{_2_}}}"))
+# OUTPUT: version
+```
+---
+
+### loads(`Jstr`, `dupSign_start`="{{{", `dupSign_end`="}}}", `ordered_dict`=False, `_isDebug_`=False)
+_Deserialize a JSON format string to a class `JSON_DUPLICATE_KEYS`_
+- `Jstr`: a JSON format string
+- `dupSign_start`: 
+- `dupSign_end`: 
+- `ordered_dict`: preserves the order in which the Keys are inserted
+- `_isDebug_`: Show/ Hide debug error messages
+```python
+import json_duplicate_keys as jdks
+
+Jstr = '{"author": "truocphan", "version": "22.3.3", "version": "latest", "release": [{"version": "latest"}], "snapshot": {"author": "truocphan", "version": "22.3.3", "release": [{"version": "latest"}]}}'
+
+JDKSObject = jdks.loads(Jstr)
+
+print(JDKSObject)
+# OUTPUT: <json_duplicate_keys.JSON_DUPLICATE_KEYS object at 0x00000270AE987940>
+```
+---
+
+### load(`Jfilepath`, `dupSign_start`="{{{", `dupSign_end`="}}}", `ordered_dict`=False, `_isDebug_`=False)
+_Deserialize a JSON format string from a file to a class `JSON_DUPLICATE_KEYS`_
+- `Jfilepath`: The path to the file containing the JSON format string
+- `dupSign_start`: 
+- `dupSign_end`: 
+- `ordered_dict`: preserves the order in which the Keys are inserted
+- `_isDebug_`: Show/ Hide debug error messages
+```python
+# /path/to/file.json: {"author": "truocphan", "version": "22.3.3", "version": "latest", "release": [{"version": "latest"}], "snapshot": {"author": "truocphan", "version": "22.3.3", "release": [{"version": "latest"}]}}
+
+import json_duplicate_keys as jdks
+
+Jfilepath = "/path/to/file.json"
+
+JDKSObject = jdks.load(Jfilepath)
+
+print(JDKSObject)
+# OUTPUT: <json_duplicate_keys.JSON_DUPLICATE_KEYS object at 0x00000270AE986D40>
+```
+---
+
+### JSON_DUPLICATE_KEYS.getObject()
+_Get the JSON object_
+```python
+import json_duplicate_keys as jdks
+
+Jstr = '{"author": "truocphan", "version": "22.3.3", "version": "latest", "release": [{"version": "latest"}], "snapshot": {"author": "truocphan", "version": "22.3.3", "release": [{"version": "latest"}]}}'
+
+JDKSObject = jdks.loads(Jstr)
+
+print(JDKSObject.getObject())
+# OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': 'latest', 'release': [{'version': 'latest'}], 'snapshot': {'author': 'truocphan', 'version': '22.3.3', 'release': [{'version': 'latest'}]}}
+```
+---
+
+### JSON_DUPLICATE_KEYS.get(`name`, `separator`="||", `parse_index`="$", `_isDebug_`=False)
+_Get value in the JSON object by `name`_
+- `name`: the key name of the JSON object. Supported flatten key name format
+- `separator`: 
+- `parse_index`:
+- `_isDebug_`: Show/ Hide debug error messages
+```python
+import json_duplicate_keys as jdks
+
+Jstr = '{"author": "truocphan", "version": "22.3.3", "version": "latest", "release": [{"version": "latest"}], "snapshot": {"author": "truocphan", "version": "22.3.3", "release": [{"version": "latest"}]}}'
+
+JDKSObject = jdks.loads(Jstr)
+
+print(JDKSObject.get("version{{{_2_}}}"))
+# OUTPUT: latest
+
+print(JDKSObject.get("release||$0$"))
+# OUTPUT: {'version': 'latest'}
+
+print(JDKSObject.get("snapshot||author"))
+# OUTPUT: truocphan
+```
+---
+
+### JSON_DUPLICATE_KEYS.set(`name`, `value`, `separator`="||", `parse_index`="$", `dupSign_start`="{{{", `dupSign_end`="}}}", `ordered_dict`=False, `_isDebug_`=False)
+_Set a new `name` and `value` for the JSON object_
+- `name`: new key name for the JSON object. Supported flat key name format
+- `value`: value for key `name`
+- `separator`: 
+- `parse_index`: 
+- `dupSign_start`: 
+- `dupSign_end`: 
+- `ordered_dict`: preserves the order in which the Keys are inserted
+- `_isDebug_`: Show/Hide debug error messages
+```python
+import json_duplicate_keys as jdks
+
+Jstr = '{}'
+JDKSObject = jdks.loads(Jstr)
+
+print(JDKSObject.getObject())
+# OUTPUT: {}
+
+JDKSObject.set("author", "truocphan")
+print(JDKSObject.getObject())
+# OUTPUT: {'author': 'truocphan'}
+
+JDKSObject.set("version", "22.3.3")
+print(JDKSObject.getObject())
+# OUTPUT: {'author': 'truocphan', 'version': '22.3.3'}
+
+JDKSObject.set("version", "latest")
+print(JDKSObject.getObject())
+# OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': 'latest'}
+
+JDKSObject.set("release", [{"version": "latest"}])
+print(JDKSObject.getObject())
+# OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': 'latest', 'release': [{'version': 'latest'}]}
+
+JDKSObject.set("snapshot", {})
+print(JDKSObject.getObject())
+# OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': 'latest', 'release': [{'version': 'latest'}], 'snapshot': {}}
+
+JDKSObject.set("snapshot||author", "truocphan")
+print(JDKSObject.getObject())
+# OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': 'latest', 'release': [{'version': 'latest'}], 'snapshot': {'author': 'truocphan'}}
+
+
+Jstr = '[]'
+JDKSObject = jdks.loads(Jstr)
+
+print(JDKSObject.getObject())
+# OUTPUT: []
+
+JDKSObject.set("author", "truocphan")
+print(JDKSObject.getObject())
+# OUTPUT: [{'author': 'truocphan'}]
+
+JDKSObject.set("release", [])
+print(JDKSObject.getObject())
+# OUTPUT: [{'author': 'truocphan'}, {'release': []}]
+
+JDKSObject.set("$1$||release||", {"version": "latest"})
+print(JDKSObject.getObject())
+# OUTPUT: [{'author': 'truocphan'}, {'release': [{'version': 'latest'}]}]
+```
+---
+
+### JSON_DUPLICATE_KEYS.update(`name`, `value`, `separator`="||", `parse_index`="$", `_isDebug_`=False)
+_Update new `value` for existing `name` in the JSON object_
+- `name`: the key name of the JSON object. Supported flatten key name format
+- `value`: new value for key `name`
+- `separator`: 
+- `parse_index`: 
+- `_isDebug_`: Show/ Hide debug error messages
+```python
+import json_duplicate_keys as jdks
+
+Jstr = '{"author": "truocphan", "version": "22.3.3", "version": "latest", "release": [{"version": "latest"}], "snapshot": {"author": "truocphan", "version": "22.3.3", "release": [{"version": "latest"}]}}'
+
+JDKSObject = jdks.loads(Jstr)
+
+print(JDKSObject.getObject())
+# OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': 'latest', 'release': [{'version': 'latest'}], 'snapshot': {'author': 'truocphan', 'version': '22.3.3', 'release': [{'version': 'latest'}]}}
+
+JDKSObject.update("version{{{_2_}}}", ["22.3.3", "latest"])
+JDKSObject.update("snapshot||version", "latest")
+
+print(JDKSObject.getObject())
+# OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': ['22.3.3', 'latest'], 'release': [{'version': 'latest'}], 'snapshot': {'author': 'truocphan', 'version': 'latest', 'release': [{'version': 'latest'}]}}
+```
+---
+
+### JSON_DUPLICATE_KEYS.delete(`name`, `separator`="||", `parse_index`="$", `_isDebug_`=False)
+_Delete a key-value pair in a JSON object by key `name`_
+- `name`: the key name of the JSON object. Supported flatten key name format
+- `separator`: 
+- `parse_index`: 
+- `_isDebug_`: Show/ Hide debug error messages
+```python
+import json_duplicate_keys as jdks
+
+Jstr = '{"author": "truocphan", "version": "22.3.3", "version": "latest", "release": [{"version": "latest"}], "snapshot": {"author": "truocphan", "version": "22.3.3", "release": [{"version": "latest"}]}}'
+
+JDKSObject = jdks.loads(Jstr)
+
+print(JDKSObject.getObject())
+# OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': 'latest', 'release': [{'version': 'latest'}], 'snapshot': {'author': 'truocphan', 'version': '22.3.3', 'release': [{'version': 'latest'}]}}
+
+JDKSObject.delete("version")
+JDKSObject.delete("release||$0$")
+JDKSObject.delete("snapshot")
+
+print(JDKSObject.getObject())
+# OUTPUT: {'author': 'truocphan', 'version{{{_2_}}}': 'latest', 'release': []}
+```
+---
+
+### JSON_DUPLICATE_KEYS.filter_keys(`name`, `separator`="||", `parse_index`="$", `ordered_dict`=False)
+
+- `name`:
+- `separator`:
+- `parse_index`:
+- `ordered_dict`:
+```python
+import json_duplicate_keys as jdks
+
+Jstr = '{"author": "truocphan", "version": "22.3.3", "version": "latest", "release": [{"version": "latest"}], "snapshot": {"author": "truocphan", "version": "22.3.3", "release": [{"version": "latest"}]}}'
+
+JDKSObject = jdks.loads(Jstr)
+
+print(JDKSObject.filter_keys("version").dumps())
+# OUTPUT: {"version": "22.3.3", "version": "latest", "release||$0$||version": "latest", "snapshot||version": "22.3.3", "snapshot||release||$0$||version": "latest"}
+
+print(JDKSObject.dumps())
+# OUTPUT: {"author": "truocphan", "version": "22.3.3", "version": "latest", "release": [{"version": "latest"}], "snapshot": {"author": "truocphan", "version": "22.3.3", "release": [{"version": "latest"}]}}
+```
+---
+
+### JSON_DUPLICATE_KEYS.filter_values(`value`, `separator`="||", `parse_index`="$", `ordered_dict`=False)
+
+- `value`:
+- `separator`:
+- `parse_index`:
+- `ordered_dict`:
+```python
+import json_duplicate_keys as jdks
+
+Jstr = '{"author": "truocphan", "version": "22.3.3", "version": "latest", "release": [{"version": "latest"}], "snapshot": {"author": "truocphan", "version": "22.3.3", "release": [{"version": "latest"}]}}'
+
+JDKSObject = jdks.loads(Jstr)
+
+print(JDKSObject.filter_values("latest").dumps())
+# OUTPUT: {"version": "latest", "release||$0$||version": "latest", "snapshot||release||$0$||version": "latest"}
+
+print(JDKSObject.dumps())
+# OUTPUT: {"author": "truocphan", "version": "22.3.3", "version": "latest", "release": [{"version": "latest"}], "snapshot": {"author": "truocphan", "version": "22.3.3", "release": [{"version": "latest"}]}}
+```
+---
+
+### JSON_DUPLICATE_KEYS.dumps(`dupSign_start`="{{{", `dupSign_end`="}}}", `_isDebug_`=False, `skipkeys`=False, `ensure_ascii`=True, `check_circular`=True, `allow_nan`=True, `cls`=None, `indent`=None, `separators`=None, `default`=None, `sort_keys`=False)
+_Serialize a JSON object to a JSON format string_
+- `dupSign_start`: 
+- `dupSign_end`: 
+- `_isDebug_`: Show/ Hide debug error messages
+- For remaining arguments, please refer to [json.dump()](https://docs.python.org/3/library/json.html#json.dump)
+```python
+import json_duplicate_keys as jdks
+
+Jstr = '{"author": "truocphan", "version": "22.3.3", "version": "latest", "release": [{"version": "latest"}], "snapshot": {"author": "truocphan", "version": "22.3.3", "release": [{"version": "latest"}]}}'
+
+JDKSObject = jdks.loads(Jstr)
+
+print(JDKSObject.getObject())
+# OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': 'latest', 'release': [{'version': 'latest'}], 'snapshot': {'author': 'truocphan', 'version': '22.3.3', 'release': [{'version': 'latest'}]}}
+
+JDKSObject.delete("version")
+JDKSObject.delete("release||$0$")
+JDKSObject.delete("snapshot")
+
+print(JDKSObject.dumps())
+# OUTPUT: {"author": "truocphan", "version": "latest", "release": []}
+```
+---
+
+### JSON_DUPLICATE_KEYS.dump(`Jfilepath`, `dupSign_start`="{{{", `dupSign_end`="}}}", `_isDebug_`=False, `skipkeys`=False, `ensure_ascii`=True, `check_circular`=True, `allow_nan`=True, `cls`=None, `indent`=None, `separators`=None, `default`=None, `sort_keys`=False)
+_Serialize a JSON object to a JSON format string and write to a file_
+- `Jfilepath`: the path to the file to save the JSON format string
+- `dupSign_start`: 
+- `dupSign_end`: 
+- `_isDebug_`: Show/ Hide debug error messages
+- For remaining arguments, please refer to [json.dump()](https://docs.python.org/3/library/json.html#json.dump)
+```python
+import json_duplicate_keys as jdks
+
+Jstr = '{"author": "truocphan", "version": "22.3.3", "version": "latest", "release": [{"version": "latest"}], "snapshot": {"author": "truocphan", "version": "22.3.3", "release": [{"version": "latest"}]}}'
+
+JDKSObject = jdks.loads(Jstr)
+
+print(JDKSObject.getObject())
+# OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': 'latest', 'release': [{'version': 'latest'}], 'snapshot': {'author': 'truocphan', 'version': '22.3.3', 'release': [{'version': 'latest'}]}}
+
+JDKSObject.delete("version")
+JDKSObject.delete("release||$0$")
+JDKSObject.delete("snapshot")
+
+Jfilepath = "/path/to/file.json"
+JDKSObject.dump(Jfilepath)
+
+JDKSObject_load = jdks.load(Jfilepath)
+print(JDKSObject_load.getObject())
+# OUTPUT: {'author': 'truocphan', 'version': 'latest', 'release': []}
+```
+---
+
+### JSON_DUPLICATE_KEYS.flatten(`separator`="||", `parse_index`="$", `ordered_dict`=False, `_isDebug_`=False)
+_Flatten a JSON object to a single key-value pairs_
+- `separator`: 
+- `parse_index`: 
+- `ordered_dict`: preserves the order in which the Keys are inserted
+- `_isDebug_`: Show/ Hide debug error messages
+```python
+import json_duplicate_keys as jdks
+
+Jstr = '{"author": "truocphan", "version": "22.3.3", "version": "latest", "release": [{"version": "latest"}], "snapshot": {"author": "truocphan", "version": "22.3.3", "release": [{"version": "latest"}]}}'
+
+JDKSObject = jdks.loads(Jstr)
+
+print(JDKSObject.getObject())
+# OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': 'latest', 'release': [{'version': 'latest'}], 'snapshot': {'author': 'truocphan', 'version': '22.3.3', 'release': [{'version': 'latest'}]}}
+
+JDKSObject.flatten()
+
+print(JDKSObject.getObject())
+# OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': 'latest', 'release||$0$||version': 'latest', 'snapshot||author': 'truocphan', 'snapshot||version': '22.3.3', 'snapshot||release||$0$||version': 'latest'}
+```
+---
+
+### JSON_DUPLICATE_KEYS.unflatten(`separator`="||", `parse_index`="$", `ordered_dict`=False, `_isDebug_`=False)
+_Unflatten a flattened JSON object back to a JSON object_
+- `separator`: 
+- `parse_index`: 
+- `ordered_dict`: preserves the order in which the Keys are inserted
+- `_isDebug_`: Show/ Hide debug error messages
+```python
+import json_duplicate_keys as jdks
+
+Jstr = '{"author": "truocphan", "version": "22.3.3", "version": "latest", "release||$0$||version": "latest", "snapshot||author": "truocphan", "snapshot||version": "22.3.3", "snapshot||release||$0$||version": "latest"}'
+
+JDKSObject = jdks.loads(Jstr)
+
+print(JDKSObject.getObject())
+# OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': 'latest', 'release||$0$||version': 'latest', 'snapshot||author': 'truocphan', 'snapshot||version': '22.3.3', 'snapshot||release||$0$||version': 'latest'}
+
+JDKSObject.unflatten()
+
+print(JDKSObject.getObject())
+# OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': 'latest', 'release': [{'version': 'latest'}], 'snapshot': {'author': 'truocphan', 'version': '22.3.3', 'release': [{'version': 'latest'}]}}
+```
+---
+
+## CHANGELOG
+#### [json-duplicate-keys v2024.4.20](https://github.com/truocphan/json-duplicate-keys/tree/2024.4.20)
+- **New**: _filter_values_
+- **Updated**: _filter_keys_
+
+#### [json-duplicate-keys v2024.3.24](https://github.com/truocphan/json-duplicate-keys/tree/2024.3.24)
+- **Updated**: _normalize_key_, _loads_, _get_, _set_, _update_, _delete_
+---

{json-duplicate-keys-2024.2.21 → json-duplicate-keys-2024.4.20}/json_duplicate_keys/__init__.py

@@ -8,14 +8,12 @@ def normalize_key(name, dupSign_start="{{{", dupSign_end="}}}", _isDebug_=False)
 	if type(_isDebug_) != bool: _isDebug_ = False
 	try:
 		if type(name) not in [str, unicode]:
-			if _isDebug_: print("\x1b[31m[-] DataTypeError: the KEY name must be str or unicode, not {}\x1b[0m".format(type(name)))
-			exit()
+			exit("\x1b[31m[-] DataTypeError: the KEY name must be str or unicode, not {}\x1b[0m".format(type(name)))
 		if type(dupSign_start) not in [str, unicode]: dupSign_start = "{{{"
 		if type(dupSign_end) not in [str, unicode]: dupSign_end = "}}}"
 	except Exception as e:
 		if type(name) not in [str]:
-			if _isDebug_: print("\x1b[31m[-] DataTypeError: the KEY name must be str or unicode, not {}\x1b[0m".format(type(name)))
-			exit()
+			exit("\x1b[31m[-] DataTypeError: the KEY name must be str or unicode, not {}\x1b[0m".format(type(name)))
 		if type(dupSign_start) not in [str]: dupSign_start = "{{{"
 		if type(dupSign_end) not in [str]: dupSign_end = "}}}"
 
@@ -37,14 +35,12 @@ def loads(Jstr, dupSign_start="{{{", dupSign_end="}}}", ordered_dict=False, _isD
 	if type(ordered_dict) != bool: ordered_dict = False
 	try:
 		if type(Jstr) not in [str, unicode]:
-			if _isDebug_: print("\x1b[31m[-] DataTypeError: the JSON object must be str or unicode, not {}\x1b[0m".format(type(Jstr)))
-			exit()
+			exit("\x1b[31m[-] DataTypeError: the JSON object must be str or unicode, not {}\x1b[0m".format(type(Jstr)))
 		if type(dupSign_start) not in [str, unicode]: dupSign_start = "{{{"
 		if type(dupSign_end) not in [str, unicode]: dupSign_end = "}}}"
 	except Exception as e:
 		if type(Jstr) not in [str]:
-			if _isDebug_: print("\x1b[31m[-] DataTypeError: the JSON object must be str or unicode, not {}\x1b[0m".format(type(Jstr)))
-			exit()
+			exit("\x1b[31m[-] DataTypeError: the JSON object must be str or unicode, not {}\x1b[0m".format(type(Jstr)))
 		if type(dupSign_start) not in [str]: dupSign_start = "{{{"
 		if type(dupSign_end) not in [str]: dupSign_end = "}}}"
 
@@ -195,14 +191,12 @@ class JSON_DUPLICATE_KEYS:
 		if type(_isDebug_) != bool: _isDebug_ = False
 		try:
 			if type(name) not in [str, unicode]:
-				if _isDebug_: print("\x1b[31m[-] DataTypeError: the KEY name must be str or unicode, not {}\x1b[0m".format(type(name)))
-				exit()
+				exit("\x1b[31m[-] DataTypeError: the KEY name must be str or unicode, not {}\x1b[0m".format(type(name)))
 			if type(separator) not in [str, unicode]: separator = "||"
 			if type(parse_index) not in [str, unicode]: parse_index = "$"
 		except Exception as e:
 			if type(name) not in [str]:
-				if _isDebug_: print("\x1b[31m[-] DataTypeError: the KEY name must be str or unicode, not {}\x1b[0m".format(type(name)))
-				exit()
+				exit("\x1b[31m[-] DataTypeError: the KEY name must be str or unicode, not {}\x1b[0m".format(type(name)))
 			if type(separator) not in [str]: separator = "||"
 			if type(parse_index) not in [str]: parse_index = "$"
 
@@ -246,16 +240,14 @@ class JSON_DUPLICATE_KEYS:
 		if type(ordered_dict) != bool: ordered_dict = False
 		try:
 			if type(name) not in [str, unicode]:
-				if _isDebug_: print("\x1b[31m[-] DataTypeError: the KEY name must be str or unicode, not {}\x1b[0m".format(type(name)))
-				exit()
+				exit("\x1b[31m[-] DataTypeError: the KEY name must be str or unicode, not {}\x1b[0m".format(type(name)))
 			if type(separator) not in [str, unicode]: separator = "||"
 			if type(parse_index) not in [str, unicode]: parse_index = "$"
 			if type(dupSign_start) not in [str, unicode]: dupSign_start = "{{{"
 			if type(dupSign_end) not in [str, unicode]: dupSign_end = "}}}"
 		except Exception as e:
 			if type(name) not in [str]:
-				if _isDebug_: print("\x1b[31m[-] DataTypeError: the KEY name must be str or unicode, not {}\x1b[0m".format(type(name)))
-				exit()
+				exit("\x1b[31m[-] DataTypeError: the KEY name must be str or unicode, not {}\x1b[0m".format(type(name)))
 			if type(separator) not in [str]: separator = "||"
 			if type(parse_index) not in [str]: parse_index = "$"
 			if type(dupSign_start) not in [str]: dupSign_start = "{{{"
@@ -308,6 +300,7 @@ class JSON_DUPLICATE_KEYS:
 								exec_expression += "["+repr(k)+"]"
 
 						exec(exec_expression+"="+repr(value))
+						return True
 					# Add new key
 					elif self.get(separator.join(name_split_first), separator=separator, parse_index=parse_index) != "JSON_DUPLICATE_KEYS_ERROR":
 						if type(self.get(separator.join(name_split_first), separator=separator, parse_index=parse_index)) == list:
@@ -331,6 +324,7 @@ class JSON_DUPLICATE_KEYS:
 										exec_expression += "["+repr(k)+"]"
 
 								exec(exec_expression+".append({"+repr(name_split_lastKey)+":"+repr(value)+"})")
+							return True
 						elif type(self.get(separator.join(name_split_first), separator=separator, parse_index=parse_index)) == dict:
 							exec_expression = "self.getObject()"
 
@@ -341,6 +335,7 @@ class JSON_DUPLICATE_KEYS:
 									exec_expression += "["+repr(k)+"]"
 
 							exec(exec_expression+"["+repr(name_split_lastKey)+"]="+repr(value))
+							return True
 						else:
 							if _isDebug_: print("\x1b[31m[-] KeyNameNotExistError: {}\x1b[0m".format(separator.join(name_split_first)))
 					# Add new key
@@ -352,6 +347,7 @@ class JSON_DUPLICATE_KEYS:
 								self.__Jobj.append({name_split_lastKey: value})
 						else:
 							self.__Jobj[name_split_lastKey] = value
+						return True
 					else:
 						if _isDebug_: print("\x1b[31m[-] KeyNameInvalidError: {}\x1b[0m".format(separator.join(name_split_first)))
 				else:
@@ -360,6 +356,8 @@ class JSON_DUPLICATE_KEYS:
 				if _isDebug_: print("\x1b[31m[-] ExceptionError: {}\x1b[0m".format(e))
 		else:
 			if _isDebug_: print("\x1b[31m[-] DataTypeError: the JSON object must be list, dict or OrderedDict, not {}\x1b[0m".format(type(self.getObject())))
+
+		return False
 	# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
 	# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
 	# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
@@ -375,14 +373,12 @@ class JSON_DUPLICATE_KEYS:
 		if type(_isDebug_) != bool: _isDebug_ = False
 		try:
 			if type(name) not in [str, unicode]:
-				if _isDebug_: print("\x1b[31m[-] DataTypeError: the KEY name must be str or unicode, not {}\x1b[0m".format(type(name)))
-				exit()
+				exit("\x1b[31m[-] DataTypeError: the KEY name must be str or unicode, not {}\x1b[0m".format(type(name)))
 			if type(separator) not in [str, unicode]: separator = "||"
 			if type(parse_index) not in [str, unicode]: parse_index = "$"
 		except Exception as e:
 			if type(name) not in [str]:
-				if _isDebug_: print("\x1b[31m[-] DataTypeError: the KEY name must be str or unicode, not {}\x1b[0m".format(type(name)))
-				exit()
+				exit("\x1b[31m[-] DataTypeError: the KEY name must be str or unicode, not {}\x1b[0m".format(type(name)))
 			if type(separator) not in [str]: separator = "||"
 			if type(parse_index) not in [str]: parse_index = "$"
 
@@ -397,8 +393,11 @@ class JSON_DUPLICATE_KEYS:
 						exec_expression += "["+repr(k)+"]"
 
 				exec(exec_expression+"="+repr(value))
+				return True
 			except Exception as e:
 				if _isDebug_: print("\x1b[31m[-] ExceptionError: {}\x1b[0m".format(e))
+
+		return False
 	# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
 	# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
 	# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
@@ -415,14 +414,12 @@ class JSON_DUPLICATE_KEYS:
 
 		try:
 			if type(name) not in [str, unicode]:
-				if _isDebug_: print("\x1b[31m[-] DataTypeError: the KEY name must be str or unicode, not {}\x1b[0m".format(type(name)))
-				exit()
+				exit("\x1b[31m[-] DataTypeError: the KEY name must be str or unicode, not {}\x1b[0m".format(type(name)))
 			if type(separator) not in [str, unicode]: separator = "||"
 			if type(parse_index) not in [str, unicode]: parse_index = "$"
 		except Exception as e:
 			if type(name) not in [str]:
-				if _isDebug_: print("\x1b[31m[-] DataTypeError: the KEY name must be str or unicode, not {}\x1b[0m".format(type(name)))
-				exit()
+				exit("\x1b[31m[-] DataTypeError: the KEY name must be str or unicode, not {}\x1b[0m".format(type(name)))
 			if type(separator) not in [str]: separator = "||"
 			if type(parse_index) not in [str]: parse_index = "$"
 
@@ -437,8 +434,11 @@ class JSON_DUPLICATE_KEYS:
 						exec_expression += "["+repr(k)+"]"
 
 				exec(exec_expression)
+				return True
 			except Exception as e:
 				if _isDebug_: print("\x1b[31m[-] ExceptionError: {}\x1b[0m".format(e))
+
+		return False
 	# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
 	# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
 	# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
@@ -454,9 +454,37 @@ class JSON_DUPLICATE_KEYS:
 		JDKSObject.flatten(separator=separator, parse_index=parse_index, ordered_dict=ordered_dict)
 		newJDKSObject = loads("{}", ordered_dict=ordered_dict)
 
-		for k in JDKSObject.getObject():
-			if re.search(name, k):
-				newJDKSObject.set(k, JDKSObject.get(k, separator="§§"+separator+"§§", parse_index="§§"+parse_index+"§§"), separator="§§"+separator+"§§", parse_index="§§"+parse_index+"§§", ordered_dict=ordered_dict)
+		for k, v in JDKSObject.getObject().items():
+			if type(k) == str and type(name) == str:
+				if re.search(name, k):
+					newJDKSObject.set(k, v, separator="§§"+separator+"§§", parse_index="§§"+parse_index+"§§", ordered_dict=ordered_dict)
+			else:
+				if name == k:
+					newJDKSObject.set(k, v, separator="§§"+separator+"§§", parse_index="§§"+parse_index+"§§", ordered_dict=ordered_dict)
+
+		return newJDKSObject
+	# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+	# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+	# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+
+
+	# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+	# # # # # # # # # # # # filter_values  # # # # # # # # # # # # #
+	# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+	def filter_values(self, value, separator="||", parse_index="$", ordered_dict=False):
+		import re, copy
+
+		JDKSObject = copy.deepcopy(self)
+		JDKSObject.flatten(separator=separator, parse_index=parse_index, ordered_dict=ordered_dict)
+		newJDKSObject = loads("{}", ordered_dict=ordered_dict)
+
+		for k, v in JDKSObject.getObject().items():
+			if type(v) == str and type(value) == str:
+				if re.search(value, v):
+					newJDKSObject.set(k, v, separator="§§"+separator+"§§", parse_index="§§"+parse_index+"§§", ordered_dict=ordered_dict)
+			else:
+				if value == v:
+					newJDKSObject.set(k, v, separator="§§"+separator+"§§", parse_index="§§"+parse_index+"§§", ordered_dict=ordered_dict)
 
 		return newJDKSObject
 	# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

json-duplicate-keys-2024.4.20/json_duplicate_keys.egg-info/PKG-INFO

@@ -0,0 +1,403 @@
+Metadata-Version: 2.1
+Name: json-duplicate-keys
+Version: 2024.4.20
+Summary: Flatten/ Unflatten and Load(s)/ Dump(s) JSON File/ Object with Duplicate Keys
+Home-page: https://github.com/truocphan/json-duplicate-keys
+Author: TP Cyber Security
+Author-email: tpcybersec2023@gmail.com
+License: MIT
+Description: # JSON Duplicate Keys - PyPI
+        Flatten/ Unflatten and Load(s)/ Dump(s) JSON File/ Object with Duplicate Keys
+        
+        <p align="center">
+            <a href="https://github.com/truocphan/json-duplicate-keys/releases/"><img src="https://img.shields.io/github/release/truocphan/json-duplicate-keys" height=30></a>
+        	<a href="#"><img src="https://img.shields.io/github/downloads/truocphan/json-duplicate-keys/total" height=30></a>
+        	<a href="#"><img src="https://img.shields.io/github/stars/truocphan/json-duplicate-keys" height=30></a>
+        	<a href="#"><img src="https://img.shields.io/github/forks/truocphan/json-duplicate-keys" height=30></a>
+        	<a href="https://github.com/truocphan/json-duplicate-keys/issues?q=is%3Aopen+is%3Aissue"><img src="https://img.shields.io/github/issues/truocphan/json-duplicate-keys" height=30></a>
+        	<a href="https://github.com/truocphan/json-duplicate-keys/issues?q=is%3Aissue+is%3Aclosed"><img src="https://img.shields.io/github/issues-closed/truocphan/json-duplicate-keys" height=30></a>
+        	<a href="https://pypi.org/project/json-duplicate-keys/" target="_blank"><img src="https://img.shields.io/badge/pypi-3775A9?style=for-the-badge&logo=pypi&logoColor=white" height=30></a>
+        	<a href="https://www.facebook.com/61550595106970" target="_blank"><img src="https://img.shields.io/badge/Facebook-1877F2?style=for-the-badge&logo=facebook&logoColor=white" height=30></a>
+        	<a href="https://twitter.com/TPCyberSec" target="_blank"><img src="https://img.shields.io/badge/Twitter-1DA1F2?style=for-the-badge&logo=twitter&logoColor=white" height=30></a>
+        	<a href="https://github.com/truocphan" target="_blank"><img src="https://img.shields.io/badge/GitHub-100000?style=for-the-badge&logo=github&logoColor=white" height=30></a>
+        	<a href="mailto:tpcybersec2023@gmail.com" target="_blank"><img src="https://img.shields.io/badge/Gmail-D14836?style=for-the-badge&logo=gmail&logoColor=white" height=30></a>
+        	<a href="https://www.buymeacoffee.com/truocphan" target="_blank"><img src="https://img.shields.io/badge/Buy_Me_A_Coffee-FFDD00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=black" height=30></a>
+        </p>
+        
+        ## Installation
+        #### From PyPI:
+        ```console
+        pip install json-duplicate-keys
+        ```
+        #### From Source:
+        ```console
+        git clone https://github.com/truocphan/json-duplicate-keys.git --branch <Branch/Tag>
+        cd json-duplicate-keys
+        python setup.py build
+        python setup.py install
+        ```
+        
+        ## Basic Usage
+        ### normalize_key(`name`, `dupSign_start`="{{{", `dupSign_end`="}}}", `_isDebug_`=False)
+        _Normalize Key name_
+        - `name`: key name
+        - `dupSign_start`: 
+        - `dupSign_end`: 
+        - `_isDebug_`: Show/ Hide debug error messages
+        ```python
+        import json_duplicate_keys as jdks
+        
+        print(jdks.normalize_key("version{{{_2_}}}"))
+        # OUTPUT: version
+        ```
+        ---
+        
+        ### loads(`Jstr`, `dupSign_start`="{{{", `dupSign_end`="}}}", `ordered_dict`=False, `_isDebug_`=False)
+        _Deserialize a JSON format string to a class `JSON_DUPLICATE_KEYS`_
+        - `Jstr`: a JSON format string
+        - `dupSign_start`: 
+        - `dupSign_end`: 
+        - `ordered_dict`: preserves the order in which the Keys are inserted
+        - `_isDebug_`: Show/ Hide debug error messages
+        ```python
+        import json_duplicate_keys as jdks
+        
+        Jstr = '{"author": "truocphan", "version": "22.3.3", "version": "latest", "release": [{"version": "latest"}], "snapshot": {"author": "truocphan", "version": "22.3.3", "release": [{"version": "latest"}]}}'
+        
+        JDKSObject = jdks.loads(Jstr)
+        
+        print(JDKSObject)
+        # OUTPUT: <json_duplicate_keys.JSON_DUPLICATE_KEYS object at 0x00000270AE987940>
+        ```
+        ---
+        
+        ### load(`Jfilepath`, `dupSign_start`="{{{", `dupSign_end`="}}}", `ordered_dict`=False, `_isDebug_`=False)
+        _Deserialize a JSON format string from a file to a class `JSON_DUPLICATE_KEYS`_
+        - `Jfilepath`: The path to the file containing the JSON format string
+        - `dupSign_start`: 
+        - `dupSign_end`: 
+        - `ordered_dict`: preserves the order in which the Keys are inserted
+        - `_isDebug_`: Show/ Hide debug error messages
+        ```python
+        # /path/to/file.json: {"author": "truocphan", "version": "22.3.3", "version": "latest", "release": [{"version": "latest"}], "snapshot": {"author": "truocphan", "version": "22.3.3", "release": [{"version": "latest"}]}}
+        
+        import json_duplicate_keys as jdks
+        
+        Jfilepath = "/path/to/file.json"
+        
+        JDKSObject = jdks.load(Jfilepath)
+        
+        print(JDKSObject)
+        # OUTPUT: <json_duplicate_keys.JSON_DUPLICATE_KEYS object at 0x00000270AE986D40>
+        ```
+        ---
+        
+        ### JSON_DUPLICATE_KEYS.getObject()
+        _Get the JSON object_
+        ```python
+        import json_duplicate_keys as jdks
+        
+        Jstr = '{"author": "truocphan", "version": "22.3.3", "version": "latest", "release": [{"version": "latest"}], "snapshot": {"author": "truocphan", "version": "22.3.3", "release": [{"version": "latest"}]}}'
+        
+        JDKSObject = jdks.loads(Jstr)
+        
+        print(JDKSObject.getObject())
+        # OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': 'latest', 'release': [{'version': 'latest'}], 'snapshot': {'author': 'truocphan', 'version': '22.3.3', 'release': [{'version': 'latest'}]}}
+        ```
+        ---
+        
+        ### JSON_DUPLICATE_KEYS.get(`name`, `separator`="||", `parse_index`="$", `_isDebug_`=False)
+        _Get value in the JSON object by `name`_
+        - `name`: the key name of the JSON object. Supported flatten key name format
+        - `separator`: 
+        - `parse_index`:
+        - `_isDebug_`: Show/ Hide debug error messages
+        ```python
+        import json_duplicate_keys as jdks
+        
+        Jstr = '{"author": "truocphan", "version": "22.3.3", "version": "latest", "release": [{"version": "latest"}], "snapshot": {"author": "truocphan", "version": "22.3.3", "release": [{"version": "latest"}]}}'
+        
+        JDKSObject = jdks.loads(Jstr)
+        
+        print(JDKSObject.get("version{{{_2_}}}"))
+        # OUTPUT: latest
+        
+        print(JDKSObject.get("release||$0$"))
+        # OUTPUT: {'version': 'latest'}
+        
+        print(JDKSObject.get("snapshot||author"))
+        # OUTPUT: truocphan
+        ```
+        ---
+        
+        ### JSON_DUPLICATE_KEYS.set(`name`, `value`, `separator`="||", `parse_index`="$", `dupSign_start`="{{{", `dupSign_end`="}}}", `ordered_dict`=False, `_isDebug_`=False)
+        _Set a new `name` and `value` for the JSON object_
+        - `name`: new key name for the JSON object. Supported flat key name format
+        - `value`: value for key `name`
+        - `separator`: 
+        - `parse_index`: 
+        - `dupSign_start`: 
+        - `dupSign_end`: 
+        - `ordered_dict`: preserves the order in which the Keys are inserted
+        - `_isDebug_`: Show/Hide debug error messages
+        ```python
+        import json_duplicate_keys as jdks
+        
+        Jstr = '{}'
+        JDKSObject = jdks.loads(Jstr)
+        
+        print(JDKSObject.getObject())
+        # OUTPUT: {}
+        
+        JDKSObject.set("author", "truocphan")
+        print(JDKSObject.getObject())
+        # OUTPUT: {'author': 'truocphan'}
+        
+        JDKSObject.set("version", "22.3.3")
+        print(JDKSObject.getObject())
+        # OUTPUT: {'author': 'truocphan', 'version': '22.3.3'}
+        
+        JDKSObject.set("version", "latest")
+        print(JDKSObject.getObject())
+        # OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': 'latest'}
+        
+        JDKSObject.set("release", [{"version": "latest"}])
+        print(JDKSObject.getObject())
+        # OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': 'latest', 'release': [{'version': 'latest'}]}
+        
+        JDKSObject.set("snapshot", {})
+        print(JDKSObject.getObject())
+        # OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': 'latest', 'release': [{'version': 'latest'}], 'snapshot': {}}
+        
+        JDKSObject.set("snapshot||author", "truocphan")
+        print(JDKSObject.getObject())
+        # OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': 'latest', 'release': [{'version': 'latest'}], 'snapshot': {'author': 'truocphan'}}
+        
+        
+        Jstr = '[]'
+        JDKSObject = jdks.loads(Jstr)
+        
+        print(JDKSObject.getObject())
+        # OUTPUT: []
+        
+        JDKSObject.set("author", "truocphan")
+        print(JDKSObject.getObject())
+        # OUTPUT: [{'author': 'truocphan'}]
+        
+        JDKSObject.set("release", [])
+        print(JDKSObject.getObject())
+        # OUTPUT: [{'author': 'truocphan'}, {'release': []}]
+        
+        JDKSObject.set("$1$||release||", {"version": "latest"})
+        print(JDKSObject.getObject())
+        # OUTPUT: [{'author': 'truocphan'}, {'release': [{'version': 'latest'}]}]
+        ```
+        ---
+        
+        ### JSON_DUPLICATE_KEYS.update(`name`, `value`, `separator`="||", `parse_index`="$", `_isDebug_`=False)
+        _Update new `value` for existing `name` in the JSON object_
+        - `name`: the key name of the JSON object. Supported flatten key name format
+        - `value`: new value for key `name`
+        - `separator`: 
+        - `parse_index`: 
+        - `_isDebug_`: Show/ Hide debug error messages
+        ```python
+        import json_duplicate_keys as jdks
+        
+        Jstr = '{"author": "truocphan", "version": "22.3.3", "version": "latest", "release": [{"version": "latest"}], "snapshot": {"author": "truocphan", "version": "22.3.3", "release": [{"version": "latest"}]}}'
+        
+        JDKSObject = jdks.loads(Jstr)
+        
+        print(JDKSObject.getObject())
+        # OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': 'latest', 'release': [{'version': 'latest'}], 'snapshot': {'author': 'truocphan', 'version': '22.3.3', 'release': [{'version': 'latest'}]}}
+        
+        JDKSObject.update("version{{{_2_}}}", ["22.3.3", "latest"])
+        JDKSObject.update("snapshot||version", "latest")
+        
+        print(JDKSObject.getObject())
+        # OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': ['22.3.3', 'latest'], 'release': [{'version': 'latest'}], 'snapshot': {'author': 'truocphan', 'version': 'latest', 'release': [{'version': 'latest'}]}}
+        ```
+        ---
+        
+        ### JSON_DUPLICATE_KEYS.delete(`name`, `separator`="||", `parse_index`="$", `_isDebug_`=False)
+        _Delete a key-value pair in a JSON object by key `name`_
+        - `name`: the key name of the JSON object. Supported flatten key name format
+        - `separator`: 
+        - `parse_index`: 
+        - `_isDebug_`: Show/ Hide debug error messages
+        ```python
+        import json_duplicate_keys as jdks
+        
+        Jstr = '{"author": "truocphan", "version": "22.3.3", "version": "latest", "release": [{"version": "latest"}], "snapshot": {"author": "truocphan", "version": "22.3.3", "release": [{"version": "latest"}]}}'
+        
+        JDKSObject = jdks.loads(Jstr)
+        
+        print(JDKSObject.getObject())
+        # OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': 'latest', 'release': [{'version': 'latest'}], 'snapshot': {'author': 'truocphan', 'version': '22.3.3', 'release': [{'version': 'latest'}]}}
+        
+        JDKSObject.delete("version")
+        JDKSObject.delete("release||$0$")
+        JDKSObject.delete("snapshot")
+        
+        print(JDKSObject.getObject())
+        # OUTPUT: {'author': 'truocphan', 'version{{{_2_}}}': 'latest', 'release': []}
+        ```
+        ---
+        
+        ### JSON_DUPLICATE_KEYS.filter_keys(`name`, `separator`="||", `parse_index`="$", `ordered_dict`=False)
+        
+        - `name`:
+        - `separator`:
+        - `parse_index`:
+        - `ordered_dict`:
+        ```python
+        import json_duplicate_keys as jdks
+        
+        Jstr = '{"author": "truocphan", "version": "22.3.3", "version": "latest", "release": [{"version": "latest"}], "snapshot": {"author": "truocphan", "version": "22.3.3", "release": [{"version": "latest"}]}}'
+        
+        JDKSObject = jdks.loads(Jstr)
+        
+        print(JDKSObject.filter_keys("version").dumps())
+        # OUTPUT: {"version": "22.3.3", "version": "latest", "release||$0$||version": "latest", "snapshot||version": "22.3.3", "snapshot||release||$0$||version": "latest"}
+        
+        print(JDKSObject.dumps())
+        # OUTPUT: {"author": "truocphan", "version": "22.3.3", "version": "latest", "release": [{"version": "latest"}], "snapshot": {"author": "truocphan", "version": "22.3.3", "release": [{"version": "latest"}]}}
+        ```
+        ---
+        
+        ### JSON_DUPLICATE_KEYS.filter_values(`value`, `separator`="||", `parse_index`="$", `ordered_dict`=False)
+        
+        - `value`:
+        - `separator`:
+        - `parse_index`:
+        - `ordered_dict`:
+        ```python
+        import json_duplicate_keys as jdks
+        
+        Jstr = '{"author": "truocphan", "version": "22.3.3", "version": "latest", "release": [{"version": "latest"}], "snapshot": {"author": "truocphan", "version": "22.3.3", "release": [{"version": "latest"}]}}'
+        
+        JDKSObject = jdks.loads(Jstr)
+        
+        print(JDKSObject.filter_values("latest").dumps())
+        # OUTPUT: {"version": "latest", "release||$0$||version": "latest", "snapshot||release||$0$||version": "latest"}
+        
+        print(JDKSObject.dumps())
+        # OUTPUT: {"author": "truocphan", "version": "22.3.3", "version": "latest", "release": [{"version": "latest"}], "snapshot": {"author": "truocphan", "version": "22.3.3", "release": [{"version": "latest"}]}}
+        ```
+        ---
+        
+        ### JSON_DUPLICATE_KEYS.dumps(`dupSign_start`="{{{", `dupSign_end`="}}}", `_isDebug_`=False, `skipkeys`=False, `ensure_ascii`=True, `check_circular`=True, `allow_nan`=True, `cls`=None, `indent`=None, `separators`=None, `default`=None, `sort_keys`=False)
+        _Serialize a JSON object to a JSON format string_
+        - `dupSign_start`: 
+        - `dupSign_end`: 
+        - `_isDebug_`: Show/ Hide debug error messages
+        - For remaining arguments, please refer to [json.dump()](https://docs.python.org/3/library/json.html#json.dump)
+        ```python
+        import json_duplicate_keys as jdks
+        
+        Jstr = '{"author": "truocphan", "version": "22.3.3", "version": "latest", "release": [{"version": "latest"}], "snapshot": {"author": "truocphan", "version": "22.3.3", "release": [{"version": "latest"}]}}'
+        
+        JDKSObject = jdks.loads(Jstr)
+        
+        print(JDKSObject.getObject())
+        # OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': 'latest', 'release': [{'version': 'latest'}], 'snapshot': {'author': 'truocphan', 'version': '22.3.3', 'release': [{'version': 'latest'}]}}
+        
+        JDKSObject.delete("version")
+        JDKSObject.delete("release||$0$")
+        JDKSObject.delete("snapshot")
+        
+        print(JDKSObject.dumps())
+        # OUTPUT: {"author": "truocphan", "version": "latest", "release": []}
+        ```
+        ---
+        
+        ### JSON_DUPLICATE_KEYS.dump(`Jfilepath`, `dupSign_start`="{{{", `dupSign_end`="}}}", `_isDebug_`=False, `skipkeys`=False, `ensure_ascii`=True, `check_circular`=True, `allow_nan`=True, `cls`=None, `indent`=None, `separators`=None, `default`=None, `sort_keys`=False)
+        _Serialize a JSON object to a JSON format string and write to a file_
+        - `Jfilepath`: the path to the file to save the JSON format string
+        - `dupSign_start`: 
+        - `dupSign_end`: 
+        - `_isDebug_`: Show/ Hide debug error messages
+        - For remaining arguments, please refer to [json.dump()](https://docs.python.org/3/library/json.html#json.dump)
+        ```python
+        import json_duplicate_keys as jdks
+        
+        Jstr = '{"author": "truocphan", "version": "22.3.3", "version": "latest", "release": [{"version": "latest"}], "snapshot": {"author": "truocphan", "version": "22.3.3", "release": [{"version": "latest"}]}}'
+        
+        JDKSObject = jdks.loads(Jstr)
+        
+        print(JDKSObject.getObject())
+        # OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': 'latest', 'release': [{'version': 'latest'}], 'snapshot': {'author': 'truocphan', 'version': '22.3.3', 'release': [{'version': 'latest'}]}}
+        
+        JDKSObject.delete("version")
+        JDKSObject.delete("release||$0$")
+        JDKSObject.delete("snapshot")
+        
+        Jfilepath = "/path/to/file.json"
+        JDKSObject.dump(Jfilepath)
+        
+        JDKSObject_load = jdks.load(Jfilepath)
+        print(JDKSObject_load.getObject())
+        # OUTPUT: {'author': 'truocphan', 'version': 'latest', 'release': []}
+        ```
+        ---
+        
+        ### JSON_DUPLICATE_KEYS.flatten(`separator`="||", `parse_index`="$", `ordered_dict`=False, `_isDebug_`=False)
+        _Flatten a JSON object to a single key-value pairs_
+        - `separator`: 
+        - `parse_index`: 
+        - `ordered_dict`: preserves the order in which the Keys are inserted
+        - `_isDebug_`: Show/ Hide debug error messages
+        ```python
+        import json_duplicate_keys as jdks
+        
+        Jstr = '{"author": "truocphan", "version": "22.3.3", "version": "latest", "release": [{"version": "latest"}], "snapshot": {"author": "truocphan", "version": "22.3.3", "release": [{"version": "latest"}]}}'
+        
+        JDKSObject = jdks.loads(Jstr)
+        
+        print(JDKSObject.getObject())
+        # OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': 'latest', 'release': [{'version': 'latest'}], 'snapshot': {'author': 'truocphan', 'version': '22.3.3', 'release': [{'version': 'latest'}]}}
+        
+        JDKSObject.flatten()
+        
+        print(JDKSObject.getObject())
+        # OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': 'latest', 'release||$0$||version': 'latest', 'snapshot||author': 'truocphan', 'snapshot||version': '22.3.3', 'snapshot||release||$0$||version': 'latest'}
+        ```
+        ---
+        
+        ### JSON_DUPLICATE_KEYS.unflatten(`separator`="||", `parse_index`="$", `ordered_dict`=False, `_isDebug_`=False)
+        _Unflatten a flattened JSON object back to a JSON object_
+        - `separator`: 
+        - `parse_index`: 
+        - `ordered_dict`: preserves the order in which the Keys are inserted
+        - `_isDebug_`: Show/ Hide debug error messages
+        ```python
+        import json_duplicate_keys as jdks
+        
+        Jstr = '{"author": "truocphan", "version": "22.3.3", "version": "latest", "release||$0$||version": "latest", "snapshot||author": "truocphan", "snapshot||version": "22.3.3", "snapshot||release||$0$||version": "latest"}'
+        
+        JDKSObject = jdks.loads(Jstr)
+        
+        print(JDKSObject.getObject())
+        # OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': 'latest', 'release||$0$||version': 'latest', 'snapshot||author': 'truocphan', 'snapshot||version': '22.3.3', 'snapshot||release||$0$||version': 'latest'}
+        
+        JDKSObject.unflatten()
+        
+        print(JDKSObject.getObject())
+        # OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': 'latest', 'release': [{'version': 'latest'}], 'snapshot': {'author': 'truocphan', 'version': '22.3.3', 'release': [{'version': 'latest'}]}}
+        ```
+        ---
+        
+        ## CHANGELOG
+        #### [json-duplicate-keys v2024.4.20](https://github.com/truocphan/json-duplicate-keys/tree/2024.4.20)
+        - **New**: _filter_values_
+        - **Updated**: _filter_keys_
+        
+        #### [json-duplicate-keys v2024.3.24](https://github.com/truocphan/json-duplicate-keys/tree/2024.3.24)
+        - **Updated**: _normalize_key_, _loads_, _get_, _set_, _update_, _delete_
+        ---
+Keywords: TPCyberSec,json,duplicate keys,json duplicate keys,flatten,unflatten
+Platform: UNKNOWN
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: Implementation :: Jython
+Description-Content-Type: text/markdown

json-duplicate-keys-2024.4.20/json_duplicate_keys.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+MANIFEST.in
+README.md
+requirements.txt
+setup.py
+json_duplicate_keys/__init__.py
+json_duplicate_keys.egg-info/PKG-INFO
+json_duplicate_keys.egg-info/SOURCES.txt
+json_duplicate_keys.egg-info/dependency_links.txt
+json_duplicate_keys.egg-info/top_level.txt

json-duplicate-keys-2024.4.20/json_duplicate_keys.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

json-duplicate-keys-2024.4.20/json_duplicate_keys.egg-info/top_level.txt

@@ -0,0 +1 @@
+json_duplicate_keys

json-duplicate-keys-2024.4.20/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

{json-duplicate-keys-2024.2.21 → json-duplicate-keys-2024.4.20}/setup.py

@@ -2,7 +2,7 @@ import setuptools
 
 setuptools.setup(
 	name="json-duplicate-keys",
-	version="2024.2.21",
+	version="2024.4.20",
 	author="TP Cyber Security",
 	license="MIT",
 	author_email="tpcybersec2023@gmail.com",