file.py

""" file.py """
import os
import json


def create_or_update(file_name: str, content: dict  = None) -> None:
    """Create a new json file or Updates an existing file

    Args:
        file_name (str): File name or path
        content (str, optional): Text file content. Defaults to None.
    """

    if os.path.isfile(file_name): 
        if valid_json_file(file_name):
            update(file_name, content)
        else:
            create(file_name, content)
    else:
       create(file_name, content)   

def valid_json_file(file_name) -> bool: 
    try:
        file = open(file_name)
        json.loads(file.read())
        file.close()
        return True
    except ValueError as e:
        os.remove(file_name)
        return False 
def create(file_name: str, content: dict = None) -> None:
    """Create a new json file

    Args:
        file_name (str): File name or path
        content (str, optional): Text file content. Defaults to None.
    """
    mode = "w" if content else "x"

    try:
        file = open(file_name, mode)

    except FileExistsError as error:
        raise OSError(f"File '{file_name}' already exists") from error

    except PermissionError as error:
        raise OSError(f"You do not hav permisson to create '{file_name}'") from error

    if content and isinstance(content, (list, dict)):
        content = json.dumps(content)
        file.write(content)

    file.close()


def update(file_name: str, content: dict) -> None:
    """Updates an existing file

    Args:
        file_name (str): File name or path
        content (str): Text file content
        overwrite (bool, optional): If True, file will be overwritten. Defaults to False.
    """
    if not isinstance(content, dict)  or content == "":
        raise ValueError("'content' argument must be specified")

    file = open(file_name)
    file_content = json.loads(file.read())
    file.close()

    if isinstance(file_content, list):
        if isinstance(content, dict):
            file_content.append(content)

        elif isinstance(content, list):
            file_content += content

    elif isinstance(file_content, dict):
        if isinstance(content, dict):
            file_content = [file_content, content]

        elif isinstance(content, list):
            file_content = [file_content] + content

    file = open(file_name, "w")
    file.write(json.dumps(file_content))
    file.close()


def read(file_name: str) -> str:
    """Returns the content of a text file

    Args:
        file_name (str): File name or path

    Returns(str): File content
    """
    file = open(file_name)
    content = file.read()
    file.close()
    return content