From 1ec708ce7f5786a6cff9bbd490beff0872553d01 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 15 Jul 2022 17:01:28 +0200
Subject: [PATCH] added helper functions to get outdated containers or just
 check if there are any outdated

---
 openpype/pipeline/load/__init__.py |  4 ++++
 openpype/pipeline/load/utils.py    | 29 +++++++++++++++++++++++++++++
 2 files changed, 33 insertions(+)

diff --git a/openpype/pipeline/load/__init__.py b/openpype/pipeline/load/__init__.py
index e05dde2f9c..e46d9f152b 100644
--- a/openpype/pipeline/load/__init__.py
+++ b/openpype/pipeline/load/__init__.py
@@ -25,6 +25,8 @@ from .utils import (
     loaders_from_repre_context,
     loaders_from_representation,
 
+    any_outdated_containers,
+    get_outdated_containers,
     filter_containers,
 )
 
@@ -68,6 +70,8 @@ __all__ = (
     "loaders_from_repre_context",
     "loaders_from_representation",
 
+    "any_outdated_containers",
+    "get_outdated_containers",
     "filter_containers",
 
     # plugins.py
diff --git a/openpype/pipeline/load/utils.py b/openpype/pipeline/load/utils.py
index 68850c095a..a9aa240ff6 100644
--- a/openpype/pipeline/load/utils.py
+++ b/openpype/pipeline/load/utils.py
@@ -694,6 +694,35 @@ def loaders_from_representation(loaders, representation):
     return loaders_from_repre_context(loaders, context)
 
 
+def any_outdated_containers(host=None, project_name=None):
+    """Check if there are any outdated containers in scene."""
+
+    if get_outdated_containers(host, project_name):
+        return True
+    return False
+
+
+def get_outdated_containers(host=None, project_name=None):
+    """Collect outdated containers from host scene.
+
+    Currently registered host and project in global session are used if
+    arguments are not passed.
+
+    Args:
+        host (ModuleType): Host implementation with 'ls' function available.
+        project_name (str): Name of project in which context we are.
+    """
+
+    if host is None:
+        from openpype.pipeline import registered_host
+        host = registered_host()
+
+    if project_name is None:
+        project_name = legacy_io.active_project()
+    containers = host.ls()
+    return filter_containers(containers, project_name).outdated
+
+
 def filter_containers(containers, project_name):
     """Filter containers and split them into 4 categories.