VertexEngine-JSON 1.0.0__tar.gz

vertexengine_json-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tyrel Miguel Gomez.
+
+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.

vertexengine_json-1.0.0/PKG-INFO

@@ -0,0 +1,34 @@
+Metadata-Version: 2.4
+Name: VertexEngine-JSON
+Version: 1.0.0
+Summary: JSON Extension of VertexEngine.
+Project-URL: Homepage, https://vertexengine-zii6.onrender.com/
+Project-URL: Documentation, https://vertexenginedocs.netlify.app/
+Project-URL: Repository, https://github.com/VertexEngine-Projects/VertexEngine-JSON
+Keywords: vertexengine,json,serialization,game-engine
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Games/Entertainment
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: VertexEngine>=1.5.0
+Dynamic: license-file
+
+# What is This
+This is an extension of VertexEngine that adds JSON tooling to it. It makes game development easier as you can easily make save files. It is also open source like VertexEngine and is created by the same author of VertexEngine.
+
+# Dependencies
+All you need is VertexEngine! This is an extension of VertexEngine so you need VertexEngine to use this package.
+
+# License
+The license is the MIT License. For more information, read the LICENSE file.

vertexengine_json-1.0.0/README.md

@@ -0,0 +1,8 @@
+# What is This
+This is an extension of VertexEngine that adds JSON tooling to it. It makes game development easier as you can easily make save files. It is also open source like VertexEngine and is created by the same author of VertexEngine.
+
+# Dependencies
+All you need is VertexEngine! This is an extension of VertexEngine so you need VertexEngine to use this package.
+
+# License
+The license is the MIT License. For more information, read the LICENSE file.

vertexengine_json-1.0.0/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["setuptools >= 77.0.3"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "VertexEngine-JSON"
+version = "1.0.0"
+description = "JSON Extension of VertexEngine."
+readme = "README.md"
+requires-python = ">=3.10"
+keywords = ["vertexengine", "json", "serialization", "game-engine"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Topic :: Games/Entertainment",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Operating System :: OS Independent"
+]
+dependencies = [
+    "VertexEngine>=1.5.0"
+]
+
+[project.urls]
+Homepage = "https://vertexengine-zii6.onrender.com/"
+Documentation = "https://vertexenginedocs.netlify.app/"
+Repository = "https://github.com/VertexEngine-Projects/VertexEngine-JSON"

vertexengine_json-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

vertexengine_json-1.0.0/src/VertexEngine/json/__init__.py

@@ -0,0 +1,21 @@
+from ._operation_data import (
+    add_data,
+    dict_to_json,
+    get_data,
+    merge_data,
+    mutate_object,
+    remove_object,
+    split_object,
+    swap_data,
+)
+
+__all__ = [
+    "add_data",
+    "dict_to_json",
+    "get_data",
+    "merge_data",
+    "mutate_object",
+    "remove_object",
+    "split_object",
+    "swap_data",
+]

vertexengine_json-1.0.0/src/VertexEngine/json/_operation_data.py

@@ -0,0 +1,163 @@
+import json
+from copy import deepcopy
+from pathlib import Path
+from typing import Any, Iterable
+
+def _load_json(path: str | Path) -> dict[str, Any]:
+    file_path = Path(path)
+    if not file_path.exists():
+        return {}
+
+    try:
+        data = file_path.read_text(encoding="utf-8")
+    except OSError:
+        return {}
+
+    if not data.strip():
+        return {}
+
+    parsed = json.loads(data)
+    if not isinstance(parsed, dict):
+        raise ValueError("JSON root must be an object/dictionary.")
+    return parsed
+
+
+def _save_json(path: str | Path, data: dict[str, Any]) -> dict[str, Any]:
+    file_path = Path(path)
+    file_path.parent.mkdir(parents=True, exist_ok=True)
+    file_path.write_text(json.dumps(data, indent=2, ensure_ascii=False), encoding="utf-8")
+    return data
+
+
+def add_data(file_path: str | Path, data: dict[str, Any]) -> dict[str, Any]:
+    if not isinstance(data, dict):
+        raise TypeError("data must be a dictionary.")
+
+    payload = _load_json(file_path)
+    payload.update(deepcopy(data))
+    return _save_json(file_path, payload)
+
+
+def get_data(file_path: str | Path, object_name: str, key: str | None = None, default: Any = None) -> Any:
+    payload = _load_json(file_path)
+    if object_name not in payload:
+        return default
+
+    value = payload[object_name]
+    if key is None:
+        return value
+
+    if not isinstance(value, dict):
+        return default
+
+    return value.get(key, default)
+
+
+def remove_object(file_path: str | Path, object_name: str) -> dict[str, Any]:
+    payload = _load_json(file_path)
+    payload.pop(object_name, None)
+    return _save_json(file_path, payload)
+
+
+def merge_data(file_path: str | Path, object_name: str, new_data: dict[str, Any]) -> dict[str, Any]:
+    if not isinstance(new_data, dict):
+        raise TypeError("new_data must be a dictionary.")
+
+    payload = _load_json(file_path)
+    existing = payload.get(object_name)
+    if existing is None:
+        payload[object_name] = deepcopy(new_data)
+    elif isinstance(existing, dict):
+        existing.update(deepcopy(new_data))
+    else:
+        payload[object_name] = deepcopy(new_data)
+
+    return _save_json(file_path, payload)
+
+
+def split_object(file_path: str | Path, object_name: str, groups: dict[str, Iterable[str]]) -> dict[str, Any]:
+    payload = _load_json(file_path)
+    source = payload.get(object_name)
+    if source is None:
+        raise KeyError(f"Object '{object_name}' does not exist.")
+    if not isinstance(source, dict):
+        raise TypeError(f"Object '{object_name}' is not a dictionary.")
+
+    split_payload = {}
+    for new_name, keys in groups.items():
+        selected = {key: deepcopy(source[key]) for key in keys if key in source}
+        split_payload[new_name] = selected
+
+    payload.pop(object_name, None)
+    payload.update(split_payload)
+    return _save_json(file_path, payload)
+
+
+def mutate_object(
+    file_path: str | Path,
+    object_name: str,
+    changes: dict[str, Any],
+    *,
+    new_name: str | None = None,
+) -> dict[str, Any]:
+    if not isinstance(changes, dict):
+        raise TypeError("changes must be a dictionary.")
+
+    payload = _load_json(file_path)
+    source = payload.get(object_name)
+    if source is None:
+        raise KeyError(f"Object '{object_name}' does not exist.")
+    if not isinstance(source, dict):
+        raise TypeError(f"Object '{object_name}' is not a dictionary.")
+
+    mutated = deepcopy(source)
+    mutated.update(deepcopy(changes))
+
+    target_name = new_name or f"{object_name}_copy"
+    payload[target_name] = mutated
+    return _save_json(file_path, payload)
+
+
+def swap_data(file_path: str | Path, first_object: str, second_object: str, key: str) -> dict[str, Any]:
+    payload = _load_json(file_path)
+    first = payload.get(first_object)
+    second = payload.get(second_object)
+
+    if not isinstance(first, dict) or not isinstance(second, dict):
+        raise TypeError("Both objects must be dictionaries.")
+    if key not in first or key not in second:
+        return payload
+
+    first[key], second[key] = second[key], first[key]
+    return _save_json(file_path, payload)
+
+
+def dict_to_json(file_path: str | Path, data: dict[str, Any]) -> str:
+    """
+    Converts a dictionary to JSON and saves it to a file.
+    
+    Args:
+        file_path: Path where the JSON file will be saved
+        data: Dictionary to convert and save
+        
+    Returns:
+        The JSON string representation of the data
+    """
+    if not isinstance(data, dict):
+        raise TypeError("data must be a dictionary.")
+    
+    _save_json(file_path, data)
+    json_string = json.dumps(data, indent=2, ensure_ascii=False)
+    return json_string
+
+
+__all__ = [
+    "add_data",
+    "get_data",
+    "remove_object",
+    "merge_data",
+    "split_object",
+    "mutate_object",
+    "swap_data",
+    "dict_to_json",
+]

vertexengine_json-1.0.0/src/VertexEngine/json_files/_operation_data.py

@@ -0,0 +1,107 @@
+import json
+from copy import deepcopy
+from pathlib import Path
+from typing import Any, Iterable
+
+
+def _load_json(path: str | Path) -> dict[str, Any]:
+    """Load JSON from a file, returning an empty dict if file doesn't exist or is empty."""
+    file_path = Path(path)
+    if not file_path.exists():
+        return {}
+
+    try:
+        data = file_path.read_text(encoding="utf-8")
+    except OSError:
+        return {}
+
+    if not data.strip():
+        return {}
+
+    parsed = json.loads(data)
+    if not isinstance(parsed, dict):
+        raise ValueError("JSON root must be an object/dictionary.")
+    return parsed
+
+
+def _save_json(path: str | Path, data: dict[str, Any]) -> dict[str, Any]:
+    """Save JSON data to a file, creating parent directories as needed."""
+    file_path = Path(path)
+    file_path.parent.mkdir(parents=True, exist_ok=True)
+    file_path.write_text(json.dumps(data, indent=2, ensure_ascii=False), encoding="utf-8")
+    return data
+
+
+def merge_file(files: Iterable[str | Path], output_path: str | Path) -> dict[str, Any]:
+    """
+    Merges multiple JSON files into a single file.
+    
+    Args:
+        files: Iterable of file paths to merge
+        output_path: Path where the merged result will be saved
+        
+    Returns:
+        The merged dictionary
+    """
+    merged: dict[str, Any] = {}
+    
+    for file_path in files:
+        data = _load_json(file_path)
+        merged.update(deepcopy(data))
+    
+    return _save_json(output_path, merged)
+
+
+def folder_to_file(folder: str | Path, output_path: str | Path, *, extension: str = "*.json") -> dict[str, Any]:
+    """
+    Merges all JSON files in a folder into a single file.
+    
+    Args:
+        folder: Path to the folder containing JSON files
+        output_path: Path where the merged result will be saved
+        extension: File pattern to match (default: "*.json")
+        
+    Returns:
+        The merged dictionary
+    """
+    folder_path = Path(folder)
+    if not folder_path.is_dir():
+        raise ValueError(f"Folder '{folder_path}' does not exist or is not a directory.")
+    
+    json_files = sorted(folder_path.glob(extension))
+    return merge_file(json_files, output_path)
+
+
+def add_data(file_path: str | Path, object_names: Iterable[str], data: dict[str, Any]) -> dict[str, Any]:
+    """
+    Adds data to a set of JSON objects in a specific JSON file.
+    
+    Args:
+        file_path: Path to the JSON file
+        object_names: Iterable of object names to add data to
+        data: Dictionary of data to add to each object
+        
+    Returns:
+        The updated payload
+    """
+    if not isinstance(data, dict):
+        raise TypeError("data must be a dictionary.")
+    
+    payload = _load_json(file_path)
+    data_copy = deepcopy(data)
+    
+    for object_name in object_names:
+        if object_name not in payload:
+            payload[object_name] = {}
+        
+        if isinstance(payload[object_name], dict):
+            payload[object_name].update(data_copy)
+    
+    return _save_json(file_path, payload)
+
+
+__all__ = [
+    "merge_file",
+    "folder_to_file",
+    "add_data",
+]

vertexengine_json-1.0.0/src/VertexEngine_JSON.egg-info/PKG-INFO

@@ -0,0 +1,34 @@
+Metadata-Version: 2.4
+Name: VertexEngine-JSON
+Version: 1.0.0
+Summary: JSON Extension of VertexEngine.
+Project-URL: Homepage, https://vertexengine-zii6.onrender.com/
+Project-URL: Documentation, https://vertexenginedocs.netlify.app/
+Project-URL: Repository, https://github.com/VertexEngine-Projects/VertexEngine-JSON
+Keywords: vertexengine,json,serialization,game-engine
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Games/Entertainment
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: VertexEngine>=1.5.0
+Dynamic: license-file
+
+# What is This
+This is an extension of VertexEngine that adds JSON tooling to it. It makes game development easier as you can easily make save files. It is also open source like VertexEngine and is created by the same author of VertexEngine.
+
+# Dependencies
+All you need is VertexEngine! This is an extension of VertexEngine so you need VertexEngine to use this package.
+
+# License
+The license is the MIT License. For more information, read the LICENSE file.

vertexengine_json-1.0.0/src/VertexEngine_JSON.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+src/VertexEngine/json/__init__.py
+src/VertexEngine/json/_operation_data.py
+src/VertexEngine/json_files/__init__.py
+src/VertexEngine/json_files/_operation_data.py
+src/VertexEngine_JSON.egg-info/PKG-INFO
+src/VertexEngine_JSON.egg-info/SOURCES.txt
+src/VertexEngine_JSON.egg-info/dependency_links.txt
+src/VertexEngine_JSON.egg-info/requires.txt
+src/VertexEngine_JSON.egg-info/top_level.txt

vertexengine_json-1.0.0/src/VertexEngine_JSON.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

vertexengine_json-1.0.0/src/VertexEngine_JSON.egg-info/requires.txt

@@ -0,0 +1 @@
+VertexEngine>=1.5.0

vertexengine_json-1.0.0/src/VertexEngine_JSON.egg-info/top_level.txt

@@ -0,0 +1 @@
+VertexEngine