json-duplicate-keys 2025.6.6__py3-none-any.whl → 2025.8.19__py3-none-any.whl

json_duplicate_keys/__init__.py

@@ -1,9 +1,8 @@
 # -*- coding: utf-8 -*-
-json_duplicate_keys_VERSION = "2025.6.6"
 try:
-	unicode # Python 2
+	unicode
 except NameError:
-	unicode = str # Python 3
+	unicode = str
 
 from collections import OrderedDict
 import json, re, copy
@@ -23,7 +22,7 @@ def normalize_key(name, dupSign_start="{{{", dupSign_end="}}}", _isDebug_=False)
 
 	if type(dupSign_end) not in [str, unicode]: dupSign_end = "}}}"
 
-	return re.sub('{dupSign_start}_\\d+_{dupSign_end}$'.format(dupSign_start=re.escape(dupSign_start), dupSign_end=re.escape(dupSign_end)), "", name)
+	return re.sub(re.escape(dupSign_start)+'_\\d+_'+re.escape(dupSign_end)+'$', "", name)
 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
@@ -36,10 +35,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 +96,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 +110,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_escape+'_dupSign_'+dupSign_end_escape+'":').encode(), Jstr)
+
+				Jstr = re.sub(r'""[\s\t\r\n]*:'.encode(), ('"'+dupSign_start_escape+'_dupSign_'+dupSign_end_escape+'":').encode(), Jstr)
+
+				i = 0
+				while re.search((dupSign_start_escape+'_dupSign_'+dupSign_end_escape+r'"[\s\t\r\n]*:').encode(), Jstr):
+					Jstr = re.sub((dupSign_start_escape+'_dupSign_'+dupSign_end_escape+r'"[\s\t\r\n]*:').encode(), (dupSign_start_escape+"_"+str(i)+"_"+dupSign_end_escape+'":').encode(), 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]*:', r'"\1'+dupSign_start_escape+'_dupSign_'+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(r'""[\s\t\r\n]*:', '"'+dupSign_start_escape+'_dupSign_'+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), 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
+				i = 0
+				while re.search(dupSign_start_escape+'_dupSign_'+dupSign_end_escape+r'"[\s\t\r\n]*:', Jstr):
+					Jstr = re.sub(dupSign_start_escape+'_dupSign_'+dupSign_end_escape+r'"[\s\t\r\n]*:', 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)
+				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,8 +176,10 @@ 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()
+		try:
+			with open(Jfilepath) as Jfile: Jstr = Jfile.read()
+		except Exception as e:
+			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_)
 	except Exception as e:
@@ -192,7 +217,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 +240,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 +277,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 +324,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 +362,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 +407,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 +451,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
 
@@ -463,10 +494,10 @@ class JSON_DUPLICATE_KEYS:
 		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)
+					newJDKSObject.set(k, v, separator=u"§§"+separator+u"§§", parse_index=u"§§"+parse_index+u"§§", ordered_dict=ordered_dict)
 			else:
 				if name == k:
-					newJDKSObject.set(k, v, separator="§§"+separator+"§§", parse_index="§§"+parse_index+"§§", ordered_dict=ordered_dict)
+					newJDKSObject.set(k, v, separator=u"§§"+separator+u"§§", parse_index=u"§§"+parse_index+u"§§", ordered_dict=ordered_dict)
 
 		return newJDKSObject
 	# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
@@ -485,10 +516,10 @@ class JSON_DUPLICATE_KEYS:
 		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)
+					newJDKSObject.set(k, v, separator=u"§§"+separator+u"§§", parse_index=u"§§"+parse_index+u"§§", ordered_dict=ordered_dict)
 			else:
 				if value == v:
-					newJDKSObject.set(k, v, separator="§§"+separator+"§§", parse_index="§§"+parse_index+"§§", ordered_dict=ordered_dict)
+					newJDKSObject.set(k, v, separator=u"§§"+separator+u"§§", parse_index=u"§§"+parse_index+u"§§", ordered_dict=ordered_dict)
 
 		return newJDKSObject
 	# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
@@ -515,7 +546,7 @@ class JSON_DUPLICATE_KEYS:
 
 		dupSign_end_escape_regex = re.escape(json.dumps({dupSign_end:""})[2:-6])
 
-		return re.sub('{dupSign_start}_\\d+_{dupSign_end}":'.format(dupSign_start=dupSign_start_escape_regex, dupSign_end=dupSign_end_escape_regex), '":', json.dumps(self.getObject(), skipkeys=skipkeys, ensure_ascii=ensure_ascii, check_circular=check_circular, allow_nan=allow_nan, cls=cls, indent=indent, separators=separators, default=default, sort_keys=sort_keys))
+		return re.sub(dupSign_start_escape_regex+'_\\d+_'+dupSign_end_escape_regex+'":', '":', json.dumps(self.getObject(), skipkeys=skipkeys, ensure_ascii=ensure_ascii, check_circular=check_circular, allow_nan=allow_nan, cls=cls, indent=indent, separators=separators, default=default, sort_keys=sort_keys))
 	# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
 	# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
 	# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
@@ -528,8 +559,8 @@ class JSON_DUPLICATE_KEYS:
 		Jstr = self.dumps(dupSign_start=dupSign_start, dupSign_end=dupSign_end, _isDebug_=_isDebug_, skipkeys=skipkeys, ensure_ascii=ensure_ascii, check_circular=check_circular, allow_nan=allow_nan, cls=cls, indent=indent, separators=separators, default=default, sort_keys=sort_keys)
 
 		try:
-			Jfile = open(Jfilepath, "w")
-			Jfile.write(Jstr)
+			Jfile = open(Jfilepath, "wb")
+			Jfile.write(Jstr.encode("utf-8"))
 			Jfile.close()
 		except Exception as e:
 			if _isDebug_: print("\x1b[31m[-] ExceptionError: {}\x1b[0m".format(e))
@@ -571,7 +602,7 @@ class JSON_DUPLICATE_KEYS:
 						else:
 							for k,v in Jobj.items():
 								_Jobj = v
-								_key = "{key}{separator}{k}".format(key=key,separator=separator,k=k) if key != None else "{k}".format(k=k)
+								_key = key+separator+k if key != None else k
 
 								__convert_Jobj_to_Jflat(_Jobj, _key)
 					elif type(Jobj) == list:
@@ -580,7 +611,7 @@ class JSON_DUPLICATE_KEYS:
 						else:
 							for i,v in enumerate(Jobj):
 								_Jobj = v
-								_key = "{key}{separator}{parse_index}{i}{parse_index}".format(key=key, separator=separator, parse_index=parse_index, i=i) if key != None else "{parse_index}{i}{parse_index}".format(parse_index=parse_index, i=i)
+								_key = key+separator+parse_index+str(i)+parse_index if key != None else parse_index+str(i)+parse_index
 
 								__convert_Jobj_to_Jflat(_Jobj, _key)
 					else:

{json_duplicate_keys-2025.6.6.dist-info → json_duplicate_keys-2025.8.19.dist-info}/METADATA

@@ -1,32 +1,51 @@
 Metadata-Version: 2.1
 Name: json-duplicate-keys
-Version: 2025.6.6
+Version: 2025.8.19
 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
+Author-email: TP Cyber Security <tpcybersec2023@gmail.com>
+License: 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.
+Project-URL: Homepage, https://github.com/tpcybersec/json-duplicate-keys
 Keywords: TPCyberSec,json,duplicate keys,json duplicate keys,flatten,unflatten
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 2
 Classifier: Programming Language :: Python :: Implementation :: Jython
 Description-Content-Type: text/markdown
 License-File: LICENSE
 
-# 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>
+<div align="center">
+	<h1>JSON Duplicate Keys - PyPI</h1>
+	<i>Flatten/ Unflatten and Load(s)/ Dump(s) JSON File/ Object with Duplicate Keys</i>
+	<br><br>
+	<a href="https://github.com/tpcybersec/json-duplicate-keys/releases/"><img src="https://img.shields.io/github/release/tpcybersec/json-duplicate-keys" height=30></a>
+	<a href="#"><img src="https://img.shields.io/github/downloads/tpcybersec/json-duplicate-keys/total" height=30></a>
+	<a href="#"><img src="https://img.shields.io/github/stars/tpcybersec/json-duplicate-keys" height=30></a>
+	<a href="#"><img src="https://img.shields.io/github/forks/tpcybersec/json-duplicate-keys" height=30></a>
+	<a href="https://github.com/tpcybersec/json-duplicate-keys/issues?q=is%3Aopen+is%3Aissue"><img src="https://img.shields.io/github/issues/tpcybersec/json-duplicate-keys" height=30></a>
+	<a href="https://github.com/tpcybersec/json-duplicate-keys/issues?q=is%3Aissue+is%3Aclosed"><img src="https://img.shields.io/github/issues-closed/tpcybersec/json-duplicate-keys" height=30></a>
 	<br>
 	<a href="#"><img src="https://img.shields.io/pypi/v/json-duplicate-keys" height=30></a>
+	<a href="#"><img src="https://img.shields.io/pypi/pyversions/json-duplicate-keys" height=30></a>
 	<a href="#"><img src="https://img.shields.io/pypi/dm/json-duplicate-keys" height=30></a>
-</p>
+</div>
 
 ## Installation
 #### From PyPI:
@@ -35,18 +54,18 @@ pip install json-duplicate-keys
 ```
 #### From Source:
 ```console
-git clone https://github.com/truocphan/json-duplicate-keys.git --branch <Branch/Tag>
+git clone https://github.com/tpcybersec/json-duplicate-keys.git --branch <Branch/Tag>
 cd json-duplicate-keys
-python setup.py build
-python setup.py install
+python -m build
+python -m pip install dist/json_duplicate_keys-<version>-py3-none-any.whl
 ```
 
 ## Basic Usage
 ### 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 +78,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 +98,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 +135,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 +161,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 +199,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 +208,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 +237,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 +265,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 +288,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 +309,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 +331,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 +357,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 +386,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 +409,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,25 +431,34 @@ print(JDKSObject.getObject())
 ---
 
 ## CHANGELOG
-#### [json-duplicate-keys v2025.6.6](https://github.com/truocphan/json-duplicate-keys/tree/2025.6.6)
+#### [json-duplicate-keys v2025.8.19](https://github.com/tpcybersec/json-duplicate-keys/tree/2025.8.19)
+- [**Updated**] Add an exception when loading a non-existent file
+- [**Updated**] Dump Unicode characters to a file
+
+#### [json-duplicate-keys v2025.7.1](https://github.com/tpcybersec/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/tpcybersec/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 v2024.12.12](https://github.com/truocphan/json-duplicate-keys/tree/2024.12.12)
+#### [json-duplicate-keys v2024.12.12](https://github.com/tpcybersec/json-duplicate-keys/tree/2024.12.12)
 - **New**: _insert_ function
 
-#### [json-duplicate-keys v2024.11.28](https://github.com/truocphan/json-duplicate-keys/tree/2024.11.28)
+#### [json-duplicate-keys v2024.11.28](https://github.com/tpcybersec/json-duplicate-keys/tree/2024.11.28)
 - **Fixed**: Add subkey name to empty dict of existing key name
 
-#### [json-duplicate-keys v2024.11.19](https://github.com/truocphan/json-duplicate-keys/tree/2024.11.19)
+#### [json-duplicate-keys v2024.11.19](https://github.com/tpcybersec/json-duplicate-keys/tree/2024.11.19)
 - **Updated**: Allows getting (`JSON_DUPLICATE_KEYS.get`), setting (`JSON_DUPLICATE_KEYS.set`), updating (`JSON_DUPLICATE_KEYS.update`), deleting (`JSON_DUPLICATE_KEYS.delete`) JSON_DUPLICATE_KEYS objects with case-insensitive key names
 
-#### [json-duplicate-keys v2024.7.17](https://github.com/truocphan/json-duplicate-keys/tree/2024.7.17)
-- **Fixed**: issue [#3](https://github.com/truocphan/json-duplicate-keys/issues/3) break the set function when the key's value is empty. Thanks [ptth222](https://github.com/ptth222) for reporting this issue.
+#### [json-duplicate-keys v2024.7.17](https://github.com/tpcybersec/json-duplicate-keys/tree/2024.7.17)
+- **Fixed**: issue #3 break the set function when the key's value is empty. Thanks [ptth222](https://github.com/ptth222) for reporting this issue.
 
-#### [json-duplicate-keys v2024.4.20](https://github.com/truocphan/json-duplicate-keys/tree/2024.4.20)
+#### [json-duplicate-keys v2024.4.20](https://github.com/tpcybersec/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)
+#### [json-duplicate-keys v2024.3.24](https://github.com/tpcybersec/json-duplicate-keys/tree/2024.3.24)
 - **Updated**: _normalize_key_, _loads_, _get_, _set_, _update_, _delete_
 ---

json_duplicate_keys-2025.8.19.dist-info/RECORD

@@ -0,0 +1,6 @@
+json_duplicate_keys/__init__.py,sha256=j-jA6opC7If-__TFmt86AKtw9h7msoSUkUPpfUZ3YP4,30097
+json_duplicate_keys-2025.8.19.dist-info/LICENSE,sha256=_hudSGMciUc27wGR8EMKfeb3atJRlf6rbhJtLnel-nc,1093
+json_duplicate_keys-2025.8.19.dist-info/METADATA,sha256=g8CkjaHAODINJs7QvcCyilmGzbQnLKVWX6r9G1guWHY,24279
+json_duplicate_keys-2025.8.19.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
+json_duplicate_keys-2025.8.19.dist-info/top_level.txt,sha256=vdsGrPLVS_l-BFL1i4hCJBY5_-gq4Cwp-11yegA750Y,20
+json_duplicate_keys-2025.8.19.dist-info/RECORD,,

json_duplicate_keys-2025.6.6.dist-info/RECORD

@@ -1,6 +0,0 @@
-json_duplicate_keys/__init__.py,sha256=vxG-My8fNJiG90q6flLf0_vmOJVyWjjm96ESP1grFn8,29024
-json_duplicate_keys-2025.6.6.dist-info/LICENSE,sha256=_hudSGMciUc27wGR8EMKfeb3atJRlf6rbhJtLnel-nc,1093
-json_duplicate_keys-2025.6.6.dist-info/METADATA,sha256=BELit1CyMqG530hTLEkU43h1sxcx7r0JE7o0Vv34rzs,21194
-json_duplicate_keys-2025.6.6.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
-json_duplicate_keys-2025.6.6.dist-info/top_level.txt,sha256=vdsGrPLVS_l-BFL1i4hCJBY5_-gq4Cwp-11yegA750Y,20
-json_duplicate_keys-2025.6.6.dist-info/RECORD,,