File Data Helper Functions in Python

from pathlib import Path

def load_text_file(filepath):
    """Read a text file and return its contents as a string."""
    path = Path(filepath)
    if not path.exists():
        raise FileNotFoundError(f"File not found: {filepath}")
    return path.read_text(encoding="utf-8")

def save_text_file(filepath, content):
    """Write content to a text file."""
    path = Path(filepath)
    path.parent.mkdir(parents=True, exist_ok=True)
    path.write_text(content, encoding="utf-8")
    return f"Saved {len(content)} characters to {filepath}"

def load_json_file(filepath):
    """Read a JSON file and return parsed data."""
    import json
    path = Path(filepath)
    if not path.exists():
        raise FileNotFoundError(f"File not found: {filepath}")
    with path.open("r", encoding="utf-8") as f:
        return json.load(f)

def save_json_file(filepath, data):
    """Save data as a JSON file with nice formatting."""
    import json
    path = Path(filepath)
    path.parent.mkdir(parents=True, exist_ok=True)
    with path.open("w", encoding="utf-8") as f:
        json.dump(data, f, indent=2, ensure_ascii=False)
    return f"Saved JSON data to {filepath}"

def list_files_in_directory(directory):
    """Return a list of all files in a directory."""
    path = Path(directory)
    if not path.is_dir():
        raise NotADirectoryError(f"Not a directory: {directory}")
    return [p.name for p in path.iterdir() if p.is_file()]

if __name__ == "__main__":
    # Demo usage
    file_text = "Hello, PythonSkillset!\nThis is a sample file."
    save_result = save_text_file("demo_files/sample.txt", file_text)
    print(save_result)
    print("Loaded text:", load_text_file("demo_files/sample.txt"))
    
    demo_data = {"name": "Python", "version": 3.9, "features": ["simple", "powerful"]}
    save_json_result = save_json_file("demo_files/data.json", demo_data)
    print(save_json_result)
    print("Loaded JSON:", load_json_file("demo_files/data.json"))
    
    print("Files in demo_files:", list_files_in_directory("demo_files"))