luxforge 0.1.2__py3-none-any.whl

foundry/colours/__init__.py

@@ -0,0 +1,25 @@
+from .colours import Colours
+
+# Often modified metadata
+__version__ = "1.0.0"
+__modified__ = "2025-10-16"
+
+__all__ = ["Colours"]
+
+# Metadata
+__author__ = "LuxForge"
+__maintainer__ = "LuxForge"
+__email__ = "lab@luxforge.dev"
+__license__ = "MIT"
+__status__ = "Development"
+__copyright__ = "© 2025 LuxForge"
+__credits__ = ["LuxForge"]
+__description__ = "Colour utility module for Foundry tools, supporting ANSI styling, bold emphasis, and semantic log highlighting."
+__created__ = "2025-10-16"
+__module__ = "foundry.colours"
+__tags__ = ["colour", "ansi", "styling", "logging", "foundry"]
+__interface__ = "console"
+__features__ = ["ANSI colour codes", "bold text", "semantic level mapping"]
+__dependencies__ = ["os", "sys"]
+__compatibility__ = ["Python 3.8+", "Foundry VTT 0.8+"]
+__repository__ = "https://github.com/LuxForge/LuxForge-Foundry"

foundry/colours/colours.py

@@ -0,0 +1,68 @@
+# !/usr/bin/env python3
+
+# Colour definitions for terminal output
+# Author: Luxforge
+
+class Colours:
+    GRAY = "\033[90m"
+    RED = "\033[91m"
+    GREEN = "\033[92m"
+    YELLOW = "\033[93m"
+    ORANGE = "\033[38;5;208m"
+    BLUE = "\033[94m"
+    CYAN = "\033[96m"
+    MAGENTA = "\033[95m"
+    CYBERPURPLE = "\033[38;5;201m"  # Neon pink
+    DEEP_MAGENTA = "\033[38;5;165m"  # Deep magenta
+    BUBBLEGUM = "\033[38;5;213m"  # Bubblegum
+    RASPBERRY = "\033[38;5;200m"  # Raspberry
+    RESET = "\033[0m"
+    BOLD = "\033[1m"
+    UNDERLINE = "\033[4m"
+    REVERSE = "\033[7m"
+
+    @staticmethod
+    def colour_text( text, colour: str = None, bold: bool = False, underline: bool = False, reverse: bool = False):
+        # cast colour to upper to match class attributes
+        if colour:
+            colour = colour.upper()
+        else:
+            colour = "RESET"
+        if not hasattr(Colours, colour) or colour == "RESET":
+            colour = Colours.RESET
+        else:
+            colour = getattr(Colours, colour)
+        styles = [colour]
+        if bold:
+            styles.append(Colours.BOLD)
+        if underline:
+            styles.append(Colours.UNDERLINE)
+        if reverse:
+            styles.append(Colours.REVERSE)
+        return f"{''.join(styles)}{text}{Colours.RESET}"
+    @staticmethod
+    def test_all():
+        for colour in ["GRAY", "RED", "GREEN", "YELLOW", "ORANGE", "BLUE", "CYAN", "MAGENTA"]:
+            print(Colours.colour_text(f"This is {colour.lower()} text", colour))
+        print(Colours.colour_text("This is bold text", bold=True))
+        print(Colours.colour_text("This is underlined text", underline=True))
+        print(Colours.colour_text("This is reversed text", reverse=True))
+        print(Colours.colour_text("This is normal text")) 
+
+    @staticmethod
+    def style(colour: str = None, bold=False, underline=False, reverse=False):
+        colour = colour.upper() if colour else "RESET"
+        if not hasattr(Colours, colour) or colour == "RESET":
+            colour_code = Colours.RESET
+        else:
+            colour_code = getattr(Colours, colour)
+        styles = [colour_code]
+        if bold: styles.append(Colours.BOLD)
+        if underline: styles.append(Colours.UNDERLINE)
+        if reverse: styles.append(Colours.REVERSE)
+        return ''.join(styles)
+    
+if __name__ == "__main__":
+    Colours.test_all()
+    for code in [201, 200, 213, 165]:
+        print(f"\033[38;5;{code}mCyberpunk Purple {code}\033[0m")

foundry/files/__init__.py

@@ -0,0 +1,25 @@
+from .files import find_all_files, read_file, write_file
+
+# Often modified metadata
+__version__ = "1.0.0"
+__modified__ = "2025-10-16"
+
+__all__ = ["find_all_files", "read_file", "write_file"]
+
+# Metadata
+__author__ = "LuxForge"
+__maintainer__ = "LuxForge"
+__email__ = "lab@luxforge.dev"
+__license__ = "MIT"
+__status__ = "Development"
+__copyright__ = "© 2025 LuxForge"
+__credits__ = ["LuxForge"]
+__description__ = "Modular file I/O handler for Foundry tools, supporting read, write, append, export, and structured archival operations."
+__created__ = "2025-10-16"
+__module__ = "foundry.files"
+__tags__ = ["file", "io", "read", "write", "append", "export", "foundry"]
+__interface__ = "filesystem,stream"
+__features__ = ["read", "write", "append", "export", "structured archival"]
+__dependencies__ = ["os", "pathlib", "datetime", "json", "csv"]
+__compatibility__ = ["Python 3.8+", "Foundry VTT 0.8+"]
+__repository__ = "https://github.com/LuxForge/LuxForge-Foundry"

foundry/files/files.py

@@ -0,0 +1,108 @@
+#!/usr/bin/env python3
+
+# files.py
+# Author: Luxforge
+# File and directory utilities
+
+import os
+import time
+from pathlib import Path
+from foundry.logger.logger import logger
+from typing import List
+
+def write_file(filepath, data, retries=5, timeout=2, encoding="utf-8"):
+    """
+    Write data to a file with retry logic and timeout between attempts.
+    
+    ARGS:
+        filepath (str or Path): Destination file path
+        data (str): Data to write
+        retries (int): Number of retry attempts
+        timeout (int or float): Seconds to wait between retries
+        encoding (str): File encoding (default: utf-8)
+    
+    RETURNS:
+        bool: True if write succeeded, False otherwise
+    """
+    # VALIDATE INPUTS
+    if retries == 0:
+        logger.warning(f"Retries set to 0, no further attempts will be made to write the file: {filepath}")
+        return False
+
+    # Ensure filepath is a Path object
+    filepath = Path(filepath)
+
+    # Ensure the parent directory exists
+    filepath.parent.mkdir(parents=True, exist_ok=True)
+
+    # Recursively attempt to write the file
+
+    try:
+        with open(filepath, "w", encoding=encoding) as f:
+            f.write(data)
+    except Exception as e:
+        
+        # Log the error and retry
+        logger.error(f"Failed to write to {filepath}. Retries pending:{retries}. Error: {e}")
+        time.sleep(timeout)
+
+        return write_file(filepath, data, retries - 1, timeout, encoding)
+    logger.info(f"Successfully wrote to {filepath}")
+    return True
+
+def read_file(filepath: str | Path, encoding: str="utf-8", retries: int=5, timeout: int=2) -> str | None:
+    """
+    Read data from a file.
+    
+    ARGS:
+        filepath (str or Path): Source file path
+        encoding (str): File encoding (default: utf-8)
+        retries (int): Number of retry attempts (default: 5)
+        timeout (int or float): Seconds to wait between retries (default: 2)
+    RETURNS:
+        str: File contents, or None if read failed
+
+    """
+    # VALIDATE INPUTS
+    
+    if retries == 0:
+        logger.warning(f"Out of retries, no further attempts will be made to read the file: {filepath}")
+        return None
+    
+    # Ensure filepath is a Path object
+    filepath = Path(filepath)
+    if not filepath.exists():
+        logger.error(f"File does not exist: {filepath}")
+        return None
+
+    # Recursively attempt to read the file    
+    try:
+        with open(filepath, "r", encoding=encoding) as f:
+            return f.read()
+    except Exception as e:
+
+        logger.error(f"Failed to read from {filepath}. Error: {e}")
+        time.sleep(timeout)
+        return read_file(filepath, encoding, retries - 1, timeout)
+
+    logger.info(f"Successfully read from {filepath}")
+    return True
+
+def find_all_files(directory: str | Path, pattern: str="*") -> List[Path]:
+    """
+    Recursively find all files in a directory matching a pattern.
+    
+    ARGS:
+        directory (str or Path): Root directory to search
+        pattern (str): Glob pattern to match files (default: "*")
+    
+    RETURNS:
+        list of Path: List of matching file paths
+    """
+    directory = Path(directory)
+    if not directory.exists() or not directory.is_dir():
+        logger.error(f"Directory does not exist or is not a directory: {directory}")
+        return []
+    
+    logger.info(f"Searching for files in {directory} matching pattern '{pattern}'")
+    return [p.resolve() for p in directory.rglob(pattern)]

foundry/logger/__init__.py

@@ -0,0 +1,27 @@
+from .logger import BoundLogger, Logger, format_utc, logger, utc_now
+
+
+# Often modified metadata
+__version__ = "1.0.0"
+__modified__ = "2025-10-16"
+
+
+__all__ = ["BoundLogger", "Logger", "format_utc", "logger", "utc_now"]
+
+# Metadata
+__author__ = "LuxForge"
+__maintainer__ = "LuxForge"
+__email__ = "lab@luxforge.dev"
+__license__ = "MIT"
+__status__ = "Development"
+__copyright__ = "© 2025 LuxForge"
+__credits__ = ["LuxForge"]
+__description__ = "Audit-grade logging module for Foundry tools, supporting timestamped output to console, file, and (eventually) database and API endpoints."
+__created__ = "2025-10-16"
+__module__ = "foundry.logger"
+__tags__ = ["logging", "audit", "rasputin", "foundry", "timestamp"]
+__interface__ = "console,file,api"
+__features__ = ["timestamped output", "file rotation", "milestone tagging"]
+__dependencies__ = ["os", "logging", "logging.handlers", "datetime", "threading"]
+__compatibility__ = ["Python 3.8+", "Foundry VTT 0.8+"]
+__repository__ = "https://github.com/LuxForge/LuxForge-Foundry"