Fix the issue: inserting a value with an empty or null name

Author: truocphan

README.md

@@ -2,32 +2,34 @@
 	<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>
+	<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>
 </div>
 
-## Installation
+---
+# 🛠️ Installation
 #### From PyPI:
 ```console
 pip install json-duplicate-keys
 ```
 #### From Source:
 ```console
-git clone https://github.com/tpcybersec/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 -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
@@ -40,8 +42,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
@@ -60,8 +62,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
@@ -82,8 +84,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
@@ -96,8 +98,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
@@ -121,8 +123,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
@@ -167,8 +169,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
@@ -195,9 +197,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
@@ -226,8 +238,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
@@ -252,8 +264,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`:
@@ -273,8 +285,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`:
@@ -294,8 +306,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: `{{{`)
@@ -319,8 +331,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
@@ -349,8 +361,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: `||`)
@@ -372,8 +384,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: `||`)
@@ -395,37 +407,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.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.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.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 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)
+### [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/tpcybersec/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/tpcybersec/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/tpcybersec/json-duplicate-keys/tree/2024.7.17)
+### [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/tpcybersec/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/tpcybersec/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/__init__.py

@@ -362,8 +362,8 @@ def insert(self, name, value, position=None, case_insensitive=False, separator="
 		# 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
@@ -381,6 +381,12 @@ def insert(self, name, value, position=None, case_insensitive=False, separator="
 		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)

pyproject.toml

@@ -7,7 +7,7 @@ name = "json-duplicate-keys"
 version = "2025.8.19"
 description = "Flatten/ Unflatten and Load(s)/ Dump(s) JSON File/ Object with Duplicate Keys"
 readme = { file = "README.md", content-type = "text/markdown" }
-license = { file = "LICENSE" }
+license = { text = "MIT" }
 keywords = ["TPCyberSec", "json", "duplicate keys", "json duplicate keys", "flatten", "unflatten"]
 classifiers = [
   "Programming Language :: Python :: 3",
@@ -19,7 +19,7 @@ authors = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/tpcybersec/json-duplicate-keys"
+Homepage = "https://github.com/TPCyberSec/json-duplicate-keys"
 
 [tool.setuptools]
 packages = ["json_duplicate_keys"]