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

json_duplicate_keys/__init__.py

@@ -362,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
@@ -381,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)

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

@@ -1,30 +1,10 @@
 Metadata-Version: 2.1
 Name: json-duplicate-keys
-Version: 2025.8.19
+Version: 2025.9.9
 Summary: Flatten/ Unflatten and Load(s)/ Dump(s) JSON File/ Object with Duplicate Keys
 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
+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 :: Implementation :: Jython
@@ -35,32 +15,34 @@ License-File: LICENSE
 	<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
@@ -73,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
@@ -93,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
@@ -115,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
@@ -129,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
@@ -154,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
@@ -200,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
@@ -228,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
@@ -259,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
@@ -285,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`:
@@ -306,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`:
@@ -327,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: `{{{`)
@@ -352,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
@@ -382,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: `||`)
@@ -405,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: `||`)
@@ -428,37 +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.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-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.8.19.dist-info/RECORD

@@ -1,6 +0,0 @@
-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,,