AYON_in_flame

def app_initialized(parent=None):
    """Inicialization of Framework

    Args:
        parent (obj, optional): Parent object. Defaults to None.
    """
    flame_api.CTX.app_framework = flame_api.FlameAppFramework()

    print(f"{flame_api.CTX.app_framework.bundle_name} initializing")

    load_apps()
    check_project_ocio_config()

def ayon_flame_install():
    """Registering AYON in context
    """
    flame_host = FlameHost()
    install_host(flame_host)

def check_project_ocio_config():
    """Warn if Flame project OCIO config and AYON OCIO config differs.

    Flame project OCIO config is only set at project creation,
    so it can differ from the current config set in AYON (used at publish).
    """
    import flame
    from ayon_core.pipeline.context_tools import get_current_project_settings

    # Flame < 2026 projects use SynColor not OCIO.
    if int(flame.get_version_major()) < 2026:
        return

    # No OCIO config set.
    ayon_ocio_config = os.getenv("OCIO")
    if not ayon_ocio_config:
        return

    project_name = flame_api.get_current_project().name
    try:
        # Color management is disabled.
        imageio_flame = get_current_project_settings()["flame"]["imageio"]
        if imageio_flame.get("activate_host_color_management") is False:
            return

        project_ocio_config = flame_api.get_project_ocio_config(project_name)

    except Exception as error:
        print(f"!!!! not able to check project OCIO config: {error} !!!!")
        return

    if (
        project_ocio_config
        and os.path.realpath(project_ocio_config)
        == os.path.realpath(ayon_ocio_config)
    ):
        return

    message = (
        f"Flame project '{project_name}' OCIO config does not match "
        "AYON OCIO config, published colorspaces might be wrong.\n\n"
        f"- Flame project: {project_ocio_config}\n"
        f"- AYON: {ayon_ocio_config}"
    )
    print(f"AYON: {message}")
    flame.messages.show_in_dialog(
        "AYON: OCIO config mismatch",
        message,
        "warning",
        ["OK"],
    )

def cleanup():
    """Cleaning up Flame framework context
    """
    if flame_api.CTX.flame_apps:
        print(
            f"`{__file__}` cleaning up flame_apps:\n "
            f"{pformat(flame_api.CTX.flame_apps)}\n"
        )
        while len(flame_api.CTX.flame_apps):
            app = flame_api.CTX.flame_apps.pop()
            print(f"`{__file__}` removing : {app.name}")
            del app
        flame_api.CTX.flame_apps = []

    if flame_api.CTX.app_framework:
        print(f"AYON\t: {flame_api.CTX.app_framework.bundle_name} cleaning up")
        flame_api.CTX.app_framework.save_prefs()
        flame_api.CTX.app_framework = None

def exception_handler(exctype, value, _traceback):
    """Exception handler for improving UX

    Args:
        exctype (str): type of exception
        value (str): exception value
        tb (str): traceback to show
    """
    msg = f"AYON: Python exception {value} in {exctype}"
    mbox = QtWidgets.QMessageBox()
    mbox.setText(msg)
    mbox.setDetailedText(
        pformat(traceback.format_exception(exctype, value, _traceback)))
    mbox.setStyleSheet("QLabel{min-width: 800px;}")
    mbox.exec_()
    sys.__excepthook__(exctype, value, _traceback)

def get_batch_custom_ui_actions():
    """Hook to create submenu in batch

    Returns:
        list: menu object
    """
    # install AYON and the host
    ayon_flame_install()

    return _build_app_menu("FlameMenuBatch")

def get_main_menu_custom_ui_actions():
    """Hook to create submenu in start menu

    Returns:
        list: menu object
    """
    # install AYON and the host
    ayon_flame_install()

    return _build_app_menu("FlameMenuProjectConnect")

def get_media_panel_custom_ui_actions():
    """Hook to create submenu in desktop

    Returns:
        list: menu object
    """
    # install AYON and the host
    ayon_flame_install()

    return _build_app_menu("FlameMenuUniversal")

def get_timeline_custom_ui_actions():
    """Hook to create submenu in timeline

    Returns:
        list: menu object
    """
    # install AYON and the host
    ayon_flame_install()

    return _build_app_menu("FlameMenuTimeline")

def load_apps():
    """Load available flame_apps into Flame framework
    """
    flame_api.CTX.flame_apps.append(
        flame_api.FlameMenuProjectConnect(flame_api.CTX.app_framework))
    flame_api.CTX.flame_apps.append(
        flame_api.FlameMenuTimeline(flame_api.CTX.app_framework))
    flame_api.CTX.flame_apps.append(
        flame_api.FlameMenuBatch(flame_api.CTX.app_framework))
    flame_api.CTX.flame_apps.append(
        flame_api.FlameMenuUniversal(flame_api.CTX.app_framework))
    flame_api.CTX.app_framework.log.info("Apps are loaded")

def project_changed_dict(info):
    """Hook for project change action

    Args:
        info (str): info text
    """
    cleanup()

def project_saved(project_name, save_time, is_auto_save):
    """Hook to activate when project is saved

    Args:
        project_name (str): name of project
        save_time (str): time when it was saved
        is_auto_save (bool): autosave is on or off
    """
    if flame_api.CTX.app_framework:
        flame_api.CTX.app_framework.save_prefs()