json-duplicate-keys 2025.7.1__py3-none-any.whl → 2025.9.9__py3-none-any.whl

json_duplicate_keys/__init__.py

@@ -1,10 +1,8 @@
 # -*- coding: utf-8 -*-
-json_duplicate_keys_VERSION = "2025.7.1"
-
 try:
-	unicode # Python 2
+	unicode
 except NameError:
-	unicode = str # Python 3
+	unicode = str
 
 from collections import OrderedDict
 import json, re, copy
@@ -24,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)
 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
@@ -118,13 +116,13 @@ def loads(Jstr, dupSign_start="{{{", dupSign_end="}}}", ordered_dict=False, skip
 				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]*:'.encode(), (r'"\1'+dupSign_start_escape+'_dupSign_'+dupSign_end_escape+'":').encode(), 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]*:'.encode(), ('"'+dupSign_start_escape+'_dupSign_'+dupSign_end_escape+'":').encode(), 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)
+				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)
@@ -135,13 +133,13 @@ def loads(Jstr, dupSign_start="{{{", dupSign_end="}}}", ordered_dict=False, skip
 				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)
+				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)
@@ -178,11 +176,15 @@ 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()
-	except Exception as e:
-		with open(Jfilepath, "rb") 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_)
+		return loads(Jstr, dupSign_start=dupSign_start, dupSign_end=dupSign_end, ordered_dict=ordered_dict, skipDuplicated=skipDuplicated, _isDebug_=_isDebug_)
+	except Exception as e:
+		if _isDebug_: print("\x1b[31m[-] ExceptionError: {}\x1b[0m".format(e))
+		return False
 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
@@ -360,8 +362,8 @@ class JSON_DUPLICATE_KEYS:
 		# User input data type validation
 		if type(_isDebug_) != bool: _isDebug_ = False
 
-		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)))
+		if type(name) not in [str, unicode, type(None)]:
+			if _isDebug_: print("\x1b[31m[-] DataTypeError: the KEY name must be str, unicode or None, not {}\x1b[0m".format(type(name)))
 			return False
 
 		if type(position) != int: position = None
@@ -379,6 +381,12 @@ class JSON_DUPLICATE_KEYS:
 		if type(self.getObject()) not in [list, dict, OrderedDict]:
 			if _isDebug_: print("\x1b[31m[-] DataTypeError: the JSON object must be list, dict or OrderedDict, not {}\x1b[0m".format(type(self.getObject())))
 			return False
+		
+		if (name is None or name == "") and type(self.getObject()) == list:
+			if position is None: position = len(self.getObject())
+
+			self.getObject().insert(position, value)
+			return True
 
 		if re.search(re.escape(separator)+"$", name):
 			if _isDebug_: print("\x1b[31m[-] KeyNameInvalidError: \x1b[0m"+name)
@@ -492,10 +500,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
 	# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
@@ -514,10 +522,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
 	# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
@@ -544,7 +552,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))
 	# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
 	# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
 	# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
@@ -557,8 +565,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))
@@ -600,7 +608,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:
@@ -609,7 +617,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.7.1.dist-info → json_duplicate_keys-2025.9.9.dist-info}/METADATA

@@ -1,47 +1,48 @@
 Metadata-Version: 2.1
 Name: json-duplicate-keys
-Version: 2025.7.1
+Version: 2025.9.9
 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
+Author-email: TP Cyber Security <tpcybersec2023@gmail.com>
 License: MIT
+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
+---
+# 🛠️ 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>
+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
+---
+# 📘 Basic Usage
 ### normalize_key(`name`, `dupSign_start`="{{{", `dupSign_end`="}}}", `_isDebug_`=False)
 _Normalize Key name_
 - `name`: key name
@@ -54,8 +55,8 @@ import json_duplicate_keys as jdks
 print(jdks.normalize_key("version{{{_2_}}}"))
 # OUTPUT: version
 ```
----
 
+---
 ### 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
@@ -74,8 +75,8 @@ 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, `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
@@ -96,8 +97,8 @@ 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
@@ -110,8 +111,8 @@ 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`, `case_insensitive`=False, `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
@@ -135,8 +136,8 @@ print(JDKSObject.get("release||$0$"))
 print(JDKSObject.get("snapshot||author"))
 # OUTPUT: {'name': 'snapshot||author', 'value': 'truocphan'}
 ```
----
 
+---
 ### JSON_DUPLICATE_KEYS.set(`name`, `value`, `case_insensitive`=False, `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
@@ -181,8 +182,8 @@ JDKSObject.set("snapshot||author", "truocphan")
 print(JDKSObject.getObject())
 # OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': 'latest', 'release': [{'version': 'latest'}], 'snapshot': {'author': 'truocphan'}}
 ```
----
 
+---
 ### JSON_DUPLICATE_KEYS.insert(`name`, `value`, `position`=None, `case_insensitive`=False, `separator`="||", `parse_index`="$", `dupSign_start`="{{{", `dupSign_end`="}}}", `_isDebug_`=False)
 _Insert `value` at `position` in value list of `name`_
 - `name`: the key name of the JSON object. Supported flatten key name format
@@ -209,9 +210,19 @@ JDKSObject.insert("snapshot||release", {'version': '2025.1.1'}, 0)
 
 print(JDKSObject.getObject())
 # OUTPUT: {'author': 'truocphan', 'version': '22.3.3', 'version{{{_2_}}}': 'latest', 'release': [{'version': 'latest'}, {'version': '2025.1.1'}], 'snapshot': {'author': 'truocphan', 'version': '22.3.3', 'release': [{'version': '2025.1.1'}, {'version': 'latest'}]}}
+
+
+JDKSObject = jdks.loads("[]")
+
+JDKSObject.insert(None, {"release": []})
+JDKSObject.insert(None, {"author": "truocphan"}, 0)
+JDKSObject.insert("$1$||release", {"version": "2025.9.9"})
+
+print(JDKSObject.getObject())
+# OUTPUT: [{'author': 'truocphan'}, {'release': [{'version': '2025.9.9'}]}]
 ```
----
 
+---
 ### JSON_DUPLICATE_KEYS.update(`name`, `value`, `case_insensitive`=False, `allow_new_key`=False, `separator`="||", `parse_index`="$", `dupSign_start`="{{{", `dupSign_end`="}}}", `ordered_dict`=False, `_isDebug_`=False)
 _Update new `value` for existing `name` or Set a new `name` in the JSON object_
 - `name`: the key name of the JSON object. Supported flatten key name format
@@ -240,8 +251,8 @@ 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`, `case_insensitive`=False, `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
@@ -266,8 +277,8 @@ 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)
 _Return a `JSON_DUPLICATE_KEYS` object with keys matching a pattern_
 - `name`:
@@ -287,8 +298,8 @@ print(JDKSObject.filter_keys("version").dumps())
 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)
 _Return a `JSON_DUPLICATE_KEYS` object with values matching a pattern_
 - `value`:
@@ -308,8 +319,8 @@ print(JDKSObject.filter_values("latest").dumps())
 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`: Start symbol for marking duplicates (default: `{{{`)
@@ -333,8 +344,8 @@ 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
@@ -363,8 +374,8 @@ 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`: Separator for flatten keys (default: `||`)
@@ -386,8 +397,8 @@ 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`: Separator for flatten keys (default: `||`)
@@ -409,33 +420,41 @@ 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 v2025.9.9](https://github.com/TPCyberSec/json-duplicate-keys/tree/2025.9.9)
+- **Fixed**: Inserting a value with an `empty` or `null` name
 
-## 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.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.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 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 v2024.12.12](https://github.com/truocphan/json-duplicate-keys/tree/2024.12.12)
+### [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/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.9.9.dist-info/RECORD

@@ -0,0 +1,6 @@
+json_duplicate_keys/__init__.py,sha256=Ns_b4ZkssTizVwPQmpStuspo_FRLhJOWy_raNJ7I63I,30311
+json_duplicate_keys-2025.9.9.dist-info/LICENSE,sha256=_hudSGMciUc27wGR8EMKfeb3atJRlf6rbhJtLnel-nc,1093
+json_duplicate_keys-2025.9.9.dist-info/METADATA,sha256=SXON-ghmCMYFVuxKsEFIbF4tjfsyJZKdZDp8CY5Yx5E,23508
+json_duplicate_keys-2025.9.9.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
+json_duplicate_keys-2025.9.9.dist-info/top_level.txt,sha256=vdsGrPLVS_l-BFL1i4hCJBY5_-gq4Cwp-11yegA750Y,20
+json_duplicate_keys-2025.9.9.dist-info/RECORD,,

json_duplicate_keys-2025.7.1.dist-info/RECORD

@@ -1,6 +0,0 @@
-json_duplicate_keys/__init__.py,sha256=ClhnGD0jyYwBRsOs9zHevi6WWGtnMEOjczwkUC0BMv8,30753
-json_duplicate_keys-2025.7.1.dist-info/LICENSE,sha256=_hudSGMciUc27wGR8EMKfeb3atJRlf6rbhJtLnel-nc,1093
-json_duplicate_keys-2025.7.1.dist-info/METADATA,sha256=wvDz2_ia5VuzhLvNiVZnrI7YJEVfjGVwy07RGb2-dQk,22717
-json_duplicate_keys-2025.7.1.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
-json_duplicate_keys-2025.7.1.dist-info/top_level.txt,sha256=vdsGrPLVS_l-BFL1i4hCJBY5_-gq4Cwp-11yegA750Y,20
-json_duplicate_keys-2025.7.1.dist-info/RECORD,,