json-duplicate-keys 2025.6.6__tar.gz → 2025.7.1__tar.gz

{json_duplicate_keys-2025.6.6/json_duplicate_keys.egg-info → json_duplicate_keys-2025.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: json-duplicate-keys
-Version: 2025.6.6
+Version: 2025.7.1
 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
@@ -45,8 +45,8 @@ python setup.py install
 ### normalize_key(`name`, `dupSign_start`="{{{", `dupSign_end`="}}}", `_isDebug_`=False)
 _Normalize Key name_
 - `name`: key name
-- `dupSign_start`: 
-- `dupSign_end`: 
+- `dupSign_start`: Start symbol for marking duplicates (default: `{{{`)
+- `dupSign_end`: End symbol for marking duplicates (default: `}}}`)
 - `_isDebug_`: Show/ Hide debug error messages
 ```python
 import json_duplicate_keys as jdks
@@ -59,8 +59,8 @@ print(jdks.normalize_key("version{{{_2_}}}"))
 ### loads(`Jstr`, `dupSign_start`="{{{", `dupSign_end`="}}}", `ordered_dict`=False, `skipDuplicated`=False, `_isDebug_`=False)
 _Deserialize a JSON format string to a class `JSON_DUPLICATE_KEYS`_
 - `Jstr`: a JSON format string
-- `dupSign_start`: 
-- `dupSign_end`: 
+- `dupSign_start`: Start symbol for marking duplicates (default: `{{{`)
+- `dupSign_end`: End symbol for marking duplicates (default: `}}}`)
 - `ordered_dict`: preserves the order in which the Keys are inserted
 - `skipDuplicated`: Skip loading duplicate keys to improve execution performance
 - `_isDebug_`: Show/ Hide debug error messages
@@ -79,8 +79,8 @@ print(JDKSObject)
 ### load(`Jfilepath`, `dupSign_start`="{{{", `dupSign_end`="}}}", `ordered_dict`=False, `skipDuplicated`=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`: 
+- `dupSign_start`: Start symbol for marking duplicates (default: `{{{`)
+- `dupSign_end`: End symbol for marking duplicates (default: `}}}`)
 - `ordered_dict`: preserves the order in which the Keys are inserted
 - `skipDuplicated`: Skip loading duplicate keys to improve execution performance
 - `_isDebug_`: Show/ Hide debug error messages
@@ -116,8 +116,8 @@ print(JDKSObject.getObject())
 _Get value in the JSON object by `name`_
 - `name`: the key name of the JSON object. Supported flatten key name format
 - `case_insensitive`: the key name case (in)sensitive
-- `separator`: 
-- `parse_index`:
+- `separator`: Separator for flatten keys (default: `||`)
+- `parse_index`: Symbol for index parsing (default: `$`)
 - `_isDebug_`: Show/ Hide debug error messages
 ```python
 import json_duplicate_keys as jdks
@@ -142,10 +142,10 @@ _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`
 - `case_insensitive`: the key name case (in)sensitive
-- `separator`: 
-- `parse_index`: 
-- `dupSign_start`: 
-- `dupSign_end`: 
+- `separator`: Separator for flatten keys (default: `||`)
+- `parse_index`: Symbol for index parsing (default: `$`)
+- `dupSign_start`: Start symbol for marking duplicates (default: `{{{`)
+- `dupSign_end`: End symbol for marking duplicates (default: `}}}`)
 - `ordered_dict`: preserves the order in which the Keys are inserted
 - `_isDebug_`: Show/Hide debug error messages
 ```python
@@ -180,25 +180,6 @@ print(JDKSObject.getObject())
 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'}]}]
 ```
 ---
 
@@ -208,10 +189,10 @@ _Insert `value` at `position` in value list of `name`_
 - `value`: new value for key `name`
 - `position`: position of the `value` to insert (default insert at the last position of the list)
 - `case_insensitive`: the key name case (in)sensitive
-- `separator`: 
-- `parse_index`: 
-- `dupSign_start`: 
-- `dupSign_end`: 
+- `separator`: Separator for flatten keys (default: `||`)
+- `parse_index`: Symbol for index parsing (default: `$`)
+- `dupSign_start`: Start symbol for marking duplicates (default: `{{{`)
+- `dupSign_end`: End symbol for marking duplicates (default: `}}}`)
 - `_isDebug_`: Show/ Hide debug error messages
 ```python
 import json_duplicate_keys as jdks
@@ -237,10 +218,10 @@ _Update new `value` for existing `name` or Set a new `name` in the JSON object_
 - `value`: new value for key `name`
 - `case_insensitive`: the key name case (in)sensitive
 - `allow_new_key`: allows to create a new key name if the key name does not exist
-- `separator`: 
-- `parse_index`: 
-- `dupSign_start`: 
-- `dupSign_end`: 
+- `separator`: Separator for flatten keys (default: `||`)
+- `parse_index`: Symbol for index parsing (default: `$`)
+- `dupSign_start`: Start symbol for marking duplicates (default: `{{{`)
+- `dupSign_end`: End symbol for marking duplicates (default: `}}}`)
 - `ordered_dict`: preserves the order in which the Keys are inserted
 - `_isDebug_`: Show/ Hide debug error messages
 ```python
@@ -265,8 +246,8 @@ print(JDKSObject.getObject())
 _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
 - `case_insensitive`: the key name case (in)sensitive
-- `separator`: 
-- `parse_index`: 
+- `separator`: Separator for flatten keys (default: `||`)
+- `parse_index`: Symbol for index parsing (default: `$`)
 - `_isDebug_`: Show/ Hide debug error messages
 ```python
 import json_duplicate_keys as jdks
@@ -288,10 +269,10 @@ print(JDKSObject.getObject())
 ---
 
 ### JSON_DUPLICATE_KEYS.filter_keys(`name`, `separator`="||", `parse_index`="$", `ordered_dict`=False)
-
+_Return a `JSON_DUPLICATE_KEYS` object with keys matching a pattern_
 - `name`:
-- `separator`:
-- `parse_index`:
+- `separator`: Separator for flatten keys (default: `||`)
+- `parse_index`: Symbol for index parsing (default: `$`)
 - `ordered_dict`: preserves the order in which the Keys are inserted
 ```python
 import json_duplicate_keys as jdks
@@ -309,10 +290,10 @@ print(JDKSObject.dumps())
 ---
 
 ### JSON_DUPLICATE_KEYS.filter_values(`value`, `separator`="||", `parse_index`="$", `ordered_dict`=False)
-
+_Return a `JSON_DUPLICATE_KEYS` object with values matching a pattern_
 - `value`:
-- `separator`:
-- `parse_index`:
+- `separator`: Separator for flatten keys (default: `||`)
+- `parse_index`: Symbol for index parsing (default: `$`)
 - `ordered_dict`: preserves the order in which the Keys are inserted
 ```python
 import json_duplicate_keys as jdks
@@ -331,8 +312,8 @@ print(JDKSObject.dumps())
 
 ### 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`: 
+- `dupSign_start`: Start symbol for marking duplicates (default: `{{{`)
+- `dupSign_end`: End symbol for marking duplicates (default: `}}}`)
 - `_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
@@ -357,8 +338,8 @@ print(JDKSObject.dumps())
 ### 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`: 
+- `dupSign_start`: Start symbol for marking duplicates (default: `{{{`)
+- `dupSign_end`: End symbol for marking duplicates (default: `}}}`)
 - `_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
@@ -386,8 +367,8 @@ print(JDKSObject_load.getObject())
 
 ### 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`: 
+- `separator`: Separator for flatten keys (default: `||`)
+- `parse_index`: Symbol for index parsing (default: `$`)
 - `ordered_dict`: preserves the order in which the Keys are inserted
 - `_isDebug_`: Show/ Hide debug error messages
 ```python
@@ -409,8 +390,8 @@ print(JDKSObject.getObject())
 
 ### 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`: 
+- `separator`: Separator for flatten keys (default: `||`)
+- `parse_index`: Symbol for index parsing (default: `$`)
 - `ordered_dict`: preserves the order in which the Keys are inserted
 - `_isDebug_`: Show/ Hide debug error messages
 ```python
@@ -431,6 +412,11 @@ print(JDKSObject.getObject())
 ---
 
 ## CHANGELOG
+#### [json-duplicate-keys v2025.7.1](https://github.com/truocphan/json-duplicate-keys/tree/2025.7.1)
+- [**Updated**] Fixed some issues when loading JSON strings with `skipDuplicated` option
+- [**Updated**] Allow loading of JSON data in byte string format
+- [**Updated**] Issue with getting and setting an empty list
+
 #### [json-duplicate-keys v2025.6.6](https://github.com/truocphan/json-duplicate-keys/tree/2025.6.6)
 - [**Updated**] Added `skipDuplicated` parameter to `load` and `loads` functions to improve performance when parsing large JSON strings by skipping duplicate keys.
 

{json_duplicate_keys-2025.6.6 → json_duplicate_keys-2025.7.1}/README.md

@@ -30,8 +30,8 @@ python setup.py install
 ### normalize_key(`name`, `dupSign_start`="{{{", `dupSign_end`="}}}", `_isDebug_`=False)
 _Normalize Key name_
 - `name`: key name
-- `dupSign_start`: 
-- `dupSign_end`: 
+- `dupSign_start`: Start symbol for marking duplicates (default: `{{{`)
+- `dupSign_end`: End symbol for marking duplicates (default: `}}}`)
 - `_isDebug_`: Show/ Hide debug error messages
 ```python
 import json_duplicate_keys as jdks
@@ -44,8 +44,8 @@ print(jdks.normalize_key("version{{{_2_}}}"))
 ### loads(`Jstr`, `dupSign_start`="{{{", `dupSign_end`="}}}", `ordered_dict`=False, `skipDuplicated`=False, `_isDebug_`=False)
 _Deserialize a JSON format string to a class `JSON_DUPLICATE_KEYS`_
 - `Jstr`: a JSON format string
-- `dupSign_start`: 
-- `dupSign_end`: 
+- `dupSign_start`: Start symbol for marking duplicates (default: `{{{`)
+- `dupSign_end`: End symbol for marking duplicates (default: `}}}`)
 - `ordered_dict`: preserves the order in which the Keys are inserted
 - `skipDuplicated`: Skip loading duplicate keys to improve execution performance
 - `_isDebug_`: Show/ Hide debug error messages
@@ -64,8 +64,8 @@ print(JDKSObject)
 ### load(`Jfilepath`, `dupSign_start`="{{{", `dupSign_end`="}}}", `ordered_dict`=False, `skipDuplicated`=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`: 
+- `dupSign_start`: Start symbol for marking duplicates (default: `{{{`)
+- `dupSign_end`: End symbol for marking duplicates (default: `}}}`)
 - `ordered_dict`: preserves the order in which the Keys are inserted
 - `skipDuplicated`: Skip loading duplicate keys to improve execution performance
 - `_isDebug_`: Show/ Hide debug error messages
@@ -101,8 +101,8 @@ print(JDKSObject.getObject())
 _Get value in the JSON object by `name`_
 - `name`: the key name of the JSON object. Supported flatten key name format
 - `case_insensitive`: the key name case (in)sensitive
-- `separator`: 
-- `parse_index`:
+- `separator`: Separator for flatten keys (default: `||`)
+- `parse_index`: Symbol for index parsing (default: `$`)
 - `_isDebug_`: Show/ Hide debug error messages
 ```python
 import json_duplicate_keys as jdks
@@ -127,10 +127,10 @@ _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`
 - `case_insensitive`: the key name case (in)sensitive
-- `separator`: 
-- `parse_index`: 
-- `dupSign_start`: 
-- `dupSign_end`: 
+- `separator`: Separator for flatten keys (default: `||`)
+- `parse_index`: Symbol for index parsing (default: `$`)
+- `dupSign_start`: Start symbol for marking duplicates (default: `{{{`)
+- `dupSign_end`: End symbol for marking duplicates (default: `}}}`)
 - `ordered_dict`: preserves the order in which the Keys are inserted
 - `_isDebug_`: Show/Hide debug error messages
 ```python
@@ -165,25 +165,6 @@ print(JDKSObject.getObject())
 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'}]}]
 ```
 ---
 
@@ -193,10 +174,10 @@ _Insert `value` at `position` in value list of `name`_
 - `value`: new value for key `name`
 - `position`: position of the `value` to insert (default insert at the last position of the list)
 - `case_insensitive`: the key name case (in)sensitive
-- `separator`: 
-- `parse_index`: 
-- `dupSign_start`: 
-- `dupSign_end`: 
+- `separator`: Separator for flatten keys (default: `||`)
+- `parse_index`: Symbol for index parsing (default: `$`)
+- `dupSign_start`: Start symbol for marking duplicates (default: `{{{`)
+- `dupSign_end`: End symbol for marking duplicates (default: `}}}`)
 - `_isDebug_`: Show/ Hide debug error messages
 ```python
 import json_duplicate_keys as jdks
@@ -222,10 +203,10 @@ _Update new `value` for existing `name` or Set a new `name` in the JSON object_
 - `value`: new value for key `name`
 - `case_insensitive`: the key name case (in)sensitive
 - `allow_new_key`: allows to create a new key name if the key name does not exist
-- `separator`: 
-- `parse_index`: 
-- `dupSign_start`: 
-- `dupSign_end`: 
+- `separator`: Separator for flatten keys (default: `||`)
+- `parse_index`: Symbol for index parsing (default: `$`)
+- `dupSign_start`: Start symbol for marking duplicates (default: `{{{`)
+- `dupSign_end`: End symbol for marking duplicates (default: `}}}`)
 - `ordered_dict`: preserves the order in which the Keys are inserted
 - `_isDebug_`: Show/ Hide debug error messages
 ```python
@@ -250,8 +231,8 @@ print(JDKSObject.getObject())
 _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
 - `case_insensitive`: the key name case (in)sensitive
-- `separator`: 
-- `parse_index`: 
+- `separator`: Separator for flatten keys (default: `||`)
+- `parse_index`: Symbol for index parsing (default: `$`)
 - `_isDebug_`: Show/ Hide debug error messages
 ```python
 import json_duplicate_keys as jdks
@@ -273,10 +254,10 @@ print(JDKSObject.getObject())
 ---
 
 ### JSON_DUPLICATE_KEYS.filter_keys(`name`, `separator`="||", `parse_index`="$", `ordered_dict`=False)
-
+_Return a `JSON_DUPLICATE_KEYS` object with keys matching a pattern_
 - `name`:
-- `separator`:
-- `parse_index`:
+- `separator`: Separator for flatten keys (default: `||`)
+- `parse_index`: Symbol for index parsing (default: `$`)
 - `ordered_dict`: preserves the order in which the Keys are inserted
 ```python
 import json_duplicate_keys as jdks
@@ -294,10 +275,10 @@ print(JDKSObject.dumps())
 ---
 
 ### JSON_DUPLICATE_KEYS.filter_values(`value`, `separator`="||", `parse_index`="$", `ordered_dict`=False)
-
+_Return a `JSON_DUPLICATE_KEYS` object with values matching a pattern_
 - `value`:
-- `separator`:
-- `parse_index`:
+- `separator`: Separator for flatten keys (default: `||`)
+- `parse_index`: Symbol for index parsing (default: `$`)
 - `ordered_dict`: preserves the order in which the Keys are inserted
 ```python
 import json_duplicate_keys as jdks
@@ -316,8 +297,8 @@ print(JDKSObject.dumps())
 
 ### 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`: 
+- `dupSign_start`: Start symbol for marking duplicates (default: `{{{`)
+- `dupSign_end`: End symbol for marking duplicates (default: `}}}`)
 - `_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
@@ -342,8 +323,8 @@ print(JDKSObject.dumps())
 ### 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`: 
+- `dupSign_start`: Start symbol for marking duplicates (default: `{{{`)
+- `dupSign_end`: End symbol for marking duplicates (default: `}}}`)
 - `_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
@@ -371,8 +352,8 @@ print(JDKSObject_load.getObject())
 
 ### 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`: 
+- `separator`: Separator for flatten keys (default: `||`)
+- `parse_index`: Symbol for index parsing (default: `$`)
 - `ordered_dict`: preserves the order in which the Keys are inserted
 - `_isDebug_`: Show/ Hide debug error messages
 ```python
@@ -394,8 +375,8 @@ print(JDKSObject.getObject())
 
 ### 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`: 
+- `separator`: Separator for flatten keys (default: `||`)
+- `parse_index`: Symbol for index parsing (default: `$`)
 - `ordered_dict`: preserves the order in which the Keys are inserted
 - `_isDebug_`: Show/ Hide debug error messages
 ```python
@@ -416,6 +397,11 @@ print(JDKSObject.getObject())
 ---
 
 ## CHANGELOG
+#### [json-duplicate-keys v2025.7.1](https://github.com/truocphan/json-duplicate-keys/tree/2025.7.1)
+- [**Updated**] Fixed some issues when loading JSON strings with `skipDuplicated` option
+- [**Updated**] Allow loading of JSON data in byte string format
+- [**Updated**] Issue with getting and setting an empty list
+
 #### [json-duplicate-keys v2025.6.6](https://github.com/truocphan/json-duplicate-keys/tree/2025.6.6)
 - [**Updated**] Added `skipDuplicated` parameter to `load` and `loads` functions to improve performance when parsing large JSON strings by skipping duplicate keys.
 

{json_duplicate_keys-2025.6.6 → json_duplicate_keys-2025.7.1}/json_duplicate_keys/__init__.py

@@ -1,5 +1,6 @@
 # -*- coding: utf-8 -*-
-json_duplicate_keys_VERSION = "2025.6.6"
+json_duplicate_keys_VERSION = "2025.7.1"
+
 try:
 	unicode # Python 2
 except NameError:
@@ -36,10 +37,12 @@ def loads(Jstr, dupSign_start="{{{", dupSign_end="}}}", ordered_dict=False, skip
 	# User input data type validation
 	if type(_isDebug_) != bool: _isDebug_ = False
 
+	if type(skipDuplicated) != bool: skipDuplicated = False
+
 	if type(ordered_dict) != bool: ordered_dict = False
 
-	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)))
+	if type(Jstr) not in [str, unicode, bytes]:
+		if _isDebug_: print("\x1b[31m[-] DataTypeError: the JSON object must be str, unicode or bytes, not {}\x1b[0m".format(type(Jstr)))
 		return False
 
 	if type(dupSign_start) not in [str, unicode]: dupSign_start = "{{{"
@@ -95,7 +98,11 @@ def loads(Jstr, dupSign_start="{{{", dupSign_end="}}}", ordered_dict=False, skip
 		if ordered_dict: Jloads = json.loads(Jstr, object_pairs_hook=OrderedDict)
 
 		if skipDuplicated:
-			return JSON_DUPLICATE_KEYS(Jloads)
+			if type(Jloads) in [list, dict, OrderedDict]:
+				return JSON_DUPLICATE_KEYS(Jloads)
+			else:
+				if _isDebug_: print("\x1b[31m[-] DataError: Invalid JSON format\x1b[0m")
+				return False
 
 		if type(Jloads) in [list, dict, OrderedDict]:
 			dupSign_start_escape = "".join(["\\\\u"+hex(ord(c))[2:].zfill(4) for c in dupSign_start])
@@ -105,23 +112,41 @@ def loads(Jstr, dupSign_start="{{{", dupSign_end="}}}", ordered_dict=False, skip
 			dupSign_end_escape_regex = re.escape(dupSign_end)
 
 
-			Jstr = re.sub(r'\\\\', '\x00\x01', Jstr)
-			Jstr = re.sub(r'\\"', '\x02\x03', Jstr)
-			Jstr = re.sub(r'"([^"]*)"[\s\t\r\n]*([,\]}])', '\x04\x05\\1\x04\x05\\2', Jstr)
+			if type(Jstr) == bytes:
+				Jstr = re.sub(r'\\\\'.encode(), '\x00\x01'.encode(), Jstr)
+				Jstr = re.sub(r'\\"'.encode(), '\x02\x03'.encode(), Jstr)
+				Jstr = re.sub(r'"([^"]*)"[\s\t\r\n]*([,\]}])'.encode(), '\x04\x05\\1\x04\x05\\2'.encode(), Jstr)
+
 
+				Jstr = re.sub(r'"([^"]+)"[\s\t\r\n]*:'.encode(), r'"\1{dupSign_start}_dupSign_{dupSign_end}":'.format(dupSign_start=dupSign_start_escape, dupSign_end=dupSign_end_escape).encode(), Jstr)
 
-			Jstr = re.sub(r'"([^"]+)"[\s\t\r\n]*:', r'"\1{dupSign_start}_dupSign_{dupSign_end}":'.format(dupSign_start=dupSign_start_escape, dupSign_end=dupSign_end_escape), Jstr)
+				Jstr = re.sub(r'""[\s\t\r\n]*:'.encode(), '"{dupSign_start}_dupSign_{dupSign_end}":'.format(dupSign_start=dupSign_start_escape, dupSign_end=dupSign_end_escape).encode(), Jstr)
 
-			Jstr = re.sub(r'""[\s\t\r\n]*:', '"{dupSign_start}_dupSign_{dupSign_end}":'.format(dupSign_start=dupSign_start_escape, dupSign_end=dupSign_end_escape), Jstr)
+				i = 0
+				while re.search(r'{dupSign_start}_dupSign_{dupSign_end}"[\s\t\r\n]*:'.format(dupSign_start=dupSign_start_escape, dupSign_end=dupSign_end_escape).encode(), Jstr):
+					Jstr = re.sub(r'{dupSign_start}_dupSign_{dupSign_end}"[\s\t\r\n]*:'.format(dupSign_start=dupSign_start_escape, dupSign_end=dupSign_end_escape).encode(), (dupSign_start_escape+"_"+str(i)+"_"+dupSign_end_escape+'":').encode(), Jstr, 1)
+					i += 1
 
-			i = 0
-			while re.search(r'{dupSign_start}_dupSign_{dupSign_end}"[\s\t\r\n]*:'.format(dupSign_start=dupSign_start_escape, dupSign_end=dupSign_end_escape), Jstr):
-				Jstr = re.sub(r'{dupSign_start}_dupSign_{dupSign_end}"[\s\t\r\n]*:'.format(dupSign_start=dupSign_start_escape, dupSign_end=dupSign_end_escape), dupSign_start_escape+"_"+str(i)+"_"+dupSign_end_escape+'":', Jstr, 1)
-				i += 1
+				Jstr = re.sub('\x00\x01'.encode(), r'\\\\'.encode(), Jstr)
+				Jstr = re.sub('\x02\x03'.encode(), r'\\"'.encode(), Jstr)
+				Jstr = re.sub('\x04\x05'.encode(), r'"'.encode(), Jstr)
+			else:
+				Jstr = re.sub(r'\\\\', '\x00\x01', Jstr)
+				Jstr = re.sub(r'\\"', '\x02\x03', Jstr)
+				Jstr = re.sub(r'"([^"]*)"[\s\t\r\n]*([,\]}])', '\x04\x05\\1\x04\x05\\2', Jstr)
+
+				Jstr = re.sub(r'"([^"]+)"[\s\t\r\n]*:', r'"\1{dupSign_start}_dupSign_{dupSign_end}":'.format(dupSign_start=dupSign_start_escape, dupSign_end=dupSign_end_escape), Jstr)
+
+				Jstr = re.sub(r'""[\s\t\r\n]*:', '"{dupSign_start}_dupSign_{dupSign_end}":'.format(dupSign_start=dupSign_start_escape, dupSign_end=dupSign_end_escape), Jstr)
 
-			Jstr = re.sub('\x00\x01', r'\\\\', Jstr)
-			Jstr = re.sub('\x02\x03', r'\\"', Jstr)
-			Jstr = re.sub('\x04\x05', r'"', Jstr)
+				i = 0
+				while re.search(r'{dupSign_start}_dupSign_{dupSign_end}"[\s\t\r\n]*:'.format(dupSign_start=dupSign_start_escape, dupSign_end=dupSign_end_escape), Jstr):
+					Jstr = re.sub(r'{dupSign_start}_dupSign_{dupSign_end}"[\s\t\r\n]*:'.format(dupSign_start=dupSign_start_escape, dupSign_end=dupSign_end_escape), dupSign_start_escape+"_"+str(i)+"_"+dupSign_end_escape+'":', Jstr, 1)
+					i += 1
+
+				Jstr = re.sub('\x00\x01', r'\\\\', Jstr)
+				Jstr = re.sub('\x02\x03', r'\\"', Jstr)
+				Jstr = re.sub('\x04\x05', r'"', Jstr)
 
 			Jloads = json.loads(Jstr)
 			if ordered_dict:
@@ -153,13 +178,11 @@ def loads(Jstr, dupSign_start="{{{", dupSign_end="}}}", ordered_dict=False, skip
 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
 def load(Jfilepath, dupSign_start="{{{", dupSign_end="}}}", ordered_dict=False, skipDuplicated=False, _isDebug_=False):
 	try:
-		with open(Jfilepath) as Jfile:
-			Jstr = Jfile.read()
-
-		return loads(Jstr, dupSign_start=dupSign_start, dupSign_end=dupSign_end, ordered_dict=ordered_dict, skipDuplicated=skipDuplicated, _isDebug_=_isDebug_)
+		with open(Jfilepath) as Jfile: Jstr = Jfile.read()
 	except Exception as e:
-		if _isDebug_: print("\x1b[31m[-] ExceptionError: {}\x1b[0m".format(e))
-		return False
+		with open(Jfilepath, "rb") as Jfile: Jstr = Jfile.read()
+
+	return loads(Jstr, dupSign_start=dupSign_start, dupSign_end=dupSign_end, ordered_dict=ordered_dict, skipDuplicated=skipDuplicated, _isDebug_=_isDebug_)
 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
@@ -192,7 +215,7 @@ class JSON_DUPLICATE_KEYS:
 		# User input data type validation
 		if type(_isDebug_) != bool: _isDebug_ = False
 
-		if type(name) not in [str, unicode]: 
+		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)))
 			return {"name":name, "value":"JSON_DUPLICATE_KEYS_ERROR"}
 
@@ -215,16 +238,18 @@ class JSON_DUPLICATE_KEYS:
 		Jname = []
 		Jval = self.__Jobj
 		name_split = name.split(separator)
-		for k in Jobj.getObject().keys():
-			if len(k.split(separator)) >= len(name_split):
-				if case_insensitive:
-					if separator.join(k.split(separator)[:len(name_split)]).lower() == name.lower():
-						Jname = k.split(separator)[:len(name_split)]
-						break
-				else:
-					if separator.join(k.split(separator)[:len(name_split)]) == name:
-						Jname = name_split
-						break
+
+		if type(Jobj.getObject()) in [dict, OrderedDict]:
+			for k in Jobj.getObject().keys():
+				if len(k.split(separator)) >= len(name_split):
+					if case_insensitive:
+						if separator.join(k.split(separator)[:len(name_split)]).lower() == name.lower():
+							Jname = k.split(separator)[:len(name_split)]
+							break
+					else:
+						if separator.join(k.split(separator)[:len(name_split)]) == name:
+							Jname = name_split
+							break
 
 		if len(Jname) > 0:
 			for k in Jname:
@@ -250,7 +275,7 @@ class JSON_DUPLICATE_KEYS:
 
 		if type(ordered_dict) != bool: ordered_dict = False
 
-		if type(name) not in [str, unicode]: 
+		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)))
 			return False
 
@@ -297,8 +322,12 @@ class JSON_DUPLICATE_KEYS:
 			return True
 		else:
 			if len(name.split(separator)) == 1:
-				self.getObject()[name] = value
-				return True
+				if type(self.getObject()) in [dict, OrderedDict]:
+					self.getObject()[name] = value
+					return True
+				else:
+					if _isDebug_: print("\x1b[31m[-] DataTypeError: Cannot set name and value for a list object\x1b[0m")
+					return False
 			else:
 				if self.get(separator.join(name.split(separator)[:-1]), case_insensitive=case_insensitive, separator=separator, parse_index=parse_index)["value"] != "JSON_DUPLICATE_KEYS_ERROR":
 					Jget = self.get(separator.join(name.split(separator)[:-1]), case_insensitive=case_insensitive, separator=separator, parse_index=parse_index)
@@ -331,7 +360,7 @@ class JSON_DUPLICATE_KEYS:
 		# User input data type validation
 		if type(_isDebug_) != bool: _isDebug_ = False
 
-		if type(name) not in [str, unicode]: 
+		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)))
 			return False
 
@@ -376,7 +405,7 @@ class JSON_DUPLICATE_KEYS:
 		# User input data type validation
 		if type(_isDebug_) != bool: _isDebug_ = False
 
-		if type(name) not in [str, unicode]: 
+		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)))
 			return False
 
@@ -420,7 +449,7 @@ class JSON_DUPLICATE_KEYS:
 		# User input data type validation
 		if type(_isDebug_) != bool: _isDebug_ = False
 
-		if type(name) not in [str, unicode]: 
+		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)))
 			return False
 

{json_duplicate_keys-2025.6.6 → json_duplicate_keys-2025.7.1/json_duplicate_keys.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: json-duplicate-keys
-Version: 2025.6.6
+Version: 2025.7.1
 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
@@ -45,8 +45,8 @@ python setup.py install
 ### normalize_key(`name`, `dupSign_start`="{{{", `dupSign_end`="}}}", `_isDebug_`=False)
 _Normalize Key name_
 - `name`: key name
-- `dupSign_start`: 
-- `dupSign_end`: 
+- `dupSign_start`: Start symbol for marking duplicates (default: `{{{`)
+- `dupSign_end`: End symbol for marking duplicates (default: `}}}`)
 - `_isDebug_`: Show/ Hide debug error messages
 ```python
 import json_duplicate_keys as jdks
@@ -59,8 +59,8 @@ print(jdks.normalize_key("version{{{_2_}}}"))
 ### loads(`Jstr`, `dupSign_start`="{{{", `dupSign_end`="}}}", `ordered_dict`=False, `skipDuplicated`=False, `_isDebug_`=False)
 _Deserialize a JSON format string to a class `JSON_DUPLICATE_KEYS`_
 - `Jstr`: a JSON format string
-- `dupSign_start`: 
-- `dupSign_end`: 
+- `dupSign_start`: Start symbol for marking duplicates (default: `{{{`)
+- `dupSign_end`: End symbol for marking duplicates (default: `}}}`)
 - `ordered_dict`: preserves the order in which the Keys are inserted
 - `skipDuplicated`: Skip loading duplicate keys to improve execution performance
 - `_isDebug_`: Show/ Hide debug error messages
@@ -79,8 +79,8 @@ print(JDKSObject)
 ### load(`Jfilepath`, `dupSign_start`="{{{", `dupSign_end`="}}}", `ordered_dict`=False, `skipDuplicated`=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`: 
+- `dupSign_start`: Start symbol for marking duplicates (default: `{{{`)
+- `dupSign_end`: End symbol for marking duplicates (default: `}}}`)
 - `ordered_dict`: preserves the order in which the Keys are inserted
 - `skipDuplicated`: Skip loading duplicate keys to improve execution performance
 - `_isDebug_`: Show/ Hide debug error messages
@@ -116,8 +116,8 @@ print(JDKSObject.getObject())
 _Get value in the JSON object by `name`_
 - `name`: the key name of the JSON object. Supported flatten key name format
 - `case_insensitive`: the key name case (in)sensitive
-- `separator`: 
-- `parse_index`:
+- `separator`: Separator for flatten keys (default: `||`)
+- `parse_index`: Symbol for index parsing (default: `$`)
 - `_isDebug_`: Show/ Hide debug error messages
 ```python
 import json_duplicate_keys as jdks
@@ -142,10 +142,10 @@ _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`
 - `case_insensitive`: the key name case (in)sensitive
-- `separator`: 
-- `parse_index`: 
-- `dupSign_start`: 
-- `dupSign_end`: 
+- `separator`: Separator for flatten keys (default: `||`)
+- `parse_index`: Symbol for index parsing (default: `$`)
+- `dupSign_start`: Start symbol for marking duplicates (default: `{{{`)
+- `dupSign_end`: End symbol for marking duplicates (default: `}}}`)
 - `ordered_dict`: preserves the order in which the Keys are inserted
 - `_isDebug_`: Show/Hide debug error messages
 ```python
@@ -180,25 +180,6 @@ print(JDKSObject.getObject())
 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'}]}]
 ```
 ---
 
@@ -208,10 +189,10 @@ _Insert `value` at `position` in value list of `name`_
 - `value`: new value for key `name`
 - `position`: position of the `value` to insert (default insert at the last position of the list)
 - `case_insensitive`: the key name case (in)sensitive
-- `separator`: 
-- `parse_index`: 
-- `dupSign_start`: 
-- `dupSign_end`: 
+- `separator`: Separator for flatten keys (default: `||`)
+- `parse_index`: Symbol for index parsing (default: `$`)
+- `dupSign_start`: Start symbol for marking duplicates (default: `{{{`)
+- `dupSign_end`: End symbol for marking duplicates (default: `}}}`)
 - `_isDebug_`: Show/ Hide debug error messages
 ```python
 import json_duplicate_keys as jdks
@@ -237,10 +218,10 @@ _Update new `value` for existing `name` or Set a new `name` in the JSON object_
 - `value`: new value for key `name`
 - `case_insensitive`: the key name case (in)sensitive
 - `allow_new_key`: allows to create a new key name if the key name does not exist
-- `separator`: 
-- `parse_index`: 
-- `dupSign_start`: 
-- `dupSign_end`: 
+- `separator`: Separator for flatten keys (default: `||`)
+- `parse_index`: Symbol for index parsing (default: `$`)
+- `dupSign_start`: Start symbol for marking duplicates (default: `{{{`)
+- `dupSign_end`: End symbol for marking duplicates (default: `}}}`)
 - `ordered_dict`: preserves the order in which the Keys are inserted
 - `_isDebug_`: Show/ Hide debug error messages
 ```python
@@ -265,8 +246,8 @@ print(JDKSObject.getObject())
 _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
 - `case_insensitive`: the key name case (in)sensitive
-- `separator`: 
-- `parse_index`: 
+- `separator`: Separator for flatten keys (default: `||`)
+- `parse_index`: Symbol for index parsing (default: `$`)
 - `_isDebug_`: Show/ Hide debug error messages
 ```python
 import json_duplicate_keys as jdks
@@ -288,10 +269,10 @@ print(JDKSObject.getObject())
 ---
 
 ### JSON_DUPLICATE_KEYS.filter_keys(`name`, `separator`="||", `parse_index`="$", `ordered_dict`=False)
-
+_Return a `JSON_DUPLICATE_KEYS` object with keys matching a pattern_
 - `name`:
-- `separator`:
-- `parse_index`:
+- `separator`: Separator for flatten keys (default: `||`)
+- `parse_index`: Symbol for index parsing (default: `$`)
 - `ordered_dict`: preserves the order in which the Keys are inserted
 ```python
 import json_duplicate_keys as jdks
@@ -309,10 +290,10 @@ print(JDKSObject.dumps())
 ---
 
 ### JSON_DUPLICATE_KEYS.filter_values(`value`, `separator`="||", `parse_index`="$", `ordered_dict`=False)
-
+_Return a `JSON_DUPLICATE_KEYS` object with values matching a pattern_
 - `value`:
-- `separator`:
-- `parse_index`:
+- `separator`: Separator for flatten keys (default: `||`)
+- `parse_index`: Symbol for index parsing (default: `$`)
 - `ordered_dict`: preserves the order in which the Keys are inserted
 ```python
 import json_duplicate_keys as jdks
@@ -331,8 +312,8 @@ print(JDKSObject.dumps())
 
 ### 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`: 
+- `dupSign_start`: Start symbol for marking duplicates (default: `{{{`)
+- `dupSign_end`: End symbol for marking duplicates (default: `}}}`)
 - `_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
@@ -357,8 +338,8 @@ print(JDKSObject.dumps())
 ### 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`: 
+- `dupSign_start`: Start symbol for marking duplicates (default: `{{{`)
+- `dupSign_end`: End symbol for marking duplicates (default: `}}}`)
 - `_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
@@ -386,8 +367,8 @@ print(JDKSObject_load.getObject())
 
 ### 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`: 
+- `separator`: Separator for flatten keys (default: `||`)
+- `parse_index`: Symbol for index parsing (default: `$`)
 - `ordered_dict`: preserves the order in which the Keys are inserted
 - `_isDebug_`: Show/ Hide debug error messages
 ```python
@@ -409,8 +390,8 @@ print(JDKSObject.getObject())
 
 ### 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`: 
+- `separator`: Separator for flatten keys (default: `||`)
+- `parse_index`: Symbol for index parsing (default: `$`)
 - `ordered_dict`: preserves the order in which the Keys are inserted
 - `_isDebug_`: Show/ Hide debug error messages
 ```python
@@ -431,6 +412,11 @@ print(JDKSObject.getObject())
 ---
 
 ## CHANGELOG
+#### [json-duplicate-keys v2025.7.1](https://github.com/truocphan/json-duplicate-keys/tree/2025.7.1)
+- [**Updated**] Fixed some issues when loading JSON strings with `skipDuplicated` option
+- [**Updated**] Allow loading of JSON data in byte string format
+- [**Updated**] Issue with getting and setting an empty list
+
 #### [json-duplicate-keys v2025.6.6](https://github.com/truocphan/json-duplicate-keys/tree/2025.6.6)
 - [**Updated**] Added `skipDuplicated` parameter to `load` and `loads` functions to improve performance when parsing large JSON strings by skipping duplicate keys.