simple-storage-python-module 1.1.4__tar.gz

simple_storage_python_module-1.1.4/LICENSE.txt

@@ -0,0 +1,8 @@
+MIT License
+Copyright 2026 Andrew Abdelmalek
+
+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.

simple_storage_python_module-1.1.4/PKG-INFO

@@ -0,0 +1,21 @@
+Metadata-Version: 2.4
+Name: simple_storage_python_module
+Version: 1.1.4
+Summary: A small, easy to use module that helps you store data easily.
+Author-email: Andrew Abdelmalek <aa2@olprahraneast.catholic.edu.au>
+License-Expression: MIT
+Project-URL: Homepage, https://simple-storage-module.netlify.app
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Dynamic: license-file
+
+# simple-storage
+
+A tiny Python module for safely saving and loading JSON data.
+
+## Install
+```bash
+pip install simple_storage_python_module

simple_storage_python_module-1.1.4/README.md

@@ -0,0 +1,7 @@
+# simple-storage
+
+A tiny Python module for safely saving and loading JSON data.
+
+## Install
+```bash
+pip install simple_storage_python_module

simple_storage_python_module-1.1.4/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "simple_storage_python_module"
+version = "1.1.4"
+authors = [
+  { name="Andrew Abdelmalek", email="aa2@olprahraneast.catholic.edu.au" },
+]
+description = "A small, easy to use module that helps you store data easily."
+readme = "README.md"
+requires-python = ">=3.9"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+license = "MIT"
+license-files = ["LICENSE.txt"]
+
+[project.urls]
+Homepage = "https://simple-storage-module.netlify.app"
+

simple_storage_python_module-1.1.4/setup.cfg

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

simple_storage_python_module-1.1.4/src/simple_storage_module_SIMPLES/_init_.py

@@ -0,0 +1,3 @@
+from .simple_storage import (safe_save, safe_load, save, load, exists, delete)
+
+__all__ = ["safe_save", "safe_load", "save", "load", "exists", "delete"]

simple_storage_python_module-1.1.4/src/simple_storage_module_SIMPLES/simple_storage.py

@@ -0,0 +1,127 @@
+# Simple Storage
+# Descripton: Easy to use long term storage module
+# Version 1.1.0
+# Documentation at this link: 
+# By Andrew Abdelmalek
+# © 2026 Andrew Abdelmalek
+
+import json
+import os
+import base64
+
+_STORAGE_FOLDER = "simple_storage_folder"
+os.makedirs(_STORAGE_FOLDER, exist_ok=True)
+
+
+_STORAGE_FOLDER = "simple_storage_folder"
+_KEY = b"MyFixedSecretKey1234567890pneumonoutramicroscopicsilicovoclacjkku49^^&6348736*&^#^*&(#*(^t5v-m(&(#*&$_+?"
+
+
+def _ensure_folder(): # Helper function
+    if not os.path.exists(_STORAGE_FOLDER): #Checks if storage folder exists
+        os.makedirs(_STORAGE_FOLDER)# If not, creates
+
+
+def _file_path(name): #Helper Function
+    return os.path.join(_STORAGE_FOLDER, f"{name}.json")
+
+def save(name, data): #Save any JSON-safe data (dict, list, str, int, etc.)u
+    if not name or data == "":
+        raise ValueError("Error while saving information: No value in argument 'name' and/or 'data'")
+    _ensure_folder()
+    with open(_file_path(name), "w", encoding="utf-8") as f: # Opens file
+        json.dump(data, f, indent=4)
+
+def load(name, default=None): #Load saved data. Returns default if not found.
+    try:
+        with open(_file_path(name), "r", encoding="utf-8") as f:
+            return json.load(f)
+    except FileNotFoundError:
+        return default
+
+def _encrypt_string(s: str) -> str:
+    encrypted_bytes = bytes([b ^ _KEY[i % len(_KEY)] for i, b in enumerate(s.encode())])
+    return base64.b64encode(encrypted_bytes).decode()
+
+
+def _decrypt_string(s: str) -> str:
+    encrypted_bytes = base64.b64decode(s.encode())
+    decrypted_bytes = bytes([b ^ _KEY[i % len(_KEY)] for i, b in enumerate(encrypted_bytes)])
+    return decrypted_bytes.decode()
+
+def safe_save(name: str, data):
+    """
+    Encrypts the JSON data and saves it to a file.
+    """
+    if not name or data:
+        raise ValueError("Error while saving information: No value in argument 'name' and/or 'data'")
+    json_str = json.dumps(data)
+    encrypted_str = _encrypt_string(json_str)
+    with open(_file_path(name), "w") as f:
+        f.write(encrypted_str)
+
+
+def safe_load(name: str):
+    """
+    Loads the file and decrypts the JSON data.
+    Returns the original Python object.
+    """
+    if not os.path.exists(_file_path(name)):
+        return None
+    with open(_file_path(name), "r") as f:
+        encrypted_str = f.read()
+    json_str = _decrypt_string(encrypted_str)
+    return json.loads(json_str)
+
+
+
+def exists(name): #Check if a saved item exists.
+    return os.path.exists(_file_path(name))
+
+
+def delete(name): #Delete saved data.
+    if exists(name):
+        os.remove(_file_path(name))
+
+# MODULE TEST
+def _run_tests():
+    print("Running simple_storage tests...")
+
+    test_name = "__test_item__"
+
+    # Clean up before test
+    if exists(test_name):
+        delete(test_name)
+
+    # Test: file should not exist
+    assert not exists(test_name), "Test failed: file should not exist"
+
+    # Test: save data
+    data = {
+        "name": "Test",
+        "value": 123,
+        "active": True
+    }
+    save(test_name, data)
+
+    # Test: file should exist
+    assert exists(test_name), "Test failed: file should exist"
+
+    # Test: load data
+    loaded = load(test_name)
+    assert loaded == data, "Test failed: loaded data does not match saved data"
+
+    # Test: load with default
+    missing = load("does_not_exist", default="default")
+    assert missing == "default", "Test failed: default value not returned"
+
+    # Test: delete data
+    delete(test_name)
+    assert not exists(test_name), "Test failed: file was not deleted"
+
+    print("All tests passed successfully.")
+
+
+if __name__ == "__main__":
+    _run_tests()
+

simple_storage_python_module-1.1.4/src/simple_storage_python_module.egg-info/PKG-INFO

@@ -0,0 +1,21 @@
+Metadata-Version: 2.4
+Name: simple_storage_python_module
+Version: 1.1.4
+Summary: A small, easy to use module that helps you store data easily.
+Author-email: Andrew Abdelmalek <aa2@olprahraneast.catholic.edu.au>
+License-Expression: MIT
+Project-URL: Homepage, https://simple-storage-module.netlify.app
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Dynamic: license-file
+
+# simple-storage
+
+A tiny Python module for safely saving and loading JSON data.
+
+## Install
+```bash
+pip install simple_storage_python_module

simple_storage_python_module-1.1.4/src/simple_storage_python_module.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE.txt
+README.md
+pyproject.toml
+src/simple_storage_module_SIMPLES/_init_.py
+src/simple_storage_module_SIMPLES/simple_storage.py
+src/simple_storage_python_module.egg-info/PKG-INFO
+src/simple_storage_python_module.egg-info/SOURCES.txt
+src/simple_storage_python_module.egg-info/dependency_links.txt
+src/simple_storage_python_module.egg-info/top_level.txt

simple_storage_python_module-1.1.4/src/simple_storage_python_module.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

simple_storage_python_module-1.1.4/src/simple_storage_python_module.egg-info/top_level.txt

@@ -0,0 +1 @@
+simple_storage_module_SIMPLES