From b0055516e6631d26fedfd499769984a7f2963f79 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 29 Mar 2022 15:21:35 +0200
Subject: [PATCH 001/151] OP-2834 - Fix getting non-active model panel.

---
 .../maya/plugins/publish/extract_playblast.py | 21 +++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/openpype/hosts/maya/plugins/publish/extract_playblast.py b/openpype/hosts/maya/plugins/publish/extract_playblast.py
index bb1ecf279d..7fa9a840e9 100644
--- a/openpype/hosts/maya/plugins/publish/extract_playblast.py
+++ b/openpype/hosts/maya/plugins/publish/extract_playblast.py
@@ -90,6 +90,24 @@ class ExtractPlayblast(openpype.api.Extractor):
         else:
             preset["viewport_options"] = {"imagePlane": image_plane}
 
+        # Image planes do not update the file sequence unless the active panel
+        # is viewing through the camera.
+        model_panel = instance.context.data.get("model_panel")
+        if not model_panel:
+            model_panels = cmds.getPanel(type="modelPanel")
+            visible_panels = cmds.getPanel(visiblePanels=True)
+            model_panel = list(
+                set(visible_panels) - (set(visible_panels) - set(model_panels))
+            )[0]
+            instance.context.data["model_panel"] = model_panel
+
+        panel_camera = instance.context.data.get("panel_camera")
+        if not panel_camera:
+            panel_camera = capture.parse_view(model_panel)["camera"]
+            instance.context.data["panel_camera"] = panel_camera
+
+        cmds.modelPanel(model_panel, edit=True, camera=preset["camera"])
+
         with maintained_time():
             filename = preset.get("filename", "%TEMP%")
 
@@ -108,6 +126,9 @@ class ExtractPlayblast(openpype.api.Extractor):
 
             path = capture.capture(**preset)
 
+        # Restore panel camera.
+        cmds.modelPanel(model_panel, edit=True, camera=panel_camera)
+
         self.log.debug("playblast path  {}".format(path))
 
         collected_files = os.listdir(stagingdir)

From 6e34c4aed26e20bc8b1af0fc0e368060cf684d20 Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Thu, 9 Mar 2023 16:13:32 +0100
Subject: [PATCH 002/151] Make sure value-data is int or float

---
 .../modules/kitsu/utils/update_op_with_zou.py | 36 ++++++++++---------
 1 file changed, 20 insertions(+), 16 deletions(-)

diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index 4fa8cf9fdd..a2b560b75b 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -128,8 +128,8 @@ def update_op_assets(
             if frames_duration:
                 frame_out = frame_in + frames_duration - 1
             else:
-                frame_out = project_doc["data"].get("frameEnd", frame_in)
-        item_data["frameEnd"] = frame_out
+                frame_out = int(project_doc["data"].get("frameEnd", frame_in))
+        item_data["frameEnd"] = int(frame_out)
         # Fps, fallback to project's value or default value (25.0)
         try:
             fps = float(item_data.get("fps"))
@@ -147,33 +147,37 @@ def update_op_assets(
             item_data["resolutionWidth"] = int(match_res.group(1))
             item_data["resolutionHeight"] = int(match_res.group(2))
         else:
-            item_data["resolutionWidth"] = project_doc["data"].get(
-                "resolutionWidth"
+            item_data["resolutionWidth"] = int(
+                project_doc["data"].get("resolutionWidth")
             )
-            item_data["resolutionHeight"] = project_doc["data"].get(
-                "resolutionHeight"
+            item_data["resolutionHeight"] = int(
+                project_doc["data"].get("resolutionHeight")
             )
         # Properties that doesn't fully exist in Kitsu.
         # Guessing those property names below:
         # Pixel Aspect Ratio
-        item_data["pixelAspect"] = item_data.get(
-            "pixel_aspect", project_doc["data"].get("pixelAspect")
+        item_data["pixelAspect"] = float(
+            item_data.get(
+                "pixel_aspect", project_doc["data"].get("pixelAspect")
+            )
         )
         # Handle Start
-        item_data["handleStart"] = item_data.get(
-            "handle_start", project_doc["data"].get("handleStart")
+        item_data["handleStart"] = int(
+            item_data.get(
+                "handle_start", project_doc["data"].get("handleStart")
+            )
         )
         # Handle End
-        item_data["handleEnd"] = item_data.get(
-            "handle_end", project_doc["data"].get("handleEnd")
+        item_data["handleEnd"] = int(
+            item_data.get("handle_end", project_doc["data"].get("handleEnd"))
         )
         # Clip In
-        item_data["clipIn"] = item_data.get(
-            "clip_in", project_doc["data"].get("clipIn")
+        item_data["clipIn"] = int(
+            item_data.get("clip_in", project_doc["data"].get("clipIn"))
         )
         # Clip Out
-        item_data["clipOut"] = item_data.get(
-            "clip_out", project_doc["data"].get("clipOut")
+        item_data["clipOut"] = int(
+            item_data.get("clip_out", project_doc["data"].get("clipOut"))
         )
 
         # Tasks

From 10da5885cd8611354f0c903622a33124dcda4ac4 Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Thu, 9 Mar 2023 21:13:42 +0100
Subject: [PATCH 003/151] Get the settings up and running

---
 .../defaults/project_settings/kitsu.json      |  6 ++++-
 .../projects_schema/schema_project_kitsu.json | 26 ++++++++++++++++++-
 2 files changed, 30 insertions(+), 2 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/kitsu.json b/openpype/settings/defaults/project_settings/kitsu.json
index 95b3da04ae..280895f1b9 100644
--- a/openpype/settings/defaults/project_settings/kitsu.json
+++ b/openpype/settings/defaults/project_settings/kitsu.json
@@ -8,6 +8,10 @@
         "IntegrateKitsuNote": {
             "set_status_note": false,
             "note_status_shortname": "wfa"
+        },
+        "CustomCommentTemplate": {
+            "enabled": false,
+            "comment_template": "{comment}\n\n|  |  |\n|--|--|\n| version| `{version}` |\n| family | `{family}` |\n| name | `{name}` |"
         }
     }
-}
+}
\ No newline at end of file
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
index fb47670e74..255190c396 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
@@ -54,8 +54,32 @@
                             "label": "Note shortname"
                         }
                     ]
+                },
+                {
+                    "type": "dict",
+                    "collapsible": true,
+                    "checkbox_key": "enabled",
+                    "key": "CustomCommentTemplate",
+                    "label": "Custom Comment Template",
+                    "children": [
+                        {
+                            "type": "boolean",
+                            "key": "enabled",
+                            "label": "Enabled"
+                        },
+                        {
+                            "type": "label",
+                            "label": "Kitsu supports markdown and here you can create a custom comment template.<br/>You can use data from your instance's anatomy."
+                        },
+                        {
+                            "key": "comment_template",
+                            "type": "text",
+                            "multiline": true,
+                            "label": "Custom comment"
+                        }
+                    ]
                 }
             ]
         }
     ]
-}
+}
\ No newline at end of file

From e2771abfb48d255288a708407b305241f4601737 Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Fri, 10 Mar 2023 23:07:13 +0100
Subject: [PATCH 004/151] Move CustomCommentTemplate to within
 IntegrateKitsuNote

---
 .../defaults/project_settings/kitsu.json      | 10 ++---
 .../projects_schema/schema_project_kitsu.json | 44 +++++++++----------
 2 files changed, 27 insertions(+), 27 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/kitsu.json b/openpype/settings/defaults/project_settings/kitsu.json
index 280895f1b9..f8a98d1a0b 100644
--- a/openpype/settings/defaults/project_settings/kitsu.json
+++ b/openpype/settings/defaults/project_settings/kitsu.json
@@ -7,11 +7,11 @@
     "publish": {
         "IntegrateKitsuNote": {
             "set_status_note": false,
-            "note_status_shortname": "wfa"
-        },
-        "CustomCommentTemplate": {
-            "enabled": false,
-            "comment_template": "{comment}\n\n|  |  |\n|--|--|\n| version| `{version}` |\n| family | `{family}` |\n| name | `{name}` |"
+            "note_status_shortname": "wfa",
+            "CustomCommentTemplate": {
+                "enabled": false,
+                "comment_template": "{comment}\n\n|  |  |\n|--|--|\n| version| `{version}` |\n| family | `{family}` |\n| name | `{name}` |"
+            }
         }
     }
 }
\ No newline at end of file
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
index 255190c396..25f75c8280 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
@@ -52,30 +52,30 @@
                             "type": "text",
                             "key": "note_status_shortname",
                             "label": "Note shortname"
-                        }
-                    ]
-                },
-                {
-                    "type": "dict",
-                    "collapsible": true,
-                    "checkbox_key": "enabled",
-                    "key": "CustomCommentTemplate",
-                    "label": "Custom Comment Template",
-                    "children": [
-                        {
-                            "type": "boolean",
-                            "key": "enabled",
-                            "label": "Enabled"
                         },
                         {
-                            "type": "label",
-                            "label": "Kitsu supports markdown and here you can create a custom comment template.<br/>You can use data from your instance's anatomy."
-                        },
-                        {
-                            "key": "comment_template",
-                            "type": "text",
-                            "multiline": true,
-                            "label": "Custom comment"
+                            "type": "dict",
+                            "collapsible": true,
+                            "checkbox_key": "enabled",
+                            "key": "CustomCommentTemplate",
+                            "label": "Custom Comment Template",
+                            "children": [
+                                {
+                                    "type": "boolean",
+                                    "key": "enabled",
+                                    "label": "Enabled"
+                                },
+                                {
+                                    "type": "label",
+                                    "label": "Kitsu supports markdown and here you can create a custom comment template.<br/>You can use data from your instance's anatomy."
+                                },
+                                {
+                                    "key": "comment_template",
+                                    "type": "text",
+                                    "multiline": true,
+                                    "label": "Custom comment"
+                                }
+                            ]
                         }
                     ]
                 }

From 7c1789faabea2380ab3001e32876d2747cf55f28 Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Fri, 10 Mar 2023 23:07:41 +0100
Subject: [PATCH 005/151] Add custom message functionally

---
 .../plugins/publish/integrate_kitsu_note.py   | 36 +++++++++++++++++--
 1 file changed, 34 insertions(+), 2 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index 6702cbe7aa..b1743ca828 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -1,6 +1,7 @@
 # -*- coding: utf-8 -*-
 import gazu
 import pyblish.api
+import re
 
 
 class IntegrateKitsuNote(pyblish.api.ContextPlugin):
@@ -9,17 +10,39 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
     order = pyblish.api.IntegratorOrder
     label = "Kitsu Note and Status"
     families = ["render", "kitsu"]
+
+    # status settings
     set_status_note = False
     note_status_shortname = "wfa"
 
+    # comment settings
+    CustomCommentTemplate = {}
+    CustomCommentTemplate["enabled"] = False
+    CustomCommentTemplate["comment_template"] = "{comment}"
+
+    def safe_format(self, msg, **kwargs):
+        def replace_missing(match):
+            value = kwargs.get(match.group(1), None)
+            if value is None:
+                self.log.warning(
+                    "Key `{}` was not found in instance.data "
+                    "and will be rendered as `` in the comment".format(
+                        match.group(1)
+                    )
+                )
+                return ""
+            else:
+                return str(value)
+
+        pattern = r"\{([^}]*)\}"
+        return re.sub(pattern, replace_missing, msg)
+
     def process(self, context):
         # Get comment text body
         publish_comment = context.data.get("comment")
         if not publish_comment:
             self.log.info("Comment is not set.")
 
-        self.log.debug("Comment is `{}`".format(publish_comment))
-
         for instance in context:
             kitsu_task = instance.data.get("kitsu_task")
             if kitsu_task is None:
@@ -42,6 +65,15 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
                         "changed!".format(self.note_status_shortname)
                     )
 
+            # If custom comment, create it
+            if self.CustomCommentTemplate["enabled"]:
+                publish_comment = self.safe_format(
+                    self.CustomCommentTemplate["comment_template"],
+                    **instance.data,
+                )
+
+            self.log.debug("Comment is `{}`".format(publish_comment))
+
             # Add comment to kitsu task
             task_id = kitsu_task["id"]
             self.log.debug("Add new note in taks id {}".format(task_id))

From a797d78d451eb953bd5c4a2018712ade3e645c2a Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Fri, 10 Mar 2023 23:19:31 +0100
Subject: [PATCH 006/151] Added a check so only renders gets published to Kitsu

---
 .../modules/kitsu/plugins/publish/integrate_kitsu_note.py     | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index b1743ca828..44134dec6d 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -44,6 +44,10 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
             self.log.info("Comment is not set.")
 
         for instance in context:
+            # Check if instance is a render by checking its family
+            if "render" not in instance.data["family"]:
+                continue
+
             kitsu_task = instance.data.get("kitsu_task")
             if kitsu_task is None:
                 continue

From 1093c519add9baae3276e01aa28e1a1d46cab0c8 Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Fri, 10 Mar 2023 23:27:47 +0100
Subject: [PATCH 007/151] Change the label to explain more correct what it does

---
 .../schemas/projects_schema/schema_project_kitsu.json         | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
index 25f75c8280..1a7747b3dc 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
@@ -46,12 +46,12 @@
                         {
                             "type": "boolean",
                             "key": "set_status_note",
-                            "label": "Set status on note"
+                            "label": "Set status with note"
                         },
                         {
                             "type": "text",
                             "key": "note_status_shortname",
-                            "label": "Note shortname"
+                            "label": "Status shortname"
                         },
                         {
                             "type": "dict",

From 021454dc9bc72e9d09c0e4447f3d37647ad79669 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sat, 11 Mar 2023 06:59:43 +0100
Subject: [PATCH 008/151] Fix #4044: Don't rely on containers, but just get ids
 from the nodes

---
 openpype/tools/mayalookassigner/commands.py | 18 +++---------------
 1 file changed, 3 insertions(+), 15 deletions(-)

diff --git a/openpype/tools/mayalookassigner/commands.py b/openpype/tools/mayalookassigner/commands.py
index 2e7a51efde..6955dda97f 100644
--- a/openpype/tools/mayalookassigner/commands.py
+++ b/openpype/tools/mayalookassigner/commands.py
@@ -80,21 +80,9 @@ def get_all_asset_nodes():
     Returns:
         list: list of dictionaries
     """
-
-    host = registered_host()
-
-    nodes = []
-    for container in host.ls():
-        # We are not interested in looks but assets!
-        if container["loader"] == "LookLoader":
-            continue
-
-        # Gather all information
-        container_name = container["objectName"]
-        nodes += lib.get_container_members(container_name)
-
-    nodes = list(set(nodes))
-    return nodes
+    nodes = cmds.ls(dag=True, noIntermediate=True, long=True)
+    items = commands.create_items_from_nodes(nodes)
+    return items
 
 
 def create_asset_id_hash(nodes):

From b44b0b8fb063aeef51761a2b179cd9e074a9a5f8 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sat, 11 Mar 2023 07:57:20 +0100
Subject: [PATCH 009/151] Remove `commands.` prefix since function is local

---
 openpype/tools/mayalookassigner/commands.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/tools/mayalookassigner/commands.py b/openpype/tools/mayalookassigner/commands.py
index 6955dda97f..0135eb4f49 100644
--- a/openpype/tools/mayalookassigner/commands.py
+++ b/openpype/tools/mayalookassigner/commands.py
@@ -81,7 +81,7 @@ def get_all_asset_nodes():
         list: list of dictionaries
     """
     nodes = cmds.ls(dag=True, noIntermediate=True, long=True)
-    items = commands.create_items_from_nodes(nodes)
+    items = create_items_from_nodes(nodes)
     return items
 
 

From 24a22e964a4de4481c9896eca2ebc5ebf75adabd Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 13 Mar 2023 16:27:33 +0100
Subject: [PATCH 010/151] Nuke: fix families mixing up with old way.

---
 .../deadline/plugins/publish/submit_nuke_deadline.py     | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/openpype/modules/deadline/plugins/publish/submit_nuke_deadline.py b/openpype/modules/deadline/plugins/publish/submit_nuke_deadline.py
index aff34c7e4a..9abe8dec8b 100644
--- a/openpype/modules/deadline/plugins/publish/submit_nuke_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_nuke_deadline.py
@@ -32,7 +32,7 @@ class NukeSubmitDeadline(pyblish.api.InstancePlugin,
     label = "Submit Nuke to Deadline"
     order = pyblish.api.IntegratorOrder + 0.1
     hosts = ["nuke"]
-    families = ["render", "prerender.farm"]
+    families = ["render", "prerender"]
     optional = True
     targets = ["local"]
 
@@ -80,6 +80,9 @@ class NukeSubmitDeadline(pyblish.api.InstancePlugin,
         ]
 
     def process(self, instance):
+        if not instance.data.get("farm"):
+            return
+
         instance.data["attributeValues"] = self.get_attr_values_from_data(
             instance.data)
 
@@ -168,10 +171,10 @@ class NukeSubmitDeadline(pyblish.api.InstancePlugin,
                     resp.json()["_id"])
 
         # redefinition of families
-        if "render.farm" in families:
+        if "render" in family:
             instance.data['family'] = 'write'
             families.insert(0, "render2d")
-        elif "prerender.farm" in families:
+        elif "prerender" in family:
             instance.data['family'] = 'write'
             families.insert(0, "prerender")
         instance.data["families"] = families

From 0483714dcb55f2f7b2db5892c640ef6b673f393f Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Mon, 13 Mar 2023 17:49:44 +0100
Subject: [PATCH 011/151] Change "Maya" to Fusion in comment

---
 openpype/hosts/fusion/api/action.py | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/fusion/api/action.py b/openpype/hosts/fusion/api/action.py
index 1750920950..ff5dd14caa 100644
--- a/openpype/hosts/fusion/api/action.py
+++ b/openpype/hosts/fusion/api/action.py
@@ -6,12 +6,13 @@ from openpype.pipeline.publish import get_errored_instances_from_context
 
 
 class SelectInvalidAction(pyblish.api.Action):
-    """Select invalid nodes in Maya when plug-in failed.
+    """Select invalid nodes in Fusion when plug-in failed.
 
     To retrieve the invalid nodes this assumes a static `get_invalid()`
     method is available on the plugin.
 
     """
+
     label = "Select invalid"
     on = "failed"  # This action is only available on a failed plug-in
     icon = "search"  # Icon from Awesome Icon
@@ -31,8 +32,10 @@ class SelectInvalidAction(pyblish.api.Action):
                 if isinstance(invalid_nodes, (list, tuple)):
                     invalid.extend(invalid_nodes)
                 else:
-                    self.log.warning("Plug-in returned to be invalid, "
-                                     "but has no selectable nodes.")
+                    self.log.warning(
+                        "Plug-in returned to be invalid, "
+                        "but has no selectable nodes."
+                    )
 
         if not invalid:
             # Assume relevant comp is current comp and clear selection
@@ -51,4 +54,6 @@ class SelectInvalidAction(pyblish.api.Action):
         for tool in invalid:
             flow.Select(tool, True)
             names.add(tool.Name)
-        self.log.info("Selecting invalid tools: %s" % ", ".join(sorted(names)))
+        self.log.info(
+            "Selecting invalid tools: %s" % ", ".join(sorted(names))
+        )

From ea7390d1d3e91385cd7f723c3067cebabf5cca03 Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Mon, 13 Mar 2023 17:50:56 +0100
Subject: [PATCH 012/151] Added create and instance attr to Create plugin

Where they get it from should be moved into another folder so other plugins can get the same data.
---
 .../fusion/plugins/create/create_saver.py     | 83 +++++++++++++------
 1 file changed, 56 insertions(+), 27 deletions(-)

diff --git a/openpype/hosts/fusion/plugins/create/create_saver.py b/openpype/hosts/fusion/plugins/create/create_saver.py
index e581bac20f..56085b0a06 100644
--- a/openpype/hosts/fusion/plugins/create/create_saver.py
+++ b/openpype/hosts/fusion/plugins/create/create_saver.py
@@ -4,29 +4,34 @@ import qtawesome
 
 from openpype.hosts.fusion.api import (
     get_current_comp,
-    comp_lock_and_undo_chunk
+    comp_lock_and_undo_chunk,
 )
 
-from openpype.lib import BoolDef
+from openpype.lib import (
+    BoolDef,
+    EnumDef,
+)
 from openpype.pipeline import (
     legacy_io,
     Creator,
-    CreatedInstance
+    CreatedInstance,
+)
+from openpype.client import (
+    get_asset_by_name,
 )
-from openpype.client import get_asset_by_name
 
 
 class CreateSaver(Creator):
     identifier = "io.openpype.creators.fusion.saver"
-    name = "saver"
-    label = "Saver"
+    label = "Render (saver)"
+    name = "render"
     family = "render"
-    default_variants = ["Main"]
-
+    default_variants = ["Main", "Mask"]
     description = "Fusion Saver to generate image sequence"
 
-    def create(self, subset_name, instance_data, pre_create_data):
+    instance_attributes = ["reviewable"]
 
+    def create(self, subset_name, instance_data, pre_create_data):
         # TODO: Add pre_create attributes to choose file format?
         file_format = "OpenEXRFormat"
 
@@ -58,7 +63,8 @@ class CreateSaver(Creator):
             family=self.family,
             subset_name=subset_name,
             data=instance_data,
-            creator=self)
+            creator=self,
+        )
 
         # Insert the transient data
         instance.transient_data["tool"] = saver
@@ -68,11 +74,9 @@ class CreateSaver(Creator):
         return instance
 
     def collect_instances(self):
-
         comp = get_current_comp()
         tools = comp.GetToolList(False, "Saver").values()
         for tool in tools:
-
             data = self.get_managed_tool_data(tool)
             if not data:
                 data = self._collect_unmanaged_saver(tool)
@@ -90,7 +94,6 @@ class CreateSaver(Creator):
 
     def update_instances(self, update_list):
         for created_inst, _changes in update_list:
-
             new_data = created_inst.data_to_store()
             tool = created_inst.transient_data["tool"]
             self._update_tool_with_data(tool, new_data)
@@ -139,7 +142,6 @@ class CreateSaver(Creator):
                 tool.SetAttrs({"TOOLS_Name": subset})
 
     def _collect_unmanaged_saver(self, tool):
-
         # TODO: this should not be done this way - this should actually
         #       get the data as stored on the tool explicitly (however)
         #       that would disallow any 'regular saver' to be collected
@@ -153,8 +155,7 @@ class CreateSaver(Creator):
         asset = legacy_io.Session["AVALON_ASSET"]
         task = legacy_io.Session["AVALON_TASK"]
 
-        asset_doc = get_asset_by_name(project_name=project,
-                                      asset_name=asset)
+        asset_doc = get_asset_by_name(project_name=project, asset_name=asset)
 
         path = tool["Clip"][comp.TIME_UNDEFINED]
         fname = os.path.basename(path)
@@ -178,21 +179,20 @@ class CreateSaver(Creator):
             "variant": variant,
             "active": not passthrough,
             "family": self.family,
-
             # Unique identifier for instance and this creator
             "id": "pyblish.avalon.instance",
-            "creator_identifier": self.identifier
+            "creator_identifier": self.identifier,
         }
 
     def get_managed_tool_data(self, tool):
         """Return data of the tool if it matches creator identifier"""
-        data = tool.GetData('openpype')
+        data = tool.GetData("openpype")
         if not isinstance(data, dict):
             return
 
         required = {
             "id": "pyblish.avalon.instance",
-            "creator_identifier": self.identifier
+            "creator_identifier": self.identifier,
         }
         for key, value in required.items():
             if key not in data or data[key] != value:
@@ -205,11 +205,40 @@ class CreateSaver(Creator):
 
         return data
 
-    def get_instance_attr_defs(self):
-        return [
-            BoolDef(
-                "review",
-                default=True,
-                label="Review"
-            )
+    def get_pre_create_attr_defs(self):
+        """Settings for create page"""
+        attr_defs = [
+            self._get_render_target_enum(),
+            self._get_reviewable_bool(),
         ]
+        return attr_defs
+
+    def get_instance_attr_defs(self):
+        """Settings for publish page"""
+        attr_defs = [
+            self._get_render_target_enum(),
+            self._get_reviewable_bool(),
+        ]
+        return attr_defs
+
+    # These functions below should be moved to another file
+    # so it can be used by other plugins. plugin.py ?
+
+    def _get_render_target_enum(self):
+        rendering_targets = {
+            "local": "Local machine rendering",
+            "frames": "Use existing frames",
+        }
+        if "farm_rendering" in self.instance_attributes:
+            rendering_targets["farm"] = "Farm rendering"
+
+        return EnumDef(
+            "render_target", items=rendering_targets, label="Render target"
+        )
+
+    def _get_reviewable_bool(self):
+        return BoolDef(
+            "review",
+            default=("reviewable" in self.instance_attributes),
+            label="Review",
+        )

From 0414045f362bdd6c2ecfeb5851b82f129de4f710 Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Mon, 13 Mar 2023 17:54:02 +0100
Subject: [PATCH 013/151] Split the render into render and review data

---
 .../plugins/publish/collect_render_target.py  | 44 ---------------
 .../fusion/plugins/publish/collect_renders.py | 42 ++++++++++++++
 ...ender_local.py => extract_render_local.py} | 46 ++--------------
 .../plugins/publish/extract_review_data.py    | 55 +++++++++++++++++++
 4 files changed, 102 insertions(+), 85 deletions(-)
 delete mode 100644 openpype/hosts/fusion/plugins/publish/collect_render_target.py
 create mode 100644 openpype/hosts/fusion/plugins/publish/collect_renders.py
 rename openpype/hosts/fusion/plugins/publish/{render_local.py => extract_render_local.py} (59%)
 create mode 100644 openpype/hosts/fusion/plugins/publish/extract_review_data.py

diff --git a/openpype/hosts/fusion/plugins/publish/collect_render_target.py b/openpype/hosts/fusion/plugins/publish/collect_render_target.py
deleted file mode 100644
index 39017f32e0..0000000000
--- a/openpype/hosts/fusion/plugins/publish/collect_render_target.py
+++ /dev/null
@@ -1,44 +0,0 @@
-import pyblish.api
-
-
-class CollectFusionRenderMode(pyblish.api.InstancePlugin):
-    """Collect current comp's render Mode
-
-    Options:
-        local
-        farm
-
-    Note that this value is set for each comp separately. When you save the
-    comp this information will be stored in that file. If for some reason the
-    available tool does not visualize which render mode is set for the
-    current comp, please run the following line in the console (Py2)
-
-    comp.GetData("openpype.rendermode")
-
-    This will return the name of the current render mode as seen above under
-    Options.
-
-    """
-
-    order = pyblish.api.CollectorOrder + 0.4
-    label = "Collect Render Mode"
-    hosts = ["fusion"]
-    families = ["render"]
-
-    def process(self, instance):
-        """Collect all image sequence tools"""
-        options = ["local", "farm"]
-
-        comp = instance.context.data.get("currentComp")
-        if not comp:
-            raise RuntimeError("No comp previously collected, unable to "
-                               "retrieve Fusion version.")
-
-        rendermode = comp.GetData("openpype.rendermode") or "local"
-        assert rendermode in options, "Must be supported render mode"
-
-        self.log.info("Render mode: {0}".format(rendermode))
-
-        # Append family
-        family = "render.{0}".format(rendermode)
-        instance.data["families"].append(family)
diff --git a/openpype/hosts/fusion/plugins/publish/collect_renders.py b/openpype/hosts/fusion/plugins/publish/collect_renders.py
new file mode 100644
index 0000000000..cdd37b3b65
--- /dev/null
+++ b/openpype/hosts/fusion/plugins/publish/collect_renders.py
@@ -0,0 +1,42 @@
+import pyblish.api
+from pprint import pformat
+
+
+class CollectFusionRenders(pyblish.api.InstancePlugin):
+    """Collect current comp's render Mode
+
+    Options:
+        local
+        farm
+
+    Note that this value is set for each comp separately. When you save the
+    comp this information will be stored in that file. If for some reason the
+    available tool does not visualize which render mode is set for the
+    current comp, please run the following line in the console (Py2)
+
+    comp.GetData("openpype.rendermode")
+
+    This will return the name of the current render mode as seen above under
+    Options.
+
+    """
+
+    order = pyblish.api.CollectorOrder + 0.4
+    label = "Collect Renders"
+    hosts = ["fusion"]
+    families = ["render"]
+
+    def process(self, instance):
+        self.log.debug(pformat(instance.data))
+
+        saver_node = instance.data["transientData"]["tool"]
+        render_target = instance.data["render_target"]
+        family = instance.data["family"]
+        families = instance.data["families"]
+
+        # add targeted family to families
+        instance.data["families"].append(
+            "{}.{}".format(family, render_target)
+        )
+
+        self.log.debug(pformat(instance.data))
diff --git a/openpype/hosts/fusion/plugins/publish/render_local.py b/openpype/hosts/fusion/plugins/publish/extract_render_local.py
similarity index 59%
rename from openpype/hosts/fusion/plugins/publish/render_local.py
rename to openpype/hosts/fusion/plugins/publish/extract_render_local.py
index 7d5f1a40c7..62625c899a 100644
--- a/openpype/hosts/fusion/plugins/publish/render_local.py
+++ b/openpype/hosts/fusion/plugins/publish/extract_render_local.py
@@ -4,16 +4,12 @@ from openpype.pipeline import publish
 from openpype.hosts.fusion.api import comp_lock_and_undo_chunk
 
 
-class Fusionlocal(pyblish.api.InstancePlugin,
-                  publish.ColormanagedPyblishPluginMixin):
-    """Render the current Fusion composition locally.
+class FusionRenderLocal(
+    pyblish.api.InstancePlugin, publish.ColormanagedPyblishPluginMixin
+):
+    """Render the current Fusion composition locally."""
 
-    Extract the result of savers by starting a comp render
-    This will run the local render of Fusion.
-
-    """
-
-    order = pyblish.api.ExtractorOrder - 0.1
+    order = pyblish.api.ExtractorOrder - 0.2
     label = "Render Local"
     hosts = ["fusion"]
     families = ["render.local"]
@@ -33,38 +29,6 @@ class Fusionlocal(pyblish.api.InstancePlugin,
             )
         )
 
-        frame_start = context.data["frameStartHandle"]
-        frame_end = context.data["frameEndHandle"]
-        path = instance.data["path"]
-        output_dir = instance.data["outputDir"]
-
-        basename = os.path.basename(path)
-        head, ext = os.path.splitext(basename)
-        files = [
-            f"{head}{str(frame).zfill(4)}{ext}"
-            for frame in range(frame_start, frame_end + 1)
-        ]
-        repre = {
-            "name": ext[1:],
-            "ext": ext[1:],
-            "frameStart": f"%0{len(str(frame_end))}d" % frame_start,
-            "files": files,
-            "stagingDir": output_dir,
-        }
-
-        self.set_representation_colorspace(
-            representation=repre,
-            context=context,
-        )
-
-        if "representations" not in instance.data:
-            instance.data["representations"] = []
-        instance.data["representations"].append(repre)
-
-        # review representation
-        if instance.data.get("review", False):
-            repre["tags"] = ["review", "ftrackreview"]
-
     def render_once(self, context):
         """Render context comp only once, even with more render instances"""
 
diff --git a/openpype/hosts/fusion/plugins/publish/extract_review_data.py b/openpype/hosts/fusion/plugins/publish/extract_review_data.py
new file mode 100644
index 0000000000..d9416771f6
--- /dev/null
+++ b/openpype/hosts/fusion/plugins/publish/extract_review_data.py
@@ -0,0 +1,55 @@
+import os
+import pyblish.api
+from openpype.pipeline.publish import (
+    ColormanagedPyblishPluginMixin,
+)
+
+
+class FusionExtractReviewData(
+    pyblish.api.InstancePlugin, ColormanagedPyblishPluginMixin
+):
+    """
+    Extract the result of savers by starting a comp render
+    This will run the local render of Fusion.
+    """
+
+    order = pyblish.api.ExtractorOrder - 0.1
+    label = "Extract Review Data"
+    hosts = ["fusion"]
+    families = ["review"]
+
+    def process(self, instance):
+        context = instance.context
+
+        frame_start = context.data["frameStartHandle"]
+        frame_end = context.data["frameEndHandle"]
+        path = instance.data["path"]
+        output_dir = instance.data["outputDir"]
+
+        basename = os.path.basename(path)
+        head, ext = os.path.splitext(basename)
+        files = [
+            f"{head}{str(frame).zfill(4)}{ext}"
+            for frame in range(frame_start, frame_end + 1)
+        ]
+        repre = {
+            "name": ext[1:],
+            "ext": ext[1:],
+            "frameStart": f"%0{len(str(frame_end))}d" % frame_start,
+            "files": files,
+            "stagingDir": output_dir,
+        }
+
+        self.set_representation_colorspace(
+            representation=repre,
+            context=context,
+        )
+
+        # review representation
+        if instance.data.get("review", False):
+            repre["tags"] = ["review"]
+
+        # add the repre to the instance
+        if "representations" not in instance.data:
+            instance.data["representations"] = []
+        instance.data["representations"].append(repre)

From ba8d03715229693745ef5df4525c6eb0fc156bf2 Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Mon, 13 Mar 2023 17:54:47 +0100
Subject: [PATCH 014/151] Validate that frames for "use existing frames" do
 exist

---
 .../validate_local_frames_existence.py        | 71 +++++++++++++++++++
 1 file changed, 71 insertions(+)
 create mode 100644 openpype/hosts/fusion/plugins/publish/validate_local_frames_existence.py

diff --git a/openpype/hosts/fusion/plugins/publish/validate_local_frames_existence.py b/openpype/hosts/fusion/plugins/publish/validate_local_frames_existence.py
new file mode 100644
index 0000000000..d80e11e078
--- /dev/null
+++ b/openpype/hosts/fusion/plugins/publish/validate_local_frames_existence.py
@@ -0,0 +1,71 @@
+import os
+import pyblish.api
+
+from openpype.pipeline.publish import RepairAction
+from openpype.pipeline import PublishValidationError
+
+from openpype.hosts.fusion.api.action import SelectInvalidAction
+
+
+class ValidateLocalFramesExistence(pyblish.api.InstancePlugin):
+    """Checks if files for savers that's set to publish existing frames exists"""
+
+    order = pyblish.api.ValidatorOrder
+    label = "Validate Existing Frames Exists"
+    families = ["render"]
+    hosts = ["fusion"]
+    actions = [RepairAction, SelectInvalidAction]
+
+    @classmethod
+    def get_invalid(cls, instance):
+        active = instance.data.get("active", instance.data.get("publish"))
+        if not active:
+            return []
+
+        if instance.data.get("render_target") == "frames":
+            tool = instance[0]
+
+            frame_start = instance.data["frameStart"]
+            frame_end = instance.data["frameEnd"]
+            path = instance.data["path"]
+            output_dir = instance.data["outputDir"]
+
+            basename = os.path.basename(path)
+            head, ext = os.path.splitext(basename)
+            files = [
+                f"{head}{str(frame).zfill(4)}{ext}"
+                for frame in range(frame_start, frame_end + 1)
+            ]
+
+            non_existing_frames = []
+
+            for file in files:
+                cls.log.error(file)
+                if not os.path.exists(os.path.join(output_dir, file)):
+                    non_existing_frames.append(file)
+
+            if len(non_existing_frames) > 0:
+                cls.log.error(
+                    "Some of {}'s files does not exist".format(tool.Name)
+                )
+                return [tool, output_dir, non_existing_frames]
+
+    def process(self, instance):
+        invalid = self.get_invalid(instance)
+        if invalid:
+            raise PublishValidationError(
+                "{} is set to publish existing frames but "
+                "some frames are missing in the folder:\n\n{}"
+                "The missing file(s) are:\n\n{}".format(
+                    invalid[0].Name,
+                    invalid[1],
+                    "\n\n".join(invalid[2]),
+                ),
+                title=self.label,
+            )
+
+    @classmethod
+    def repair(cls, instance):
+        invalid = cls.get_invalid(instance)
+        for tool in invalid:
+            tool.SetInput("CreateDir", 1.0)

From a15e29afaf5ff8e78296f36cea9f06d036e1cccf Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Mon, 13 Mar 2023 17:55:04 +0100
Subject: [PATCH 015/151] Fixed repair-button to show up on review tab

---
 .../plugins/publish/validate_create_folder_checked.py  | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/fusion/plugins/publish/validate_create_folder_checked.py b/openpype/hosts/fusion/plugins/publish/validate_create_folder_checked.py
index ba943abacb..53dea2af71 100644
--- a/openpype/hosts/fusion/plugins/publish/validate_create_folder_checked.py
+++ b/openpype/hosts/fusion/plugins/publish/validate_create_folder_checked.py
@@ -14,11 +14,10 @@ class ValidateCreateFolderChecked(pyblish.api.InstancePlugin):
     """
 
     order = pyblish.api.ValidatorOrder
-    actions = [RepairAction]
     label = "Validate Create Folder Checked"
     families = ["render"]
     hosts = ["fusion"]
-    actions = [SelectInvalidAction]
+    actions = [RepairAction, SelectInvalidAction]
 
     @classmethod
     def get_invalid(cls, instance):
@@ -29,7 +28,9 @@ class ValidateCreateFolderChecked(pyblish.api.InstancePlugin):
         tool = instance[0]
         create_dir = tool.GetInput("CreateDir")
         if create_dir == 0.0:
-            cls.log.error("%s has Create Folder turned off" % instance[0].Name)
+            cls.log.error(
+                "%s has Create Folder turned off" % instance[0].Name
+            )
             return [tool]
 
     def process(self, instance):
@@ -37,7 +38,8 @@ class ValidateCreateFolderChecked(pyblish.api.InstancePlugin):
         if invalid:
             raise PublishValidationError(
                 "Found Saver with Create Folder During Render checked off",
-                title=self.label)
+                title=self.label,
+            )
 
     @classmethod
     def repair(cls, instance):

From 73b6ee58ae61b6ee88d6cd6bd28f78c6610220f1 Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Mon, 13 Mar 2023 17:57:09 +0100
Subject: [PATCH 016/151] Remove old Render Mode menu

---
 openpype/hosts/fusion/api/menu.py             |  12 --
 .../hosts/fusion/scripts/set_rendermode.py    | 112 ------------------
 2 files changed, 124 deletions(-)
 delete mode 100644 openpype/hosts/fusion/scripts/set_rendermode.py

diff --git a/openpype/hosts/fusion/api/menu.py b/openpype/hosts/fusion/api/menu.py
index 343f5f803a..ba3ce6798d 100644
--- a/openpype/hosts/fusion/api/menu.py
+++ b/openpype/hosts/fusion/api/menu.py
@@ -60,7 +60,6 @@ class OpenPypeMenu(QtWidgets.QWidget):
         publish_btn = QtWidgets.QPushButton("Publish...", self)
         manager_btn = QtWidgets.QPushButton("Manage...", self)
         libload_btn = QtWidgets.QPushButton("Library...", self)
-        rendermode_btn = QtWidgets.QPushButton("Set render mode...", self)
         set_framerange_btn = QtWidgets.QPushButton("Set Frame Range", self)
         set_resolution_btn = QtWidgets.QPushButton("Set Resolution", self)
         duplicate_with_inputs_btn = QtWidgets.QPushButton(
@@ -91,7 +90,6 @@ class OpenPypeMenu(QtWidgets.QWidget):
 
         layout.addWidget(set_framerange_btn)
         layout.addWidget(set_resolution_btn)
-        layout.addWidget(rendermode_btn)
 
         layout.addSpacing(20)
 
@@ -108,7 +106,6 @@ class OpenPypeMenu(QtWidgets.QWidget):
         load_btn.clicked.connect(self.on_load_clicked)
         manager_btn.clicked.connect(self.on_manager_clicked)
         libload_btn.clicked.connect(self.on_libload_clicked)
-        rendermode_btn.clicked.connect(self.on_rendermode_clicked)
         duplicate_with_inputs_btn.clicked.connect(
             self.on_duplicate_with_inputs_clicked
         )
@@ -162,15 +159,6 @@ class OpenPypeMenu(QtWidgets.QWidget):
     def on_libload_clicked(self):
         host_tools.show_library_loader()
 
-    def on_rendermode_clicked(self):
-        if self.render_mode_widget is None:
-            window = set_rendermode.SetRenderMode()
-            window.setStyleSheet(load_stylesheet())
-            window.show()
-            self.render_mode_widget = window
-        else:
-            self.render_mode_widget.show()
-
     def on_duplicate_with_inputs_clicked(self):
         duplicate_with_inputs.duplicate_with_input_connections()
 
diff --git a/openpype/hosts/fusion/scripts/set_rendermode.py b/openpype/hosts/fusion/scripts/set_rendermode.py
deleted file mode 100644
index 9d2bfef310..0000000000
--- a/openpype/hosts/fusion/scripts/set_rendermode.py
+++ /dev/null
@@ -1,112 +0,0 @@
-from qtpy import QtWidgets
-import qtawesome
-from openpype.hosts.fusion.api import get_current_comp
-
-
-_help = {"local": "Render the comp on your own machine and publish "
-                  "it from that the destination folder",
-         "farm": "Submit a Fusion render job to a Render farm to use all other"
-                 " computers and add a publish job"}
-
-
-class SetRenderMode(QtWidgets.QWidget):
-
-    def __init__(self, parent=None):
-        QtWidgets.QWidget.__init__(self, parent)
-
-        self._comp = get_current_comp()
-        self._comp_name = self._get_comp_name()
-
-        self.setWindowTitle("Set Render Mode")
-        self.setFixedSize(300, 175)
-
-        layout = QtWidgets.QVBoxLayout()
-
-        # region comp info
-        comp_info_layout = QtWidgets.QHBoxLayout()
-
-        update_btn = QtWidgets.QPushButton(qtawesome.icon("fa.refresh",
-                                                          color="white"), "")
-        update_btn.setFixedWidth(25)
-        update_btn.setFixedHeight(25)
-
-        comp_information = QtWidgets.QLineEdit()
-        comp_information.setEnabled(False)
-
-        comp_info_layout.addWidget(comp_information)
-        comp_info_layout.addWidget(update_btn)
-        # endregion comp info
-
-        # region modes
-        mode_options = QtWidgets.QComboBox()
-        mode_options.addItems(_help.keys())
-
-        mode_information = QtWidgets.QTextEdit()
-        mode_information.setReadOnly(True)
-        # endregion modes
-
-        accept_btn = QtWidgets.QPushButton("Accept")
-
-        layout.addLayout(comp_info_layout)
-        layout.addWidget(mode_options)
-        layout.addWidget(mode_information)
-        layout.addWidget(accept_btn)
-
-        self.setLayout(layout)
-
-        self.comp_information = comp_information
-        self.update_btn = update_btn
-
-        self.mode_options = mode_options
-        self.mode_information = mode_information
-
-        self.accept_btn = accept_btn
-
-        self.connections()
-        self.update()
-
-        # Force updated render mode help text
-        self._update_rendermode_info()
-
-    def connections(self):
-        """Build connections between code and buttons"""
-
-        self.update_btn.clicked.connect(self.update)
-        self.accept_btn.clicked.connect(self._set_comp_rendermode)
-        self.mode_options.currentIndexChanged.connect(
-            self._update_rendermode_info)
-
-    def update(self):
-        """Update all information in the UI"""
-
-        self._comp = get_current_comp()
-        self._comp_name = self._get_comp_name()
-        self.comp_information.setText(self._comp_name)
-
-        # Update current comp settings
-        mode = self._get_comp_rendermode()
-        index = self.mode_options.findText(mode)
-        self.mode_options.setCurrentIndex(index)
-
-    def _update_rendermode_info(self):
-        rendermode = self.mode_options.currentText()
-        self.mode_information.setText(_help[rendermode])
-
-    def _get_comp_name(self):
-        return self._comp.GetAttrs("COMPS_Name")
-
-    def _get_comp_rendermode(self):
-        return self._comp.GetData("openpype.rendermode") or "local"
-
-    def _set_comp_rendermode(self):
-        rendermode = self.mode_options.currentText()
-        self._comp.SetData("openpype.rendermode", rendermode)
-
-        self._comp.Print("Updated render mode to '%s'\n" % rendermode)
-        self.hide()
-
-    def _validation(self):
-        ui_mode = self.mode_options.currentText()
-        comp_mode = self._get_comp_rendermode()
-
-        return comp_mode == ui_mode

From 075ea125894262ad87597f46e78d3f54e8997d13 Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Mon, 13 Mar 2023 18:01:33 +0100
Subject: [PATCH 017/151] Remove reference to set_rendermode (forgot to delete
 it in last push)

---
 openpype/hosts/fusion/api/menu.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/hosts/fusion/api/menu.py b/openpype/hosts/fusion/api/menu.py
index ba3ce6798d..92f38a64c2 100644
--- a/openpype/hosts/fusion/api/menu.py
+++ b/openpype/hosts/fusion/api/menu.py
@@ -6,7 +6,6 @@ from openpype.tools.utils import host_tools
 from openpype.style import load_stylesheet
 from openpype.lib import register_event_callback
 from openpype.hosts.fusion.scripts import (
-    set_rendermode,
     duplicate_with_inputs,
 )
 from openpype.hosts.fusion.api.lib import (

From be463b05dc2fae9eda44bd2ce3bd1fd47eca82d0 Mon Sep 17 00:00:00 2001
From: Oscar Domingo <oscardomingo@gmail.com>
Date: Wed, 18 Jan 2023 15:55:40 +0000
Subject: [PATCH 018/151] documentation: Add `ARCHITECTURE.md` document This
 document attemps to give a quick overview of the project to help onboarding,
 it's not an extensive documentation but more of a elevator pitch one-line
 descriptions of files/directories and what the attempt to do.

---
 ARCHITECTURE.md | 77 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 77 insertions(+)
 create mode 100644 ARCHITECTURE.md

diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
new file mode 100644
index 0000000000..912780d803
--- /dev/null
+++ b/ARCHITECTURE.md
@@ -0,0 +1,77 @@
+# Architecture
+
+OpenPype is a monolithic Python project that bundles several parts, this document will try to give a birds eye overview of the project and, to a certain degree, each of the sub-projects.
+The current file structure looks like this:
+
+```
+.
+├── common - Code in this folder is backend portion of Addon distribution logic for v4 server.
+├── docs - Documentation of the source code.
+├── igniter - The OpenPype bootstrapper, deals with running version resolution and setting up the connection to the mongodb.
+├── openpype - The actual OpenPype core package.
+├── schema - Collection of JSON files describing schematics of objects. This follows Avalon's convention.
+├── tests - Integration and unit tests.
+├── tools - Conveninece scripts to perform common actions (in both bash and ps1).
+├── vendor - When using the igniter, it deploys third party tools in here, such as ffmpeg.
+└── website - Source files for https://openpype.io/ which is Docusaursus (https://docusaurus.io/).
+```
+
+The core functionality of the pipeline can be found in `igniter` and `openpype`, which in turn rely on the `schema` files, whenever you build (or download a pre-built) version of OpenPype, these two are bundled in there, and `Igniter` is the entry point.
+
+
+## Igniter
+
+It's the setup and update tool for OpenPype, unless you want to package `openpype` separately and deal with all the config manually, this will most likely be your entry point.
+
+```
+igniter/
+├── bootstrap_repos.py - Module that will find or install OpenPype versions in the system.
+├── __init__.py - Igniter entry point.
+├── install_dialog.py- Show dialog for choosing central pype repository.
+├── install_thread.py - Threading helpers for the install process.
+├── __main__.py - Like `__init__.py` ?
+├── message_dialog.py - Qt Dialog with a message and "Ok" button.
+├── nice_progress_bar.py - Fancy Qt progress bar.
+├── splash.txt - ASCII art for the terminal installer.
+├── stylesheet.css - Installer Qt styles.
+├── terminal_splash.py - Terminal installer animation, relies in `splash.txt`.
+├── tools.py - Collection of methods that don't fit in other modules.
+├── update_thread.py - Threading helper to update existing OpenPype installs.
+├── update_window.py - Qt UI to update OpenPype installs. 
+├── user_settings.py - Interface for the OpenPype user settings.
+└── version.py - Igniter's version number.
+```
+
+## OpenPype
+
+This is the main package of the OpenPype logic, it could be loosely described as a combination of [Avalon](https://getavalon.github.io), [Pyblish](https://pyblish.com/) and glue around those with custom OpenPype only elements, things are in progress of being moved around to better prepare for V4, which will be released under a new name AYON.
+
+```
+openpype/
+├── client - Interface for the MongoDB.
+├── hooks - Hooks to be executed on certain OpenPype Applications defined in `openpype.lib.applications`.
+├── host - Base class for the different hosts.
+├── hosts - Integration with the different DCCs (hosts) using the `host` base class.
+├── lib - Libraries that stitch together the package, some have been moved into other parts.
+├── modules - OpenPype modules should contain separated logic of specific kind of implementation, such as Ftrack connection and its python API.
+├── pipeline - Core of the OpenPype pipeline, handles creation of data, publishing, etc.
+├── plugins - Global/core plugins for loader and publisher tool.
+├── resources - Icons, fonts, etc.
+├── scripts - Loose scipts that get run by tools/publishers.
+├── settings - OpenPype settings interface.
+├── style - Qt styling.
+├── tests - Unit tests.
+├── tools - Core tools, check out https://openpype.io/docs/artist_tools.
+├── vendor - Vendoring of needed required Python packes.
+├── widgets - Common re-usable Qt Widgets.
+├── action.py - LEGACY: Lives now in `openpype.pipeline.publish.action` Pyblish actions.
+├── cli.py - Command line interface, leverages `click`.
+├── __init__.py - Sets two constants.
+├── __main__.py - Entry point, calls the `cli.py`
+├── plugin.py - Pyblish plugins.
+├── pype_commands.py - Implementation of OpenPype commands.
+└── version.py - Current version number.
+```
+
+
+

From 1e458d6d1d67b2eb88c0d6e649fd80f7192f08ce Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Tue, 14 Mar 2023 14:44:29 +0100
Subject: [PATCH 019/151] global and nuke: farm publishing workflow fixes

---
 openpype/hosts/nuke/plugins/publish/extract_review_data.py | 2 +-
 .../hosts/nuke/plugins/publish/extract_review_data_lut.py  | 7 ++++++-
 .../hosts/nuke/plugins/publish/extract_review_data_mov.py  | 5 +----
 openpype/hosts/nuke/plugins/publish/extract_thumbnail.py   | 2 +-
 .../deadline/plugins/publish/submit_nuke_deadline.py       | 5 +++--
 .../modules/deadline/plugins/publish/submit_publish_job.py | 4 ++++
 .../deadline/plugins/publish/validate_deadline_pools.py    | 4 ++++
 7 files changed, 20 insertions(+), 9 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/publish/extract_review_data.py b/openpype/hosts/nuke/plugins/publish/extract_review_data.py
index dee8248295..c221af40fb 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_review_data.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_review_data.py
@@ -25,7 +25,7 @@ class ExtractReviewData(publish.Extractor):
         # review can be removed since `ProcessSubmittedJobOnFarm` will create
         # reviewable representation if needed
         if (
-            "render.farm" in instance.data["families"]
+            instance.data.get("farm")
             and "review" in instance.data["families"]
         ):
             instance.data["families"].remove("review")
diff --git a/openpype/hosts/nuke/plugins/publish/extract_review_data_lut.py b/openpype/hosts/nuke/plugins/publish/extract_review_data_lut.py
index 67779e9599..e4b7b155cd 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_review_data_lut.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_review_data_lut.py
@@ -49,7 +49,12 @@ class ExtractReviewDataLut(publish.Extractor):
                 exporter.stagingDir, exporter.file).replace("\\", "/")
             instance.data["representations"] += data["representations"]
 
-        if "render.farm" in families:
+        # review can be removed since `ProcessSubmittedJobOnFarm` will create
+        # reviewable representation if needed
+        if (
+            instance.data.get("farm")
+            and "review" in instance.data["families"]
+        ):
             instance.data["families"].remove("review")
 
         self.log.debug(
diff --git a/openpype/hosts/nuke/plugins/publish/extract_review_data_mov.py b/openpype/hosts/nuke/plugins/publish/extract_review_data_mov.py
index 3fcfc2a4b5..956d1a54a3 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_review_data_mov.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_review_data_mov.py
@@ -105,10 +105,7 @@ class ExtractReviewDataMov(publish.Extractor):
                     self, instance, o_name, o_data["extension"],
                     multiple_presets)
 
-                if (
-                    "render.farm" in families or
-                    "prerender.farm" in families
-                ):
+                if instance.data.get("farm"):
                     if "review" in instance.data["families"]:
                         instance.data["families"].remove("review")
 
diff --git a/openpype/hosts/nuke/plugins/publish/extract_thumbnail.py b/openpype/hosts/nuke/plugins/publish/extract_thumbnail.py
index a1a0e241c0..f391ca1e7c 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_thumbnail.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_thumbnail.py
@@ -31,7 +31,7 @@ class ExtractThumbnail(publish.Extractor):
 
 
     def process(self, instance):
-        if "render.farm" in instance.data["families"]:
+        if instance.data.get("farm"):
             return
 
         with napi.maintained_selection():
diff --git a/openpype/modules/deadline/plugins/publish/submit_nuke_deadline.py b/openpype/modules/deadline/plugins/publish/submit_nuke_deadline.py
index 9abe8dec8b..cc069cf51a 100644
--- a/openpype/modules/deadline/plugins/publish/submit_nuke_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_nuke_deadline.py
@@ -81,6 +81,7 @@ class NukeSubmitDeadline(pyblish.api.InstancePlugin,
 
     def process(self, instance):
         if not instance.data.get("farm"):
+            self.log.info("Skipping local instance.")
             return
 
         instance.data["attributeValues"] = self.get_attr_values_from_data(
@@ -171,10 +172,10 @@ class NukeSubmitDeadline(pyblish.api.InstancePlugin,
                     resp.json()["_id"])
 
         # redefinition of families
-        if "render" in family:
+        if "render" in instance.data["family"]:
             instance.data['family'] = 'write'
             families.insert(0, "render2d")
-        elif "prerender" in family:
+        elif "prerender" in instance.data["family"]:
             instance.data['family'] = 'write'
             families.insert(0, "prerender")
         instance.data["families"] = families
diff --git a/openpype/modules/deadline/plugins/publish/submit_publish_job.py b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
index 53c09ad22f..0d0698c21f 100644
--- a/openpype/modules/deadline/plugins/publish/submit_publish_job.py
+++ b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
@@ -756,6 +756,10 @@ class ProcessSubmittedJobOnFarm(pyblish.api.InstancePlugin):
             instance (pyblish.api.Instance): Instance data.
 
         """
+        if not instance.data.get("farm"):
+            self.log.info("Skipping local instance.")
+            return
+
         data = instance.data.copy()
         context = instance.context
         self.context = context
diff --git a/openpype/modules/deadline/plugins/publish/validate_deadline_pools.py b/openpype/modules/deadline/plugins/publish/validate_deadline_pools.py
index 78eed17c98..05afa5080d 100644
--- a/openpype/modules/deadline/plugins/publish/validate_deadline_pools.py
+++ b/openpype/modules/deadline/plugins/publish/validate_deadline_pools.py
@@ -21,6 +21,10 @@ class ValidateDeadlinePools(OptionalPyblishPluginMixin,
     optional = True
 
     def process(self, instance):
+        if not instance.data.get("farm"):
+            self.log.info("Skipping local instance.")
+            return
+
         # get default deadline webservice url from deadline module
         deadline_url = instance.context.data["defaultDeadline"]
         self.log.info("deadline_url::{}".format(deadline_url))

From 10ff798ed59e72f006f4aac8df09a8bb119c647b Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Tue, 14 Mar 2023 17:18:56 +0100
Subject: [PATCH 020/151] Fixed "Select invalid"

---
 .../validate_local_frames_existence.py        | 26 +++++++++----------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/openpype/hosts/fusion/plugins/publish/validate_local_frames_existence.py b/openpype/hosts/fusion/plugins/publish/validate_local_frames_existence.py
index d80e11e078..c1cba795e1 100644
--- a/openpype/hosts/fusion/plugins/publish/validate_local_frames_existence.py
+++ b/openpype/hosts/fusion/plugins/publish/validate_local_frames_existence.py
@@ -8,7 +8,9 @@ from openpype.hosts.fusion.api.action import SelectInvalidAction
 
 
 class ValidateLocalFramesExistence(pyblish.api.InstancePlugin):
-    """Checks if files for savers that's set to publish existing frames exists"""
+    """Checks if files for savers that's set
+    to publish existing frames exists
+    """
 
     order = pyblish.api.ValidatorOrder
     label = "Validate Existing Frames Exists"
@@ -17,7 +19,7 @@ class ValidateLocalFramesExistence(pyblish.api.InstancePlugin):
     actions = [RepairAction, SelectInvalidAction]
 
     @classmethod
-    def get_invalid(cls, instance):
+    def get_invalid(cls, instance, non_existing_frames=[]):
         active = instance.data.get("active", instance.data.get("publish"))
         if not active:
             return []
@@ -37,29 +39,27 @@ class ValidateLocalFramesExistence(pyblish.api.InstancePlugin):
                 for frame in range(frame_start, frame_end + 1)
             ]
 
-            non_existing_frames = []
-
             for file in files:
-                cls.log.error(file)
                 if not os.path.exists(os.path.join(output_dir, file)):
+                    cls.log.error(
+                        f"Missing file: {os.path.join(output_dir, file)}"
+                    )
                     non_existing_frames.append(file)
 
             if len(non_existing_frames) > 0:
-                cls.log.error(
-                    "Some of {}'s files does not exist".format(tool.Name)
-                )
-                return [tool, output_dir, non_existing_frames]
+                cls.log.error(f"Some of {tool.Name}'s files does not exist")
+                return [tool]
 
     def process(self, instance):
-        invalid = self.get_invalid(instance)
+        non_existing_frames = []
+        invalid = self.get_invalid(instance, non_existing_frames)
         if invalid:
             raise PublishValidationError(
                 "{} is set to publish existing frames but "
-                "some frames are missing in the folder:\n\n{}"
+                "some frames are missing. "
                 "The missing file(s) are:\n\n{}".format(
                     invalid[0].Name,
-                    invalid[1],
-                    "\n\n".join(invalid[2]),
+                    "\n\n".join(non_existing_frames),
                 ),
                 title=self.label,
             )

From 9741d47fbc7c03d20cbc775f61ae19e321bb631c Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Tue, 14 Mar 2023 17:19:19 +0100
Subject: [PATCH 021/151] Added crude repair functionality

---
 .../publish/validate_local_frames_existence.py      | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/fusion/plugins/publish/validate_local_frames_existence.py b/openpype/hosts/fusion/plugins/publish/validate_local_frames_existence.py
index c1cba795e1..4b50e0b837 100644
--- a/openpype/hosts/fusion/plugins/publish/validate_local_frames_existence.py
+++ b/openpype/hosts/fusion/plugins/publish/validate_local_frames_existence.py
@@ -67,5 +67,14 @@ class ValidateLocalFramesExistence(pyblish.api.InstancePlugin):
     @classmethod
     def repair(cls, instance):
         invalid = cls.get_invalid(instance)
-        for tool in invalid:
-            tool.SetInput("CreateDir", 1.0)
+        if invalid:
+            data = invalid[0].GetData("openpype")
+
+            # Change render target to local to render locally
+            data["creator_attributes"]["render_target"] = "local"
+
+            invalid[0].SetData("openpype", data)
+            cls.log.error(
+                f"Reload the publisher and {invalid[0].Name} "
+                "will be set to render locally"
+            )

From 1e9670f54dd9121527438c25649c53016fd4ea92 Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Tue, 14 Mar 2023 17:19:43 +0100
Subject: [PATCH 022/151] Fixed docstring and removed unused variables

---
 .../fusion/plugins/publish/collect_renders.py  | 18 +++---------------
 1 file changed, 3 insertions(+), 15 deletions(-)

diff --git a/openpype/hosts/fusion/plugins/publish/collect_renders.py b/openpype/hosts/fusion/plugins/publish/collect_renders.py
index cdd37b3b65..be405d2495 100644
--- a/openpype/hosts/fusion/plugins/publish/collect_renders.py
+++ b/openpype/hosts/fusion/plugins/publish/collect_renders.py
@@ -3,21 +3,11 @@ from pprint import pformat
 
 
 class CollectFusionRenders(pyblish.api.InstancePlugin):
-    """Collect current comp's render Mode
+    """Collect current saver node's render Mode
 
     Options:
-        local
-        farm
-
-    Note that this value is set for each comp separately. When you save the
-    comp this information will be stored in that file. If for some reason the
-    available tool does not visualize which render mode is set for the
-    current comp, please run the following line in the console (Py2)
-
-    comp.GetData("openpype.rendermode")
-
-    This will return the name of the current render mode as seen above under
-    Options.
+        local (Render locally)
+        frames (Use existing frames)
 
     """
 
@@ -29,10 +19,8 @@ class CollectFusionRenders(pyblish.api.InstancePlugin):
     def process(self, instance):
         self.log.debug(pformat(instance.data))
 
-        saver_node = instance.data["transientData"]["tool"]
         render_target = instance.data["render_target"]
         family = instance.data["family"]
-        families = instance.data["families"]
 
         # add targeted family to families
         instance.data["families"].append(

From 191882424047cb517f0fc97171819dcca6d84093 Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Tue, 14 Mar 2023 17:56:11 +0100
Subject: [PATCH 023/151] Moved the review representation back to
 render_local.py

---
 .../plugins/publish/extract_render_local.py   | 35 +++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/openpype/hosts/fusion/plugins/publish/extract_render_local.py b/openpype/hosts/fusion/plugins/publish/extract_render_local.py
index 62625c899a..ea801107c1 100644
--- a/openpype/hosts/fusion/plugins/publish/extract_render_local.py
+++ b/openpype/hosts/fusion/plugins/publish/extract_render_local.py
@@ -29,6 +29,41 @@ class FusionRenderLocal(
             )
         )
 
+        # Generate the frame list
+        frame_start = context.data["frameStartHandle"]
+        frame_end = context.data["frameEndHandle"]
+        path = instance.data["path"]
+        output_dir = instance.data["outputDir"]
+
+        basename = os.path.basename(path)
+        head, ext = os.path.splitext(basename)
+        files = [
+            f"{head}{str(frame).zfill(4)}{ext}"
+            for frame in range(frame_start, frame_end + 1)
+        ]
+        repre = {
+            "name": ext[1:],
+            "ext": ext[1:],
+            "frameStart": f"%0{len(str(frame_end))}d" % frame_start,
+            "files": files,
+            "stagingDir": output_dir,
+        }
+
+        # Get the colorspace represenation
+        self.set_representation_colorspace(
+            representation=repre,
+            context=context,
+        )
+
+        # review representation
+        if instance.data.get("review", False):
+            repre["tags"] = ["review"]
+
+        # add the repre to the instance
+        if "representations" not in instance.data:
+            instance.data["representations"] = []
+        instance.data["representations"].append(repre)
+
     def render_once(self, context):
         """Render context comp only once, even with more render instances"""
 

From c7ae8b53201b5a0f223aec38cc2244b305581607 Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Tue, 14 Mar 2023 17:57:45 +0100
Subject: [PATCH 024/151] Collect all frames for "using existing frames" savers

---
 ...iew_data.py => collect_existing_frames.py} | 20 ++++++-------------
 ... => validate_existing_frames_existence.py} |  0
 2 files changed, 6 insertions(+), 14 deletions(-)
 rename openpype/hosts/fusion/plugins/publish/{extract_review_data.py => collect_existing_frames.py} (74%)
 rename openpype/hosts/fusion/plugins/publish/{validate_local_frames_existence.py => validate_existing_frames_existence.py} (100%)

diff --git a/openpype/hosts/fusion/plugins/publish/extract_review_data.py b/openpype/hosts/fusion/plugins/publish/collect_existing_frames.py
similarity index 74%
rename from openpype/hosts/fusion/plugins/publish/extract_review_data.py
rename to openpype/hosts/fusion/plugins/publish/collect_existing_frames.py
index d9416771f6..7c5f7cd55d 100644
--- a/openpype/hosts/fusion/plugins/publish/extract_review_data.py
+++ b/openpype/hosts/fusion/plugins/publish/collect_existing_frames.py
@@ -1,22 +1,14 @@
-import os
 import pyblish.api
-from openpype.pipeline.publish import (
-    ColormanagedPyblishPluginMixin,
-)
+import os
 
 
-class FusionExtractReviewData(
-    pyblish.api.InstancePlugin, ColormanagedPyblishPluginMixin
-):
-    """
-    Extract the result of savers by starting a comp render
-    This will run the local render of Fusion.
-    """
+class CollectFusionRenders(pyblish.api.InstancePlugin):
+    """Collect all frames needed to publish existing frames"""
 
-    order = pyblish.api.ExtractorOrder - 0.1
-    label = "Extract Review Data"
+    order = pyblish.api.CollectorOrder + 0.5
+    label = "Collect Existing Frames"
     hosts = ["fusion"]
-    families = ["review"]
+    families = ["render.frames"]
 
     def process(self, instance):
         context = instance.context
diff --git a/openpype/hosts/fusion/plugins/publish/validate_local_frames_existence.py b/openpype/hosts/fusion/plugins/publish/validate_existing_frames_existence.py
similarity index 100%
rename from openpype/hosts/fusion/plugins/publish/validate_local_frames_existence.py
rename to openpype/hosts/fusion/plugins/publish/validate_existing_frames_existence.py

From 1754ef32672256b1661669d510c1c83e6fa5f403 Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Tue, 14 Mar 2023 18:06:37 +0100
Subject: [PATCH 025/151] Fixed mutable data structure problem

---
 .../plugins/publish/validate_existing_frames_existence.py    | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/fusion/plugins/publish/validate_existing_frames_existence.py b/openpype/hosts/fusion/plugins/publish/validate_existing_frames_existence.py
index 4b50e0b837..a43d2c691a 100644
--- a/openpype/hosts/fusion/plugins/publish/validate_existing_frames_existence.py
+++ b/openpype/hosts/fusion/plugins/publish/validate_existing_frames_existence.py
@@ -19,7 +19,10 @@ class ValidateLocalFramesExistence(pyblish.api.InstancePlugin):
     actions = [RepairAction, SelectInvalidAction]
 
     @classmethod
-    def get_invalid(cls, instance, non_existing_frames=[]):
+    def get_invalid(cls, instance, non_existing_frames=None):
+        if non_existing_frames is None:
+            non_existing_frames = []
+
         active = instance.data.get("active", instance.data.get("publish"))
         if not active:
             return []

From 78ce629ba63ee31f104255d628dbb6067578bea9 Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Tue, 14 Mar 2023 18:14:19 +0100
Subject: [PATCH 026/151] Removed double casting

---
 openpype/modules/kitsu/utils/update_op_with_zou.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/modules/kitsu/utils/update_op_with_zou.py b/openpype/modules/kitsu/utils/update_op_with_zou.py
index a2b560b75b..1f38648dfa 100644
--- a/openpype/modules/kitsu/utils/update_op_with_zou.py
+++ b/openpype/modules/kitsu/utils/update_op_with_zou.py
@@ -128,7 +128,7 @@ def update_op_assets(
             if frames_duration:
                 frame_out = frame_in + frames_duration - 1
             else:
-                frame_out = int(project_doc["data"].get("frameEnd", frame_in))
+                frame_out = project_doc["data"].get("frameEnd", frame_in)
         item_data["frameEnd"] = int(frame_out)
         # Fps, fallback to project's value or default value (25.0)
         try:

From 383ce7ccb6f20453ef2aa40d81b2af4ae5856eba Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Tue, 14 Mar 2023 18:32:18 +0100
Subject: [PATCH 027/151] Change variable name to snake_case

---
 .../kitsu/plugins/publish/integrate_kitsu_note.py    | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index 44134dec6d..debbfdf98e 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -16,9 +16,11 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
     note_status_shortname = "wfa"
 
     # comment settings
-    CustomCommentTemplate = {}
-    CustomCommentTemplate["enabled"] = False
-    CustomCommentTemplate["comment_template"] = "{comment}"
+    custom_comment_template = {}
+    custom_comment_template = {
+        "enabled": False,
+        "comment_template": "{comment}",
+    }
 
     def safe_format(self, msg, **kwargs):
         def replace_missing(match):
@@ -70,9 +72,9 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
                     )
 
             # If custom comment, create it
-            if self.CustomCommentTemplate["enabled"]:
+            if self.custom_comment_template["enabled"]:
                 publish_comment = self.safe_format(
-                    self.CustomCommentTemplate["comment_template"],
+                    self.custom_comment_template["comment_template"],
                     **instance.data,
                 )
 

From c53e5b2302b9916360bf3e3a2f38e550596f64d8 Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Tue, 14 Mar 2023 18:32:41 +0100
Subject: [PATCH 028/151] Added docstring

---
 openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index debbfdf98e..a4b229d236 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -23,6 +23,8 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
     }
 
     def safe_format(self, msg, **kwargs):
+        """If key is not found in kwargs, set None instead"""
+
         def replace_missing(match):
             value = kwargs.get(match.group(1), None)
             if value is None:

From a789b135aed5d1dabdbee3b3ae14904a95b34428 Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Tue, 14 Mar 2023 18:33:00 +0100
Subject: [PATCH 029/151] Changed the instance check from render to review

---
 .../modules/kitsu/plugins/publish/integrate_kitsu_note.py     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index a4b229d236..2e1e656cee 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -48,8 +48,8 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
             self.log.info("Comment is not set.")
 
         for instance in context:
-            # Check if instance is a render by checking its family
-            if "render" not in instance.data["family"]:
+            # Check if instance is a review by checking its family
+            if "review" not in instance.data["family"]:
                 continue
 
             kitsu_task = instance.data.get("kitsu_task")

From b3816ae876ff35d6187e43357d2580e46bafe2ae Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Wed, 15 Mar 2023 17:05:00 +0100
Subject: [PATCH 030/151] Fixed key check towards kwargs

---
 .../kitsu/plugins/publish/integrate_kitsu_note.py     | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index 2e1e656cee..d4282ab048 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -16,7 +16,6 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
     note_status_shortname = "wfa"
 
     # comment settings
-    custom_comment_template = {}
     custom_comment_template = {
         "enabled": False,
         "comment_template": "{comment}",
@@ -26,17 +25,15 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
         """If key is not found in kwargs, set None instead"""
 
         def replace_missing(match):
-            value = kwargs.get(match.group(1), None)
-            if value is None:
+            key = match.group(1)
+            if key not in kwargs:
                 self.log.warning(
                     "Key `{}` was not found in instance.data "
-                    "and will be rendered as `` in the comment".format(
-                        match.group(1)
-                    )
+                    "and will be rendered as `` in the comment".format(key)
                 )
                 return ""
             else:
-                return str(value)
+                return str(kwargs[key])
 
         pattern = r"\{([^}]*)\}"
         return re.sub(pattern, replace_missing, msg)

From a30887bb746ebba4756329cefb36eb4fa77d0db7 Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Wed, 15 Mar 2023 17:05:34 +0100
Subject: [PATCH 031/151] Change name from CamelCase to snake_case

---
 openpype/settings/defaults/project_settings/kitsu.json        | 2 +-
 .../schemas/projects_schema/schema_project_kitsu.json         | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/kitsu.json b/openpype/settings/defaults/project_settings/kitsu.json
index f8a98d1a0b..738bd95e38 100644
--- a/openpype/settings/defaults/project_settings/kitsu.json
+++ b/openpype/settings/defaults/project_settings/kitsu.json
@@ -8,7 +8,7 @@
         "IntegrateKitsuNote": {
             "set_status_note": false,
             "note_status_shortname": "wfa",
-            "CustomCommentTemplate": {
+            "custom_comment_template": {
                 "enabled": false,
                 "comment_template": "{comment}\n\n|  |  |\n|--|--|\n| version| `{version}` |\n| family | `{family}` |\n| name | `{name}` |"
             }
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
index 1a7747b3dc..fc421c20f5 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
@@ -57,7 +57,7 @@
                             "type": "dict",
                             "collapsible": true,
                             "checkbox_key": "enabled",
-                            "key": "CustomCommentTemplate",
+                            "key": "custom_comment_template",
                             "label": "Custom Comment Template",
                             "children": [
                                 {
@@ -67,7 +67,7 @@
                                 },
                                 {
                                     "type": "label",
-                                    "label": "Kitsu supports markdown and here you can create a custom comment template.<br/>You can use data from your instance's anatomy."
+                                    "label": "Kitsu supports markdown and here you can create a custom comment template.<br/>You can use data from your publishing instance's data."
                                 },
                                 {
                                     "key": "comment_template",

From 8449c2131d49354b581e8db495b1b36b64f1a89f Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Wed, 15 Mar 2023 18:28:55 +0100
Subject: [PATCH 032/151] Extended Nuke testing classes with representation
 details

---
 .../nuke/test_deadline_publish_in_nuke.py     | 18 +++++++++++
 .../hosts/nuke/test_publish_in_nuke.py        | 31 +++++++++++++++----
 2 files changed, 43 insertions(+), 6 deletions(-)

diff --git a/tests/integration/hosts/nuke/test_deadline_publish_in_nuke.py b/tests/integration/hosts/nuke/test_deadline_publish_in_nuke.py
index cd9cbb94f8..a4026f195b 100644
--- a/tests/integration/hosts/nuke/test_deadline_publish_in_nuke.py
+++ b/tests/integration/hosts/nuke/test_deadline_publish_in_nuke.py
@@ -71,12 +71,30 @@ class TestDeadlinePublishInNuke(NukeDeadlinePublishTestClass):
         failures.append(
             DBAssert.count_of_types(dbcon, "representation", 4))
 
+        additional_args = {"context.subset": "workfileTest_task",
+                           "context.ext": "nk"}
+        failures.append(
+            DBAssert.count_of_types(dbcon, "representation", 1,
+                                    additional_args=additional_args))
+
         additional_args = {"context.subset": "renderTest_taskMain",
                            "context.ext": "exr"}
         failures.append(
             DBAssert.count_of_types(dbcon, "representation", 1,
                                     additional_args=additional_args))
 
+        additional_args = {"context.subset": "renderTest_taskMain",
+                           "name": "thumbnail"}
+        failures.append(
+            DBAssert.count_of_types(dbcon, "representation", 1,
+                                    additional_args=additional_args))
+
+        additional_args = {"context.subset": "renderTest_taskMain",
+                           "name": "h264_mov"}
+        failures.append(
+            DBAssert.count_of_types(dbcon, "representation", 1,
+                                    additional_args=additional_args))
+
         assert not any(failures)
 
 
diff --git a/tests/integration/hosts/nuke/test_publish_in_nuke.py b/tests/integration/hosts/nuke/test_publish_in_nuke.py
index f84f13fa20..a4026f195b 100644
--- a/tests/integration/hosts/nuke/test_publish_in_nuke.py
+++ b/tests/integration/hosts/nuke/test_publish_in_nuke.py
@@ -1,12 +1,12 @@
 import logging
 
 from tests.lib.assert_classes import DBAssert
-from tests.integration.hosts.nuke.lib import NukeLocalPublishTestClass
+from tests.integration.hosts.nuke.lib import NukeDeadlinePublishTestClass
 
 log = logging.getLogger("test_publish_in_nuke")
 
 
-class TestPublishInNuke(NukeLocalPublishTestClass):
+class TestDeadlinePublishInNuke(NukeDeadlinePublishTestClass):
     """Basic test case for publishing in Nuke
 
         Uses generic TestCase to prepare fixtures for test data, testing DBs,
@@ -15,7 +15,7 @@ class TestPublishInNuke(NukeLocalPublishTestClass):
         !!!
         It expects modified path in WriteNode,
         use '[python {nuke.script_directory()}]' instead of regular root
-        dir (eg. instead of `c:/projects/test_project/test_asset/test_task`).
+        dir (eg. instead of `c:/projects`).
         Access file path by selecting WriteNode group, CTRL+Enter, update file
         input
         !!!
@@ -36,12 +36,13 @@ class TestPublishInNuke(NukeLocalPublishTestClass):
     """
     # https://drive.google.com/file/d/1SUurHj2aiQ21ZIMJfGVBI2KjR8kIjBGI/view?usp=sharing  # noqa: E501
     TEST_FILES = [
-        ("1SUurHj2aiQ21ZIMJfGVBI2KjR8kIjBGI", "test_Nuke_publish.zip", "")
+        ("1SeWprClKhWMv2xVC9AcnekIJFExxnp_b",
+         "test_nuke_deadline_publish.zip", "")
     ]
 
     APP_GROUP = "nuke"
 
-    TIMEOUT = 50  # publish timeout
+    TIMEOUT = 180  # publish timeout
 
     # could be overwritten by command line arguments
     # keep empty to locate latest installed variant or explicit
@@ -70,14 +71,32 @@ class TestPublishInNuke(NukeLocalPublishTestClass):
         failures.append(
             DBAssert.count_of_types(dbcon, "representation", 4))
 
+        additional_args = {"context.subset": "workfileTest_task",
+                           "context.ext": "nk"}
+        failures.append(
+            DBAssert.count_of_types(dbcon, "representation", 1,
+                                    additional_args=additional_args))
+
         additional_args = {"context.subset": "renderTest_taskMain",
                            "context.ext": "exr"}
         failures.append(
             DBAssert.count_of_types(dbcon, "representation", 1,
                                     additional_args=additional_args))
 
+        additional_args = {"context.subset": "renderTest_taskMain",
+                           "name": "thumbnail"}
+        failures.append(
+            DBAssert.count_of_types(dbcon, "representation", 1,
+                                    additional_args=additional_args))
+
+        additional_args = {"context.subset": "renderTest_taskMain",
+                           "name": "h264_mov"}
+        failures.append(
+            DBAssert.count_of_types(dbcon, "representation", 1,
+                                    additional_args=additional_args))
+
         assert not any(failures)
 
 
 if __name__ == "__main__":
-    test_case = TestPublishInNuke()
+    test_case = TestDeadlinePublishInNuke()

From ce22b665b4b1ce1216f84156c09074cb6436545a Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Thu, 16 Mar 2023 10:39:47 +0100
Subject: [PATCH 033/151] Fixed comments in code

---
 .../kitsu/plugins/publish/integrate_kitsu_note.py   | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index d4282ab048..69b456426f 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -22,21 +22,24 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
     }
 
     def safe_format(self, msg, **kwargs):
-        """If key is not found in kwargs, set None instead"""
+        """Pars the msg thourgh a custom format code.
+        It makes sure non existing keys gets None returned instead of error
+        """
 
-        def replace_missing(match):
+        def replace_missing_key(match):
+            """If key is not found in kwargs, set None instead"""
             key = match.group(1)
             if key not in kwargs:
                 self.log.warning(
-                    "Key `{}` was not found in instance.data "
-                    "and will be rendered as `` in the comment".format(key)
+                    "Key '{}' was not found in instance.data "
+                    "and will be rendered as '' in the comment".format(key)
                 )
                 return ""
             else:
                 return str(kwargs[key])
 
         pattern = r"\{([^}]*)\}"
-        return re.sub(pattern, replace_missing, msg)
+        return re.sub(pattern, replace_missing_key, msg)
 
     def process(self, context):
         # Get comment text body

From adc648616f2eebe7780a81de5882bf95e805ddf9 Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Thu, 16 Mar 2023 10:40:03 +0100
Subject: [PATCH 034/151] Look for review in families instead of family

---
 openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index 69b456426f..3ad53a1f12 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -49,7 +49,7 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
 
         for instance in context:
             # Check if instance is a review by checking its family
-            if "review" not in instance.data["family"]:
+            if "review" not in instance.data["families"]:
                 continue
 
             kitsu_task = instance.data.get("kitsu_task")

From f70eac116d1978a337c8adc912413ab5a12bd842 Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Thu, 16 Mar 2023 17:11:16 +0100
Subject: [PATCH 035/151] Made the format function more logical

---
 .../plugins/publish/integrate_kitsu_note.py   | 25 +++++++++----------
 1 file changed, 12 insertions(+), 13 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index 3ad53a1f12..b0063282d0 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -21,25 +21,27 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
         "comment_template": "{comment}",
     }
 
-    def safe_format(self, msg, **kwargs):
-        """Pars the msg thourgh a custom format code.
-        It makes sure non existing keys gets None returned instead of error
-        """
+    def format_publish_comment(self, instance):
+        """Format the instance's publish comment
 
+        Formats `instance.data` against the custom template.
+        """
+        
         def replace_missing_key(match):
             """If key is not found in kwargs, set None instead"""
             key = match.group(1)
-            if key not in kwargs:
+            if key not in instance.data:
                 self.log.warning(
-                    "Key '{}' was not found in instance.data "
-                    "and will be rendered as '' in the comment".format(key)
+                    "Key "{}" was not found in instance.data "
+                    "and will be rendered as "" in the comment".format(key)
                 )
                 return ""
             else:
-                return str(kwargs[key])
+                return str(instance.data[key])
 
+        template = self.custom_comment_template["comment_template"]
         pattern = r"\{([^}]*)\}"
-        return re.sub(pattern, replace_missing_key, msg)
+        return re.sub(pattern, replace_missing_key, template)
 
     def process(self, context):
         # Get comment text body
@@ -75,10 +77,7 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
 
             # If custom comment, create it
             if self.custom_comment_template["enabled"]:
-                publish_comment = self.safe_format(
-                    self.custom_comment_template["comment_template"],
-                    **instance.data,
-                )
+                publish_comment = self.format_publish_comment(instance)
 
             self.log.debug("Comment is `{}`".format(publish_comment))
 

From 5a7bf785f72d4dacbf9283ee362f447991db2de8 Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Thu, 16 Mar 2023 17:13:17 +0100
Subject: [PATCH 036/151] Fixed hound comments

---
 .../modules/kitsu/plugins/publish/integrate_kitsu_note.py  | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index b0063282d0..a5a58c8462 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -26,14 +26,15 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
 
         Formats `instance.data` against the custom template.
         """
-        
+
         def replace_missing_key(match):
             """If key is not found in kwargs, set None instead"""
             key = match.group(1)
             if key not in instance.data:
                 self.log.warning(
-                    "Key "{}" was not found in instance.data "
-                    "and will be rendered as "" in the comment".format(key)
+                    "Key '{}' was not found in instance.data "
+                    "and will be rendered as "
+                    " in the comment".format(key)
                 )
                 return ""
             else:

From 316c3577c6143aab061677fbf643340ed2d6c1e6 Mon Sep 17 00:00:00 2001
From: Joseff <vzotov42@gmail.com>
Date: Thu, 16 Mar 2023 20:35:21 +0100
Subject: [PATCH 037/151] Fixed a bug where the QThread in the splash screen
 could be destroyed before finishing execution

---
 openpype/hosts/unreal/ue_workers.py | 42 ++++++++++++++++++++++++++---
 openpype/widgets/splash_screen.py   |  7 +++++
 2 files changed, 45 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/unreal/ue_workers.py b/openpype/hosts/unreal/ue_workers.py
index 00f83a7d7a..f7bc0e90dc 100644
--- a/openpype/hosts/unreal/ue_workers.py
+++ b/openpype/hosts/unreal/ue_workers.py
@@ -28,6 +28,15 @@ def parse_prj_progress(line: str, progress_signal: QtCore.Signal(int)) -> int:
         progress_signal.emit(int(percent_match.group()))
 
 
+def retrieve_exit_code(line: str):
+    match = re.search('ExitCode=\d+', line)
+    if match is not None:
+        split: list[str] = match.group().split('=')
+        return int(split[1])
+
+    return None
+
+
 class UEProjectGenerationWorker(QtCore.QObject):
     finished = QtCore.Signal(str)
     failed = QtCore.Signal(str)
@@ -225,9 +234,30 @@ class UEProjectGenerationWorker(QtCore.QObject):
             msg = f"Unreal Python not found at {python_path}"
             self.failed.emit(msg, 1)
             raise RuntimeError(msg)
-        subprocess.check_call(
-            [python_path.as_posix(), "-m", "pip", "install", "pyside2"]
-        )
+        pyside_cmd = [python_path.as_posix(),
+                      "-m",
+                      "pip",
+                      "install",
+                      "pyside2"]
+
+        pyside_install = subprocess.Popen(pyside_cmd,
+                                          stdout=subprocess.PIPE,
+                                          stderr=subprocess.PIPE)
+
+        for line in pyside_install.stdout:
+            decoded_line: str = line.decode(errors='replace')
+            print(decoded_line, end='')
+            self.log.emit(decoded_line)
+
+        pyside_install.stdout.close()
+        return_code = pyside_install.wait()
+
+        if return_code and return_code != 0:
+            msg = 'Failed to create the project! ' \
+                  f'The installation of PySide2 has failed!'
+            self.failed.emit(msg, return_code)
+            raise RuntimeError(msg)
+
         self.progress.emit(100)
         self.finished.emit("Project successfully built!")
 
@@ -274,18 +304,22 @@ class UEPluginInstallWorker(QtCore.QObject):
         build_proc = subprocess.Popen(build_plugin_cmd,
                                       stdout=subprocess.PIPE,
                                       stderr=subprocess.PIPE)
+        return_code: int = None
         for line in build_proc.stdout:
             decoded_line: str = line.decode(errors='replace')
             print(decoded_line, end='')
             self.log.emit(decoded_line)
+            if return_code is None:
+                return_code = retrieve_exit_code(decoded_line)
             parse_comp_progress(decoded_line, self.progress)
 
         build_proc.stdout.close()
-        return_code = build_proc.wait()
+        build_proc.wait()
 
         if return_code and return_code != 0:
             msg = 'Failed to build plugin' \
                   f' project! Exited with return code {return_code}'
+            dir_util.remove_tree(temp_dir.as_posix())
             self.failed.emit(msg, return_code)
             raise RuntimeError(msg)
 
diff --git a/openpype/widgets/splash_screen.py b/openpype/widgets/splash_screen.py
index fffe143ea5..6bb0944c46 100644
--- a/openpype/widgets/splash_screen.py
+++ b/openpype/widgets/splash_screen.py
@@ -80,8 +80,14 @@ class SplashScreen(QtWidgets.QDialog):
         """
         self.thread_return_code = 0
         self.q_thread.quit()
+
+        if not self.q_thread.wait(5000):
+            raise RuntimeError("Failed to quit the QThread! "
+                               "The deadline has been reached! The thread "
+                               "has not finished it's execution!.")
         self.close()
 
+
     @QtCore.Slot()
     def toggle_log(self):
         if self.is_log_visible:
@@ -256,3 +262,4 @@ class SplashScreen(QtWidgets.QDialog):
         self.close_btn.show()
         self.thread_return_code = return_code
         self.q_thread.exit(return_code)
+        self.q_thread.wait()

From 72a0c017608d7947b1c4ac8ba08fc4b66b3bd2eb Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Fri, 17 Mar 2023 22:26:36 +0800
Subject: [PATCH 038/151] add callback for setting resolution referenced from
 DB record for Max

---
 openpype/hosts/max/api/lib.py      | 64 ++++++++++++++++++++++++++++++
 openpype/hosts/max/api/menu.py     | 13 +++++-
 openpype/hosts/max/api/pipeline.py |  4 ++
 3 files changed, 80 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/max/api/lib.py b/openpype/hosts/max/api/lib.py
index 4fb750d91b..6a7f63ca75 100644
--- a/openpype/hosts/max/api/lib.py
+++ b/openpype/hosts/max/api/lib.py
@@ -6,6 +6,13 @@ from pymxs import runtime as rt
 from typing import Union
 import contextlib
 
+from openpype.client import (
+    get_project
+)
+from openpype.pipeline import legacy_io
+
+from openpype.pipeline.context_tools import get_current_project_asset
+
 
 JSON_PREFIX = "JSON::"
 
@@ -157,6 +164,63 @@ def get_multipass_setting(project_setting=None):
                            ["multipass"])
 
 
+def set_scene_resolution(width, height):
+    """Set the render resolution
+
+    Args:
+        width(int): value of the width
+        height(int): value of the height
+
+    Returns:
+        None
+
+    """
+    rt.renderWidth = width
+    rt.renderHeight = height
+
+
+def reset_scene_resolution():
+    """Apply the scene resolution from the project definition
+
+    scene resolution can be overwritten by an asset if the asset.data contains
+    any information regarding scene resolution .
+
+    Returns:
+        None
+    """
+    project_name = legacy_io.active_project()
+    project_doc = get_project(project_name)
+    project_data = project_doc["data"]
+    asset_data = get_current_project_asset()["data"]
+
+    # Set project resolution
+    width_key = "resolutionWidth"
+    height_key = "resolutionHeight"
+    proj_width_key = project_data.get(width_key, 1920)
+    proj_height_key = project_data.get(height_key, 1080)
+
+    width = asset_data.get(width_key, proj_width_key)
+    height = asset_data.get(height_key, proj_height_key)
+
+    set_scene_resolution(width, height)
+
+
+def set_context_setting():
+    """Apply the project settings from the project definition
+
+    Settings can be overwritten by an asset if the asset.data contains
+    any information regarding those settings.
+
+    Examples of settings:
+        frame range
+        resolution
+
+    Returns:
+        None
+    """
+    reset_scene_resolution()
+
+
 def get_max_version():
     """
     Args:
diff --git a/openpype/hosts/max/api/menu.py b/openpype/hosts/max/api/menu.py
index 5c273b49b4..1f18972394 100644
--- a/openpype/hosts/max/api/menu.py
+++ b/openpype/hosts/max/api/menu.py
@@ -4,7 +4,7 @@ from qtpy import QtWidgets, QtCore
 from pymxs import runtime as rt
 
 from openpype.tools.utils import host_tools
-
+from openpype.hosts.max.api import lib
 
 class OpenPypeMenu(object):
     """Object representing OpenPype menu.
@@ -107,6 +107,13 @@ class OpenPypeMenu(object):
         workfiles_action = QtWidgets.QAction("Work Files...", openpype_menu)
         workfiles_action.triggered.connect(self.workfiles_callback)
         openpype_menu.addAction(workfiles_action)
+
+        openpype_menu.addSeparator()
+
+        res_action = QtWidgets.QAction("Set Resolution", openpype_menu)
+        res_action.triggered.connect(self.resolution_callback)
+        openpype_menu.addAction(res_action)
+
         return openpype_menu
 
     def load_callback(self):
@@ -128,3 +135,7 @@ class OpenPypeMenu(object):
     def workfiles_callback(self):
         """Callback to show Workfiles tool."""
         host_tools.show_workfiles(parent=self.main_widget)
+
+    def resolution_callback(self):
+        """Callback to reset scene resolution"""
+        return lib.reset_scene_resolution()
diff --git a/openpype/hosts/max/api/pipeline.py b/openpype/hosts/max/api/pipeline.py
index f8a7b8ea5c..b3c12f59bc 100644
--- a/openpype/hosts/max/api/pipeline.py
+++ b/openpype/hosts/max/api/pipeline.py
@@ -49,6 +49,10 @@ class MaxHost(HostBase, IWorkfileHost, ILoadHost, INewPublisher):
         self.menu = OpenPypeMenu()
 
         self._has_been_setup = True
+        def context_setting():
+            return lib.set_context_setting()
+        rt.callbacks.addScript(rt.Name('systemPostNew'),
+                               context_setting)
 
     def has_unsaved_changes(self):
         # TODO: how to get it from 3dsmax?

From 543ec0d926e70f285dc008a3fc00623873c8c6d0 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Fri, 17 Mar 2023 22:28:48 +0800
Subject: [PATCH 039/151] cosmetic issue fix

---
 openpype/hosts/max/api/pipeline.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openpype/hosts/max/api/pipeline.py b/openpype/hosts/max/api/pipeline.py
index b3c12f59bc..dacc402318 100644
--- a/openpype/hosts/max/api/pipeline.py
+++ b/openpype/hosts/max/api/pipeline.py
@@ -49,6 +49,7 @@ class MaxHost(HostBase, IWorkfileHost, ILoadHost, INewPublisher):
         self.menu = OpenPypeMenu()
 
         self._has_been_setup = True
+
         def context_setting():
             return lib.set_context_setting()
         rt.callbacks.addScript(rt.Name('systemPostNew'),

From c86e8e1d6ea0ae292fe414d5c499451884b230e1 Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Fri, 17 Mar 2023 16:22:01 +0100
Subject: [PATCH 040/151] Added empty line in the end

VSC removed it automatically before.
---
 openpype/settings/defaults/project_settings/kitsu.json          | 2 +-
 .../entities/schemas/projects_schema/schema_project_kitsu.json  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/kitsu.json b/openpype/settings/defaults/project_settings/kitsu.json
index 738bd95e38..11c138e8e5 100644
--- a/openpype/settings/defaults/project_settings/kitsu.json
+++ b/openpype/settings/defaults/project_settings/kitsu.json
@@ -14,4 +14,4 @@
             }
         }
     }
-}
\ No newline at end of file
+}
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
index fc421c20f5..7ceb979d6f 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
@@ -82,4 +82,4 @@
             ]
         }
     ]
-}
\ No newline at end of file
+}

From 8a91e4aaa07dc10ae0d0c373749af103e284e5a7 Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Fri, 17 Mar 2023 16:22:28 +0100
Subject: [PATCH 041/151] Fixed comment

---
 .../modules/kitsu/plugins/publish/integrate_kitsu_note.py     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index a5a58c8462..67702578c5 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -33,8 +33,8 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
             if key not in instance.data:
                 self.log.warning(
                     "Key '{}' was not found in instance.data "
-                    "and will be rendered as "
-                    " in the comment".format(key)
+                    "and will be rendered as an empty string "
+                    "in the comment".format(key)
                 )
                 return ""
             else:

From 94ba8151e72b6d069d8a72fb74477a6ad0f7739c Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Fri, 17 Mar 2023 16:23:13 +0100
Subject: [PATCH 042/151] Read the comment from the instance instead from the
 context

---
 .../kitsu/plugins/publish/integrate_kitsu_note.py   | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index 67702578c5..cf36bbc4fe 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -45,11 +45,6 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
         return re.sub(pattern, replace_missing_key, template)
 
     def process(self, context):
-        # Get comment text body
-        publish_comment = context.data.get("comment")
-        if not publish_comment:
-            self.log.info("Comment is not set.")
-
         for instance in context:
             # Check if instance is a review by checking its family
             if "review" not in instance.data["families"]:
@@ -76,11 +71,15 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
                         "changed!".format(self.note_status_shortname)
                     )
 
-            # If custom comment, create it
+            # Get comment text body
+            publish_comment = instance.data.get("comment")
             if self.custom_comment_template["enabled"]:
                 publish_comment = self.format_publish_comment(instance)
 
-            self.log.debug("Comment is `{}`".format(publish_comment))
+            if not publish_comment:
+                self.log.info("Comment is not set.")
+            else:
+                self.log.debug("Comment is `{}`".format(publish_comment))
 
             # Add comment to kitsu task
             task_id = kitsu_task["id"]

From ab4179d49a06185da3b852861c50e216ad226238 Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Fri, 17 Mar 2023 16:51:36 +0000
Subject: [PATCH 043/151] Properly get and set model panel camera.

---
 .../maya/plugins/publish/extract_playblast.py | 23 ++++++-------------
 1 file changed, 7 insertions(+), 16 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_playblast.py b/openpype/hosts/maya/plugins/publish/extract_playblast.py
index 06d3ccb4a9..a652db2eb5 100644
--- a/openpype/hosts/maya/plugins/publish/extract_playblast.py
+++ b/openpype/hosts/maya/plugins/publish/extract_playblast.py
@@ -114,21 +114,12 @@ class ExtractPlayblast(publish.Extractor):
 
         # Image planes do not update the file sequence unless the active panel
         # is viewing through the camera.
-        model_panel = instance.context.data.get("model_panel")
-        if not model_panel:
-            model_panels = cmds.getPanel(type="modelPanel")
-            visible_panels = cmds.getPanel(visiblePanels=True)
-            model_panel = list(
-                set(visible_panels) - (set(visible_panels) - set(model_panels))
-            )[0]
-            instance.context.data["model_panel"] = model_panel
-
-        panel_camera = instance.context.data.get("panel_camera")
-        if not panel_camera:
-            panel_camera = capture.parse_view(model_panel)["camera"]
-            instance.context.data["panel_camera"] = panel_camera
-
-        cmds.modelPanel(model_panel, edit=True, camera=preset["camera"])
+        panel_camera = cmds.modelPanel(
+            instance.data["panel"], query=True, camera=True
+        )
+        cmds.modelPanel(
+            instance.data["panel"], edit=True, camera=preset["camera"]
+        )
 
         # Disable Pan/Zoom.
         pan_zoom = cmds.getAttr("{}.panZoomEnabled".format(preset["camera"]))
@@ -188,7 +179,7 @@ class ExtractPlayblast(publish.Extractor):
         cmds.setAttr("{}.panZoomEnabled".format(preset["camera"]), pan_zoom)
 
         # Restore panel camera.
-        cmds.modelPanel(model_panel, edit=True, camera=panel_camera)
+        cmds.modelPanel(instance.data["panel"], edit=True, camera=panel_camera)
 
         self.log.debug("playblast path  {}".format(path))
 

From 1dec179dc766d341a56b37baf3e07f6d092aca98 Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Sat, 18 Mar 2023 19:29:20 +0100
Subject: [PATCH 044/151] Changed the name from existing to expected frames

---
 ...ollect_existing_frames.py => collect_expected_frames.py} | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)
 rename openpype/hosts/fusion/plugins/publish/{collect_existing_frames.py => collect_expected_frames.py} (88%)

diff --git a/openpype/hosts/fusion/plugins/publish/collect_existing_frames.py b/openpype/hosts/fusion/plugins/publish/collect_expected_frames.py
similarity index 88%
rename from openpype/hosts/fusion/plugins/publish/collect_existing_frames.py
rename to openpype/hosts/fusion/plugins/publish/collect_expected_frames.py
index 7c5f7cd55d..485ca0c9a4 100644
--- a/openpype/hosts/fusion/plugins/publish/collect_existing_frames.py
+++ b/openpype/hosts/fusion/plugins/publish/collect_expected_frames.py
@@ -2,11 +2,11 @@ import pyblish.api
 import os
 
 
-class CollectFusionRenders(pyblish.api.InstancePlugin):
-    """Collect all frames needed to publish existing frames"""
+class CollectFusionExpectedFrames(pyblish.api.InstancePlugin):
+    """Collect all frames needed to publish expected frames"""
 
     order = pyblish.api.CollectorOrder + 0.5
-    label = "Collect Existing Frames"
+    label = "Collect Expected Frames"
     hosts = ["fusion"]
     families = ["render.frames"]
 

From aad3325e046de74696ba93bd8b2d592b423a3d8b Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Sat, 18 Mar 2023 19:29:32 +0100
Subject: [PATCH 045/151] Cleaned up code

---
 openpype/hosts/fusion/plugins/publish/collect_renders.py | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/openpype/hosts/fusion/plugins/publish/collect_renders.py b/openpype/hosts/fusion/plugins/publish/collect_renders.py
index be405d2495..7f38e68447 100644
--- a/openpype/hosts/fusion/plugins/publish/collect_renders.py
+++ b/openpype/hosts/fusion/plugins/publish/collect_renders.py
@@ -1,5 +1,4 @@
 import pyblish.api
-from pprint import pformat
 
 
 class CollectFusionRenders(pyblish.api.InstancePlugin):
@@ -17,8 +16,6 @@ class CollectFusionRenders(pyblish.api.InstancePlugin):
     families = ["render"]
 
     def process(self, instance):
-        self.log.debug(pformat(instance.data))
-
         render_target = instance.data["render_target"]
         family = instance.data["family"]
 
@@ -26,5 +23,3 @@ class CollectFusionRenders(pyblish.api.InstancePlugin):
         instance.data["families"].append(
             "{}.{}".format(family, render_target)
         )
-
-        self.log.debug(pformat(instance.data))

From f2e782368fe5a135c1d01f4ee6a85fe8840e0f94 Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Sat, 18 Mar 2023 19:30:13 +0100
Subject: [PATCH 046/151] Changed to dot notation for clearer code

---
 ...nce.py => validate_expected_frames_existence.py} | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)
 rename openpype/hosts/fusion/plugins/publish/{validate_existing_frames_existence.py => validate_expected_frames_existence.py} (87%)

diff --git a/openpype/hosts/fusion/plugins/publish/validate_existing_frames_existence.py b/openpype/hosts/fusion/plugins/publish/validate_expected_frames_existence.py
similarity index 87%
rename from openpype/hosts/fusion/plugins/publish/validate_existing_frames_existence.py
rename to openpype/hosts/fusion/plugins/publish/validate_expected_frames_existence.py
index a43d2c691a..e74eb82366 100644
--- a/openpype/hosts/fusion/plugins/publish/validate_existing_frames_existence.py
+++ b/openpype/hosts/fusion/plugins/publish/validate_expected_frames_existence.py
@@ -9,11 +9,11 @@ from openpype.hosts.fusion.api.action import SelectInvalidAction
 
 class ValidateLocalFramesExistence(pyblish.api.InstancePlugin):
     """Checks if files for savers that's set
-    to publish existing frames exists
+    to publish expected frames exists
     """
 
     order = pyblish.api.ValidatorOrder
-    label = "Validate Existing Frames Exists"
+    label = "Validate Expected Frames Exists"
     families = ["render"]
     hosts = ["fusion"]
     actions = [RepairAction, SelectInvalidAction]
@@ -71,13 +71,12 @@ class ValidateLocalFramesExistence(pyblish.api.InstancePlugin):
     def repair(cls, instance):
         invalid = cls.get_invalid(instance)
         if invalid:
-            data = invalid[0].GetData("openpype")
+            tool = invalid[0]
 
             # Change render target to local to render locally
-            data["creator_attributes"]["render_target"] = "local"
+            tool.SetData("openpype.creator_attributes.render_target", "local")
 
-            invalid[0].SetData("openpype", data)
-            cls.log.error(
-                f"Reload the publisher and {invalid[0].Name} "
+            cls.log.info(
+                f"Reload the publisher and {tool.Name} "
                 "will be set to render locally"
             )

From 0401f40ac941b0fba6f31c954aeb98da380d6301 Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Sat, 18 Mar 2023 19:50:11 +0100
Subject: [PATCH 047/151] Collect frames in expected_frames instead of in
 redner_local

---
 .../publish/collect_expected_frames.py        |  7 +++-
 .../plugins/publish/extract_render_local.py   | 39 +------------------
 2 files changed, 6 insertions(+), 40 deletions(-)

diff --git a/openpype/hosts/fusion/plugins/publish/collect_expected_frames.py b/openpype/hosts/fusion/plugins/publish/collect_expected_frames.py
index 485ca0c9a4..0ba777629f 100644
--- a/openpype/hosts/fusion/plugins/publish/collect_expected_frames.py
+++ b/openpype/hosts/fusion/plugins/publish/collect_expected_frames.py
@@ -1,14 +1,17 @@
 import pyblish.api
+from openpype.pipeline import publish
 import os
 
 
-class CollectFusionExpectedFrames(pyblish.api.InstancePlugin):
+class CollectFusionExpectedFrames(
+    pyblish.api.InstancePlugin, publish.ColormanagedPyblishPluginMixin
+):
     """Collect all frames needed to publish expected frames"""
 
     order = pyblish.api.CollectorOrder + 0.5
     label = "Collect Expected Frames"
     hosts = ["fusion"]
-    families = ["render.frames"]
+    families = ["render"]
 
     def process(self, instance):
         context = instance.context
diff --git a/openpype/hosts/fusion/plugins/publish/extract_render_local.py b/openpype/hosts/fusion/plugins/publish/extract_render_local.py
index ea801107c1..673c5a3ce3 100644
--- a/openpype/hosts/fusion/plugins/publish/extract_render_local.py
+++ b/openpype/hosts/fusion/plugins/publish/extract_render_local.py
@@ -4,9 +4,7 @@ from openpype.pipeline import publish
 from openpype.hosts.fusion.api import comp_lock_and_undo_chunk
 
 
-class FusionRenderLocal(
-    pyblish.api.InstancePlugin, publish.ColormanagedPyblishPluginMixin
-):
+class FusionRenderLocal(pyblish.api.InstancePlugin):
     """Render the current Fusion composition locally."""
 
     order = pyblish.api.ExtractorOrder - 0.2
@@ -29,41 +27,6 @@ class FusionRenderLocal(
             )
         )
 
-        # Generate the frame list
-        frame_start = context.data["frameStartHandle"]
-        frame_end = context.data["frameEndHandle"]
-        path = instance.data["path"]
-        output_dir = instance.data["outputDir"]
-
-        basename = os.path.basename(path)
-        head, ext = os.path.splitext(basename)
-        files = [
-            f"{head}{str(frame).zfill(4)}{ext}"
-            for frame in range(frame_start, frame_end + 1)
-        ]
-        repre = {
-            "name": ext[1:],
-            "ext": ext[1:],
-            "frameStart": f"%0{len(str(frame_end))}d" % frame_start,
-            "files": files,
-            "stagingDir": output_dir,
-        }
-
-        # Get the colorspace represenation
-        self.set_representation_colorspace(
-            representation=repre,
-            context=context,
-        )
-
-        # review representation
-        if instance.data.get("review", False):
-            repre["tags"] = ["review"]
-
-        # add the repre to the instance
-        if "representations" not in instance.data:
-            instance.data["representations"] = []
-        instance.data["representations"].append(repre)
-
     def render_once(self, context):
         """Render context comp only once, even with more render instances"""
 

From 519cd3050888478202e7e2328fb3894ca5a7ab0a Mon Sep 17 00:00:00 2001
From: Jacob Danell <jacob@emberlight.se>
Date: Sat, 18 Mar 2023 19:50:49 +0100
Subject: [PATCH 048/151] Removed code that should never be able to happen

---
 .../fusion/plugins/publish/validate_create_folder_checked.py  | 4 ----
 .../plugins/publish/validate_expected_frames_existence.py     | 4 ----
 2 files changed, 8 deletions(-)

diff --git a/openpype/hosts/fusion/plugins/publish/validate_create_folder_checked.py b/openpype/hosts/fusion/plugins/publish/validate_create_folder_checked.py
index 53dea2af71..8a91f23578 100644
--- a/openpype/hosts/fusion/plugins/publish/validate_create_folder_checked.py
+++ b/openpype/hosts/fusion/plugins/publish/validate_create_folder_checked.py
@@ -21,10 +21,6 @@ class ValidateCreateFolderChecked(pyblish.api.InstancePlugin):
 
     @classmethod
     def get_invalid(cls, instance):
-        active = instance.data.get("active", instance.data.get("publish"))
-        if not active:
-            return []
-
         tool = instance[0]
         create_dir = tool.GetInput("CreateDir")
         if create_dir == 0.0:
diff --git a/openpype/hosts/fusion/plugins/publish/validate_expected_frames_existence.py b/openpype/hosts/fusion/plugins/publish/validate_expected_frames_existence.py
index e74eb82366..c208b8ef15 100644
--- a/openpype/hosts/fusion/plugins/publish/validate_expected_frames_existence.py
+++ b/openpype/hosts/fusion/plugins/publish/validate_expected_frames_existence.py
@@ -23,10 +23,6 @@ class ValidateLocalFramesExistence(pyblish.api.InstancePlugin):
         if non_existing_frames is None:
             non_existing_frames = []
 
-        active = instance.data.get("active", instance.data.get("publish"))
-        if not active:
-            return []
-
         if instance.data.get("render_target") == "frames":
             tool = instance[0]
 

From d24c4e03dd41faa775efdc57b31b3cc3132f10b8 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Mon, 20 Mar 2023 17:56:50 +0800
Subject: [PATCH 049/151] 3dsmax: render instance settings in creator

---
 .../hosts/max/plugins/create/create_render.py | 50 +++++++++++++++++++
 .../max/plugins/publish/collect_render.py     | 11 +++-
 .../deadline/plugins/publish/collect_pools.py |  2 +-
 .../plugins/publish/submit_max_deadline.py    | 13 +++--
 4 files changed, 66 insertions(+), 10 deletions(-)

diff --git a/openpype/hosts/max/plugins/create/create_render.py b/openpype/hosts/max/plugins/create/create_render.py
index 269fff2e32..31e3ddcb09 100644
--- a/openpype/hosts/max/plugins/create/create_render.py
+++ b/openpype/hosts/max/plugins/create/create_render.py
@@ -1,8 +1,22 @@
 # -*- coding: utf-8 -*-
 """Creator plugin for creating camera."""
 from openpype.hosts.max.api import plugin
+from openpype.lib import (
+    TextDef,
+    BoolDef,
+    NumberDef,
+)
 from openpype.pipeline import CreatedInstance
 from openpype.hosts.max.api.lib_rendersettings import RenderSettings
+from openpype.settings import get_project_settings
+from openpype.pipeline import legacy_io
+
+
+def setting(project_setting=None):
+    render_setting = get_project_settings(
+        legacy_io.Session["AVALON_PROJECT"]
+    )
+    return render_setting["deadline"]["publish"]["MaxSubmitDeadline"]
 
 
 class CreateRender(plugin.MaxCreator):
@@ -31,3 +45,39 @@ class CreateRender(plugin.MaxCreator):
         RenderSettings().set_render_camera(sel_obj)
         # set output paths for rendering(mandatory for deadline)
         RenderSettings().render_output(container_name)
+
+    def get_instance_attr_defs(self):
+        return [
+            BoolDef("use_published",
+                    default=setting()["active"],
+                    label="Use Published Scene"),
+
+            NumberDef("priority",
+                      minimum=1,
+                      maximum=250,
+                      decimals=0,
+                      default=setting()["priority"],
+                      label="Priority"),
+
+            NumberDef("chunkSize",
+                      minimum=1,
+                      maximum=50,
+                      decimals=0,
+                      default=setting()["chunk_size"],
+                      label="Chunk Size"),
+
+            TextDef("group",
+                    default=setting()["group"],
+                    label="Group Name"),
+
+            TextDef("deadline_pool",
+                    default=setting()["deadline_pool"],
+                    label="Deadline Pool"),
+
+            TextDef("deadline_pool_secondary",
+                    default=setting()["deadline_pool_secondary"],
+                    label="Deadline Pool Secondary")
+        ]
+
+    def get_pre_create_attr_defs(self):
+        return self.get_instance_attr_defs()
diff --git a/openpype/hosts/max/plugins/publish/collect_render.py b/openpype/hosts/max/plugins/publish/collect_render.py
index 7c9e311c2f..357135750f 100644
--- a/openpype/hosts/max/plugins/publish/collect_render.py
+++ b/openpype/hosts/max/plugins/publish/collect_render.py
@@ -47,11 +47,13 @@ class CollectRender(pyblish.api.InstancePlugin):
         self.log.debug(f"Setting {version_int} to context.")
         context.data["version"] = version_int
 
+        creator_attr = instance.data["creator_attributes"]
+
         # setup the plugin as 3dsmax for the internal renderer
         data = {
             "subset": instance.name,
             "asset": asset,
-            "publish": True,
+            "publish": creator_attr["use_published"],
             "maxversion": str(get_max_version()),
             "imageFormat": img_format,
             "family": 'maxrender',
@@ -61,7 +63,12 @@ class CollectRender(pyblish.api.InstancePlugin):
             "plugin": "3dsmax",
             "frameStart": context.data['frameStart'],
             "frameEnd": context.data['frameEnd'],
-            "version": version_int
+            "version": version_int,
+            "priority": creator_attr["priority"],
+            "chunkSize": creator_attr["chunkSize"],
+            "group": creator_attr["group"],
+            "primaryPool": creator_attr["deadline_pool"],
+            "secondaryPool": creator_attr["deadline_pool_secondary"]
         }
         self.log.info("data: {0}".format(data))
         instance.data.update(data)
diff --git a/openpype/modules/deadline/plugins/publish/collect_pools.py b/openpype/modules/deadline/plugins/publish/collect_pools.py
index 48130848d5..c9b4f485d8 100644
--- a/openpype/modules/deadline/plugins/publish/collect_pools.py
+++ b/openpype/modules/deadline/plugins/publish/collect_pools.py
@@ -10,7 +10,7 @@ class CollectDeadlinePools(pyblish.api.InstancePlugin):
 
     order = pyblish.api.CollectorOrder + 0.420
     label = "Collect Deadline Pools"
-    families = ["rendering", "render.farm", "renderFarm", "renderlayer"]
+    families = ["rendering", "render.farm", "renderFarm", "renderlayer", "maxrender"]
 
     primary_pool = None
     secondary_pool = None
diff --git a/openpype/modules/deadline/plugins/publish/submit_max_deadline.py b/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
index 417a03de74..6d62dd7f33 100644
--- a/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
@@ -21,7 +21,7 @@ class MaxPluginInfo(object):
     SaveFile = attr.ib(default=True)
     IgnoreInputs = attr.ib(default=True)
 
-
+#TODO: add the optional attirbute
 class MaxSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline):
 
     label = "Submit Render to Deadline"
@@ -49,11 +49,13 @@ class MaxSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline):
 
         instance = self._instance
         context = instance.context
-
         # Always use the original work file name for the Job name even when
         # rendering is done from the published Work File. The original work
         # file name is clearer because it can also have subversion strings,
         # etc. which are stripped for the published file.
+        if not instance.data.get("publish"):
+            self.use_published = False
+
         src_filepath = context.data["currentFile"]
         src_filename = os.path.basename(src_filepath)
 
@@ -71,13 +73,10 @@ class MaxSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline):
 
         job_info.Pool = instance.data.get("primaryPool")
         job_info.SecondaryPool = instance.data.get("secondaryPool")
-        job_info.ChunkSize = instance.data.get("chunkSize", 1)
+        job_info.ChunkSize = instance.data.get("chunkSize", self.chunk_size)
         job_info.Comment = context.data.get("comment")
         job_info.Priority = instance.data.get("priority", self.priority)
-        job_info.FramesPerTask = instance.data.get("framesPerTask", 1)
-
-        if self.group:
-            job_info.Group = self.group
+        job_info.Group = instance.data.get("group", self.group)
 
         # Add options from RenderGlobals
         render_globals = instance.data.get("renderGlobals", {})

From f1c490b21cf69294b7c1ab7e03a8115557c552de Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Mon, 20 Mar 2023 10:57:16 +0100
Subject: [PATCH 050/151] Fix `get_all_asset_nodes`

---
 openpype/hosts/maya/tools/mayalookassigner/commands.py | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/openpype/hosts/maya/tools/mayalookassigner/commands.py b/openpype/hosts/maya/tools/mayalookassigner/commands.py
index 0135eb4f49..3d9746511d 100644
--- a/openpype/hosts/maya/tools/mayalookassigner/commands.py
+++ b/openpype/hosts/maya/tools/mayalookassigner/commands.py
@@ -80,9 +80,7 @@ def get_all_asset_nodes():
     Returns:
         list: list of dictionaries
     """
-    nodes = cmds.ls(dag=True, noIntermediate=True, long=True)
-    items = create_items_from_nodes(nodes)
-    return items
+    return cmds.ls(dag=True, noIntermediate=True, long=True)
 
 
 def create_asset_id_hash(nodes):

From fff1e3f0c1b257d03170fd665ccd09636fc611ad Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Mon, 20 Mar 2023 18:08:51 +0800
Subject: [PATCH 051/151] cosmetic fix and add optional for 3dsmax deadline
 submission

---
 .../deadline/plugins/publish/collect_pools.py        |  6 +++++-
 .../deadline/plugins/publish/submit_max_deadline.py  | 12 +++++++++---
 2 files changed, 14 insertions(+), 4 deletions(-)

diff --git a/openpype/modules/deadline/plugins/publish/collect_pools.py b/openpype/modules/deadline/plugins/publish/collect_pools.py
index c9b4f485d8..3a424f9e74 100644
--- a/openpype/modules/deadline/plugins/publish/collect_pools.py
+++ b/openpype/modules/deadline/plugins/publish/collect_pools.py
@@ -10,7 +10,11 @@ class CollectDeadlinePools(pyblish.api.InstancePlugin):
 
     order = pyblish.api.CollectorOrder + 0.420
     label = "Collect Deadline Pools"
-    families = ["rendering", "render.farm", "renderFarm", "renderlayer", "maxrender"]
+    families = ["rendering",
+                "render.farm",
+                "renderFarm",
+                "renderlayer",
+                "maxrender"]
 
     primary_pool = None
     secondary_pool = None
diff --git a/openpype/modules/deadline/plugins/publish/submit_max_deadline.py b/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
index 6d62dd7f33..1f1a59a8e6 100644
--- a/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
@@ -3,7 +3,10 @@ import getpass
 import copy
 
 import attr
-from openpype.pipeline import legacy_io
+from openpype.pipeline import (
+    legacy_io,
+    OptionalPyblishPluginMixin
+)
 from openpype.settings import get_project_settings
 from openpype.hosts.max.api.lib import (
     get_current_renderer,
@@ -21,8 +24,8 @@ class MaxPluginInfo(object):
     SaveFile = attr.ib(default=True)
     IgnoreInputs = attr.ib(default=True)
 
-#TODO: add the optional attirbute
-class MaxSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline):
+class MaxSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline,
+                        OptionalPyblishPluginMixin):
 
     label = "Submit Render to Deadline"
     hosts = ["max"]
@@ -39,6 +42,7 @@ class MaxSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline):
     deadline_pool = None
     deadline_pool_secondary = None
     framePerTask = 1
+    optional = True
 
     def get_job_info(self):
         job_info = DeadlineJobInfo(Plugin="3dsmax")
@@ -49,6 +53,8 @@ class MaxSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline):
 
         instance = self._instance
         context = instance.context
+        if not self.is_active(instance.data):
+            return
         # Always use the original work file name for the Job name even when
         # rendering is done from the published Work File. The original work
         # file name is clearer because it can also have subversion strings,

From 7baa5754e05d6f30794cb265245f8d55a68a0c37 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Mon, 20 Mar 2023 18:09:39 +0800
Subject: [PATCH 052/151] cosmetic issue fix

---
 openpype/modules/deadline/plugins/publish/submit_max_deadline.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openpype/modules/deadline/plugins/publish/submit_max_deadline.py b/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
index 1f1a59a8e6..d04c4b9c09 100644
--- a/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
@@ -24,6 +24,7 @@ class MaxPluginInfo(object):
     SaveFile = attr.ib(default=True)
     IgnoreInputs = attr.ib(default=True)
 
+
 class MaxSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline,
                         OptionalPyblishPluginMixin):
 

From 507941c20898a9cf524851189a10176263543116 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Mon, 20 Mar 2023 18:36:36 +0800
Subject: [PATCH 053/151] use apply_settings

---
 .../hosts/max/plugins/create/create_render.py | 32 ++++++++++---------
 .../plugins/publish/submit_max_deadline.py    |  4 +--
 2 files changed, 18 insertions(+), 18 deletions(-)

diff --git a/openpype/hosts/max/plugins/create/create_render.py b/openpype/hosts/max/plugins/create/create_render.py
index 31e3ddcb09..dc1605bb5e 100644
--- a/openpype/hosts/max/plugins/create/create_render.py
+++ b/openpype/hosts/max/plugins/create/create_render.py
@@ -8,15 +8,6 @@ from openpype.lib import (
 )
 from openpype.pipeline import CreatedInstance
 from openpype.hosts.max.api.lib_rendersettings import RenderSettings
-from openpype.settings import get_project_settings
-from openpype.pipeline import legacy_io
-
-
-def setting(project_setting=None):
-    render_setting = get_project_settings(
-        legacy_io.Session["AVALON_PROJECT"]
-    )
-    return render_setting["deadline"]["publish"]["MaxSubmitDeadline"]
 
 
 class CreateRender(plugin.MaxCreator):
@@ -25,6 +16,17 @@ class CreateRender(plugin.MaxCreator):
     family = "maxrender"
     icon = "gear"
 
+    def apply_settings(self, project_settings, system_settings):
+        plugin_settings = (
+            project_settings["deadline"]["publish"]["MaxSubmitDeadline"]
+        )
+        self.use_published = plugin_settings["use_published"]
+        self.priority = plugin_settings["priority"]
+        self.chunkSize = plugin_settings["chunk_size"]
+        self.group = plugin_settings["group"]
+        self.deadline_pool = plugin_settings["deadline_pool"]
+        self.deadline_pool_secondary = plugin_settings["deadline_pool_secondary"]
+
     def create(self, subset_name, instance_data, pre_create_data):
         from pymxs import runtime as rt
         sel_obj = list(rt.selection)
@@ -49,33 +51,33 @@ class CreateRender(plugin.MaxCreator):
     def get_instance_attr_defs(self):
         return [
             BoolDef("use_published",
-                    default=setting()["active"],
+                    default=self.use_published,
                     label="Use Published Scene"),
 
             NumberDef("priority",
                       minimum=1,
                       maximum=250,
                       decimals=0,
-                      default=setting()["priority"],
+                      default=self.priority,
                       label="Priority"),
 
             NumberDef("chunkSize",
                       minimum=1,
                       maximum=50,
                       decimals=0,
-                      default=setting()["chunk_size"],
+                      default=self.chunkSize,
                       label="Chunk Size"),
 
             TextDef("group",
-                    default=setting()["group"],
+                    default=self.group,
                     label="Group Name"),
 
             TextDef("deadline_pool",
-                    default=setting()["deadline_pool"],
+                    default=self.deadline_pool,
                     label="Deadline Pool"),
 
             TextDef("deadline_pool_secondary",
-                    default=setting()["deadline_pool_secondary"],
+                    default=self.deadline_pool_secondary,
                     label="Deadline Pool Secondary")
         ]
 
diff --git a/openpype/modules/deadline/plugins/publish/submit_max_deadline.py b/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
index d04c4b9c09..92e06ca765 100644
--- a/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
@@ -60,8 +60,6 @@ class MaxSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline,
         # rendering is done from the published Work File. The original work
         # file name is clearer because it can also have subversion strings,
         # etc. which are stripped for the published file.
-        if not instance.data.get("publish"):
-            self.use_published = False
 
         src_filepath = context.data["currentFile"]
         src_filename = os.path.basename(src_filepath)
@@ -80,7 +78,7 @@ class MaxSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline,
 
         job_info.Pool = instance.data.get("primaryPool")
         job_info.SecondaryPool = instance.data.get("secondaryPool")
-        job_info.ChunkSize = instance.data.get("chunkSize", self.chunk_size)
+        job_info.ChunkSize = instance.data.get("chunkSize", 1)
         job_info.Comment = context.data.get("comment")
         job_info.Priority = instance.data.get("priority", self.priority)
         job_info.Group = instance.data.get("group", self.group)

From e00ef8210c9fb592bf9ee84c5c8e56df785a2845 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Mon, 20 Mar 2023 18:37:58 +0800
Subject: [PATCH 054/151] cosmetic issue fix

---
 openpype/hosts/max/plugins/create/create_render.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/max/plugins/create/create_render.py b/openpype/hosts/max/plugins/create/create_render.py
index dc1605bb5e..a24c5ea000 100644
--- a/openpype/hosts/max/plugins/create/create_render.py
+++ b/openpype/hosts/max/plugins/create/create_render.py
@@ -25,7 +25,7 @@ class CreateRender(plugin.MaxCreator):
         self.chunkSize = plugin_settings["chunk_size"]
         self.group = plugin_settings["group"]
         self.deadline_pool = plugin_settings["deadline_pool"]
-        self.deadline_pool_secondary = plugin_settings["deadline_pool_secondary"]
+        self.pool_secondary = plugin_settings["deadline_pool_secondary"]
 
     def create(self, subset_name, instance_data, pre_create_data):
         from pymxs import runtime as rt
@@ -77,7 +77,7 @@ class CreateRender(plugin.MaxCreator):
                     label="Deadline Pool"),
 
             TextDef("deadline_pool_secondary",
-                    default=self.deadline_pool_secondary,
+                    default=self.pool_secondary,
                     label="Deadline Pool Secondary")
         ]
 

From 4506a2f3ef3e7fe7b7002d89266fdb8dfb6ce8da Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Mon, 20 Mar 2023 13:41:17 +0100
Subject: [PATCH 055/151] Fix broken Nuke local test

Accidentally used DL version
---
 tests/integration/hosts/nuke/test_publish_in_nuke.py | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/tests/integration/hosts/nuke/test_publish_in_nuke.py b/tests/integration/hosts/nuke/test_publish_in_nuke.py
index a4026f195b..bfd84e4fd5 100644
--- a/tests/integration/hosts/nuke/test_publish_in_nuke.py
+++ b/tests/integration/hosts/nuke/test_publish_in_nuke.py
@@ -1,12 +1,12 @@
 import logging
 
 from tests.lib.assert_classes import DBAssert
-from tests.integration.hosts.nuke.lib import NukeDeadlinePublishTestClass
+from tests.integration.hosts.nuke.lib import NukeLocalPublishTestClass
 
 log = logging.getLogger("test_publish_in_nuke")
 
 
-class TestDeadlinePublishInNuke(NukeDeadlinePublishTestClass):
+class TestPublishInNuke(NukeLocalPublishTestClass):
     """Basic test case for publishing in Nuke
 
         Uses generic TestCase to prepare fixtures for test data, testing DBs,
@@ -36,13 +36,12 @@ class TestDeadlinePublishInNuke(NukeDeadlinePublishTestClass):
     """
     # https://drive.google.com/file/d/1SUurHj2aiQ21ZIMJfGVBI2KjR8kIjBGI/view?usp=sharing  # noqa: E501
     TEST_FILES = [
-        ("1SeWprClKhWMv2xVC9AcnekIJFExxnp_b",
-         "test_nuke_deadline_publish.zip", "")
+        ("1SUurHj2aiQ21ZIMJfGVBI2KjR8kIjBGI", "test_Nuke_publish.zip", "")
     ]
 
     APP_GROUP = "nuke"
 
-    TIMEOUT = 180  # publish timeout
+    TIMEOUT = 50  # publish timeout
 
     # could be overwritten by command line arguments
     # keep empty to locate latest installed variant or explicit
@@ -99,4 +98,4 @@ class TestDeadlinePublishInNuke(NukeDeadlinePublishTestClass):
 
 
 if __name__ == "__main__":
-    test_case = TestDeadlinePublishInNuke()
+    test_case = TestPublishInNuke()

From 36db7faab4c763ed58d9ac3a124a54c9ecac5e9b Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Mon, 20 Mar 2023 23:51:49 +0800
Subject: [PATCH 056/151] only allows user to set up the attributes in publish
 tab

---
 .../hosts/max/plugins/create/create_render.py | 52 -----------
 .../max/plugins/publish/collect_render.py     |  9 +-
 .../plugins/publish/submit_max_deadline.py    | 86 ++++++++++++++++---
 3 files changed, 77 insertions(+), 70 deletions(-)

diff --git a/openpype/hosts/max/plugins/create/create_render.py b/openpype/hosts/max/plugins/create/create_render.py
index a24c5ea000..269fff2e32 100644
--- a/openpype/hosts/max/plugins/create/create_render.py
+++ b/openpype/hosts/max/plugins/create/create_render.py
@@ -1,11 +1,6 @@
 # -*- coding: utf-8 -*-
 """Creator plugin for creating camera."""
 from openpype.hosts.max.api import plugin
-from openpype.lib import (
-    TextDef,
-    BoolDef,
-    NumberDef,
-)
 from openpype.pipeline import CreatedInstance
 from openpype.hosts.max.api.lib_rendersettings import RenderSettings
 
@@ -16,17 +11,6 @@ class CreateRender(plugin.MaxCreator):
     family = "maxrender"
     icon = "gear"
 
-    def apply_settings(self, project_settings, system_settings):
-        plugin_settings = (
-            project_settings["deadline"]["publish"]["MaxSubmitDeadline"]
-        )
-        self.use_published = plugin_settings["use_published"]
-        self.priority = plugin_settings["priority"]
-        self.chunkSize = plugin_settings["chunk_size"]
-        self.group = plugin_settings["group"]
-        self.deadline_pool = plugin_settings["deadline_pool"]
-        self.pool_secondary = plugin_settings["deadline_pool_secondary"]
-
     def create(self, subset_name, instance_data, pre_create_data):
         from pymxs import runtime as rt
         sel_obj = list(rt.selection)
@@ -47,39 +31,3 @@ class CreateRender(plugin.MaxCreator):
         RenderSettings().set_render_camera(sel_obj)
         # set output paths for rendering(mandatory for deadline)
         RenderSettings().render_output(container_name)
-
-    def get_instance_attr_defs(self):
-        return [
-            BoolDef("use_published",
-                    default=self.use_published,
-                    label="Use Published Scene"),
-
-            NumberDef("priority",
-                      minimum=1,
-                      maximum=250,
-                      decimals=0,
-                      default=self.priority,
-                      label="Priority"),
-
-            NumberDef("chunkSize",
-                      minimum=1,
-                      maximum=50,
-                      decimals=0,
-                      default=self.chunkSize,
-                      label="Chunk Size"),
-
-            TextDef("group",
-                    default=self.group,
-                    label="Group Name"),
-
-            TextDef("deadline_pool",
-                    default=self.deadline_pool,
-                    label="Deadline Pool"),
-
-            TextDef("deadline_pool_secondary",
-                    default=self.pool_secondary,
-                    label="Deadline Pool Secondary")
-        ]
-
-    def get_pre_create_attr_defs(self):
-        return self.get_instance_attr_defs()
diff --git a/openpype/hosts/max/plugins/publish/collect_render.py b/openpype/hosts/max/plugins/publish/collect_render.py
index 357135750f..63e4108c84 100644
--- a/openpype/hosts/max/plugins/publish/collect_render.py
+++ b/openpype/hosts/max/plugins/publish/collect_render.py
@@ -47,13 +47,11 @@ class CollectRender(pyblish.api.InstancePlugin):
         self.log.debug(f"Setting {version_int} to context.")
         context.data["version"] = version_int
 
-        creator_attr = instance.data["creator_attributes"]
-
         # setup the plugin as 3dsmax for the internal renderer
         data = {
             "subset": instance.name,
             "asset": asset,
-            "publish": creator_attr["use_published"],
+            "publish": True,
             "maxversion": str(get_max_version()),
             "imageFormat": img_format,
             "family": 'maxrender',
@@ -64,11 +62,6 @@ class CollectRender(pyblish.api.InstancePlugin):
             "frameStart": context.data['frameStart'],
             "frameEnd": context.data['frameEnd'],
             "version": version_int,
-            "priority": creator_attr["priority"],
-            "chunkSize": creator_attr["chunkSize"],
-            "group": creator_attr["group"],
-            "primaryPool": creator_attr["deadline_pool"],
-            "secondaryPool": creator_attr["deadline_pool_secondary"]
         }
         self.log.info("data: {0}".format(data))
         instance.data.update(data)
diff --git a/openpype/modules/deadline/plugins/publish/submit_max_deadline.py b/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
index 92e06ca765..83ecdfd6af 100644
--- a/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
@@ -3,9 +3,14 @@ import getpass
 import copy
 
 import attr
+from openpype.lib import (
+    TextDef,
+    BoolDef,
+    NumberDef,
+)
 from openpype.pipeline import (
     legacy_io,
-    OptionalPyblishPluginMixin
+    OpenPypePyblishPluginMixin
 )
 from openpype.settings import get_project_settings
 from openpype.hosts.max.api.lib import (
@@ -26,7 +31,7 @@ class MaxPluginInfo(object):
 
 
 class MaxSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline,
-                        OptionalPyblishPluginMixin):
+                        OpenPypePyblishPluginMixin):
 
     label = "Submit Render to Deadline"
     hosts = ["max"]
@@ -36,7 +41,7 @@ class MaxSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline,
     use_published = True
     priority = 50
     tile_priority = 50
-    chunk_size = 1
+    chunkSize = 1
     jobInfo = {}
     pluginInfo = {}
     group = None
@@ -45,6 +50,22 @@ class MaxSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline,
     framePerTask = 1
     optional = True
 
+    @classmethod
+    def apply_settings(cls, project_settings, system_settings):
+        settings = project_settings["deadline"]["publish"]["MaxSubmitDeadline"]  # noqa
+
+        # Take some defaults from settings
+        cls.use_published = settings.get("use_published",
+                                         cls.use_published)
+        cls.priority = settings.get("priority",
+                                    cls.priority)
+        cls.chunkSize = settings.get("chunk_size", cls.chunkSize)
+        cls.group = settings.get("group", cls.group)
+        cls.deadline_pool = settings.get("deadline_pool",
+                                         cls.deadline_pool)
+        cls.deadline_pool_secondary = settings.get("deadline_pool_secondary",
+                                                   cls.deadline_pool_secondary)
+
     def get_job_info(self):
         job_info = DeadlineJobInfo(Plugin="3dsmax")
 
@@ -54,8 +75,6 @@ class MaxSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline,
 
         instance = self._instance
         context = instance.context
-        if not self.is_active(instance.data):
-            return
         # Always use the original work file name for the Job name even when
         # rendering is done from the published Work File. The original work
         # file name is clearer because it can also have subversion strings,
@@ -76,12 +95,22 @@ class MaxSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline,
         )
         job_info.Frames = frames
 
-        job_info.Pool = instance.data.get("primaryPool")
-        job_info.SecondaryPool = instance.data.get("secondaryPool")
-        job_info.ChunkSize = instance.data.get("chunkSize", 1)
+        attr_values = self.get_attr_values_from_data(instance.data)
+
+        if attr_values.get("deadline_pool"):
+            job_info.Pool = attr_values.get("deadline_pool")
+        else:
+            job_info.Pool = instance.data.get("primaryPool")
+        if attr_values.get("deadline_pool_secondary"):
+            job_info.SecondaryPool = attr_values.get("deadline_pool_secondary")
+        else:
+            job_info.SecondaryPool = instance.data.get("secondaryPool",
+                                                       self.deadline_pool_secondary)
+
+        job_info.ChunkSize = attr_values.get("chunkSize", 1)
         job_info.Comment = context.data.get("comment")
-        job_info.Priority = instance.data.get("priority", self.priority)
-        job_info.Group = instance.data.get("group", self.group)
+        job_info.Priority = attr_values.get("priority", self.priority)
+        job_info.Group = attr_values.get("group", self.group)
 
         # Add options from RenderGlobals
         render_globals = instance.data.get("renderGlobals", {})
@@ -220,3 +249,40 @@ class MaxSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline,
         plugin_info.update(plugin_data)
 
         return job_info, plugin_info
+
+    @classmethod
+    def get_attribute_defs(cls):
+        defs = super(MaxSubmitDeadline, cls).get_attribute_defs()
+        defs.extend([
+            BoolDef("use_published",
+                    default=cls.use_published,
+                    label="Use Published Scene"),
+
+            NumberDef("priority",
+                      minimum=1,
+                      maximum=250,
+                      decimals=0,
+                      default=cls.priority,
+                      label="Priority"),
+
+            NumberDef("chunkSize",
+                      minimum=1,
+                      maximum=50,
+                      decimals=0,
+                      default=cls.chunkSize,
+                      label="Frame Per Task"),
+
+            TextDef("group",
+                    default=cls.group,
+                    label="Group Name"),
+
+            TextDef("deadline_pool",
+                    default=cls.deadline_pool,
+                    label="Deadline Pool"),
+
+            TextDef("deadline_pool_secondary",
+                    default=cls.deadline_pool_secondary,
+                    label="Deadline Pool Secondary")
+        ])
+
+        return defs

From fb6bc696f8a5f94b54689c2d4e6c390f8058220c Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Mon, 20 Mar 2023 23:54:16 +0800
Subject: [PATCH 057/151] cosmetic issue fix

---
 .../modules/deadline/plugins/publish/submit_max_deadline.py     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/modules/deadline/plugins/publish/submit_max_deadline.py b/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
index 83ecdfd6af..478c2ce2de 100644
--- a/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
@@ -105,7 +105,7 @@ class MaxSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline,
             job_info.SecondaryPool = attr_values.get("deadline_pool_secondary")
         else:
             job_info.SecondaryPool = instance.data.get("secondaryPool",
-                                                       self.deadline_pool_secondary)
+                                                       self.deadline_pool_secondary)    # noqa
 
         job_info.ChunkSize = attr_values.get("chunkSize", 1)
         job_info.Comment = context.data.get("comment")

From 2af4c94e2ca6328328b49bed562c2a4106ba9c90 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Tue, 21 Mar 2023 15:43:45 +0800
Subject: [PATCH 058/151] move the pool settings into the pool collectors

---
 .../deadline/plugins/publish/collect_pools.py | 46 +++++++++++++++++--
 .../plugins/publish/submit_max_deadline.py    | 25 ++--------
 .../publish/validate_deadline_pools.py        |  6 ++-
 3 files changed, 51 insertions(+), 26 deletions(-)

diff --git a/openpype/modules/deadline/plugins/publish/collect_pools.py b/openpype/modules/deadline/plugins/publish/collect_pools.py
index 3a424f9e74..eb84308e9d 100644
--- a/openpype/modules/deadline/plugins/publish/collect_pools.py
+++ b/openpype/modules/deadline/plugins/publish/collect_pools.py
@@ -3,9 +3,12 @@
 
 """
 import pyblish.api
+from openpype.lib import TextDef
+from openpype.pipeline.publish import OpenPypePyblishPluginMixin
 
 
-class CollectDeadlinePools(pyblish.api.InstancePlugin):
+class CollectDeadlinePools(pyblish.api.InstancePlugin,
+                           OpenPypePyblishPluginMixin):
     """Collect pools from instance if present, from Setting otherwise."""
 
     order = pyblish.api.CollectorOrder + 0.420
@@ -19,9 +22,46 @@ class CollectDeadlinePools(pyblish.api.InstancePlugin):
     primary_pool = None
     secondary_pool = None
 
+    @classmethod
+    def apply_settings(cls, project_settings, system_settings):
+        # deadline.publish.CollectDeadlinePools
+        settings = project_settings["deadline"]["publish"]["CollectDeadlinePools"]  # noqa
+        cls.primary_pool = settings.get("primary_pool", None)
+        cls.secondary_pool = settings.get("secondary_pool", None)
+        for family in cls.families:
+            if family == "maxrender":
+                max_setting = project_settings["deadline"]["publish"]["MaxSubmitDeadline"]  # noqa
+                cls.primary_pool = max_setting.get("deadline_pool", None)
+                cls.secondary_pool = max_setting.get("deadline_pool_secondary", None)
+
     def process(self, instance):
+
+        attr_values = self.get_attr_values_from_data(instance.data)
         if not instance.data.get("primaryPool"):
-            instance.data["primaryPool"] = self.primary_pool or "none"
+            instance.data["primaryPool"] = (
+                attr_values.get("primaryPool") or self.primary_pool or "none"
+            )
 
         if not instance.data.get("secondaryPool"):
-            instance.data["secondaryPool"] = self.secondary_pool or "none"
+            instance.data["secondaryPool"] = (
+                attr_values.get("secondaryPool") or self.secondary_pool or "none"  # noqa
+            )
+
+    @classmethod
+    def get_attribute_defs(cls):
+        # TODO: Preferably this would be an enum for the user
+        #       but the Deadline server URL can be dynamic and
+        #       can be set per render instance. Since get_attribute_defs
+        #       can't be dynamic unfortunately EnumDef isn't possible (yet?)
+        # pool_names = self.deadline_module.get_deadline_pools(deadline_url,
+        #                                                      self.log)
+        # secondary_pool_names = ["-"] + pool_names
+
+        return [
+            TextDef("primaryPool",
+                    label="Primary Pool",
+                    default=cls.primary_pool),
+            TextDef("secondaryPool",
+                    label="Secondary Pool",
+                    default=cls.secondary_pool)
+        ]
diff --git a/openpype/modules/deadline/plugins/publish/submit_max_deadline.py b/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
index 478c2ce2de..c55e85cfb0 100644
--- a/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
@@ -61,10 +61,6 @@ class MaxSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline,
                                     cls.priority)
         cls.chunkSize = settings.get("chunk_size", cls.chunkSize)
         cls.group = settings.get("group", cls.group)
-        cls.deadline_pool = settings.get("deadline_pool",
-                                         cls.deadline_pool)
-        cls.deadline_pool_secondary = settings.get("deadline_pool_secondary",
-                                                   cls.deadline_pool_secondary)
 
     def get_job_info(self):
         job_info = DeadlineJobInfo(Plugin="3dsmax")
@@ -95,17 +91,10 @@ class MaxSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline,
         )
         job_info.Frames = frames
 
-        attr_values = self.get_attr_values_from_data(instance.data)
+        job_info.Pool = instance.data.get("primaryPool")
+        job_info.SecondaryPool = instance.data.get("secondaryPool")
 
-        if attr_values.get("deadline_pool"):
-            job_info.Pool = attr_values.get("deadline_pool")
-        else:
-            job_info.Pool = instance.data.get("primaryPool")
-        if attr_values.get("deadline_pool_secondary"):
-            job_info.SecondaryPool = attr_values.get("deadline_pool_secondary")
-        else:
-            job_info.SecondaryPool = instance.data.get("secondaryPool",
-                                                       self.deadline_pool_secondary)    # noqa
+        attr_values = self.get_attr_values_from_data(instance.data)
 
         job_info.ChunkSize = attr_values.get("chunkSize", 1)
         job_info.Comment = context.data.get("comment")
@@ -275,14 +264,6 @@ class MaxSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline,
             TextDef("group",
                     default=cls.group,
                     label="Group Name"),
-
-            TextDef("deadline_pool",
-                    default=cls.deadline_pool,
-                    label="Deadline Pool"),
-
-            TextDef("deadline_pool_secondary",
-                    default=cls.deadline_pool_secondary,
-                    label="Deadline Pool Secondary")
         ])
 
         return defs
diff --git a/openpype/modules/deadline/plugins/publish/validate_deadline_pools.py b/openpype/modules/deadline/plugins/publish/validate_deadline_pools.py
index 78eed17c98..3c02c7933f 100644
--- a/openpype/modules/deadline/plugins/publish/validate_deadline_pools.py
+++ b/openpype/modules/deadline/plugins/publish/validate_deadline_pools.py
@@ -17,7 +17,11 @@ class ValidateDeadlinePools(OptionalPyblishPluginMixin,
 
     label = "Validate Deadline Pools"
     order = pyblish.api.ValidatorOrder
-    families = ["rendering", "render.farm", "renderFarm", "renderlayer"]
+    families = ["rendering",
+                "render.farm",
+                "renderFarm",
+                "renderlayer",
+                "maxrender"]
     optional = True
 
     def process(self, instance):

From c48fddbba33cdb290c6f86c34bc68bb25a943607 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Tue, 21 Mar 2023 15:45:01 +0800
Subject: [PATCH 059/151] cosmetic issue fix

---
 openpype/modules/deadline/plugins/publish/collect_pools.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openpype/modules/deadline/plugins/publish/collect_pools.py b/openpype/modules/deadline/plugins/publish/collect_pools.py
index eb84308e9d..b2732d375f 100644
--- a/openpype/modules/deadline/plugins/publish/collect_pools.py
+++ b/openpype/modules/deadline/plugins/publish/collect_pools.py
@@ -32,7 +32,8 @@ class CollectDeadlinePools(pyblish.api.InstancePlugin,
             if family == "maxrender":
                 max_setting = project_settings["deadline"]["publish"]["MaxSubmitDeadline"]  # noqa
                 cls.primary_pool = max_setting.get("deadline_pool", None)
-                cls.secondary_pool = max_setting.get("deadline_pool_secondary", None)
+                cls.secondary_pool = max_setting.get("deadline_pool_secondary",
+                                                     None)
 
     def process(self, instance):
 

From d8441216e4fa4c8b1b0b1ee2e58d1df4eb2b28a3 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Tue, 21 Mar 2023 15:55:07 +0800
Subject: [PATCH 060/151] move the pool settings into the pool collectors

---
 openpype/modules/deadline/plugins/publish/collect_pools.py  | 6 ------
 .../modules/deadline/plugins/publish/submit_max_deadline.py | 6 ++++--
 2 files changed, 4 insertions(+), 8 deletions(-)

diff --git a/openpype/modules/deadline/plugins/publish/collect_pools.py b/openpype/modules/deadline/plugins/publish/collect_pools.py
index b2732d375f..e221eb00ea 100644
--- a/openpype/modules/deadline/plugins/publish/collect_pools.py
+++ b/openpype/modules/deadline/plugins/publish/collect_pools.py
@@ -28,12 +28,6 @@ class CollectDeadlinePools(pyblish.api.InstancePlugin,
         settings = project_settings["deadline"]["publish"]["CollectDeadlinePools"]  # noqa
         cls.primary_pool = settings.get("primary_pool", None)
         cls.secondary_pool = settings.get("secondary_pool", None)
-        for family in cls.families:
-            if family == "maxrender":
-                max_setting = project_settings["deadline"]["publish"]["MaxSubmitDeadline"]  # noqa
-                cls.primary_pool = max_setting.get("deadline_pool", None)
-                cls.secondary_pool = max_setting.get("deadline_pool_secondary",
-                                                     None)
 
     def process(self, instance):
 
diff --git a/openpype/modules/deadline/plugins/publish/submit_max_deadline.py b/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
index c55e85cfb0..e681346556 100644
--- a/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
@@ -91,8 +91,10 @@ class MaxSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline,
         )
         job_info.Frames = frames
 
-        job_info.Pool = instance.data.get("primaryPool")
-        job_info.SecondaryPool = instance.data.get("secondaryPool")
+        job_info.Pool = instance.data.get("primaryPool",
+                                          self.deadline_pool)
+        job_info.SecondaryPool = instance.data.get("secondaryPool",
+                                                   self.deadline_pool_secondary)
 
         attr_values = self.get_attr_values_from_data(instance.data)
 

From 6c1882236419d68934d6130242ffc9cf75c4eeba Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Tue, 21 Mar 2023 15:56:15 +0800
Subject: [PATCH 061/151] hound fix

---
 .../modules/deadline/plugins/publish/submit_max_deadline.py     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/modules/deadline/plugins/publish/submit_max_deadline.py b/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
index e681346556..e99752b7ab 100644
--- a/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
@@ -94,7 +94,7 @@ class MaxSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline,
         job_info.Pool = instance.data.get("primaryPool",
                                           self.deadline_pool)
         job_info.SecondaryPool = instance.data.get("secondaryPool",
-                                                   self.deadline_pool_secondary)
+                                                   self.deadline_pool_secondary)    # noqa
 
         attr_values = self.get_attr_values_from_data(instance.data)
 

From 6bdca1561bc14fd024f0d264887f4a2202fbcc79 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Tue, 21 Mar 2023 16:00:29 +0800
Subject: [PATCH 062/151] clean up the duplicate attributes for pool settings

---
 .../deadline/plugins/publish/submit_max_deadline.py    |  8 ++------
 .../settings/defaults/project_settings/deadline.json   |  2 --
 .../projects_schema/schema_project_deadline.json       | 10 ----------
 3 files changed, 2 insertions(+), 18 deletions(-)

diff --git a/openpype/modules/deadline/plugins/publish/submit_max_deadline.py b/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
index e99752b7ab..65d08b9ef4 100644
--- a/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
@@ -45,8 +45,6 @@ class MaxSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline,
     jobInfo = {}
     pluginInfo = {}
     group = None
-    deadline_pool = None
-    deadline_pool_secondary = None
     framePerTask = 1
     optional = True
 
@@ -91,10 +89,8 @@ class MaxSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline,
         )
         job_info.Frames = frames
 
-        job_info.Pool = instance.data.get("primaryPool",
-                                          self.deadline_pool)
-        job_info.SecondaryPool = instance.data.get("secondaryPool",
-                                                   self.deadline_pool_secondary)    # noqa
+        job_info.Pool = instance.data.get("primaryPool")
+        job_info.SecondaryPool = instance.data.get("secondaryPool")
 
         attr_values = self.get_attr_values_from_data(instance.data)
 
diff --git a/openpype/settings/defaults/project_settings/deadline.json b/openpype/settings/defaults/project_settings/deadline.json
index 0cbd323299..dec6a405a0 100644
--- a/openpype/settings/defaults/project_settings/deadline.json
+++ b/openpype/settings/defaults/project_settings/deadline.json
@@ -44,8 +44,6 @@
             "priority": 50,
             "chunk_size": 10,
             "group": "none",
-            "deadline_pool": "",
-            "deadline_pool_secondary": "",
             "framePerTask": 1
         },
         "NukeSubmitDeadline": {
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_deadline.json b/openpype/settings/entities/schemas/projects_schema/schema_project_deadline.json
index 9906939cc7..29551cc9f8 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_deadline.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_deadline.json
@@ -246,16 +246,6 @@
                             "key": "group",
                             "label": "Group Name"
                         },
-                        {
-                            "type": "text",
-                            "key": "deadline_pool",
-                            "label": "Deadline pool"
-                        },
-                        {
-                            "type": "text",
-                            "key": "deadline_pool_secondary",
-                            "label": "Deadline pool (secondary)"
-                        },
                         {
                             "type": "number",
                             "key": "framePerTask",

From 44120036bf8d8c45fd89cae46837cbe8088c63ed Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Tue, 21 Mar 2023 16:03:40 +0800
Subject: [PATCH 063/151] clean up setting

---
 openpype/settings/defaults/project_settings/deadline.json  | 3 +--
 .../schemas/projects_schema/schema_project_deadline.json   | 7 +------
 2 files changed, 2 insertions(+), 8 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/deadline.json b/openpype/settings/defaults/project_settings/deadline.json
index dec6a405a0..fdd70f1a44 100644
--- a/openpype/settings/defaults/project_settings/deadline.json
+++ b/openpype/settings/defaults/project_settings/deadline.json
@@ -43,8 +43,7 @@
             "use_published": true,
             "priority": 50,
             "chunk_size": 10,
-            "group": "none",
-            "framePerTask": 1
+            "group": "none"
         },
         "NukeSubmitDeadline": {
             "enabled": true,
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_deadline.json b/openpype/settings/entities/schemas/projects_schema/schema_project_deadline.json
index 29551cc9f8..d8b5e4dc1f 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_deadline.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_deadline.json
@@ -239,17 +239,12 @@
                         {
                             "type": "number",
                             "key": "chunk_size",
-                            "label": "Chunk Size"
+                            "label": "Frame per Task"
                         },
                         {
                             "type": "text",
                             "key": "group",
                             "label": "Group Name"
-                        },
-                        {
-                            "type": "number",
-                            "key": "framePerTask",
-                            "label": "Frame Per Task"
                         }
                     ]
                 },

From 828f59bfb55e10c2c207c98eab7d6f1184d2826e Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Tue, 21 Mar 2023 16:37:58 +0800
Subject: [PATCH 064/151] clean up attributes

---
 .../modules/deadline/plugins/publish/submit_max_deadline.py  | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/openpype/modules/deadline/plugins/publish/submit_max_deadline.py b/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
index 65d08b9ef4..dec4bcc500 100644
--- a/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
@@ -40,13 +40,10 @@ class MaxSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline,
 
     use_published = True
     priority = 50
-    tile_priority = 50
-    chunkSize = 1
+    chunk_size = 1
     jobInfo = {}
     pluginInfo = {}
     group = None
-    framePerTask = 1
-    optional = True
 
     @classmethod
     def apply_settings(cls, project_settings, system_settings):

From 71a28cb76048d0fa057f2ec6ede62fe84fe54587 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 21 Mar 2023 10:09:36 +0100
Subject: [PATCH 065/151] Scene inventory: Fix code errors when "not found"
 entries are found (#4594)

* Avoid VersionDelegate error if version value is not set, e.g. for NOT FOUND instances

* Ignore items without `representation` data

* Add not found items per container into the model like regular containers

* Do not provide set version + remove options for NOT FOUND items
---
 openpype/tools/sceneinventory/model.py | 16 ++++++++--------
 openpype/tools/sceneinventory/view.py  |  7 +++++++
 openpype/tools/utils/delegates.py      |  8 +++++---
 3 files changed, 20 insertions(+), 11 deletions(-)

diff --git a/openpype/tools/sceneinventory/model.py b/openpype/tools/sceneinventory/model.py
index 680dfd5a51..63d2945145 100644
--- a/openpype/tools/sceneinventory/model.py
+++ b/openpype/tools/sceneinventory/model.py
@@ -327,7 +327,7 @@ class InventoryModel(TreeModel):
                 project_name, repre_id
             )
             if not representation:
-                not_found["representation"].append(group_items)
+                not_found["representation"].extend(group_items)
                 not_found_ids.append(repre_id)
                 continue
 
@@ -335,7 +335,7 @@ class InventoryModel(TreeModel):
                 project_name, representation["parent"]
             )
             if not version:
-                not_found["version"].append(group_items)
+                not_found["version"].extend(group_items)
                 not_found_ids.append(repre_id)
                 continue
 
@@ -348,13 +348,13 @@ class InventoryModel(TreeModel):
 
             subset = get_subset_by_id(project_name, version["parent"])
             if not subset:
-                not_found["subset"].append(group_items)
+                not_found["subset"].extend(group_items)
                 not_found_ids.append(repre_id)
                 continue
 
             asset = get_asset_by_id(project_name, subset["parent"])
             if not asset:
-                not_found["asset"].append(group_items)
+                not_found["asset"].extend(group_items)
                 not_found_ids.append(repre_id)
                 continue
 
@@ -380,11 +380,11 @@ class InventoryModel(TreeModel):
 
             self.add_child(group_node, parent=parent)
 
-            for _group_items in group_items:
+            for item in group_items:
                 item_node = Item()
-                item_node["Name"] = ", ".join(
-                    [item["objectName"] for item in _group_items]
-                )
+                item_node.update(item)
+                item_node["Name"] = item.get("objectName", "NO NAME")
+                item_node["isNotFound"] = True
                 self.add_child(item_node, parent=group_node)
 
         for repre_id, group_dict in sorted(grouped.items()):
diff --git a/openpype/tools/sceneinventory/view.py b/openpype/tools/sceneinventory/view.py
index a04171e429..3279be6094 100644
--- a/openpype/tools/sceneinventory/view.py
+++ b/openpype/tools/sceneinventory/view.py
@@ -80,9 +80,16 @@ class SceneInventoryView(QtWidgets.QTreeView):
         self.setStyleSheet("QTreeView {}")
 
     def _build_item_menu_for_selection(self, items, menu):
+
+        # Exclude items that are "NOT FOUND" since setting versions, updating
+        # and removal won't work for those items.
+        items = [item for item in items if not item.get("isNotFound")]
+
         if not items:
             return
 
+        # An item might not have a representation, for example when an item
+        # is listed as "NOT FOUND"
         repre_ids = {
             item["representation"]
             for item in items
diff --git a/openpype/tools/utils/delegates.py b/openpype/tools/utils/delegates.py
index d76284afb1..fa69113ef1 100644
--- a/openpype/tools/utils/delegates.py
+++ b/openpype/tools/utils/delegates.py
@@ -30,9 +30,11 @@ class VersionDelegate(QtWidgets.QStyledItemDelegate):
     def displayText(self, value, locale):
         if isinstance(value, HeroVersionType):
             return lib.format_version(value, True)
-        assert isinstance(value, numbers.Integral), (
-            "Version is not integer. \"{}\" {}".format(value, str(type(value)))
-        )
+        if not isinstance(value, numbers.Integral):
+            # For cases where no version is resolved like NOT FOUND cases
+            # where a representation might not exist in current database
+            return
+
         return lib.format_version(value)
 
     def paint(self, painter, option, index):

From a0c599203e992b8aea3f7898ce040362e3c11032 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 21 Mar 2023 10:42:06 +0100
Subject: [PATCH 066/151] Global: add tags field to thumbnail representation
 (#4660)

* Fix add tags field to thumbnail representation

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 .../plugins/publish/preintegrate_thumbnail_representation.py    | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/openpype/plugins/publish/preintegrate_thumbnail_representation.py b/openpype/plugins/publish/preintegrate_thumbnail_representation.py
index b88ccee9dc..1c95b82c97 100644
--- a/openpype/plugins/publish/preintegrate_thumbnail_representation.py
+++ b/openpype/plugins/publish/preintegrate_thumbnail_representation.py
@@ -60,6 +60,8 @@ class PreIntegrateThumbnails(pyblish.api.InstancePlugin):
         if not found_profile:
             return
 
+        thumbnail_repre.setdefault("tags", [])
+
         if not found_profile["integrate_thumbnail"]:
             if "delete" not in thumbnail_repre["tags"]:
                 thumbnail_repre["tags"].append("delete")

From 55b984dc66c4948b793033afe27e111047b62ae1 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Tue, 21 Mar 2023 17:45:35 +0800
Subject: [PATCH 067/151] scene length setting for 3dsmax

---
 openpype/hosts/max/api/lib.py      | 127 +++++++++++++++++++++++++++++
 openpype/hosts/max/api/menu.py     |  21 ++++-
 openpype/hosts/max/api/pipeline.py |   5 ++
 3 files changed, 152 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/max/api/lib.py b/openpype/hosts/max/api/lib.py
index 4fb750d91b..f1d1f91dd1 100644
--- a/openpype/hosts/max/api/lib.py
+++ b/openpype/hosts/max/api/lib.py
@@ -6,6 +6,14 @@ from pymxs import runtime as rt
 from typing import Union
 import contextlib
 
+from openpype.client import (
+    get_project,
+    get_asset_by_name
+)
+from openpype.pipeline import legacy_io
+
+from openpype.pipeline.context_tools import get_current_project_asset
+
 
 JSON_PREFIX = "JSON::"
 
@@ -157,6 +165,125 @@ def get_multipass_setting(project_setting=None):
                            ["multipass"])
 
 
+def set_scene_resolution(width, height):
+    """Set the render resolution
+
+    Args:
+        width(int): value of the width
+        height(int): value of the height
+
+    Returns:
+        None
+
+    """
+    rt.renderWidth = width
+    rt.renderHeight = height
+
+
+def reset_scene_resolution():
+    """Apply the scene resolution from the project definition
+
+    scene resolution can be overwritten by an asset if the asset.data contains
+    any information regarding scene resolution .
+
+    Returns:
+        None
+    """
+    project_name = legacy_io.active_project()
+    project_doc = get_project(project_name)
+    project_data = project_doc["data"]
+    asset_data = get_current_project_asset()["data"]
+
+    # Set project resolution
+    width_key = "resolutionWidth"
+    height_key = "resolutionHeight"
+    proj_width_key = project_data.get(width_key, 1920)
+    proj_height_key = project_data.get(height_key, 1080)
+
+    width = asset_data.get(width_key, proj_width_key)
+    height = asset_data.get(height_key, proj_height_key)
+
+    set_scene_resolution(width, height)
+
+
+def get_frame_range():
+    """Get the current assets frame range and handles."""
+    # Set frame start/end
+    project_name = legacy_io.active_project()
+    asset_name = legacy_io.Session["AVALON_ASSET"]
+    asset = get_asset_by_name(project_name, asset_name)
+
+    frame_start = asset["data"].get("frameStart")
+    frame_end = asset["data"].get("frameEnd")
+    # Backwards compatibility
+    if frame_start is None or frame_end is None:
+        frame_start = asset["data"].get("edit_in")
+        frame_end = asset["data"].get("edit_out")
+
+    if frame_start is None or frame_end is None:
+        return
+
+    handles = asset["data"].get("handles") or 0
+    handle_start = asset["data"].get("handleStart")
+    if handle_start is None:
+        handle_start = handles
+
+    handle_end = asset["data"].get("handleEnd")
+    if handle_end is None:
+        handle_end = handles
+
+    return {
+        "frameStart": frame_start,
+        "frameEnd": frame_end,
+        "handleStart": handle_start,
+        "handleEnd": handle_end
+    }
+
+
+def reset_frame_range(fps=True):
+    """Set frame range to current asset
+
+    Args:
+        animationRange: A System Global variable which lets you get and
+        set an Interval value that defines the start and end frames
+        of the Active Time Segment.
+        frameRate: A System Global variable which lets you get
+        and set an Integer value that defines the current
+        scene frame rate in frames-per-second.
+    """
+    if fps:
+        fps_number = float(legacy_io.Session.get("AVALON_FPS",
+                                                 25))
+        rt.frameRate = fps_number
+
+    frame_range = get_frame_range()
+
+    frame_start = frame_range["frameStart"] - int(frame_range["handleStart"])
+    frame_end = frame_range["frameEnd"] + int(frame_range["handleEnd"])
+
+    frange_cmd = f"animationRange = interval {frame_start} {frame_end}"
+
+    rt.execute(frange_cmd)
+
+
+def set_context_setting():
+    """Apply the project settings from the project definition
+
+    Settings can be overwritten by an asset if the asset.data contains
+    any information regarding those settings.
+
+    Examples of settings:
+        frame range
+        resolution
+
+    Returns:
+        None
+    """
+    reset_scene_resolution()
+
+    reset_frame_range()
+
+
 def get_max_version():
     """
     Args:
diff --git a/openpype/hosts/max/api/menu.py b/openpype/hosts/max/api/menu.py
index 5c273b49b4..fdac5eba09 100644
--- a/openpype/hosts/max/api/menu.py
+++ b/openpype/hosts/max/api/menu.py
@@ -4,7 +4,7 @@ from qtpy import QtWidgets, QtCore
 from pymxs import runtime as rt
 
 from openpype.tools.utils import host_tools
-
+from openpype.hosts.max.api import lib
 
 class OpenPypeMenu(object):
     """Object representing OpenPype menu.
@@ -107,6 +107,17 @@ class OpenPypeMenu(object):
         workfiles_action = QtWidgets.QAction("Work Files...", openpype_menu)
         workfiles_action.triggered.connect(self.workfiles_callback)
         openpype_menu.addAction(workfiles_action)
+
+        openpype_menu.addSeparator()
+
+        res_action = QtWidgets.QAction("Set Resolution", openpype_menu)
+        res_action.triggered.connect(self.resolution_callback)
+        openpype_menu.addAction(res_action)
+
+        frame_action = QtWidgets.QAction("Set Frame Range", openpype_menu)
+        frame_action.triggered.connect(self.frame_range_callback)
+        openpype_menu.addAction(frame_action)
+
         return openpype_menu
 
     def load_callback(self):
@@ -128,3 +139,11 @@ class OpenPypeMenu(object):
     def workfiles_callback(self):
         """Callback to show Workfiles tool."""
         host_tools.show_workfiles(parent=self.main_widget)
+
+    def resolution_callback(self):
+        """Callback to reset scene resolution"""
+        return lib.reset_scene_resolution()
+
+    def frame_range_callback(self):
+        """Callback to reset frame range"""
+        return lib.reset_frame_range()
diff --git a/openpype/hosts/max/api/pipeline.py b/openpype/hosts/max/api/pipeline.py
index f8a7b8ea5c..dacc402318 100644
--- a/openpype/hosts/max/api/pipeline.py
+++ b/openpype/hosts/max/api/pipeline.py
@@ -50,6 +50,11 @@ class MaxHost(HostBase, IWorkfileHost, ILoadHost, INewPublisher):
 
         self._has_been_setup = True
 
+        def context_setting():
+            return lib.set_context_setting()
+        rt.callbacks.addScript(rt.Name('systemPostNew'),
+                               context_setting)
+
     def has_unsaved_changes(self):
         # TODO: how to get it from 3dsmax?
         return True

From b8ce4b71e2fdd7786d0cb14b5b6c1bf91b5e6851 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Tue, 21 Mar 2023 11:20:32 +0100
Subject: [PATCH 068/151] hiero: fix padding in workfile input

---
 openpype/hosts/hiero/api/plugin.py | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/hiero/api/plugin.py b/openpype/hosts/hiero/api/plugin.py
index 07457db1a4..5ca901caaa 100644
--- a/openpype/hosts/hiero/api/plugin.py
+++ b/openpype/hosts/hiero/api/plugin.py
@@ -146,6 +146,8 @@ class CreatorWidget(QtWidgets.QDialog):
         return " ".join([str(m.group(0)).capitalize() for m in matches])
 
     def create_row(self, layout, type, text, **kwargs):
+        value_keys = ["setText", "setCheckState", "setValue", "setChecked"]
+
         # get type attribute from qwidgets
         attr = getattr(QtWidgets, type)
 
@@ -167,14 +169,27 @@ class CreatorWidget(QtWidgets.QDialog):
 
         # assign the created attribute to variable
         item = getattr(self, attr_name)
+
+        # set attributes to item which are not values
         for func, val in kwargs.items():
+            if func in value_keys:
+                continue
+
             if getattr(item, func):
+                log.debug("Setting {} to {}".format(func, val))
                 func_attr = getattr(item, func)
                 if isinstance(val, tuple):
                     func_attr(*val)
                 else:
                     func_attr(val)
 
+        # set values to item
+        for value_item in value_keys:
+            if value_item not in kwargs:
+                continue
+            if getattr(item, value_item):
+                getattr(item, value_item)(kwargs[value_item])
+
         # add to layout
         layout.addRow(label, item)
 
@@ -276,8 +291,11 @@ class CreatorWidget(QtWidgets.QDialog):
             elif v["type"] == "QSpinBox":
                 data[k]["value"] = self.create_row(
                     content_layout, "QSpinBox", v["label"],
-                    setValue=v["value"], setMinimum=0,
+                    setValue=v["value"],
+                    setDisplayIntegerBase=10000,
+                    setRange=(0, 99999), setMinimum=0,
                     setMaximum=100000, setToolTip=tool_tip)
+
         return data
 
 

From a24dcd207cceb8959a832a3c576a59bba0200064 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Tue, 21 Mar 2023 18:53:12 +0800
Subject: [PATCH 069/151] renaming chunksize variablesd

---
 .../modules/deadline/plugins/publish/submit_max_deadline.py   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/modules/deadline/plugins/publish/submit_max_deadline.py b/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
index dec4bcc500..c728b6b9c7 100644
--- a/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_max_deadline.py
@@ -54,7 +54,7 @@ class MaxSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline,
                                          cls.use_published)
         cls.priority = settings.get("priority",
                                     cls.priority)
-        cls.chunkSize = settings.get("chunk_size", cls.chunkSize)
+        cls.chuck_size = settings.get("chunk_size", cls.chunk_size)
         cls.group = settings.get("group", cls.group)
 
     def get_job_info(self):
@@ -253,7 +253,7 @@ class MaxSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline,
                       minimum=1,
                       maximum=50,
                       decimals=0,
-                      default=cls.chunkSize,
+                      default=cls.chunk_size,
                       label="Frame Per Task"),
 
             TextDef("group",

From ba6135f49e7b0e1c8794f681b58a887e39a368e5 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Tue, 21 Mar 2023 14:05:00 +0100
Subject: [PATCH 070/151] Nuke: removing frame-range data

---
 .../nuke/plugins/publish/collect_backdrop.py  | 32 ++-----------------
 1 file changed, 2 insertions(+), 30 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/publish/collect_backdrop.py b/openpype/hosts/nuke/plugins/publish/collect_backdrop.py
index 8eaefa6854..7d51af7e9e 100644
--- a/openpype/hosts/nuke/plugins/publish/collect_backdrop.py
+++ b/openpype/hosts/nuke/plugins/publish/collect_backdrop.py
@@ -51,38 +51,10 @@ class CollectBackdrops(pyblish.api.InstancePlugin):
         instance.data["label"] = "{0} ({1} nodes)".format(
             bckn.name(), len(instance.data["transientData"]["childNodes"]))
 
-        instance.data["families"].append(instance.data["family"])
-
-        # Get frame range
-        handle_start = instance.context.data["handleStart"]
-        handle_end = instance.context.data["handleEnd"]
-        first_frame = int(nuke.root()["first_frame"].getValue())
-        last_frame = int(nuke.root()["last_frame"].getValue())
-
         # get version
         version = instance.context.data.get('version')
 
-        if not version:
-            raise RuntimeError("Script name has no version in the name.")
+        if version:
+            instance.data['version'] = version
 
-        instance.data['version'] = version
-
-        # Add version data to instance
-        version_data = {
-            "handles": handle_start,
-            "handleStart": handle_start,
-            "handleEnd": handle_end,
-            "frameStart": first_frame + handle_start,
-            "frameEnd": last_frame - handle_end,
-            "version": int(version),
-            "families": [instance.data["family"]] + instance.data["families"],
-            "subset": instance.data["subset"],
-            "fps": instance.context.data["fps"]
-        }
-
-        instance.data.update({
-            "versionData": version_data,
-            "frameStart": first_frame,
-            "frameEnd": last_frame
-        })
         self.log.info("Backdrop instance collected: `{}`".format(instance))

From 6f16f3e4f402ff37fd6c8264615d856a6cea67f4 Mon Sep 17 00:00:00 2001
From: Sharkitty <81646000+Sharkitty@users.noreply.github.com>
Date: Tue, 21 Mar 2023 14:22:23 +0000
Subject: [PATCH 071/151] Enhancement kitsu note with exceptions (#4537)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Enhancement: Allowing kitsu not status exceptions

* Update openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py

Co-authored-by: Félix David <felixg.david@gmail.com>

* adding equal/not equal option

* Making equal/not equal option available at for every list item

* Changed  into , renamed  into , added documentation

* Using upper cases during check, so the new settings aren't case sensitive

* Linting little detail

* Renaming Equality into Condition, new screenshot with both equal and not equal shown on it

* Update website/docs/module_kitsu.md

README adjustments

Co-authored-by: Félix David <felixg.david@gmail.com>

* Changes needed to resolve conflict

* Changing context into instance where appropriate

* Minor change to avoid changing a line that doesn't need to be changed

* Turning exceptions into conditions. Making checks positive instead of negative. Changing implementation based on suggestions.

---------

Co-authored-by: Félix David <felixg.david@gmail.com>
---
 .../plugins/publish/integrate_kitsu_note.py   |  22 +++++++++++----
 .../defaults/project_settings/kitsu.json      |   1 +
 .../projects_schema/schema_project_kitsu.json |  26 ++++++++++++++++++
 .../assets/integrate_kitsu_note_settings.png  | Bin 0 -> 30524 bytes
 website/docs/module_kitsu.md                  |  12 ++++++++
 5 files changed, 56 insertions(+), 5 deletions(-)
 create mode 100644 website/docs/assets/integrate_kitsu_note_settings.png

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index cf36bbc4fe..6fda32d85f 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -14,6 +14,7 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
     # status settings
     set_status_note = False
     note_status_shortname = "wfa"
+    status_conditions = list()
 
     # comment settings
     custom_comment_template = {
@@ -56,9 +57,19 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
 
             # Get note status, by default uses the task status for the note
             # if it is not specified in the configuration
-            note_status = kitsu_task["task_status"]["id"]
+            shortname = kitsu_task["task_status"]["short_name"].upper()
+            note_status = kitsu_task["task_status_id"]
 
-            if self.set_status_note:
+            # Check if any status condition is not met
+            allow_status_change = True
+            for status_cond in self.status_conditions:
+                condition = status_cond["condition"] == "equal"
+                match = status_cond["short_name"].upper() == shortname
+                if match and not condition or condition and not match:
+                    allow_status_change = False
+                    break
+
+            if self.set_status_note and allow_status_change:
                 kitsu_status = gazu.task.get_task_status_by_short_name(
                     self.note_status_shortname
                 )
@@ -82,10 +93,11 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
                 self.log.debug("Comment is `{}`".format(publish_comment))
 
             # Add comment to kitsu task
-            task_id = kitsu_task["id"]
-            self.log.debug("Add new note in taks id {}".format(task_id))
+            self.log.debug(
+                "Add new note in tasks id {}".format(kitsu_task["id"])
+            )
             kitsu_comment = gazu.task.add_comment(
-                task_id, note_status, comment=publish_comment
+                kitsu_task, note_status, comment=publish_comment
             )
 
             instance.data["kitsu_comment"] = kitsu_comment
diff --git a/openpype/settings/defaults/project_settings/kitsu.json b/openpype/settings/defaults/project_settings/kitsu.json
index 11c138e8e5..0638450595 100644
--- a/openpype/settings/defaults/project_settings/kitsu.json
+++ b/openpype/settings/defaults/project_settings/kitsu.json
@@ -8,6 +8,7 @@
         "IntegrateKitsuNote": {
             "set_status_note": false,
             "note_status_shortname": "wfa",
+            "status_conditions": [],
             "custom_comment_template": {
                 "enabled": false,
                 "comment_template": "{comment}\n\n|  |  |\n|--|--|\n| version| `{version}` |\n| family | `{family}` |\n| name | `{name}` |"
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
index 7ceb979d6f..ee309f63a7 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
@@ -51,6 +51,32 @@
                         {
                             "type": "text",
                             "key": "note_status_shortname",
+                            "label": "Note shortname"
+                        },
+                        {
+                            "type": "list",
+                            "key": "status_conditions",
+                            "label": "Status conditions",
+                            "object_type": {
+                                "type": "dict",
+                                "key": "conditions_dict",
+                                "children": [
+                                    {
+                                        "type": "enum",
+                                        "key": "condition",
+                                        "label": "Condition",
+                                        "enum_items": [
+                                            {"equal": "Equal"},
+                                            {"not_equal": "Not equal"}
+                                        ]
+                                    },
+                                    {
+                                        "type": "text",
+                                        "key": "short_name",
+                                        "label": "Short name"
+                                    }
+                                ]
+                            },
                             "label": "Status shortname"
                         },
                         {
diff --git a/website/docs/assets/integrate_kitsu_note_settings.png b/website/docs/assets/integrate_kitsu_note_settings.png
new file mode 100644
index 0000000000000000000000000000000000000000..127e79ab8063dae0408f90a82d6bb4b5e233ed47
GIT binary patch
literal 30524
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

literal 0
HcmV?d00001

diff --git a/website/docs/module_kitsu.md b/website/docs/module_kitsu.md
index 7be2a42c45..23898fba2e 100644
--- a/website/docs/module_kitsu.md
+++ b/website/docs/module_kitsu.md
@@ -38,6 +38,18 @@ This functionality cannot deal with all cases and is not error proof, some inter
 openpype_console module kitsu push-to-zou -l me@domain.ext -p my_password
 ```
 
+## Integrate Kitsu Note
+Task status can be automatically set during publish thanks to `Integrate Kitsu Note`. This feature can be configured in:
+
+`Admin -> Studio Settings -> Project Settings -> Kitsu -> Integrate Kitsu Note`.
+
+There are three settings available:
+- `Set status on note` -> turns on and off this integrator.
+- `Note shortname` -> Which status shortname should be set automatically (Case sensitive).
+- `Status conditions` -> Conditions that need to be met for kitsu status to be changed. You can add as many conditions as you like. There are two fields to each conditions: `Condition` (Whether current status should be equal or not equal to the condition status) and `Short name` (Kitsu Shortname of the condition status).
+
+![Integrate Kitsu Note project settings](assets/integrate_kitsu_note_settings.png)
+
 ## Q&A
 ### Is it safe to rename an entity from Kitsu?
 Absolutely! Entities are linked by their unique IDs between the two databases.  

From 96e184c8ca7db7d579065e3617149a38c176ebae Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 21 Mar 2023 15:29:19 +0100
Subject: [PATCH 072/151] Integrator: Enforce unique destination transfers,
 disallow overwrites in queued transfers (#4662)

* Fix #4656: Enforce unique destination transfer in Integrator

Note that this is per instance - it doesn't validate cross-instance destinations in the context

* Use explicit DuplicateDestinationError and raise as KnownPublishError
---
 openpype/lib/file_transaction.py      | 22 +++++++++++++++++++++-
 openpype/plugins/publish/integrate.py | 16 ++++++++++++++--
 2 files changed, 35 insertions(+), 3 deletions(-)

diff --git a/openpype/lib/file_transaction.py b/openpype/lib/file_transaction.py
index fe70b37cb1..81332a8891 100644
--- a/openpype/lib/file_transaction.py
+++ b/openpype/lib/file_transaction.py
@@ -13,6 +13,16 @@ else:
     from shutil import copyfile
 
 
+class DuplicateDestinationError(ValueError):
+    """Error raised when transfer destination already exists in queue.
+
+    The error is only raised if `allow_queue_replacements` is False on the
+    FileTransaction instance and the added file to transfer is of a different
+    src file than the one already detected in the queue.
+
+    """
+
+
 class FileTransaction(object):
     """File transaction with rollback options.
 
@@ -44,7 +54,7 @@ class FileTransaction(object):
     MODE_COPY = 0
     MODE_HARDLINK = 1
 
-    def __init__(self, log=None):
+    def __init__(self, log=None, allow_queue_replacements=False):
         if log is None:
             log = logging.getLogger("FileTransaction")
 
@@ -60,6 +70,8 @@ class FileTransaction(object):
         # Backup file location mapping to original locations
         self._backup_to_original = {}
 
+        self._allow_queue_replacements = allow_queue_replacements
+
     def add(self, src, dst, mode=MODE_COPY):
         """Add a new file to transfer queue.
 
@@ -82,6 +94,14 @@ class FileTransaction(object):
                         src, dst))
                 return
             else:
+                if not self._allow_queue_replacements:
+                    raise DuplicateDestinationError(
+                        "Transfer to destination is already in queue: "
+                        "{} -> {}. It's not allowed to be replaced by "
+                        "a new transfer from {}".format(
+                            queued_src, dst, src
+                        ))
+
                 self.log.warning("File transfer in queue replaced..")
                 self.log.debug(
                     "Removed from queue: {} -> {} replaced by {} -> {}".format(
diff --git a/openpype/plugins/publish/integrate.py b/openpype/plugins/publish/integrate.py
index 6a0327ec84..760b1a6b37 100644
--- a/openpype/plugins/publish/integrate.py
+++ b/openpype/plugins/publish/integrate.py
@@ -24,7 +24,10 @@ from openpype.client import (
     get_version_by_name,
 )
 from openpype.lib import source_hash
-from openpype.lib.file_transaction import FileTransaction
+from openpype.lib.file_transaction import (
+    FileTransaction,
+    DuplicateDestinationError
+)
 from openpype.pipeline.publish import (
     KnownPublishError,
     get_publish_template_name,
@@ -170,9 +173,18 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
             ).format(instance.data["family"]))
             return
 
-        file_transactions = FileTransaction(log=self.log)
+        file_transactions = FileTransaction(log=self.log,
+                                            # Enforce unique transfers
+                                            allow_queue_replacements=False)
         try:
             self.register(instance, file_transactions, filtered_repres)
+        except DuplicateDestinationError as exc:
+            # Raise DuplicateDestinationError as KnownPublishError
+            # and rollback the transactions
+            file_transactions.rollback()
+            six.reraise(KnownPublishError,
+                        KnownPublishError(exc),
+                        sys.exc_info()[2])
         except Exception:
             # clean destination
             # todo: preferably we'd also rollback *any* changes to the database

From c42ce4e96c7d14767d1aa0a62b126ffa43ccd942 Mon Sep 17 00:00:00 2001
From: Sharkitty <hayleylalicorne@gmail.com>
Date: Wed, 1 Mar 2023 14:41:51 +0100
Subject: [PATCH 073/151] Enhancement: Adding family requirements option to
 kitsu note

---
 .../plugins/publish/integrate_kitsu_note.py   | 51 +++++++++++++++++++
 .../defaults/project_settings/kitsu.json      |  1 +
 .../projects_schema/schema_project_kitsu.json | 26 ++++++++++
 3 files changed, 78 insertions(+)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index 6fda32d85f..8e0037fcf7 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -15,6 +15,7 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
     set_status_note = False
     note_status_shortname = "wfa"
     status_conditions = list()
+    family_requirements = list()
 
     # comment settings
     custom_comment_template = {
@@ -72,6 +73,56 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
             if self.set_status_note and allow_status_change:
                 kitsu_status = gazu.task.get_task_status_by_short_name(
                     self.note_status_shortname
+        families = set()
+        for instance in context:
+            if instance.data.get('publish'):
+                families.add(instance.data['family'])
+
+        # Get note status, by default uses the task status for the note
+        # if it is not specified in the configuration
+        kitsu_task = context.data["kitsu_task"]
+        shortname = kitsu_task["task_status"]["short_name"].upper()
+        note_status = kitsu_task["task_status_id"]
+        if self.set_status_note and next(
+            (
+                False
+                for status_except in self.status_exceptions
+                if shortname == status_except["short_name"].upper()
+                and status_except["condition"] == "equal"
+                or
+                shortname != status_except["short_name"].upper()
+                and status_except["condition"] == "not_equal"
+            ),
+            True,
+        ) and next(
+            (
+                True
+                for family in families
+                if next(
+                    (
+                        False
+                        for family_req in self.family_requirements
+                        if family_req['equality'] != 'equal'
+                        and family_req['family'] == family
+                        or
+                        family_req['equality'] == 'not_equal'
+                        and family_req['family'] == family
+                    ),
+                    True,
+                )
+            ),
+            False,
+        ):
+            kitsu_status = gazu.task.get_task_status_by_short_name(
+                self.note_status_shortname
+            )
+            if kitsu_status:
+                note_status = kitsu_status
+                self.log.info("Note Kitsu status: {}".format(note_status))
+            else:
+                self.log.info(
+                    "Cannot find {} status. The status will not be "
+                    "changed!".format(self.note_status_shortname)
                 )
                 if kitsu_status:
                     note_status = kitsu_status
diff --git a/openpype/settings/defaults/project_settings/kitsu.json b/openpype/settings/defaults/project_settings/kitsu.json
index 0638450595..32c6c253c7 100644
--- a/openpype/settings/defaults/project_settings/kitsu.json
+++ b/openpype/settings/defaults/project_settings/kitsu.json
@@ -9,6 +9,7 @@
             "set_status_note": false,
             "note_status_shortname": "wfa",
             "status_conditions": [],
+            "family_requirements": [],
             "custom_comment_template": {
                 "enabled": false,
                 "comment_template": "{comment}\n\n|  |  |\n|--|--|\n| version| `{version}` |\n| family | `{family}` |\n| name | `{name}` |"
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
index ee309f63a7..c32a2cb5af 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
@@ -79,6 +79,31 @@
                             },
                             "label": "Status shortname"
                         },
+                        {
+                            "type": "list",
+                            "key": "family_requirements",
+                            "label": "Family requirements",
+                            "object_type": {
+                                "type": "dict",
+                                "key": "requirement_dict",
+                                "children": [
+                                    {
+                                        "type": "enum",
+                                        "key": "equality",
+                                        "label": "Equality",
+                                        "enum_items": [
+                                            {"equal": "Equal"},
+                                            {"not_equal": "Not equal"}
+                                        ]
+                                    },
+                                    {
+                                        "type": "text",
+                                        "key": "family",
+                                        "label": "Family"
+                                    }
+                                ]
+                            }
+                        },
                         {
                             "type": "dict",
                             "collapsible": true,
@@ -102,6 +127,7 @@
                                     "label": "Custom comment"
                                 }
                             ]
+                            }
                         }
                     ]
                 }

From b467909fd65622f524ff1ba35f2cca53cd62afab Mon Sep 17 00:00:00 2001
From: Sharkitty <hayleylalicorne@gmail.com>
Date: Wed, 1 Mar 2023 14:48:37 +0100
Subject: [PATCH 074/151] Using lower cases for families and a small fix

---
 .../modules/kitsu/plugins/publish/integrate_kitsu_note.py   | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index 8e0037fcf7..bd43fe3b7c 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -102,11 +102,11 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
                     (
                         False
                         for family_req in self.family_requirements
-                        if family_req['equality'] != 'equal'
-                        and family_req['family'] == family
+                        if family_req['equality'] == 'equal'
+                        and family_req['family'].lower() != family
                         or
                         family_req['equality'] == 'not_equal'
-                        and family_req['family'] == family
+                        and family_req['family'].lower() == family
                     ),
                     True,
                 )

From d3330f482a7e4d8945d871e13359f03938577240 Mon Sep 17 00:00:00 2001
From: Sharkitty <hayleylalicorne@gmail.com>
Date: Wed, 1 Mar 2023 15:11:56 +0100
Subject: [PATCH 075/151] Edited kitsu module readme

---
 website/docs/module_kitsu.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/website/docs/module_kitsu.md b/website/docs/module_kitsu.md
index 23898fba2e..08b7073c3d 100644
--- a/website/docs/module_kitsu.md
+++ b/website/docs/module_kitsu.md
@@ -43,10 +43,11 @@ Task status can be automatically set during publish thanks to `Integrate Kitsu N
 
 `Admin -> Studio Settings -> Project Settings -> Kitsu -> Integrate Kitsu Note`.
 
-There are three settings available:
+There are four settings available:
 - `Set status on note` -> turns on and off this integrator.
 - `Note shortname` -> Which status shortname should be set automatically (Case sensitive).
 - `Status conditions` -> Conditions that need to be met for kitsu status to be changed. You can add as many conditions as you like. There are two fields to each conditions: `Condition` (Whether current status should be equal or not equal to the condition status) and `Short name` (Kitsu Shortname of the condition status).
+- `Family requirements` -> With this option you can add requirements to which families must be pushed or not in order to have the task status set by this integrator. There are two fields for each requirements: `Equality` (Same as the above) and `Family` (name of the family concerned by this requirement). For instance, adding one item set to `Not equal` and `workfile`, would mean the task status would change if a subset from another family than workfile is published (workfile can still be included), but not if you only publish the workfile subset.
 
 ![Integrate Kitsu Note project settings](assets/integrate_kitsu_note_settings.png)
 

From 7356887df6402f5d4acfb7448a47aec5b5c33877 Mon Sep 17 00:00:00 2001
From: Sharkitty <hayleylalicorne@gmail.com>
Date: Wed, 1 Mar 2023 18:45:15 +0100
Subject: [PATCH 076/151] Renaming equality into condition, made a new
 screenshot so both equal and not equal settings are shown

---
 .../plugins/publish/integrate_kitsu_note.py   |   4 ++--
 .../projects_schema/schema_project_kitsu.json |   4 ++--
 .../assets/integrate_kitsu_note_settings.png  | Bin 30524 -> 44847 bytes
 website/docs/module_kitsu.md                  |   2 +-
 4 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index bd43fe3b7c..2c85a5f70b 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -102,10 +102,10 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
                     (
                         False
                         for family_req in self.family_requirements
-                        if family_req['equality'] == 'equal'
+                        if family_req['condition'] == 'equal'
                         and family_req['family'].lower() != family
                         or
-                        family_req['equality'] == 'not_equal'
+                        family_req['condition'] == 'not_equal'
                         and family_req['family'].lower() == family
                     ),
                     True,
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
index c32a2cb5af..ba77f2b471 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
@@ -89,8 +89,8 @@
                                 "children": [
                                     {
                                         "type": "enum",
-                                        "key": "equality",
-                                        "label": "Equality",
+                                        "key": "condition",
+                                        "label": "Condition",
                                         "enum_items": [
                                             {"equal": "Equal"},
                                             {"not_equal": "Not equal"}
diff --git a/website/docs/assets/integrate_kitsu_note_settings.png b/website/docs/assets/integrate_kitsu_note_settings.png
index 127e79ab8063dae0408f90a82d6bb4b5e233ed47..fd055942d023e2ffc12fc508cd7079eb834045c3 100644
GIT binary patch
literal 44847
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
BT7Uom

literal 30524
zcmce;WmsEXyDm!K3T?3pTC6Qlio072MS>Q0DDLhOpoSJGPSN6!AjO?PDNtO41S?iZ
zkWe5<usy^3ersK4pS8|D`#Rs*`IE`K26H}Rj7RSKeg;ImR+T5Z`{*tn9v%@$;gtp+
z-t}QTylXkPZvl5qQK9X?*9{M8kk)PB6L{M)9Qc{aQ&!JY)5Y4;$IRUd&&Jus$%@0n
z!rjWs*~8Yw6MY>f2@K-E4U%!UGV`=^ael02=VXPa0$lKNKUOhw2fldu9`o>u^6-gr
z^F4m8@>oVzOFlj}2oLWu9_ZCeE#Hi-c^_YzDKPqSn0&(6Go+YNboxc^Jw`lovd9Na
z{qB}CL(z&fjbeVzkuK%u&40X{w|>NA(lM(pKbUoo;1H{`gzDuoM#ev{OnChALFvZF
zjrPByINEoH&?KLg-Wt78h$Pips92Aq+Zy=7xA<jADqF&4$e<58`RFgecs#u7sv)0i
zS64>p+rWwdpVY_V*Kyx(zDv%=lw;MxE;*fjm*<Ob;%<ictsR{_b+%ch!u^Ez@Pp0O
zxAMKLtEX_k^u;YGUi*!uf7<{dBVSGqjxmc^u!5Bp)4nlo5AlAHn`NW_;yn2E{)ml3
zKo)kkR{hAUk(7cOy6C?cKuSRmr7-c8m8>x3oJtKeaXC(X_fEFTfZg8CDZ8id%2Xlf
zCZ{+obI=-Y>@&|9#%JQPJzciY76j6;(e-JFhTFrNYHLy3n+$)iMtKC=-C;Of8&X~#
z*??|;dy7_hWH%;Kw5ZKFnwO8y^X!;~Rw_s_UaQi*(cT_X<6`<=HAB2CV5d#9vXY1O
zr)hpH_<*Ojre?EtsvcTcsMyu@F)}(jX=(*tqRAmT;;JA3Pl6P)PYoFdz$ZMV;}67O
z`=4q4{J}1fWKU>4cGb4W$4z`ry!^R%HbD=?tqmwuMt@&qt*=`I7JIA4V`@QvmWYs$
zg@M7iv$Ipwtx6x5J2{6zaS~gygR84T7<GDLd>Ui+Vz4&qYV+s(%Y6}tAFpBUZ`puY
zxlCC>X?K-bNbkxzuI!({7e-60`pF#}=V<9bL%qGpj3P9|H)URKBU(-0vdAS~t)cF3
z+Oj$@C%5VLFLsbhkE*S&uby9{2rCCiQ>jIO|B&rb);X~12K9A1u>Dz*lE=YIrQ2nb
z)Xt-BxVf}9Z_pNXJKWD;LLOIYA})SAQ-$Ur1Oy_ZqB08#*0wG=`0D6H+?CZX&RDh=
zTGd8J)gfijIL42kkm_5{PY=EZczV{DTbP&opW_}ElHTLhia7lB>vIg9METxcfq@}R
z&d?ORk}F6z{DF~$S;(-~L8o^U(<i}`BTKN)&&|&c?PBfCZJ+tr9x5-#1X3bTv17eA
z^8I6Dl^#0<hTzIbk*V{*wR3#pJ_*Sjz>Dq|nZ(A#Aa~;|?%sN5(9-aVxJc8aLJf(u
zGiZfqBqgn(HaDjnDq5L9_AY2G&2cwbS@{x(`^UMJhoa!7wfQ#otEUqE&@ic;46n(9
zUW_lnqNuZc>rq#0`exx6+!j7taT@n`X#J-C_l44b7p)%(TI|bs7G-gk;kim!{I8<>
z!?}T{fmZ6ni{{gT-CE(R%z&qxxwszHkok|<|9@tL|D1+Osi7`Zp6=wUhDN-NlSQQh
zz3)aVwp|9D&}HsN0d2-ADn%VkThMFh>-PqxTzUNz(P?02LsOF?J~6)$T#`O;H>jYX
zaA11U_qh0Qr?qC^GQWt0jad^2m+!OB<{r8?c9W*w{ZL<~SE=0E3VuXM8P7-+$}cMF
zO;-Nq;-n?0(a2)YuXW$Juk@(|Gje(T>MgqcEul6bU5OV;W5{uiJvCLuc&z^^*GWTP
zA6cK#XC8(`T5-=;_$0J<f>o82M$_PMM56=x)8{%2T&P@nZNH)#YM5y}zi-@~@l>K{
zChN)-jfj%>Ahq4_otk29<};t8FH7N0k{5qs71M}^b=h8IQ~O=4ab?4c`voi(e-Bb8
z#V3}6PpP%kE2UNCTd?@IFxW%dJ!Rh-Gw}SUl0Lv`rB0AsHGcbYYiqwZW^C#e;sqCK
zU&b6CyEfN*Z%zJLDLOb_iB*Wt@?B<*&(FwUFDoz6P*kjHq00txTY*fpyd|ZEzkeFa
z-XSqLE%&pTt*_-PG2l0U{#=8ztEg3*v^hpRc=*tgGSvU{R*l8Fvr2=6!RNRfe7fmU
ziBsa|4jq44Sy}aMVo<+w7$T#hN5`z9$R5(>#SA&Op8O`h`TmJ^sZn`a8teA#)K}nj
zo!O@Ib;fJ`DbEF%WLKO4Bj=zC3z8s>-|sx(6=mA)8t?r5v8#`$bx-z~{C7?`P@B}L
zZYt~8fOAZJjpNLNf_z3OEci{gK$(8EVifsWFEV^8KUkw|I}_0wkS(3_`p5b~A6vyR
z*66{53<$JL-CH&JueTwhV$HQS!$BwK2}=f9{@6yO;LI2Qz1|`%0|QI{L0r%{s|ICr
zEg$*?uQxU|v5MaX*J^38>lzzJqfqvV@$sY!JFeZ(wxHUkrT~7Fy9)lCc2a!)+YaPt
zU%S=|F`sRC8<+wg`-b~#T%0;c!@;51dj|nb?QIkSFd3QEEY!E;iOZ%adYTD{c9KDz
zX9T0&Iabul+InMm)Iv0{0rd98i<O;-@F`y1!FbCLgnq4(w6?Zd@;3G490PDf6PypL
zr>V&Sg+mSxRhgKWP=~XV_9s;Z_AZ-Rk11b++};9d_jgN?&qC!(&Z&kbe}BO4QZZ*k
zW>D3vQ<K9ut)h~Oy1ab-yN<7YDO_Kwxj+W69FyzsWl(6euBvLXU}*&bx_ZVDg{B_K
zYQ<m8N*$>xurjEtQPx;p=b!bcoGEQWFQ^zaaI1w;$D)q^XtHv!jA1btKKsVYi{_-X
zwA_n}YbVU-g;RvUivF79a~ZFzD2R{WfBCKGbl}td`PS1%xH?-<Sh#UcvQUwji1f)<
z%MdQ}a&RCcyaiOvr{*x3PKHO1D0NJnWBgCCHcq-mMvUo$kiz#pUVE0+Y3Z|Cdfyae
zWluyAp5kX0p6(jC!~%5i4w<m^maG~3<oxl$GST@tR#0S2j1I^xM}yNBJ<GQ=s>J1z
zU`E;3XYlpIjUvG7$^Z{l@fC*{S1a~{B0MHX5R-*Mb?DDsPbILsVXLm)Y^<V+U#O@6
zpN4<o1N(c;dV|IScA5=mX1;hF`k=I`y?5pq0K??zE<W$MdstS_05hoZSkH28j<^#m
zIPcZ0p{dC<cmYIzO3NG#6QeL3KA+d!Ij-5_;a-&lv(0gw++U<_l<PTIjxrP=6TUP#
zHJTC^5D{3f#g&nUlYs!=wzToO;Rt@G(~QyTmx%RjI<uOY@(a{-%&{<N4Ch6dI(2jT
z7Mb{i?n7FGdhh7F1pC^0sTH{Jt8+S)T^cO4j_S$<@I%SB;unAZ0Fc5do)PNx`@_4@
zN*=22gRMZ=Vg;}wMiwhe!||52gA#X^jEF*?oD@AHdq~ZY4u>=x>w(6mk56un8<q2n
z?`~zK(%F&RlG*cZ0ajSU$mr8EW)1^m&9aOw<*pyyp)%!N{wE2H%fpgkz^o-M0!W7E
z)`g|In)9Gy%dOelX%R!f<l4(@Ogi^#Zx2~Z=QNuBsnc609uKv``bJs1tcx^jV3s;n
z>>V}<T}VO;uOp_X8%%uNpko@EHO|JFKrCpRnYF2A*|(LZQE>EWs;DG|hRPl6_0N*t
zzJVDzU8G(*9_gAgGg^S|#9==d>aHg<7IjiBkOvFC9%dR9nP0H3?OO^@FjH2OGHq>A
zR7y@n9U#eR?H$M7-LylvcJMm@HGmY^m=QoMVdGyLyqH6^J=|(40d|W+cRButYcHJ`
z+**(9BTEx+MtJ-9#EObGDaY~<%9v!Uxm8vozU7$YyioukDOg=B)<*O*hjE==%&{+q
zgs`}*)k7{_vnZ`LaOOc$GI_6*KuJk&$b(E`BH~zETiaJYi{PTrFnRu^tlRiCFSz%L
z_l+Fuka53(<T5?2x3<1+>`jl>axsOSB?PUlS^`<b;N!bca!&q=yqX%lP(r3>jI6Az
zikX??Xr-_U7E&$qcQRH5e8DdMb+~zXdV2Q@2$pY^DwC0~ISdGt16!<Lrh_3dIx80i
zHV1FOdV!p<IhkRIsq5yFY#{)SIZqmln-A^gwsqXp-;%Q{L{0zp^ne0Mm5iRgXsqh#
zOkOUhJ)fv(A%#hxY+fFxcKP$EG<Z^9?_k`bkc6U`fJjM!QlFM7%s@3v2B?|p4h}t5
zrZxeFVFm^WAa6isT?~tQdqWTiPFS{&xxKxjVSQW9=qL{vIq7pjK{=bD48u78!_kw6
z%&HDA<wALR$KY^yp3ou!0BMfmkhgDNCXrGA={Xwki^&f?d@Ium!z^PScRot{FLkBB
z5tHR(@lWBC<r?~+%EF<b%BvEeV!sdsxhqt0B;i^CJQ1@9JFe{>YBK~6HD-q)n(JRi
zhs6$Qe#9-wy%|R-Z2>ev=u)@O<@r%DS{XK%b%%-h8S52TXLv+UpN*mHhnp4=;f9w}
zedk-K?CoXY&^IXD*m!=@B3WBgXNO+6W&AtM5;wwi-W(x_yTG#<6m$vz7W|5`{gV6l
z@h=?4LyRFjIGV2D-5V3`JzQGG3%T>15BH7t?0@Eq?{@zl5aCdT@YX#q>I|k35_jWJ
zy@Ivv+Ux(PiQ|X$`VzfHBl^<~3y5B$`0~X~Dk|)>JpDL;jhH~ay}kYiaU}NVO`_v%
zLM{u%IDW?Q^JfEVt;zNUJ2~<?NvkdZC&2&}&@E8I&A35-dc8RWitNBg>l)ZcGO}=!
zjZ7b>0u@ACN$FHT#Pl(Df%;TxH}l+7{-sZXnL=Kk#lG<sAvQ{JhU^9o0a!4;EBE_5
z*`}34Oj_!0afQpT_*jzOhJ0`5qYqiZ7X|$g4$BXm(DP=yO{mL&&mG)*U5)*xIz7C+
zk|0p%(;YF_uP*`Y+Opz7BkHM@$C=XI)2*#ttKsL@h(gm($V=@NpGm@k&Jr$@897Xh
zaxt4I&*Psw+cVWtfq_Pj84E}4U_}r}C-^eNWU);q>&~$3y8b_)tbB*gX=V>%ZedYV
z7ZmO8US(BpC?NQI^6m9#dk6Gw`h<kcf?2^*?RVojZ5P*CE5TvnbZA+y)WtCaYI9pt
zcbH1MoPA2`@z?I|JbQc5`+w3F11=@{28_NIWd*4+FytvJE02Up9veQQp&6^l_Inv$
zW9e4H%Gw8@zOskRYHS=F+WPtg2d(H!-Q$e-gC7s2?gTqKZGWCxQ3rB|qq<;itv9NS
zw%Lj@bZmTFOV=>3W`gu1AyD-h5S147a&ktxd(*fz`_+UghwY0SzGyS(IN5gePG{_O
zx4YhJ)}PEV+5YSEEqwf>goFa3&A~;x<a_{>v$7B9`W#VhF9s`=SGxJN^2zwf$~O8B
zWsHXR7tGB$mX$}G$-ZL*5+;;e%CtyTkPSgsfNg^7p2c{``KL{mLA8NumS%`Z{PHDd
zYfE{2MKO|~##OyM&2W~CFti3>=>QjD0&PxBvGDQ9gvHX017+&&jlUlGs2Qn)ueMnt
zJ;iQzU3#za{sxpbgN-%0-?^SmDmaI*^R?3KTI+t`f8d5fdHRd5SGeKJBBZ2*1*D;&
z@h;8Kz-x7bhl=9H5dix=x28b=vDv^mtD<6G2Dojn&tcEEb<Y=U0MxCMn|>(zh69$3
z^;HV?ct!z1LF5aWye;o^I`FZ~5*Ov~@+B{T*`&Fu6_=OGmGpw*3m4f^@>la;(b|hc
z-iHyJdK+IE&5&B}leI{fTyYrg0RqMSrFo5rkQkD)^bM#%Ps<-W)ymQN`lu<#X5D)K
zQpHz7F-8?v_K|)hw4%8U)51UnL++^f{9Jo9-e1x3EM@ad+6eHIc*crFE>P8swdo9k
zo6xUiT(fC@2PxaTY`&tr`5C|<*04Wr<2{Yt-An-Ref^Lw7T_7bw|ck<qcbJCgX^rL
zoJ3t=fPYSw8Rvcf9!N(18=6;bSm88VUh?8sy!{Qp_7Li>7EVg<TA6*3zx5;I<At&(
zo!pkORlVk4OpHZ&p18Xzdx|oFyqi^s!(`%DF<4T13aNF!>u<j<1UjS;(+KAS<OG;P
zNmZ^<1+0=`?ip#zfygR(lq|7L%d<H;rVOIS_3sBCrE`!$d0Xn^Q=e0XEnrjY35-m_
zv`cLk76Y(*x2eXDIN~cS-CB2-b$}hSoo^E5Fi3?0R%eRC1Mlcw={`a+>F%}L3WPH5
zjYf*9syg8LM*sjdsA}LhpMCc(kcu}kBeC>(v$3(U#NAu(3)l64J@yVrl#@4FYNxuL
zN-vbsEHq!zw$Qd4(Cy?zdw(|iQ&VDQW{Eab2hy5n*q@R-IK4PJS^$7OyS2!*DtTEJ
zCJ_)%B~SIO6(z{_j+lVBc<!B}55P>ce_Velmx;^jbAbz(o1MSMsb_uc0OVn1B@2Yn
zl%bfnEMY8HYmGK20)!(CKwLQmJ4`WQ(0{Or+1W)+P1*)E&(%0Mwh=zRevwUW?w?GI
zgXIdWn9>f^kU(?`2n&-|Zg+&rd3k%`3U*(AN-=V}mnshp2A|`YTH#;Ul9EVq?@UP0
z)HO<HR8dj2N5=EQrz(=imqt2d<R=i1MCNcsu|0YKP+AWA!su*9wJ(voi(N!&M%z0s
zcVeY3!YwKNm+_@qpPkQc3xbb*=#zUkM-$W}y;O#-ik8r$%Nbo0F3*1D*|sOLdaGNC
z1qB5VYwZFo7Q428TI*_-#ZF$*TDA|#ysE#>Iv>^zf2^+No15p>y05wGmkIhwn9w>q
zj=g;!_Pd!M7cdPwJWkZOi;!yT^g6H-2j$<2Y0|%B*MF7K|7D&1ZwGwGNlU5dr?|J^
zHDvMpzb)MV?F0Y!P1@QwZvPmm6j>8woVmPg4xgONp)d{XI!JAprUWQIq_%9uxR|?Y
zd0E=a+uOn2-F?CS%334psrjEC`$%#?XVjIE=}aNbC_uIwzt(eA*-VS-G9Lx_Vq|1Y
zTK%J|;Zs9iLVGm5-O=^^Ywj#!Vw(E;U(zx%#@fI{K=~;j8#6D{*93T0VM_~*fKa`C
zPt1H|Z0r<meTAluck;WA5Mn`^$((M6c*f@Waw6(U$X9ODoEI+uj5#@05LLU@RrZLA
z77jcfT2v(82q>GJEMpF{3nR$!GDO24K`R@ZUOKV@K$mm^uL(rQHe&!ix_>Er3ZLFT
zTRJocD0(^%ckU!5kwKf9G*pXZcK+PiMpUagm2EFMH0{zbs|gOTJ6-Mnz;fvA;dm{e
zjt@(o<^ukel#&9)r)$u4a@rR4g6JcWC4gK!UgzZUVb*1#Mg9HzPXDD-DIMu|n)GMw
zE_RllTC}vr2GvalEG!@_QZ1+)5EeFtCfEc7th!H7s7c$)i}(KL(e;2d@KO3nrYOAB
zX?8*DIq8Ii&mxcoSZkeTy(LZu2(YU~lDVehm`{NA6`w!X;#g(~(;1dHeRm5#EHNQH
z?`Y1aJ}U@IMMO+2FMgGpeqlZ5Rc5nP0M!Dpn+arWJim8(rl_bGIW5S-qYi8dqSYpw
zuyX{UVnB`3*3x<oVrAi&e0v_Yx_?4;`xc<Byp6&NkIxo$hQ+dSlfCAqOk}LB_hF?Z
z{K-w|<>}4F^Tch^KP52<`QuLlpui=XQKEKGI);YLeSM1S|FXiP^OLw*g9M)>zRXMg
zvgB~5mCQf!`2fRy?VCPmtu1ep!q^M!&GF2AbI_izIPa$~46r<gJU&UW<&_#pp#c@a
z7?Vt7bkv<#UioFuZihFnw%v7q-0Cw_drH^;_RehQ)Llp0L%TtWRTDqv7G6Rbsf*Es
zyRRrmF}~vN!pj2u{It$_d3jcquZWk|9p`+*y62tGvB-5&V3vU=8bGNSG?@L+Q}p3R
z&nKrl5vtLR-Rt5cxQGA3dUPt!W<?FJYuXz`mg+#+$)n_qIWb2hw)0r5E4QkG!s~bA
zEFgPlXKn4ZzTGwy>h8G5kFFlOH*a3Nee>G8*_eq*b_v|^Mgho)eF|y`{H@r-$`xkq
zx&~z`DkK17`}zmfFLGr?{gw}E8?TUMh(mYX<A5cK_2%$;Hcrk71Xe&%LHRYH>7}I`
zYU}BJ1+aye&(VijZJqMhN=oV7J@bGbs%^vz&KO5(1q2i!X2o!d0giy7P>N)vtH^;b
zl8y7unIhxRtu6NXI<qpJa-;IBEII%=AvZ=>_D%xt4+}{OmJ8HEYdnz;$jCUydaDVN
zu9_$O0wM+2+FA(2C}(og8)#<qZT_+E#QK+&7#H09g7n|U2*Ia>9)s==U!~^;NqwM`
zwXoMOKD+G=UVaEGLQDNI-SY$Q8xvnGsi=o0khzTjZC+7PHNML{4(RHj;81?v<)^||
z3Hxc28NgN3Xoh^t$|{mNmtJ#|j_v;XYT|FV8JKd#dm2>#N!NG}>sM=>uH1kV|KBgk
z<Cq137d%+>%*U<s;lA$es|h5p{2wPxHbzyetCkYjpZK*w#`FJ(=4jT_KnhohVkmTU
z&r0cgwxI!{cDr^v#nbU+$5VX{a)6$iLiadl#LCv@z`hPW&baL)kMbOzrv~y^UTXmL
z#2BLRZ*H_?!8<mdn3Pb`8Lgtb$@@JwFAvikdtS#_0)@&On)nN}xBy!Y<jl>IqU`aX
zKR1{#_2yl?n8QQB(>EYfxc=X--`zi}^BKZoO8`(8KQTL1aZVJ*i4+FZO+XCP)=LcL
z=ufXV02*<)*C$U33eZWi)(1!rOI^kj(~3WE*3@s5CR^*TK#15R03*)MKI#Sr8W==Q
zmX_<t$zioiac^laTMm8XS6*JO;pL_M0}PO^jrO;pY^W)qf5azYQ)6pZjy=Wa|NSU|
zQ37B<_WuP>A$$1nf9e5N?uL5-N!zPdpl_&G<MF-MHa7K#TQgj+V2%GLGSpI}R$E*F
zGllBvLR(uk@ek=WjOXpGtgN3u<HXe%S`mNco|sH6N5=uODc<z><-f{|DwSnq7!YmX
zB1Ss^MA7-asRrcd8moRN;#-?4pnikmB@ah?091RBkbNNyWDkg*e))%2MTO6p;lPqk
znFJ_(`9g&gZ2|H(GFj%L5bq2Fw*tflr<Z*<ePd+%=8XanT{xv&cZ%xfdqA(A-WJr>
z)-L|$8n?W%%+JdU0iTjUnomEGTUy$#7*jKXFkVn?(|S?yrl5i&T>WS-TMNBAy#D<U
z(22~vVZ#T=MnEffVh&Nhy!;oAz+Sw4>E-EZ54;LUV~^<QCL<CCfh=TMt?#win!f5O
z3J1EU<WTJ-vNb?doSZDHU}KO_*_?y}^<!hAL<i8wp94BesM&z9i@I4`UtgqvI4>k8
z$L!=xvP*0kcoQe!8bId`*DpLjzYg$nBXy2y5C}B7T=n!MP_h+ZPIqs-yAQNiiAzdL
zU%f2}Ioxr1{f6~x>IUU}U5-hDW&)ylJp}01M#e<wa8owMD)ES-#zuB`XSisSH{0Jv
z+1#3#Dg#PkCEzd<Goyg2Z9eaDlqo@HA@{Gd0RF#cC;$-{STa`mz!n3;S==4~EdaJQ
zDO@gamJrhNP39yXnc@}B-Upf#{Qzb95FqX4C7`IHI@X&|^q(!;vcf{3cK=^=WAwH4
zRZF(uQR$gdowffv<Exr+;v1qOqb(>iG}Sc>u<@PUABK@$i1Cb;to0{97Z8vITuE0;
ziJLUiw^b=6vCq8Hc1)_Eq$En-Z&<`_xn{DgOq-jMFnip&p2d<fvPzzXlT$}NJ;vet
zN@M9MIH%aQ*&9}C`tjz8L8E)4YPP-lPhrz$xV^TWT^xYs&wqa`yL;>UBd=&Xr}IY~
z`bH332Wq7K8$fb_@V<;e<BDX6;V=<J7SrJE{wYym>d+j3G=bt5(J74jj&=I8Jv}|3
zG-B)6%Y{z9Bavk?dZE@uue#wEkBjfb%11=p;X{N<=TLQsFfr*1Kv{uacy8*3?abDA
z?2vutd97Eq0Z`rIh&5eYV9%aC)6&q$M<BHQEly+fhuw03hv=FFsQ`-&DSkc`N!CB%
z+W<N}qW?6#U|*YhXjiMZdUR5I+5WPu%rvj5=}~laY}gTiE37K@R{!{RYBmi^RQt-G
zm7bd*&vCWOb+hqFXSL@xz&)RIHrOg+{F19LrReb_Oez>l)|D#`(di<s(|k*D|8T|e
z9s~Bs=!nMRb%J5v)9p=MzYWk-fs|>;ro%q9+{J`0PM)c$sVix0R1ulc2U_qN9!k)r
z=HUUvg8NIn9n{V!SGK<n0mW~7plzhBleqb#SM%=2!iqj;smozb<U1~+-|lC}AP!D8
zIMDwF!t9RA5f*&+qci}R69%nyxhY?pOXo87f(7xYlaU^#(Wkfy`fJjoGjtu=yYxxd
z+dG-juHzk`A2Wqg5T!@;@I3(m60Xj6n)aT5tEl@y1JEYu8|u?CQ*Y}wT8WH`O#-(6
zvONTlzH8jOc!7LnbXfenfRUNynV@w{h$IJU%eMZBj2+NfZ{R+no#IUa&`4{oN9@jm
zC&25Wa7{HSA9d<Z?p4eQ?&Jp%HHz$R=)|<I77+W8`g%1<n5o>)&t?iaF91!42RK^*
zAQIeLh>K+G>`DrcPR>s9GsS#1FHVI3n9S570qA*vLdVL+HVQs+8XNib6~M4S^HMcS
z9DI18jK5aUPu_o@Uh14(w7KH=0+>EtL+!4ncDzm^7eU3N%%sK_PzWn0vH_5uX(ip2
zJ6^nwqDc9<<jG2U7x|IGRL8-vS#el3fRl}7a$@xWHTYk#*}`>1V?Z|Gin!(yTVIO(
z;>8yRw5~?fmzWsN+PXTn4y4u~q%YjbdmB;YR&UrPd(+_CV-=wL2hb1$ef9Dt#3L0|
zEC#XZ(zk*E02FFa$Oky|0I9P7_~2nCq8`0xeeVE60(31Vqw3Jpjk;m6G@7~NIaOm1
z8jV&Edt=Z?qGHnErbg||OdMO%w9}8<QddX+Ghr`10CNpVte$XgLM}az(aWLCzbiib
zM9e#nhXo&*`L)nVoUCg8gTUs-&TLF;Tknn6Em{Ff4$;>xX=@8QISb-2N@b3c1$vMC
zQk1xL<mS3PjIQeK1$F&+<*?SbR%PI{=ieeaH=TbSpX*}V95<#N^LF=)lbYUV^NWpX
z2AUUl4=?5I&CaWff8)`k|J~yd|LtKX+!>`1C9_Js#2Rtq-hMvP^heAN2V0A$mLlY~
zPD89~%)eO|=$MBSbve$r{hj*>M5{1g3EyW6;_9NSAN!iN1L#3R`Ap_$-@Fl{yvg^B
z?b0e+ut}NVYFV6ia@1j%<p#WP8#_7`T-?jESj$QQ{9e0CxZP|+xjsAjnz6KNaz4hd
zwn?Hw(A+h-uoF{gRgbKcy7<PP{PPOSK7R0>uiOFDKTZ~Wr$eN_@&)zYq>)Cp56A4+
zy=K-$J3HLkIzJII_BBb_h7Y4RN8g6c)||`GVlN6!)<lbxW0fNApoYYU$ujrPyLKE9
z7jiY?gB4Yl`=`#&{QSC^Y7Nt??I-WA6X;uwo~NS&n5}T>uc2#BYe|IVS$@UhXhn9m
z;_LI_eawZ82PPrm4r>3^7rFqoHhG^_Kd#e^j}e;K<GoRb$qPA5oRtNu(jVALkh$gx
zXNhr;`HmIFu;uZk;?<EZ*QllvomthGJFMOI8(rREXD_49UZ$JuxPCY)>bZrvv=7tD
zTuP9#9et<*!j49~YAt#r9o*plN?oUfvmcrwwv0K#*RVNg<+swvHkHViy>m^Uaa;Id
z(WRr}#FWdXZaH5u2Z?vdu*G<oX`fDz^b6dm_<WG8enDnyCHDIe;Tp55oa3d7&w-sw
za7LD`B4M`6@a4t`FnsJ!ob9~n#$-{Sv0?;KAN{ute4EX-*Zz*Lv!PUzX*VThX9%4(
zKTS;?7WGP4smJhrMZ2KjM``f~m1~?#uWrJHDWP0j%2Odz-s+~N<@8!TzKIatK*+#u
zzl0UMo|qX)QB+j)T3)|k(Ub>rN-(GR=}w8=a|6?vltOadM9F4*J?i~uHP6P2q)I8_
zQZx#1CE7m_g`>^O2|_k0Get06^M!RV#2eE+bfUa&pnbZ%yq!W`)w!L=Ss?*zScu`Q
z3R#v|PoAgcbGhJV=NG|?pCRN^1NYa1Tgps(<jp-#xhPm??~kYn9zne3$`@-yYJ{yc
zdU>9lca_(KgM*#n-|9St4^~zpA}gs367P*5N1ubeOw%M`{tD<5FO!Dt&%+Qjt;*QK
z1*J$X;rUh@-F!NFvbt<2e0%+YRni5-`85eFHSZzAC~g7GNMs#PkEm~X`tvKM2PYLh
zPtW11pq)rT-8v|mrBH}>r@2<9fY}5OE60vq^lzVIkKI$+nz#hagX#4JA!@B@1>GH#
zaI2Gp!DujIlD6VWg-SLny}DDfT5L-qN6KO$36~qvkoxps!NwiqbE>KRWob%Hjd7z<
zr-+e-Nw7E=R;?CX%dEmxC*~PYu4@V_Gd+?>fSN6KEuCkKSZ>7sRm1!%iLcKL!8sR%
z+OxSj4cXu|uQgsL6M9ft_C-{bCJ#Lahtkh`$YEy2pV;N_eeLsvU0_~Uy$h8!-g(|S
zMpdLjz{T;ZHd-FJBTJW5bh1Wb;A!u9Sn_L!1?qj&#cHX?FKGwwc&oQ2dR^C3<)sYD
zTOR4t*PTR5KN3D%$a&PYKIC=-aQbm6dgVAN%ea6(NU*)aXyHdXk-VYHM>9gPjJ*^!
zKPhT9;N`w#Oe#bEJ5I*L0>s@4@qj1T54gZ{tEc|FSo+WgX4IE4N&o8!^0X)3GAXC2
z^rzG{FPn1tdFN&m$86$;3ZI^mMF#?@?3v?GuI-bWST9qJW{<SfSuW_m+(%%K9hAia
zy(r_+zjPA@9Z@K6m^!1UF6WX<+Goy=w*rR4N`Y;xA2LE5%)<}~kV|#c<kTdQZQxiT
zY&JXh`t`UXnhJ&Ni4`SzV1}Q~Ds6KZzB2a=>V66mi?V9^_4$d!p+=o#(?CJ?ypP-|
zzB#5AT!PvkpeY-SB>5>}l@x$FJ9=XCY^%zkkV1waYyR-?2v#H=4~`M2!;14=`YC^8
zZ1!p@XP1B7>H_WH&NqoQwyTVTG3wo;*K!+6Gzlo?YvJg2e*VOMC!301LiFn~`~Lkk
zT8YzI{<4F3aw3A>k$poGZl^0%Y<<pi=_KQ`*=Ti{>U;uPU8PWMxK@;mKYtL`mmuZo
z*3SET$n`E2`T2q6yDae}ZV6OViP~mx+eYq6u2X1RYo%^*y_Bq4J>yUAe3-Em_qyL-
zPohdiVV(EMG)lM6Y*K>#Nlz9@m^Q1Sp%|gfTL;Je`g~Z*gPFBYcYCR<eo6>{!6Gps
z(xDUUwJZ{xzK5cO$OpOw#Di{{w_0_qdhk8X84cnsD;4x(LWVL3=DI&_JBjkr<ShoU
zD5Z3IdA<fkjVlAknS63hXPXZ<4qFVyCF=#9rsB%*xu93_N_}0rJ;FO^InkaE48$ZW
z!n#<rvnbLNMoj#p7(7?bAj5+-8vK@_{zRW$1ITDw$H=&``!E%z-h?VcCWjA>`bkT=
zp9TSdCLfk-nee1p`_Ui6r27<F21c)SqDUS1RzKY>F?*~N$^(u;4D4%u;d10sQM+TB
zi6jXQa{S}l08Z4#B|v+gRT6zqcYc4lZ<0k8bLF8Odf-BPJsv@snBvbD4enYnI}dwa
zUpuoCck%h<31%P##}f59CrMUKFqyXJo}X7PZ5pNVN-)jY$C+$L>Vn4d>Db--os%5N
zWt23YkqPym&aP92=In5Aq-{LPuFhm^ovAgf@Y&Yb_`VvXqY!H1><{RGSQ4vLu;JCw
z02dF<XmPQvC+A3r8Hf8V%lbzs%KA-ulKc-v)|b79H?c;TZzlfVlyssd_{_#lw?R`>
zvBtx7qBU+g@)f~fWw>fY4%S-vD2SUY-bmwe%S(_&5cC2)MA%rwE-LsSkHd-h9Mw9H
zO8>U`9@aZ5C6K=%=7X_schK!=Fjf=DrWc5wxQMWbz;0rnNbJ8zF-j2JMn-E^JNUnv
zvgbMY0=ZAdtZL6|sh%=h&b1xWQaod`@N?v{jB2bdOmvON;J{xu<09wDp7|T}L@@ue
zerGB;*TOghR9jS(G*4<enT!~<D3MkQgHTVLMv5H>ooZl=pqkl%0-D)nbfejDLN;3k
zX8Al!j|=<fsa3DtkN^!@wanLJd!9^O!>=9fjef}fkmfy*n{v*iv4bPF?AMsrSpG&r
zg8&i=x<W#aJ8)UE-KsiKw~Pq{TmmpL3~;%>4?ax&_5WFf`v7huz~ht!G;j(X5_`=y
zQ!2Nd6V5A5LglNSu;S^d1*SRyWKW+hM)xqwZJtdrb>!g@A?mVaXG99EG7=JY=ONCj
zg~q*uuX_)q{rB3O!B%Q%Sq>gUh~(W*n`veWYIA(WQo-XnDYLo1n`v;Ph2j|A3(`{6
zl=N>;z!v#<ZG7v12?{K9Awv51KEkj2*TSV;aXkT76(`P&F{cyqb4*)J`01C+$W4SX
z0a$d}CH-&kJGV-FIO8?-JwpEoFwa;imS8UicQzx$p?uh4^xg3c1@p5cqp&t3sbZk&
zfB6S7+ss!joupHr)?m&v-Q@-Y*G~UfSzr-}4yB!S0K!3y5dt0zaGd^yH<e&0D6SMg
z&w6f$*(IYlO%*PP<)UwmBr_Hh(kR1?aBXcY2!^22!xAv^NuB<cgE{ly%KNkIYWtfW
zP&us(VHVSo-0V!nkzhI%9k;Rkwje{8d*(|gzi&!lx^&4ijk+xzq#A1&X5rnP8OKl)
zr0a&msRmH!tPdP&6@s;Ra!(1ENo@%1e%g%d9v0ZCp*?Bc)I%?}V<fe$kJs+#Vahr|
z*e>J^kVc|5_M9xQ3D#crBlUAyXf7rRY-jJLQlZeg*1>sRu}y`oPBY_B!)zYaTcL)h
z2#vKiQ#SG8Jah#R!faN)Gk3K?akc*n)v0{UUu5-ma7xx)2+{W8N*mD{$#tOxj<qFf
zUwRZM_42$FIOy5%aN+nIV2?#Cnr=-p_Zurl5<~2S4FE9M<Uf~kskTcHe6eot;xZK*
zblkaHS8;|hWfK)u%syYtCUOZFK1Ywvr|*o~NbWOZms8sEQ79DE`Pr{9sS&QrQ;PWf
z{8dKq<*C|+;o@0xoul8MDhFJmarI~}=-dxqgaiwJhHy<1A#>KN*N6sa!qsAkk%m5p
zNQYBROuAr^JMFdeo=mX28scC);SLtn#t#m{d|ue!Y}w_3!OUMJQ3bW48;yX82E+19
zgTJ|JT~2)F%|mMw1U3N~2p!BR4?vE+hkrf#lPz`m{-ZNE(4jCb)S^aoya)g>MNad7
z9_=9xO7`x<txpbqD$Tf`IAM1mq_ovms-eNpglNVtt+&5kxVxmq5X$ybf0HZKj+d-*
z)XMf3P>O!f1L@yGrc)1R+x)bFAH_Ta!1E^>_0S-1)7YIspUs&`<f3FVSFm(&9iMS<
zBeTk;M+<gp_Vhqbtwr)U-4Qf)gx-O>q{JWtR6w{#1#6RR{z<8t5G5~@DyJD;tk|4l
zFm&fUZ4{uf9m%9dPs9!dc?;755{WkVJuQIZ%gGfkQdATdYjt*9Us?&;{qfKri!AEQ
zCR#a5JXcBI(ec=~n-5sDzB>365;eCxUPpAk?D<Z#XB(Rr8CAr;n6<8c^eQpS!Hd;W
zA=9}zOE|e0f8E#TxIS_YyEDodtzxi7q=(tpyn`S$YupctHNK<%q!sp)LtaZ^d&N6i
zB`cU_wrP2SpN0X1n5BU7z_g<>u7Sp`e|(5NjI$*2bGrK>A5E_muN{i23S3&b+<f)!
z@SwYo&nk(hhs)1p)4kZu6)WECZ<Eyn(1D#cy^n-Z-OOd8!uOza)u)Wefe*&R*{wn@
zo;@u0sy2$4AMo>7!G9!biw*y<Q<r`mXqsi`2ALr%`~2j5LoZh+U(NnypzGnX_2|gR
z*ZAcJfJ({)f<knWtGx-p$yu%1S}))nC>*j!wq`Fpa!-<z^zPs>+Q_#~j~x*>Yz;;?
zFKU{b#{(@u&gN&hG$B-P=)ZcB0h>-LG+kKC<Dez}xIoTdz5E`PnR-Iq31BkCC?Z=y
zDz}&CR_9;e*~o{K>DaMKOFGimZ~6f22?!|cYM=Uf(@aUQNMdepbq^*W&$=f2u1Xjf
z)aQN!zA0jwVy4iV^~I|;dRRP25S;bp^2S0?78x?ZKM+}5wQ`-8ot(q-#=)wubi;Ot
z%kS1ZkI0E&PKLjnz#QQO8$&Ii`Rw3}s2eWrko=9$Sc#M)u^|bG`A0O5M*7Ie5Va0P
zlM|Enmu+C6a|nS}j7M>`ef^#*Eh{UFoUXJeJO{d(w(esU7CkY@Bwdry-vMYi(j{=E
z%Kq;-We`^qU8&rpr`9+~@p_M4L+&rRj@W3|d04+5a=YbaZH}#zeKbmYFmrH1ONE%H
zKA}a`J9x`(UIwtqAS+*<?*kO(hkFVRJjau!Sv2^LIB0tZzF?NiWde~$C9d7x7?^$c
z&1@jB$G>jJT1>5GaHL-75QRQ0+CV1Xpb9;x-^Aw>o;-LkJhfGg>|uUz5G}*<JDTgI
zOy^5&Egjq8ta$_NRz<1vUbR(>FD61QNW;y|4N_V>vDDpp_r{PEY|-!7to1S{?0Yus
zpo=Rr69UdQ@m;zJ8tdnR<pVQa1P*Nl>6%m=K_;#`G~M#PlA9Do4?TyU#?o<8Pj$RS
z+6`2AcWv?|G5CKSDO;bV>2ter5TIm)HPOt?NBR`<Ex%KYBC!8qqxti5(0s;Mpk}ET
ziOEPfH^=A6^o5h4CN>7*er+9x<T{NrjC2M;o4WHz9n#P78y9zw<VBL|J7aM<l+miH
zu>CCpy&72XVLM&PWaAG6p-7&zJ!N>3nS#hr2mn^?J&Y0IhaZFB%M**Gv=fIrz5>Ku
z&k^>vZhQHU!pzHyVej!tP^0qn@G7f*enH8?ogHV8MnFI_aQ?2=d`)qCw%Mhd2X+Ck
z`2IvczPq~{I4PftKp1H2XrY$m>A$ocPV3FP_0aMmaGT#ydp~ROH<xz-5_xp^K`Qpx
z5j#<*e6BzE4dA|dos!TXZ&r1+dgWMEdg_SLWWlf?%z`sUWg645xVo`Oq83YYxv|5i
z7%s@aT#o`$9L2}=)#=Y|P2R8V+^(tI;sAm?50EHY^F=T7c=Wydi-Z1T(dn0sjpk6E
zchr^cCZZLd!bMXmLC}kmC$fu;P~Gb$&7$4g{tywfA&cKt`^p&?hc6=Aw1o0$<X^Of
z$j%PkLbADS{CWvK3=Y=WoN^h-nh*Fsd$hGs7TI@~!>~?y@#L`HhGqrh-x(E=S#3A|
zY#Y(2d3iE_N$3JCD}zg<3q8F0d%zF4{;Wy&s^PDBuj5fcGBDeo78-UL7W`UOHKy$l
zUID4BRFBts{rW4{B}Nxe&@q*<LHu)vQKnd2n@-rG)(OZmF2U=w*s0+2P~aBj0^P%h
zdGu$yVc31Hz?Vg;nN4!KII#4~e|)dxe%W!wyYN$IB)rbe!ok+|GtloH&6Dq(MIaD>
zTf;|2xO?KpArOdV?X>5y<E~^6`pDt*P{<SAdSr}AySzNy5toEu7cP%C2fln^Pl#q`
zywS;NI74AY;e+Co{lWGITI^JYFsbF7|4}zNx!~a95-@9D)(}NtKymjBQiZ;&@Io2y
z;nQnXE_@(sk@X{a{(C>=2&tqOhI=}D7(9l2PFBSUW6?Hk{r7R7xFHbVu)BeS^KboE
zxKF->-9J~aRvljNu|K`~jQzy~44O4ww$^ihK4%t=`~0MG_Er2m@YE;aC`r8EZhPgs
z0`IcH(S^g`&#gm|+5Ay|IbJcQy~kcut1B6`Qa|2GsB|Y(jPz=R$a{_qjlupIH<bll
z+=w|v=2&OYGFQrRLuqh0zgh#sgDV61x^@#Er;zMcV+!5LZF=0k^}#LmTOo>~(b=Ea
ze!nx3Y?8Mlskt&K5d1~fS&}vU*Bbc)oBuTaDaS1N)hqAYy^Xi|`znt7x!=G4rf?^1
zNO+BjyM{QO8e^f|KT}11KfAz#3jlwQbA0>8yCp#Tf9|)F%UbS#<EYK+)sBIx(`D}j
zVPp8Q4~3vXUBRh4s?nHpY&?PGIeS4(Y2@qYq&uIl_J+Wt*|@<-)xWUlwU(A#QoZQh
zlT3HxXMV(%p9)cPejgt2alaD~j`D~&*^NylyLm(NRtVV-{fu!)ood|~a>&b8C?>5B
zJA84G;7U6kbAMOB-&E8j_Q3LPl;WQg`|q@oxK+Fz6pROxdcl1!KfpkUY1rnj7;o~P
zi{z^<M3HN7-GkZfC({<(F^~s%5P8!mF&htP!cqc9aFfTeqT8|JwQofD+6fe&T~~WB
zz5A6%1uIO<U7C8uKd!t>RjT#^kEx4{5xA#iM7QIrTEZD8ZWvejrpeW&qU-hv59GYz
z$OZ4K{odfjp$LBP@O|ImFG>TUHm+#HSeFB3dwkOmv`ZbuB~PvA#~bz}ooib1azpl@
z!75{m6&2`e{|SK`<Dn0lx74?O>ah-=N_Nn_uOwm~+6y$l#5|8dtz4}0X8I0i%5TrC
zo5{agVV_ewGbDNIq%O8A9++oi*7eLxhxC5!+Rdkui-a!*e-Yfy5_oV1pE%4Wy!C3!
zP<{Z#+)>x|Y25%4W*WL3`OF+`;MfmA*IDo0oFHsVJr2G|jD!Y9tby{k5Iya6Am7cG
zXExDat#`W^TQHAb3+?Y@2J&?{Q&DypJoVvXz^(|j*WKyzE;>V*K5X443bbguxnn!P
zF!Lj5S4udrpe&eNV|XPZzowM+pP=K1)IEElp&<@9(AmIVr!YZPNy{;vI5oLh@^AQJ
zl>QOPJ3E<h#0lqpeJHA;nHc@VefU%u(qBRsB%(d;Tr?Y1FJvH@%KLTZ0vcvaT&GfR
z<I;imuJ`<r3VG}L0Mlp5Psc*^?FZx!BUNtBJ{|E826pq_<xZz?)ZvO6z3Q3}{rABA
zx7ZnU+O_d;{c~M$hpg|1o_UUwE64kFD+{pu!HXV$qO(9}Qo)h>X<?UJB@=-w8o+Xn
zd=2g-zJEEy^}K0Y;K4#5p1k(x9UjE}%0$yY1m=_Hnc-UkAIzII-A;zxCa~cHMt4KV
z(xtzhzG!MayN<_dBmN4Ls_#1~2}jvHk^fRyA~Cf6V~<gT$M0IlMZ({%t5CGE&`9dD
zWb*W|qUSb^F&P!%M_2E+*PWVQ?R|2(e|b1uOy|Y1rpx)Gl>M>&W`D!JH@|+Dm#xqF
z@XlPBFEf{|$B}i{6Z=r3S6_#HjYJGx$#<M;jJDhN!}T!~1CgCxn7+2-J?zP=phL-_
z?_jS#G-o$_hOF)JReBnO?&A@=+>dKcx&B6rY^iTi<@uBA(+W;75HR@KP`nY|(<+@M
z>HrC+B{Uy#b=B94sO#0s-0ET%purI(RDw-NaV)vT4TsI;!I^Lv`a^<0`O_llwM4_5
zZuyCo^{}g?8TSpDmHe_}sU?|!j+q~&82E5~2`!P;Kn9bz8JD@xB)3OM`Sww6eT(wM
zWY_U<mfYH>uy8}HgAu-zNKUC!>cpoL@>;6A4l{GHj5n0bGfSiN3{^U26IvP){?D{E
z$<1~6xBhh&;Md89z*FxE;hab^ve>+;Uq3c0dmAF9TwDiBSs7PBlGqu;v2PmB!?%l1
z4|@(hJJmnWe``DXp}#iy&0Iq@HBOL?;9Kr;tixrhZ%jl%?XdK!*6oAzzY{@z^uRXy
zjdO4q>Qs`@=egOaRs4DdWu5G+Nk#ipwP&9%hyaT_zHQ&K0&<Lu)8d^Uu=;!QULrZp
z5-gef>lO%GJvz4VZCCyV(nwXu-5KyNi#dGBXQ{j)du%~(^Um&-zZauUbkov()0N-u
zh95_@pi!E-dTUC$a-OF@b|P5Pn`HkEth%0*?OBQ0&p0=g#Jco`3oFAmjne5A3s9Fh
zXHFeQRAHO5?O^r2zl&9-umR`T$;Ss{cMfRYl9AyTCcKEvxiNNYMYIJUFRw7;jXSLA
zd+2pB)@wF?LGva?onO62ZW1BH+FJ6e?uEQSJ;p07c0N9(o!6vNM!lz{A_xJ@j7d{;
zwE1zzO>WCD%w^88G}Y3vlQDIoXa}2hR6^x>tt0W`4do60nD#{nn)~`}hL}_Nz_z!D
zm*aPsGH!;xg`sb}i)c;v)q6=8EYPvqW_l4sr1{2Y=$SOnd<m^E?X2s)NTmY*Rqa<>
zCq7VfyY2s&jAz6bn_04tK4U5$md85ydHP9~X1?9lT@b{}t>?&b$7TZAEF`ryn0YV3
zr?~0ZMA79~il#Q{l{IHqF=n#fC-5Y^RQpHi1)Da-#l16l>ILgl$x}SGN)o)B)iy1o
zLrw1ad!<ag0RlVM=`-)y9CWYms$z)?rX;SZ3IT!h1BSV`^FI4t^^P4YR};RND4l$l
z*|N@AU67im(%h-ggD)cqdu;UG-m(uWeK_K>!6TM_!-eZ5qUcj@+U3Q-;tmOUubY3+
zoIk`cI*`Ko&`w>|)pDy>JAN?j%9=y{D=-kAq58=zk68ews{86Y#B|Z~FgS~Thg;Qv
z+vzr0%7WT*_2R9sj)(NSrG9s(a*U&sU64Tm&#?=Jh<zODF*Y$IAv{&Yfa&AUQXC!`
zZI)V0CX6y!XUXQPJ};nOsI0zINYv#nZ|1KABrC;<nBc6vwmhNM@M=bUJfLL0K-`-X
zNvCdIBs20|k~MNiGR<AC(ElCB_w8;n4L>!01z57CE2%s&<nyOA_?EoaOiBgcW@;Dn
z&Kw6uYU(gsncM2c`_+@_Q(ENGM*=E7YvuP2!;(krE-i=tddpYnXgnd_CXO@L9`)DL
zqZTz_p*JgNPqUoZAk+&iLJt+_W1K`Ijsy8dH?z8zDrV89yhkkJ>8ANWq5QDiWT8WP
zull!(FbVkXi|1|l+UwxhH}1hSZM;Bnau^Bjohu60KVjY~_H9|8yIn|dsm~BG4I>`L
z%3_Y@O}FsIKe}vTCWtda$*A5}zoF-G$oj!vW@w`2*D){LzxStz<VmU^W!|LxfqVrV
zws~eL(QJF)rR~J}+~)N7Ax0L5Hv2XA*vD?_sk_}sIDOc>H>{Fe(sE!j5HJ3~w1I4P
zDR=LCb8%V_z8hPRu4%W>GVAi<DHE~jowh$7#c7Ae56BmZLSJ@u9W6<ovHU@wKj^15
z_Te^Scv_|VP!aW>j7ol>PfEa`TgaRIZMEDz*lG`@fcC_vhIk-NysS@Yi@m>h-K!!o
z3heWwoI(G1_z`H0OsXfd`c7EI)@pXFm6^a^Q+-Vh|4zdS@hw8(^sy=pa*2IHsfK;k
z-^1zn?a&HXw+xB+&xKYmQ)xm<?hw;+)YQNi4+*@L?${Nnixs)}`1o&*Q9g@7VL}VO
zEBPxAflU*E@0>5usw|wI)2GqNcrzI<YimC>&ZMOxd3|Y6yP{voa$_uXd1ja9!(Wuw
z=(D1Sm(W7j`nOBCD3TgU!|Ev=)5EuFKQv|DoM_z?OPot79^`uYJS49vqgZXh&ZDLF
z`Y<ypZ_4$!kGu4-y4V6FKxI~+0jPHFb-zU8Z-$&k(NYSSlpfPL?d<!8nz>${lYCA{
z?{D$*@B{u*r_uRvE5Ux{=Mux&QUr5@-9=zf<L>?6gV}0;l+xVw9EglDlQhN8Ny796
ztNQr_-1e+^xBcQDwYvDl^PEY33aPkA)7O7}w6M>$*iZDvKPsk#^oO7_-qwaQWsuAH
z19THMni*AQ*2TC|ELzy+WT8W5A=^Xm1cMwmC|+|6n<>0#^VlD3IUf?kToTcWCQeLf
zVKL~Qey-M6+?4sHrJsBjf==@hgZ=$0?QgH+Z7ssG0ePsYsIZPj4p`hc&F$k?`Vk&7
z26Y@`Hv#0sqqJX4%TK$Gm1Uk2g7klzAJubK1OG)6sdRJJ{xi2wEyXbuTgUbn!)t;G
z4l);m{eVa!Qx+Y^yQJ%ZejSfJjijACmU%bp{D0G5+J0N7dh_%16W>;oz_vWo=cHt0
zw5GLYbD^WZ_G|3M8;+NwA|hkD>ztM!F1yj_$^jm}>bZ9+b@nA7*f;FKx}5EA{rsq1
z$G|L<S;`8vk3>!bzoX5KoMTVvKN8$P5*Dw*U;J<~T}VAk`|&8l@0Df6+t=T^>INe_
zg_VeZQTtr4>x`hiuY}oUOJjG@(tV(eir#j8=e8^*b3b6A$bY~~PksIyttv#`<o*59
zuFPQ6!ZmP9RTVFAz%}C2r&1U>J^kWW<>&Xl^T!T(Ge3Jac`5F@`zFYBJyU#tfNw5f
zSYplx-KwRnor!J7#b?_yrlDwDh{`s22tK^5kO!)t>de+<;qh;Z=P>stIr$5CKR5yi
z#dt&G)3b6shqB!!67N_4t|)VutBWxHBleEv`t$Rl>cqh_BK0py>FjiIm?wHK728_F
zAtm*hu2TN}=0+!CEa~Srn1m!`zOK72FPvIIADq;=3eyl>@DaZ63?oTMPw$Tw8tUR#
z0shfS<5^^=>Fq$bU4l>&`fDNMNXza|RG6a&51N+B_Ttmi3EHPCS2iZgW?3Rkahyq2
z!eV*@<j)-S)2{SCYQWHK*~NgU;+|m_*RsYV@uH%mReYa|kRb4>x`x5`J*)oX$x?kx
zkrN4x@MrX*8@}rJ4_)IyND?$v%!gBGjvK#dyq6^SfFYEaN>SbI{+BOe$k}=>r3Jn3
zLz!ZYyWgW4R>zbYE_<YQzAfUcxbZc>;MUEseS{GV+eQMq=ocU=_xi{KjkiI%XK*sN
z1{|54{fPL{EjX8AsIT9VOho;2aPSGG?J2uWz~Ly_#S_%?Xr^Iii;a;S@!enVF}>A5
zg;TI09a<HU$Rj~Yj8jRvGt$Ktbx2f9^$*dC{gg^o3o=nnUlG$@0n<`GGwvI4AzXQ<
z#AW7V{S3`zsA^{R^8G0b%RH6j|7h(zpqlEUJ&#~R5k!<CAOZp+U8I*-kRnY)y7VR`
z^xmQ(y@~X$g7hLFp%WqWDj+o>)X=LSon%h%``)~H^JdMOwI+*2xk>KLJ^Pfs|G&Kt
zUe_n<mhVYxH@usuy|3COO=vS2@e~F196{sGJG<tV<&JCOVCdgOt12m(O?`NzBmonr
zA1SsxNsi-~Xv<>=vzgbaIh)hf(LLrYnwZem`e)_hxfFbShl_X;ztw#y!TZ|3m$`}#
zHJ4xh`JA+{o0&w2z@sBGJXQJ@k!*szSTNVvPQtHnUAKn&23g&=-g*6E@P$sPt!IJ7
zX9<(K5)$NG_=1aAlF-6=xZQYr%}{~v@e|^U=ll!x>O+fCgzww*UJ=#r;Tu>CmcDcB
zwt*=+jW*}*WLfS^4|G|4IOyQ;sdKdn3lV&C<I>jFaFLncZ_)$<VgH?Q>7MwF+|sI#
zmSVF#sZv2b^upg@8<?2lTG)nxu>I%{a8pf~ARk}KBs|N5<xYnnX2Jw$bxzJO!h0lC
zGXY`N`gIlE;9p0=0U1nlza5o^a(CzmS4`m<Q8RS}qKPd1VT3V5cbCl|(}33Q#za?R
zon)Y&srKmMhuvx3c6L!mX<62dc!CrWJr7Q+JasJL04uH6z;Y<3^+qG*#$!ccY#R@6
z$&oV|5Byq+z-+XaRt<-A(seC4IW>Mw*i3-nN)McRYasqcf?X2A#fEKr>osA8g;G~`
zpL~Z$4ZqH(u!5|gtmLgp-I}c5_&1X1fSO9}72jxXz+V92l6|SImn;*zQc`nQA7Zo>
z6FJ@hr5EY0jZRHXJ%5xT;l*7%r_-xV=&9}&7Gd7EEP5Mmz0oqXKBSPiPF5x%7=x)l
z`nHj1U!jYVvw1KS^qq<I`4e>LWS|5Y;noBVy!u=~Z>qG8a#k#S9_%|dmbIs3|3T7y
zNBflx4K`fJZ$`$=&c;(g!RImY7AYxDJgOQhfs~7|R%a?2(q=l9q0)Lbqggu+cgm@|
z=mIk}^p?w{Pr~2&Ul6JqMr)(_$;jG5)^3tt2sD16oAdS5s-`Wit!bMEl_i<qzP*WE
z&tt>{5u8JL%h@dt6_2RxEv3Omp>hkSp2DO=i|srs1qITO5QQtnLL$@|_kG1DtJmC=
zwiiuo23>xqq3kR>ca|cCt*p3<%~1nvJ#{!Qu)d#JoG4);s`SH?6M^kZw97mkYj+*%
zc9)+JMpBmGeX<K$J*go}56)Cs&nscPd`aQZ3dN%p&7zsrxBgX2!{@lYesdDp)wrG+
z6$VGG)l-uHQKq8FXB|WnJtrz1M9Jd0{nFUN4BMvp8|sFoIrGhRB)8{cw3)+F5Z)3Z
zusyfJp9v#{aJI!{&v@RYQJu*Wi`0xm1SF&E?~u;wU34^U<oDRF5cyVEL(+orfs&3G
z?D5D((RazERDM^4z@b~mkaP=7PbJYN_ywmch<cWe4F|>0kDfi-b3?_XejG?^ddCWy
z@H?dIlA6$;+Oy}Cnj=-n+(il2$q_1d;43~>4H^H#*Zuogb7;$}{ti34aLvZSERWuS
z$BNu&TQ`xOW-wbxJvn^hwYMwuhDg<La;eAN>oa2rJmaU9=IVc}1|9qMb~;mTt1<LO
zPdpbNmyL!uQZCA5VK*@6paS%1>p}`E!-_4ChU!B$Qq~rteMCWKzkT7<@po}`TYgx$
z|De-CD$=qiM#iF|&eCHcl97zzesIK!aO!9}R3!Nhs)sx0mZ;fP9q*gzn2GUH4;#xA
zy_;b+edVd8PR`D>;<mKe<p&$V@pUzcY$d{o=5ZHsI&ctF;6ax&g_4(_j7LGA3{^x;
zzrvlh*wtn0CA2}25kp5)w{C>@7Hozd_M~8Wj;T8bKV~`0-%~PyKt5Q4?T*bc*@~`A
z^qV@Cdq;%_A>341a+tfya`SWNRv-DdclAKwuM~sMD<$8LQ+2m+n%kTf{?mU``A>h5
z9`{%CIKu*Hp1RPQ8-pJ8Y_|d9`t#HInlUq<R?eLHt(w-X^ro7>cUzPW7gr}gS&X#r
zk<(p-t73i1eXmvRU32qtZ%d@kbR=yUlOoW4Wl{B9G3j)4JM{dYdZ6I@8}P>}CXNm+
zo#lJ>Q29qRLgKIT<f1E!vpe?fg=&obvC;gP9REzVBwTnep`XkD*Y}shB|2k^Cy@+c
zT%PfQn2%b9)2Sg;sGSQ#_CJVvlSHH0N*b>1O3$s7f2p;~gM$IsJ_1w{-~?9G9EX~B
z(MemIrCeJKH=rY968d<fD_%seIJ0$z(EVu0&U&82CD6IApJi8-DADj{QOb$w80<Ag
zS5tX_CrHn~Gv1gri|zKk1i}+kkrbG1D5K%+eO<-}1LkD(0`CN7TPv(7z9S#d3ED9r
zWy6iY@wo-;1HA@t2@vb)zcbfa9X}u~6)5d)*n$LyM10NvaxJ3|_372KXYOE1>^9dj
z=*W=})H%Q*^iHn*Q6G|1_f99F%gn2qYxBtA{sbcIvtAJ`u6L>AiV~J7wWfQ=!gc!n
zO6tp4O-WOQE|squ)mDu4`^+v(>EdmxkOWC#>DRj$g!0aCpkPH$+Mv3QTI+5U<cqiU
z&B?moPLk=beGHhu1|e5E+1T0dJ9Xd9PJ^WR>WtNG&(puu{J!2J$|!&tDag-K90LXf
zbN$ZxL{P_qGV51wYyYEwb8@5Az7hqH<4-+;jg0+4jC6_zB1|l9YwA@Hy^yuttE&RE
zazlA~A77zh_Zwr+0O#(Xd19`+!msBUD2A2aNa|hOGF4ErtvasF%1SJh$|yA-jHk9t
zNpZT@22As{3pD*Isy4ybd(UlLy0BfFU%#q+#N_=k?T{b(h`!+oU+mAAvJMfd-*<qM
zf9-FasjCI~ZzIzqi(<2N^=2MC4<@hjn$nW$&Y|UIL<-4&4mz(K7Sv7IrJ5h?4+dRT
zq7PSFVLi+o2}bKz%CTL~P#OA#y2xhn1{tstw$|*okGOj2YUrBE!4QJo`Y7dP)B!b|
zD>?XNB?Mg&o^Mr26}l0UIm2JdbWG7Z!$3rw=fA0<^YE@TV|jk!;vdynoJpGkq$>lr
zYB@JQ|NGdvZ^-cIPiEANTW!?_=4iP@-|fKsl}|rg9j<kSyUO(p=@zLirY>nx^6>6t
zjUDy&LQfmq*7~G^LE0y=5`Q2JnA1i~q#PKnb4u|U2~YeC$n`{uA?CiR`GkckTBV&E
z5?+2gr88`!vD}!_!U{ub4%BXWv;^YEG#66Dk6c3?A=gyke&)I7Qhg$u=bZ)zE;#Zj
zHo#p?=!6`IC&dkZ*r#}f?q$RjcYEu_VH59<-&kfr0H4D?n}5sqN-2;_T<;Kq_`JHA
z1z_^&%{cHySq~-cJyvp%Qxjf6<gP)If(zq_v`abP*O-6UpK&k!GQ(NFPD(5lcx`VT
znHU%FQn{89#3;@6dlxldGTcbOhbIof*nkjzT;HZHHv6ci-a{gC`FD(0JW3kVdO(xf
zw{7UR+w38Fv|3Jj?upCFaKymC3nJM_h8Fl5Q@P!mE(<G5^-L(&eoto9aOHOYaFoYf
zbO2~5ev59}_38x!az^Rqb^ThEd$$N<TTE){2Y+;LJ3JV6WGQ-i?}Z=sac7Ay8B7*Q
z(!?T|Fta(dMj0|%8~NNs^%Jkcm8>f*<<nvp&+!vWOVVc`C+&&jQO@6Sz3z^T=n%@>
zGblR^?c!9Psz|dlQ#g|gvJo^~4Ht-He*~>eanQm8)K*$NJt#g`1$MpuQpxxBIgqU>
zfr15KfMKOQ3hn@F2>F=+Jvd7B2OuK2-e%>nbK+fQe&WN{+!)`FwkUYSnUf1w*Fw%4
zttOV5nVXl|?D6(Wxf2tS2l*Q#gG$$Cp*(OcJ-x0#;Pgv<P((DGsEGe_qkzO^#oQ+r
zlCk$p$}I}p%8-iaq@$p$+!?7N_alC@#3QXcddY;|m4jY4-HZ%D!8%odfND~|nf?(O
z9>AAimxASh@h9qNpf}&$_~G{J54{p&u>G8nwm^pwt#)Z%B36<9I{x0+1^z-Kq>dTa
z`!xr@1BpA7&sLvyD2FZEqj*K&5{Fr)y?qdQHAiOFz$mlX)+?#b>(xHrUAd$)qDZMY
zzS)i;7EvX9ya{2dkdyB%yCBk}gY}B-EDwe0d)ZeKrh2+39p&;ImZQ`_!ps95?BSsZ
z(7S6x#!ND6$WV+C*xg?nj^r(0-$9LmTtF@P*{iF(Pgpti<!f<H#BXEC72Kn_^u0zn
zARXycD|*zjVfAm8xLR})m77v1;9p$2;80X=yBh0QohOxPTR0Y*VDM#JtEZ@PLiXj$
z>zT5VCJP)Aq~}wlUz&7}3e=UFk>YeAVqzKFqxQFExBDRW3HyXa^v-dtWSGn2&+lEh
zRqtCUkdq^#9`3yb5-(L;_4k$<iv#9Vx!tK0ex|;foW=)R>4H&!SX{Lh7kiM;MY_xI
zcFn<LlzOyCVu0y~o2*Ig7e~f%61ehRxWwCZR(?g)?l{-TLP~Bje@1d6&9&%?OSbe}
zc{Gu~eZn8EDO6Va9=X}oZOH<_{OqauxeFA-EpZ_1O%yPtl{Pu6S7{4{M?^sm6XkB{
zjAl;~rV$wx*t7Jf;>`bzjBC*4?Q~`)UMkRi85)b;A(Q<^?Y?dyNuLbEJIV|P{o0jC
z_-N0^0>-R~Cca{5>t=<9jJ;1JL2;etYT<^+%;i8KA>(TLD#sEOvuVeSb?SEKxZaoF
z392%WdPM(mfe}^dJXyadVBYys*k1hbUU5%~uz=GqdGP5w)m5d(<~>fuy={VWKq_{5
zFM4x4q$?fqalfhPigXG#NFGGMe=-<{u+7CDbwhs;`Ge^DOQRIHg=V+(+ON2UMW|vh
z2A<VlV`2Wtf1hY39+%%}xkn>$vl+{cRy@{&Slv&LQPa?9!T5S7xnUmMI_j}sF0mi~
z9%3kUXakC;RxC45KY`7F6^e!BS6a=QgXpMhcfnV%vgPh-ltWSdbSE7#9D?raue|n_
zdQK=LuSPy6yyXrVK{T#dXMDhNjr!y;yBxoL>=5KAOAv--r2PE;UA^-+jyB(G`0E>Y
z=br|&1h3=2Amyd|-A%ruc_c{2KtjloWB!%AiMyTLo!0pCoQ_NlnHDZ*lvJwe-)Gsf
zW~ILaZ|i*kVAM<Zzqs+VKxW&tt&)8S!J$>yREs-R(t$x0^5SJ69uJr&Vh@@N59r?(
zFui3SWEN&aGlzi7r0y2}di4H$hH4K5hQ(>bsXO$YL(p~VUWW^}Sq7p3gQ5goZ{rs#
zR|>Dft!h&BgaFyaijvNaRc*UZ>o^%ED5pN^C~vpw+n|_otKB>znI^}E&**I5Nf%Q6
zCzw;=V`+K{T}y&!4wXTp2Vc2HFeNBXIukD6zSMzr0s98h1EF0Ee9WBc&`W%r9i%c<
z`qSiu_LZ4CtDvwItL24cY~{>Z;s$TOeKjjLH+<b{;x1?LCxAEkuU~T4CV0~W0Z(PB
z9K_NHxY%HtjaGEKEr-zO-`=wq(!f}MjG2*t7TRW&JWZ}ZICIUn@o^%dA-@LEm!oW_
z{C^<t`VFmzj!*v@jdIE9`@-KW2brvM;6#Ks$;jw_0@gTv{2vaAL-n$#6jVanW<#2P
z7333MdMEsUC;HS&XVJVgOG_QsugAa8)qHyQmk{PF2jM<)I4V&AUDzy3uS-v#n!ofc
zKr#++<^c7SYB4%p$ykk3+EBUb39thtWg}?yy$cu5zjIMt8D{%vx#meN)^m!`wL?b=
z{-Nl6|3T4%Bx2Q72-fNalo&32b)En8Ms8~8QQaP=q9Ygq<UWY?{6F&2ILR>i1T`_N
zX6_c{pZ$Zsmb+tHlVkqeL3AT)B|ug`#C}E+toT%wGnF~F%LY^8q2Mi)iz1XG-iS-?
zw1nGE`&fO#$b!3155tE{le2My=@s-4@c91lRKNni$zT3o52jvg{LUPU{+^3-9$ST6
zUEGRb@2Ye;74q(+x{Sl+X|6q63UXhy1(drKt(J(n23GuQ6|)&RbsLMyd^6k~XTaLW
z_CXk6*?HLw#iQyYIY?GjZX!)OOd9=}aB&xF5MD2_fD_!Uofi@9BEN>1lm3{Vq_`T|
z=7_a)lg9)4LR(=#1W07-<U%U@hI>{J4ewmi)3D%O8IdZ#wTcm^KB>L$HEChI4Y~DC
z2$FvEU@!nfH9*w79E{$U?x&CHeJFl;Zy0a;)D<a#wIE(XmMU{lX4tcPO$>@2yOKfy
zTiLYri(Xb6xf;3>siXF=I~g%8xx-2HdH>eSv^^<+<Q?}rgVFVckML~H87vmqjBlAU
zTj|cMiM$}C;EoAiTylkGXwn^4N}@#5P&%S6;c!#ajI8&aZ*!sNwes)lzVG8`&=KX_
zOt8bN@2va<tbJu*J2wHKu3Q=uRpyvH=<PW^P=#5mpOp8ChpiN+^dRt)2-M5JvMFJ4
zsUhOJ7YTrni59N9<9=KMCQRp}+|1=l6Ny(Z4LoQx1~+cowQMYR?aRJ;dhCs8p5|&K
z_^E>picK@Mjr_S)`_kwj2pg{6(4-m!ORG5%yHwHj$<JRf6}F3-XbPtn9=7(fI1FE$
zNjRp>%nnVa)Oz99!ne3PuqW`?kC0#TWVQCPBV$JsY*_wY$-dZns<Nn$Imd~QfhX2{
zz9*$Gd8puEE=KhxkD$>HB5H2!hq4<6`!>hi`iHkl5IAu<I=bVz90;3`P#gks@}Q-q
zg}~r4p2Ie$8qr=TXx5&5PE}QK4i4w;W;;p#P*?Y+JKFIA$@x@eD;>_Tbk9I0v?mAf
z<w>T7Mhs`crom<#nEF4Z$IDs>i{8|gGqfUp4EQZ3k&m&l@6Gk<j&>#Lwp!^qP8h&2
z%v!103vz$pxv>X(?L{^g_j(L;Un99zlBry7+nolG+;AIuH~mT<U^kST(_{M#I6tay
z==4J;Ae1|Lgf+rL+6@$QQ94BLP1H%*_Smeq6|Y{J%H`!)j&UDnum@QQA%}}X0M?Ol
z$^VM1{K0=QRj8~XoXheuU|B>}h|#xdvn`<;{n<FMm!`*j5^U37V&l$zmf!D>97`R!
zkFl)WdJW;8BE8tgpj%T-VZ3u?UAzRQB6(1WP;-DXKF=T`qIM+wkASQ<=PJ<yuV)x&
znA-YaTbD6j+sbxT#^hk1Aa2M(hib5DFxd8N9f3dN<m8+rV$Vw<wSRl0C*AkO7L%CI
zdx+%LS&^QMK0X@hrn-Y|u&aU9AOS^37w6@j)d|^FJMC+k*~D)?aOCwL#dFXhH;@<i
zmrIi3&KZe*V>OL3*rsMw=M07>5{>px@E>Ci*)Xnu=v9B|Awv~f)m)W)QLTmdT0<it
z<9-@jj&a1J<mJjINh&d5pJwO%P2>6A4ELs!t=TqphpIPmOvTM*+~iE+-6@KgnJ;0y
zb{a<u>E66@kqpK?$wEZ7V`TwgzbM&=o66SK_f8J?W`RS=LQD2SQ?pgV9s%xY0gH8<
z`f-M6cVkjj!I5-AU0pT*3SkzQr7~yhy<$Z$G%!>fcTc9<PnXmcnly*WTwbJ`oN2Yx
zA5w?Ayf<tM9yQsb+%nf-8k25Mjm}!Xt@%2mY*UwZxa;#31Ygfnx3TB^e>##@L=4%|
zL$?sHV^-MlEWXTb?Pj5=-^g4n$l1DdGnR*&`!+N4XN@&>Hnzb6ExvS#`DU9+R74w<
za;4qGrdR#Gj~t@v?!9}~g-KpO7TuSGjz8dS*f;s|C9@Qovj5(Lp)HQE?pQ@k;-~x2
zM@WfSQIW^MU#9^*Qu0OuI%v9toyFz`xglpf2kAFLqQGB9<uNREB|GH5WmNqs21Hud
zhma+&%j(qh6}~N8v<;#{!hhH$UX)w)%vcr}0q3B}gntC%-Q=u|<HE*aP1I+dfPesQ
z-S5G*>oqAiy0m^7^6~IU8PmD!t>;~*9%kEC_RV{4h{$@sx@vo?3Xh{&|FhWdzqt6C
zg_SigFYnB4Y3YVXNzZS;x4M<40Z>ID-V+S+<EdT=&neu|7y<?%0_6Oajh{ZjP_mqk
zcBx>=a-m#L?P<oZs1ZvAsS6(=I2#Vmb(Xx6zndpQ<k)o!85#b0F5B{M+O{QwkU8+S
zY*uboLQTMii$<M9&k)<(=7O*%FXso?!{p3-FKT`OUNs=`P!4nyri@k#r_yNwdDNlY
zcXd%LwQA3AEMEq<qTAp@2Qs!_`L$sGj0oF}%kTYq*^8L+VaWCept-nu*BUp8Sh=?P
zJJhL$&5f0r`ApDkGfYziyt2fgzH0MJ7{4-A5b_bi?<6=p7^s6tpiel>MmP&7$BZUw
z^CG@X(@+>P9KV}J$`MTg1|wi9ds6@Yy`4uv9e5=%zuT&4jqA$rdf%yoTp$=2k^bvA
zHYE7H2BKkU6)y=v8>do+HtbQWMP*D*jUzA9lsRF83XdJkPby+#uj6(WAmyHe?6?&K
z?sBfg^dTH&pQBY`5Sx%t?y~d(gIj=<LcxXzRV(YYv>*_?PIJR~Pv1T5=iZw$BvsgW
zy+w!-(PyLJ)YLxDosp;)IvNUIUaEjVQY?;CGO>MS<2Hnc+xH}Ez{YpMTy%hAbf0>l
z>@ze}s9POc?Y!WGyyEO2o_4$`2QgXv@cH@;n&_nJm<HdYvbhMhRdjVsEo|pWXjrJ{
zbRyd<a6$$uTvfY1O*t5(tY}T{F?YbKvl}al`7J<Fs($1kHp_iOIy^%(dUQ1K$cc-K
zYqZRm1W3GRNuU{6+dk=<CWs8<*V4HImj^D3&u@8bHXfcji&;_uf}ZQar5*s940vY?
z`pn6Lj8A`WgOY?a3AYb0{*2?g)EH|m@AR*VbN~Roa#&(p?d_gBG4JB!w)MCON<Q2J
zqi(f`l+=V$#FrTD6?YGoQ4j`VbZ<6mYe!7Bie*!*!fIEq#q79iY;5d<s*J?M_8-jt
ziEcO-;bQ&1Lm@7`3AhC~ze7!GH$YeZo}RX^5RuQn9oUxviIg;keNd3q9|*4l`SuMe
z8cfNac96edVQD{U0SLf3fR25nO8^QpCEOkrc;k|g9>zF1{H9bg5Og)U^)UH5uK_!>
zlmu+AP)y{T>!9p#k-^Xm6W7DLv}O~_8nzSPqjj9^ek@u0Ma#<VFzdIiPt?YV0w=GX
z?lZWFB|6`#oiaKCY-6&Y7&n<AGYWVNKpa<6hELPigr3_{nW|x~v65YM_VcS^wwP~k
zPrUciT_(WyGEd}ri{5l9f@U1neoXUOP3zy-gG=<#8eOaT{ne%-qku}of8uW`>Hm|z
z>2VhTUiJD3LLeM84D`_Sq!U-~Ee7}`AfcD_m<FWL=f=)*^tSQusAd4Ku)X6_WJB_g
z19zYSc^7oLH;Z}#*v25{lcgN8t@WFH&Ji>dyK)-FR;-9BPB4BDI|p#;G#~8PbQ_!M
z3OnCu5&wbE{u>jnG&%q(tX98<G8Of|WEucs=!iPXTe87>lER&kKfz)ggKG6!*XIiM
z#Z$<v8cv#wMbdHra~K1Y*Bu{+8P-Ovq2P|lI(o1}u$2?O9N<aQKS1G~NJ`>aFGv(S
z@**<u&0B)hJm+s;?^f~x%3OnKgP6^~R}6o61!T;C7>p1N^m>4HQUP*q!|JN$nxkFF
zjZ39`5-B_BOUmqhy0v#L3%95^%AEDO6rasdT?<x~e_e|1g`$8a|1#z9by4f#X$IVq
zt*(TMFqvEd{Fjih$}PZ~bu#>hWopj{&NjPU2_ixA-z<vxvt&ueAeq}iOE4;zu<-hO
z_cmX~fPiyZE~;yr|FY%b@EGO6x$JY7tE?J{l?H9$wx+XYQEkpm-l>TD7RRC%1|pY(
zW?$Em2X%C>SO{1gSIMq`A@CtF@s}AHNbAra=w2z|;N+xxgE=`o<FK-~LG%fDacp5U
zl{QRmHYNXDhZX6-zcH`3Z1_Y7{P5V_fVIJk+^k@z;i$#I9EuSGkr)v}J>nk~BRywP
z7U1akuWaDNp9WA_NKppz24@shROtf9#Gl-6GsFiXkALg3Di)!d%DCg}cF)I~3vM6k
zbl3S&$D6}Ei=d=6gwZJOHoR9rw~&L|=*uZQ9nq9|f(LcmKlnX%^Kt-sLpG%QE^nY+
zR*ICQHzbFB_Kj<IOi|SKd^$}Uf|kUayC2yMZ7lRU0EYrXhP=WO#?Jer`imNMZHFx6
z(T8129p?OOzl0xeLPq;RSaqr>f487sZ;8Wms@38GbkZmD#d{)RMv7l`jB6Bpi%L2}
z9`Fvp!pR?SdT2?hW7)_Gn}9%Rhi{+jnr_`6uZgm?_-hL_@X(aH5(4AZ6Sg(lUsUt?
zX7aQg+u7BrJA~Qn&m66;pALCjw3b<MbLGjn7Su;vLy!qsvFgY&j3Ys!b|7#<&nEsa
z=&i`QRK<DL3<alG{<vlluP!32f~hvWKoUe|GFx+{r){!xZ2s+&^U)PKTZ6TaywkB{
z@hK_DpT<c3v>uq;_qm}KZqJGXw&Co-4sZ}8MOXnEd^)IX>GO+y$rgTd@RyI=b39c@
z&dthGTMS#H!|+s-`}DdRIbaStxUfxNZlb!Pd9^|e*$VjbK6bp(px}zd-Yq%`*jl=b
z%9D6=H4U|nG5_<?2`MPs>Ui=ii4V;0WvqA4wNE4e!oEzsO6_M|_Yj(>7dh7BYoc)O
z)}(sze*#KzSq*{6&d0==#jU=drbC7Re3LLqeWjxoXq>pSgi3gFP^71ViS0LSE92uz
znUF{^I0rN%vCK70oI+nX+2Ix1pYy`t`$O=D+eRlDVRj-uVV`QBWL)RJ>4BGG<R-`n
zX+hBldRT_Do(3G;*vd%Z9U-1LfXtxlteINp^Q`g;4a>{MoCwgYa&AaV)N-a-_@sXq
zFg<5>6|;_llK1r#2Zx1=cDngI;B>!*Xf>W{3n&!vPEyX!0p=#?^Q&E$?I&IReOhVj
zJ6!QR_N9e{yohroj|^Z~^VT$pw}89Z3^iN^NjJa0Z_@%KM|k4hTcgn<Q92N$f-tS!
z%|?|lg0gtTO;S@c5|F>YcF_u(oHcEYuo=4b8l-nvphW{CXdA(C!04<>BUMoGyv(#0
ze=mpe@$b+h_c8kJr68Rk4F%6|aPj+Rodm|;H#)d9Tx54}r!jJMR{L#u|I0LqsOKi<
zWxt)bbmSFa!cmrg@ij<smHdy~OI3v<LZ5W9SPph{0=y+G{g56ktP6pjB4uC#EL4R^
zObcm-goF^tFwQcgr?q0`U_`>cqK1O4Z{RDypbDD9w+NH#+;(>KfK)}}3BcbV+aqm=
z$?xZU(p2Oka1g&9r%+JV?sB3tikjWLFYeNYXD<KZQ78sNH*gYx1O^@h>|hEuKv=Me
ziHU)<2g{xP(mU+JuS^VHyigiW?;9<%QY^4Yi2@0AHK|6o+Z*b=$12_JbJmcd;pYYe
zB)oZK+oROh+UgP0M{AEsr8rZ31et+Gt-&l{gA3gLndAB=vt~NYN$~B?^k{ZWaGwZO
z{kj!{AK&xJRSCNT`z@9FIHPB<FC!3tdo%;TJ|WSu8RzOT%xC@65PQyjmb<GhL;AhZ
zxKX$+Q$JI^?A&_I2`k7-%g@Hh-W4EW;C*Fi%dv~Z2RwiC+}6Fb1Sh11n#}U*uKcFo
z4;C<0kb4WTP}*}JRfZcuAtzHX2kHf)tMZKR-8+dNZ!INiw8)geZUO;!d`FVWpy~tA
zkGJPj?9&}KBG?ois$X3xo^apr_1PUuKkU0~S0C3A!|vSmE~WIboT?pu*tI+nVlNFh
zH#Jq)ebFh$WRJzt7-na^^ezFDb=JxfaKnIg4?M+eC#o9sQNXhsAWgysIZ~Ucdu~a2
z2y-`a_egwJTAR8Y;=Mov1cd$8zR%Xnd-5KCc!}=u)zg&UiE5^?YjLZ}t=r_y&z^h)
z@>ak$&UK5B5S<g6)N^B?T*FrNnx+|p02lt3*{h+<66W2B0Dz39AvSm7w2m1-&NT?c
z!52uMZcNG`UBBCDaY9pZ!a)^XagB&eIN*6D*)_vsUd@-1APM@>r?%%a7+>1*vJZen
z&Zh8ZRPEhr3=Pek`JF*oepn*2svm~f^8hsu@|869ZEE_M1`2wB9lbkxdyDZts|7u1
zJCOxti6~J0*&4yvHs5o_avm~%NEszrcC`|v+?Os@y<RhRJROBcM){q(!zd|Df_Et<
z<YJU4Z)v92j5rZY4e;g!Iegd==|D*4^cmx5pgZh$5(WSNXJ?A8|An1J={TOXy}Y-O
za?y7z9?>TzdhZgrEWEe`%_Ev0N@^A^KE^S2@ALCqobOZ{g36~emU9(_h=QHia0*)Z
zly?Xp`$0ghtQgopTcTlq=JI@Z^>l3WJ;GSa2?UF{I48(H+KEpH8Ly$mj}7LgZe4X$
zghc?PN0f*$wGb-04Oeqt{)AO%-8|waZa73)n4h5~2Q@?cPD^kdzs)Su`vs9H3Khho
zku`q)c_dpAb?3R*>Bva9gm0AlSozNwvK<ix-mn!7vkmyh*vkhCy7M@s{%*CE+6fee
zZFQ5&aOpN238$N!E2_lI%|=1y<5Orpq<&OVGggbiLQxhy$wS?#2Sw!JF9@?`1232-
z(o&7}WXy`P;CM6QrO8~?^fh*iu!!aRw(bw&QR;{`vFiz!-~mfg>`M}V37O`sh!O|L
z9}l;jfDly2QQ<h6NoNz^uBO+eH2l6_MK6~tcx*Rn#^MffM<E=`F!*EYkyp+_MD<>K
z+1|SD!glCjbDct++CW9#hW7~uUU_4?&q5W0!@?xK3J|1P`J)$vu>^`9N+mlI*~CPT
zrHLmlT$86)0x>W3N-{Rc;ntYHeUp#mO8WW1X764}ma>tDxl8I-B9@=Mlae!%NTr3J
zbE67zVzsrr1LwLq@>$9V1&VyA7R89mcjhcB&%Da8|6<+bV}0IGUS{~-H)vs&foSKp
z0C5G>x?Bu@kjYe98U2K(;h=}ExvgazeYuZh%B>nC7S)yQ$AR6T8Tr`0N?^^`5F&bn
zc2r>`wBv`h&?bo`_Q#G(M#+iTpiNut_gwaR1<P$9Q5BGnyVXl{;YK{`=pGMYNtA6`
za3MwBnmaGsq=8H`rUDc-*c8kPSr-Ij_8AC`i_{9$@e6KO#ZN3BwmH8{pu+beJvd+&
zHe&S}FHLiIFx!opI$Zj=&<d{4e^R&Yx%u|OUG95@2waLBlj(8QmhJfWysc5?3*f&&
zGBd%B9fO)V3H@~Kl#0%Aqve`xIC#Br&w#Khyl)%N#B#tl@(bn$u2eg-r8$DnS8?vj
zGKK7CP@z26;}0`3D|wi`P#<MilH<-@nIQr7Jq718Ksx^Gs|g?hYs>y5tHVPj9%%(q
z6;>b@{2LFEjY@;f)1qDtU(9uslEmXkJTHuvTdMlIVPN>l?nHsv_j6+6;>iZ}UIGh&
z^ubY43qvhoC?2=d3F8kzpeGXPL4>5tPrk$-04;0=n_zf;YHJeT@M!F4y*>)mC2Zm~
z3q?Pt!4P=+d9(w`M6LS;qt&X?x<A8^QrobmrpIvGu_hRP52mJO;CKl}PdK%eee1XW
z7~MVco0Ozse!hcacuzprL|L!<Zt#4$1pzw5gH4=wSoP-bm466YfyU(CG-<*4+NMN}
zjsHXSW;8F78y%D;&i`-PlIHU5?suyWL6p=$Wz6bwz`{b)ezJm-e>x$gYz-u7lP*<J
zto;X;3(wV8-0IsG&`h?-AOr*BEFN1EG8PRq>-<eX7z=ixv+$G#>#pq7vYb)7ORzGj
zyF9_3IZ|A%S3fr{sBimM2BRw&%D>!3GY14<KrxB_GtjpQ<zH!D^c4$}pgfT5pZ5rr
z-==rR@k%PLuat!df{IkJwS$v0XgeA|*lqOZR5egt*IYi|@lV?662M`(MN->s`5+2%
zN-ikgnsr+8<~_BORCTI~wYBvrRh!e9d!VH@&BiA7_F^U1UoSN{^)@GG`tN7<poy^$
z(%77mFQ0vP{YG5BR1rO>$ow^Y_F~}UX>vuvFsk_$e36DXCuT0oqm!%dEQuv<|0Mz8
zKgSkjcj_rSy<h+cPgGg(FL9Ko(bS{=ls(=@6LhIoW`+zjvv}N>nM-$zFaG5~Ec%hV
j|9A95U^9RR;UE)du`ldy^_UPgZBTfsB2)a>=-vMS9RhM$

diff --git a/website/docs/module_kitsu.md b/website/docs/module_kitsu.md
index 08b7073c3d..daa7102b79 100644
--- a/website/docs/module_kitsu.md
+++ b/website/docs/module_kitsu.md
@@ -47,7 +47,7 @@ There are four settings available:
 - `Set status on note` -> turns on and off this integrator.
 - `Note shortname` -> Which status shortname should be set automatically (Case sensitive).
 - `Status conditions` -> Conditions that need to be met for kitsu status to be changed. You can add as many conditions as you like. There are two fields to each conditions: `Condition` (Whether current status should be equal or not equal to the condition status) and `Short name` (Kitsu Shortname of the condition status).
-- `Family requirements` -> With this option you can add requirements to which families must be pushed or not in order to have the task status set by this integrator. There are two fields for each requirements: `Equality` (Same as the above) and `Family` (name of the family concerned by this requirement). For instance, adding one item set to `Not equal` and `workfile`, would mean the task status would change if a subset from another family than workfile is published (workfile can still be included), but not if you only publish the workfile subset.
+- `Family requirements` -> With this option you can add requirements to which families must be pushed or not in order to have the task status set by this integrator. There are two fields for each requirements: `Condition` (Same as the above) and `Family` (name of the family concerned by this requirement). For instance, adding one item set to `Not equal` and `workfile`, would mean the task status would change if a subset from another family than workfile is published (workfile can still be included), but not if you only publish the workfile subset.
 
 ![Integrate Kitsu Note project settings](assets/integrate_kitsu_note_settings.png)
 

From d8360b5b19cad2110efdc71a9c72d007c2c8b927 Mon Sep 17 00:00:00 2001
From: Sharkitty <hayleylalicorne@gmail.com>
Date: Wed, 8 Mar 2023 12:11:09 +0100
Subject: [PATCH 077/151] Made changes to resolve conflicts with develop.
 Changes how publisshed families are accessed.

---
 .../plugins/publish/integrate_kitsu_note.py   | 96 +++++++++----------
 1 file changed, 47 insertions(+), 49 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index 2c85a5f70b..3c3607a987 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -73,56 +73,54 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
             if self.set_status_note and allow_status_change:
                 kitsu_status = gazu.task.get_task_status_by_short_name(
                     self.note_status_shortname
-        families = set()
-        for instance in context:
-            if instance.data.get('publish'):
-                families.add(instance.data['family'])
+        families = set(
+            instance.data.get('kitsu_task')
+            for instance in context
+            if instance.data.get('publish')
+        )
 
-        # Get note status, by default uses the task status for the note
-        # if it is not specified in the configuration
-        kitsu_task = context.data["kitsu_task"]
-        shortname = kitsu_task["task_status"]["short_name"].upper()
-        note_status = kitsu_task["task_status_id"]
-        if self.set_status_note and next(
-            (
-                False
-                for status_except in self.status_exceptions
-                if shortname == status_except["short_name"].upper()
-                and status_except["condition"] == "equal"
-                or
-                shortname != status_except["short_name"].upper()
-                and status_except["condition"] == "not_equal"
-            ),
-            True,
-        ) and next(
-            (
-                True
-                for family in families
-                if next(
-                    (
-                        False
-                        for family_req in self.family_requirements
-                        if family_req['condition'] == 'equal'
-                        and family_req['family'].lower() != family
-                        or
-                        family_req['condition'] == 'not_equal'
-                        and family_req['family'].lower() == family
-                    ),
-                    True,
-                )
-            ),
-            False,
-        ):
-            kitsu_status = gazu.task.get_task_status_by_short_name(
-                self.note_status_shortname
-            )
-            if kitsu_status:
-                note_status = kitsu_status
-                self.log.info("Note Kitsu status: {}".format(note_status))
-            else:
-                self.log.info(
-                    "Cannot find {} status. The status will not be "
-                    "changed!".format(self.note_status_shortname)
+        for instance in context:
+            kitsu_task = instance.data.get("kitsu_task")
+            if not kitsu_task:
+                continue
+
+            # Get note status, by default uses the task status for the note
+            # if it is not specified in the configuration
+            kitsu_task = context.data["kitsu_task"]
+            shortname = kitsu_task["task_status"]["short_name"].upper()
+            note_status = kitsu_task["task_status_id"]
+            if self.set_status_note and next(
+                (
+                    False
+                    for status_except in self.status_exceptions
+                    if shortname == status_except["short_name"].upper()
+                    and status_except["condition"] == "equal"
+                    or
+                    shortname != status_except["short_name"].upper()
+                    and status_except["condition"] == "not_equal"
+                ),
+                True,
+            ) and next(
+                (
+                    True
+                    for family in families
+                    if next(
+                        (
+                            False
+                            for family_req in self.family_requirements
+                            if family_req['condition'] == 'equal'
+                            and family_req['family'].lower() != family
+                            or
+                            family_req['condition'] == 'not_equal'
+                            and family_req['family'].lower() == family
+                        ),
+                        True,
+                    )
+                ),
+                False,
+            ):
+                kitsu_status = gazu.task.get_task_status_by_short_name(
+                    self.note_status_shortname
                 )
                 if kitsu_status:
                     note_status = kitsu_status

From 6e13275054fc3aaedb3f5d487ef45330aee615b9 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 21 Mar 2023 16:29:46 +0100
Subject: [PATCH 078/151] Cleanup unused imports

---
 openpype/hosts/fusion/plugins/publish/extract_render_local.py | 2 --
 1 file changed, 2 deletions(-)

diff --git a/openpype/hosts/fusion/plugins/publish/extract_render_local.py b/openpype/hosts/fusion/plugins/publish/extract_render_local.py
index 673c5a3ce3..16a582032f 100644
--- a/openpype/hosts/fusion/plugins/publish/extract_render_local.py
+++ b/openpype/hosts/fusion/plugins/publish/extract_render_local.py
@@ -1,6 +1,4 @@
-import os
 import pyblish.api
-from openpype.pipeline import publish
 from openpype.hosts.fusion.api import comp_lock_and_undo_chunk
 
 

From 83aabf4c2bfed63cbaa63fab3de14d5b53668a14 Mon Sep 17 00:00:00 2001
From: Sharkitty <hayleylalicorne@gmail.com>
Date: Wed, 8 Mar 2023 12:15:00 +0100
Subject: [PATCH 079/151] Linted

---
 .../plugins/publish/integrate_kitsu_note.py   | 71 +++++++++++--------
 1 file changed, 40 insertions(+), 31 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index 3c3607a987..f394a3d04b 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -55,6 +55,10 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
             kitsu_task = instance.data.get("kitsu_task")
             if kitsu_task is None:
                 continue
+        # Get comment text body
+        publish_comment = context.data.get("comment")
+        if not publish_comment:
+            self.log.info("Comment is not set.")
 
             # Get note status, by default uses the task status for the note
             # if it is not specified in the configuration
@@ -74,9 +78,9 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
                 kitsu_status = gazu.task.get_task_status_by_short_name(
                     self.note_status_shortname
         families = set(
-            instance.data.get('kitsu_task')
+            instance.data.get("kitsu_task")
             for instance in context
-            if instance.data.get('publish')
+            if instance.data.get("publish")
         )
 
         for instance in context:
@@ -89,35 +93,37 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
             kitsu_task = context.data["kitsu_task"]
             shortname = kitsu_task["task_status"]["short_name"].upper()
             note_status = kitsu_task["task_status_id"]
-            if self.set_status_note and next(
-                (
-                    False
-                    for status_except in self.status_exceptions
-                    if shortname == status_except["short_name"].upper()
-                    and status_except["condition"] == "equal"
-                    or
-                    shortname != status_except["short_name"].upper()
-                    and status_except["condition"] == "not_equal"
-                ),
-                True,
-            ) and next(
-                (
-                    True
-                    for family in families
-                    if next(
-                        (
-                            False
-                            for family_req in self.family_requirements
-                            if family_req['condition'] == 'equal'
-                            and family_req['family'].lower() != family
-                            or
-                            family_req['condition'] == 'not_equal'
-                            and family_req['family'].lower() == family
-                        ),
-                        True,
-                    )
-                ),
-                False,
+            if (
+                self.set_status_note
+                and next(
+                    (
+                        False
+                        for status_except in self.status_exceptions
+                        if shortname == status_except["short_name"].upper()
+                        and status_except["condition"] == "equal"
+                        or shortname != status_except["short_name"].upper()
+                        and status_except["condition"] == "not_equal"
+                    ),
+                    True,
+                )
+                and next(
+                    (
+                        True
+                        for family in families
+                        if next(
+                            (
+                                False
+                                for family_req in self.family_requirements
+                                if family_req["condition"] == "equal"
+                                and family_req["family"].lower() != family
+                                or family_req["condition"] == "not_equal"
+                                and family_req["family"].lower() == family
+                            ),
+                            True,
+                        )
+                    ),
+                    False,
+                )
             ):
                 kitsu_status = gazu.task.get_task_status_by_short_name(
                     self.note_status_shortname
@@ -147,6 +153,9 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
             )
             kitsu_comment = gazu.task.add_comment(
                 kitsu_task, note_status, comment=publish_comment
+                instance.data["kitsu_task"],
+                note_status,
+                comment=publish_comment,
             )
 
             instance.data["kitsu_comment"] = kitsu_comment

From 2022a38c650bf6dcd5603c88ecbebd09d176b2b0 Mon Sep 17 00:00:00 2001
From: Sharkitty <81646000+Sharkitty@users.noreply.github.com>
Date: Wed, 15 Mar 2023 09:20:17 +0000
Subject: [PATCH 080/151] Apply suggestions from code review
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Adjustment to documentation, and families set declaration

Co-authored-by: Félix David <felixg.david@gmail.com>
---
 .../modules/kitsu/plugins/publish/integrate_kitsu_note.py     | 4 ++--
 website/docs/module_kitsu.md                                  | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index f394a3d04b..0bb2a63fea 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -77,11 +77,11 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
             if self.set_status_note and allow_status_change:
                 kitsu_status = gazu.task.get_task_status_by_short_name(
                     self.note_status_shortname
-        families = set(
+        families = {
             instance.data.get("kitsu_task")
             for instance in context
             if instance.data.get("publish")
-        )
+        }
 
         for instance in context:
             kitsu_task = instance.data.get("kitsu_task")
diff --git a/website/docs/module_kitsu.md b/website/docs/module_kitsu.md
index daa7102b79..9a85f83e3f 100644
--- a/website/docs/module_kitsu.md
+++ b/website/docs/module_kitsu.md
@@ -44,10 +44,10 @@ Task status can be automatically set during publish thanks to `Integrate Kitsu N
 `Admin -> Studio Settings -> Project Settings -> Kitsu -> Integrate Kitsu Note`.
 
 There are four settings available:
-- `Set status on note` -> turns on and off this integrator.
+- `Set status on note` -> Turns on and off this integrator.
 - `Note shortname` -> Which status shortname should be set automatically (Case sensitive).
 - `Status conditions` -> Conditions that need to be met for kitsu status to be changed. You can add as many conditions as you like. There are two fields to each conditions: `Condition` (Whether current status should be equal or not equal to the condition status) and `Short name` (Kitsu Shortname of the condition status).
-- `Family requirements` -> With this option you can add requirements to which families must be pushed or not in order to have the task status set by this integrator. There are two fields for each requirements: `Condition` (Same as the above) and `Family` (name of the family concerned by this requirement). For instance, adding one item set to `Not equal` and `workfile`, would mean the task status would change if a subset from another family than workfile is published (workfile can still be included), but not if you only publish the workfile subset.
+- `Family requirements` -> With this option you can add requirements to which families must be pushed or not in order to have the task status set by this integrator. There are two fields for each requirements: `Condition` (Same as the above) and `Family` (name of the family concerned by this requirement). For instance, adding one item set to `Not equal` and `workfile`, would mean the task status would change if a subset from another family than workfile is published (workfile can still be included), but not if you publish the workfile subset only.
 
 ![Integrate Kitsu Note project settings](assets/integrate_kitsu_note_settings.png)
 

From 36ee01997672e78591e80e1d93278dc9db1a2800 Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Tue, 21 Mar 2023 16:48:50 +0100
Subject: [PATCH 081/151] :rotating_light: some style fixes

---
 openpype/hosts/unreal/ue_workers.py | 114 +++++++++++++++-------------
 openpype/widgets/splash_screen.py   |   4 +-
 2 files changed, 62 insertions(+), 56 deletions(-)

diff --git a/openpype/hosts/unreal/ue_workers.py b/openpype/hosts/unreal/ue_workers.py
index f7bc0e90dc..d1740124a8 100644
--- a/openpype/hosts/unreal/ue_workers.py
+++ b/openpype/hosts/unreal/ue_workers.py
@@ -5,33 +5,33 @@ import re
 import subprocess
 from distutils import dir_util
 from pathlib import Path
-from typing import List
+from typing import List, Union
 
 import openpype.hosts.unreal.lib as ue_lib
 
 from qtpy import QtCore
 
 
-def parse_comp_progress(line: str, progress_signal: QtCore.Signal(int)) -> int:
-    match = re.search('\[[1-9]+/[0-9]+\]', line)
+def parse_comp_progress(line: str, progress_signal: QtCore.Signal(int)):
+    match = re.search(r"\[[1-9]+/[0-9]+]", line)
     if match is not None:
-        split: list[str] = match.group().split('/')
+        split: list[str] = match.group().split("/")
         curr: float = float(split[0][1:])
         total: float = float(split[1][:-1])
         progress_signal.emit(int((curr / total) * 100.0))
 
 
-def parse_prj_progress(line: str, progress_signal: QtCore.Signal(int)) -> int:
-    match = re.search('@progress', line)
+def parse_prj_progress(line: str, progress_signal: QtCore.Signal(int)):
+    match = re.search("@progress", line)
     if match is not None:
-        percent_match = re.search('\d{1,3}', line)
+        percent_match = re.search(r"\d{1,3}", line)
         progress_signal.emit(int(percent_match.group()))
 
 
 def retrieve_exit_code(line: str):
-    match = re.search('ExitCode=\d+', line)
+    match = re.search(r"ExitCode=\d+", line)
     if match is not None:
-        split: list[str] = match.group().split('=')
+        split: list[str] = match.group().split("=")
         return int(split[1])
 
     return None
@@ -86,16 +86,19 @@ class UEProjectGenerationWorker(QtCore.QObject):
         if self.dev_mode:
             stage_count = 4
 
-        self.stage_begin.emit(f'Generating a new UE project ... 1 out of '
-                              f'{stage_count}')
+        self.stage_begin.emit(
+            ("Generating a new UE project ... 1 out of "
+             f"{stage_count}"))
 
-        commandlet_cmd = [f'{ue_editor_exe.as_posix()}',
-                          f'{cmdlet_project.as_posix()}',
-                          f'-run=OPGenerateProject',
-                          f'{project_file.resolve().as_posix()}']
+        commandlet_cmd = [
+            f"{ue_editor_exe.as_posix()}",
+            f"{cmdlet_project.as_posix()}",
+            "-run=OPGenerateProject",
+            f"{project_file.resolve().as_posix()}",
+        ]
 
         if self.dev_mode:
-            commandlet_cmd.append('-GenerateCode')
+            commandlet_cmd.append("-GenerateCode")
 
         gen_process = subprocess.Popen(commandlet_cmd,
                                        stdout=subprocess.PIPE,
@@ -103,24 +106,27 @@ class UEProjectGenerationWorker(QtCore.QObject):
 
         for line in gen_process.stdout:
             decoded_line = line.decode(errors="replace")
-            print(decoded_line, end='')
+            print(decoded_line, end="")
             self.log.emit(decoded_line)
         gen_process.stdout.close()
         return_code = gen_process.wait()
 
         if return_code and return_code != 0:
-            msg = 'Failed to generate ' + self.project_name \
-                  + f' project! Exited with return code {return_code}'
+            msg = (
+                f"Failed to generate {self.project_name} "
+                f"project! Exited with return code {return_code}"
+            )
             self.failed.emit(msg, return_code)
             raise RuntimeError(msg)
 
         print("--- Project has been generated successfully.")
-        self.stage_begin.emit(f'Writing the Engine ID of the build UE ... 1'
-                              f' out of {stage_count}')
+        self.stage_begin.emit(
+            (f"Writing the Engine ID of the build UE ... 1"
+             f" out of {stage_count}"))
 
         if not project_file.is_file():
-            msg = "Failed to write the Engine ID into .uproject file! Can " \
-                  "not read!"
+            msg = ("Failed to write the Engine ID into .uproject file! Can "
+                   "not read!")
             self.failed.emit(msg)
             raise RuntimeError(msg)
 
@@ -134,13 +140,14 @@ class UEProjectGenerationWorker(QtCore.QObject):
             pf.seek(0)
             json.dump(pf_json, pf, indent=4)
             pf.truncate()
-            print(f'--- Engine ID has been written into the project file')
+            print("--- Engine ID has been written into the project file")
 
         self.progress.emit(90)
         if self.dev_mode:
             # 2nd stage
-            self.stage_begin.emit(f'Generating project files ... 2 out of '
-                                  f'{stage_count}')
+            self.stage_begin.emit(
+                (f"Generating project files ... 2 out of "
+                 f"{stage_count}"))
 
             self.progress.emit(0)
             ubt_path = ue_lib.get_path_to_ubt(self.engine_path,
@@ -163,8 +170,8 @@ class UEProjectGenerationWorker(QtCore.QObject):
                                         stdout=subprocess.PIPE,
                                         stderr=subprocess.PIPE)
             for line in gen_proc.stdout:
-                decoded_line: str = line.decode(errors='replace')
-                print(decoded_line, end='')
+                decoded_line: str = line.decode(errors="replace")
+                print(decoded_line, end="")
                 self.log.emit(decoded_line)
                 parse_prj_progress(decoded_line, self.progress)
 
@@ -172,13 +179,13 @@ class UEProjectGenerationWorker(QtCore.QObject):
             return_code = gen_proc.wait()
 
             if return_code and return_code != 0:
-                msg = 'Failed to generate project files! ' \
-                      f'Exited with return code {return_code}'
+                msg = ("Failed to generate project files! "
+                       f"Exited with return code {return_code}")
                 self.failed.emit(msg, return_code)
                 raise RuntimeError(msg)
 
-            self.stage_begin.emit(f'Building the project ... 3 out of '
-                                  f'{stage_count}')
+            self.stage_begin.emit(
+                f"Building the project ... 3 out of {stage_count}")
             self.progress.emit(0)
             # 3rd stage
             build_prj_cmd = [ubt_path.as_posix(),
@@ -186,16 +193,16 @@ class UEProjectGenerationWorker(QtCore.QObject):
                              arch,
                              "Development",
                              "-TargetType=Editor",
-                             f'-Project={project_file}',
-                             f'{project_file}',
+                             f"-Project={project_file}",
+                             f"{project_file}",
                              "-IgnoreJunk"]
 
             build_prj_proc = subprocess.Popen(build_prj_cmd,
                                               stdout=subprocess.PIPE,
                                               stderr=subprocess.PIPE)
             for line in build_prj_proc.stdout:
-                decoded_line: str = line.decode(errors='replace')
-                print(decoded_line, end='')
+                decoded_line: str = line.decode(errors="replace")
+                print(decoded_line, end="")
                 self.log.emit(decoded_line)
                 parse_comp_progress(decoded_line, self.progress)
 
@@ -203,16 +210,17 @@ class UEProjectGenerationWorker(QtCore.QObject):
             return_code = build_prj_proc.wait()
 
             if return_code and return_code != 0:
-                msg = 'Failed to build project! ' \
-                      f'Exited with return code {return_code}'
+                msg = ("Failed to build project! "
+                       f"Exited with return code {return_code}")
                 self.failed.emit(msg, return_code)
                 raise RuntimeError(msg)
 
         # ensure we have PySide2 installed in engine
 
         self.progress.emit(0)
-        self.stage_begin.emit(f'Checking PySide2 installation... {stage_count}'
-                              f' out of {stage_count}')
+        self.stage_begin.emit(
+            (f"Checking PySide2 installation... {stage_count} "
+             f" out of {stage_count}"))
         python_path = None
         if platform.system().lower() == "windows":
             python_path = self.engine_path / ("Engine/Binaries/ThirdParty/"
@@ -245,16 +253,16 @@ class UEProjectGenerationWorker(QtCore.QObject):
                                           stderr=subprocess.PIPE)
 
         for line in pyside_install.stdout:
-            decoded_line: str = line.decode(errors='replace')
-            print(decoded_line, end='')
+            decoded_line: str = line.decode(errors="replace")
+            print(decoded_line, end="")
             self.log.emit(decoded_line)
 
         pyside_install.stdout.close()
         return_code = pyside_install.wait()
 
         if return_code and return_code != 0:
-            msg = 'Failed to create the project! ' \
-                  f'The installation of PySide2 has failed!'
+            msg = ("Failed to create the project! "
+                   "The installation of PySide2 has failed!")
             self.failed.emit(msg, return_code)
             raise RuntimeError(msg)
 
@@ -296,18 +304,18 @@ class UEPluginInstallWorker(QtCore.QObject):
 
         # in order to successfully build the plugin,
         # It must be built outside the Engine directory and then moved
-        build_plugin_cmd: List[str] = [f'{uat_path.as_posix()}',
-                                       'BuildPlugin',
-                                       f'-Plugin={uplugin_path.as_posix()}',
-                                       f'-Package={temp_dir.as_posix()}']
+        build_plugin_cmd: List[str] = [f"{uat_path.as_posix()}",
+                                       "BuildPlugin",
+                                       f"-Plugin={uplugin_path.as_posix()}",
+                                       f"-Package={temp_dir.as_posix()}"]
 
         build_proc = subprocess.Popen(build_plugin_cmd,
                                       stdout=subprocess.PIPE,
                                       stderr=subprocess.PIPE)
-        return_code: int = None
+        return_code: Union[None, int] = None
         for line in build_proc.stdout:
-            decoded_line: str = line.decode(errors='replace')
-            print(decoded_line, end='')
+            decoded_line: str = line.decode(errors="replace")
+            print(decoded_line, end="")
             self.log.emit(decoded_line)
             if return_code is None:
                 return_code = retrieve_exit_code(decoded_line)
@@ -317,8 +325,8 @@ class UEPluginInstallWorker(QtCore.QObject):
         build_proc.wait()
 
         if return_code and return_code != 0:
-            msg = 'Failed to build plugin' \
-                  f' project! Exited with return code {return_code}'
+            msg = ("Failed to build plugin"
+                   f" project! Exited with return code {return_code}")
             dir_util.remove_tree(temp_dir.as_posix())
             self.failed.emit(msg, return_code)
             raise RuntimeError(msg)
diff --git a/openpype/widgets/splash_screen.py b/openpype/widgets/splash_screen.py
index 6bb0944c46..7c1ff72ecd 100644
--- a/openpype/widgets/splash_screen.py
+++ b/openpype/widgets/splash_screen.py
@@ -49,9 +49,7 @@ class SplashScreen(QtWidgets.QDialog):
         self.init_ui()
 
     def was_proc_successful(self) -> bool:
-        if self.thread_return_code == 0:
-            return True
-        return False
+        return self.thread_return_code == 0
 
     def start_thread(self, q_thread: QtCore.QThread):
         """Saves the reference to this thread and starts it.

From 6433b1f270420f84a8742467dc34a51b71996e92 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 21 Mar 2023 16:52:13 +0100
Subject: [PATCH 082/151] Render only the local saver tools instead of all
 active savers in the comp

---
 .../plugins/publish/extract_render_local.py   | 63 ++++++++++++++++---
 1 file changed, 56 insertions(+), 7 deletions(-)

diff --git a/openpype/hosts/fusion/plugins/publish/extract_render_local.py b/openpype/hosts/fusion/plugins/publish/extract_render_local.py
index 16a582032f..5a0140c525 100644
--- a/openpype/hosts/fusion/plugins/publish/extract_render_local.py
+++ b/openpype/hosts/fusion/plugins/publish/extract_render_local.py
@@ -1,7 +1,43 @@
+import logging
+import contextlib
 import pyblish.api
 from openpype.hosts.fusion.api import comp_lock_and_undo_chunk
 
 
+log = logging.getLogger(__name__)
+
+
+@contextlib.contextmanager
+def enabled_savers(comp, savers):
+    """Enable only the `savers` in Comp during the context.
+
+    Any Saver tool in the passed composition that is not in the savers list
+    will be set to passthrough during the context.
+
+    Args:
+        comp (object): Fusion composition object.
+        savers (list): List of Saver tool objects.
+
+    """
+    passthrough_key = "TOOLB_PassThrough"
+    original_states = {}
+    enabled_save_names = {saver.Name for saver in savers}
+    try:
+        all_savers = comp.GetToolList(False, "Saver").values()
+        for saver in all_savers:
+            original_state = saver.GetAttrs()[passthrough_key]
+            original_states[saver] = original_state
+
+            # The passthrough state we want to set (passthrough != enabled)
+            state = saver.Name not in enabled_save_names
+            if state != original_state:
+                saver.SetAttrs({passthrough_key: state})
+        yield
+    finally:
+        for saver, original_state in original_states.items():
+            saver.SetAttrs({"TOOLB_PassThrough": original_state})
+
+
 class FusionRenderLocal(pyblish.api.InstancePlugin):
     """Render the current Fusion composition locally."""
 
@@ -32,6 +68,16 @@ class FusionRenderLocal(pyblish.api.InstancePlugin):
         # to speed up the rendering. The check below makes sure that we only
         # execute the rendering once and not for each instance.
         key = f"__hasRun{self.__class__.__name__}"
+
+        savers_to_render = [
+            # Get the saver tool from the instance
+            instance[0] for instance in context if
+            # Only active instances
+            instance.data.get("publish", True) and
+            # Only render.local instances
+            "render.local" in instance.data["families"]
+        ]
+
         if key not in context.data:
             # We initialize as false to indicate it wasn't successful yet
             # so we can keep track of whether Fusion succeeded
@@ -44,15 +90,18 @@ class FusionRenderLocal(pyblish.api.InstancePlugin):
             self.log.info("Starting Fusion render")
             self.log.info(f"Start frame: {frame_start}")
             self.log.info(f"End frame: {frame_end}")
+            saver_names = ", ".join(saver.Name for saver in savers_to_render)
+            self.log.info(f"Rendering tools: {saver_names}")
 
             with comp_lock_and_undo_chunk(current_comp):
-                result = current_comp.Render(
-                    {
-                        "Start": frame_start,
-                        "End": frame_end,
-                        "Wait": True,
-                    }
-                )
+                with enabled_savers(current_comp, savers_to_render):
+                    result = current_comp.Render(
+                        {
+                            "Start": frame_start,
+                            "End": frame_end,
+                            "Wait": True,
+                        }
+                    )
 
             context.data[key] = bool(result)
 

From 25f7478955e75d852095236ce6a9b21c6a5d9a9d Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 21 Mar 2023 17:02:31 +0100
Subject: [PATCH 083/151] Remove unused functions (#4671)

---
 .../maya/plugins/publish/extract_look.py      | 30 -------------------
 1 file changed, 30 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_look.py b/openpype/hosts/maya/plugins/publish/extract_look.py
index bc506b7feb..447c9a615c 100644
--- a/openpype/hosts/maya/plugins/publish/extract_look.py
+++ b/openpype/hosts/maya/plugins/publish/extract_look.py
@@ -30,36 +30,6 @@ def _has_arnold():
         return False
 
 
-def escape_space(path):
-    """Ensure path is enclosed by quotes to allow paths with spaces"""
-    return '"{}"'.format(path) if " " in path else path
-
-
-def get_ocio_config_path(profile_folder):
-    """Path to OpenPype vendorized OCIO.
-
-    Vendorized OCIO config file path is grabbed from the specific path
-    hierarchy specified below.
-
-    "{OPENPYPE_ROOT}/vendor/OpenColorIO-Configs/{profile_folder}/config.ocio"
-    Args:
-        profile_folder (str): Name of folder to grab config file from.
-
-    Returns:
-        str: Path to vendorized config file.
-    """
-
-    return os.path.join(
-        os.environ["OPENPYPE_ROOT"],
-        "vendor",
-        "bin",
-        "ocioconfig",
-        "OpenColorIOConfigs",
-        profile_folder,
-        "config.ocio"
-    )
-
-
 def find_paths_by_hash(texture_hash):
     """Find the texture hash key in the dictionary.
 

From 41d6269471f7f99c6323377fc6406ba1a0dfa59e Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Tue, 21 Mar 2023 17:11:45 +0100
Subject: [PATCH 084/151] nuke: load nukenodes family timelessly

---
 .../hosts/nuke/plugins/load/load_backdrop.py  | 22 ++++++-------------
 1 file changed, 7 insertions(+), 15 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/load/load_backdrop.py b/openpype/hosts/nuke/plugins/load/load_backdrop.py
index f227aa161a..67c7877e60 100644
--- a/openpype/hosts/nuke/plugins/load/load_backdrop.py
+++ b/openpype/hosts/nuke/plugins/load/load_backdrop.py
@@ -54,22 +54,19 @@ class LoadBackdropNodes(load.LoaderPlugin):
         version = context['version']
         version_data = version.get("data", {})
         vname = version.get("name", None)
-        first = version_data.get("frameStart", None)
-        last = version_data.get("frameEnd", None)
         namespace = namespace or context['asset']['name']
         colorspace = version_data.get("colorspace", None)
         object_name = "{}_{}".format(name, namespace)
 
         # prepare data for imprinting
         # add additional metadata from the version to imprint to Avalon knob
-        add_keys = ["frameStart", "frameEnd", "handleStart", "handleEnd",
-                    "source", "author", "fps"]
+        add_keys = ["source", "author", "fps"]
 
-        data_imprint = {"frameStart": first,
-                        "frameEnd": last,
-                        "version": vname,
-                        "colorspaceInput": colorspace,
-                        "objectName": object_name}
+        data_imprint = {
+            "version": vname,
+            "colorspaceInput": colorspace,
+            "objectName": object_name
+        }
 
         for k in add_keys:
             data_imprint.update({k: version_data[k]})
@@ -204,18 +201,13 @@ class LoadBackdropNodes(load.LoaderPlugin):
         name = container['name']
         version_data = version_doc.get("data", {})
         vname = version_doc.get("name", None)
-        first = version_data.get("frameStart", None)
-        last = version_data.get("frameEnd", None)
         namespace = container['namespace']
         colorspace = version_data.get("colorspace", None)
         object_name = "{}_{}".format(name, namespace)
 
-        add_keys = ["frameStart", "frameEnd", "handleStart", "handleEnd",
-                    "source", "author", "fps"]
+        add_keys = ["source", "author", "fps"]
 
         data_imprint = {"representation": str(representation["_id"]),
-                        "frameStart": first,
-                        "frameEnd": last,
                         "version": vname,
                         "colorspaceInput": colorspace,
                         "objectName": object_name}

From 5ca5498b03bb1a88564b43e09fa4e660111614ec Mon Sep 17 00:00:00 2001
From: Sharkitty <hayleylalicorne@gmail.com>
Date: Tue, 21 Mar 2023 17:33:50 +0100
Subject: [PATCH 085/151] Changed family requirement check based on discussions

---
 .../plugins/publish/integrate_kitsu_note.py   | 79 ++++++-------------
 1 file changed, 23 insertions(+), 56 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index 0bb2a63fea..366e70934f 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -53,12 +53,8 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
                 continue
 
             kitsu_task = instance.data.get("kitsu_task")
-            if kitsu_task is None:
+            if not kitsu_task:
                 continue
-        # Get comment text body
-        publish_comment = context.data.get("comment")
-        if not publish_comment:
-            self.log.info("Comment is not set.")
 
             # Get note status, by default uses the task status for the note
             # if it is not specified in the configuration
@@ -74,57 +70,31 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
                     allow_status_change = False
                     break
 
-            if self.set_status_note and allow_status_change:
-                kitsu_status = gazu.task.get_task_status_by_short_name(
-                    self.note_status_shortname
-        families = {
-            instance.data.get("kitsu_task")
-            for instance in context
-            if instance.data.get("publish")
-        }
+            if allow_status_change:
+                # Get families
+                families = {
+                    instance.data.get("kitsu_task")
+                    for instance in context
+                    if instance.data.get("publish")
+                }
 
-        for instance in context:
-            kitsu_task = instance.data.get("kitsu_task")
-            if not kitsu_task:
-                continue
+                # Check if any family requirement is met
+                for family_requirement in self.family_requirements:
+                    condition = family_requirement["condition"] == "equal"
 
-            # Get note status, by default uses the task status for the note
-            # if it is not specified in the configuration
-            kitsu_task = context.data["kitsu_task"]
-            shortname = kitsu_task["task_status"]["short_name"].upper()
-            note_status = kitsu_task["task_status_id"]
-            if (
-                self.set_status_note
-                and next(
-                    (
-                        False
-                        for status_except in self.status_exceptions
-                        if shortname == status_except["short_name"].upper()
-                        and status_except["condition"] == "equal"
-                        or shortname != status_except["short_name"].upper()
-                        and status_except["condition"] == "not_equal"
-                    ),
-                    True,
-                )
-                and next(
-                    (
-                        True
-                        for family in families
-                        if next(
-                            (
-                                False
-                                for family_req in self.family_requirements
-                                if family_req["condition"] == "equal"
-                                and family_req["family"].lower() != family
-                                or family_req["condition"] == "not_equal"
-                                and family_req["family"].lower() == family
-                            ),
-                            True,
+                    for family in families:
+                        match = (
+                            family_requirement["short_name"].lower() == family
                         )
-                    ),
-                    False,
-                )
-            ):
+                        if match and not condition or condition and not match:
+                            allow_status_change = True
+                            break
+
+                    if allow_status_change:
+                        break
+
+            # Set note status
+            if self.set_status_note and allow_status_change:
                 kitsu_status = gazu.task.get_task_status_by_short_name(
                     self.note_status_shortname
                 )
@@ -153,9 +123,6 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
             )
             kitsu_comment = gazu.task.add_comment(
                 kitsu_task, note_status, comment=publish_comment
-                instance.data["kitsu_task"],
-                note_status,
-                comment=publish_comment,
             )
 
             instance.data["kitsu_comment"] = kitsu_comment

From 109435fee281acd7be8bd2f2a67573e4221e8761 Mon Sep 17 00:00:00 2001
From: Sharkitty <hayleylalicorne@gmail.com>
Date: Tue, 21 Mar 2023 17:48:01 +0100
Subject: [PATCH 086/151] Fixed kitsu project settings schema, updated
 documentation screenshot

---
 .../projects_schema/schema_project_kitsu.json |   1 -
 .../assets/integrate_kitsu_note_settings.png  | Bin 44847 -> 46673 bytes
 2 files changed, 1 deletion(-)

diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
index ba77f2b471..0a3a5e6e7b 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
@@ -127,7 +127,6 @@
                                     "label": "Custom comment"
                                 }
                             ]
-                            }
                         }
                     ]
                 }
diff --git a/website/docs/assets/integrate_kitsu_note_settings.png b/website/docs/assets/integrate_kitsu_note_settings.png
index fd055942d023e2ffc12fc508cd7079eb834045c3..6f76556afa54b4a1cd946ffb78d200ec3cd3e3b1 100644
GIT binary patch
literal 46673
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%0D3V?)tF)Lx2^;H(ZQbbO&WO=KC?o7RUlAm
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
I!94Uo0HuA#d;kCd

literal 44847
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
BT7Uom


From c8c31018d656ea206c42e4a083365e21b4252861 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Date: Tue, 21 Mar 2023 18:10:09 +0100
Subject: [PATCH 087/151] General: Filter available applications (#4667)

* added project settings for applications

* filter applications by new settings in launcher and ftrack

* disable filtering by default
---
 .../event_handlers_user/action_applications.py     |  9 +++++++++
 .../defaults/project_settings/applications.json    |  3 +++
 .../schemas/projects_schema/schema_main.json       |  4 ++++
 .../schema_project_applications.json               | 14 ++++++++++++++
 openpype/tools/launcher/models.py                  |  6 ++++++
 5 files changed, 36 insertions(+)
 create mode 100644 openpype/settings/defaults/project_settings/applications.json
 create mode 100644 openpype/settings/entities/schemas/projects_schema/schema_project_applications.json

diff --git a/openpype/modules/ftrack/event_handlers_user/action_applications.py b/openpype/modules/ftrack/event_handlers_user/action_applications.py
index 102f04c956..30399b463d 100644
--- a/openpype/modules/ftrack/event_handlers_user/action_applications.py
+++ b/openpype/modules/ftrack/event_handlers_user/action_applications.py
@@ -124,6 +124,11 @@ class AppplicationsAction(BaseAction):
         if not avalon_project_apps:
             return False
 
+        settings = self.get_project_settings_from_event(
+            event, avalon_project_doc["name"])
+
+        only_available = settings["applications"]["only_available"]
+
         items = []
         for app_name in avalon_project_apps:
             app = self.application_manager.applications.get(app_name)
@@ -133,6 +138,10 @@ class AppplicationsAction(BaseAction):
             if app.group.name in CUSTOM_LAUNCH_APP_GROUPS:
                 continue
 
+            # Skip applications without valid executables
+            if only_available and not app.find_executable():
+                continue
+
             app_icon = app.icon
             if app_icon and self.icon_url:
                 try:
diff --git a/openpype/settings/defaults/project_settings/applications.json b/openpype/settings/defaults/project_settings/applications.json
new file mode 100644
index 0000000000..62f3cdfe1b
--- /dev/null
+++ b/openpype/settings/defaults/project_settings/applications.json
@@ -0,0 +1,3 @@
+{
+    "only_available": false
+}
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_main.json b/openpype/settings/entities/schemas/projects_schema/schema_main.json
index ebe59c7942..8c1d8ccbdd 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_main.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_main.json
@@ -82,6 +82,10 @@
                     "type": "schema",
                     "name": "schema_project_slack"
                 },
+                {
+                    "type": "schema",
+                    "name": "schema_project_applications"
+                },
                 {
                     "type": "schema",
                     "name": "schema_project_max"
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_applications.json b/openpype/settings/entities/schemas/projects_schema/schema_project_applications.json
new file mode 100644
index 0000000000..030ed3ee8a
--- /dev/null
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_applications.json
@@ -0,0 +1,14 @@
+{
+    "type": "dict",
+    "key": "applications",
+    "label": "Applications",
+    "collapsible": true,
+    "is_file": true,
+    "children": [
+        {
+            "type": "boolean",
+            "key": "only_available",
+            "label": "Show only available applications"
+        }
+    ]
+}
diff --git a/openpype/tools/launcher/models.py b/openpype/tools/launcher/models.py
index 6c763544a9..3aa6c5d8cb 100644
--- a/openpype/tools/launcher/models.py
+++ b/openpype/tools/launcher/models.py
@@ -19,6 +19,7 @@ from openpype.lib.applications import (
     CUSTOM_LAUNCH_APP_GROUPS,
     ApplicationManager
 )
+from openpype.settings import get_project_settings
 from openpype.pipeline import discover_launcher_actions
 from openpype.tools.utils.lib import (
     DynamicQThread,
@@ -94,6 +95,8 @@ class ActionModel(QtGui.QStandardItemModel):
         if not project_doc:
             return actions
 
+        project_settings = get_project_settings(project_name)
+        only_available = project_settings["applications"]["only_available"]
         self.application_manager.refresh()
         for app_def in project_doc["config"]["apps"]:
             app_name = app_def["name"]
@@ -104,6 +107,9 @@ class ActionModel(QtGui.QStandardItemModel):
             if app.group.name in CUSTOM_LAUNCH_APP_GROUPS:
                 continue
 
+            if only_available and not app.find_executable():
+                continue
+
             # Get from app definition, if not there from app in project
             action = type(
                 "app_{}".format(app_name),

From 749bf7d2290ff256da95f634090d5a2c3bff18dd Mon Sep 17 00:00:00 2001
From: Ynbot <bot@ynput.io>
Date: Wed, 22 Mar 2023 03:26:05 +0000
Subject: [PATCH 088/151] [Automated] Bump version

---
 openpype/version.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/version.py b/openpype/version.py
index 339c17dc70..5b6db12b5e 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.15.3-nightly.2"
+__version__ = "3.15.3-nightly.3"

From 28b424bf2fe113857d3513948a6bdcd897fbb859 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Wed, 22 Mar 2023 12:13:21 +0100
Subject: [PATCH 089/151] Publisher: Windows reduce command window pop-ups
 during Publishing (#4672)

* Avoid command pop-ups during publishing (tip by @iLLiCiTiT)

* No need to pass creationflags because it's already done in `run_subprocess`

* Hide command window for `shell=True` calls

* Update openpype/lib/execute.py

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>

---------

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 openpype/lib/execute.py                    |  4 ++++
 openpype/lib/vendor_bin_utils.py           | 12 ++++++++++--
 openpype/plugins/publish/extract_burnin.py |  6 +-----
 openpype/scripts/otio_burnin.py            |  6 ------
 4 files changed, 15 insertions(+), 13 deletions(-)

diff --git a/openpype/lib/execute.py b/openpype/lib/execute.py
index 759a4db0cb..7a929a0ade 100644
--- a/openpype/lib/execute.py
+++ b/openpype/lib/execute.py
@@ -102,6 +102,10 @@ def run_subprocess(*args, **kwargs):
     if (
         platform.system().lower() == "windows"
         and "creationflags" not in kwargs
+        # shell=True already tries to hide the console window
+        # and passing these creationflags then shows the window again
+        # so we avoid it for shell=True cases
+        and kwargs.get("shell") is not True
     ):
         kwargs["creationflags"] = (
             subprocess.CREATE_NEW_PROCESS_GROUP
diff --git a/openpype/lib/vendor_bin_utils.py b/openpype/lib/vendor_bin_utils.py
index 00dd1955fe..e5deb7a6b2 100644
--- a/openpype/lib/vendor_bin_utils.py
+++ b/openpype/lib/vendor_bin_utils.py
@@ -224,18 +224,26 @@ def find_tool_in_custom_paths(paths, tool, validation_func=None):
 
 def _check_args_returncode(args):
     try:
-        # Python 2 compatibility where DEVNULL is not available
+        kwargs = {}
+        if platform.system().lower() == "windows":
+            kwargs["creationflags"] = (
+                subprocess.CREATE_NEW_PROCESS_GROUP
+                | getattr(subprocess, "DETACHED_PROCESS", 0)
+                | getattr(subprocess, "CREATE_NO_WINDOW", 0)
+            )
+
         if hasattr(subprocess, "DEVNULL"):
             proc = subprocess.Popen(
                 args,
                 stdout=subprocess.DEVNULL,
                 stderr=subprocess.DEVNULL,
+                **kwargs
             )
             proc.wait()
         else:
             with open(os.devnull, "w") as devnull:
                 proc = subprocess.Popen(
-                    args, stdout=devnull, stderr=devnull,
+                    args, stdout=devnull, stderr=devnull, **kwargs
                 )
                 proc.wait()
 
diff --git a/openpype/plugins/publish/extract_burnin.py b/openpype/plugins/publish/extract_burnin.py
index f113e61bb0..38ec08e8d9 100644
--- a/openpype/plugins/publish/extract_burnin.py
+++ b/openpype/plugins/publish/extract_burnin.py
@@ -16,9 +16,7 @@ from openpype.lib import (
 
     get_transcode_temp_directory,
     convert_input_paths_for_ffmpeg,
-    should_convert_for_ffmpeg,
-
-    CREATE_NO_WINDOW
+    should_convert_for_ffmpeg
 )
 from openpype.lib.profiles_filtering import filter_profiles
 
@@ -338,8 +336,6 @@ class ExtractBurnin(publish.Extractor):
                     "logger": self.log,
                     "env": {}
                 }
-                if platform.system().lower() == "windows":
-                    process_kwargs["creationflags"] = CREATE_NO_WINDOW
 
                 run_openpype_process(*args, **process_kwargs)
                 # Remove the temporary json
diff --git a/openpype/scripts/otio_burnin.py b/openpype/scripts/otio_burnin.py
index cb4646c099..ef449f4f74 100644
--- a/openpype/scripts/otio_burnin.py
+++ b/openpype/scripts/otio_burnin.py
@@ -345,12 +345,6 @@ class ModifiedBurnins(ffmpeg_burnins.Burnins):
             "stderr": subprocess.PIPE,
             "shell": True,
         }
-        if platform.system().lower() == "windows":
-            kwargs["creationflags"] = (
-                subprocess.CREATE_NEW_PROCESS_GROUP
-                | getattr(subprocess, "DETACHED_PROCESS", 0)
-                | getattr(subprocess, "CREATE_NO_WINDOW", 0)
-            )
         proc = subprocess.Popen(command, **kwargs)
 
         _stdout, _stderr = proc.communicate()

From 20219b465bc1c066bf3af5c53b0e2447450d1f5a Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 22 Mar 2023 19:57:45 +0800
Subject: [PATCH 090/151] resolution setting updated

---
 openpype/hosts/max/api/lib.py | 30 ++++++++++++------------------
 1 file changed, 12 insertions(+), 18 deletions(-)

diff --git a/openpype/hosts/max/api/lib.py b/openpype/hosts/max/api/lib.py
index 6a7f63ca75..b6e3958797 100644
--- a/openpype/hosts/max/api/lib.py
+++ b/openpype/hosts/max/api/lib.py
@@ -6,12 +6,10 @@ from pymxs import runtime as rt
 from typing import Union
 import contextlib
 
-from openpype.client import (
-    get_project
+from openpype.pipeline.context_tools import (
+    get_current_project_asset,
+    get_current_project
 )
-from openpype.pipeline import legacy_io
-
-from openpype.pipeline.context_tools import get_current_project_asset
 
 
 JSON_PREFIX = "JSON::"
@@ -164,7 +162,7 @@ def get_multipass_setting(project_setting=None):
                            ["multipass"])
 
 
-def set_scene_resolution(width, height):
+def set_scene_resolution(width: int, height: int):
     """Set the render resolution
 
     Args:
@@ -188,19 +186,15 @@ def reset_scene_resolution():
     Returns:
         None
     """
-    project_name = legacy_io.active_project()
-    project_doc = get_project(project_name)
-    project_data = project_doc["data"]
-    asset_data = get_current_project_asset()["data"]
-
+    project_resolution_data = get_current_project(fields=["data.resolutionWidth",
+                                                          "data.resolutionHeight"])["data"]
+    asset_resolution_data = get_current_project_asset(fields=["data.resolutionWidth",
+                                                              "data.resolutionHeight"])["data"]
     # Set project resolution
-    width_key = "resolutionWidth"
-    height_key = "resolutionHeight"
-    proj_width_key = project_data.get(width_key, 1920)
-    proj_height_key = project_data.get(height_key, 1080)
-
-    width = asset_data.get(width_key, proj_width_key)
-    height = asset_data.get(height_key, proj_height_key)
+    project_width = int(project_resolution_data.get("resolutionWidth", 1920))
+    project_height = int(project_resolution_data.get("resolutionHeight", 1080))
+    width = int(asset_resolution_data.get("resolutionWidth", project_width))
+    height = int(asset_resolution_data.get("resolutionHeight", project_height))
 
     set_scene_resolution(width, height)
 

From 0bce4762f12e10e3097c5acdafe746a3b1cc71cd Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 22 Mar 2023 20:00:23 +0800
Subject: [PATCH 091/151] hound fix

---
 openpype/hosts/max/api/lib.py | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/max/api/lib.py b/openpype/hosts/max/api/lib.py
index b6e3958797..577dc6e99d 100644
--- a/openpype/hosts/max/api/lib.py
+++ b/openpype/hosts/max/api/lib.py
@@ -186,10 +186,11 @@ def reset_scene_resolution():
     Returns:
         None
     """
-    project_resolution_data = get_current_project(fields=["data.resolutionWidth",
-                                                          "data.resolutionHeight"])["data"]
-    asset_resolution_data = get_current_project_asset(fields=["data.resolutionWidth",
-                                                              "data.resolutionHeight"])["data"]
+    data = ["data.resolutionWidth","data.resolutionHeight"]
+    project_resolution = get_current_project(fields=data)["data"]
+    project_resolution_data = project_resolution["data"]
+    asset_resolution = get_current_project_asset(fields=data)["data"]
+    asset_resolution_data = asset_resolution["data"]
     # Set project resolution
     project_width = int(project_resolution_data.get("resolutionWidth", 1920))
     project_height = int(project_resolution_data.get("resolutionHeight", 1080))

From e70be13d9650c6c28239cb1578c06751c5e670c5 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 22 Mar 2023 20:00:59 +0800
Subject: [PATCH 092/151] hound fix

---
 openpype/hosts/max/api/lib.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/max/api/lib.py b/openpype/hosts/max/api/lib.py
index 577dc6e99d..ac1d158792 100644
--- a/openpype/hosts/max/api/lib.py
+++ b/openpype/hosts/max/api/lib.py
@@ -186,7 +186,7 @@ def reset_scene_resolution():
     Returns:
         None
     """
-    data = ["data.resolutionWidth","data.resolutionHeight"]
+    data = ["data.resolutionWidth", "data.resolutionHeight"]
     project_resolution = get_current_project(fields=data)["data"]
     project_resolution_data = project_resolution["data"]
     asset_resolution = get_current_project_asset(fields=data)["data"]

From 583fecd4009003681fb6cc535aecdbe641a66022 Mon Sep 17 00:00:00 2001
From: Sharkitty <hayleylalicorne@gmail.com>
Date: Wed, 22 Mar 2023 14:37:59 +0100
Subject: [PATCH 093/151] Fixes and adjustments based on reviews

---
 .../plugins/publish/integrate_kitsu_note.py   |  18 ++--
 .../defaults/project_settings/kitsu.json      |   6 +-
 .../projects_schema/schema_project_kitsu.json |  97 ++++++++++--------
 .../assets/integrate_kitsu_note_settings.png  | Bin 46673 -> 48874 bytes
 website/docs/module_kitsu.md                  |   4 +-
 5 files changed, 69 insertions(+), 56 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index 366e70934f..a5253d7878 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -14,8 +14,10 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
     # status settings
     set_status_note = False
     note_status_shortname = "wfa"
-    status_conditions = list()
-    family_requirements = list()
+    status_change_conditions = {
+        "status_conditions": [],
+        "family_requirements": [],
+    }
 
     # comment settings
     custom_comment_template = {
@@ -63,7 +65,7 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
 
             # Check if any status condition is not met
             allow_status_change = True
-            for status_cond in self.status_conditions:
+            for status_cond in self.status_change_conditions["status_conditions"]:
                 condition = status_cond["condition"] == "equal"
                 match = status_cond["short_name"].upper() == shortname
                 if match and not condition or condition and not match:
@@ -73,20 +75,22 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
             if allow_status_change:
                 # Get families
                 families = {
-                    instance.data.get("kitsu_task")
+                    instance.data.get("family")
                     for instance in context
                     if instance.data.get("publish")
                 }
 
+                allow_status_change = False
+
                 # Check if any family requirement is met
-                for family_requirement in self.family_requirements:
+                for family_requirement in self.status_change_conditions["family_requirements"]:
                     condition = family_requirement["condition"] == "equal"
 
                     for family in families:
                         match = (
-                            family_requirement["short_name"].lower() == family
+                            family_requirement["family"].lower() == family
                         )
-                        if match and not condition or condition and not match:
+                        if match and condition or not condition and not match:
                             allow_status_change = True
                             break
 
diff --git a/openpype/settings/defaults/project_settings/kitsu.json b/openpype/settings/defaults/project_settings/kitsu.json
index 32c6c253c7..59a36d8b97 100644
--- a/openpype/settings/defaults/project_settings/kitsu.json
+++ b/openpype/settings/defaults/project_settings/kitsu.json
@@ -8,8 +8,10 @@
         "IntegrateKitsuNote": {
             "set_status_note": false,
             "note_status_shortname": "wfa",
-            "status_conditions": [],
-            "family_requirements": [],
+            "status_change_conditions": {
+                "status_conditions": [],
+                "family_requirements": []
+            },
             "custom_comment_template": {
                 "enabled": false,
                 "comment_template": "{comment}\n\n|  |  |\n|--|--|\n| version| `{version}` |\n| family | `{family}` |\n| name | `{name}` |"
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
index 0a3a5e6e7b..8aeed00542 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_kitsu.json
@@ -54,55 +54,62 @@
                             "label": "Note shortname"
                         },
                         {
-                            "type": "list",
-                            "key": "status_conditions",
-                            "label": "Status conditions",
-                            "object_type": {
-                                "type": "dict",
-                                "key": "conditions_dict",
-                                "children": [
-                                    {
-                                        "type": "enum",
-                                        "key": "condition",
-                                        "label": "Condition",
-                                        "enum_items": [
-                                            {"equal": "Equal"},
-                                            {"not_equal": "Not equal"}
+                            "type": "dict",
+                            "collapsible": true,
+                            "key": "status_change_conditions",
+                            "label": "Status change conditions",
+                            "children": [
+                                 {
+                                    "type": "list",
+                                    "key": "status_conditions",
+                                    "label": "Status conditions",
+                                    "object_type": {
+                                        "type": "dict",
+                                        "key": "condition_dict",
+                                        "children": [
+                                            {
+                                                "type": "enum",
+                                                "key": "condition",
+                                                "label": "Condition",
+                                                "enum_items": [
+                                                    {"equal": "Equal"},
+                                                    {"not_equal": "Not equal"}
+                                                ]
+                                            },
+                                            {
+                                                "type": "text",
+                                                "key": "short_name",
+                                                "label": "Short name"
+                                            }
                                         ]
-                                    },
-                                    {
-                                        "type": "text",
-                                        "key": "short_name",
-                                        "label": "Short name"
                                     }
-                                ]
-                            },
-                            "label": "Status shortname"
-                        },
-                        {
-                            "type": "list",
-                            "key": "family_requirements",
-                            "label": "Family requirements",
-                            "object_type": {
-                                "type": "dict",
-                                "key": "requirement_dict",
-                                "children": [
-                                    {
-                                        "type": "enum",
-                                        "key": "condition",
-                                        "label": "Condition",
-                                        "enum_items": [
-                                            {"equal": "Equal"},
-                                            {"not_equal": "Not equal"}
+                                },
+                                {
+                                    "type": "list",
+                                    "key": "family_requirements",
+                                    "label": "Family requirements",
+                                    "object_type": {
+                                        "type": "dict",
+                                        "key": "requirement_dict",
+                                        "children": [
+                                            {
+                                                "type": "enum",
+                                                "key": "condition",
+                                                "label": "Condition",
+                                                "enum_items": [
+                                                    {"equal": "Equal"},
+                                                    {"not_equal": "Not equal"}
+                                                ]
+                                            },
+                                            {
+                                                "type": "text",
+                                                "key": "family",
+                                                "label": "Family"
+                                            }
                                         ]
-                                    },
-                                    {
-                                        "type": "text",
-                                        "key": "family",
-                                        "label": "Family"
                                     }
-                                ]
-                            }
+                                }
+                            ]
                         },
                         {
                             "type": "dict",
diff --git a/website/docs/assets/integrate_kitsu_note_settings.png b/website/docs/assets/integrate_kitsu_note_settings.png
index 6f76556afa54b4a1cd946ffb78d200ec3cd3e3b1..9c59f0bf5cc9a748de1a8b66b248f539ee8014b5 100644
GIT binary patch
literal 48874
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

literal 46673
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%0D3V?)tF)Lx2^;H(ZQbbO&WO=KC?o7RUlAm
zZ6H(@@r6VL8l2bD*xD{lQ9YTkeAM}+IC^wB6`S7a!NZRnovKT(lHQPK$g72f5R|}i
zZ41Zrfq(6@3x|it?Y+i5$A$cdwSEdI&S)_272JLB`Jv%!nonKL?I3VagP-4<fR9~4
z<R6hHtjLa0$n1H~Dweg+)Va4<3RNWQa>y<HsqTZXTMxnWB{J!wWSBe?QL#@6UJ5e3
z@ksk(+ANOu8{C!%-fduf=AK4V&8qxeVnLN>^41Wu(C2ZR5f4>$)Xbn2Q4|zWq?<qy
zHX9!m_df2e;;eo3d@h^C_A8~%mi#5Ktz4ER{(RYp68RTf3D0+5os`%A6xvM7L+2Yj
zID)3-S&b%VEnMT?&bW?X%Wap#c)qLbnVOk_n{oI#jDJ7K&xZ+kA8}xKczA?SiKi=N
zN|pPJAJUmz951DW-+TEXKc5M>peMMT>O?GT#)6#QE)1F$<%&+?Hs@PqetG?XnN((T
zADtOHadon>Tb$|Yn}f$s^F%mG!!YUNl+>4J;!*|TDQrgK_LV&DGCPUZdmI}@3=1UH
ziKJbQPnMXh9EV0eUaw><cH8cnI>N`2dKg96l%)L{toqpR&+~Et|C~cQICF2)mdp=J
z)$Nn)djjMoIXwPU^^jrru0p}?#j#|jrU3B`>4o-3j~I(wz`0}X19wUbBP_e2)JkVt
z&2I?h*k~v5vjC%Am`i5$j3gzsH=rjv_g9z8TsntamvyRajJifR!-zTk=^^gl+Y`se
z##%$m#ohWPiAp^N>C%BK0IlYL4R8~>lCytBeZGED`NE>+p{_GCU;pG8p>b-k&%E~9
z#xIu9P4uFoX;OZBWUiZI_x`!OI6pq1##1rS=ykKN%_~Jogc6o=bC<X4Ajoks6-18j
z`d#c90CO5W5_$R3pSD-Dt=I368w>`^57^V)n0Nq=JEh)}OLW3N4z0>>Coyk}pb#L(
z1*qh~BNl%C1Z@LWVb=`{)As?6^R2TS?_B-VolkUqd_>oW3r!C<irqYVZaR87`;9^h
ztZil6_IDAV$ulXW{(kmyz=(<b%gy3GOP8w(L=O&3aq&}oefpIabo2U;##nCbb1m8}
z!f~~$kAqvH-v8E`m6v#P{VXsS+NZW)N<Lw&ggMaUWG9G6%vW(+6DK{zc4PWGih))r
z6uGM`uN%6_MBZ-6SUlEFJsy3$PAkSn@$6+c{#MvcUvC;o-)7&fu_=LU@~iL4$dd;*
z6cL`1Qn$&$>p1zN?9hW>vUU5AQoRh59yB+7N2|>(1$=*?Z<T3r_rI*<k+Z7Y-#*{`
z=k|U6%p)5}{p9as8ISd!W?&(R_*eTZt^d*yV3MbQ+eew@Is6^<<;!m6S?Pa$;r}*3
zC&|{`Hwz2vQRI<r_+KoOXXPcY+bzT{qA_y|VLAC7QqLb_y9rIc4$K^so-BEkOXkY?
z&|d8Emg)lYuT5}N`c%O8IdBJa{ioL%4mmd?f;+%<deyq}o;f*+%E}+BpnMaIY0gaK
z6!c#?aZ!Sg9?+T^-d%TyUwX240pWm!Jb+@~XZ~EyQ>EwRQgNvf=hvsI8_dOdyU`)%
zCB+bP17-{D;*qz@e@<>0jk$e#=kA?Xo>1EKCxO(Hj{Emq-?PLS_<dbzV3zhhx&PFl
zHYRrxHMbpqOHp{s>UI11n5co&sUN{;&>d7oN-6dC=ClxJ#mEKskkHP&Jf;2{`(!aA
zPVdCVsrOS0icRFDI*$PztG{PSWSbCN=X~uOrY*h|kb<!-U-#wY!h9Yjnw(s|j9<R0
zHG#=DN5&s~Vnk#l<<7BI|J%l$RO2GJ`_N65K<PL<805QF+nNYBDSnyA=RZOaX(-jI
z>@$V;;E*)PR=`o6@bPJ}l*5oZUwgUlACDtC-2eiD$S1k<p36FKwmctUG-D}oFOCo4
zHDHW$d={wwm<U(+U`s(JY{#Z<!)2!SP-*<))o*&8k3pGsKPzSvvw<%3B2Q=N3O+fr
zC_E+55XY*N`;~$>gW^s$gmBIjXZ!Z?a6F&;Q7TZ``~`g`{9vE-<7UY3f}_|G^u=c_
zmsmv`1*WDQ4yB~dT#8FM8x5W(nEX#`%<oN+R6Pkng=gk}9l1QSpO<H4W{OJQYm96{
zI)r_NtaSPDT{I4GMbby_V%b*@KEC!vK~@Cvp0s>K@IXhUFyxo2z{&0Mvd891xCo-@
zaPvXquHCcN%0!&r$M4AGhql~4|Ir^jnoz5b{Nsa~%`MDw9Wr${pLjd>sET)7Jdvv!
zaRjGkzcWtf*zU&p!7%b8{j+cmJ=NZ`7Z2?xLd$uGn3-_L2@oUX(wC%9MqwcBUE6|O
zcc!9azoR|3IkD<5|DcrIb0*)N3FFPO2!0m#d4@3Xd+aoN9xh4hcj@FHm`c;IE&5>C
z#83siZcW2dM-^O^#VJ2IL-M=eoGjf%!Px6*Ug9b7#o4<FOnwv1S1%8XY0VDi4e#yf
zd-KEbi(V|9H(?mIKp)F=Jzot(8A-ON_;ynP7JfA$jAx`yG@s^3*4X~&ix)ZpL$&+l
zVbOqswDy^8!3d>lj|a9?OHMVO&&cd$crOjqa!o#y&DbM4H`$f@=PMKPGunUM1yBLJ
z_d4J?bECHwt3%QFjt<msXGXq67&3g?!*;(Fg(YS1Ugvkyfs<96zT6@~C<iR`^Vr4H
zt+O;%Tt|x0@uPBKdtu%|yDew;^0fyp&FnAx{GJv~*b0QAAtUWrM(PAg!n?{MRP{m4
zI@oZv@a~A@r!Udxb+hIMf<@F`4{7&ree?Zu{Kof;vS;oN&N1awps*YBfrR<oM0NF!
z@Mn)pcH%?xdzga=o1*Kl7Tx`^9Y4b~BFpgN&dAxQ+s-Q!17rrp5T0Oh`_W2Q_G7FW
z;BywS53nN)Gemz-Da0nj?1UBL)7-!VC=T_7K~rmqM53CMqhHyR%O8wP<e;j&bl*oq
z$Dchn&VWF1{iF?Xvj%+sbyg`%NzZeL<*h<EgW~^Et=1&^Fv$m==ip3Ettho$nE;pq
z>!RFDQS|iHT)cSL`gRfi$yg9*^2lBp!ih^xSK0h9sQ>4OHs7#6`T<HBa+}qH?m5$8
z%K^yGBXw)l-v}StPes~KkTWe^P%cL`0LMMwk^iff%5a4r!{<$l+z;BNq7HGs16iZ{
zg!sGr0*5vE+nW8k1cj|%<bU(;2>CMx{HQF=oJ-zNzwL0u6ybAEy=1kAiFs&S?{+*r
z$%kE!NUBq;cl29l6t+tY18TSL<m6gh2Ul<q7x#2)mv_pT*EF6RlTpSmrAOG~FJF4`
z9t1$208U@jT*qNk2ZD?_YAA^ta_yklektjI7)sq@Zny26m->%HK+#db-(!-!U8znU
zqciXxLb0K{y9P74BL3^!ThJPW+Wct6-QHoM9r;r>1krio5x*bS2U{)HOL^W!O-|8d
zkw-0uzY9dhjz-1A%p)$}r8wrZS3ermc?X1;*9`wmejXiy@ScC#*<>sg^j;)({hZ}D
zaXaH5;kW<F+#3Blh{or!U**4{Eedi4IMVKVhClzxhpjOyh7ndP<1c!j&zX;WMCqXb
z^CME%PU8Cq66_XS(>v!Bh!%{y%E7mB62wk1DeJgt6DO#Ixd<_&7N3y2AVzvVLqW-G
zw=J7Xa4<jJ7LXMeELC{)@~}Z_vJdFzHp%^uQ<*#HH0d{oYwC@$&x4xc4I^(s&M9pZ
zyf#)o1(~>JU{rGZpZpvgCm(!TUWQ@be-XrASM&WR#{*!+A)wX$)V~;EK<p|rR5FJo
z=kY%ck;NPY?BNf@GF=EoXvkD)>{^nWBLBv1<6&{hg`z4TGT<#DFR3C<tX`JKn+zd&
zdfdD(KX33}g_NmBes?dl-!&zCj=T(r8>0H47<o%o?}VFU@^Jw@mpSW}1Qk#BlRMK3
zfp_t_Nh93V2%nap6mOoKPXxO?DWA2>XRjp_7NV3=d*KN44b|GQgw2cSq_=rZ;Th8X
zX7?)T7D$(q-A?y<<YI6t6j7TWl%^wLUdi0H^t;GA7MQ+L<qU{}JaOu!@$g0AtS|jv
z{2*v~1s?hQ2tjY;E$?7vIc>-IJLL2m0r^F>yEZb5cKZIexiRrMEi?@f4w5&g)x9(r
zjxSPb=dUyA!ZYM(XQ{Y`7wUBXXkAS%JuQE|D55Wd`iZ3qgXwc#{36;!zT2G?fm$kW
z-w%VoyI$;NwM9(r-tH;W#n||x32dU{vYl<^`8$W%KqANX0@-R5z4*hwAPsz95dbvW
z1VF}EB*1$DKcx^MgS05=ykd9}5YHx$vf8S*4Hrk^CBNk`b%^=ZPc&XP2%uU{-?JmS
z-guF!PyG5`qAbTZ{+NmlASh{A{qoeig+}z}sWb0+Zu6asR!Cv)8!PDao98~yDpzUd
zVhZ2byORbt%{CU79V^U@p4`4l=g*M%<@uizUHsZS7N{{^?=)<uqkRAep50b^T;nDg
zb7Z;)p)or!D9N156Fj}op?7o|_F``4z6co+e`THc<U{DA=}+sqR9ttMx$c|y-!dK+
z{ironLIFSVuX9j;Hlsi#&tXgawjpu_PoEl$>X7&0mnCF38!a;phbVY6XIwAgPo5kA
z6fL6&2&78do*Qe3PZ>kjw9tm}i!u9=Iwcfr`Rw)hsIKuZItO*FVvYS8PcOHM9gaG-
z<&uNlTG7((i)<X&`D~3uZnILqn@*Wo+?<>5?R0<sqb18wBd-3QoD+6AU_&+ispjrU
z7@hB`0)TLa!W;cNI{jYFg^K@paC|G5!i}I5#q!IAhs+PcscLXBUF}pgv#sWQc3R59
z(kV3Sp{-2{{JFbu047AzLsBpl;uB9b<%s!+hy`N?fi#%^c}it?c@cDbV&-SS@j)?_
z*;M^HMxub_%juJ092$ChlTkuc{Q;kS{m$FqJ^U*tjT)ZZ%N*CSIfaN<*5eAr2>eR>
z@Y&mCG-?M!AV0+~AdMj9^>f?1>2kfV7(P7No*g|SzxWtaI+5P$tEAQGI27w|iyu{<
zu4qh!@wznclPC6btMyPI3*{ElSRu#LdaAC{o6j~WuED(^0vfC36hmTQ`IZ~=9g{)p
z7JL|63U0<j2*Vcinse7YNzhLp^rV8FKIJ3AuH~PYlrzcJ#hZQPQja2c+r-a4k`b{j
zXoUK<`v*P(fk3Ne<kvVm>y>QF3xe<nr7LfKKcsf+@h%PjxSfZm;gJvVErWUP^4bU3
zn6B?PO3is`4Tzup=6i>+vGNAnPj0@nGH9opC~vGeWc6e7Y2Z#}_$q5lNQ5|FQ`LU;
zt6Mg~qj~PrHLG+}0Qu5-`8JIBm6a9K9ZZ~sY$5|1Vr*q4rJv*W4Tubny}dm_=at78
zn0S;~1r=fGd3k9aO4mhzwwrg9v}7jqsyfkL$SwTM(wpPE@-CH(2-0Uaq;6Q3d1cHw
z1qL<(8yKiGH@nVHjLN?5CCBZ9f0}oy<Ke!+UuT)yLgYRUO!QI`e~MtH8%=euC@4?&
zSxTaFBfo`BC6=0;OzPce(ozu}9X%h+*FDaW?48bOa-Yb+n^UR3f22~*`?W~K{K>VS
zOCygV;$l6b;<b8`nPwJ1iCEE5e(Yf-r5|KJ=K=tQlC&qE<^~_Opnn13cyC3_JBG+O
z#m>g<8Lv6}^OxonpZslmY}E<oScE^>&mD~5(!0K4foHPWmo_Qs$Z^zA0cpSW%cZyE
zhF9d+4$@GP)>t@oD53_7S~IfFus7iZSLplq@BS+*7B8u(fq>K2#=nY>^@*d~q%IYh
zKdB!jpAE5i{XA~E&!N^<&8gj1!!l*PKB`?o_sXCP*g4;o_J9&CO1;LZ>gi>%)PsFW
z$rku!<Uq>BD*&TCphe$#Zr74I62%!idBn1~N7<&N@v5t~32qM_r*lQ1fI<m+CM=tq
zxJUNAEWT<)^yR5fiGQq*7w43dy=aE0=QwjUmaB^6CKW^7j@Io4sVC^I;xV<~YuLff
z{R`sF91JWhH0<n=WOj*>mdU?ce}hLC<wA`hlozo|nQ!mRI143-dbyhDyng+XcZzg(
zcNZg(!|3IgFJI_s{jT#uR3$M`-y%*kCFLdlBPlp)Uj_a*qOQI%=6I~yzmIn2Q$%!j
zC!S8ZZ@LT&dhIm}`~LZH>kcC`yUAh*fw$AvL~B((4hh#MstI3V`N7{BI-SV~>qK!s
zF{FVwUd~{9r0<!@TWqRVAj^kZT6H8Gh8VKbnjKq{bv4_+LaW~o(@vmcAkO0`_N#OZ
z7FtP)f2CyPo70AzIu#SW@KlR2H~&=&6wgtv;M&yvbtD9&0)0$2{(rId)nQeB-L@zw
zN($1cq)1D*A`(*4-6hi9V9+Vjt$=iQcSvrfd()flh7ETC{=W0wd(S=h{Bd~1XTz&|
zzwcUW&Nb&4W6pIzmb|w1yuxBaL|dDw`6bM$(%vYTZH~NXYd~`@ixL<~GaQrux9V*Y
z9lnL%-y-KK>NVh&$@Za_fS*h@q5>>e$L%SJ=DE8ldv<(D&@T1THCyv=M}pn*a7~tV
z>?32N-I+j8_=(S9Dl4(tm1SdadKRU!mlBmbR!h51Pxu#zs2LryGkM{1riih)SmXk~
z-`(9EUq(w!&1!h^&NxvhqHmq6#AbR8qmw&sU1F0P+tg=p$*{kCpF1%HvK&JE;GRZd
zZ@dg`M5audljwa(9gk|QsHq6t*L<Nhp^mp0N#a?JTj%xtGsOu6rTK_;O%)^3<9u-N
z^fP_oIK?eLD6dwoZ&d3@?$8;p6k`xn*0gH-!fEEv99j~GZZ=wWiu~Xa%Kh;oNA$@`
zbK|YLb(<P>=+G!BE7ir()^u*_4M6jYkV+s;sFW#5dZa+hy~@Ka;SD7MJ<fdV=497I
zd5~I6KaD_|S1!EPOdz`@TpV>-lP@ekfz!tN>JlSNpvp@~gUdo6JXZ_Z>xMf2JTELF
zw>N(i$8eU1q38Fv1ac>)ufC0!jwMw`T)ZZQ&P94XOPP-2t2R8!Q$BYXb(IJ6Y#e+t
zA&voqIjv#t*dZTp!>m08DH}Lnn6svvRR!5TkWus3TS<|+**4gut*5viBzo~}$+Arj
zd#zQo@u)kODZEL8ERlD^-p|QpB=ePyA8l#Mt_27EvPop3#qX{0ZoFKT%|Eu|yf{VD
z7{{n`S-9We1xqqC**3FvEURaoNc%}J-~cj0d8ie3gWC-1-$-RZ!X=3WHd7i15^M3c
z<`9b`X~+s>aaF-(^%S3%a5J`-l&{LO8GUhinX`I3t9CR31S2GwI*pebecd1S-B%LL
z3K3_A@ii`ypW>jEaM1^O!q4nxQKM#$I^Ksx>x+-F-gRipKePB}&<d*#W>!glb(xMP
ziCPp3KLzXS>kMDL#N73J^Ey4XO$4@3<R&($@o3>Ow!f_S`%>r@X<RT7UxfneL~b>~
zZG<~eFB(Gl`bdntavZ`!vRQ*dd7c(V_`>{sgh_rrEqZH{bs~4+oV6~2Xepo>Wpk{l
zY!k=ExIr;ojd{cTJcYb#hNBzWjnBYZ)g}w`D=8^aK99}#lDphLms4%W(l^rc0u&Vk
zE|1G)WWv?<tT)abHZlo(DKhA4(dA@WAF>KCT)vF_!}QRc0Q;uI^#V$sYGefXeGH`8
zX!0qHm!_r<C3ReWN*a(9=IY<Za^lBqXvix4abH&1?^N0Llgzk#&{bGCbX^dS<jv(h
zeO<j9ouGEn7J)G3+|#E!X|7tDp#U=Ef3U`163f=yv37l2Hr!~@4ST%c?MeMwPd3y>
zBTX23=ErH1n^4rI4(cbXR^2M~d<5N$9SXRA0(_Emr+r#5Wt-h~?}|*wl=Wu&6j?lA
zv7AR@L5r?Gx*t7k?Q&Ey8f|;X0X3Xzd+1)|pb^tnY!L)Yaf!dj<$?bZyf~BGd=HSi
zMegBYrS$ZJjS@b8d3jfPP5ZJ*1M$()yhk&3jbgexI2$YJ)|r$y6Ga=YR!6SVEGDvf
zif?T6s<vZjXy|KX<j{tI7`f$Szu%-#(`8FPc@IkQLHTHNMM6@cUcmqjWTG?~%}1EQ
zWsUA5XOO5xKCKcrHcx+rbOHf~CBv0kdCstB6fW*&ywy-u@kYP7>w<@yL79pju%_Y8
z%!Q==X9WPCD!wEPjvoP`<&9Y>BqZ@7(F=wIR)@{09V3O0TR^eO++Z@kXyo0?=m|23
zkctGxN8|Y<Pl;c+KN~-fZ}^#CzutAU_2L8Y4Sb;@p%F1LJ^ta8tV#K!N-+&*D3UrB
zaMid~`xp9);(L3xe7I=>>VZ$SIxCvp4%4_*F7L3J)CY>*41)>6!h25RBlW4m3;YI&
z(MmHZ;Gyp)IpARoUJUG#W^{co?N6Px9-Nk$u1{unJL+~`krcz`2~myqsmzHl^~InT
zVlEu^w9sPWbU3SaFXICa(<dqL4;f>-xK!}Zy3{ktK1TF9Hp|xHP25Btv;Tl!S~UXG
zYGRwltY!rdUPV+ajA{)l;S%^tT-`zBmjB(bV8KYprFR#(#BQv%cGdFxma430IB?MH
z2HVLDt|o>o);qH@5LW9QUGPJZldSR>FzE+qiNR^Q{{U#=EUYL;^V?oBwP%)^mGMJm
ziZ9NL?Rm9Dp=iK|k5^eblx|K}Co9g0r{4n`L0oC3)anrVd{grm9=C3s=!P@fF@s+*
zCU0ohoa3*p<QHM@PPA@2Rb}l}4lX?*hoe+xpctVC8v%zSTCQ@QdAW|$&3Z6>#qwzJ
zFh)mzo+l!XbD_>LiJT)zCZmr#EC4383@%U*Jn$6|6^rci!Ui$F7H7(h4gQMDdLk4P
z)uX~<d+@$PHgT+gFN`Fk>m=YYA&)CNeN5r^Cqk9Om(%6RL%?wIix`3gYMro%ANQ1V
zxd+9Lsn#hCpSW{KpZ!cfFx)#Z)pTvgy`GQZZFp_pd6<l2aP$^8ieYft+P9Q<Y;fZb
zothHgw~;i(O00)Q-|?NjovPMg%~kirH4qyQF9rd7dmi_ck)0zKG~K0&lj)%o(anOv
z7Hu|#(zv<}lJe$HGiqoly;}Ao|INk`QmA7?NG8kPKtvAeQl-zR!Io@%p?bX~BaZXb
z)o-BZ<W3ypZEvZTdY;l(z3E4AJ2nhYst*HhnQgO<F#SNvVnAEdK5{xPF3;miC~4--
z5GgB2XrDJ;J}F*LX@l>6Ft7B}E!5+#qunM@hJQCjQn<g+KkYj3*M+$&S%6udn$o-u
zJ1hr~zI}@)bD^iFr*?yOnopMG_i2eT@_?WKPyiEj1P^R=uRJj}pkCb_MHB|j_H+Ge
zVOV<xLuWSRQ$y*p&wg;>4q8$yu6|l&q%od`+K`=Q>A5RXa12^ed=*5Qw8!4<QcmUK
z4{3$I>tjl|qOzg)lI*Lld?ZCEa?oM2E1ig(feI#9gk<WY$-+F%?lsb5^5)Lv!5q?{
zuintP|K%(P#W80h481*bLEu<fSb}iYdhU!pV(j<|?FYh-v1CQh1-;Z4F>-vD31bEC
zDKIRlY#}JXk|=SY!~nD?zB<)O{8@bs>&S!Y6y9Bposm!F5)3&XOd`Ex@;cg20e+!#
zA0jY%vN0z{*1YLxvn_DUDOh_@B3XTsD(MUl8Ld8zPLS}I)dg(Q#d5gV$uftXT9xk8
z3L}N>!px$gua%dlc-!^I+ZeE0uc@PT@3b0c5mw@{-w}bgV0i2QzQjiPa0l6DHJn)T
zC*T=G!%}`{dXD+D)x%Lq8c^ILmgfYH&#CHMX%U7?x0)GxXjjQAb@?<Eb)0Eu;wm3k
zt~rG)<T9Tz10V$#z}uolWRnrWxP)T8YmH^GDw|cg{vIY+1!>~|0{C&Zch!+pd(W@%
zu3zEj6;eqXJi||Xfq~VHnE;xnC{aQD?;*&layE)uM|R*7L;T_EyT=J4ha1S^?sJ?Z
z<x!+(Oiu1qU-p@~Q(&OmNx-i4h?)r&im$koRC-+<$wyX$juOiK*PMAevW6m5F*=?+
zjV_Df9WH`nmv<U3maff&K**Ed3F?6<h7wlf1WCqNx*a~-7b_s<Wec#tx*CDl;B9B_
z1-?<#hCjOu&WO<yGiL0ZGvk&eF7`tFkv{YC^(UIIoOdA^uqQZ84^DQ>Ju$ADx>PM8
z#k;l8W(Q|3(eD`MwOXdtwv}_d@#r7Hv=caRsP5Jyu-p~Y^mEc1!xQyD?{D$&o{zVz
z4er-O`GJ68^$=jrA|zvD*0K>6bC-swKOoC{$3kE|VPTz*a<z3&0@V8L69aRxMhVA_
zvF6!VUjmLq5LxstkV;BR$4i|sVTo*n2!5^2zvL*#cjrPmVY!8cCW9H$i=^EKvmZZ^
z_KV%@;fsa<vI=Jl#>%2}os<-@@Va-U#+H=~e`3=^-r?Ykk6<jlTHLSvX!3m(9J+VV
zv~$jKx1q!MZ`#h_?x@+9w{b!}mQh)@ib(%)^SwW@6zONHUL}B|Hn9}xE3neXaIIdt
z{6K9g`Yi2)srJ;|Z@(1!H13_ePPe7z)R=kg)Y#Sv22Asvb?mnRebF$YR?rK8`#jO^
zMEBg$U64E?Q_8qK(2G@f7D1B<pWNd>E@2<^I%8YiC|#YbWOh3;bl@hx&D|nifk>Gx
zQcpv~urLEGv%9N0W(*|bj2qZ5KF}9U|53G+T}TrBQKeYK*c<=NfK--X=BR)&0nc)u
zD@jp%_faz7XsWjbiY#)N8_wHyqkaAu<FI%vaR=Fns~)}NbFH-K43+8#CT$(b*NA2D
zyvtmFLQ&qJZdrY(4ASOndcM|alZL?jbgz2%amRkgz|WI)_~No>OIo8#q^#g+y5!zX
zD1mia0+M8&FW%S##ry&+J+?L{9!RbjPrq^oXXPzffaZf?v-~xf01<WO<VVkt=o?1`
zP!;lzXjDp33y$WQv|>^jw8^`*9)<2mMM>en>u8D{eX@8QxG4bu=ia^0?GJaYJxcCv
zFZv9j*M0>!tnQ?0mxqlao-WcFAHR;VF%8$0H6q9dzvt8hw)zq8b@%ibT%7C%6A8p`
zPF7U%cKVUK|6=y4&QfR$yWRA<GFrla5w<zLkz+d)6}DN`jgO5I+c8%Urf=Njb4Hj~
z=6?&^s=VVuDM7RAl#9l$x%$9btpCPwHn}r~5mZ~M?eY+y!5X#u9BcI=R-U2V^kgjn
zJjvr1UKC66T8K@n_;ylBo@zYdlojWRs`@n1sJboR8HZPnd*c7278pFerHZ^00E2Au
z$Yl2pwl?2x)+p@TrHy0+#CQqI_2Mw60}?v%R$oP6WNSAi%yjd;>W0_lahpr>x#a@n
z4_`EPy@6?|LEl;`&FP&s#w&*i2!OvhyL!~>QUE<Lp)W`}cj!9qr7OhNpU|Avcq+ZH
z&!|zcvo1!K0h%S);D5UvrfhL5rN>yO*uW@1wa)26k_AE_pbj(paJa;vvp7i;SfIh>
z#p%I1H0*q<QHUh_FUu9nYCAP_RL`s-B189|;12&JKP)-*$MDB8{D}|OnLyHfn|@&Z
z-&A-yy7BIvjiIOi=mJ{W-jW8YMLynQZxIGaYB*;VieQV(3hoyBjTfMj0z~SR*pV+^
zNYOR$oQ^K%7QK)Hf1Jm@$$RrDJdf`&Hw694b81ZzRm}p#`@sFul8*ourrinAY1xT;
zlz_bzdFxTAO6C2qi5vwTgxn*33DC3V2DT*0t8%vj@bXvo6ACwUtZ}m}o@3=TNF!oT
z1kS(y+lwGuYy6Go(t{bciW~JnV#UQJf@LLYqYxnDW#|DlIjeRo@~@!?^0$`L@j5H4
z1n}J=yOIX1b4lJp^{-d6=1CeF9`@r4iI4$4VNg*?37t*=+uypj<u9-J%aoRfC%Jnq
z-a6A}z?ARvFVp9b9sq6ND@d70_uJg8LexiSJ}pVnx6?{TPtoGjvzjhu%O9o0frOZO
zMRbk648~Sw;8{sC3Vd4t{BP&Ayg=gi1|pSo$iEkiKr+PwA^xdYV8m=ipV8%i9>}rI
ze0me0QDhQK+x-6p4F6AsM7@&qBHC|C9<nf6>_PT_;`Lv2J=>V?G*o1jqQYK2A=t97
z@c~AW$y(X-#?=)wFtCTNa0eR&JlNm$O4qaLIA_bVnv^UoA#raee!@D_egFt7Y>C#R
zX1>gSvvqH%`G<S7?cP5}Jb~Z&{OO6nAU4FmC438bG3i6`(9Ei;#CRgykeg>0sgbW2
zdZ}iL3r3|isaqlwI1bb9g@E)1AgZ`sZz3|1hYojA1;XcK7SadhIKl@bP2+0@vw~EU
zsd6%=rL2Ds{qv#Iz4dN9Tk~)bp!s8QJEl?+pv>_jYQIbeA|P?%oJ{Cl2f<V_KB1}X
zo0$@)J(TMCp2gDGx*%*&*u-UY=h8F6U*m8x;_J9d0?4!d%bv1WqZBxKk^Zyx(RzC;
z15Vb<PmrYn{Q~&Lf0E_@TAs2<4+x&b5<qi!7E~RDA-Q_ww_jS62i@KVY&HJ_#X!cp
z?w22EG$mOqkfQleN;86g<t>S9Uce;6Nb8sG0S|{T2157&Ul1NonAh4T)p}k~zLk7?
z3Zg+jKHMAYen<)IJY4zSps#|>u$8qk37{wHsf74a#+1V5p8r~lJ^@q^!66625N5n@
z<JCB0g;S;<9^?FYdk}~SxLiCBhgIy3r=2R@l7pBUvT_w}cc9f56JYV>?<Kpjg`dxW
zs)XVs+WvWXh>(U{z>rj9z{|5|=7SPIauG1I!;azgnl;n>GQzo{;pOI7?t^yV$)8i)
zM%xcQzH?`;gL$OrhP~o;#}(Pq`a|V8enA_c2FKsXa{kcYa7PONQqTaXI_^L^+Cw&h
zTm8J+!ZpXc=GWU47~HI858Q~XZZr(>okz14H$BQuCMIp{vJZLKKUx4zw6qzq1LQ)i
zYA2)22I9=sMLuYCK<Cw7j7-S(U?%3MrXAze<<;eM_U^4^(Oz!^0~GYnL%~h86?oRQ
z3;sU?S`YWMLaNJYow=Q;xde91?cnY3oo+2%0!1x%=B<`6f3IT|)vfnAOmMYQ8w%SI
z?6+HCHxchLDo4XZyN3sa(ia0Mx<fA6#2)veVy-^7;d_0=+Cv1Ioag#bHE+P9fQQd&
zxM&1yU-Mk<%FglrUJrAzZnH3GJ<(I3RU5y_=Dee8*>Gz7;_R?p2WE1*=i~w;mR-Mo
z&1MRn6J}>;^B*1zMn*^5LS;Q|TTb*^eQkR3E5FUqCk+f>C%doFIT{<^{TdzJu~`Z2
zpKUgg)0XR>H%VFYbDC;yxrd72e0VtOymN^>*68JBz|?qo*xH-mM2hg3R(eqbTJs6C
zU1XS?PpX_*4&j;s_xI#_5N&g6U}BY(V@E<><}Rf6G=Jnc0RKixi1{(CrfS@gp3~>$
z!~_0><S*|KC}&$sPkAm7X$`6cLf`<lU&x}nH%UWbBJiV45W!nt;o%{{%b^kcr#MZ3
zrynY)<V&)Gf87r_o8<sm2O7QjP(K$SpbrQK$2y~G(MSK7BTS`iwPoct2W}5%JA>8?
z{O22N7dxSR{=xqIKLnUKL*F!>QPV3I=r*J8yUaG9SMQ{vRv!#VUei3X7w~NyQpWk^
zZO_W_R5?v|k}G(S&dzd)k){`%Kbk?UMb_&~VgB(vE83Uyt=g2SI(|HcSjZPl{w9u5
z?a3b(VR&RqVO}SQTuhq33i06I?xErX>SG{#Tlm_$Eh-Ml+W^kU;F{&YBXm$g@aFI8
ztI$X$Bk&{_Z5lo4&11UT`iYd#Z9`4E3;+JTV)Vxde7sn#I)l!6`FigAZ*q=`^j&9n
zJoV}<3|u9PQy0SewiyL1-yuxuIX+KbWml`VrS|dh>D8&4^*)k_ppjElZCg85F;K(v
z5kpa{IFM$lS($h2^Xlh;Ss$#(flw5=slsCN86%_7#+XfdM#c;4-!HXYci((&egYa0
z*TF|LNV|oEgi=8Fs5=0RdDZ>4XC*Fv;s?)-x0Z3}#1Bwp|L|69SS0-o2$6dC+}Hg2
z+p2ALA8v|T+^gUt>e)19xb&WvZ?1^P2{NCwbi9OgP8K`}ekt(Vn!muP4>HJ|Qb<D2
zdGD>Akelu!-hx;|gK}OmlZ#VXuX!-qZ0n<it!FLU6O=!J(Cv-%86G}<_}8z$3tS>1
z+<sSD=_H@GB=k*LasgNZP%!}Do82d+pNNW#WapBmZ2hkYv&4s&u&^*YNSLL{pDe-~
znwvi%C3EeY8|y_m$O4){gt<qB$O&S=M6u(!gt|u%-^^zAY#z5eSUl@baLny2OLHEX
zj6ZdMTuAHMBh-ZZW;3ftW5a4l`SFGT(d1lP5o1vT-luDg#pa2bHQ98SoR0ML3O&o`
z!z$Dx_wm9XO6~3K4BB<EeA{(FO7tomg3Qd!LUSuBkmPI}d@h_4_2*d}q0ID@w6uQb
z+qK)?725T#Sfr%VhK8U6jsrs5zj18Y{~O1))wnH)LB{`}=^HHB3{rTb^|e)(|C8my
zn?pm9Zws@ezSIeOv?34~Xm&;ZlMDW(n;sAA?H2OOsX(z}N`q^LtQ#f}npW@`#A#;G
z#R}<-94M9)q135U^gC7<mxvLgRk54M(YfwDy7MD_pbu~rb~~t0vBurV0Lq7VAeKjR
z4Wrna)+x{RKQzkMtp5D%8#YtzMM;NALZx|z$%p4K9cw|1!B>F#R?&i^Up9Ji;lw=8
zeJ&yOmg?!#JAMmoUZGr8<5JKD4`8D~EYgobM%wfVF(BAK9iSF<b^Ml9dV(3I*Z>_f
zis53c@o+s+5Dg(h|2Vj62(+~!77rf=3^|+q>ghq$ZSfAEqM>m-J^mX$aT+XEW#?b%
z%uv|ACE|XP^d$wyn=fQgxa$~7wN|{J!0-0{4~24}XUgz)p{0BDw{I;vWL}B+AZR~_
zUXi_bju_9coE8PQmYtVpc)GV#cL?#)pXBt_vxaFoy#VPY9V6XR0pB+N)1zz3e#@z`
z=X>*)hxcAzXLO)}i*R{m{K3Hta7^ScteakTclW4P>)(SW@>TBUe|YVSHiujZ4IO0P
z9Udt$J|tR(q(BZwA+4+SduilXu~@BQ@8s2ml}9Y^qY*R>a7CB69b0al?S?%AA4;yn
zO+$O*g`cngPcVNgx$oQjv8Jw?5JUdzZFy)CebN9_n_+T5Tkpi1))Cyiu*+_mn+<f-
z{Yf|^OxGCZ>-{x=4gBBCA6NYjH}y~2w2qLabrtO{FXaOL?c}^d!+)_M)5RkRu3J(x
zvMJr45=l4<p)b|c)FO`3)2Xhp^5A`w5*N5AXMx7_R(1J;csj03Oa#wp{{o=261XgZ
zQP!WC@g_+n^M=e25;AxkE;%X%$tt65a<B1T2QAmT)7ttLsn~RJvJ~K&s7p<3%66W`
z@j2@H2<IO;#nKpbhEQ@aMk&!NSC}1#Gj-ybegfnoAo#``jM#`r3QYIINS*+)NpF*=
z!fL#C%4KxHzPus3kWc?toWb@?{d1xl4YvC|`%ZP{{|5V)aJ?ItHYb|FiX8@NFt(u3
zxnjW4nXG3>_f|V<U!&9b;fKs1Abs!;I!n`R18u4|QK~(6>QvwUH}>yM)PJyloacac
z8VJVHA?}*HxR8N|du`2L!b$oeCT*jlzKp*1=uUDN&2*@&Xz&QSn{mmwW)wf|TXn)s
zjcd=qTU-6-?BB2_?*fG_NoG&iy;7#RLa-yQ!xPcH1e=vBNGxZnK5au?XvYDCktl0n
z6@2ub&exvwxH)9#IKg{6`S_m{%3fZZwzK*;4>(65Y#VEX1dm#S{FvlFDP4n^djtE-
z?yCe~Qmo;hiGTI=S?o4Y0z@}-uu#VfaLDB@_Z|AnNAK*c1u<R~`+j}}e)k7l!f^jF
zF*QT5`9~gYl~?q8C{Q+{{~fbE+)+}q`u~*tYi|kf*YYPZ8Hl9YnE7*r*LLEKH2)ZT
zVx!Vcj3%ukbW<_-=mXPV1-*UYQNbZv>z{&LmUxZz5F$3;jW9t=J#EBRn|UAx{iH|G
z7ut2XV&IELJfRQHu?Qfc<>U;VpHF2<D6FdTk4(;<Ci{ovR&g6~%`mlH=;N{j-v;r<
zxgH4`>!6v?HQl`_<T)U+tjUJ&w=h<R;n$UDw*10#pv|~5GAb%OGIB~E132=5J9Y)N
zp^J-T2nWR6k3MR6TJs_N{7KE=u@uD=VpCTT_%~ae1}r5*)oLxb7Wz^w;L~ELWd(dJ
zG_+n^g>I7n29aGsgE2;rwgyVm@M!OyN#o8VOkR%6zf3vENfHe){Jv~Yxzb|{HnVx1
z^Fb~)x4C;E$sBfdd29?l`m1JEx@w$u1qnTg>&yCTM<x(nmBayH{}?CpmMIV?B7sw{
zu#~dD?5VA5tmBM}E&+qfo&-bgoc=nstYCXc<y1@Ae!s!=`L>e;$z+AI*{Xa&A{+9@
z%4jCIJYW1Z<|X6cfJ;XwP`iPV8X1|4gHO77L@;p3K<|A#wT(r<e~*usZff-=h5997
zh_~ITw1Xw*cIl(0_Pc;JKmTx~P`mGp!>p*WXrC4bWpCrL7cz)P8kR>~L5D*?wU#?W
z<XY?StQuyl74!2`<ytj=-V{RECR!wLvVNFSy)6BplnZ}O|9pZ23Zx6;NubLI95Bs=
z%Yc^336t&QgUM;qlTqr!0bRs+Mag(=Ruq|nd=3wk-HCAR$XiRd9#WK!mhohimnU0H
z_Tl+&D2IOKs2rKBx1)XSi)pm)E1eI6_G^iPAE@1Q_N`12L7s2>xvoxAG?*k{)x5r-
z=3rPw_3XoXXSY;l1Qw;(x0sm8?7wTi0(~ZzyuEr4GnQvviTxIPK_n0>Wi1_@_gre+
zk*;abGN>`gSFx`8_{t>7CoP1lq};ESozQ+n4Tr?iMJ#H(RHfs!4)3>Lrfnq*fNV<S
zuzz;y;*x)4wr*RTJqTG!n^q%XWY_>U@t#gpU!P$KcUb3xrRgltZHHPE&i1MiZz<ly
zhUp1}Gx8+E?MNM-h{r!NtZ4W=r-y+JuH~ShwWeQvyhB3w9*R{H9h|`O36Mt{)6;to
z@vgNT9Ww%I2mQZvXJ?y}k`2J$*FS(gqNx3A0Tux_p;+_GKQM@%KF&rv^eWNua5J=g
zro$muLRykK%}O-W!0@2&3Gm_}>&lfAvH)zs16zSnfAWi;3SJwC$e7C;bPB3xYdv~l
zPj!-Uld={}Z>GwGrB&lIZp75qCD?^D%Jr#%`L8POK1;K@4_@gF2S!;ODP1#(%`d->
z>UahKs?T^Lcz?n{bQp+(I2ZV7lG);}FX%oYI3ggG<Ghl%@aV7~cfWae3X{|=)pcAz
ztk|BSh=!8&0oHHQ0TvF%U&w}nQY_4PX%83hE)_{J02?ulGg8|auMZlFRV}EW(`ak!
zn9tAYfaRJFFoXRwB2#u@fWBZBOh=yQHq>Iq%f7^*%)V3Zi2;dH%!POSDwhJ^^4q%}
zw6nb5e9{_xC;q6+_fH3^Ih4f_@^yv=Q~x$$Fm9h?N+_*8rRi%ew~_c4HijZ|&iQ9D
zVe9UPP0Mkx&nv4aeLbB+K9G`LSXa^X?R*?k*db<NVG-d8#CpMmLeYdU$l^;!3@c{0
zFKanR^>i0KI{ToR29WdwZESd4D~wEGeNTRxe26%jPfgqC?={>!zgj)O_`c<@2TDCo
z50L}3uBf)cR19hbklfH)=LB3ji`I~(DPvy{IBktY;N5!6#oQde5m(~Td>T+Q1zdS>
z0{f@*^o-86?(Vl;Gsmox73OB6OlizOB#@p2a3<uVZCKMKJkuPF{so>C{#N24!BZj8
zeDdRFY3Va>Y*z)=O&Z~3ve+4Y{Si1REIf>;LyQ{GY&3UQ(~6{Nu~N*bU0VmaFVJ!K
zfu<F^a<6hI(G9gZ@|B2{J07&nMYm?>nDBL5GrBV;lO=ZHf2v8fYE_$j=gtcRXw;FB
zcQEh^WZ42dt{{(49s#_4iHnTpxgBBoLSw*YAkF-&D8+GJ6W;<S5X#yp;$oktT(zsk
zqrQCN@C-1LG&m`ttBlmH3xicc)8pCO`{0C-YX%BIyD+A1N>kf;?jBH)$h^Or`UZ>M
z=`btg@=WG;LBYH{c-3%Kzio4}Q>>*1(zpc`%&R~%nD$`y)Qz1k=BDwDMEnQi$CRXU
zO@#QXsri>a^IHqr?kF{7HFmjt=&|OfB|bIT*ff{h#AQkb)E2TWxlVWA39OU#mbe4B
z9JQkL&7qIee3A<v5L=IOH=LzjQ5bLP*x)UJf~I1DF4b_Gw!BNpAeZ6L+Q2a<JV0rM
zG(re+n6In=FAbFb;E(@IF^<VAysEUU*mJk*H2}2x2+HOtKibf~X`hfOEAlUmUVM64
zh}BlV|H#;Z71Z2-%<OBGlUD!`_zoKh(Hd_;{l^-~yc#7GA)X)G@GV>AG{ATrjGH9u
z0cG&DuCHs<WEa|a0<v?4?*#=IAE|@zOU=hiIxZ_LxCn*Jju-?loykj0Aj_+nDO-vd
zx7JG=1cE`Hh%vlfD>#YCuIKYYRgtCPuzARPS3*ai(k5x}EiJ%0=X&&Z4V@k5{asVa
z9dlO<;XA<}F(J#a9n8ewr6UsJ#&c4@+ZiCO%~nxJNNQG3T9fwOZ-TGN1lJJdooFKv
z+#$cIQ9w;=xNkBiC~PBL=_qQ#<ns=}uM!Ec6BHQc=2e+p71mxQKEF-uPR~<7y^%kl
zH;MI^EL!InslT#Tq(K)S=F|^gXYV4SqTiyUM^2_n@@TF+imiuAO`d~AumthCL<RZR
z9j2IdN!V?aFc4L?AijtOZq0w@2wQGar`c-+EyqMid}`0nhIHoMM>Pf4yi(jYP9n?Y
zO29l_2nK&FEFS+0S)itns<6@Xc|NRIWwbbJLeb?Tn!m5$H%n}Xt1N}df|fU?*xS7%
zUE`&_a+f7fcX0Z(@`K5_iw!4nn#iG;Yb2C&l8LK=ucnoUoSBz5p1z>&TMMO+bZBC^
z@yLc+o?2=AYZsTrr6pFQHN}wvwf&!Vw*<!Oa}Z@E{`mJQ4|RjNm6J5Z5V+ZYMcmC0
z=<;UQ%|GQQPJU_&b<>?x)Nwx!SYSj=>wBhq)@_3a`&zW|$??E4g}4!JvCOP`omYah
zh4@bfksl!44cWXF5I5KjN{6IugKQh9{(@TPW>bTh<^iEhh(NDWu()1o0tzW_mX8jo
z$q7h&CH!zz6}TLuYVHfcy8?cX#EC@}NA@^7<D<j?KHz7yCk$@q{$Tp@#yye6yf5#1
zxUPuHhmqXEIvlxK%~3aw>XosZ97XkOQ$d*$a)tD>3R+OM!P>*uko&OdunVs)0$-kM
zLztpu^rM9V^>MqL+DELc?V-dJsGj|*QH<^C&lox7i34<p6zC`Wx~>S?h}hU)lwp_m
z5&Y(!(9rk_dYtWmMeq0=|7LW<3;uWJ?n($8Qc3C%b>(%z!(lXl`mk9%ibg4rJsVH?
zjTYXWDE;O@qhm9t<J#^TsFssM<JshJVQ$t(T%7QB+)wvR2jtXWQr&rc7i*v=UCMZw
ztx@Rr>`S7jT@PFY`sWgRVRqXdjY4)({nb|6^(j<Eszo>+VFrVm=5c&$!$SJwc9GhS
z_@{#~-My+J6Z7_BQ|)|@&lq_f!*lX`R!NfYCSttv&rRz0IjR%AEj<%bZ6LZ#^iA>y
z0?p98Jf|y#xSk;Yivz;9elw!0MSRUW`hBvr;9Y+=wfqT-_Gkz;E2xeJN47*$OGXck
zdu}j$HYZp$Gz0Em&B5ZVOrv@&r?~EPnb;)iFHUa&l<DdBikC^K*3t$mUE$A`r}^N5
z8i5V8Tf@XTf(boA4|I0j>(8&oGAr`+=5#I^2RmKPLvvDIJ26n$ccy+gSASaq-$V3Q
zJriq$98uO@?3FC1V^yD2ax4$N^VMT9>DS=D&<QIt-XsbP3cSOT&==cB3w=Gie=066
z{@tvyfd3dKq@e7$*PCV3BM7U!g7eL|z&0aJCpSH9!1=Dk0#3Kn7=OdMiC0)n%BZV9
zAIzNY7P{PZnr$N#AGE43&*`hHgkj;W>GovwdA_0i=y84|r>WTc^~dWI!F7V>SIrC;
zCkBn2qannji;!Dqu}7&8*6@1mxWOEYC)56YO52a^lDkPAE>DkV+P(ROp8qzzr7{qr
zglf*pNHH1pW{e7IZ!+WS3uPj}8gBlDzrT1ni0!emzfi-TG<f%a`df^Aw@rNIGc_N_
zZ&M`i>)Kw2A|sD4%sCF<Z|f$*5m-~d6?ru>|LgjL@!H7l;xIj`55qScjJV`t_59P%
z3WBKiM0c)v8F5mEH)`JbUg*b%ULP$fpYjX-rn|WZ@yBe~HM5(%fr01vkL#RxqUSeW
zX5u^=c}e?(!j|a)Z&CDjL^Hbj4JOSrvL@>`Bwp&9K{XYQ-ca07bF*P^Eo;XMc?ovS
zePyGc#I@6+MnCy}XD6zVtm||ZUmm{vOWNJR!!c}K;=O`tOytnmCO<FCYBN^&OFE|0
zjpZpnf3EpSCavq5K}&wl!~{yJ1E16~{?5J~s6;1y14_E*bm;a((lR|*BK-=Mm3~uG
z!s^tb5h*Icxh)}`>*)6Cx0@9#@B0&C&fKV~G4a4a$=xc*70-2vG>p~6l&62dc3z*-
zKP05>L-9Wk6K)sXvy_oq_l*(?E4$?!2PhVoabIiO{2g(uaJ%6C|6q+j{96I_@V^yM
z=lrX{-rryG-}uMuf2+`zXZ*JcZT0_iCEU98@c+3FxS2?4W+qN-KT3k2cI=hg1VyA@
zEh@^gn_d$KKW5I+?QW7x>AShCJ1Ddb-Ue`UbLjTZ)b;nzYqVbt&C?<#Dd#7~O#4(b
zr2H<#yU&YjD(aXJlAg|8Vu$kVnf?5sE8;(-C{K@NrCzC;X#|d}rRCH9fxVZRLyP^n
zEpmU#Wfx?&)}0vb_xZfHPO9V<ye(ZY%{*PxLdS<b9~ZVPI^N?Aam`(E<!L@wxz8J7
zr@fxeZEK7Aj6U~){ond~SY7v9E^yoYmYDh2X-eF@_&l6_l+L5yav(IpqG5WFv5^%6
zP7bsF=9ii8tY)%MpEWM3JSR!|2^NB_t>SG?h-GSC@RsY;1vCQ}{g$ADvtl1V<f6iT
zmz*Z$%8?{xJkV|ku}Z_K(*(6c-r0LciCK?M5aZ=#<T!Uly{sB^mq2e<)eduB^_bTP
z(W+xG16eV8VeEqQRrY$$gkQc3;d!{05-VEmm(QzKSmh@Y3_N}^ZRI}SoF@5G@dQ3`
z92?Gc5YGh8+mt@g*hlG?!~6_+eQ<s}C$l2FT14nf8BxT&|6uyWSP3nK(SP6vn{_$4
zch@?N{rTN)H!aDwl15!Re&OBW#@6U4;a~mjN;Z4O3{O7nK327DOfx)q9V=;PW9||b
zSdg|$<=FZy=GFMega^E3;YA#U@BSRxcAroCW8wHR9zO{kW;USfvi$92=q;kaJFop*
z!>M&KpUNKA_+Z8(^}EU+2lixC*Vjfo1);B-kzOHlJ*wDpsQY8_jO-joRD^ynv$tcT
zmwHX7@#n^XMpo5(Btf%B%X`8tBaNY(E6Jj8W|;eeHIl-+6*T)>StSLGTE!<}Y)t&!
z+{%>63x1@Z`IP2;^t#U0+Pf@Ea7!xl!yYAzZZ}QoAzIl_oo{xlGU*a`?qa1}VV#!<
zEv)h1h54TsWqJg3slZWa?2PDMnXYGp<r11WddJ#<<a7B>md>9Qv6&+0?)x($ZJCXo
zn#v!suwU(RTuG1Bcwt8#QAb%Izk6{ckqWIPwsXNULbU97>~V*68yeKL(89BUQ74Db
ze!`b+?nK8~8WnrIbtf#S8`V{T*N|5(h2Q7r&a<CiGURRBDMc7v^Ik#ac9p{Pdd@>*
zt1I=rJLT9fU3z`QipVdCJ_gFPKGZmtC0RFFuoF?>o^yH5=A<uF7FTpwYJ<@jv;y9_
zX*vTLH_7+0z|||MtrvCS60!7w#1|WkKA=~4oG1qi2`dg}(x=RYuP-xiU7C>Hk$_||
zEFH`KJtfU?7bz)OA-)-^^PN9n={{fQ3fP<BQuGJ~a`e1v<YE(dC5JvoXXJu@%8N6f
zbcXiD=cjX*qq-IP5dPwcPEYH{4XlmL_(UPu?1dd;&2BLY_M3y;oc(tSiB(`&NSiuJ
z9tJ_UooAy(IOK>;4u6bdgGwL1J>L`Q4Yr6)a;b_qe`K%A2o?r-Od^`m09>jclX&m`
zcx(`Q@(IncJ<x#L4zDq&#QZ_>s3nqowH&Z*0K@J+zrb$A3Oe;ODcE*0R5f?TuEjn*
zC1*XYQw<C=xU!^-BE7GI8`}G`8fjYt<6~D`5ThCSOqQYUzG-%R(&@>@kE$9i(8%dZ
zm#+K6iCqu^b?cUQ;0xhoa@@Z@Ej_O6trX3<>N4T+{t=<r_-wXf1?kJSz()30#zIyw
zt+{80$Jn10qLn;2tKYH+r_rqoJ(P79+d19w5z%#AK09QK!A;ySaAu8x8)nDZq*l$d
zfg>5qj5GD=1VeLMb<M$cN9#zff2w0<ZbiqfhQLZv>}<e9<#jfdV<wnDnj&z}1_^!N
z+fUNyZl(^m-+T3;!H7<9x$-B(x^32!>ua}6tE{6_Ez9SY92Bubcqp0}1H!!s9iCGL
zJo=+vQrd-><#XD_!=V$ndSHqF+2X_QbLsD8S0PB-Iz9$HwX+t4g@TbCuq_tVH@D3{
zvhjQRWs5g1BKO2pka?p%a&M!E(Kzue@7--QYfmF@!I{hk2M0VskPvyLIN$s9!>+=t
zgTfyVhJqm9)AHR@_YiC$L#VB0l9;}?r~zb5yIeR^T`0hmj=m{A;w>;k<;fvMWq&L@
zRF_rSn)^O;Y;m%jEOnkK9!HPdN4~2Ip9>ZKWFTKpmbEeWXq@r*V4Iq?L=ED==Jf(k
zhO~;*(N!CUdvV_R?%}_`zJKevi)0itCB9ODxfXS+jRSp5f~&V^V1hdDaYho^cWQRk
zzF0dDDLZA}FUc%ue++%70-G~AP-dBQ(%2EDRruq8CRmD_()F3EKtOOZU|#n3kG{xb
zIBvstmZGs|>s-x+jpaMflGDj{Uhih5!m8MM&L^3z9ms?DexSxmoiI4^=QHu9v3eTP
zb+^PP`P!|ZxmUbniQDn5Y<Un=sN$vYhE?=EyXbqI*k0h~fiw23Qt_@{QO$qDdb=@W
znUcV!1Jl;HIr~~&#*-8^FHn1N+mT3BzvTA(q6sjvtt}#-5I3s*G=>2xc3Lrem)?kY
zo}vAGZIxy}mZa-kyqx*Cc!S5f_QCWSQ@@^5xYvFz?TmZ{{B>i#dUGw_0tws<#nP29
zA{Xa8d|C;HJM1T5haVbZHBaIoB&td;MTUQLkne4jnfzz}>Y4kgT_i?z(nWS@vth@4
zFOB)M5WHe?xGmnz|9craj?^VGo(b7p?v>1LEL7K9RBx}Um~2vZB{YmUGUjjmIh2wu
z27MY*Dkhl|8GMS4XTtPDW5#rV+vS*n;=|<^Rg^GxQxYC7hnpbxuGiNp+G65%6#<#v
zI*mKe5>K#04@-+Z8Y?G`9Hy<%s*jmQ2tl|Cz8IxmV|HH3ou=gmxE<baG!u$(QBnAS
zMIRa;QG3{~SV1mwa1r-O=1scj%n3&1QG!2hF`ushlBB6%Go9qa@xwxzFw&YOfxOdI
zgp<#$!0cL+8_Fln8JlBSW9*icRQ65`!tU|j3Vp%{v#f{2gTFpNp@k#XS++Dfua;F-
z1YBqW7bC~MMJRl9LEPEF6WfEjD@v^}{bNzOIk`B0%|xa1hx0t&DQ>8zYa@>Un;Bk=
zrfmSU+{FsAun>lKpX#qRHU$wklqjIOE;hD$FoDB(L#UI>jGsq{n>pdt&ZUyKrC@c`
zKzxMqVJQ~2^lH(h4eeo@Nip`pw6ZW)T|jjS&c_S7QeYopdxBiEA@6;DawilW7V5z-
zi4p3;^KC+_@MSf{dX0R5*IULH^6EBk8L10qrusJUsq$mH=+eFVhrDHXIy<VBjyJ^|
z;nt5Xs5F!O43PZv`UJ(t&PH?lx1STjAC0syJddcElh_FCQW9NJA;+q-a{1Db;9>{c
z>!M9j^svmUWV{tjCgxsKZm+;_@!OC-)Y*R<V)3@X6-m;QhIM-;0AikI*!zWBte;B1
zT_<-U@~|fK7bLk|Gg@~1V;8p{^!3nZzb3=f6Tp*`pZi{4D)N(eKitj<c^p}TVP(!2
zJo^AVfTl%4iRWW$o!>#f-h}DpSj+!0BY86_C=DVVy*=f-?`Dqgw_FLJPVOQqYX467
zX66+p;DNea(!zG-iH6w9B2$|TGV|Uzw$-6k3KSI7SUwYsW1$^{!3>#uv#mblyF-s<
zzePKyB8+A$&|aQ&Ug_;EN+2AN|4soptIyb&Dq2c&V~l%uC;9rvn<Oy&rQ6~t2RYk*
zizEjmK^@!f`{PI9%L}NXNKKmZ@X5{K9p|ZlX&ZA_;yO#PA(JFPGfG;Ypw*`3Xo+{r
z_x^O5-N%YNqn=qoMcDDBoeeRQ{WWsjyxyUyE%IwimN>C6cmJ7i!`TBnwWl<#uYVP^
z>%N$4`0k`ctZ~L^-ie8zD^!B2@P<y*aQ%KKe^i&@{BCE;69LLE*$SCELlLsJ3vB@=
z>>axXoi3~G_;G?3M3DY7M1@RgN<mPQZ;Ny7e8PRRv$@k#|44w8q3lUUpguxf=-7vC
z;!tj>D5KaZBc)LW>T%r{3#b@EF8K$vCeDOp?lh<f4Zq(@Mg3HooRB#vY!Fu>7gZ%O
zhRL3tyQ?O;5c~+I?Q~jB8t4jvn47+<o3w09qE7KtKP+@R-lC$S`u)QIS<v~)gP#l&
z=xW?+47&(J5`d(5uGQ}jH&6_nx}2816@ULO^v2`|s$>|kv)?buY7C30KLP<(^k*qe
zEm8ex?&Graj6GrZqj%Q>da@8Aj*v2^!jQANkwSicZvHBEifOj(s49Ng)Awt39s(sl
z+1`Lxm2QjMTh^}5RgE5^5B(Zer%5(Qzw<S?z?rIa^n7YkJ$?D`9k+<C#bcL~ojFaL
zc3f|7-}(Jh|KPwj_qW71?)qUOzP786n5O`!;Qa8u9n_eDNF8HIpx{T|6;&Npz)9XK
z;Ny2hD>?v7GO}<^N6e0%(jE#S6JBk~M*3NRT$tHk%-G&pv`n6ncO`w&tL*-2F7mjp
zqT?uI51YT(VmB^dmlqC^`+cbtsbfniD$Xug8U;eJ8;oXCAa{FK3I`7ln~3PGwYBwd
z`LAE%jhxz*_(4mH&ojYs$~h^uj+@<}uDB_Y$If|i&d=o_T+Es`NjjzK#yuxu;fCY@
z5vVw-fh_dxBFw90I)m2d@l{OSB=qO|DTcaYi#z_RM<fliEPI)dAG&+=vGgbpHLf6M
z=v(_(4fBP-y~$Zm@}qQK#eI$Z$-#-qTSSD0d0N@u?lP{GIgL48fuJ!$29iGU%LAUO
z$pfnSQj>M1whs?V$2X24hA(V3##mpxcu}<!O{dC$*V5Wjy{vwvKNg-QwlZFdkD#0z
zRcz3yJRKAmm@%aGR#fyp0{rZdmY26iV(%70Gd0g3^YB~o7^Hyxz}Sr7KG0JBK6s+m
zUGK#D6cV;qd(@k!rfJ(n?K!$!FAx?cq%JNmPrT(d>&aWT{nGQ5U{4I=g34nW#d@WD
zJ6Qh|mmQ6AkWa~;Ex<r~BIy*WRx`R(^OZf}3DDp58cw$Rwh|KKug{M*)ed$kfC{Gd
z-*yX*$^9GTs!SvwJEBW4dVKbBDXf47fK?X-<=!qa03bLtELSs~tRO|ak4eKnbv2dz
z?VJ8}Nw}yeFPT%TN-Mi@aP$sx-j5u5lB57oa=zadA*=j1n_q-6fAvXAUv#7@mq<0)
zo&hcH8r?uk&yDf&pu99SL!%5X?#7Jx(lu-IaMu-28%$9h2kLWqdDU`r9v+@?&*Oy!
zjX$MU<eoOu4(`S7_s)+pE*K1McWLo`BHMBC`{=|i%|nWuUe%v2F5DZ>Sy@@_w?=&C
z(nL#6dqT`L8<&F(*q7Yp=|e?6=#{GhTJ41x8{2rD4WhQ}W|UgcaQFA8uT3Kods8uC
zqq*NE6<N#Xvy9bmbs+<L?8kxEx39@_^gNWDufLy^kEL!#y^~9W;b3(##=8wknL$Il
za9FI5)ns^XjDn+RB2OyT{qc1Hcxz3$!{yz(&H`kdc^W-Oj0tfpr!;vL6ZnT5VrZuB
zU_KQ7Hc|Tk$otUT0y0TZvF~2*;g$qS!dusu);A|5#_JQVFUZ^0s!wu_x?h)W69uPm
z$6c3%KV#esJ|}xCX#jK~;CDQ;tc&)q=u#Fo*_i%fZNGS029I4g+*F2Y;ZX*K`jCDt
zLo&gAT$wmOw((Lse3j7poDs)9j+E<KNTO-xt>!<yz4zgFFIV2F6M<n`^|T55*#32G
zyi{QqE!np#UFg$|Q<LYDg|6F##RtHD^}CjngJ}SRGxI(5PuL4g6Wfb18(&S%l8N&^
zo|GXn{BQ+T3+3y1Exd$pmsgf1pB(NEm5^BPcc4$5&we4{E`nNZzxOa05|d_4H$Hkz
zY*SA9a-1^v?q6j+dqnX4qtb1yS0_0!AZah|uaM~4Bw#mxKwh`6jhL2HX4i>f8Sjb;
zdaZiGNI8yg21x-NaUJSGN9VAG2@XrfMj&s{*(XOT>}+j_#F?nD=xk0={Jc(_Cio%n
zDF<6My}#;i%s-eMEH0f>f<#I>e>6_ifwfK>BO~M65KUL1_0ZJ5#OB~5p7xK;U&c$*
zwy6EX<>W*}-wcmiLPC=cHU=|av99IT{8JEK=X$i&_sOauzci`Kuwe8LA#%fMbiY>Z
ziB_(Kpy`V^mN;4RQA19H7jZe83b#|M;O!^&H6mjA{le0s;bZ9YALIX8>$cn^i!j*e
zM29}BU90!*6pJ1|p5&%c99Z=F`ugyKVa^m1PFt$VX$LO6o-TA_yr8Jbt(pWqN-^ch
z%!1SOikyJNPrDH`Sj5E0FDEfb5vukZ;t&9NQu4m}vuKD-PRBpWkUrqz?50n4RrBx=
z3W$Z0+fni7_6b8?T>6%qRcG1ZXFz$rR2M?->z*aCHNgy8C(6-@6o7gC{fdtrH#fcr
zX>2j)EPmfCjK`?zKW=_Dr@jzrg4U|rzg}qIjBeQov%LOB+r}IX_QlOCn+Gh@g?%|B
zj6THp3Q8~im);fW$MiTqMvMrM6+9zo<+gD?q9tdXkKwuuY=EBwA)G}Bb|;L@8J5o#
z=Xy?xP`5vlU{anc0gOZ;G7{%8IW*@_|C7Klt2Z)7yT)Np9oW#A`+K&Ur%hQJe#gH2
zTM;fq8J);(t_FQna%>0S;KMZqb#-vav{X5a#G~GVPsi#C1uCn2N#GmvhMW;8rEp?b
zCO8V_lrOk1Q8?OD$2EhHRr+4>?*y7pmIWkxobR*;;+9v?KWE4rbrv{3(u2rcJ>CZE
ztsy7qX}R4SnmLjyk_scp<AWuQ*tcdvO)@uwr;ev1Y!duS1cjDA%mBWQM4ojX{9T~d
z@lUk|KBv`~{h70%PWe3w9Y&2`yiV&apWv5Prn%ehB@Ma3Yw@7@0(fjg!}P&=F-(S$
ziS?WyLCvOAOf#smak2X9Od2vF;VOEd963k(*Z5QS*^4DR)tE+q>O;xDbry^484Jio
zB&vQM&0cbxvl*_3UA*ycI)j*6%!?Bp+)LYq!E1{3tg8>1%gM6f=v*1k<vhxOL@~71
zCN<5LH(E7c<HF_4YHKj?iC=8IXc&)Z0ihca&b5&NfvU_ay)Ly7j|N+eM&kX7d#Vbf
z|70qsacn&MEHR6-TXq6RtvaXEd=4{8@|yl#hCj5<kK9v~8aFLCRwoO|kulRttirB7
zd|!^0y^K^Q2~aeE&frW?(GLDl$h;r+=Z69<_@UIw>TQ$0_~8`keZBq({FU1hkwp@{
z?g=rYTFLcc$AvQvDk_?<?s~Rg7N~V%rG)kG5|0*UA9>pKU)S|#H-o)^4M>~s!zmnB
zh5|l)K`vcsJ-rk5G?Ps@tz6)?_2^pPVsHC{pnRuu+@9#cQrYeMxMAOzr7}!XX7W@k
z>i*?c?~_&f`RogQzxw%wfY)85{wPd6PuUlP{MD5ta<TO#vh!5($4+h?92xhAPU}H;
zvQ~KGTZk`7X8$%#&54PM>)-p?v+^ewKjvUtr;shI7Y`M@k`2?YS8cE-REt|Judo6Z
z4v_e4A3cJN>C%LqB5Rr%TQ<G9Iqo3IXY}-kX87dLz*nulwue<V?xnOo9J$IPE|+o&
zo$m|SLIVpth+whMcbvMm!$NhI=A8|uL)^wDWEF{uQrcX}RY%VAyx4VKN?$sj6SELb
zcDRJZ-&U?CLit}?QQOyEp(IT#Yf-oRY+Rhtt5Z|$1=)<wT6@bYtBbn0RO{5n#uB*d
z4ETXP*>>mU^AyiLR_gXcw;(6GUNy+&1IutcT`-LpBxACZ6`KUS`rNzu*cV$cLvj;H
ze^Q<X{LL2?1P-y_jQKJ4uvslhz@lYA$-lGx1-AY4V$c`%dJ1RbGE*@AV&d2cU_PIM
zp1r`6ACUeIizT>Xv^qU?AsM@31d@<kyC^y7cw52i1}g$CQ)Cz!KW$hTHxonuu)D{)
zYhTeD(*p>4)^eIOg^@sV4y#3_-uveXH^Qlc@xs`Vppi$Xfp@z>pMbx?^m-(E9ieOj
z**mpRgZ)V)_|9@ENNgW!?7slqU5-A1Bl5jLD8+}}2vu8*B!4qh>g@^_fRx@f+iGTW
z4Ky+CoBt-sbf;<6{#$r*zuR`b*xR?QnB>rylCb&I`TNH=@nX20j<PW?m}hfnU2&H_
z`>?yb3249;!9qy(d0+$!-YliREYm3;FYD4s44;TRu8Pl+O{OsJXGcJxt$VpM^Runa
z1vQj$dzQq8Tu`CUE2B5+C%~CAQ`eW2Mm0(ObQ$?wJKm&`_qnVy77%lV)&k}ErjA$p
zc8X{G?Ck9Qkb7TszCu7`M?9r-<EN;;f@C?oRC&Y-8&I#x@clLiq^9IuTpBBCnv_qQ
zI~a9ymp#<4<)ig&qjdL__4zJ1DyCkKvB~B=D<PlqhTsJ=v)7E=K&&=@tc%7FtR2W+
zy+ecuo@Ha3JWOFy6SlTy0m^*@5izm-N$6$tv7mDbj~&bwl(8W0%m*>=2IYFqjb2$@
zoi_%98)h|Nf-!r+&4v%-JDktrGEav?9_LI5T<o;g!Tb4QrDza%owj-}PElDj4ooy|
z9w9yqY>2<qP{-@NXCsZ2Qlty8gMYv8K9g;E48?L6bbpE!n^f%y?=`wddrqL;YxIWJ
ziiozN;k38B(W5CoDG)4&0*o)kMw{(PV^RJ~Uisy+9^SsbFScsdxsTwi-~>UGrpK~^
zT|ZtU$GP_4fMe*|QJF77D8)icY?r(UI6knaFvCec0txd(r4=L(=unzIe)3!xVebGT
zW_7xbkl^L}r^cmmfP9x%)NFf$uhsSm5qV|27QfbUyJd&-@>K375~JYwb5(;EUTSO`
zW5C3mbp|Me$Y9S0y?Cj3LT`prJ0FY}pOkqDrWDG}`)z21=I)DYCiw!(3GEu*sqB(&
zJX99cF7wA+hQPqEE@wjp112|ViXAAlY8{uRouKV3XrZKh9Uaod1pJ09>mvne2A!cw
z^byycpFpJu9n+D}WL5<$s7`%#yfs~{%5bnT9JC$g0jbE>AY|DQnag%6oN<Q_kD_0F
zyNwTsUV=~|UE)MIt;n<TVV$M>$P;i!9BK@1YwB;2Wtty^P}#5luiCCW9Lm1mk9wZu
zL6U4`DY9l4#x^2LWeXwuZnE!WmqHSfLNTT+jck)8`<l$ym3@~bWE=ZF=KO|w-gD0N
zzUQ3xkK>Ot=DNo1zJJ^IvwipBVtrNR9=p@=nq_-$a?1DS9hy2@NiT_up9#@7!^3rr
za(Y|(&4Se<iyi|3zL0wl_e}5#3A=L4bhLymQrz3giU}6Lfa<=LC}6^HZBDyps0Ja+
z!!rUR=lGK3kj|qOt7~$HZhD=^aoq0ji36H*V&EFptc{Ph+p3_D{&^ZtbIN=H_T(!G
z%}bwy?z6vII%O$cm9B*`-r5z(2Q^=Q^_C$p04c}^!2mHo6(gOMn=6xtZ_&+30)cG9
zrB3Y7D@o{DSfJM(6RX9M@<%MPenRGT*AImp=u~1@E{h8!T)q+hJULm_+uJ)`Ci$qW
zxfw`gQQ;hG<3-uk&aETz036yiAs?$PoS#kd!EIF17kUW0x=SZF&vFnY1x~D01oF^r
zFdfF><d=7bdy@j9Jx)EhU}$^2PDe%PXU{dL4A0Hw)27OB$3A0hOO{Rq(J+%!M&L|0
z4WhKHu>F5T{2^-Bbww|@pkk=#$vo540`myejg2KXxgmn;<jUq2y4-E@i#_?T5vQ&W
zR-Y!x&e1(f-eD@X2e{d2spT!F;ajSzHb4?VveS(`Bn7?<06H}u{7Jrp8z)G(xp9>s
z8BHIFndQ!O$v?XH$=xQ}s!tr#fsh6XW#og!ZaTXAdBY`NOPq|n7m1c(;@6vF7}i57
z@5w>#---g|co79Q?vxFxl?t-q70#_2$@9y9OpjG2J)cz(bMro$7Va>fV9!tE`KRwQ
zt_wKn(f}^|7^*z^EBCy~R}}y<zrHevg!9cPt7ge3g6}+j%LzOl$9?@%)!Y7U_vzE1
zoXuz~_^)yUkH^%n9^>}|A8N2)A`TxqE^C}NFBTRam!*3Q_i9UYg0Rh$HG_YA#CaR)
zl0&hPega8F^y8JC>%RiP<wTVg=&MXrwA=`mq1ysj?G)y@mnRf}_dAY`XRgi=NLn&C
z3M*Zs{U8n0G;=SHE_@pP<ptuYtb<^TQf$e<u_<^gJJ-{ybT}*56EGi0F~C;2<p#_C
zT@G?`H-)!)9d?!$1Gle?uBldJ`}?7f#{*C2qe0%?yJaU3%JDiNQ%OeG*!XsU@p*Y~
zqqjQ8IKL$B3r1P{uJ(nwYj08#*q@}JMx3e2%fpIqKjV}`Gw6q1jP1WTSA2X|I}GII
z#U1sox)sEor%jx6LlQuTrWnNzE1)$<$@~F$=Cc<sM)q2gdEP!=$!7TyTh*0(IaF#o
z?WmR5!63*`YHGh4UN!l<GGm)%K>Wkv{O?N)fW<lE&nHpQUnWjtEP>A97f|j2BpS(U
zf6+HK+LVo^UPpEFfyXHsJLn|-;>BcB2hZELUnBd0j^gj@tQ-w*x6M@7mH~e|RJHXa
zLi_lR^-1x>q>P+sY2p1{yEaLp3%k^T0wi|$M$VTxIxT1ypaNz;98vFoar5i`j!_pb
z=N+A%rKO?2$T)ZRO$t$$!2_fTiLK1P&aa9cs`-COyo>pM9rbPc=;_%M-1B^|MM<GT
z(Rc&?{U`LwFI7lWXG&nF_M)WSAIw8fngiWcBCrdMLnn?c&c)DwlOP1T6gK{tO2G3W
z@xp(Pqq@R%olsN6O&e_eLk$k%@IM|Q)c><a;~I~qr33)w^7f3Os~jVFg82o3Cfmme
z`Wd@(z~apRT%zV=CZ2Qh)?$nWRXsS=xVC63c;j=Lts;)35mJzv@2&uq{)lqP+p4*i
z8WFVau;#x0U>o7{`=+Pd0QF=>7@+#oSHk72_+@TSr>R6DM8j5SJFQx8+a>I50mjxi
z6H+F1CbMv~?gCB%1x{j?9V6wBr4;b_zzAFmU`N*cZD^vIo39n>c#}9M1W=)_&;N<x
zSo`v?8ICnYVJ<*hFd2=fS9MZ8U^lej>ELw4JKU=!oPxMmJEX8LH`4S|18BT{KVi4A
z6DgAXQA}`(JTk-cJHL5>man`^=ozQF0ypR0Kp>s~KLMw${Ei0U(1wq;tXCZI3-|sK
zA>sa)B*(>^#ulg2(T=NvwIgp2>5W}UB*vg|uLuT%Zx4^>o1DZEX0CkmkJPf5$7tV7
zj5vqBY$%6ZJlJQxz)Q45X5>@Y;pYk_(LjOVXQDC<@3a(XMLE`4r!?R$+t=SP7tsm;
z;hV96H;8Wy+~BF%^XbKq-8PAkC}CE1{lmf`Td?QlW^%}WsHviWAB9d>{8Q5@?usqD
zwDDT1_|kJBYc&#Q4{-(qF|2RbLdRYj@B1(QG!jarO<mm<4L&4QLr6t$F7y=u;N5=M
zbG|2%QPlSN$d&@|TNqSqh|&od0|kpnEq)XS#BblDCB}(aomf`?#o|Na0j8sJneBtu
zIZ%VN1x-<UFO860x3pvvg?D7=prW|B`OKG7B#ACIwPY#U5GwkhFFKksw+sypbp?VC
zrU*j5YgZt9RCAr}65|Svj(p*r-^W#9Kc-^kU{g4G;v$!k`Cz(V)S+to7k>ga8aw%b
z`Z!3Es(W^|%VX@6#$t?B_waWwEBC|+Acp~DzQq8u?vesH8Vj_aM8>}D5nNR^gM>)P
zkhmE8E0okwnM%y8u_<^54}A|XL8wr#^{OPb{w2)FqTtPcDxPfn&+43^fv!>u=^zLM
z42vY*+rn%{65OV4Zo(cjRgC~OzwUZx#crGZGkenJBI~`907e~`*Pr7xW$Tk#v93h(
z{?3YpY4DO*VJut}oLRE@FDNN0uk53cwyRu7*KYOr*Agx)wfH5MNWd9bi>&TUX+BSl
ztMB=s^I*Q2i+B<cZ6WLwOjT`6MyVmiqv3G;!w=o>saaXa-yVCKGdQyT@0`rFZ7v|6
zRilFhy!)2KtC~~t2{C6D7?%xu_7U3Ff!x^M1=1fO1$NCCT$^-e{6*wo*V_klIblCq
z6FmS9|6VQGZwOCv^3?M{zGTpQ$eiI6wnh%a6-DQ<`$NCS;XqZe`sEZhwkQbi2LZNb
zWm8j@z`YHQ%a<RXVU}L0m;AJL4FaKcCTaopaZ{@gK;Y|iH-~BmH=(Uf?F=i7q7L+E
z2Zv9TuEJ-==p&_LS67PR742_LNKir)UjmN{u=!;b&%RW+E!%CY{|E!33<hr%-Bs+x
zI0&o(eQ$bwH=CJ&J%kyZ<t!zK7Rct?_QvXnnHrENKaiQuB)HZ;-hOHMf-1dF_`)P>
zFhM$)urIf>*1E|c=i67d1N2@+_@Nm92-4E(qTQ^lrpmyP$#<X2MZ9Qu3Ci>iR7ph0
z%3!cL&BWQ+*{k8M@N2aoWCRs!2d%!b{LTB^Fl1~~*3C9l@zE+B*Im8Rbya3<;Wh6C
z-5UTbqr(*JGCxHJoY%3Dlqc=81PWQ#FDGDpO5;|tHONBwZdb<#G<<a6c+SD?CHp|u
zE5?Zj7A{5*vcbEsdA3%XlfSE){UlZ*@hb7VT{k&Ui#5YTI%`j#FAk>tkvQ^X^T7p9
zeKOi=4B*;7!k1)+(eLyCyx)e9P9$XwctYE%f7e8in;Yu1pr4~hHa(rfZQXnKPR=|M
zsR=TeHDwNW?6wU{oz?H(=dQ1>zkByC<Sf9l`Y{VzmIW!s>a;X8I-4H-`6lIrholbx
ziFg#xygn9G35z}MXmmeQOC9W)8DRw|7ml@cxe4d)_|K69)v+a<_BCg^v4IkZBA@>m
zGgk&s&)yN*rEQ}Pdz?pr<4<kx0==%j%qoJr%!wszilBD0rRzd6Df2zb@Q4GW*~zNK
z{O;ulXQL2)2dXd{GoX558gcSFw>ns~$!m$o1EVx9Ik^=i0qA%+ttYetV$i&2PAiGu
z7W7~$pGfRqN50~Es;bneq=;1n&o^u^U=P{fZY1sjLfl1W)>=VHmDFx4<v9nYwGikL
z#LmwC$jJG1Xrtw28NL*U{7u0MW=X%tsj~hg=AR51rM(?{tFyB1-$rCwTU$fE0taMT
zdiq7Y|M7!QXzWSHJs%>_mp@5~mnznr{OV)yP-6<tb1czq!3~KP*%sKg+xO*y3+9Kx
zQWMR5!-y8=(po$vbd|HHa=9j%T(IhSS{hq|fJw`XU_3dpGXhYz^${%Ab#)J?f6T0Y
zeMFT?SE+;27;(cgdoK2np|Prddp-w0gAWx!!IqIB4i;U!=l$`A2cZE8f<_oLr&^X@
zjv)}zm%GfU<<gPc{P>Y;Qk1}>^PadM6&U6n>`BzV^DkYVp84_OMPbC&(s0q-l+xm0
zQN-W-KiBZ|(ZSR3g<fQ{HEXM*D*@<#Xtw7mgZd3WR}tfN{0fJ1iM#;GBT^cc<zQ#c
zTepOV#hpMlHFIp`M2^J;QDxPglYMu3f%qY&!Uxv@DtH3`2oi5zTsXP)M3&@CJRl!#
z+Q%z)j#axsnS!<f^Ez1MKyRQ@)YPITm+t0;0hp3!Z5e4gy5a>OAaV^$Qc{=*Ctv)J
zOqP92`PlPTWs&;>X93*+m@7&E_V16zMn=B#C>5Y!6?@Tc=4=gc%S{%ef68R_n*BE>
z%W&kMFj)XM<>V-xYAMin10;?2^1#E1&Ay>A$AYgY7qfHcXzmp_`c~_){se5?1wh(x
zs?|g;8HpEJj1EZ!H<MJcP+bJwr}h)ti4>Qf(Nfgj8}{&&O7JvLzru|r!5#7gcc^TB
zz93_9ti6A@wBO*`385;}nz0(hOOQtm-nhb1no|@Dj<{kBfQ<ur#*=pphZwhIUnXGs
zK%lCen|qyA)6Y<C7<L$L{Euo3h1(q1&d>7MpGjIU0esxn;)v4Bgs7R)D_>~5thA5Y
zkAa+d#~gs^iB*`5JW7B4nsSeW@a<jkwHRC5F8m}5Nz~=uA~<T2QHC=9R`7}AKzZ-f
zn*J#kF`E52#HRf?lSlRC#OP_Ty;1UBz;my=a$;kd;Y~K|4o)ap0X7t%_ny_v-!{eX
zk2|=)WmgxbKG-x*fPCq)?Rrv4SM%EO!=61%R_q(go9&Ac;*<8$A%!Y>zkzN$PDaW_
z_;_U~(9Z(Nq7}j^*(yH~aDM=qU8$GGA-tX;fWf)D$LOY}CVI7sXmHl}R^lYRm6_2~
zPU>~=<rXAhC#bzP*EBW)j4k3=ekAunyk9~&u;=^@ds}z?vjvlazxDDRqV2-{s`l|;
z>U(<p5O#Oz0jFqg&wI=1g*_jW9WuO$=M)7?TPm}cp!~CEPuWCxvpc-~y%#g!NEqM=
z%z7J-+Y!ah=#H1C9#dGo?VG<@Eem5B&h?*DZ`y3tICVY+o(WjzM^t)$5GEyFG&Kv0
zyoQE%dURrZym~;+V?e$fA3ED}U>>qjjh{CdMU!Awr|6<G`%1uvg1%|HySu$5wbs{z
zG2>8@qTT5-+oG^l361YBNbosJ@n9=ZQ*(@#yr1)?iIG9h?p#5E8>D#YD@lknE}85)
zh$oMt<GbI(fU?j1&A%O}af<4=)Sk>)Qk1lvU-A*cMN6#gK2v54#%`hS_vbU$R=LR_
z1By?Fn2kYM0$|>bglu^$`^MjKO~3;HQbfG_O~7hBwm0hl@*MhwjDpJa+P4bBg(w~=
zu?9Y~*a6paVv0+>PAEXm*x{brZ7@4K>NNHD56ZgkZxO1ytbb=49|(DVIW6=$Ny1+|
z+-=f)!MA7}Flas^;HSWaJj(4B0DHs{Mdt>XHwd3W@m#LnHKOYODPY?HS|c{ZsJObC
z*VGIfTNKW44xa#81=%ubN(}u4nmNy-g^vga#E0`QTvXT!ipk{8F%7g&UI;9=r8LVo
ziNbMR4X!e!@-Pji45+ck<~Zl;AG2K1vrGtve)HAOG)BGiycZA*SJ9Y#P#C0G4!>95
zSR9TJ)XUBKWTItZQH@y`ET!`I-a}@ajWcZOnoxW|Tooak-I@K!@1OcsaQyRK!*y1Z
zqn*aiH-HQw%tiyW$}%yVXqo_XCj{|wcEK+vSFABCd9EwbKMdAQM5UJna5#UOHS5$>
z1}`S+4(G?aPDugV*)_1od*Z&GjQX@yF`q_7|8cHisPvUVu3p9VoV>EK-y_Ro#u&y5
z4c=wy`yps~3$Oi40xB8(bBBbFw9mq9#q1?z*$30WH(;iDU5kpLH+fthBT?8JF=+X2
zN{K$st9XW1H$g8i9x1tSlWmr|LCBRZ(N!x^z}nWjXDC0vp)s7I@|nw4hU>vV!Kp^#
z)K*l9(7AKZUC#=M289r&%88_}#|x<Tj-Eo$j9Q0G8;4}szHu!6BO$q21K}fvHAZKY
zosDl+0BhwgEGNil&c3VEOzsTJO`Gx5H$ESUDjcz`CG~ge?jp=mUiK>t;NLXx0_Yw7
z;0wRoIcjlsCKn)0>CL%&YNWYGl8tMeI(;zSVG~1i37F@@WkHl=kz`lQl19EWG}Cj&
zKToQ|Y&zIG5tTBObb(MLps^(8602{ZG$@#4l9X6Gs2)&ABB(FqEgd_ZwOu&j0?PLs
ztA{19#x9M8KLDd$Dc_hrO&<Sq5G8RnfgfFzM_jd6%4GRc2qbtx<}Y6-*ylf~^jdxr
z@!UDRXD0OoFkN+1TYt!4cGFxZRm+UbD6T8@e>*?6G7EtpyWX^`!TN1u^S&tHr-<Li
zd?N>bzki{Py{Pds_+NLrzF>l&iL#!pA0lu=Pb|*x!3Ya10B1s6(fwHio`Y3yaj;;$
zSpO;pTMD}L!oUc5B$$9UZ>Xry9CqnoQ2#JDgmUBB-mIjn*kxAm2^h(8Qz)&95R<Fc
z!X8P+sO@;c{c3GdgD)@kGXU)ZQ9MAZqa(S}UOGLykNf!Kc-Qr;nqvd9lDJMe6Js0$
zm=Zk=HPt*ou7Ct}gs|rq*GVIeozc!_SVt;C+MskV>J%DcAH$#yOlU0il?itP#kFet
zVX0*Pm=a~yqVi{q9+Fl9tPMKgOo85tq9;V{<B-j9>?&`dqQ`T_{?}s!LI$E-1{V_a
z<;#vsPHSi9RNbM=V2O=UwH_n>B~g+y?dA_nO2E_?7kfx4cduBi`Qp(@c~BMEkV-F~
zfD&`QFqPA0o97ZHry$dsucNJo_g`)@$5PY9iUE&<7g|Sr#a712@4Ag-OuGxsMniHZ
za4v8<wzm$%E@nRkCF*&#;Ha!dP0MCUPquvimsP_v)Su?afQr6zjwkiCSd@vh4^csx
z(w=y{u1})Cz7H5GAm}Lq5y8sL`u`6M)vwl$k_f>3HW^&~xAgsKP5-;Tzc(qC^g2od
zK}7GHodh!q(_Un%%2`c(4%-QUK|t6-GYB-hX>80?E-6{HzFg@zShZX1)@Cb8*j#A<
zEYsoEXYzq1Z$JS#pE8v?TZ(O0VGX*OSy`A}-DqjCm)FfG>3-fe>b3es2@(G-N5Ad)
z_BPVx*{xychLzNT3j^rj;2`{0^r~Mqs____v?Bt~)45@brV6etg}~3FPX?6OHh8Xy
zNZe@{Yt8f1Z5_t7K{JJ+@qrYAGlgmK645k`RLJrziIew=bPCS1VtXxwN^+~qXe!SY
z9H66D?s6$TRuNhlloQ(D>^CU&X3jfjxY{P#c}GtV14jlbqfM*J);pwq_kNCh%zeM?
zw>9603)+@u30@Sg*<Y5fEm$t!W>L7Iu!|(@vIEuwIBx}R)`a-uYDo1nqoi%yE<vGX
z*?4t{akc*Z(K6ha|7w}+!QpFE`Oo*szO#r@VT&|C2`vs3oD9)oS1AOwhBHgBO**Xh
z2!t*+CgP3o_GtmEvFV-7PU{Cmge!?(kw55ZmQpNr;narCez0+#M~T7~KepHRO1?$|
z@O`2U8+-17;G^qX1&*L}d1S%Bw13Ee<TGpoeYi>Lvc9G7Oh)N4sYyTSoVD7{H*p-T
zcm*2c>PA~IoC12%sZjD4zRTru`gwm{kh10`m)m;+cu3HWnQzCu#%xhI9lNsnISh)>
z;5DY@+duFKr(g`75W81oOUbU1`h=S4d|RD-BIsCh_2TB>@u||L`zh!zb*|<sckZ~;
z3G_vz*lB%~g*shpYDGfVLmhx;kd5vIrN^?;v#Mz16RwJSxEDq~eR|>&Odu6^W*5!Z
zBAKf0Xl&d&yTv@z4M@bA(OTBhVG}P|Db6>Gi}6;o^wauIviqxtC#htc+F0{nx6foB
z=IG^5ht=Yv0WEq-fLZ1V`)d_wO5C@bn#ZXlX~6M#jT-yj7b;j8|1>K2VR>2-ura!N
zF%DiSP;;gS(yI@S5@&}en4@7q^716BtE-@N`gHpe7Z(b%ze<(|1?|9^h1bZ5HTLep
zdZ*~2e(mH`7<tYf27`%9O+6FB-u7_N-Cg*;yakEiAueih>{FBuGb|tpU?~FC8`{bg
zto1Fg2zD=LkH`0J+z|^Kd9cl=01o1m?Fr?N=C*O{^9^P+1=HKW;c;uaHb~z~4!9=@
zSS1Z8$Og-kR&0W^_Z-)Ji4uAs?nQl~8YBFv6@}c0nk@=Dd$44$276RwQDXRUcuAK4
zW+yRPOjqGVx-t^_R!Uen?qZOyEWx1sL<k|*xETzMp93G*IpZTijGC}{9Yim9RjIcO
zWUzt9eYiH_p_T%T19TzDN4sw2Ah8L3=w~LNt>jdHGo9E;pHpMr@{*_6{uLwz>hi&9
zxI}kbKmUL#T{(Jkl7+s=d8wkv&--X`kJGUO2g{UofO)?!#9vCA?UY$4c(0k<v0>Mp
z0}Ea`+z(i(CzZjE*Usiw;%1gBaqqISo@A;f7Ou&0b<hk|JJ7q-?4F8+?Qv_xeG3TY
zi<&(=fX6UNx)1FzGBURLI)LslTTm+5jZ3&H{28B74+(Vjp_FrJ@}I1Hm#!|{*WKS9
z_m53>DG#eX*c1eR#d&(#^;Il+^Nxk;P=(h**;EW8$UFEG)$QBYdDJF|ZB2(LQ@z&l
zvzTqIsOw$exrmz9zkt)U<#gm**Dkrb1y09?<N+$DZ2j61e|nm=gRF{+sp)!wB_YE7
zYT1>?t=4*s{&qV6!*3?73Y&X}NFqIrsE^+$<uBx4-V^it(0ybO-6brIYTDCSFkvTH
zL2(f|WN&CB8`68@bj8^bUvmAYS7k#=KSrFD_)9<)ZBA=Aa*G_#?(KL}B>uhWrSF&(
zanVkX(9SLVT8H#kslnCQGUHmL)JX{B-r4TW_NJIE9rzUs=m|qExgD0ot3EpLw&?9>
z2;@8AP5wyK@<eG5<1L1mkiPPgeaURNi&e!$A2kHB;u4QSTm4)>{d%{#<ILn<$9@*F
zHtN9+bP{7Ye+7KR)7SYfn8rt3!hXBL3Es7edMue5w?CWphUoEbm81_0$JD3O3kR+7
zzONqs5D$TbT)iSa6uVsSyaB5M3DV~+prM%TY^jP-ne1#0gnQ<ucS%}l(W|3t7gCDD
zJ{UPzPtfdr`z}14cWp$R0s;}D@<q|4e}j5qMi^t>zH4zm>yUF*%X7Vl2LgdacjE-H
zgGl-LXXPHuBp0&tx!l~>q?a8>o|>U-o~d}L2?%JzNgxou+_WZkoTufdS|<39OPpTo
zo%h1o?|)pc7wRBwxVJR^EGSq~${<0C3<5E?h{k$73)el6k#TN3x?nx1BtN@GYY!v%
zg?tPyOyKh%Lh%!)!MBjt6e{2wq|F*i>|k%s*#K@N1R{$6vlo6#kqxpiMtpfoNkcJT
I!94Uo0HuA#d;kCd

diff --git a/website/docs/module_kitsu.md b/website/docs/module_kitsu.md
index 9a85f83e3f..05cff87fcc 100644
--- a/website/docs/module_kitsu.md
+++ b/website/docs/module_kitsu.md
@@ -46,8 +46,8 @@ Task status can be automatically set during publish thanks to `Integrate Kitsu N
 There are four settings available:
 - `Set status on note` -> Turns on and off this integrator.
 - `Note shortname` -> Which status shortname should be set automatically (Case sensitive).
-- `Status conditions` -> Conditions that need to be met for kitsu status to be changed. You can add as many conditions as you like. There are two fields to each conditions: `Condition` (Whether current status should be equal or not equal to the condition status) and `Short name` (Kitsu Shortname of the condition status).
-- `Family requirements` -> With this option you can add requirements to which families must be pushed or not in order to have the task status set by this integrator. There are two fields for each requirements: `Condition` (Same as the above) and `Family` (name of the family concerned by this requirement). For instance, adding one item set to `Not equal` and `workfile`, would mean the task status would change if a subset from another family than workfile is published (workfile can still be included), but not if you publish the workfile subset only.
+- `Status change conditions - Status conditions` -> Conditions that need to be met for kitsu status to be changed. You can add as many conditions as you like. There are two fields to each conditions: `Condition` (Whether current status should be equal or not equal to the condition status) and `Short name` (Kitsu Shortname of the condition status).
+- `Status change conditions - Family requirements` -> With this option you can add requirements to which families must be pushed or not in order to have the task status set by this integrator. There are two fields for each requirements: `Condition` (Same as the above) and `Family` (name of the family concerned by this requirement). For instance, adding one item set to `Not equal` and `workfile`, would mean the task status would change if a subset from another family than workfile is published (workfile can still be included), but not if you publish the workfile subset only.
 
 ![Integrate Kitsu Note project settings](assets/integrate_kitsu_note_settings.png)
 

From 3af273679011d230d48aaa97a8d8468e69944c70 Mon Sep 17 00:00:00 2001
From: Sharkitty <hayleylalicorne@gmail.com>
Date: Wed, 22 Mar 2023 14:38:42 +0100
Subject: [PATCH 094/151] linted

---
 .../kitsu/plugins/publish/integrate_kitsu_note.py    | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index a5253d7878..6a1b09dde1 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -65,7 +65,9 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
 
             # Check if any status condition is not met
             allow_status_change = True
-            for status_cond in self.status_change_conditions["status_conditions"]:
+            for status_cond in self.status_change_conditions[
+                "status_conditions"
+            ]:
                 condition = status_cond["condition"] == "equal"
                 match = status_cond["short_name"].upper() == shortname
                 if match and not condition or condition and not match:
@@ -83,13 +85,13 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
                 allow_status_change = False
 
                 # Check if any family requirement is met
-                for family_requirement in self.status_change_conditions["family_requirements"]:
+                for family_requirement in self.status_change_conditions[
+                    "family_requirements"
+                ]:
                     condition = family_requirement["condition"] == "equal"
 
                     for family in families:
-                        match = (
-                            family_requirement["family"].lower() == family
-                        )
+                        match = family_requirement["family"].lower() == family
                         if match and condition or not condition and not match:
                             allow_status_change = True
                             break

From d861e556319bcc4f34fba481d6ec1e0aef9fbc84 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 22 Mar 2023 21:49:00 +0800
Subject: [PATCH 095/151] update the frame range settings

---
 openpype/hosts/max/api/lib.py | 72 ++++++++++++++---------------------
 1 file changed, 28 insertions(+), 44 deletions(-)

diff --git a/openpype/hosts/max/api/lib.py b/openpype/hosts/max/api/lib.py
index f1d1f91dd1..ac8f6aedfe 100644
--- a/openpype/hosts/max/api/lib.py
+++ b/openpype/hosts/max/api/lib.py
@@ -6,13 +6,10 @@ from pymxs import runtime as rt
 from typing import Union
 import contextlib
 
-from openpype.client import (
-    get_project,
-    get_asset_by_name
+from openpype.pipeline.context_tools import (
+    get_current_project_asset,
+    get_current_project
 )
-from openpype.pipeline import legacy_io
-
-from openpype.pipeline.context_tools import get_current_project_asset
 
 
 JSON_PREFIX = "JSON::"
@@ -165,7 +162,7 @@ def get_multipass_setting(project_setting=None):
                            ["multipass"])
 
 
-def set_scene_resolution(width, height):
+def set_scene_resolution(width: int, height: int):
     """Set the render resolution
 
     Args:
@@ -189,49 +186,43 @@ def reset_scene_resolution():
     Returns:
         None
     """
-    project_name = legacy_io.active_project()
-    project_doc = get_project(project_name)
-    project_data = project_doc["data"]
-    asset_data = get_current_project_asset()["data"]
-
+    data = ["data.resolutionWidth", "data.resolutionHeight"]
+    project_resolution = get_current_project(fields=data)["data"]
+    project_resolution_data = project_resolution["data"]
+    asset_resolution = get_current_project_asset(fields=data)["data"]
+    asset_resolution_data = asset_resolution["data"]
     # Set project resolution
-    width_key = "resolutionWidth"
-    height_key = "resolutionHeight"
-    proj_width_key = project_data.get(width_key, 1920)
-    proj_height_key = project_data.get(height_key, 1080)
-
-    width = asset_data.get(width_key, proj_width_key)
-    height = asset_data.get(height_key, proj_height_key)
+    project_width = int(project_resolution_data.get("resolutionWidth", 1920))
+    project_height = int(project_resolution_data.get("resolutionHeight", 1080))
+    width = int(asset_resolution_data.get("resolutionWidth", project_width))
+    height = int(asset_resolution_data.get("resolutionHeight", project_height))
 
     set_scene_resolution(width, height)
 
 
-def get_frame_range():
-    """Get the current assets frame range and handles."""
-    # Set frame start/end
-    project_name = legacy_io.active_project()
-    asset_name = legacy_io.Session["AVALON_ASSET"]
-    asset = get_asset_by_name(project_name, asset_name)
+def get_frame_range() -> dict:
+    """Get the current assets frame range and handles.
 
+    Returns:
+    	dict: with frame start, frame end, handle start, handle end.
+    """
+    # Set frame start/end
+    asset = get_current_project_asset()
     frame_start = asset["data"].get("frameStart")
     frame_end = asset["data"].get("frameEnd")
     # Backwards compatibility
     if frame_start is None or frame_end is None:
         frame_start = asset["data"].get("edit_in")
         frame_end = asset["data"].get("edit_out")
-
     if frame_start is None or frame_end is None:
         return
-
     handles = asset["data"].get("handles") or 0
     handle_start = asset["data"].get("handleStart")
     if handle_start is None:
         handle_start = handles
-
     handle_end = asset["data"].get("handleEnd")
     if handle_end is None:
         handle_end = handles
-
     return {
         "frameStart": frame_start,
         "frameEnd": frame_end,
@@ -240,29 +231,24 @@ def get_frame_range():
     }
 
 
-def reset_frame_range(fps=True):
-    """Set frame range to current asset
+def reset_frame_range(fps: bool=True):
+    """Set frame range to current asset.
 
-    Args:
+    	This is part of 3dsmax documentation:
         animationRange: A System Global variable which lets you get and
-        set an Interval value that defines the start and end frames
-        of the Active Time Segment.
+        	set an Interval value that defines the start and end frames
+        	of the Active Time Segment.
         frameRate: A System Global variable which lets you get
-        and set an Integer value that defines the current
-        scene frame rate in frames-per-second.
+        	and set an Integer value that defines the current
+        	scene frame rate in frames-per-second.
     """
     if fps:
-        fps_number = float(legacy_io.Session.get("AVALON_FPS",
-                                                 25))
+        fps_number = float(get_current_project(fields=["data.fps"])["data"]["fps"])
         rt.frameRate = fps_number
-
     frame_range = get_frame_range()
-
     frame_start = frame_range["frameStart"] - int(frame_range["handleStart"])
     frame_end = frame_range["frameEnd"] + int(frame_range["handleEnd"])
-
     frange_cmd = f"animationRange = interval {frame_start} {frame_end}"
-
     rt.execute(frange_cmd)
 
 
@@ -281,8 +267,6 @@ def set_context_setting():
     """
     reset_scene_resolution()
 
-    reset_frame_range()
-
 
 def get_max_version():
     """

From 4e8354eec810023d83a23616c1af0d76035932a6 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 22 Mar 2023 21:54:43 +0800
Subject: [PATCH 096/151] hound fix

---
 openpype/hosts/max/api/lib.py | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/openpype/hosts/max/api/lib.py b/openpype/hosts/max/api/lib.py
index ac8f6aedfe..09edaaa2ef 100644
--- a/openpype/hosts/max/api/lib.py
+++ b/openpype/hosts/max/api/lib.py
@@ -182,7 +182,6 @@ def reset_scene_resolution():
 
     scene resolution can be overwritten by an asset if the asset.data contains
     any information regarding scene resolution .
-
     Returns:
         None
     """
@@ -204,7 +203,7 @@ def get_frame_range() -> dict:
     """Get the current assets frame range and handles.
 
     Returns:
-    	dict: with frame start, frame end, handle start, handle end.
+        dict: with frame start, frame end, handle start, handle end.
     """
     # Set frame start/end
     asset = get_current_project_asset()
@@ -233,17 +232,18 @@ def get_frame_range() -> dict:
 
 def reset_frame_range(fps: bool=True):
     """Set frame range to current asset.
+    This is part of 3dsmax documentation:
 
-    	This is part of 3dsmax documentation:
-        animationRange: A System Global variable which lets you get and
-        	set an Interval value that defines the start and end frames
-        	of the Active Time Segment.
-        frameRate: A System Global variable which lets you get
-        	and set an Integer value that defines the current
-        	scene frame rate in frames-per-second.
+    animationRange: A System Global variable which lets you get and
+        set an Interval value that defines the start and end frames
+        of the Active Time Segment.
+    frameRate: A System Global variable which lets you get
+            and set an Integer value that defines the current
+            scene frame rate in frames-per-second.
     """
     if fps:
-        fps_number = float(get_current_project(fields=["data.fps"])["data"]["fps"])
+        data_fps = get_current_project(fields=["data.fps"])
+        fps_number = float(data_fps["data"]["fps"])
         rt.frameRate = fps_number
     frame_range = get_frame_range()
     frame_start = frame_range["frameStart"] - int(frame_range["handleStart"])

From e373ccf4e3a747d3db3266f56478cdacfeb0aa3c Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 22 Mar 2023 21:57:19 +0800
Subject: [PATCH 097/151] hound fix

---
 openpype/hosts/max/api/lib.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/max/api/lib.py b/openpype/hosts/max/api/lib.py
index 09edaaa2ef..c398d7cf48 100644
--- a/openpype/hosts/max/api/lib.py
+++ b/openpype/hosts/max/api/lib.py
@@ -230,7 +230,7 @@ def get_frame_range() -> dict:
     }
 
 
-def reset_frame_range(fps: bool=True):
+def reset_frame_range(fps:bool=True):
     """Set frame range to current asset.
     This is part of 3dsmax documentation:
 

From 57308ff488e0a2f931231a455cad13ca23eaaa7e Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 22 Mar 2023 21:58:29 +0800
Subject: [PATCH 098/151] hound fix

---
 openpype/hosts/max/api/lib.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/max/api/lib.py b/openpype/hosts/max/api/lib.py
index c398d7cf48..aa7f72b26c 100644
--- a/openpype/hosts/max/api/lib.py
+++ b/openpype/hosts/max/api/lib.py
@@ -230,7 +230,7 @@ def get_frame_range() -> dict:
     }
 
 
-def reset_frame_range(fps:bool=True):
+def reset_frame_range(fps: bool = True):
     """Set frame range to current asset.
     This is part of 3dsmax documentation:
 

From 62ced23858534c081c4aee84714b236507e64439 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Thu, 23 Mar 2023 00:45:58 +0800
Subject: [PATCH 099/151] remove irrelevant attrs of data

---
 openpype/hosts/max/api/lib.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/max/api/lib.py b/openpype/hosts/max/api/lib.py
index aa7f72b26c..ac7d75db08 100644
--- a/openpype/hosts/max/api/lib.py
+++ b/openpype/hosts/max/api/lib.py
@@ -186,9 +186,9 @@ def reset_scene_resolution():
         None
     """
     data = ["data.resolutionWidth", "data.resolutionHeight"]
-    project_resolution = get_current_project(fields=data)["data"]
+    project_resolution = get_current_project(fields=data)
     project_resolution_data = project_resolution["data"]
-    asset_resolution = get_current_project_asset(fields=data)["data"]
+    asset_resolution = get_current_project_asset(fields=data)
     asset_resolution_data = asset_resolution["data"]
     # Set project resolution
     project_width = int(project_resolution_data.get("resolutionWidth", 1920))

From 499351a2807e58ed8bf770b63566b2b34e6d8fae Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Thu, 23 Mar 2023 00:47:18 +0800
Subject: [PATCH 100/151] remove irrelevant attributes

---
 openpype/hosts/max/api/lib.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/max/api/lib.py b/openpype/hosts/max/api/lib.py
index ac1d158792..39657a2525 100644
--- a/openpype/hosts/max/api/lib.py
+++ b/openpype/hosts/max/api/lib.py
@@ -187,9 +187,9 @@ def reset_scene_resolution():
         None
     """
     data = ["data.resolutionWidth", "data.resolutionHeight"]
-    project_resolution = get_current_project(fields=data)["data"]
+    project_resolution = get_current_project(fields=data)
     project_resolution_data = project_resolution["data"]
-    asset_resolution = get_current_project_asset(fields=data)["data"]
+    asset_resolution = get_current_project_asset(fields=data)
     asset_resolution_data = asset_resolution["data"]
     # Set project resolution
     project_width = int(project_resolution_data.get("resolutionWidth", 1920))

From f823b065d312c8f9dc24d10d51ebcb014319866c Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 22 Mar 2023 22:36:11 +0100
Subject: [PATCH 101/151] celaction: moving conditional workfile parameters
 into settings

---
 .../celaction/hooks/pre_celaction_setup.py    | 22 +++++++++++--------
 .../publish/collect_celaction_cli_kwargs.py   |  2 +-
 .../defaults/project_settings/celaction.json  |  9 ++++++++
 .../schema_project_celaction.json             | 14 ++++++++++++
 4 files changed, 37 insertions(+), 10 deletions(-)

diff --git a/openpype/hosts/celaction/hooks/pre_celaction_setup.py b/openpype/hosts/celaction/hooks/pre_celaction_setup.py
index 62cebf99ed..7506f1a52c 100644
--- a/openpype/hosts/celaction/hooks/pre_celaction_setup.py
+++ b/openpype/hosts/celaction/hooks/pre_celaction_setup.py
@@ -38,8 +38,9 @@ class CelactionPrelaunchHook(PreLaunchHook):
         )
 
         path_to_cli = os.path.join(CELACTION_SCRIPTS_DIR, "publish_cli.py")
-        subproces_args = get_openpype_execute_args("run", path_to_cli)
-        openpype_executable = subproces_args.pop(0)
+        subprocess_args = get_openpype_execute_args("run", path_to_cli)
+        openpype_executable = subprocess_args.pop(0)
+        workfile_settings = self.get_workfile_settings()
 
         winreg.SetValueEx(
             hKey,
@@ -49,15 +50,15 @@ class CelactionPrelaunchHook(PreLaunchHook):
             openpype_executable
         )
 
-        parameters = subproces_args + [
-            "--currentFile", "*SCENE*",
-            "--chunk", "*CHUNK*",
-            "--frameStart", "*START*",
-            "--frameEnd", "*END*",
-            "--resolutionWidth", "*X*",
-            "--resolutionHeight", "*Y*"
+        # add required arguments for workfile path
+        parameters = subprocess_args + [
+            "--currentFile", "*SCENE*"
         ]
 
+        # Add custom parameters from workfile settings
+        if workfile_settings["parameters"]:
+            parameters += workfile_settings["parameters"]
+
         winreg.SetValueEx(
             hKey, "SubmitParametersTitle", 0, winreg.REG_SZ,
             subprocess.list2cmdline(parameters)
@@ -135,3 +136,6 @@ class CelactionPrelaunchHook(PreLaunchHook):
         self.log.info(f"Workfile to open: \"{workfile_path}\"")
 
         return workfile_path
+
+    def get_workfile_settings(self):
+        return self.data["project_settings"]["celaction"]["workfile"]
diff --git a/openpype/hosts/celaction/plugins/publish/collect_celaction_cli_kwargs.py b/openpype/hosts/celaction/plugins/publish/collect_celaction_cli_kwargs.py
index 43b81b83e7..54dea15dff 100644
--- a/openpype/hosts/celaction/plugins/publish/collect_celaction_cli_kwargs.py
+++ b/openpype/hosts/celaction/plugins/publish/collect_celaction_cli_kwargs.py
@@ -39,7 +39,7 @@ class CollectCelactionCliKwargs(pyblish.api.Collector):
             passing_kwargs[key] = value
 
         if missing_kwargs:
-            raise RuntimeError("Missing arguments {}".format(
+            self.log.debug("Missing arguments {}".format(
                 ", ".join(
                     [f'"{key}"' for key in missing_kwargs]
                 )
diff --git a/openpype/settings/defaults/project_settings/celaction.json b/openpype/settings/defaults/project_settings/celaction.json
index bdba6d7322..0194b2c48c 100644
--- a/openpype/settings/defaults/project_settings/celaction.json
+++ b/openpype/settings/defaults/project_settings/celaction.json
@@ -9,6 +9,15 @@
             "rules": {}
         }
     },
+    "workfile": {
+        "parameters": [
+            "--chunk *CHUNK*",
+            "--frameStart *START*",
+            "--frameEnd *END*",
+            "--resolutionWidth *X*",
+            "--resolutionHeight *Y*"
+        ]
+    },
     "publish": {
         "CollectRenderPath": {
             "output_extension": "png",
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_celaction.json b/openpype/settings/entities/schemas/projects_schema/schema_project_celaction.json
index 2320d9ae26..4ca3cbb4da 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_celaction.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_celaction.json
@@ -22,6 +22,20 @@
 
             ]
         },
+        {
+            "type": "dict",
+            "collapsible": true,
+            "key": "workfile",
+            "label": "Workfile",
+            "children": [
+                {
+                    "key": "parameters",
+                    "label": "Parameters",
+                    "type": "list",
+                    "object_type": "text"
+                }
+            ]
+        },
         {
             "type": "dict",
             "collapsible": true,

From 230139baf6dfdad8b131b2547ce76d474f11f777 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Wed, 22 Mar 2023 23:32:19 +0100
Subject: [PATCH 102/151] Fix some minor grammar/typos

---
 .../docs/project_settings/settings_project_global.md   | 10 +++++-----
 website/docs/pype2/admin_presets_plugins.md            |  2 +-
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/website/docs/project_settings/settings_project_global.md b/website/docs/project_settings/settings_project_global.md
index 6c1a269b1f..b6d624caa8 100644
--- a/website/docs/project_settings/settings_project_global.md
+++ b/website/docs/project_settings/settings_project_global.md
@@ -82,8 +82,8 @@ All context filters are lists which may contain strings or Regular expressions (
 - **`tasks`** - Currently processed task. `["modeling", "animation"]`
 
 :::important Filtering
-Filters are optional. In case when multiple profiles match current context, profile with higher number of matched filters has higher priority that profile without filters.
-(Eg. order of when filter is added doesn't matter, only the precision of matching does.)
+Filters are optional. In case when multiple profiles match current context, profile with higher number of matched filters has higher priority than profile without filters.
+(The order the profiles in settings doesn't matter, only the precision of matching does.)
 :::
 
 ## Publish plugins
@@ -94,7 +94,7 @@ Publish plugins used across all integrations.
 ### Extract Review
 Plugin responsible for automatic FFmpeg conversion to variety of formats.
 
-Extract review is using [profile filtering](#profile-filters) to be able render different outputs for different situations.
+Extract review uses [profile filtering](#profile-filters) to render different outputs for different situations.
 
 Applicable context filters:
  **`hosts`** - Host from which publishing was triggered. `["maya", "nuke"]`
@@ -104,7 +104,7 @@ Applicable context filters:
 
 **Output Definitions**
 
-Profile may generate multiple outputs from a single input. Each output must define unique name and output extension (use the extension without a dot e.g. **mp4**). All other settings of output definition are optional.
+A profile may generate multiple outputs from a single input. Each output must define unique name and output extension (use the extension without a dot e.g. **mp4**). All other settings of output definition are optional.
 
 ![global_extract_review_output_defs](assets/global_extract_review_output_defs.png)
 - **`Tags`**
@@ -118,7 +118,7 @@ Profile may generate multiple outputs from a single input. Each output must defi
     - **Output arguments** other FFmpeg output arguments like codec definition.
 
 - **`Output width`** and **`Output height`**
-    - it is possible to rescale output to specified resolution and keep aspect ratio.
+    - It is possible to rescale output to specified resolution and keep aspect ratio.
     - If value is set to 0, source resolution will be used.
 
 - **`Overscan crop`**
diff --git a/website/docs/pype2/admin_presets_plugins.md b/website/docs/pype2/admin_presets_plugins.md
index fcdc09439b..e589f7d14b 100644
--- a/website/docs/pype2/admin_presets_plugins.md
+++ b/website/docs/pype2/admin_presets_plugins.md
@@ -36,7 +36,7 @@ All context filters are lists which may contain strings or Regular expressions (
 - **families** - Main family of processed instance. `["plate", "model"]`
 
 :::important Filtering
-Filters are optional and may not be set. In case when multiple profiles match current context, profile with filters has higher priority that profile without filters.
+Filters are optional and may not be set. In case when multiple profiles match current context, profile with filters has higher priority than profile without filters.
 :::
 
 #### Profile outputs

From 654bef0afcfb5159b541b38c7abd5e4ae50c307e Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Wed, 22 Mar 2023 23:53:30 +0100
Subject: [PATCH 103/151] Tweak logging - preserve order and clarify versions
 with groups

---
 openpype/lib/applications.py | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/openpype/lib/applications.py b/openpype/lib/applications.py
index 7cc296f47b..e9d49337f9 100644
--- a/openpype/lib/applications.py
+++ b/openpype/lib/applications.py
@@ -1508,8 +1508,8 @@ def prepare_app_environments(
         if key in source_env:
             source_env[key] = value
 
-    # `added_env_keys` has debug purpose
-    added_env_keys = {app.group.name, app.name}
+    # `app_and_tool_labels` has debug purpose
+    app_and_tool_labels = ["/".join([app.group.name, app.name])]
     # Environments for application
     environments = [
         app.group.environment,
@@ -1532,15 +1532,14 @@ def prepare_app_environments(
         for group_name in sorted(groups_by_name.keys()):
             group = groups_by_name[group_name]
             environments.append(group.environment)
-            added_env_keys.add(group_name)
             for tool_name in sorted(tool_by_group_name[group_name].keys()):
                 tool = tool_by_group_name[group_name][tool_name]
                 environments.append(tool.environment)
-                added_env_keys.add(tool.name)
+                app_and_tool_labels.append("/".join([group_name, tool_name]))
 
     log.debug(
         "Will add environments for apps and tools: {}".format(
-            ", ".join(added_env_keys)
+            ", ".join(app_and_tool_labels)
         )
     )
 

From aa6dc207f1cad419fd968dfd85d6d0b1923d55ba Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 23 Mar 2023 00:45:50 +0100
Subject: [PATCH 104/151] Fix grammar

---
 openpype/hosts/blender/api/ops.py                  | 4 ++--
 openpype/hosts/photoshop/api/launch_logic.py       | 4 ++--
 openpype/hosts/tvpaint/api/communication_server.py | 4 ++--
 openpype/tools/utils/lib.py                        | 4 ++--
 4 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/openpype/hosts/blender/api/ops.py b/openpype/hosts/blender/api/ops.py
index b1fa13acb9..158c32fb5a 100644
--- a/openpype/hosts/blender/api/ops.py
+++ b/openpype/hosts/blender/api/ops.py
@@ -84,11 +84,11 @@ class MainThreadItem:
         self.kwargs = kwargs
 
     def execute(self):
-        """Execute callback and store it's result.
+        """Execute callback and store its result.
 
         Method must be called from main thread. Item is marked as `done`
         when callback execution finished. Store output of callback of exception
-        information when callback raise one.
+        information when callback raises one.
         """
         print("Executing process in main thread")
         if self.done:
diff --git a/openpype/hosts/photoshop/api/launch_logic.py b/openpype/hosts/photoshop/api/launch_logic.py
index 89ba6ad4e6..25732446b5 100644
--- a/openpype/hosts/photoshop/api/launch_logic.py
+++ b/openpype/hosts/photoshop/api/launch_logic.py
@@ -66,11 +66,11 @@ class MainThreadItem:
         return self._result
 
     def execute(self):
-        """Execute callback and store it's result.
+        """Execute callback and store its result.
 
         Method must be called from main thread. Item is marked as `done`
         when callback execution finished. Store output of callback of exception
-        information when callback raise one.
+        information when callback raises one.
         """
         log.debug("Executing process in main thread")
         if self.done:
diff --git a/openpype/hosts/tvpaint/api/communication_server.py b/openpype/hosts/tvpaint/api/communication_server.py
index e94e64e04a..6f76c25e0c 100644
--- a/openpype/hosts/tvpaint/api/communication_server.py
+++ b/openpype/hosts/tvpaint/api/communication_server.py
@@ -389,11 +389,11 @@ class MainThreadItem:
         self.kwargs = kwargs
 
     def execute(self):
-        """Execute callback and store it's result.
+        """Execute callback and store its result.
 
         Method must be called from main thread. Item is marked as `done`
         when callback execution finished. Store output of callback of exception
-        information when callback raise one.
+        information when callback raises one.
         """
         log.debug("Executing process in main thread")
         if self.done:
diff --git a/openpype/tools/utils/lib.py b/openpype/tools/utils/lib.py
index 8d38f03b8d..950c782727 100644
--- a/openpype/tools/utils/lib.py
+++ b/openpype/tools/utils/lib.py
@@ -862,11 +862,11 @@ class WrappedCallbackItem:
         return self._result
 
     def execute(self):
-        """Execute callback and store it's result.
+        """Execute callback and store its result.
 
         Method must be called from main thread. Item is marked as `done`
         when callback execution finished. Store output of callback of exception
-        information when callback raise one.
+        information when callback raises one.
         """
         if self.done:
             self.log.warning("- item is already processed")

From fb6c1f7f350d8f525e9db61851a0801c18f80669 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 23 Mar 2023 00:48:13 +0100
Subject: [PATCH 105/151] Fix grammar

---
 openpype/hooks/pre_foundry_apps.py                     | 4 ++--
 openpype/modules/example_addons/example_addon/addon.py | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/hooks/pre_foundry_apps.py b/openpype/hooks/pre_foundry_apps.py
index 2092d5025d..21ec8e7881 100644
--- a/openpype/hooks/pre_foundry_apps.py
+++ b/openpype/hooks/pre_foundry_apps.py
@@ -7,7 +7,7 @@ class LaunchFoundryAppsWindows(PreLaunchHook):
 
     Nuke is executed "like" python process so it is required to pass
     `CREATE_NEW_CONSOLE` flag on windows to trigger creation of new console.
-    At the same time the newly created console won't create it's own stdout
+    At the same time the newly created console won't create its own stdout
     and stderr handlers so they should not be redirected to DEVNULL.
     """
 
@@ -18,7 +18,7 @@ class LaunchFoundryAppsWindows(PreLaunchHook):
 
     def execute(self):
         # Change `creationflags` to CREATE_NEW_CONSOLE
-        # - on Windows will nuke create new window using it's console
+        # - on Windows nuke will create new window using its console
         # Set `stdout` and `stderr` to None so new created console does not
         #   have redirected output to DEVNULL in build
         self.launch_context.kwargs.update({
diff --git a/openpype/modules/example_addons/example_addon/addon.py b/openpype/modules/example_addons/example_addon/addon.py
index ead647b41d..be1d3ff920 100644
--- a/openpype/modules/example_addons/example_addon/addon.py
+++ b/openpype/modules/example_addons/example_addon/addon.py
@@ -44,7 +44,7 @@ class AddonSettingsDef(JsonFilesSettingsDef):
 
 
 class ExampleAddon(OpenPypeAddOn, IPluginPaths, ITrayAction):
-    """This Addon has defined it's settings and interface.
+    """This Addon has defined its settings and interface.
 
     This example has system settings with an enabled option. And use
     few other interfaces:

From 47052f7445316e49dff631c91c5967ea7a60b486 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Thu, 23 Mar 2023 11:15:51 +0800
Subject: [PATCH 106/151] incrment workfile version

---
 .../publish/increment_workfile_version.py     | 20 +++++++++++++++++++
 1 file changed, 20 insertions(+)
 create mode 100644 openpype/hosts/max/plugins/publish/increment_workfile_version.py

diff --git a/openpype/hosts/max/plugins/publish/increment_workfile_version.py b/openpype/hosts/max/plugins/publish/increment_workfile_version.py
new file mode 100644
index 0000000000..eda8cd7677
--- /dev/null
+++ b/openpype/hosts/max/plugins/publish/increment_workfile_version.py
@@ -0,0 +1,20 @@
+import pyblish.api
+from openpype.lib import version_up
+from pymxs import runtime as rt
+
+
+class IncrementWorkfileVersion(pyblish.api.ContextPlugin):
+    """Increment current workfile version."""
+
+    order = pyblish.api.IntegratorOrder + 0.9
+    label = "Increment Workfile Version"
+    optional = True
+    hosts = ["max"]
+    families = ["workfile"]
+
+    def process(self, context):
+        path = context.data["currentFile"]
+        filepath = version_up(path)
+
+        rt.saveMaxFile(filepath)
+        self.log.info('Incrementing file version')

From 2130f3d826dbb4e156f02acc680596091a1b4ce8 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Thu, 23 Mar 2023 11:19:46 +0800
Subject: [PATCH 107/151] remove optional

---
 openpype/hosts/max/plugins/publish/increment_workfile_version.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/hosts/max/plugins/publish/increment_workfile_version.py b/openpype/hosts/max/plugins/publish/increment_workfile_version.py
index eda8cd7677..7b4f4e238d 100644
--- a/openpype/hosts/max/plugins/publish/increment_workfile_version.py
+++ b/openpype/hosts/max/plugins/publish/increment_workfile_version.py
@@ -8,7 +8,6 @@ class IncrementWorkfileVersion(pyblish.api.ContextPlugin):
 
     order = pyblish.api.IntegratorOrder + 0.9
     label = "Increment Workfile Version"
-    optional = True
     hosts = ["max"]
     families = ["workfile"]
 

From f681e9843d03a04ef2e5f413b3cc32953c45ced4 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 23 Mar 2023 09:50:28 +0100
Subject: [PATCH 108/151] Extract Review code refactor (#3930)

* Tweak variable names

* Use `filter_profiles` from lib

* Fix type fallback

* Simplify additional family filters

* Use legacy_io.Session instead of os.environ

* Fix logging message

* Indent todo comment for better todo highlighting in Pycharm

* Simplify gap filling logic

* Optimize getting nearest frames

* Fix logic for nearest frame

- This fixes cases where nearest frame isn't directly the next frame

* Refactor `index` in variable `idx` to match `missing_idx` naming

* Use `filter_profiles` from lib

* Match family filter validation of extract review

* Fix typo `overscal` -> `overscan`

* Use `legacy_io.Session` instead of `os.environ`

* Remove unused import

* use 'KnownPublishError' instead of 'AssertionError'

* modify nearest frame logic in holes fill

* Fix unsupported indexing of clique Collection + slightly simplify

---------

Co-authored-by: Jakub Trllo <jakub.trllo@gmail.com>
---
 openpype/plugins/publish/extract_burnin.py |  33 +-
 openpype/plugins/publish/extract_review.py | 396 ++++-----------------
 2 files changed, 82 insertions(+), 347 deletions(-)

diff --git a/openpype/plugins/publish/extract_burnin.py b/openpype/plugins/publish/extract_burnin.py
index 38ec08e8d9..44ba4a5025 100644
--- a/openpype/plugins/publish/extract_burnin.py
+++ b/openpype/plugins/publish/extract_burnin.py
@@ -725,7 +725,6 @@ class ExtractBurnin(publish.Extractor):
             return filtered_burnin_defs
 
         families = self.families_from_instance(instance)
-        low_families = [family.lower() for family in families]
 
         for filename_suffix, orig_burnin_def in burnin_defs.items():
             burnin_def = copy.deepcopy(orig_burnin_def)
@@ -736,7 +735,7 @@ class ExtractBurnin(publish.Extractor):
 
             families_filters = def_filter["families"]
             if not self.families_filter_validation(
-                low_families, families_filters
+                families, families_filters
             ):
                 self.log.debug((
                     "Skipped burnin definition \"{}\". Family"
@@ -773,31 +772,19 @@ class ExtractBurnin(publish.Extractor):
         return filtered_burnin_defs
 
     def families_filter_validation(self, families, output_families_filter):
-        """Determine if entered families intersect with families filters.
+        """Determines if entered families intersect with families filters.
 
         All family values are lowered to avoid unexpected results.
         """
-        if not output_families_filter:
+
+        families_filter_lower = set(family.lower() for family in
+                                    output_families_filter
+                                    # Exclude empty filter values
+                                    if family)
+        if not families_filter_lower:
             return True
-
-        for family_filter in output_families_filter:
-            if not family_filter:
-                continue
-
-            if not isinstance(family_filter, (list, tuple)):
-                if family_filter.lower() not in families:
-                    continue
-                return True
-
-            valid = True
-            for family in family_filter:
-                if family.lower() not in families:
-                    valid = False
-                    break
-
-            if valid:
-                return True
-        return False
+        return any(family.lower() in families_filter_lower
+                   for family in families)
 
     def families_from_instance(self, instance):
         """Return all families of entered instance."""
diff --git a/openpype/plugins/publish/extract_review.py b/openpype/plugins/publish/extract_review.py
index acb1fc10bf..7de92a8bbd 100644
--- a/openpype/plugins/publish/extract_review.py
+++ b/openpype/plugins/publish/extract_review.py
@@ -12,7 +12,7 @@ import pyblish.api
 
 from openpype.lib import (
     get_ffmpeg_tool_path,
-
+    filter_profiles,
     path_to_subprocess_arg,
     run_subprocess,
 )
@@ -23,6 +23,7 @@ from openpype.lib.transcoding import (
     convert_input_paths_for_ffmpeg,
     get_transcode_temp_directory,
 )
+from openpype.pipeline.publish import KnownPublishError
 
 
 class ExtractReview(pyblish.api.InstancePlugin):
@@ -88,21 +89,23 @@ class ExtractReview(pyblish.api.InstancePlugin):
 
     def _get_outputs_for_instance(self, instance):
         host_name = instance.context.data["hostName"]
-        task_name = os.environ["AVALON_TASK"]
         family = self.main_family_from_instance(instance)
 
         self.log.info("Host: \"{}\"".format(host_name))
-        self.log.info("Task: \"{}\"".format(task_name))
         self.log.info("Family: \"{}\"".format(family))
 
-        profile = self.find_matching_profile(
-            host_name, task_name, family
-        )
+        profile = filter_profiles(
+            self.profiles,
+            {
+                "hosts": host_name,
+                "families": family,
+            },
+            logger=self.log)
         if not profile:
             self.log.info((
                 "Skipped instance. None of profiles in presets are for"
-                " Host: \"{}\" | Family: \"{}\" | Task \"{}\""
-            ).format(host_name, family, task_name))
+                " Host: \"{}\" | Family: \"{}\""
+            ).format(host_name, family))
             return
 
         self.log.debug("Matching profile: \"{}\"".format(json.dumps(profile)))
@@ -112,17 +115,19 @@ class ExtractReview(pyblish.api.InstancePlugin):
         filtered_outputs = self.filter_output_defs(
             profile, subset_name, instance_families
         )
+        if not filtered_outputs:
+            self.log.info((
+                "Skipped instance. All output definitions from selected"
+                " profile do not match instance families \"{}\" or"
+                " subset name \"{}\"."
+            ).format(str(instance_families), subset_name))
+
         # Store `filename_suffix` to save arguments
         profile_outputs = []
         for filename_suffix, definition in filtered_outputs.items():
             definition["filename_suffix"] = filename_suffix
             profile_outputs.append(definition)
 
-        if not filtered_outputs:
-            self.log.info((
-                "Skipped instance. All output definitions from selected"
-                " profile does not match to instance families. \"{}\""
-            ).format(str(instance_families)))
         return profile_outputs
 
     def _get_outputs_per_representations(self, instance, profile_outputs):
@@ -216,6 +221,7 @@ class ExtractReview(pyblish.api.InstancePlugin):
         outputs_per_repres = self._get_outputs_per_representations(
             instance, profile_outputs
         )
+
         for repre, output_defs in outputs_per_repres:
             # Check if input should be preconverted before processing
             # Store original staging dir (it's value may change)
@@ -297,10 +303,10 @@ class ExtractReview(pyblish.api.InstancePlugin):
                         shutil.rmtree(new_staging_dir)
 
     def _render_output_definitions(
-        self, instance, repre, src_repre_staging_dir, output_defs
+        self, instance, repre, src_repre_staging_dir, output_definitions
     ):
         fill_data = copy.deepcopy(instance.data["anatomyData"])
-        for _output_def in output_defs:
+        for _output_def in output_definitions:
             output_def = copy.deepcopy(_output_def)
             # Make sure output definition has "tags" key
             if "tags" not in output_def:
@@ -346,10 +352,11 @@ class ExtractReview(pyblish.api.InstancePlugin):
             if temp_data["input_is_sequence"]:
                 self.log.info("Filling gaps in sequence.")
                 files_to_clean = self.fill_sequence_gaps(
-                    temp_data["origin_repre"]["files"],
-                    new_repre["stagingDir"],
-                    temp_data["frame_start"],
-                    temp_data["frame_end"])
+                    files=temp_data["origin_repre"]["files"],
+                    staging_dir=new_repre["stagingDir"],
+                    start_frame=temp_data["frame_start"],
+                    end_frame=temp_data["frame_end"]
+                )
 
             # create or update outputName
             output_name = new_repre.get("outputName", "")
@@ -421,10 +428,10 @@ class ExtractReview(pyblish.api.InstancePlugin):
     def input_is_sequence(self, repre):
         """Deduce from representation data if input is sequence."""
         # TODO GLOBAL ISSUE - Find better way how to find out if input
-        # is sequence. Issues( in theory):
-        # - there may be multiple files ant not be sequence
-        # - remainders are not checked at all
-        # - there can be more than one collection
+        #  is sequence. Issues (in theory):
+        #   - there may be multiple files ant not be sequence
+        #   - remainders are not checked at all
+        #   - there can be more than one collection
         return isinstance(repre["files"], (list, tuple))
 
     def prepare_temp_data(self, instance, repre, output_def):
@@ -816,76 +823,41 @@ class ExtractReview(pyblish.api.InstancePlugin):
                 is done.
 
         Raises:
-            AssertionError: if more then one collection is obtained.
-
+            KnownPublishError: if more than one collection is obtained.
         """
-        start_frame = int(start_frame)
-        end_frame = int(end_frame)
+
         collections = clique.assemble(files)[0]
-        msg = "Multiple collections {} found.".format(collections)
-        assert len(collections) == 1, msg
+        if len(collections) != 1:
+            raise KnownPublishError(
+                "Multiple collections {} found.".format(collections))
+
         col = collections[0]
 
-        # do nothing if no gap is found in input range
-        not_gap = True
-        for fr in range(start_frame, end_frame + 1):
-            if fr not in col.indexes:
-                not_gap = False
-
-        if not_gap:
-            return []
-
-        holes = col.holes()
-
-        # generate ideal sequence
-        complete_col = clique.assemble(
-            [("{}{:0" + str(col.padding) + "d}{}").format(
-                col.head, f, col.tail
-            ) for f in range(start_frame, end_frame)]
-        )[0][0]  # type: clique.Collection
-
-        new_files = {}
-        last_existing_file = None
-
-        for idx in holes.indexes:
-            # get previous existing file
-            test_file = os.path.normpath(os.path.join(
-                staging_dir,
-                ("{}{:0" + str(complete_col.padding) + "d}{}").format(
-                    complete_col.head, idx - 1, complete_col.tail)))
-            if os.path.isfile(test_file):
-                new_files[idx] = test_file
-                last_existing_file = test_file
+        # Prepare which hole is filled with what frame
+        #   - the frame is filled only with already existing frames
+        prev_frame = next(iter(col.indexes))
+        hole_frame_to_nearest = {}
+        for frame in range(int(start_frame), int(end_frame) + 1):
+            if frame in col.indexes:
+                prev_frame = frame
             else:
-                if not last_existing_file:
-                    # previous file is not found (sequence has a hole
-                    # at the beginning. Use first available frame
-                    # there is.
-                    try:
-                        last_existing_file = list(col)[0]
-                    except IndexError:
-                        # empty collection?
-                        raise AssertionError(
-                            "Invalid sequence collected")
-                new_files[idx] = os.path.normpath(
-                    os.path.join(staging_dir, last_existing_file))
+                # Use previous frame as source for hole
+                hole_frame_to_nearest[frame] = prev_frame
 
-        files_to_clean = []
-        if new_files:
-            # so now new files are dict with missing frame as a key and
-            # existing file as a value.
-            for frame, file in new_files.items():
-                self.log.info(
-                    "Filling gap {} with {}".format(frame, file))
+        # Calculate paths
+        added_files = []
+        col_format = col.format("{head}{padding}{tail}")
+        for hole_frame, src_frame in hole_frame_to_nearest.items():
+            hole_fpath = os.path.join(staging_dir, col_format % hole_frame)
+            src_fpath = os.path.join(staging_dir, col_format % src_frame)
+            if not os.path.isfile(src_fpath):
+                raise KnownPublishError(
+                    "Missing previously detected file: {}".format(src_fpath))
 
-                hole = os.path.join(
-                    staging_dir,
-                    ("{}{:0" + str(col.padding) + "d}{}").format(
-                        col.head, frame, col.tail))
-                speedcopy.copyfile(file, hole)
-                files_to_clean.append(hole)
+            speedcopy.copyfile(src_fpath, hole_fpath)
+            added_files.append(hole_fpath)
 
-        return files_to_clean
+        return added_files
 
     def input_output_paths(self, new_repre, output_def, temp_data):
         """Deduce input nad output file paths based on entered data.
@@ -1281,7 +1253,7 @@ class ExtractReview(pyblish.api.InstancePlugin):
         #   'use_input_res' is set to 'True'.
         use_input_res = False
 
-        # Overscal color
+        # Overscan color
         overscan_color_value = "black"
         overscan_color = output_def.get("overscan_color")
         if overscan_color:
@@ -1468,240 +1440,20 @@ class ExtractReview(pyblish.api.InstancePlugin):
                 families.append(family)
         return families
 
-    def compile_list_of_regexes(self, in_list):
-        """Convert strings in entered list to compiled regex objects."""
-        regexes = []
-        if not in_list:
-            return regexes
-
-        for item in in_list:
-            if not item:
-                continue
-
-            try:
-                regexes.append(re.compile(item))
-            except TypeError:
-                self.log.warning((
-                    "Invalid type \"{}\" value \"{}\"."
-                    " Expected string based object. Skipping."
-                ).format(str(type(item)), str(item)))
-
-        return regexes
-
-    def validate_value_by_regexes(self, value, in_list):
-        """Validates in any regex from list match entered value.
-
-        Args:
-            in_list (list): List with regexes.
-            value (str): String where regexes is checked.
-
-        Returns:
-            int: Returns `0` when list is not set or is empty. Returns `1` when
-                any regex match value and returns `-1` when none of regexes
-                match value entered.
-        """
-        if not in_list:
-            return 0
-
-        output = -1
-        regexes = self.compile_list_of_regexes(in_list)
-        for regex in regexes:
-            if not value:
-                continue
-            if re.match(regex, value):
-                output = 1
-                break
-        return output
-
-    def profile_exclusion(self, matching_profiles):
-        """Find out most matching profile byt host, task and family match.
-
-        Profiles are selectively filtered. Each profile should have
-        "__value__" key with list of booleans. Each boolean represents
-        existence of filter for specific key (host, tasks, family).
-        Profiles are looped in sequence. In each sequence are split into
-        true_list and false_list. For next sequence loop are used profiles in
-        true_list if there are any profiles else false_list is used.
-
-        Filtering ends when only one profile left in true_list. Or when all
-        existence booleans loops passed, in that case first profile from left
-        profiles is returned.
-
-        Args:
-            matching_profiles (list): Profiles with same values.
-
-        Returns:
-            dict: Most matching profile.
-        """
-        self.log.info(
-            "Search for first most matching profile in match order:"
-            " Host name -> Task name -> Family."
-        )
-        # Filter all profiles with highest points value. First filter profiles
-        # with matching host if there are any then filter profiles by task
-        # name if there are any and lastly filter by family. Else use first in
-        # list.
-        idx = 0
-        final_profile = None
-        while True:
-            profiles_true = []
-            profiles_false = []
-            for profile in matching_profiles:
-                value = profile["__value__"]
-                # Just use first profile when idx is greater than values.
-                if not idx < len(value):
-                    final_profile = profile
-                    break
-
-                if value[idx]:
-                    profiles_true.append(profile)
-                else:
-                    profiles_false.append(profile)
-
-            if final_profile is not None:
-                break
-
-            if profiles_true:
-                matching_profiles = profiles_true
-            else:
-                matching_profiles = profiles_false
-
-            if len(matching_profiles) == 1:
-                final_profile = matching_profiles[0]
-                break
-            idx += 1
-
-        final_profile.pop("__value__")
-        return final_profile
-
-    def find_matching_profile(self, host_name, task_name, family):
-        """ Filter profiles by Host name, Task name and main Family.
-
-        Filtering keys are "hosts" (list), "tasks" (list), "families" (list).
-        If key is not find or is empty than it's expected to match.
-
-        Args:
-            profiles (list): Profiles definition from presets.
-            host_name (str): Current running host name.
-            task_name (str): Current context task name.
-            family (str): Main family of current Instance.
-
-        Returns:
-            dict/None: Return most matching profile or None if none of profiles
-                match at least one criteria.
-        """
-
-        matching_profiles = None
-        if not self.profiles:
-            return matching_profiles
-
-        highest_profile_points = -1
-        # Each profile get 1 point for each matching filter. Profile with most
-        # points is returned. For cases when more than one profile will match
-        # are also stored ordered lists of matching values.
-        for profile in self.profiles:
-            profile_points = 0
-            profile_value = []
-
-            # Host filtering
-            host_names = profile.get("hosts")
-            match = self.validate_value_by_regexes(host_name, host_names)
-            if match == -1:
-                self.log.debug(
-                    "\"{}\" not found in {}".format(host_name, host_names)
-                )
-                continue
-            profile_points += match
-            profile_value.append(bool(match))
-
-            # Task filtering
-            task_names = profile.get("tasks")
-            match = self.validate_value_by_regexes(task_name, task_names)
-            if match == -1:
-                self.log.debug(
-                    "\"{}\" not found in {}".format(task_name, task_names)
-                )
-                continue
-            profile_points += match
-            profile_value.append(bool(match))
-
-            # Family filtering
-            families = profile.get("families")
-            match = self.validate_value_by_regexes(family, families)
-            if match == -1:
-                self.log.debug(
-                    "\"{}\" not found in {}".format(family, families)
-                )
-                continue
-            profile_points += match
-            profile_value.append(bool(match))
-
-            if profile_points < highest_profile_points:
-                continue
-
-            if profile_points > highest_profile_points:
-                matching_profiles = []
-                highest_profile_points = profile_points
-
-            if profile_points == highest_profile_points:
-                profile["__value__"] = profile_value
-                matching_profiles.append(profile)
-
-        if not matching_profiles:
-            self.log.warning((
-                "None of profiles match your setup."
-                " Host \"{}\" | Task: \"{}\" | Family: \"{}\""
-            ).format(host_name, task_name, family))
-            return
-
-        if len(matching_profiles) == 1:
-            # Pop temporary key `__value__`
-            matching_profiles[0].pop("__value__")
-            return matching_profiles[0]
-
-        self.log.warning((
-            "More than one profile match your setup."
-            " Host \"{}\" | Task: \"{}\" | Family: \"{}\""
-        ).format(host_name, task_name, family))
-
-        return self.profile_exclusion(matching_profiles)
-
     def families_filter_validation(self, families, output_families_filter):
         """Determines if entered families intersect with families filters.
 
         All family values are lowered to avoid unexpected results.
         """
-        if not output_families_filter:
+
+        families_filter_lower = set(family.lower() for family in
+                                    output_families_filter
+                                    # Exclude empty filter values
+                                    if family)
+        if not families_filter_lower:
             return True
-
-        single_families = []
-        combination_families = []
-        for family_filter in output_families_filter:
-            if not family_filter:
-                continue
-            if isinstance(family_filter, (list, tuple)):
-                _family_filter = []
-                for family in family_filter:
-                    if family:
-                        _family_filter.append(family.lower())
-                combination_families.append(_family_filter)
-            else:
-                single_families.append(family_filter.lower())
-
-        for family in single_families:
-            if family in families:
-                return True
-
-        for family_combination in combination_families:
-            valid = True
-            for family in family_combination:
-                if family not in families:
-                    valid = False
-                    break
-
-            if valid:
-                return True
-        return False
+        return any(family.lower() in families_filter_lower
+                   for family in families)
 
     def filter_output_defs(self, profile, subset_name, families):
         """Return outputs matching input instance families.
@@ -1716,14 +1468,10 @@ class ExtractReview(pyblish.api.InstancePlugin):
         Returns:
             list: Containg all output definitions matching entered families.
         """
-        outputs = profile.get("outputs") or []
+        outputs = profile.get("outputs") or {}
         if not outputs:
             return outputs
 
-        # lower values
-        # QUESTION is this valid operation?
-        families = [family.lower() for family in families]
-
         filtered_outputs = {}
         for filename_suffix, output_def in outputs.items():
             output_filters = output_def.get("filter")
@@ -1995,14 +1743,14 @@ class OverscanCrop:
     relative_source_regex = re.compile(r"%([\+\-])")
 
     def __init__(
-        self, input_width, input_height, string_value, overscal_color=None
+        self, input_width, input_height, string_value, overscan_color=None
     ):
         # Make sure that is not None
         string_value = string_value or ""
 
         self.input_width = input_width
         self.input_height = input_height
-        self.overscal_color = overscal_color
+        self.overscan_color = overscan_color
 
         width, height = self._convert_string_to_values(string_value)
         self._width_value = width
@@ -2058,20 +1806,20 @@ class OverscanCrop:
         elif width >= self.input_width and height >= self.input_height:
             output.append(
                 "pad={}:{}:(iw-ow)/2:(ih-oh)/2:{}".format(
-                    width, height, self.overscal_color
+                    width, height, self.overscan_color
                 )
             )
 
         elif width > self.input_width and height < self.input_height:
             output.append("crop=iw:{}".format(height))
             output.append("pad={}:ih:(iw-ow)/2:(ih-oh)/2:{}".format(
-                width, self.overscal_color
+                width, self.overscan_color
             ))
 
         elif width < self.input_width and height > self.input_height:
             output.append("crop={}:ih".format(width))
             output.append("pad=iw:{}:(iw-ow)/2:(ih-oh)/2:{}".format(
-                height, self.overscal_color
+                height, self.overscan_color
             ))
 
         return output

From 90f5cdf7f37942c5dd4c81fd4feee51fe568bd33 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 23 Mar 2023 09:59:56 +0100
Subject: [PATCH 109/151] Use `app.full_name` (#4686)

---
 openpype/lib/applications.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/lib/applications.py b/openpype/lib/applications.py
index e9d49337f9..9c791eff38 100644
--- a/openpype/lib/applications.py
+++ b/openpype/lib/applications.py
@@ -1509,7 +1509,7 @@ def prepare_app_environments(
             source_env[key] = value
 
     # `app_and_tool_labels` has debug purpose
-    app_and_tool_labels = ["/".join([app.group.name, app.name])]
+    app_and_tool_labels = [app.full_name]
     # Environments for application
     environments = [
         app.group.environment,
@@ -1535,7 +1535,7 @@ def prepare_app_environments(
             for tool_name in sorted(tool_by_group_name[group_name].keys()):
                 tool = tool_by_group_name[group_name][tool_name]
                 environments.append(tool.environment)
-                app_and_tool_labels.append("/".join([group_name, tool_name]))
+                app_and_tool_labels.append(tool.full_name)
 
     log.debug(
         "Will add environments for apps and tools: {}".format(

From a14b645d892e71ef60c6e15da0a9e7f350d6b66f Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 23 Mar 2023 10:01:50 +0100
Subject: [PATCH 110/151] Fix class name and docstring (#4683)

---
 openpype/hooks/pre_create_extra_workdir_folders.py | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/openpype/hooks/pre_create_extra_workdir_folders.py b/openpype/hooks/pre_create_extra_workdir_folders.py
index c5af620c87..8856281120 100644
--- a/openpype/hooks/pre_create_extra_workdir_folders.py
+++ b/openpype/hooks/pre_create_extra_workdir_folders.py
@@ -3,10 +3,13 @@ from openpype.lib import PreLaunchHook
 from openpype.pipeline.workfile import create_workdir_extra_folders
 
 
-class AddLastWorkfileToLaunchArgs(PreLaunchHook):
-    """Add last workfile path to launch arguments.
+class CreateWorkdirExtraFolders(PreLaunchHook):
+    """Create extra folders for the work directory.
+
+    Based on setting `project_settings/global/tools/Workfiles/extra_folders`
+    profile filtering will decide whether extra folders need to be created in
+    the work directory.
 
-    This is not possible to do for all applications the same way.
     """
 
     # Execute after workfile template copy

From 5995750ec1eff10ad5265b60ce75dfb1b72a8262 Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Thu, 23 Mar 2023 09:14:58 +0000
Subject: [PATCH 111/151] Functionality

---
 openpype/hosts/maya/plugins/create/create_review.py      | 2 ++
 openpype/hosts/maya/plugins/publish/extract_playblast.py | 5 ++++-
 openpype/hosts/maya/plugins/publish/extract_thumbnail.py | 5 ++++-
 3 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/maya/plugins/create/create_review.py b/openpype/hosts/maya/plugins/create/create_review.py
index f1b626c06b..e709239ae7 100644
--- a/openpype/hosts/maya/plugins/create/create_review.py
+++ b/openpype/hosts/maya/plugins/create/create_review.py
@@ -26,6 +26,7 @@ class CreateReview(plugin.Creator):
         "alpha cut"
     ]
     useMayaTimeline = True
+    panZoom = False
 
     def __init__(self, *args, **kwargs):
         super(CreateReview, self).__init__(*args, **kwargs)
@@ -45,5 +46,6 @@ class CreateReview(plugin.Creator):
         data["keepImages"] = self.keepImages
         data["imagePlane"] = self.imagePlane
         data["transparency"] = self.transparency
+        data["panZoom"] = self.panZoom
 
         self.data = data
diff --git a/openpype/hosts/maya/plugins/publish/extract_playblast.py b/openpype/hosts/maya/plugins/publish/extract_playblast.py
index 94571ff731..31cb3435ac 100644
--- a/openpype/hosts/maya/plugins/publish/extract_playblast.py
+++ b/openpype/hosts/maya/plugins/publish/extract_playblast.py
@@ -114,7 +114,10 @@ class ExtractPlayblast(publish.Extractor):
 
         # Disable Pan/Zoom.
         pan_zoom = cmds.getAttr("{}.panZoomEnabled".format(preset["camera"]))
-        cmds.setAttr("{}.panZoomEnabled".format(preset["camera"]), False)
+        cmds.setAttr(
+            "{}.panZoomEnabled".format(preset["camera"]),
+            instance.data["panZoom"]
+        )
 
         # Need to explicitly enable some viewport changes so the viewport is
         # refreshed ahead of playblasting.
diff --git a/openpype/hosts/maya/plugins/publish/extract_thumbnail.py b/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
index 1d94bd58c5..ba8712c73d 100644
--- a/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
+++ b/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
@@ -124,7 +124,10 @@ class ExtractThumbnail(publish.Extractor):
 
         # Disable Pan/Zoom.
         pan_zoom = cmds.getAttr("{}.panZoomEnabled".format(preset["camera"]))
-        cmds.setAttr("{}.panZoomEnabled".format(preset["camera"]), False)
+        cmds.setAttr(
+            "{}.panZoomEnabled".format(preset["camera"]),
+            instance.data["panZoom"]
+        )
 
         with lib.maintained_time():
             # Force viewer to False in call to capture because we have our own

From d791000b80cb0b4b05e4d0a4d04edafcf44f65e5 Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Thu, 23 Mar 2023 09:25:15 +0000
Subject: [PATCH 112/151] Settings

---
 openpype/settings/defaults/project_settings/maya.json        | 3 ++-
 .../schemas/projects_schema/schemas/schema_maya_capture.json | 5 +++++
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/openpype/settings/defaults/project_settings/maya.json b/openpype/settings/defaults/project_settings/maya.json
index 2aa95fd1be..4a97ea8a09 100644
--- a/openpype/settings/defaults/project_settings/maya.json
+++ b/openpype/settings/defaults/project_settings/maya.json
@@ -817,7 +817,8 @@
                 },
                 "Generic": {
                     "isolate_view": true,
-                    "off_screen": true
+                    "off_screen": true,
+                    "pan_zoom": false
                 },
                 "Renderer": {
                     "rendererName": "vp2Renderer"
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
index 1f0e4eeffb..8d37aa299e 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
@@ -91,6 +91,11 @@
                             "type": "boolean",
                             "key": "off_screen",
                             "label": "            Off Screen"
+                        },
+                        {
+                            "type": "boolean",
+                            "key": "pan_zoom",
+                            "label": "            2D Pan/Zoom"
                         }
                     ]
                 },

From 21c25ac21c3d362c6f602a30706a3c480ab46620 Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Thu, 23 Mar 2023 09:25:22 +0000
Subject: [PATCH 113/151] Code cosmetics

---
 .../maya/plugins/publish/extract_thumbnail.py | 46 +++++++++----------
 1 file changed, 23 insertions(+), 23 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_thumbnail.py b/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
index ba8712c73d..2d3daa53c6 100644
--- a/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
+++ b/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
@@ -26,28 +26,28 @@ class ExtractThumbnail(publish.Extractor):
     def process(self, instance):
         self.log.info("Extracting capture..")
 
-        camera = instance.data['review_camera']
+        camera = instance.data["review_camera"]
 
-        capture_preset = (
-            instance.context.data["project_settings"]['maya']['publish']['ExtractPlayblast']['capture_preset']
-        )
+        maya_setting = instance.context.data["project_settings"]["maya"]
+        plugin_setting = maya_setting["publish"]["ExtractPlayblast"]
+        capture_preset = plugin_setting["capture_preset"]
         override_viewport_options = (
-            capture_preset['Viewport Options']['override_viewport_options']
+            capture_preset["Viewport Options"]["override_viewport_options"]
         )
 
         try:
             preset = lib.load_capture_preset(data=capture_preset)
         except KeyError as ke:
-            self.log.error('Error loading capture presets: {}'.format(str(ke)))
+            self.log.error("Error loading capture presets: {}".format(str(ke)))
             preset = {}
-        self.log.info('Using viewport preset: {}'.format(preset))
+        self.log.info("Using viewport preset: {}".format(preset))
 
         # preset["off_screen"] =  False
 
-        preset['camera'] = camera
-        preset['start_frame'] = instance.data["frameStart"]
-        preset['end_frame'] = instance.data["frameStart"]
-        preset['camera_options'] = {
+        preset["camera"] = camera
+        preset["start_frame"] = instance.data["frameStart"]
+        preset["end_frame"] = instance.data["frameStart"]
+        preset["camera_options"] = {
             "displayGateMask": False,
             "displayResolution": False,
             "displayFilmGate": False,
@@ -74,14 +74,14 @@ class ExtractThumbnail(publish.Extractor):
         # used, if not then the asset resolution is
         # used
         if review_instance_width and review_instance_height:
-            preset['width'] = review_instance_width
-            preset['height'] = review_instance_height
+            preset["width"] = review_instance_width
+            preset["height"] = review_instance_height
         elif width_preset and height_preset:
-            preset['width'] = width_preset
-            preset['height'] = height_preset
+            preset["width"] = width_preset
+            preset["height"] = height_preset
         elif asset_width and asset_height:
-            preset['width'] = asset_width
-            preset['height'] = asset_height
+            preset["width"] = asset_width
+            preset["height"] = asset_height
 
         # Create temp directory for thumbnail
         # - this is to avoid "override" of source file
@@ -96,8 +96,8 @@ class ExtractThumbnail(publish.Extractor):
 
         self.log.info("Outputting images to %s" % path)
 
-        preset['filename'] = path
-        preset['overwrite'] = True
+        preset["filename"] = path
+        preset["overwrite"] = True
 
         pm.refresh(f=True)
 
@@ -133,7 +133,7 @@ class ExtractThumbnail(publish.Extractor):
             # Force viewer to False in call to capture because we have our own
             # viewer opening call to allow a signal to trigger between
             # playblast and viewer
-            preset['viewer'] = False
+            preset["viewer"] = False
 
             # Update preset with current panel setting
             # if override_viewport_options is turned off
@@ -156,9 +156,9 @@ class ExtractThumbnail(publish.Extractor):
             instance.data["representations"] = []
 
         representation = {
-            'name': 'thumbnail',
-            'ext': 'jpg',
-            'files': thumbnail,
+            "name": "thumbnail",
+            "ext": "jpg",
+            "files": thumbnail,
             "stagingDir": dst_staging,
             "thumbnail": True
         }

From 4d53e4f5fb81e633eb0a404d6cbca7da152572a8 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 23 Mar 2023 10:27:02 +0100
Subject: [PATCH 114/151] Application launch context: Include app group name in
 logger (#4684)

* Include app group name with app name for logger

* Include app group name in launch finished log message

* Include app group name with launching message

* Use `application.full_name` instead
---
 openpype/lib/applications.py | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/openpype/lib/applications.py b/openpype/lib/applications.py
index 9c791eff38..127d31d042 100644
--- a/openpype/lib/applications.py
+++ b/openpype/lib/applications.py
@@ -889,7 +889,8 @@ class ApplicationLaunchContext:
         self.modules_manager = ModulesManager()
 
         # Logger
-        logger_name = "{}-{}".format(self.__class__.__name__, self.app_name)
+        logger_name = "{}-{}".format(self.__class__.__name__,
+                                     self.application.full_name)
         self.log = Logger.get_logger(logger_name)
 
         self.executable = executable
@@ -1246,7 +1247,7 @@ class ApplicationLaunchContext:
             args_len_str = " ({})".format(len(args))
         self.log.info(
             "Launching \"{}\" with args{}: {}".format(
-                self.app_name, args_len_str, args
+                self.application.full_name, args_len_str, args
             )
         )
         self.launch_args = args
@@ -1271,7 +1272,9 @@ class ApplicationLaunchContext:
                     exc_info=True
                 )
 
-        self.log.debug("Launch of {} finished.".format(self.app_name))
+        self.log.debug("Launch of {} finished.".format(
+            self.application.full_name
+        ))
 
         return self.process
 

From 75e67807c3c7af4c68e3fcebd5b155fd4b5f51fe Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Thu, 23 Mar 2023 10:42:54 +0000
Subject: [PATCH 115/151] Docs

---
 .../schemas/schema_maya_capture.json          |   2 +-
 website/docs/admin_hosts_maya.md              |  33 ++++++++++++++++++
 .../maya-admin_extract_playblast_settings.png | Bin 0 -> 26814 bytes
 ...ract_playblast_settings_camera_options.png | Bin 0 -> 16732 bytes
 ...ct_playblast_settings_viewport_options.png | Bin 0 -> 1064191 bytes
 5 files changed, 34 insertions(+), 1 deletion(-)
 create mode 100644 website/docs/assets/maya-admin_extract_playblast_settings.png
 create mode 100644 website/docs/assets/maya-admin_extract_playblast_settings_camera_options.png
 create mode 100644 website/docs/assets/maya-admin_extract_playblast_settings_viewport_options.png

diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
index 8d37aa299e..dec5a5cdc2 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_capture.json
@@ -161,7 +161,7 @@
                         {
                             "type": "boolean",
                             "key": "override_viewport_options",
-                            "label": "override_viewport_options"
+                            "label": "Override Viewport Options"
                         },
                         {
                             "type": "enum",
diff --git a/website/docs/admin_hosts_maya.md b/website/docs/admin_hosts_maya.md
index 23cacb4193..fe30703c2e 100644
--- a/website/docs/admin_hosts_maya.md
+++ b/website/docs/admin_hosts_maya.md
@@ -110,6 +110,39 @@ or Deadlines **Draft Tile Assembler**.
 This is useful to fix some specific renderer glitches and advanced hacking of Maya Scene files. `Patch name` is label for patch for easier orientation.
 `Patch regex` is regex used to find line in file, after `Patch line` string is inserted. Note that you need to add line ending.
 
+### Extract Playblast Settings (review)
+These settings provide granular control over how the playblasts or reviews are produced in Maya.
+
+![Extract Playblast Settings](assets/maya-admin_extract_playblast_settings.png)
+
+- **Compression type** which file encoding to use.
+- **Data format** what format is the file encoding.
+- **Quality** lets you control the compression value for the output. Results can vary depending on the compression you selected. Quality values can range from 0 to 100, with a default value of 95.
+- **Background Color** the viewports background color.
+- **Background Bottom** the viewports background bottom color.
+- **Background Top** the viewports background top color.
+- **Override display options** override the viewports display options to use what is set in the settings.
+- **Isolate view** isolates the view to what is in the review instance. If only a camera is present in the review instance, all nodes are displayed in view.
+- **Off Screen** records the playblast hidden from the user.
+- **2D Pan/Zoom** enables the 2D Pan/Zoom functionality of the camera.
+- **Renderer name** which renderer to use for playblasting.
+- **Width** width of the output resolution.
+- **Height** height of the output resolution.
+
+#### Viewport Options
+
+Most settings to override in the viewport are self explanatory and can be found in Maya.
+
+![Extract Playblast Settings](assets/maya-admin_extract_playblast_settings_viewport_options.png)
+
+- **Override Viewport Options** enable to use the settings below for the viewport when publishing the review.
+
+#### Camera Options
+
+These camera options can be overridden when publishing the review. They can be found on the camera shape node.
+
+![Extract Playblast Settings](assets/maya-admin_extract_playblast_settings_camera_options.png)
+
 ## Custom Menu
 You can add your custom tools menu into Maya by extending definitions in **Maya -> Scripts Menu Definition**.
 ![Custom menu definition](assets/maya-admin_scriptsmenu.png)
diff --git a/website/docs/assets/maya-admin_extract_playblast_settings.png b/website/docs/assets/maya-admin_extract_playblast_settings.png
new file mode 100644
index 0000000000000000000000000000000000000000..9312e30321b332c1d22c18f1c77175ca25cf954e
GIT binary patch
literal 26814
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

literal 0
HcmV?d00001

diff --git a/website/docs/assets/maya-admin_extract_playblast_settings_camera_options.png b/website/docs/assets/maya-admin_extract_playblast_settings_camera_options.png
new file mode 100644
index 0000000000000000000000000000000000000000..1a5561328e056fe03278f78c56ea6b837a384e56
GIT binary patch
literal 16732
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

literal 0
HcmV?d00001

diff --git a/website/docs/assets/maya-admin_extract_playblast_settings_viewport_options.png b/website/docs/assets/maya-admin_extract_playblast_settings_viewport_options.png
new file mode 100644
index 0000000000000000000000000000000000000000..5b801775d32338ea9dcb051d2b01a008697c7bd8
GIT binary patch
literal 1064191
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%0AJ<c>pOqGmRpk29oF=8t0UWz?Ldih)A1?YQ79f+
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%0A+pdunb1%FI&jOs4}MR+
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
W{e?~d<VE8M?0A4In7+(Jg8vVb(pG8!

literal 0
HcmV?d00001


From 236078d072bf1f3aff89970da9d52abac7e9e38a Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Thu, 23 Mar 2023 10:43:27 +0000
Subject: [PATCH 116/151] Fix representation hardcoded to png

---
 openpype/hosts/maya/plugins/publish/extract_playblast.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_playblast.py b/openpype/hosts/maya/plugins/publish/extract_playblast.py
index 31cb3435ac..f8bc6987c6 100644
--- a/openpype/hosts/maya/plugins/publish/extract_playblast.py
+++ b/openpype/hosts/maya/plugins/publish/extract_playblast.py
@@ -207,9 +207,9 @@ class ExtractPlayblast(publish.Extractor):
             collected_files = collected_files[0]
 
         representation = {
-            'name': 'png',
-            'ext': 'png',
-            'files': collected_files,
+            "name": self.capture_preset["Codec"]["compression"],
+            "ext": self.capture_preset["Codec"]["compression"],
+            "files": collected_files,
             "stagingDir": stagingdir,
             "frameStart": start,
             "frameEnd": end,

From 6eeed5d8e72031acb1b7238cc04083821c633262 Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Thu, 23 Mar 2023 10:43:36 +0000
Subject: [PATCH 117/151] Code cosmetics

---
 .../maya/plugins/publish/extract_playblast.py | 38 +++++++++----------
 1 file changed, 19 insertions(+), 19 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_playblast.py b/openpype/hosts/maya/plugins/publish/extract_playblast.py
index f8bc6987c6..ab1e1a65c6 100644
--- a/openpype/hosts/maya/plugins/publish/extract_playblast.py
+++ b/openpype/hosts/maya/plugins/publish/extract_playblast.py
@@ -43,7 +43,7 @@ class ExtractPlayblast(publish.Extractor):
         self.log.info("start: {}, end: {}".format(start, end))
 
         # get cameras
-        camera = instance.data['review_camera']
+        camera = instance.data["review_camera"]
 
         preset = lib.load_capture_preset(data=self.capture_preset)
         # Grab capture presets from the project settings
@@ -57,23 +57,23 @@ class ExtractPlayblast(publish.Extractor):
         asset_height = asset_data.get("resolutionHeight")
         review_instance_width = instance.data.get("review_width")
         review_instance_height = instance.data.get("review_height")
-        preset['camera'] = camera
+        preset["camera"] = camera
 
         # Tests if project resolution is set,
         # if it is a value other than zero, that value is
         # used, if not then the asset resolution is
         # used
         if review_instance_width and review_instance_height:
-            preset['width'] = review_instance_width
-            preset['height'] = review_instance_height
+            preset["width"] = review_instance_width
+            preset["height"] = review_instance_height
         elif width_preset and height_preset:
-            preset['width'] = width_preset
-            preset['height'] = height_preset
+            preset["width"] = width_preset
+            preset["height"] = height_preset
         elif asset_width and asset_height:
-            preset['width'] = asset_width
-            preset['height'] = asset_height
-        preset['start_frame'] = start
-        preset['end_frame'] = end
+            preset["width"] = asset_width
+            preset["height"] = asset_height
+        preset["start_frame"] = start
+        preset["end_frame"] = end
 
         # Enforce persisting camera depth of field
         camera_options = preset.setdefault("camera_options", {})
@@ -86,8 +86,8 @@ class ExtractPlayblast(publish.Extractor):
 
         self.log.info("Outputting images to %s" % path)
 
-        preset['filename'] = path
-        preset['overwrite'] = True
+        preset["filename"] = path
+        preset["overwrite"] = True
 
         pm.refresh(f=True)
 
@@ -139,7 +139,7 @@ class ExtractPlayblast(publish.Extractor):
                 )
 
         override_viewport_options = (
-            capture_presets['Viewport Options']['override_viewport_options']
+            capture_presets["Viewport Options"]["override_viewport_options"]
         )
         with lib.maintained_time():
             filename = preset.get("filename", "%TEMP%")
@@ -147,7 +147,7 @@ class ExtractPlayblast(publish.Extractor):
             # Force viewer to False in call to capture because we have our own
             # viewer opening call to allow a signal to trigger between
             # playblast and viewer
-            preset['viewer'] = False
+            preset["viewer"] = False
 
             # Update preset with current panel setting
             # if override_viewport_options is turned off
@@ -183,7 +183,7 @@ class ExtractPlayblast(publish.Extractor):
         self.log.debug("filename {}".format(filename))
         frame_collection = None
         for collection in collections:
-            filebase = collection.format('{head}').rstrip(".")
+            filebase = collection.format("{head}").rstrip(".")
             self.log.debug("collection head {}".format(filebase))
             if filebase in filename:
                 frame_collection = collection
@@ -213,9 +213,9 @@ class ExtractPlayblast(publish.Extractor):
             "stagingDir": stagingdir,
             "frameStart": start,
             "frameEnd": end,
-            'fps': fps,
-            'preview': True,
-            'tags': tags,
-            'camera_name': camera_node_name
+            "fps": fps,
+            "preview": True,
+            "tags": tags,
+            "camera_name": camera_node_name
         }
         instance.data["representations"].append(representation)

From 81b659e933591e3fbabc9ea1b57ce99a25ef5396 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?=
 <33513211+antirotor@users.noreply.github.com>
Date: Thu, 23 Mar 2023 12:06:01 +0100
Subject: [PATCH 118/151] Update
 openpype/hosts/max/plugins/publish/increment_workfile_version.py

---
 .../hosts/max/plugins/publish/increment_workfile_version.py     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/max/plugins/publish/increment_workfile_version.py b/openpype/hosts/max/plugins/publish/increment_workfile_version.py
index 7b4f4e238d..3dec214f77 100644
--- a/openpype/hosts/max/plugins/publish/increment_workfile_version.py
+++ b/openpype/hosts/max/plugins/publish/increment_workfile_version.py
@@ -16,4 +16,4 @@ class IncrementWorkfileVersion(pyblish.api.ContextPlugin):
         filepath = version_up(path)
 
         rt.saveMaxFile(filepath)
-        self.log.info('Incrementing file version')
+        self.log.info("Incrementing file version")

From 0a085c7001db46671d26beb0c8a59de1a37a58a2 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 23 Mar 2023 12:06:05 +0100
Subject: [PATCH 119/151] Kitsu: Slightly less strict with instance data
 (#4678)

* Match family and families

* Allow kitsu note to not have set comment and capture it without erroring in IntegrateKitsuReview

* Allow fallback to context for instance `task`

* Shush hound

* Refactor variable names
---
 .../kitsu/plugins/publish/collect_kitsu_entities.py       | 2 +-
 .../modules/kitsu/plugins/publish/integrate_kitsu_note.py | 5 ++++-
 .../kitsu/plugins/publish/integrate_kitsu_review.py       | 8 ++++----
 3 files changed, 9 insertions(+), 6 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py b/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
index a0bd2b305b..4ea8135620 100644
--- a/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
+++ b/openpype/modules/kitsu/plugins/publish/collect_kitsu_entities.py
@@ -29,7 +29,7 @@ class CollectKitsuEntities(pyblish.api.ContextPlugin):
             if not zou_asset_data:
                 raise ValueError("Zou asset data not found in OpenPype!")
 
-            task_name = instance.data.get("task")
+            task_name = instance.data.get("task", context.data.get("task"))
             if not task_name:
                 continue
 
diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index 6fda32d85f..6be14b3bdf 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -48,7 +48,10 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
     def process(self, context):
         for instance in context:
             # Check if instance is a review by checking its family
-            if "review" not in instance.data["families"]:
+            # Allow a match to primary family or any of families
+            families = set([instance.data["family"]] +
+                           instance.data.get("families", []))
+            if "review" not in families:
                 continue
 
             kitsu_task = instance.data.get("kitsu_task")
diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
index 12482b5657..e05ff05f50 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_review.py
@@ -12,17 +12,17 @@ class IntegrateKitsuReview(pyblish.api.InstancePlugin):
     optional = True
 
     def process(self, instance):
-        task = instance.data["kitsu_task"]["id"]
-        comment = instance.data["kitsu_comment"]["id"]
 
         # Check comment has been created
-        if not comment:
+        comment_id = instance.data.get("kitsu_comment", {}).get("id")
+        if not comment_id:
             self.log.debug(
                 "Comment not created, review not pushed to preview."
             )
             return
 
         # Add review representations as preview of comment
+        task_id = instance.data["kitsu_task"]["id"]
         for representation in instance.data.get("representations", []):
             # Skip if not tagged as review
             if "kitsureview" not in representation.get("tags", []):
@@ -31,6 +31,6 @@ class IntegrateKitsuReview(pyblish.api.InstancePlugin):
             self.log.debug("Found review at: {}".format(review_path))
 
             gazu.task.add_preview(
-                task, comment, review_path, normalize_movie=True
+                task_id, comment_id, review_path, normalize_movie=True
             )
             self.log.info("Review upload on comment")

From d0f083ec195a0e4ac639865c14d50635d318bb6e Mon Sep 17 00:00:00 2001
From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Date: Thu, 23 Mar 2023 12:52:25 +0100
Subject: [PATCH 120/151] Publisher: Explicit save (#4676)

* added save button class

* added save button to window

* workfiles is also part of context in CreateContext to be able check if context changed

* window cares about trigger of convertors

* use abstractproperty with property and abstractmethod decorators

* save changes happens using main window and can be blocked

* fix pyside compatibility

* use create context to get current context names

* Fix docstring label

* added shortcuts for save and reset

* change control string matching for macos

* added 'publish_has_started' property

* allow save only if publishing did not start yet

* rename 'get_selected_convertors' to 'get_selected_legacy_convertors' and added docstrings

* Added Saved changes

* disable instances toggle when publishing started

* Fix reset button tooltip

Co-authored-by: Roy Nieterau <roy_nieterau@hotmail.com>

* Use QKeySequence to string for tooltips

* added example output

* use predefined method to emit card message

---------

Co-authored-by: Roy Nieterau <roy_nieterau@hotmail.com>
---
 openpype/pipeline/create/context.py           |  91 +++++++--
 openpype/tools/publisher/constants.py         |   5 +-
 openpype/tools/publisher/control.py           | 185 +++++++++++++-----
 openpype/tools/publisher/widgets/__init__.py  |   6 +-
 .../publisher/widgets/card_view_widgets.py    |  19 ++
 .../tools/publisher/widgets/images/save.png   | Bin 0 -> 3961 bytes
 .../publisher/widgets/list_view_widgets.py    |  27 +++
 .../publisher/widgets/overview_widget.py      |  38 +++-
 openpype/tools/publisher/widgets/widgets.py   |  34 +++-
 openpype/tools/publisher/window.py            | 127 ++++++++++--
 openpype/tools/traypublisher/window.py        |   2 +-
 11 files changed, 450 insertions(+), 84 deletions(-)
 create mode 100644 openpype/tools/publisher/widgets/images/save.png

diff --git a/openpype/pipeline/create/context.py b/openpype/pipeline/create/context.py
index acc2bb054f..22cab28e4b 100644
--- a/openpype/pipeline/create/context.py
+++ b/openpype/pipeline/create/context.py
@@ -22,7 +22,7 @@ from openpype.lib.attribute_definitions import (
     deserialize_attr_defs,
     get_default_values,
 )
-from openpype.host import IPublishHost
+from openpype.host import IPublishHost, IWorkfileHost
 from openpype.pipeline import legacy_io
 from openpype.pipeline.plugin_discover import DiscoverResult
 
@@ -1374,6 +1374,7 @@ class CreateContext:
         self._current_project_name = None
         self._current_asset_name = None
         self._current_task_name = None
+        self._current_workfile_path = None
 
         self._host_is_valid = host_is_valid
         # Currently unused variable
@@ -1503,14 +1504,62 @@ class CreateContext:
         return os.environ["AVALON_APP"]
 
     def get_current_project_name(self):
+        """Project name which was used as current context on context reset.
+
+        Returns:
+            Union[str, None]: Project name.
+        """
+
         return self._current_project_name
 
     def get_current_asset_name(self):
+        """Asset name which was used as current context on context reset.
+
+        Returns:
+            Union[str, None]: Asset name.
+        """
+
         return self._current_asset_name
 
     def get_current_task_name(self):
+        """Task name which was used as current context on context reset.
+
+        Returns:
+            Union[str, None]: Task name.
+        """
+
         return self._current_task_name
 
+    def get_current_workfile_path(self):
+        """Workfile path which was opened on context reset.
+
+        Returns:
+            Union[str, None]: Workfile path.
+        """
+
+        return self._current_workfile_path
+
+    @property
+    def context_has_changed(self):
+        """Host context has changed.
+
+        As context is used project, asset, task name and workfile path if
+        host does support workfiles.
+
+        Returns:
+            bool: Context changed.
+        """
+
+        project_name, asset_name, task_name, workfile_path = (
+            self._get_current_host_context()
+        )
+        return (
+            self._current_project_name != project_name
+            or self._current_asset_name != asset_name
+            or self._current_task_name != task_name
+            or self._current_workfile_path != workfile_path
+        )
+
     project_name = property(get_current_project_name)
 
     @property
@@ -1575,6 +1624,28 @@ class CreateContext:
         self._collection_shared_data = None
         self.refresh_thumbnails()
 
+    def _get_current_host_context(self):
+        project_name = asset_name = task_name = workfile_path = None
+        if hasattr(self.host, "get_current_context"):
+            host_context = self.host.get_current_context()
+            if host_context:
+                project_name = host_context.get("project_name")
+                asset_name = host_context.get("asset_name")
+                task_name = host_context.get("task_name")
+
+        if isinstance(self.host, IWorkfileHost):
+            workfile_path = self.host.get_current_workfile()
+
+        # --- TODO remove these conditions ---
+        if not project_name:
+            project_name = legacy_io.Session.get("AVALON_PROJECT")
+        if not asset_name:
+            asset_name = legacy_io.Session.get("AVALON_ASSET")
+        if not task_name:
+            task_name = legacy_io.Session.get("AVALON_TASK")
+        # ---
+        return project_name, asset_name, task_name, workfile_path
+
     def reset_current_context(self):
         """Refresh current context.
 
@@ -1593,24 +1664,14 @@ class CreateContext:
                 are stored. We should store the workfile (if is available) too.
         """
 
-        project_name = asset_name = task_name = None
-        if hasattr(self.host, "get_current_context"):
-            host_context = self.host.get_current_context()
-            if host_context:
-                project_name = host_context.get("project_name")
-                asset_name = host_context.get("asset_name")
-                task_name = host_context.get("task_name")
-
-        if not project_name:
-            project_name = legacy_io.Session.get("AVALON_PROJECT")
-        if not asset_name:
-            asset_name = legacy_io.Session.get("AVALON_ASSET")
-        if not task_name:
-            task_name = legacy_io.Session.get("AVALON_TASK")
+        project_name, asset_name, task_name, workfile_path = (
+            self._get_current_host_context()
+        )
 
         self._current_project_name = project_name
         self._current_asset_name = asset_name
         self._current_task_name = task_name
+        self._current_workfile_path = workfile_path
 
     def reset_plugins(self, discover_publish_plugins=True):
         """Reload plugins.
diff --git a/openpype/tools/publisher/constants.py b/openpype/tools/publisher/constants.py
index b2bfd7dd5c..5d23886aa8 100644
--- a/openpype/tools/publisher/constants.py
+++ b/openpype/tools/publisher/constants.py
@@ -1,4 +1,4 @@
-from qtpy import QtCore
+from qtpy import QtCore, QtGui
 
 # ID of context item in instance view
 CONTEXT_ID = "context"
@@ -26,6 +26,9 @@ GROUP_ROLE = QtCore.Qt.UserRole + 7
 CONVERTER_IDENTIFIER_ROLE = QtCore.Qt.UserRole + 8
 CREATOR_SORT_ROLE = QtCore.Qt.UserRole + 9
 
+ResetKeySequence = QtGui.QKeySequence(
+    QtCore.Qt.ControlModifier | QtCore.Qt.Key_R
+)
 
 __all__ = (
     "CONTEXT_ID",
diff --git a/openpype/tools/publisher/control.py b/openpype/tools/publisher/control.py
index 49e7eeb4f7..b62ae7ecc1 100644
--- a/openpype/tools/publisher/control.py
+++ b/openpype/tools/publisher/control.py
@@ -6,7 +6,7 @@ import collections
 import uuid
 import tempfile
 import shutil
-from abc import ABCMeta, abstractmethod, abstractproperty
+from abc import ABCMeta, abstractmethod
 
 import six
 import pyblish.api
@@ -964,7 +964,8 @@ class AbstractPublisherController(object):
     access objects directly but by using wrappers that can be serialized.
     """
 
-    @abstractproperty
+    @property
+    @abstractmethod
     def log(self):
         """Controller's logger object.
 
@@ -974,13 +975,15 @@ class AbstractPublisherController(object):
 
         pass
 
-    @abstractproperty
+    @property
+    @abstractmethod
     def event_system(self):
         """Inner event system for publisher controller."""
 
         pass
 
-    @abstractproperty
+    @property
+    @abstractmethod
     def project_name(self):
         """Current context project name.
 
@@ -990,7 +993,8 @@ class AbstractPublisherController(object):
 
         pass
 
-    @abstractproperty
+    @property
+    @abstractmethod
     def current_asset_name(self):
         """Current context asset name.
 
@@ -1000,7 +1004,8 @@ class AbstractPublisherController(object):
 
         pass
 
-    @abstractproperty
+    @property
+    @abstractmethod
     def current_task_name(self):
         """Current context task name.
 
@@ -1010,7 +1015,21 @@ class AbstractPublisherController(object):
 
         pass
 
-    @abstractproperty
+    @property
+    @abstractmethod
+    def host_context_has_changed(self):
+        """Host context changed after last reset.
+
+        'CreateContext' has this option available using 'context_has_changed'.
+
+        Returns:
+            bool: Context has changed.
+        """
+
+        pass
+
+    @property
+    @abstractmethod
     def host_is_valid(self):
         """Host is valid for creation part.
 
@@ -1023,7 +1042,8 @@ class AbstractPublisherController(object):
 
         pass
 
-    @abstractproperty
+    @property
+    @abstractmethod
     def instances(self):
         """Collected/created instances.
 
@@ -1134,7 +1154,13 @@ class AbstractPublisherController(object):
 
     @abstractmethod
     def save_changes(self):
-        """Save changes in create context."""
+        """Save changes in create context.
+
+        Save can crash because of unexpected errors.
+
+        Returns:
+            bool: Save was successful.
+        """
 
         pass
 
@@ -1145,7 +1171,19 @@ class AbstractPublisherController(object):
 
         pass
 
-    @abstractproperty
+    @property
+    @abstractmethod
+    def publish_has_started(self):
+        """Has publishing finished.
+
+        Returns:
+            bool: If publishing finished and all plugins were iterated.
+        """
+
+        pass
+
+    @property
+    @abstractmethod
     def publish_has_finished(self):
         """Has publishing finished.
 
@@ -1155,7 +1193,8 @@ class AbstractPublisherController(object):
 
         pass
 
-    @abstractproperty
+    @property
+    @abstractmethod
     def publish_is_running(self):
         """Publishing is running right now.
 
@@ -1165,7 +1204,8 @@ class AbstractPublisherController(object):
 
         pass
 
-    @abstractproperty
+    @property
+    @abstractmethod
     def publish_has_validated(self):
         """Publish validation passed.
 
@@ -1175,7 +1215,8 @@ class AbstractPublisherController(object):
 
         pass
 
-    @abstractproperty
+    @property
+    @abstractmethod
     def publish_has_crashed(self):
         """Publishing crashed for any reason.
 
@@ -1185,7 +1226,8 @@ class AbstractPublisherController(object):
 
         pass
 
-    @abstractproperty
+    @property
+    @abstractmethod
     def publish_has_validation_errors(self):
         """During validation happened at least one validation error.
 
@@ -1195,7 +1237,8 @@ class AbstractPublisherController(object):
 
         pass
 
-    @abstractproperty
+    @property
+    @abstractmethod
     def publish_max_progress(self):
         """Get maximum possible progress number.
 
@@ -1205,7 +1248,8 @@ class AbstractPublisherController(object):
 
         pass
 
-    @abstractproperty
+    @property
+    @abstractmethod
     def publish_progress(self):
         """Current progress number.
 
@@ -1215,7 +1259,8 @@ class AbstractPublisherController(object):
 
         pass
 
-    @abstractproperty
+    @property
+    @abstractmethod
     def publish_error_msg(self):
         """Current error message which cause fail of publishing.
 
@@ -1267,7 +1312,8 @@ class AbstractPublisherController(object):
 
         pass
 
-    @abstractproperty
+    @property
+    @abstractmethod
     def convertor_items(self):
         pass
 
@@ -1356,6 +1402,7 @@ class BasePublisherController(AbstractPublisherController):
         self._publish_has_validation_errors = False
         self._publish_has_crashed = False
         # All publish plugins are processed
+        self._publish_has_started = False
         self._publish_has_finished = False
         self._publish_max_progress = 0
         self._publish_progress = 0
@@ -1386,7 +1433,8 @@ class BasePublisherController(AbstractPublisherController):
             "show.card.message" - Show card message request (UI related).
             "instances.refresh.finished" - Instances are refreshed.
             "plugins.refresh.finished" - Plugins refreshed.
-            "publish.reset.finished" - Publish context reset finished.
+            "publish.reset.finished" - Reset finished.
+            "controller.reset.started" - Controller reset started.
             "controller.reset.finished" - Controller reset finished.
             "publish.process.started" - Publishing started. Can be started from
                 paused state.
@@ -1425,7 +1473,16 @@ class BasePublisherController(AbstractPublisherController):
     def _set_host_is_valid(self, value):
         if self._host_is_valid != value:
             self._host_is_valid = value
-            self._emit_event("publish.host_is_valid.changed", {"value": value})
+            self._emit_event(
+                "publish.host_is_valid.changed", {"value": value}
+            )
+
+    def _get_publish_has_started(self):
+        return self._publish_has_started
+
+    def _set_publish_has_started(self, value):
+        if value != self._publish_has_started:
+            self._publish_has_started = value
 
     def _get_publish_has_finished(self):
         return self._publish_has_finished
@@ -1449,7 +1506,9 @@ class BasePublisherController(AbstractPublisherController):
     def _set_publish_has_validated(self, value):
         if self._publish_has_validated != value:
             self._publish_has_validated = value
-            self._emit_event("publish.has_validated.changed", {"value": value})
+            self._emit_event(
+                "publish.has_validated.changed", {"value": value}
+            )
 
     def _get_publish_has_crashed(self):
         return self._publish_has_crashed
@@ -1497,6 +1556,9 @@ class BasePublisherController(AbstractPublisherController):
     host_is_valid = property(
         _get_host_is_valid, _set_host_is_valid
     )
+    publish_has_started = property(
+        _get_publish_has_started, _set_publish_has_started
+    )
     publish_has_finished = property(
         _get_publish_has_finished, _set_publish_has_finished
     )
@@ -1526,6 +1588,7 @@ class BasePublisherController(AbstractPublisherController):
         """Reset most of attributes that can be reset."""
 
         self.publish_is_running = False
+        self.publish_has_started = False
         self.publish_has_validated = False
         self.publish_has_crashed = False
         self.publish_has_validation_errors = False
@@ -1645,10 +1708,7 @@ class PublisherController(BasePublisherController):
             str: Project name.
         """
 
-        if not hasattr(self._host, "get_current_context"):
-            return legacy_io.active_project()
-
-        return self._host.get_current_context()["project_name"]
+        return self._create_context.get_current_project_name()
 
     @property
     def current_asset_name(self):
@@ -1658,10 +1718,7 @@ class PublisherController(BasePublisherController):
             Union[str, None]: Asset name or None if asset is not set.
         """
 
-        if not hasattr(self._host, "get_current_context"):
-            return legacy_io.Session["AVALON_ASSET"]
-
-        return self._host.get_current_context()["asset_name"]
+        return self._create_context.get_current_asset_name()
 
     @property
     def current_task_name(self):
@@ -1671,10 +1728,11 @@ class PublisherController(BasePublisherController):
             Union[str, None]: Task name or None if task is not set.
         """
 
-        if not hasattr(self._host, "get_current_context"):
-            return legacy_io.Session["AVALON_TASK"]
+        return self._create_context.get_current_task_name()
 
-        return self._host.get_current_context()["task_name"]
+    @property
+    def host_context_has_changed(self):
+        return self._create_context.context_has_changed
 
     @property
     def instances(self):
@@ -1751,6 +1809,8 @@ class PublisherController(BasePublisherController):
         """Reset everything related to creation and publishing."""
         self.stop_publish()
 
+        self._emit_event("controller.reset.started")
+
         self.host_is_valid = self._create_context.host_is_valid
 
         self._create_context.reset_preparation()
@@ -1992,7 +2052,15 @@ class PublisherController(BasePublisherController):
         )
 
     def trigger_convertor_items(self, convertor_identifiers):
-        self.save_changes()
+        """Trigger legacy item convertors.
+
+        This functionality requires to save and reset CreateContext. The reset
+        is needed so Creators can collect converted items.
+
+        Args:
+            convertor_identifiers (list[str]): Identifiers of convertor
+                plugins.
+        """
 
         success = True
         try:
@@ -2039,13 +2107,33 @@ class PublisherController(BasePublisherController):
         self._on_create_instance_change()
         return success
 
-    def save_changes(self):
-        """Save changes happened during creation."""
+    def save_changes(self, show_message=True):
+        """Save changes happened during creation.
+
+        Trigger save of changes using host api. This functionality does not
+        validate anything. It is required to do checks before this method is
+        called to be able to give user actionable response e.g. check of
+        context using 'host_context_has_changed'.
+
+        Args:
+            show_message (bool): Show message that changes were
+                saved successfully.
+
+        Returns:
+            bool: Save of changes was successful.
+        """
+
         if not self._create_context.host_is_valid:
-            return
+            # TODO remove
+            # Fake success save when host is not valid for CreateContext
+            #   this is for testing as experimental feature
+            return True
 
         try:
             self._create_context.save_changes()
+            if show_message:
+                self.emit_card_message("Saved changes..")
+            return True
 
         except CreatorsOperationFailed as exc:
             self._emit_event(
@@ -2056,16 +2144,17 @@ class PublisherController(BasePublisherController):
                 }
             )
 
+        return False
+
     def remove_instances(self, instance_ids):
         """Remove instances based on instance ids.
 
         Args:
             instance_ids (List[str]): List of instance ids to remove.
         """
-        # QUESTION Expect that instances are really removed? In that case save
-        #   reset is not required and save changes too.
-        self.save_changes()
 
+        # QUESTION Expect that instances are really removed? In that case reset
+        #    is not required.
         self._remove_instances_from_context(instance_ids)
 
         self._on_create_instance_change()
@@ -2136,12 +2225,22 @@ class PublisherController(BasePublisherController):
             self._publish_comment_is_set = True
 
     def publish(self):
-        """Run publishing."""
+        """Run publishing.
+
+        Make sure all changes are saved before method is called (Call
+        'save_changes' and check output).
+        """
+
         self._publish_up_validation = False
         self._start_publish()
 
     def validate(self):
-        """Run publishing and stop after Validation."""
+        """Run publishing and stop after Validation.
+
+        Make sure all changes are saved before method is called (Call
+        'save_changes' and check output).
+        """
+
         if self.publish_has_validated:
             return
         self._publish_up_validation = True
@@ -2152,10 +2251,8 @@ class PublisherController(BasePublisherController):
         if self.publish_is_running:
             return
 
-        # Make sure changes are saved
-        self.save_changes()
-
         self.publish_is_running = True
+        self.publish_has_started = True
 
         self._emit_event("publish.process.started")
 
diff --git a/openpype/tools/publisher/widgets/__init__.py b/openpype/tools/publisher/widgets/__init__.py
index 042985b007..f18e6cc61e 100644
--- a/openpype/tools/publisher/widgets/__init__.py
+++ b/openpype/tools/publisher/widgets/__init__.py
@@ -4,8 +4,9 @@ from .icons import (
     get_icon
 )
 from .widgets import (
-    StopBtn,
+    SaveBtn,
     ResetBtn,
+    StopBtn,
     ValidateBtn,
     PublishBtn,
     CreateNextPageOverlay,
@@ -25,8 +26,9 @@ __all__ = (
     "get_pixmap",
     "get_icon",
 
-    "StopBtn",
+    "SaveBtn",
     "ResetBtn",
+    "StopBtn",
     "ValidateBtn",
     "PublishBtn",
     "CreateNextPageOverlay",
diff --git a/openpype/tools/publisher/widgets/card_view_widgets.py b/openpype/tools/publisher/widgets/card_view_widgets.py
index 3fd5243ce9..0734e1bc27 100644
--- a/openpype/tools/publisher/widgets/card_view_widgets.py
+++ b/openpype/tools/publisher/widgets/card_view_widgets.py
@@ -164,6 +164,11 @@ class BaseGroupWidget(QtWidgets.QWidget):
     def _on_widget_selection(self, instance_id, group_id, selection_type):
         self.selected.emit(instance_id, group_id, selection_type)
 
+    def set_active_toggle_enabled(self, enabled):
+        for widget in self._widgets_by_id.values():
+            if isinstance(widget, InstanceCardWidget):
+                widget.set_active_toggle_enabled(enabled)
+
 
 class ConvertorItemsGroupWidget(BaseGroupWidget):
     def update_items(self, items_by_id):
@@ -437,6 +442,9 @@ class InstanceCardWidget(CardWidget):
 
         self.update_instance_values()
 
+    def set_active_toggle_enabled(self, enabled):
+        self._active_checkbox.setEnabled(enabled)
+
     def set_active(self, new_value):
         """Set instance as active."""
         checkbox_value = self._active_checkbox.isChecked()
@@ -551,6 +559,7 @@ class InstanceCardView(AbstractInstanceView):
 
         self._context_widget = None
         self._convertor_items_group = None
+        self._active_toggle_enabled = True
         self._widgets_by_group = {}
         self._ordered_groups = []
 
@@ -667,6 +676,9 @@ class InstanceCardView(AbstractInstanceView):
             group_widget.update_instances(
                 instances_by_group[group_name]
             )
+            group_widget.set_active_toggle_enabled(
+                self._active_toggle_enabled
+            )
 
         self._update_ordered_group_names()
 
@@ -1091,3 +1103,10 @@ class InstanceCardView(AbstractInstanceView):
 
         self._explicitly_selected_groups = selected_groups
         self._explicitly_selected_instance_ids = selected_instances
+
+    def set_active_toggle_enabled(self, enabled):
+        if self._active_toggle_enabled is enabled:
+            return
+        self._active_toggle_enabled = enabled
+        for group_widget in self._widgets_by_group.values():
+            group_widget.set_active_toggle_enabled(enabled)
diff --git a/openpype/tools/publisher/widgets/images/save.png b/openpype/tools/publisher/widgets/images/save.png
new file mode 100644
index 0000000000000000000000000000000000000000..0db48d74ae2660e8766fc2bcd30ed794fd067068
GIT binary patch
literal 3961
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

literal 0
HcmV?d00001

diff --git a/openpype/tools/publisher/widgets/list_view_widgets.py b/openpype/tools/publisher/widgets/list_view_widgets.py
index 172563d15c..227ae7bda9 100644
--- a/openpype/tools/publisher/widgets/list_view_widgets.py
+++ b/openpype/tools/publisher/widgets/list_view_widgets.py
@@ -198,6 +198,9 @@ class InstanceListItemWidget(QtWidgets.QWidget):
         self.instance["active"] = new_value
         self.active_changed.emit(self.instance.id, new_value)
 
+    def set_active_toggle_enabled(self, enabled):
+        self._active_checkbox.setEnabled(enabled)
+
 
 class ListContextWidget(QtWidgets.QFrame):
     """Context (or global attributes) widget."""
@@ -302,6 +305,9 @@ class InstanceListGroupWidget(QtWidgets.QFrame):
         else:
             self.expand_btn.setArrowType(QtCore.Qt.RightArrow)
 
+    def set_active_toggle_enabled(self, enabled):
+        self.toggle_checkbox.setEnabled(enabled)
+
 
 class InstanceTreeView(QtWidgets.QTreeView):
     """View showing instances and their groups."""
@@ -461,6 +467,8 @@ class InstanceListView(AbstractInstanceView):
         self._instance_model = instance_model
         self._proxy_model = proxy_model
 
+        self._active_toggle_enabled = True
+
     def _on_expand(self, index):
         self._update_widget_expand_state(index, True)
 
@@ -667,6 +675,9 @@ class InstanceListView(AbstractInstanceView):
                     widget = InstanceListItemWidget(
                         instance, self._instance_view
                     )
+                    widget.set_active_toggle_enabled(
+                        self._active_toggle_enabled
+                    )
                     widget.active_changed.connect(self._on_active_changed)
                     self._instance_view.setIndexWidget(proxy_index, widget)
                     self._widgets_by_id[instance.id] = widget
@@ -802,6 +813,9 @@ class InstanceListView(AbstractInstanceView):
             proxy_index = self._proxy_model.mapFromSource(index)
             group_name = group_item.data(GROUP_ROLE)
             widget = InstanceListGroupWidget(group_name, self._instance_view)
+            widget.set_active_toggle_enabled(
+                self._active_toggle_enabled
+            )
             widget.expand_changed.connect(self._on_group_expand_request)
             widget.toggle_requested.connect(self._on_group_toggle_request)
             self._group_widgets[group_name] = widget
@@ -1051,3 +1065,16 @@ class InstanceListView(AbstractInstanceView):
             QtCore.QItemSelectionModel.Select
             | QtCore.QItemSelectionModel.Rows
         )
+
+    def set_active_toggle_enabled(self, enabled):
+        if self._active_toggle_enabled is enabled:
+            return
+
+        self._active_toggle_enabled = enabled
+        for widget in self._widgets_by_id.values():
+            if isinstance(widget, InstanceListItemWidget):
+                widget.set_active_toggle_enabled(enabled)
+
+        for widget in self._group_widgets.values():
+            if isinstance(widget, InstanceListGroupWidget):
+                widget.set_active_toggle_enabled(enabled)
diff --git a/openpype/tools/publisher/widgets/overview_widget.py b/openpype/tools/publisher/widgets/overview_widget.py
index 8706daeda6..25fff73134 100644
--- a/openpype/tools/publisher/widgets/overview_widget.py
+++ b/openpype/tools/publisher/widgets/overview_widget.py
@@ -17,6 +17,7 @@ class OverviewWidget(QtWidgets.QFrame):
     active_changed = QtCore.Signal()
     instance_context_changed = QtCore.Signal()
     create_requested = QtCore.Signal()
+    convert_requested = QtCore.Signal()
 
     anim_end_value = 200
     anim_duration = 200
@@ -132,6 +133,9 @@ class OverviewWidget(QtWidgets.QFrame):
         controller.event_system.add_callback(
             "publish.process.started", self._on_publish_start
         )
+        controller.event_system.add_callback(
+            "controller.reset.started", self._on_controller_reset_start
+        )
         controller.event_system.add_callback(
             "publish.reset.finished", self._on_publish_reset
         )
@@ -336,13 +340,31 @@ class OverviewWidget(QtWidgets.QFrame):
         self.instance_context_changed.emit()
 
     def _on_convert_requested(self):
-        _, _, convertor_identifiers = self.get_selected_items()
-        self._controller.trigger_convertor_items(convertor_identifiers)
+        self.convert_requested.emit()
 
     def get_selected_items(self):
+        """Selected items in current view widget.
+
+        Returns:
+            tuple[list[str], bool, list[str]]: Selected items. List of
+                instance ids, context is selected, list of selected legacy
+                convertor plugins.
+        """
+
         view = self._subset_views_layout.currentWidget()
         return view.get_selected_items()
 
+    def get_selected_legacy_convertors(self):
+        """Selected legacy convertor identifiers.
+
+        Returns:
+            list[str]: Selected legacy convertor identifiers.
+                Example: ['io.openpype.creators.houdini.legacy']
+        """
+
+        _, _, convertor_identifiers = self.get_selected_items()
+        return convertor_identifiers
+
     def _change_view_type(self):
         idx = self._subset_views_layout.currentIndex()
         new_idx = (idx + 1) % self._subset_views_layout.count()
@@ -391,9 +413,19 @@ class OverviewWidget(QtWidgets.QFrame):
 
         self._create_btn.setEnabled(False)
         self._subset_attributes_wrap.setEnabled(False)
+        for idx in range(self._subset_views_layout.count()):
+            widget = self._subset_views_layout.widget(idx)
+            widget.set_active_toggle_enabled(False)
+
+    def _on_controller_reset_start(self):
+        """Controller reset started."""
+
+        for idx in range(self._subset_views_layout.count()):
+            widget = self._subset_views_layout.widget(idx)
+            widget.set_active_toggle_enabled(True)
 
     def _on_publish_reset(self):
-        """Context in controller has been refreshed."""
+        """Context in controller has been reseted."""
 
         self._create_btn.setEnabled(True)
         self._subset_attributes_wrap.setEnabled(True)
diff --git a/openpype/tools/publisher/widgets/widgets.py b/openpype/tools/publisher/widgets/widgets.py
index 86475460aa..d2ce1fbcb2 100644
--- a/openpype/tools/publisher/widgets/widgets.py
+++ b/openpype/tools/publisher/widgets/widgets.py
@@ -34,7 +34,8 @@ from .icons import (
 )
 
 from ..constants import (
-    VARIANT_TOOLTIP
+    VARIANT_TOOLTIP,
+    ResetKeySequence,
 )
 
 
@@ -198,12 +199,26 @@ class CreateBtn(PublishIconBtn):
         self.setLayoutDirection(QtCore.Qt.RightToLeft)
 
 
+class SaveBtn(PublishIconBtn):
+    """Save context and instances information."""
+    def __init__(self, parent=None):
+        icon_path = get_icon_path("save")
+        super(SaveBtn, self).__init__(icon_path, parent)
+        self.setToolTip(
+            "Save changes ({})".format(
+                QtGui.QKeySequence(QtGui.QKeySequence.Save).toString()
+            )
+        )
+
+
 class ResetBtn(PublishIconBtn):
     """Publish reset button."""
     def __init__(self, parent=None):
         icon_path = get_icon_path("refresh")
         super(ResetBtn, self).__init__(icon_path, parent)
-        self.setToolTip("Refresh publishing")
+        self.setToolTip(
+            "Reset & discard changes ({})".format(ResetKeySequence.toString())
+        )
 
 
 class StopBtn(PublishIconBtn):
@@ -348,6 +363,19 @@ class AbstractInstanceView(QtWidgets.QWidget):
             "{} Method 'set_selected_items' is not implemented."
         ).format(self.__class__.__name__))
 
+    def set_active_toggle_enabled(self, enabled):
+        """Instances are disabled for changing enabled state.
+
+        Active state should stay the same until is "unset".
+
+        Args:
+            enabled (bool): Instance state can be changed.
+        """
+
+        raise NotImplementedError((
+            "{} Method 'set_active_toggle_enabled' is not implemented."
+        ).format(self.__class__.__name__))
+
 
 class ClickableLineEdit(QtWidgets.QLineEdit):
     """QLineEdit capturing left mouse click.
@@ -1533,7 +1561,7 @@ class SubsetAttributesWidget(QtWidgets.QWidget):
     │   attributes    │  Thumbnail  │  TOP
     │                 │             │
     ├─────────────┬───┴─────────────┤
-    │  Family     │   Publish       │
+    │  Creator    │   Publish       │
     │  attributes │   plugin        │  BOTTOM
     │             │   attributes    │
     └───────────────────────────────┘
diff --git a/openpype/tools/publisher/window.py b/openpype/tools/publisher/window.py
index 74977d65d8..c72b60d826 100644
--- a/openpype/tools/publisher/window.py
+++ b/openpype/tools/publisher/window.py
@@ -13,6 +13,7 @@ from openpype.tools.utils import (
     PixmapLabel,
 )
 
+from .constants import ResetKeySequence
 from .publish_report_viewer import PublishReportViewerWidget
 from .control_qt import QtPublisherController
 from .widgets import (
@@ -22,8 +23,9 @@ from .widgets import (
 
     PublisherTabsWidget,
 
-    StopBtn,
+    SaveBtn,
     ResetBtn,
+    StopBtn,
     ValidateBtn,
     PublishBtn,
 
@@ -121,6 +123,7 @@ class PublisherWindow(QtWidgets.QDialog):
             "Attach a comment to your publish"
         )
 
+        save_btn = SaveBtn(footer_widget)
         reset_btn = ResetBtn(footer_widget)
         stop_btn = StopBtn(footer_widget)
         validate_btn = ValidateBtn(footer_widget)
@@ -129,6 +132,7 @@ class PublisherWindow(QtWidgets.QDialog):
         footer_bottom_layout = QtWidgets.QHBoxLayout(footer_bottom_widget)
         footer_bottom_layout.setContentsMargins(0, 0, 0, 0)
         footer_bottom_layout.addStretch(1)
+        footer_bottom_layout.addWidget(save_btn, 0)
         footer_bottom_layout.addWidget(reset_btn, 0)
         footer_bottom_layout.addWidget(stop_btn, 0)
         footer_bottom_layout.addWidget(validate_btn, 0)
@@ -250,7 +254,11 @@ class PublisherWindow(QtWidgets.QDialog):
         overview_widget.create_requested.connect(
             self._on_create_request
         )
+        overview_widget.convert_requested.connect(
+            self._on_convert_requested
+        )
 
+        save_btn.clicked.connect(self._on_save_clicked)
         reset_btn.clicked.connect(self._on_reset_clicked)
         stop_btn.clicked.connect(self._on_stop_clicked)
         validate_btn.clicked.connect(self._on_validate_clicked)
@@ -330,8 +338,9 @@ class PublisherWindow(QtWidgets.QDialog):
         self._comment_input = comment_input
         self._footer_spacer = footer_spacer
 
-        self._stop_btn = stop_btn
+        self._save_btn = save_btn
         self._reset_btn = reset_btn
+        self._stop_btn = stop_btn
         self._validate_btn = validate_btn
         self._publish_btn = publish_btn
 
@@ -388,7 +397,9 @@ class PublisherWindow(QtWidgets.QDialog):
     def closeEvent(self, event):
         self._window_is_visible = False
         self._uninstall_app_event_listener()
-        self.save_changes()
+        # TODO capture changes and ask user if wants to save changes on close
+        if not self._controller.host_context_has_changed:
+            self._save_changes(False)
         self._reset_on_show = True
         self._controller.clear_thumbnail_temp_dir_path()
         super(PublisherWindow, self).closeEvent(event)
@@ -421,6 +432,19 @@ class PublisherWindow(QtWidgets.QDialog):
         if event.key() == QtCore.Qt.Key_Escape:
             event.accept()
             return
+
+        if event.matches(QtGui.QKeySequence.Save):
+            if not self._controller.publish_has_started:
+                self._save_changes(True)
+            event.accept()
+            return
+
+        if event.matches(ResetKeySequence):
+            if not self.controller.publish_is_running:
+                self.reset()
+            event.accept()
+            return
+
         super(PublisherWindow, self).keyPressEvent(event)
 
     def _on_overlay_message(self, event):
@@ -455,8 +479,65 @@ class PublisherWindow(QtWidgets.QDialog):
             self._reset_on_show = False
             self.reset()
 
-    def save_changes(self):
-        self._controller.save_changes()
+    def _checks_before_save(self, explicit_save):
+        """Save of changes may trigger some issues.
+
+        Check if context did change and ask user if he is really sure the
+        save should happen. A dialog can be shown during this method.
+
+        Args:
+            explicit_save (bool): Method was called when user explicitly asked
+                for save. Value affects shown message.
+
+        Returns:
+            bool: Save can happen.
+        """
+
+        if not self._controller.host_context_has_changed:
+            return True
+
+        title = "Host context changed"
+        if explicit_save:
+            message = (
+                "Context has changed since Publisher window was refreshed last"
+                " time.\n\nAre you sure you want to save changes?"
+            )
+        else:
+            message = (
+                "Your action requires save of changes but context has changed"
+                " since Publisher window was refreshed last time.\n\nAre you"
+                " sure you want to continue and save changes?"
+            )
+
+        result = QtWidgets.QMessageBox.question(
+            self,
+            title,
+            message,
+            QtWidgets.QMessageBox.Save | QtWidgets.QMessageBox.Cancel
+        )
+        return result == QtWidgets.QMessageBox.Save
+
+    def _save_changes(self, explicit_save):
+        """Save changes of Creation part.
+
+        All possible triggers of save changes were moved to main window (here),
+        so it can handle possible issues with save at one place. Do checks,
+        so user don't accidentally save changes to different file or using
+        different context.
+        Moving responsibility to this place gives option to show the dialog and
+        wait for user's response without breaking action he wanted to do.
+
+        Args:
+            explicit_save (bool): Method was called when user explicitly asked
+                for save. Value affects shown message.
+
+        Returns:
+            bool: Save happened successfully.
+        """
+
+        if not self._checks_before_save(explicit_save):
+            return False
+        return self._controller.save_changes()
 
     def reset(self):
         self._controller.reset()
@@ -491,15 +572,18 @@ class PublisherWindow(QtWidgets.QDialog):
         self._help_dialog.show()
 
         window = self.window()
-        desktop = QtWidgets.QApplication.desktop()
-        screen_idx = desktop.screenNumber(window)
-        screen = desktop.screen(screen_idx)
-        screen_rect = screen.geometry()
+        if hasattr(QtWidgets.QApplication, "desktop"):
+            desktop = QtWidgets.QApplication.desktop()
+            screen_idx = desktop.screenNumber(window)
+            screen_geo = desktop.screenGeometry(screen_idx)
+        else:
+            screen = window.screen()
+            screen_geo = screen.geometry()
 
         window_geo = window.geometry()
         dialog_x = window_geo.x() + window_geo.width()
         dialog_right = (dialog_x + self._help_dialog.width()) - 1
-        diff = dialog_right - screen_rect.right()
+        diff = dialog_right - screen_geo.right()
         if diff > 0:
             dialog_x -= diff
 
@@ -549,6 +633,14 @@ class PublisherWindow(QtWidgets.QDialog):
     def _on_create_request(self):
         self._go_to_create_tab()
 
+    def _on_convert_requested(self):
+        if not self._save_changes(False):
+            return
+        convertor_identifiers = (
+            self._overview_widget.get_selected_legacy_convertors()
+        )
+        self._controller.trigger_convertor_items(convertor_identifiers)
+
     def _set_current_tab(self, identifier):
         self._tabs_widget.set_current_tab(identifier)
 
@@ -599,8 +691,10 @@ class PublisherWindow(QtWidgets.QDialog):
         self._publish_frame.setVisible(visible)
         self._update_publish_frame_rect()
 
+    def _on_save_clicked(self):
+        self._save_changes(True)
+
     def _on_reset_clicked(self):
-        self.save_changes()
         self.reset()
 
     def _on_stop_clicked(self):
@@ -610,14 +704,17 @@ class PublisherWindow(QtWidgets.QDialog):
         self._controller.set_comment(self._comment_input.text())
 
     def _on_validate_clicked(self):
-        self._set_publish_comment()
-        self._controller.validate()
+        if self._save_changes(False):
+            self._set_publish_comment()
+            self._controller.validate()
 
     def _on_publish_clicked(self):
-        self._set_publish_comment()
-        self._controller.publish()
+        if self._save_changes(False):
+            self._set_publish_comment()
+            self._controller.publish()
 
     def _set_footer_enabled(self, enabled):
+        self._save_btn.setEnabled(True)
         self._reset_btn.setEnabled(True)
         if enabled:
             self._stop_btn.setEnabled(False)
diff --git a/openpype/tools/traypublisher/window.py b/openpype/tools/traypublisher/window.py
index 3007fa66a5..3ac1b4c4ad 100644
--- a/openpype/tools/traypublisher/window.py
+++ b/openpype/tools/traypublisher/window.py
@@ -247,7 +247,7 @@ class TrayPublishWindow(PublisherWindow):
 
     def _on_project_select(self, project_name):
         # TODO register project specific plugin paths
-        self._controller.save_changes()
+        self._controller.save_changes(False)
         self._controller.reset_project_data_cache()
 
         self.reset()

From 79eb8f105f02c9309949d64d425f64095ac6e7c5 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 23 Mar 2023 12:54:55 +0100
Subject: [PATCH 121/151] celaction: make parameters enumerator

---
 .../celaction/hooks/pre_celaction_setup.py    | 16 ++++++++++++++--
 .../defaults/project_settings/celaction.json  | 10 ++++------
 .../schema_project_celaction.json             | 19 +++++++++++++++----
 3 files changed, 33 insertions(+), 12 deletions(-)

diff --git a/openpype/hosts/celaction/hooks/pre_celaction_setup.py b/openpype/hosts/celaction/hooks/pre_celaction_setup.py
index 7506f1a52c..81f5f2bf11 100644
--- a/openpype/hosts/celaction/hooks/pre_celaction_setup.py
+++ b/openpype/hosts/celaction/hooks/pre_celaction_setup.py
@@ -56,8 +56,20 @@ class CelactionPrelaunchHook(PreLaunchHook):
         ]
 
         # Add custom parameters from workfile settings
-        if workfile_settings["parameters"]:
-            parameters += workfile_settings["parameters"]
+        if "render_chunk" in workfile_settings["submission_overrides"]:
+            parameters += [
+            "--chunk *CHUNK*"
+        ]
+        elif "resolution" in workfile_settings["submission_overrides"]:
+            parameters += [
+                "--resolutionWidth *X*",
+                "--resolutionHeight *Y*"
+            ]
+        elif "frame_range" in workfile_settings["submission_overrides"]:
+            parameters += [
+                "--frameStart *START*",
+                "--frameEnd *END*"
+            ]
 
         winreg.SetValueEx(
             hKey, "SubmitParametersTitle", 0, winreg.REG_SZ,
diff --git a/openpype/settings/defaults/project_settings/celaction.json b/openpype/settings/defaults/project_settings/celaction.json
index 0194b2c48c..822604fd2f 100644
--- a/openpype/settings/defaults/project_settings/celaction.json
+++ b/openpype/settings/defaults/project_settings/celaction.json
@@ -10,12 +10,10 @@
         }
     },
     "workfile": {
-        "parameters": [
-            "--chunk *CHUNK*",
-            "--frameStart *START*",
-            "--frameEnd *END*",
-            "--resolutionWidth *X*",
-            "--resolutionHeight *Y*"
+        "submission_overrides": [
+            "render_chunk",
+            "frame_range",
+            "resolution"
         ]
     },
     "publish": {
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_celaction.json b/openpype/settings/entities/schemas/projects_schema/schema_project_celaction.json
index 4ca3cbb4da..c5ca3eb9f5 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_celaction.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_celaction.json
@@ -29,10 +29,21 @@
             "label": "Workfile",
             "children": [
                 {
-                    "key": "parameters",
-                    "label": "Parameters",
-                    "type": "list",
-                    "object_type": "text"
+                    "key": "submission_overrides",
+                    "label": "Submission workfile overrides",
+                    "type": "enum",
+                    "multiselection": true,
+                    "enum_items": [
+                        {
+                            "render_chunk": "Pass chunk size"
+                        },
+                        {
+                            "frame_range": "Pass frame range"
+                        },
+                        {
+                            "resolution": "Pass resolution"
+                        }
+                    ]
                 }
             ]
         },

From 011e635c1f91a3e49b282aaf3bf935da3ba31bd0 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 23 Mar 2023 12:56:54 +0100
Subject: [PATCH 122/151] hound

---
 openpype/hosts/celaction/hooks/pre_celaction_setup.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/celaction/hooks/pre_celaction_setup.py b/openpype/hosts/celaction/hooks/pre_celaction_setup.py
index 81f5f2bf11..c7e8bc5d0c 100644
--- a/openpype/hosts/celaction/hooks/pre_celaction_setup.py
+++ b/openpype/hosts/celaction/hooks/pre_celaction_setup.py
@@ -58,8 +58,8 @@ class CelactionPrelaunchHook(PreLaunchHook):
         # Add custom parameters from workfile settings
         if "render_chunk" in workfile_settings["submission_overrides"]:
             parameters += [
-            "--chunk *CHUNK*"
-        ]
+                "--chunk *CHUNK*"
+           ]
         elif "resolution" in workfile_settings["submission_overrides"]:
             parameters += [
                 "--resolutionWidth *X*",

From 54d566a4ee76924a2d091d4c3fbf7e0f076749df Mon Sep 17 00:00:00 2001
From: Toke Jepsen <tokejepsen@gmail.com>
Date: Thu, 23 Mar 2023 12:17:02 +0000
Subject: [PATCH 123/151] Update website/docs/admin_hosts_maya.md

Co-authored-by: Roy Nieterau <roy_nieterau@hotmail.com>
---
 website/docs/admin_hosts_maya.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/docs/admin_hosts_maya.md b/website/docs/admin_hosts_maya.md
index fe30703c2e..716bbadd88 100644
--- a/website/docs/admin_hosts_maya.md
+++ b/website/docs/admin_hosts_maya.md
@@ -139,7 +139,7 @@ Most settings to override in the viewport are self explanatory and can be found
 
 #### Camera Options
 
-These camera options can be overridden when publishing the review. They can be found on the camera shape node.
+These options are set on the camera shape when publishing the review. They correspond to attributes on the Maya camera shape node.
 
 ![Extract Playblast Settings](assets/maya-admin_extract_playblast_settings_camera_options.png)
 

From f5117f4593f62b086e6af1809331c5d3580af73c Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 23 Mar 2023 14:28:05 +0100
Subject: [PATCH 124/151] celaction: fixes after testing

---
 .../hosts/celaction/hooks/pre_celaction_setup.py | 16 +++++++++-------
 .../plugins/publish/submit_celaction_deadline.py |  2 +-
 2 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/openpype/hosts/celaction/hooks/pre_celaction_setup.py b/openpype/hosts/celaction/hooks/pre_celaction_setup.py
index c7e8bc5d0c..96e784875c 100644
--- a/openpype/hosts/celaction/hooks/pre_celaction_setup.py
+++ b/openpype/hosts/celaction/hooks/pre_celaction_setup.py
@@ -58,17 +58,17 @@ class CelactionPrelaunchHook(PreLaunchHook):
         # Add custom parameters from workfile settings
         if "render_chunk" in workfile_settings["submission_overrides"]:
             parameters += [
-                "--chunk *CHUNK*"
+                "--chunk", "*CHUNK*"
            ]
-        elif "resolution" in workfile_settings["submission_overrides"]:
+        if "resolution" in workfile_settings["submission_overrides"]:
             parameters += [
-                "--resolutionWidth *X*",
-                "--resolutionHeight *Y*"
+                "--resolutionWidth", "*X*",
+                "--resolutionHeight", "*Y*"
             ]
-        elif "frame_range" in workfile_settings["submission_overrides"]:
+        if "frame_range" in workfile_settings["submission_overrides"]:
             parameters += [
-                "--frameStart *START*",
-                "--frameEnd *END*"
+                "--frameStart", "*START*",
+                "--frameEnd", "*END*"
             ]
 
         winreg.SetValueEx(
@@ -76,6 +76,8 @@ class CelactionPrelaunchHook(PreLaunchHook):
             subprocess.list2cmdline(parameters)
         )
 
+        self.log.debug(f"__ parameters: \"{parameters}\"")
+
         # setting resolution parameters
         path_submit = "\\".join([
             path_user_settings, "Dialogs", "SubmitOutput"
diff --git a/openpype/modules/deadline/plugins/publish/submit_celaction_deadline.py b/openpype/modules/deadline/plugins/publish/submit_celaction_deadline.py
index 038ee4fc03..bcf0850768 100644
--- a/openpype/modules/deadline/plugins/publish/submit_celaction_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_celaction_deadline.py
@@ -106,7 +106,7 @@ class CelactionSubmitDeadline(pyblish.api.InstancePlugin):
 
         # define chunk and priority
         chunk_size = instance.context.data.get("chunk")
-        if chunk_size == 0:
+        if not chunk_size:
             chunk_size = self.deadline_chunk_size
 
         # search for %02d pattern in name, and padding number

From cc7a9f32c1efd58d89f18f0da4101d9df44666c6 Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Thu, 23 Mar 2023 14:30:51 +0100
Subject: [PATCH 125/151] :art: add OP startup script for max to cmdline args

---
 openpype/settings/defaults/system_settings/applications.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/settings/defaults/system_settings/applications.json b/openpype/settings/defaults/system_settings/applications.json
index 5fd9b926fb..eb3a88ce66 100644
--- a/openpype/settings/defaults/system_settings/applications.json
+++ b/openpype/settings/defaults/system_settings/applications.json
@@ -133,7 +133,7 @@
                     "linux": []
                 },
                 "arguments": {
-                    "windows": [],
+                    "windows": ["-U MAXScript {OPENPYPE_ROOT}\\openpype\\hosts\\max\\startup\\startup.ms"],
                     "darwin": [],
                     "linux": []
                 },

From 0f6d969867821c077486cd685bb0c8efbeabac21 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Date: Thu, 23 Mar 2023 14:35:58 +0100
Subject: [PATCH 126/151] fix shortcut key sequence check (#4694)

---
 openpype/tools/publisher/window.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/openpype/tools/publisher/window.py b/openpype/tools/publisher/window.py
index c72b60d826..8826e0f849 100644
--- a/openpype/tools/publisher/window.py
+++ b/openpype/tools/publisher/window.py
@@ -439,7 +439,9 @@ class PublisherWindow(QtWidgets.QDialog):
             event.accept()
             return
 
-        if event.matches(ResetKeySequence):
+        if ResetKeySequence.matches(
+            QtGui.QKeySequence(event.key() | event.modifiers())
+        ):
             if not self.controller.publish_is_running:
                 self.reset()
             event.accept()

From 93ad644f7488dcb0d10e6183618a85b0016850d3 Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Thu, 23 Mar 2023 15:36:04 +0000
Subject: [PATCH 127/151] Use pan zoom in capture instead of collect/restore.

---
 openpype/hosts/maya/plugins/publish/extract_playblast.py | 9 ++-------
 openpype/hosts/maya/plugins/publish/extract_thumbnail.py | 9 ++-------
 2 files changed, 4 insertions(+), 14 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_playblast.py b/openpype/hosts/maya/plugins/publish/extract_playblast.py
index ab1e1a65c6..bdb34474e8 100644
--- a/openpype/hosts/maya/plugins/publish/extract_playblast.py
+++ b/openpype/hosts/maya/plugins/publish/extract_playblast.py
@@ -113,11 +113,8 @@ class ExtractPlayblast(publish.Extractor):
             preset["viewport_options"] = {"imagePlane": image_plane}
 
         # Disable Pan/Zoom.
-        pan_zoom = cmds.getAttr("{}.panZoomEnabled".format(preset["camera"]))
-        cmds.setAttr(
-            "{}.panZoomEnabled".format(preset["camera"]),
-            instance.data["panZoom"]
-        )
+        preset.pop("pan_zoom", None)
+        preset["camera_options"]["panZoomEnabled"] = instance.data["panZoom"]
 
         # Need to explicitly enable some viewport changes so the viewport is
         # refreshed ahead of playblasting.
@@ -170,8 +167,6 @@ class ExtractPlayblast(publish.Extractor):
                 instance.data["panel"], edit=True, **viewport_defaults
             )
 
-        cmds.setAttr("{}.panZoomEnabled".format(preset["camera"]), pan_zoom)
-
         self.log.debug("playblast path  {}".format(path))
 
         collected_files = os.listdir(stagingdir)
diff --git a/openpype/hosts/maya/plugins/publish/extract_thumbnail.py b/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
index 2d3daa53c6..f2d084b828 100644
--- a/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
+++ b/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
@@ -123,11 +123,8 @@ class ExtractThumbnail(publish.Extractor):
             preset["viewport_options"] = {"imagePlane": image_plane}
 
         # Disable Pan/Zoom.
-        pan_zoom = cmds.getAttr("{}.panZoomEnabled".format(preset["camera"]))
-        cmds.setAttr(
-            "{}.panZoomEnabled".format(preset["camera"]),
-            instance.data["panZoom"]
-        )
+        preset.pop("pan_zoom", None)
+        preset["camera_options"]["panZoomEnabled"] = instance.data["panZoom"]
 
         with lib.maintained_time():
             # Force viewer to False in call to capture because we have our own
@@ -148,8 +145,6 @@ class ExtractThumbnail(publish.Extractor):
 
         _, thumbnail = os.path.split(playblast)
 
-        cmds.setAttr("{}.panZoomEnabled".format(preset["camera"]), pan_zoom)
-
         self.log.info("file list  {}".format(thumbnail))
 
         if "representations" not in instance.data:

From e7b2e0026f2769e5b1100af1a72e260f17404b65 Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Thu, 23 Mar 2023 15:36:57 +0000
Subject: [PATCH 128/151] BigRoy feedback

---
 website/docs/admin_hosts_maya.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/website/docs/admin_hosts_maya.md b/website/docs/admin_hosts_maya.md
index fe30703c2e..6271feda15 100644
--- a/website/docs/admin_hosts_maya.md
+++ b/website/docs/admin_hosts_maya.md
@@ -113,6 +113,8 @@ This is useful to fix some specific renderer glitches and advanced hacking of Ma
 ### Extract Playblast Settings (review)
 These settings provide granular control over how the playblasts or reviews are produced in Maya.
 
+Some of these settings are also available on the instance itself, in which case these settings will become the default value when creating the review instance.
+
 ![Extract Playblast Settings](assets/maya-admin_extract_playblast_settings.png)
 
 - **Compression type** which file encoding to use.
@@ -126,8 +128,8 @@ These settings provide granular control over how the playblasts or reviews are p
 - **Off Screen** records the playblast hidden from the user.
 - **2D Pan/Zoom** enables the 2D Pan/Zoom functionality of the camera.
 - **Renderer name** which renderer to use for playblasting.
-- **Width** width of the output resolution.
-- **Height** height of the output resolution.
+- **Width** width of the output resolution. If this value is `0`, the asset's width is used.
+- **Height** height of the output resolution. If this value is `0`, the asset's height is used.
 
 #### Viewport Options
 

From 8b9a3547d9feeb9516a119f08b6b3e5964abcee9 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 23 Mar 2023 17:15:40 +0100
Subject: [PATCH 129/151] adding project actions

---
 .github/workflows/project_actions.yml | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)
 create mode 100644 .github/workflows/project_actions.yml

diff --git a/.github/workflows/project_actions.yml b/.github/workflows/project_actions.yml
new file mode 100644
index 0000000000..9c8c9da7dd
--- /dev/null
+++ b/.github/workflows/project_actions.yml
@@ -0,0 +1,23 @@
+name: project-actions
+
+on:
+  pull_request:
+    types: [review_requested, closed]
+  pull_request_review:
+    types: [submitted]
+
+jobs:
+  pr_review_requested:
+    name: pr_review_requested
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request' && github.event.action == 'review_requested'
+    steps:
+      - name: Move PR to 'Change Requested'
+        uses: leonsteinhaeuser/project-beta-automations@v2.1.0
+        with:
+          gh_token: ${{ secrets.YNPUT_BOT_TOKEN }}
+          user: ${{ secrets.CI_USER }}
+          organization: ynput
+          project_id: 11
+          resource_node_id: ${{ github.event.pull_request.node_id }}
+          status_value: Change Requested

From d88cd48b8eda227873191b830a5792f3403b1abf Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Fri, 24 Mar 2023 07:48:28 +0000
Subject: [PATCH 130/151] Refactor to nested/stacked contextlib

---
 .../maya/plugins/publish/extract_playblast.py | 83 ++++++++++++-------
 1 file changed, 52 insertions(+), 31 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_playblast.py b/openpype/hosts/maya/plugins/publish/extract_playblast.py
index a652db2eb5..9d35789343 100644
--- a/openpype/hosts/maya/plugins/publish/extract_playblast.py
+++ b/openpype/hosts/maya/plugins/publish/extract_playblast.py
@@ -1,5 +1,6 @@
 import os
 import json
+import contextlib
 
 import clique
 import capture
@@ -11,6 +12,16 @@ from maya import cmds
 import pymel.core as pm
 
 
+@contextlib.contextmanager
+def panel_camera(panel, camera):
+    original_camera = cmds.modelPanel(panel, query=True, camera=True)
+    try:
+        cmds.modelPanel(panel, edit=True, camera=camera)
+        yield
+    finally:
+        cmds.modelPanel(panel, edit=True, camera=original_camera)
+
+
 class ExtractPlayblast(publish.Extractor):
     """Extract viewport playblast.
 
@@ -25,6 +36,31 @@ class ExtractPlayblast(publish.Extractor):
     optional = True
     capture_preset = {}
 
+    def _capture(self, preset, override_viewport_options, instance):
+        filename = preset.get("filename", "%TEMP%")
+
+        # Force viewer to False in call to capture because we have our own
+        # viewer opening call to allow a signal to trigger between
+        # playblast and viewer
+        preset['viewer'] = False
+
+        # Update preset with current panel setting
+        # if override_viewport_options is turned off
+        if not override_viewport_options:
+            panel_preset = capture.parse_view(instance.data["panel"])
+            panel_preset.pop("camera")
+            preset.update(panel_preset)
+
+        self.log.info(
+            "Using preset:\n{}".format(
+                json.dumps(preset, sort_keys=True, indent=4)
+            )
+        )
+
+        path = capture.capture(log=self.log, **preset)
+
+        return filename, path
+
     def process(self, instance):
         self.log.info("Extracting capture..")
 
@@ -112,15 +148,6 @@ class ExtractPlayblast(publish.Extractor):
         else:
             preset["viewport_options"] = {"imagePlane": image_plane}
 
-        # Image planes do not update the file sequence unless the active panel
-        # is viewing through the camera.
-        panel_camera = cmds.modelPanel(
-            instance.data["panel"], query=True, camera=True
-        )
-        cmds.modelPanel(
-            instance.data["panel"], edit=True, camera=preset["camera"]
-        )
-
         # Disable Pan/Zoom.
         pan_zoom = cmds.getAttr("{}.panZoomEnabled".format(preset["camera"]))
         cmds.setAttr("{}.panZoomEnabled".format(preset["camera"]), False)
@@ -147,28 +174,25 @@ class ExtractPlayblast(publish.Extractor):
         override_viewport_options = (
             capture_presets['Viewport Options']['override_viewport_options']
         )
-        with lib.maintained_time():
-            filename = preset.get("filename", "%TEMP%")
 
-            # Force viewer to False in call to capture because we have our own
-            # viewer opening call to allow a signal to trigger between
-            # playblast and viewer
-            preset['viewer'] = False
-
-            # Update preset with current panel setting
-            # if override_viewport_options is turned off
-            if not override_viewport_options:
-                panel_preset = capture.parse_view(instance.data["panel"])
-                panel_preset.pop("camera")
-                preset.update(panel_preset)
-
-            self.log.info(
-                "Using preset:\n{}".format(
-                    json.dumps(preset, sort_keys=True, indent=4)
+        if getattr(contextlib, "nested", None):
+            with contextlib.nested(
+                lib.maintained_time(),
+                panel_camera(instance.data["panel"], preset["camera"])
+            ):
+                filename, path = self._capture(
+                    preset, override_viewport_options, instance
+                )
+        else:
+            with contextlib.ExitStack() as stack:
+                stack.enter_context(lib.maintained_time())
+                stack.enter_context(
+                    panel_camera(instance.data["panel"], preset["camera"])
                 )
-            )
 
-            path = capture.capture(log=self.log, **preset)
+                filename, path = self._capture(
+                    preset, override_viewport_options, instance
+                )
 
         # Restoring viewport options.
         if viewport_defaults:
@@ -178,9 +202,6 @@ class ExtractPlayblast(publish.Extractor):
 
         cmds.setAttr("{}.panZoomEnabled".format(preset["camera"]), pan_zoom)
 
-        # Restore panel camera.
-        cmds.modelPanel(instance.data["panel"], edit=True, camera=panel_camera)
-
         self.log.debug("playblast path  {}".format(path))
 
         collected_files = os.listdir(stagingdir)

From 4d42e58074c873f2247fa31e4d86b51c6c1b4262 Mon Sep 17 00:00:00 2001
From: Toke Jepsen <tokejepsen@gmail.com>
Date: Fri, 24 Mar 2023 09:37:05 +0000
Subject: [PATCH 131/151] Update
 openpype/hosts/maya/plugins/publish/extract_playblast.py

---
 openpype/hosts/maya/plugins/publish/extract_playblast.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/openpype/hosts/maya/plugins/publish/extract_playblast.py b/openpype/hosts/maya/plugins/publish/extract_playblast.py
index 9d35789343..e7dc42d2c0 100644
--- a/openpype/hosts/maya/plugins/publish/extract_playblast.py
+++ b/openpype/hosts/maya/plugins/publish/extract_playblast.py
@@ -175,7 +175,10 @@ class ExtractPlayblast(publish.Extractor):
             capture_presets['Viewport Options']['override_viewport_options']
         )
 
+        # Need to ensure Python 2 compatibility.
+        # TODO: Remove once dropping Python 2.
         if getattr(contextlib, "nested", None):
+            # Python 3 compatibility.
             with contextlib.nested(
                 lib.maintained_time(),
                 panel_camera(instance.data["panel"], preset["camera"])
@@ -184,6 +187,7 @@ class ExtractPlayblast(publish.Extractor):
                     preset, override_viewport_options, instance
                 )
         else:
+            # Python 2 compatibility.
             with contextlib.ExitStack() as stack:
                 stack.enter_context(lib.maintained_time())
                 stack.enter_context(

From d1038ace686dea66069319b2a8e0df7df3c4e4c7 Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Fri, 24 Mar 2023 09:44:39 +0000
Subject: [PATCH 132/151] Refactor _capture

---
 .../maya/plugins/publish/extract_playblast.py | 35 +++++++++----------
 1 file changed, 16 insertions(+), 19 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_playblast.py b/openpype/hosts/maya/plugins/publish/extract_playblast.py
index e7dc42d2c0..9bd859ade1 100644
--- a/openpype/hosts/maya/plugins/publish/extract_playblast.py
+++ b/openpype/hosts/maya/plugins/publish/extract_playblast.py
@@ -37,29 +37,13 @@ class ExtractPlayblast(publish.Extractor):
     capture_preset = {}
 
     def _capture(self, preset, override_viewport_options, instance):
-        filename = preset.get("filename", "%TEMP%")
-
-        # Force viewer to False in call to capture because we have our own
-        # viewer opening call to allow a signal to trigger between
-        # playblast and viewer
-        preset['viewer'] = False
-
-        # Update preset with current panel setting
-        # if override_viewport_options is turned off
-        if not override_viewport_options:
-            panel_preset = capture.parse_view(instance.data["panel"])
-            panel_preset.pop("camera")
-            preset.update(panel_preset)
-
         self.log.info(
             "Using preset:\n{}".format(
                 json.dumps(preset, sort_keys=True, indent=4)
             )
         )
 
-        path = capture.capture(log=self.log, **preset)
-
-        return filename, path
+        return capture.capture(log=self.log, **preset)
 
     def process(self, instance):
         self.log.info("Extracting capture..")
@@ -175,6 +159,18 @@ class ExtractPlayblast(publish.Extractor):
             capture_presets['Viewport Options']['override_viewport_options']
         )
 
+        # Force viewer to False in call to capture because we have our own
+        # viewer opening call to allow a signal to trigger between
+        # playblast and viewer
+        preset['viewer'] = False
+
+        # Update preset with current panel setting
+        # if override_viewport_options is turned off
+        if not override_viewport_options:
+            panel_preset = capture.parse_view(instance.data["panel"])
+            panel_preset.pop("camera")
+            preset.update(panel_preset)
+
         # Need to ensure Python 2 compatibility.
         # TODO: Remove once dropping Python 2.
         if getattr(contextlib, "nested", None):
@@ -183,7 +179,7 @@ class ExtractPlayblast(publish.Extractor):
                 lib.maintained_time(),
                 panel_camera(instance.data["panel"], preset["camera"])
             ):
-                filename, path = self._capture(
+                path = self._capture(
                     preset, override_viewport_options, instance
                 )
         else:
@@ -194,7 +190,7 @@ class ExtractPlayblast(publish.Extractor):
                     panel_camera(instance.data["panel"], preset["camera"])
                 )
 
-                filename, path = self._capture(
+                path = self._capture(
                     preset, override_viewport_options, instance
                 )
 
@@ -214,6 +210,7 @@ class ExtractPlayblast(publish.Extractor):
                                                  minimum_items=1,
                                                  patterns=patterns)
 
+        filename = preset.get("filename", "%TEMP%")
         self.log.debug("filename {}".format(filename))
         frame_collection = None
         for collection in collections:

From 799a6b6cc457d4ef6b4b28f18fe6c831521376ea Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Fri, 24 Mar 2023 10:02:48 +0000
Subject: [PATCH 133/151] Remove path variable and _capture arguments.

---
 .../maya/plugins/publish/extract_playblast.py     | 15 +++++----------
 1 file changed, 5 insertions(+), 10 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_playblast.py b/openpype/hosts/maya/plugins/publish/extract_playblast.py
index 9bd859ade1..41e4f3a7c2 100644
--- a/openpype/hosts/maya/plugins/publish/extract_playblast.py
+++ b/openpype/hosts/maya/plugins/publish/extract_playblast.py
@@ -36,14 +36,15 @@ class ExtractPlayblast(publish.Extractor):
     optional = True
     capture_preset = {}
 
-    def _capture(self, preset, override_viewport_options, instance):
+    def _capture(self, preset):
         self.log.info(
             "Using preset:\n{}".format(
                 json.dumps(preset, sort_keys=True, indent=4)
             )
         )
 
-        return capture.capture(log=self.log, **preset)
+        path = capture.capture(log=self.log, **preset)
+        self.log.debug("playblast path  {}".format(path))
 
     def process(self, instance):
         self.log.info("Extracting capture..")
@@ -179,9 +180,7 @@ class ExtractPlayblast(publish.Extractor):
                 lib.maintained_time(),
                 panel_camera(instance.data["panel"], preset["camera"])
             ):
-                path = self._capture(
-                    preset, override_viewport_options, instance
-                )
+                self._capture(preset)
         else:
             # Python 2 compatibility.
             with contextlib.ExitStack() as stack:
@@ -190,9 +189,7 @@ class ExtractPlayblast(publish.Extractor):
                     panel_camera(instance.data["panel"], preset["camera"])
                 )
 
-                path = self._capture(
-                    preset, override_viewport_options, instance
-                )
+                self._capture(preset)
 
         # Restoring viewport options.
         if viewport_defaults:
@@ -202,8 +199,6 @@ class ExtractPlayblast(publish.Extractor):
 
         cmds.setAttr("{}.panZoomEnabled".format(preset["camera"]), pan_zoom)
 
-        self.log.debug("playblast path  {}".format(path))
-
         collected_files = os.listdir(stagingdir)
         patterns = [clique.PATTERNS["frames"]]
         collections, remainder = clique.assemble(collected_files,

From de4b3e4d659e38715a78290fc1c05e00fedb7432 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Date: Fri, 24 Mar 2023 15:25:49 +0100
Subject: [PATCH 134/151] Ftrack: Hierarchical <> Non-Hierarchical attributes
 sync fix (#4635)

* modify action to use 'CustomAttributeValue' and fix bugs

* modify and fix event handler to push hierarchical values

* added few smaller comments

* removed unused variables
---
 .../action_push_frame_values_to_task.py       |  316 +++--
 .../event_push_frame_values_to_task.py        | 1096 ++++++-----------
 2 files changed, 546 insertions(+), 866 deletions(-)

diff --git a/openpype/modules/ftrack/event_handlers_server/action_push_frame_values_to_task.py b/openpype/modules/ftrack/event_handlers_server/action_push_frame_values_to_task.py
index 1209375f82..a698195c59 100644
--- a/openpype/modules/ftrack/event_handlers_server/action_push_frame_values_to_task.py
+++ b/openpype/modules/ftrack/event_handlers_server/action_push_frame_values_to_task.py
@@ -9,7 +9,7 @@ from openpype_modules.ftrack.lib import (
 
 
 class PushHierValuesToNonHier(ServerAction):
-    """Action push hierarchical custom attribute values to non hierarchical.
+    """Action push hierarchical custom attribute values to non-hierarchical.
 
     Hierarchical value is also pushed to their task entities.
 
@@ -119,17 +119,109 @@ class PushHierValuesToNonHier(ServerAction):
             self.join_query_keys(object_ids)
         )).all()
 
-        output = {}
+        attrs_by_obj_id = collections.defaultdict(list)
         hiearchical = []
         for attr in attrs:
             if attr["is_hierarchical"]:
                 hiearchical.append(attr)
                 continue
             obj_id = attr["object_type_id"]
-            if obj_id not in output:
-                output[obj_id] = []
-            output[obj_id].append(attr)
-        return output, hiearchical
+            attrs_by_obj_id[obj_id].append(attr)
+        return attrs_by_obj_id, hiearchical
+
+    def query_attr_value(
+        self,
+        session,
+        hier_attrs,
+        attrs_by_obj_id,
+        dst_object_type_ids,
+        task_entity_ids,
+        non_task_entity_ids,
+        parent_id_by_entity_id
+    ):
+        all_non_task_ids_with_parents = set()
+        for entity_id in non_task_entity_ids:
+            all_non_task_ids_with_parents.add(entity_id)
+            _entity_id = entity_id
+            while True:
+                parent_id = parent_id_by_entity_id.get(_entity_id)
+                if (
+                    parent_id is None
+                    or parent_id in all_non_task_ids_with_parents
+                ):
+                    break
+                all_non_task_ids_with_parents.add(parent_id)
+                _entity_id = parent_id
+
+        all_entity_ids = (
+            set(all_non_task_ids_with_parents)
+            | set(task_entity_ids)
+        )
+        attr_ids = {attr["id"] for attr in hier_attrs}
+        for obj_id in dst_object_type_ids:
+            attrs = attrs_by_obj_id.get(obj_id)
+            if attrs is not None:
+                for attr in attrs:
+                    attr_ids.add(attr["id"])
+
+        real_values_by_entity_id = {
+            entity_id: {}
+            for entity_id in all_entity_ids
+        }
+
+        attr_values = query_custom_attributes(
+            session, attr_ids, all_entity_ids, True
+        )
+        for item in attr_values:
+            entity_id = item["entity_id"]
+            attr_id = item["configuration_id"]
+            real_values_by_entity_id[entity_id][attr_id] = item["value"]
+
+        # Fill hierarchical values
+        hier_attrs_key_by_id = {
+            hier_attr["id"]: hier_attr
+            for hier_attr in hier_attrs
+        }
+        hier_values_per_entity_id = {}
+        for entity_id in all_non_task_ids_with_parents:
+            real_values = real_values_by_entity_id[entity_id]
+            hier_values_per_entity_id[entity_id] = {}
+            for attr_id, attr in hier_attrs_key_by_id.items():
+                key = attr["key"]
+                hier_values_per_entity_id[entity_id][key] = (
+                    real_values.get(attr_id)
+                )
+
+        output = {}
+        for entity_id in non_task_entity_ids:
+            output[entity_id] = {}
+            for attr in hier_attrs_key_by_id.values():
+                key = attr["key"]
+                value = hier_values_per_entity_id[entity_id][key]
+                tried_ids = set()
+                if value is None:
+                    tried_ids.add(entity_id)
+                    _entity_id = entity_id
+                    while value is None:
+                        parent_id = parent_id_by_entity_id.get(_entity_id)
+                        if not parent_id:
+                            break
+                        value = hier_values_per_entity_id[parent_id][key]
+                        if value is not None:
+                            break
+                        _entity_id = parent_id
+                        tried_ids.add(parent_id)
+
+                if value is None:
+                    value = attr["default"]
+
+                if value is not None:
+                    for ent_id in tried_ids:
+                        hier_values_per_entity_id[ent_id][key] = value
+
+                output[entity_id][key] = value
+
+        return real_values_by_entity_id, output
 
     def propagate_values(self, session, event, selected_entities):
         ftrack_settings = self.get_ftrack_settings(
@@ -156,29 +248,24 @@ class PushHierValuesToNonHier(ServerAction):
         }
 
         task_object_type = object_types_by_low_name["task"]
-        destination_object_types = [task_object_type]
+        dst_object_type_ids = {task_object_type["id"]}
         for ent_type in interest_entity_types:
             obj_type = object_types_by_low_name.get(ent_type)
-            if obj_type and obj_type not in destination_object_types:
-                destination_object_types.append(obj_type)
-
-        destination_object_type_ids = set(
-            obj_type["id"]
-            for obj_type in destination_object_types
-        )
+            if obj_type:
+                dst_object_type_ids.add(obj_type["id"])
 
         interest_attributes = action_settings["interest_attributes"]
         # Find custom attributes definitions
         attrs_by_obj_id, hier_attrs = self.attrs_configurations(
-            session, destination_object_type_ids, interest_attributes
+            session, dst_object_type_ids, interest_attributes
         )
         # Filter destination object types if they have any object specific
         # custom attribute
-        for obj_id in tuple(destination_object_type_ids):
+        for obj_id in tuple(dst_object_type_ids):
             if obj_id not in attrs_by_obj_id:
-                destination_object_type_ids.remove(obj_id)
+                dst_object_type_ids.remove(obj_id)
 
-        if not destination_object_type_ids:
+        if not dst_object_type_ids:
             # TODO report that there are not matching custom attributes
             return {
                 "success": True,
@@ -192,14 +279,14 @@ class PushHierValuesToNonHier(ServerAction):
             session,
             selected_ids,
             project_entity,
-            destination_object_type_ids
+            dst_object_type_ids
         )
 
         self.log.debug("Preparing whole project hierarchy by ids.")
 
         entities_by_obj_id = {
             obj_id: []
-            for obj_id in destination_object_type_ids
+            for obj_id in dst_object_type_ids
         }
 
         self.log.debug("Filtering Task entities.")
@@ -223,10 +310,16 @@ class PushHierValuesToNonHier(ServerAction):
                 "message": "Nothing to do in your selection."
             }
 
-        self.log.debug("Getting Hierarchical custom attribute values parents.")
-        hier_values_by_entity_id = self.get_hier_values(
+        self.log.debug("Getting Custom attribute values.")
+        (
+            real_values_by_entity_id,
+            hier_values_by_entity_id
+        ) = self.query_attr_value(
             session,
             hier_attrs,
+            attrs_by_obj_id,
+            dst_object_type_ids,
+            task_entity_ids,
             non_task_entity_ids,
             parent_id_by_entity_id
         )
@@ -237,7 +330,8 @@ class PushHierValuesToNonHier(ServerAction):
             hier_attrs,
             task_entity_ids,
             hier_values_by_entity_id,
-            parent_id_by_entity_id
+            parent_id_by_entity_id,
+            real_values_by_entity_id
         )
 
         self.log.debug("Setting values to entities themselves.")
@@ -245,7 +339,8 @@ class PushHierValuesToNonHier(ServerAction):
             session,
             entities_by_obj_id,
             attrs_by_obj_id,
-            hier_values_by_entity_id
+            hier_values_by_entity_id,
+            real_values_by_entity_id
         )
 
         return True
@@ -322,112 +417,64 @@ class PushHierValuesToNonHier(ServerAction):
 
         return parent_id_by_entity_id, filtered_entities
 
-    def get_hier_values(
-        self,
-        session,
-        hier_attrs,
-        focus_entity_ids,
-        parent_id_by_entity_id
-    ):
-        all_ids_with_parents = set()
-        for entity_id in focus_entity_ids:
-            all_ids_with_parents.add(entity_id)
-            _entity_id = entity_id
-            while True:
-                parent_id = parent_id_by_entity_id.get(_entity_id)
-                if (
-                    not parent_id
-                    or parent_id in all_ids_with_parents
-                ):
-                    break
-                all_ids_with_parents.add(parent_id)
-                _entity_id = parent_id
-
-        hier_attr_ids = tuple(hier_attr["id"] for hier_attr in hier_attrs)
-        hier_attrs_key_by_id = {
-            hier_attr["id"]: hier_attr["key"]
-            for hier_attr in hier_attrs
-        }
-
-        values_per_entity_id = {}
-        for entity_id in all_ids_with_parents:
-            values_per_entity_id[entity_id] = {}
-            for key in hier_attrs_key_by_id.values():
-                values_per_entity_id[entity_id][key] = None
-
-        values = query_custom_attributes(
-            session, hier_attr_ids, all_ids_with_parents, True
-        )
-        for item in values:
-            entity_id = item["entity_id"]
-            key = hier_attrs_key_by_id[item["configuration_id"]]
-
-            values_per_entity_id[entity_id][key] = item["value"]
-
-        output = {}
-        for entity_id in focus_entity_ids:
-            output[entity_id] = {}
-            for key in hier_attrs_key_by_id.values():
-                value = values_per_entity_id[entity_id][key]
-                tried_ids = set()
-                if value is None:
-                    tried_ids.add(entity_id)
-                    _entity_id = entity_id
-                    while value is None:
-                        parent_id = parent_id_by_entity_id.get(_entity_id)
-                        if not parent_id:
-                            break
-                        value = values_per_entity_id[parent_id][key]
-                        if value is not None:
-                            break
-                        _entity_id = parent_id
-                        tried_ids.add(parent_id)
-
-                if value is not None:
-                    for ent_id in tried_ids:
-                        values_per_entity_id[ent_id][key] = value
-
-                output[entity_id][key] = value
-        return output
-
     def set_task_attr_values(
         self,
         session,
         hier_attrs,
         task_entity_ids,
         hier_values_by_entity_id,
-        parent_id_by_entity_id
+        parent_id_by_entity_id,
+        real_values_by_entity_id
     ):
         hier_attr_id_by_key = {
             attr["key"]: attr["id"]
             for attr in hier_attrs
         }
+        filtered_task_ids = set()
         for task_id in task_entity_ids:
-            parent_id = parent_id_by_entity_id.get(task_id) or {}
+            parent_id = parent_id_by_entity_id.get(task_id)
             parent_values = hier_values_by_entity_id.get(parent_id)
-            if not parent_values:
-                continue
+            if parent_values:
+                filtered_task_ids.add(task_id)
 
+        if not filtered_task_ids:
+            return
+
+        for task_id in filtered_task_ids:
+            parent_id = parent_id_by_entity_id[task_id]
+            parent_values = hier_values_by_entity_id[parent_id]
             hier_values_by_entity_id[task_id] = {}
+            real_task_attr_values = real_values_by_entity_id[task_id]
             for key, value in parent_values.items():
                 hier_values_by_entity_id[task_id][key] = value
+                if value is None:
+                    continue
+
                 configuration_id = hier_attr_id_by_key[key]
                 _entity_key = collections.OrderedDict([
                     ("configuration_id", configuration_id),
                     ("entity_id", task_id)
                 ])
-
-                session.recorded_operations.push(
-                    ftrack_api.operation.UpdateEntityOperation(
-                        "ContextCustomAttributeValue",
+                op = None
+                if configuration_id not in real_task_attr_values:
+                    op = ftrack_api.operation.CreateEntityOperation(
+                        "CustomAttributeValue",
+                        _entity_key,
+                        {"value": value}
+                    )
+                elif real_task_attr_values[configuration_id] != value:
+                    op = ftrack_api.operation.UpdateEntityOperation(
+                        "CustomAttributeValue",
                         _entity_key,
                         "value",
-                        ftrack_api.symbol.NOT_SET,
+                        real_task_attr_values[configuration_id],
                         value
                     )
-                )
-                if len(session.recorded_operations) > 100:
-                    session.commit()
+
+                if op is not None:
+                    session.recorded_operations.push(op)
+                    if len(session.recorded_operations) > 100:
+                        session.commit()
 
         session.commit()
 
@@ -436,39 +483,68 @@ class PushHierValuesToNonHier(ServerAction):
         session,
         entities_by_obj_id,
         attrs_by_obj_id,
-        hier_values_by_entity_id
+        hier_values_by_entity_id,
+        real_values_by_entity_id
     ):
+        """Push values from hierarchical custom attributes to non-hierarchical.
+
+        Args:
+            session (ftrack_api.Sessison): Session which queried entities,
+                values and which is used for change propagation.
+            entities_by_obj_id (dict[str, list[str]]): TypedContext
+                ftrack entity ids where the attributes are propagated by their
+                object ids.
+            attrs_by_obj_id (dict[str, ftrack_api.Entity]): Objects of
+                'CustomAttributeConfiguration' by their ids.
+            hier_values_by_entity_id (doc[str, dict[str, Any]]): Attribute
+                values by entity id and by their keys.
+            real_values_by_entity_id (doc[str, dict[str, Any]]): Real attribute
+                values of entities.
+        """
+
         for object_id, entity_ids in entities_by_obj_id.items():
             attrs = attrs_by_obj_id.get(object_id)
             if not attrs or not entity_ids:
                 continue
 
-            for attr in attrs:
-                for entity_id in entity_ids:
-                    value = (
-                        hier_values_by_entity_id
-                        .get(entity_id, {})
-                        .get(attr["key"])
-                    )
+            for entity_id in entity_ids:
+                real_values = real_values_by_entity_id.get(entity_id)
+                hier_values = hier_values_by_entity_id.get(entity_id)
+                if hier_values is None:
+                    continue
+
+                for attr in attrs:
+                    attr_id = attr["id"]
+                    attr_key = attr["key"]
+                    value = hier_values.get(attr_key)
                     if value is None:
                         continue
 
                     _entity_key = collections.OrderedDict([
-                        ("configuration_id", attr["id"]),
+                        ("configuration_id", attr_id),
                         ("entity_id", entity_id)
                     ])
 
-                    session.recorded_operations.push(
-                        ftrack_api.operation.UpdateEntityOperation(
-                            "ContextCustomAttributeValue",
+                    op = None
+                    if attr_id not in real_values:
+                        op = ftrack_api.operation.CreateEntityOperation(
+                            "CustomAttributeValue",
+                            _entity_key,
+                            {"value": value}
+                        )
+                    elif real_values[attr_id] != value:
+                        op = ftrack_api.operation.UpdateEntityOperation(
+                            "CustomAttributeValue",
                             _entity_key,
                             "value",
-                            ftrack_api.symbol.NOT_SET,
+                            real_values[attr_id],
                             value
                         )
-                    )
-                    if len(session.recorded_operations) > 100:
-                        session.commit()
+
+                    if op is not None:
+                        session.recorded_operations.push(op)
+                        if len(session.recorded_operations) > 100:
+                            session.commit()
 
         session.commit()
 
diff --git a/openpype/modules/ftrack/event_handlers_server/event_push_frame_values_to_task.py b/openpype/modules/ftrack/event_handlers_server/event_push_frame_values_to_task.py
index dc76920a57..0f10145c06 100644
--- a/openpype/modules/ftrack/event_handlers_server/event_push_frame_values_to_task.py
+++ b/openpype/modules/ftrack/event_handlers_server/event_push_frame_values_to_task.py
@@ -1,6 +1,6 @@
 import collections
-import datetime
 import copy
+from typing import Any
 
 import ftrack_api
 from openpype_modules.ftrack.lib import (
@@ -9,13 +9,30 @@ from openpype_modules.ftrack.lib import (
 )
 
 
-class PushFrameValuesToTaskEvent(BaseEvent):
+class PushHierValuesToNonHierEvent(BaseEvent):
+    """Push value changes between hierarchical and non-hierarchical attributes.
+
+    Changes of non-hierarchical attributes are pushed to hierarchical and back.
+    The attributes must have same definition of custom attribute.
+
+    Handler does not handle changes of hierarchical parents. So if entity does
+    not have explicitly set value of hierarchical attribute and any parent
+    would change it the change would not be propagated.
+
+    The handler also push the value to task entity on task creation
+        and movement. To push values between hierarchical & non-hierarchical
+        add 'Task' to entity types in settings.
+
+    Todos:
+        Task attribute values push on create/move should be possible to
+            enabled by settings.
+    """
+
     # Ignore event handler by default
     cust_attrs_query = (
         "select id, key, object_type_id, is_hierarchical, default"
         " from CustomAttributeConfiguration"
-        " where key in ({}) and"
-        " (object_type_id in ({}) or is_hierarchical is true)"
+        " where key in ({})"
     )
 
     _cached_task_object_id = None
@@ -26,35 +43,35 @@ class PushFrameValuesToTaskEvent(BaseEvent):
 
     settings_key = "sync_hier_entity_attributes"
 
-    def session_user_id(self, session):
-        if self._cached_user_id is None:
-            user = session.query(
-                "User where username is \"{}\"".format(session.api_user)
-            ).one()
-            self._cached_user_id = user["id"]
-        return self._cached_user_id
+    def filter_entities_info(
+        self, event: ftrack_api.event.base.Event
+    ) -> dict[str, list[dict[str, Any]]]:
+        """Basic entities filter info we care about.
 
-    def launch(self, session, event):
-        filtered_entities_info = self.filter_entities_info(event)
-        if not filtered_entities_info:
-            return
+        This filtering is first of many filters. This does not query anything
+        from ftrack nor use settings.
 
-        for project_id, entities_info in filtered_entities_info.items():
-            self.process_by_project(session, event, project_id, entities_info)
+        Args:
+            event (ftrack_api.event.base.Event): Ftrack event with update
+                information.
+
+        Returns:
+            dict[str, list[dict[str, Any]]]: Filtered entity changes by
+                project id.
+        """
 
-    def filter_entities_info(self, event):
         # Filter if event contain relevant data
         entities_info = event["data"].get("entities")
         if not entities_info:
             return
 
-        entities_info_by_project_id = {}
+        entities_info_by_project_id = collections.defaultdict(list)
         for entity_info in entities_info:
-            # Care only about tasks
-            if entity_info.get("entityType") != "task":
+            # Ignore removed entities
+            if entity_info.get("action") == "remove":
                 continue
 
-            # Care only about changes of status
+            # Care only about information with changes of entities
             changes = entity_info.get("changes")
             if not changes:
                 continue
@@ -69,367 +86,287 @@ class PushFrameValuesToTaskEvent(BaseEvent):
             if project_id is None:
                 continue
 
-            # Skip `Task` entity type if parent didn't change
-            if entity_info["entity_type"].lower() == "task":
-                if (
-                    "parent_id" not in changes
-                    or changes["parent_id"]["new"] is None
-                ):
-                    continue
-
-            if project_id not in entities_info_by_project_id:
-                entities_info_by_project_id[project_id] = []
             entities_info_by_project_id[project_id].append(entity_info)
 
         return entities_info_by_project_id
 
-    def process_by_project(self, session, event, project_id, entities_info):
-        project_name = self.get_project_name_from_event(
+    def _get_attrs_configurations(self, session, interest_attributes):
+        """Get custom attribute configurations by name.
+
+        Args:
+            session (ftrack_api.Session): Ftrack sesson.
+            interest_attributes (list[str]): Names of custom attributes
+                that should be synchronized.
+
+        Returns:
+            tuple[dict[str, list], list]: Attributes by object id and
+                hierarchical attributes.
+        """
+
+        attrs = session.query(self.cust_attrs_query.format(
+            self.join_query_keys(interest_attributes)
+        )).all()
+
+        attrs_by_obj_id = collections.defaultdict(list)
+        hier_attrs = []
+        for attr in attrs:
+            if attr["is_hierarchical"]:
+                hier_attrs.append(attr)
+                continue
+            obj_id = attr["object_type_id"]
+            attrs_by_obj_id[obj_id].append(attr)
+        return attrs_by_obj_id, hier_attrs
+
+    def _get_handler_project_settings(
+        self,
+        session: ftrack_api.Session,
+        event: ftrack_api.event.base.Event,
+        project_id: str
+    ) -> tuple[set[str], set[str]]:
+        """Get handler settings based on the project.
+
+        Args:
+            session (ftrack_api.Session): Ftrack session.
+            event (ftrack_api.event.base.Event): Ftrack event which triggered
+                the changes.
+            project_id (str): Project id where the current changes are handled.
+
+        Returns:
+            tuple[set[str], set[str]]: Attribute names we care about and
+                entity types we care about.
+        """
+
+        project_name: str = self.get_project_name_from_event(
             session, event, project_id
         )
         # Load settings
-        project_settings = self.get_project_settings_from_event(
-            event, project_name
+        project_settings: dict[str, Any] = (
+            self.get_project_settings_from_event(event, project_name)
         )
         # Load status mapping from presets
-        event_settings = (
+        event_settings: dict[str, Any] = (
             project_settings
             ["ftrack"]
             ["events"]
-            ["sync_hier_entity_attributes"]
+            [self.settings_key]
         )
         # Skip if event is not enabled
         if not event_settings["enabled"]:
             self.log.debug("Project \"{}\" has disabled {}".format(
                 project_name, self.__class__.__name__
             ))
-            return
+            return set(), set()
 
-        interest_attributes = event_settings["interest_attributes"]
+        interest_attributes: list[str] = event_settings["interest_attributes"]
         if not interest_attributes:
             self.log.info((
                 "Project \"{}\" does not have filled 'interest_attributes',"
                 " skipping."
             ))
-            return
-        interest_entity_types = event_settings["interest_entity_types"]
+
+        interest_entity_types: list[str] = (
+            event_settings["interest_entity_types"])
         if not interest_entity_types:
             self.log.info((
                 "Project \"{}\" does not have filled 'interest_entity_types',"
                 " skipping."
             ))
-            return
 
-        interest_attributes = set(interest_attributes)
-        interest_entity_types = set(interest_entity_types)
+        # Unify possible issues from settings ('Asset Build' -> 'assetbuild')
+        interest_entity_types: set[str] = {
+            entity_type.replace(" ", "").lower()
+            for entity_type in interest_entity_types
+        }
+        return set(interest_attributes), interest_entity_types
 
-        # Separate value changes and task parent changes
-        _entities_info = []
-        added_entities = []
-        added_entity_ids = set()
-        task_parent_changes = []
+    def _entities_filter_by_settings(
+        self,
+        entities_info: list[dict[str, Any]],
+        interest_attributes: set[str],
+        interest_entity_types: set[str]
+    ):
+        new_entities_info = []
         for entity_info in entities_info:
-            if entity_info["entity_type"].lower() == "task":
-                task_parent_changes.append(entity_info)
-            elif entity_info.get("action") == "add":
-                added_entities.append(entity_info)
-                added_entity_ids.add(entity_info["entityId"])
-            else:
-                _entities_info.append(entity_info)
-        entities_info = _entities_info
+            entity_type_low = entity_info["entity_type"].lower()
 
-        # Filter entities info with changes
-        interesting_data, changed_keys_by_object_id = self.filter_changes(
-            session, event, entities_info, interest_attributes
-        )
-        self.interesting_data_for_added(
-            session,
-            added_entities,
-            interest_attributes,
-            interesting_data,
-            changed_keys_by_object_id
-        )
-        if not interesting_data and not task_parent_changes:
-            return
+            changes = entity_info["changes"]
+            # SPECIAL CASE: Capture changes of task created/moved under
+            #   interested entity type
+            if (
+                entity_type_low == "task"
+                and "parent_id" in changes
+            ):
+                # Direct parent is always second item in 'parents' and 'Task'
+                #   must have at least one parent
+                parent_info = entity_info["parents"][1]
+                parent_entity_type = (
+                    parent_info["entity_type"]
+                    .replace(" ", "")
+                    .lower()
+                )
+                if parent_entity_type in interest_entity_types:
+                    new_entities_info.append(entity_info)
+                    continue
 
-        # Prepare object types
-        object_types = session.query("select id, name from ObjectType").all()
-        object_types_by_name = {}
-        for object_type in object_types:
-            name_low = object_type["name"].lower()
-            object_types_by_name[name_low] = object_type
+            # Skip if entity type is not enabled for attr value sync
+            if entity_type_low not in interest_entity_types:
+                continue
 
-        # NOTE it would be nice to check if `interesting_data` do not contain
-        #   value changs of tasks that were created or moved
-        # - it is a complex way how to find out
-        if interesting_data:
-            self.process_attribute_changes(
-                session,
-                object_types_by_name,
-                interesting_data,
-                changed_keys_by_object_id,
-                interest_entity_types,
-                interest_attributes,
-                added_entity_ids
-            )
+            valid_attr_change = entity_info.get("action") == "add"
+            for attr_key in interest_attributes:
+                if valid_attr_change:
+                    break
 
-        if task_parent_changes:
-            self.process_task_parent_change(
-                session, object_types_by_name, task_parent_changes,
-                interest_entity_types, interest_attributes
-            )
+                if attr_key not in changes:
+                    continue
 
-    def process_task_parent_change(
+                if changes[attr_key]["new"] is not None:
+                    valid_attr_change = True
+
+            if not valid_attr_change:
+                continue
+
+            new_entities_info.append(entity_info)
+
+        return new_entities_info
+
+    def propagate_attribute_changes(
         self,
         session,
-        object_types_by_name,
-        task_parent_changes,
-        interest_entity_types,
-        interest_attributes
+        interest_attributes,
+        entities_info,
+        attrs_by_obj_id,
+        hier_attrs,
+        real_values_by_entity_id,
+        hier_values_by_entity_id,
     ):
-        """Push custom attribute values if task parent has changed.
+        hier_attr_ids_by_key = {
+            attr["key"]: attr["id"]
+            for attr in hier_attrs
+        }
+        filtered_interest_attributes = {
+            attr_name
+            for attr_name in interest_attributes
+            if attr_name in hier_attr_ids_by_key
+        }
+        attrs_keys_by_obj_id = {}
+        for obj_id, attrs in attrs_by_obj_id.items():
+            attrs_keys_by_obj_id[obj_id] = {
+                attr["key"]: attr["id"]
+                for attr in attrs
+            }
 
-        Parent is changed if task is created or if is moved under different
-        entity. We don't care about all task changes only about those that
-        have it's parent in interest types (from settings).
+        op_changes = []
+        for entity_info in entities_info:
+            entity_id = entity_info["entityId"]
+            obj_id = entity_info["objectTypeId"]
+            # Skip attributes sync if does not have object specific custom
+            #   attribute
+            if obj_id not in attrs_keys_by_obj_id:
+                continue
+            attr_keys = attrs_keys_by_obj_id[obj_id]
+            real_values = real_values_by_entity_id[entity_id]
+            hier_values = hier_values_by_entity_id[entity_id]
 
-        Tasks hierarchical value should be unset or set based on parents
-        real hierarchical value and non hierarchical custom attribute value
-        should be set to hierarchical value.
-        """
-
-        # Store task ids which were created or moved under parent with entity
-        #   type defined in settings (interest_entity_types).
-        task_ids = set()
-        # Store parent ids of matching task ids
-        matching_parent_ids = set()
-        # Store all entity ids of all entities to be able query hierarchical
-        #   values.
-        whole_hierarchy_ids = set()
-        # Store parent id of each entity id
-        parent_id_by_entity_id = {}
-        for entity_info in task_parent_changes:
-            # Ignore entities with less parents than 2
-            # NOTE entity itself is also part of "parents" value
-            parents = entity_info.get("parents") or []
-            if len(parents) < 2:
+            changes = copy.deepcopy(entity_info["changes"])
+            obj_id_attr_keys = {
+                attr_key
+                for attr_key in filtered_interest_attributes
+                if attr_key in attr_keys
+            }
+            if not obj_id_attr_keys:
                 continue
 
-            parent_info = parents[1]
-            # Check if parent has entity type we care about.
-            if parent_info["entity_type"] not in interest_entity_types:
-                continue
+            value_by_key = {}
+            is_new_entity = entity_info.get("action") == "add"
+            for attr_key in obj_id_attr_keys:
+                if (
+                    attr_key in changes
+                    and changes[attr_key]["new"] is not None
+                ):
+                    value_by_key[attr_key] = changes[attr_key]["new"]
 
-            task_ids.add(entity_info["entityId"])
-            matching_parent_ids.add(parent_info["entityId"])
-
-            # Store whole hierarchi of task entity
-            prev_id = None
-            for item in parents:
-                item_id = item["entityId"]
-                whole_hierarchy_ids.add(item_id)
-
-                if prev_id is None:
-                    prev_id = item_id
+                if not is_new_entity:
                     continue
 
-                parent_id_by_entity_id[prev_id] = item_id
-                if item["entityType"] == "show":
-                    break
-                prev_id = item_id
+                hier_attr_id = hier_attr_ids_by_key[attr_key]
+                attr_id = attr_keys[attr_key]
+                if hier_attr_id in real_values or attr_id in real_values:
+                    continue
 
-        # Just skip if nothing is interesting for our settings
-        if not matching_parent_ids:
-            return
+                value_by_key[attr_key] = hier_values[hier_attr_id]
 
-        # Query object type ids of parent ids for custom attribute
-        #   definitions query
-        entities = session.query(
-            "select object_type_id from TypedContext where id in ({})".format(
-                self.join_query_keys(matching_parent_ids)
-            )
-        )
+            for key, new_value in value_by_key.items():
+                if new_value is None:
+                    continue
 
-        # Prepare task object id
-        task_object_id = object_types_by_name["task"]["id"]
+                hier_id = hier_attr_ids_by_key[key]
+                std_id = attr_keys[key]
+                real_hier_value = real_values.get(hier_id)
+                real_std_value = real_values.get(std_id)
+                hier_value = hier_values[hier_id]
+                # Get right type of value for conversion
+                #   - values in event are strings
+                type_value = real_hier_value
+                if type_value is None:
+                    type_value = real_std_value
+                    if type_value is None:
+                        type_value = hier_value
+                        # Skip if current values are not set
+                        if type_value is None:
+                            continue
 
-        # All object ids for which we're querying custom attribute definitions
-        object_type_ids = set()
-        object_type_ids.add(task_object_id)
-        for entity in entities:
-            object_type_ids.add(entity["object_type_id"])
+                try:
+                    new_value = type(type_value)(new_value)
+                except Exception:
+                    self.log.warning((
+                        "Couldn't convert from {} to {}."
+                        " Skipping update values."
+                    ).format(type(new_value), type(type_value)))
+                    continue
 
-        attrs_by_obj_id, hier_attrs = self.attrs_configurations(
-            session, object_type_ids, interest_attributes
-        )
+                real_std_value_is_same = new_value == real_std_value
+                real_hier_value_is_same = new_value == real_hier_value
+                # New value does not match anything in current entity values
+                if (
+                    not is_new_entity
+                    and not real_std_value_is_same
+                    and not real_hier_value_is_same
+                ):
+                    continue
 
-        # Skip if all task attributes are not available
-        task_attrs = attrs_by_obj_id.get(task_object_id)
-        if not task_attrs:
-            return
+                if not real_std_value_is_same:
+                    op_changes.append((
+                        std_id,
+                        entity_id,
+                        new_value,
+                        real_values.get(std_id),
+                        std_id in real_values
+                    ))
 
-        # Skip attributes that is not in both hierarchical and nonhierarchical
-        # TODO be able to push values if hierarchical is available
-        for key in interest_attributes:
-            if key not in hier_attrs:
-                task_attrs.pop(key, None)
+                if not real_hier_value_is_same:
+                    op_changes.append((
+                        hier_id,
+                        entity_id,
+                        new_value,
+                        real_values.get(hier_id),
+                        hier_id in real_values
+                    ))
 
-            elif key not in task_attrs:
-                hier_attrs.pop(key)
+        for change in op_changes:
+            (
+                attr_id,
+                entity_id,
+                new_value,
+                old_value,
+                do_update
+            ) = change
 
-        # Skip if nothing remained
-        if not task_attrs:
-            return
-
-        # Do some preparations for custom attribute values query
-        attr_key_by_id = {}
-        nonhier_id_by_key = {}
-        hier_attr_ids = []
-        for key, attr_id in hier_attrs.items():
-            attr_key_by_id[attr_id] = key
-            hier_attr_ids.append(attr_id)
-
-        conf_ids = list(hier_attr_ids)
-        task_conf_ids = []
-        for key, attr_id in task_attrs.items():
-            attr_key_by_id[attr_id] = key
-            nonhier_id_by_key[key] = attr_id
-            conf_ids.append(attr_id)
-            task_conf_ids.append(attr_id)
-
-        # Query custom attribute values
-        # - result does not contain values for all entities only result of
-        #   query callback to ftrack server
-        result = query_custom_attributes(
-            session, list(hier_attr_ids), whole_hierarchy_ids, True
-        )
-        result.extend(
-            query_custom_attributes(
-                session, task_conf_ids, whole_hierarchy_ids, False
-            )
-        )
-
-        # Prepare variables where result will be stored
-        # - hierachical values should not contain attribute with value by
-        #   default
-        hier_values_by_entity_id = {
-            entity_id: {}
-            for entity_id in whole_hierarchy_ids
-        }
-        # - real values of custom attributes
-        values_by_entity_id = {
-            entity_id: {
-                attr_id: None
-                for attr_id in conf_ids
-            }
-            for entity_id in whole_hierarchy_ids
-        }
-        for item in result:
-            attr_id = item["configuration_id"]
-            entity_id = item["entity_id"]
-            value = item["value"]
-
-            values_by_entity_id[entity_id][attr_id] = value
-
-            if attr_id in hier_attr_ids and value is not None:
-                hier_values_by_entity_id[entity_id][attr_id] = value
-
-        # Prepare values for all task entities
-        # - going through all parents and storing first value value
-        # - store None to those that are already known that do not have set
-        #   value at all
-        for task_id in tuple(task_ids):
-            for attr_id in hier_attr_ids:
-                entity_ids = []
-                value = None
-                entity_id = task_id
-                while value is None:
-                    entity_value = hier_values_by_entity_id[entity_id]
-                    if attr_id in entity_value:
-                        value = entity_value[attr_id]
-                        if value is None:
-                            break
-
-                    if value is None:
-                        entity_ids.append(entity_id)
-
-                    entity_id = parent_id_by_entity_id.get(entity_id)
-                    if entity_id is None:
-                        break
-
-                for entity_id in entity_ids:
-                    hier_values_by_entity_id[entity_id][attr_id] = value
-
-        # Prepare changes to commit
-        changes = []
-        for task_id in tuple(task_ids):
-            parent_id = parent_id_by_entity_id[task_id]
-            for attr_id in hier_attr_ids:
-                attr_key = attr_key_by_id[attr_id]
-                nonhier_id = nonhier_id_by_key[attr_key]
-
-                # Real value of hierarchical attribute on parent
-                # - If is none then should be unset
-                real_parent_value = values_by_entity_id[parent_id][attr_id]
-                # Current hierarchical value of a task
-                # - Will be compared to real parent value
-                hier_value = hier_values_by_entity_id[task_id][attr_id]
-
-                # Parent value that can be inherited from it's parent entity
-                parent_value = hier_values_by_entity_id[parent_id][attr_id]
-                # Task value of nonhierarchical custom attribute
-                nonhier_value = values_by_entity_id[task_id][nonhier_id]
-
-                if real_parent_value != hier_value:
-                    changes.append({
-                        "new_value": real_parent_value,
-                        "attr_id": attr_id,
-                        "entity_id": task_id,
-                        "attr_key": attr_key
-                    })
-
-                if parent_value != nonhier_value:
-                    changes.append({
-                        "new_value": parent_value,
-                        "attr_id": nonhier_id,
-                        "entity_id": task_id,
-                        "attr_key": attr_key
-                    })
-
-        self._commit_changes(session, changes)
-
-    def _commit_changes(self, session, changes):
-        uncommited_changes = False
-        for idx, item in enumerate(changes):
-            new_value = item["new_value"]
-            old_value = item["old_value"]
-            attr_id = item["attr_id"]
-            entity_id = item["entity_id"]
-            attr_key = item["attr_key"]
-
-            entity_key = collections.OrderedDict((
+            entity_key = collections.OrderedDict([
                 ("configuration_id", attr_id),
                 ("entity_id", entity_id)
-            ))
-            self._cached_changes.append({
-                "attr_key": attr_key,
-                "entity_id": entity_id,
-                "value": new_value,
-                "time": datetime.datetime.now()
-            })
-            old_value_is_set = (
-                old_value is not ftrack_api.symbol.NOT_SET
-                and old_value is not None
-            )
-            if new_value is None:
-                if not old_value_is_set:
-                    continue
-                op = ftrack_api.operation.DeleteEntityOperation(
-                    "CustomAttributeValue",
-                    entity_key
-                )
-
-            elif old_value_is_set:
+            ])
+            if do_update:
                 op = ftrack_api.operation.UpdateEntityOperation(
                     "CustomAttributeValue",
                     entity_key,
@@ -446,449 +383,116 @@ class PushFrameValuesToTaskEvent(BaseEvent):
                 )
 
             session.recorded_operations.push(op)
-            self.log.info((
-                "Changing Custom Attribute \"{}\" to value"
-                " \"{}\" on entity: {}"
-            ).format(attr_key, new_value, entity_id))
-
-            if (idx + 1) % 20 == 0:
-                uncommited_changes = False
-                try:
-                    session.commit()
-                except Exception:
-                    session.rollback()
-                    self.log.warning(
-                        "Changing of values failed.", exc_info=True
-                    )
-            else:
-                uncommited_changes = True
-        if uncommited_changes:
-            try:
+            if len(session.recorded_operations) > 100:
                 session.commit()
-            except Exception:
-                session.rollback()
-                self.log.warning("Changing of values failed.", exc_info=True)
+        session.commit()
 
-    def process_attribute_changes(
+    def process_by_project(
         self,
-        session,
-        object_types_by_name,
-        interesting_data,
-        changed_keys_by_object_id,
-        interest_entity_types,
-        interest_attributes,
-        added_entity_ids
+        session: ftrack_api.Session,
+        event: ftrack_api.event.base.Event,
+        project_id: str,
+        entities_info: list[dict[str, Any]]
     ):
-        # Prepare task object id
-        task_object_id = object_types_by_name["task"]["id"]
+        """Proces changes in single project.
 
-        # Collect object type ids based on settings
-        interest_object_ids = []
-        for entity_type in interest_entity_types:
-            _entity_type = entity_type.lower()
-            object_type = object_types_by_name.get(_entity_type)
-            if not object_type:
-                self.log.warning("Couldn't find object type \"{}\"".format(
-                    entity_type
-                ))
+        Args:
+            session (ftrack_api.Session): Ftrack session.
+            event (ftrack_api.event.base.Event): Event which has all changes
+                information.
+            project_id (str): Project id related to changes.
+            entities_info (list[dict[str, Any]]): Changes of entities.
+        """
 
-            interest_object_ids.append(object_type["id"])
-
-        # Query entities by filtered data and object ids
-        entities = self.get_entities(
-            session, interesting_data, interest_object_ids
-        )
-        if not entities:
+        (
+            interest_attributes,
+            interest_entity_types
+        ) = self._get_handler_project_settings(session, event, project_id)
+        if not interest_attributes or not interest_entity_types:
             return
 
-        # Pop not found entities from interesting data
-        entity_ids = set(
-            entity["id"]
-            for entity in entities
+        entities_info: list[dict[str, Any]] = (
+            self._entities_filter_by_settings(
+                entities_info,
+                interest_attributes,
+                interest_entity_types
+            )
         )
-        for entity_id in tuple(interesting_data.keys()):
-            if entity_id not in entity_ids:
-                interesting_data.pop(entity_id)
-
-        # Add task object type to list
-        attr_obj_ids = list(interest_object_ids)
-        attr_obj_ids.append(task_object_id)
-
-        attrs_by_obj_id, hier_attrs = self.attrs_configurations(
-            session, attr_obj_ids, interest_attributes
-        )
-
-        task_attrs = attrs_by_obj_id.get(task_object_id)
-
-        changed_keys = set()
-        # Skip keys that are not both in hierachical and type specific
-        for object_id, keys in changed_keys_by_object_id.items():
-            changed_keys |= set(keys)
-            object_id_attrs = attrs_by_obj_id.get(object_id)
-            for key in keys:
-                if key not in hier_attrs:
-                    attrs_by_obj_id[object_id].pop(key)
-                    continue
-
-                if (
-                    (not object_id_attrs or key not in object_id_attrs)
-                    and (not task_attrs or key not in task_attrs)
-                ):
-                    hier_attrs.pop(key)
-
-        # Clean up empty values
-        for key, value in tuple(attrs_by_obj_id.items()):
-            if not value:
-                attrs_by_obj_id.pop(key)
-
-        if not attrs_by_obj_id:
-            self.log.warning((
-                "There is not created Custom Attributes {} "
-                " for entity types: {}"
-            ).format(
-                self.join_query_keys(interest_attributes),
-                self.join_query_keys(interest_entity_types)
-            ))
+        if not entities_info:
             return
 
-        # Prepare task entities
-        task_entities = []
-        # If task entity does not contain changed attribute then skip
-        if task_attrs:
-            task_entities = self.get_task_entities(session, interesting_data)
-
-        task_entity_ids = set()
-        parent_id_by_task_id = {}
-        for task_entity in task_entities:
-            task_id = task_entity["id"]
-            task_entity_ids.add(task_id)
-            parent_id_by_task_id[task_id] = task_entity["parent_id"]
-
-        self.finalize_attribute_changes(
-            session,
-            interesting_data,
-            changed_keys,
-            attrs_by_obj_id,
-            hier_attrs,
-            task_entity_ids,
-            parent_id_by_task_id,
-            added_entity_ids
-        )
-
-    def finalize_attribute_changes(
-        self,
-        session,
-        interesting_data,
-        changed_keys,
-        attrs_by_obj_id,
-        hier_attrs,
-        task_entity_ids,
-        parent_id_by_task_id,
-        added_entity_ids
-    ):
-        attr_id_to_key = {}
-        for attr_confs in attrs_by_obj_id.values():
-            for key in changed_keys:
-                custom_attr_id = attr_confs.get(key)
-                if custom_attr_id:
-                    attr_id_to_key[custom_attr_id] = key
-
-        for key in changed_keys:
-            custom_attr_id = hier_attrs.get(key)
-            if custom_attr_id:
-                attr_id_to_key[custom_attr_id] = key
-
-        entity_ids = (
-            set(interesting_data.keys()) | task_entity_ids
-        )
-        attr_ids = set(attr_id_to_key.keys())
-
-        current_values_by_id = self.get_current_values(
-            session,
-            attr_ids,
-            entity_ids,
-            task_entity_ids,
-            hier_attrs
-        )
-
-        changes = []
-        for entity_id, current_values in current_values_by_id.items():
-            parent_id = parent_id_by_task_id.get(entity_id)
-            if not parent_id:
-                parent_id = entity_id
-            values = interesting_data[parent_id]
-
-            added_entity = entity_id in added_entity_ids
-            for attr_id, old_value in current_values.items():
-                if added_entity and attr_id in hier_attrs:
-                    continue
-
-                attr_key = attr_id_to_key.get(attr_id)
-                if not attr_key:
-                    continue
-
-                # Convert new value from string
-                new_value = values.get(attr_key)
-                new_value_is_valid = (
-                    old_value is not ftrack_api.symbol.NOT_SET
-                    and new_value is not None
-                )
-                if added_entity and not new_value_is_valid:
-                    continue
-
-                if new_value is not None and new_value_is_valid:
-                    try:
-                        new_value = type(old_value)(new_value)
-                    except Exception:
-                        self.log.warning((
-                            "Couldn't convert from {} to {}."
-                            " Skipping update values."
-                        ).format(type(new_value), type(old_value)))
-                if new_value == old_value:
-                    continue
-
-                changes.append({
-                    "new_value": new_value,
-                    "attr_id": attr_id,
-                    "old_value": old_value,
-                    "entity_id": entity_id,
-                    "attr_key": attr_key
-                })
-        self._commit_changes(session, changes)
-
-    def filter_changes(
-        self, session, event, entities_info, interest_attributes
-    ):
-        session_user_id = self.session_user_id(session)
-        user_data = event["data"].get("user")
-        changed_by_session = False
-        if user_data and user_data.get("userid") == session_user_id:
-            changed_by_session = True
-
-        current_time = datetime.datetime.now()
-
-        interesting_data = {}
-        changed_keys_by_object_id = {}
-
-        for entity_info in entities_info:
-            # Care only about changes if specific keys
-            entity_changes = {}
-            changes = entity_info["changes"]
-            for key in interest_attributes:
-                if key in changes:
-                    entity_changes[key] = changes[key]["new"]
-
-            entity_id = entity_info["entityId"]
-            if changed_by_session:
-                for key, new_value in tuple(entity_changes.items()):
-                    for cached in tuple(self._cached_changes):
-                        if (
-                            cached["entity_id"] != entity_id
-                            or cached["attr_key"] != key
-                        ):
-                            continue
-
-                        cached_value = cached["value"]
-                        try:
-                            new_value = type(cached_value)(new_value)
-                        except Exception:
-                            pass
-
-                        if cached_value == new_value:
-                            self._cached_changes.remove(cached)
-                            entity_changes.pop(key)
-                            break
-
-                        delta = (current_time - cached["time"]).seconds
-                        if delta > self._max_delta:
-                            self._cached_changes.remove(cached)
-
-            if not entity_changes:
-                continue
-
-            entity_id = entity_info["entityId"]
-            object_id = entity_info["objectTypeId"]
-            interesting_data[entity_id] = entity_changes
-            if object_id not in changed_keys_by_object_id:
-                changed_keys_by_object_id[object_id] = set()
-            changed_keys_by_object_id[object_id] |= set(entity_changes.keys())
-
-        return interesting_data, changed_keys_by_object_id
-
-    def interesting_data_for_added(
-        self,
-        session,
-        added_entities,
-        interest_attributes,
-        interesting_data,
-        changed_keys_by_object_id
-    ):
-        if not added_entities or not interest_attributes:
-            return
-
-        object_type_ids = set()
-        entity_ids = set()
-        all_entity_ids = set()
-        object_id_by_entity_id = {}
-        project_id = None
-        entity_ids_by_parent_id = collections.defaultdict(set)
-        for entity_info in added_entities:
-            object_id = entity_info["objectTypeId"]
-            entity_id = entity_info["entityId"]
-            object_type_ids.add(object_id)
-            entity_ids.add(entity_id)
-            object_id_by_entity_id[entity_id] = object_id
-
-            for item in entity_info["parents"]:
-                entity_id = item["entityId"]
-                all_entity_ids.add(entity_id)
-                parent_id = item["parentId"]
-                if not parent_id:
-                    project_id = entity_id
-                else:
-                    entity_ids_by_parent_id[parent_id].add(entity_id)
-
-        hier_attrs = self.get_hierarchical_configurations(
+        attrs_by_obj_id, hier_attrs = self._get_attrs_configurations(
             session, interest_attributes
         )
-        if not hier_attrs:
+        # Skip if attributes are not available
+        #   - there is nothing to sync
+        if not attrs_by_obj_id or not hier_attrs:
             return
 
-        hier_attrs_key_by_id = {
-            attr_conf["id"]: attr_conf["key"]
-            for attr_conf in hier_attrs
-        }
-        default_values_by_key = {
-            attr_conf["key"]: attr_conf["default"]
-            for attr_conf in hier_attrs
-        }
+        entity_ids_by_parent_id = collections.defaultdict(set)
+        all_entity_ids = set()
+        for entity_info in entities_info:
+            entity_id = None
+            for item in entity_info["parents"]:
+                item_id = item["entityId"]
+                all_entity_ids.add(item_id)
+                if entity_id is not None:
+                    entity_ids_by_parent_id[item_id].add(entity_id)
+                entity_id = item_id
 
-        values = query_custom_attributes(
-            session, list(hier_attrs_key_by_id.keys()), all_entity_ids, True
+        attr_ids = {attr["id"] for attr in hier_attrs}
+        for attrs in attrs_by_obj_id.values():
+            attr_ids |= {attr["id"] for attr in attrs}
+
+        # Query real custom attribute values
+        #   - we have to know what are the real values, if are set and to what
+        #       value
+        value_items = query_custom_attributes(
+            session, attr_ids, all_entity_ids, True
         )
-        values_per_entity_id = {}
-        for entity_id in all_entity_ids:
-            values_per_entity_id[entity_id] = {}
-            for attr_name in interest_attributes:
-                values_per_entity_id[entity_id][attr_name] = None
-
-        for item in values:
-            entity_id = item["entity_id"]
-            key = hier_attrs_key_by_id[item["configuration_id"]]
-            values_per_entity_id[entity_id][key] = item["value"]
-
-        fill_queue = collections.deque()
-        fill_queue.append((project_id, default_values_by_key))
-        while fill_queue:
-            item = fill_queue.popleft()
-            entity_id, values_by_key = item
-            entity_values = values_per_entity_id[entity_id]
-            new_values_by_key = copy.deepcopy(values_by_key)
-            for key, value in values_by_key.items():
-                current_value = entity_values[key]
-                if current_value is None:
-                    entity_values[key] = value
-                else:
-                    new_values_by_key[key] = current_value
-
-            for child_id in entity_ids_by_parent_id[entity_id]:
-                fill_queue.append((child_id, new_values_by_key))
-
-        for entity_id in entity_ids:
-            entity_changes = {}
-            for key, value in values_per_entity_id[entity_id].items():
-                if value is not None:
-                    entity_changes[key] = value
-
-            if not entity_changes:
-                continue
-
-            interesting_data[entity_id] = entity_changes
-            object_id = object_id_by_entity_id[entity_id]
-            if object_id not in changed_keys_by_object_id:
-                changed_keys_by_object_id[object_id] = set()
-            changed_keys_by_object_id[object_id] |= set(entity_changes.keys())
-
-    def get_current_values(
-        self,
-        session,
-        attr_ids,
-        entity_ids,
-        task_entity_ids,
-        hier_attrs
-    ):
-        current_values_by_id = {}
-        if not attr_ids or not entity_ids:
-            return current_values_by_id
-
-        for entity_id in entity_ids:
-            current_values_by_id[entity_id] = {}
-            for attr_id in attr_ids:
-                current_values_by_id[entity_id][attr_id] = (
-                    ftrack_api.symbol.NOT_SET
-                )
-
-        values = query_custom_attributes(
-            session, attr_ids, entity_ids, True
-        )
-
-        for item in values:
+        real_values_by_entity_id = collections.defaultdict(dict)
+        for item in value_items:
             entity_id = item["entity_id"]
             attr_id = item["configuration_id"]
-            if entity_id in task_entity_ids and attr_id in hier_attrs:
-                continue
+            real_values_by_entity_id[entity_id][attr_id] = item["value"]
 
-            if entity_id not in current_values_by_id:
-                current_values_by_id[entity_id] = {}
-            current_values_by_id[entity_id][attr_id] = item["value"]
-        return current_values_by_id
+        hier_values_by_entity_id = {}
+        default_values = {
+            attr["id"]: attr["default"]
+            for attr in hier_attrs
+        }
+        hier_queue = collections.deque()
+        hier_queue.append((default_values, [project_id]))
+        while hier_queue:
+            parent_values, entity_ids = hier_queue.popleft()
+            for entity_id in entity_ids:
+                entity_values = copy.deepcopy(parent_values)
+                real_values = real_values_by_entity_id[entity_id]
+                for attr_id, value in real_values.items():
+                    entity_values[attr_id] = value
+                hier_values_by_entity_id[entity_id] = entity_values
+                hier_queue.append(
+                    (entity_values, entity_ids_by_parent_id[entity_id])
+                )
 
-    def get_entities(self, session, interesting_data, interest_object_ids):
-        return session.query((
-            "select id from TypedContext"
-            " where id in ({}) and object_type_id in ({})"
-        ).format(
-            self.join_query_keys(interesting_data.keys()),
-            self.join_query_keys(interest_object_ids)
-        )).all()
-
-    def get_task_entities(self, session, interesting_data):
-        return session.query(
-            "select id, parent_id from Task where parent_id in ({})".format(
-                self.join_query_keys(interesting_data.keys())
-            )
-        ).all()
-
-    def attrs_configurations(self, session, object_ids, interest_attributes):
-        attrs = session.query(self.cust_attrs_query.format(
-            self.join_query_keys(interest_attributes),
-            self.join_query_keys(object_ids)
-        )).all()
-
-        output = {}
-        hiearchical = {}
-        for attr in attrs:
-            if attr["is_hierarchical"]:
-                hiearchical[attr["key"]] = attr["id"]
-                continue
-            obj_id = attr["object_type_id"]
-            if obj_id not in output:
-                output[obj_id] = {}
-            output[obj_id][attr["key"]] = attr["id"]
-        return output, hiearchical
-
-    def get_hierarchical_configurations(self, session, interest_attributes):
-        hier_attr_query = (
-            "select id, key, object_type_id, is_hierarchical, default"
-            " from CustomAttributeConfiguration"
-            " where key in ({}) and is_hierarchical is true"
+        self.propagate_attribute_changes(
+            session,
+            interest_attributes,
+            entities_info,
+            attrs_by_obj_id,
+            hier_attrs,
+            real_values_by_entity_id,
+            hier_values_by_entity_id,
         )
-        if not interest_attributes:
-            return []
-        return list(session.query(hier_attr_query.format(
-            self.join_query_keys(interest_attributes),
-        )).all())
+
+    def launch(self, session, event):
+        filtered_entities_info = self.filter_entities_info(event)
+        if not filtered_entities_info:
+            return
+
+        for project_id, entities_info in filtered_entities_info.items():
+            self.process_by_project(session, event, project_id, entities_info)
 
 
 def register(session):
-    PushFrameValuesToTaskEvent(session).register()
+    PushHierValuesToNonHierEvent(session).register()

From 0cc5f3ee37e08aa5516d0ca11bebf1c7fea6fd0e Mon Sep 17 00:00:00 2001
From: Sharkitty <hayleylalicorne@gmail.com>
Date: Fri, 24 Mar 2023 15:44:29 +0100
Subject: [PATCH 135/151] Changed logic as suggested

---
 .../modules/kitsu/plugins/publish/integrate_kitsu_note.py   | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
index 6a1b09dde1..571ed683bb 100644
--- a/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
+++ b/openpype/modules/kitsu/plugins/publish/integrate_kitsu_note.py
@@ -82,8 +82,6 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
                     if instance.data.get("publish")
                 }
 
-                allow_status_change = False
-
                 # Check if any family requirement is met
                 for family_requirement in self.status_change_conditions[
                     "family_requirements"
@@ -92,8 +90,8 @@ class IntegrateKitsuNote(pyblish.api.ContextPlugin):
 
                     for family in families:
                         match = family_requirement["family"].lower() == family
-                        if match and condition or not condition and not match:
-                            allow_status_change = True
+                        if match and not condition or condition and not match:
+                            allow_status_change = False
                             break
 
                     if allow_status_change:

From aceaef0b213833214472643f580a01121778f143 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Fri, 24 Mar 2023 16:24:33 +0100
Subject: [PATCH 136/151] hiero: correct container colors if UpToDate

---
 openpype/hosts/hiero/api/lib.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/hiero/api/lib.py b/openpype/hosts/hiero/api/lib.py
index bbd1edc14a..0d4368529f 100644
--- a/openpype/hosts/hiero/api/lib.py
+++ b/openpype/hosts/hiero/api/lib.py
@@ -1221,7 +1221,7 @@ def set_track_color(track_item, color):
 
 def check_inventory_versions(track_items=None):
     """
-    Actual version color idetifier of Loaded containers
+    Actual version color identifier of Loaded containers
 
     Check all track items and filter only
     Loader nodes for its version. It will get all versions from database
@@ -1249,10 +1249,10 @@ def check_inventory_versions(track_items=None):
     project_name = legacy_io.active_project()
     filter_result = filter_containers(containers, project_name)
     for container in filter_result.latest:
-        set_track_color(container["_item"], clip_color)
+        set_track_color(container["_item"], clip_color_last)
 
     for container in filter_result.outdated:
-        set_track_color(container["_item"], clip_color_last)
+        set_track_color(container["_item"], clip_color)
 
 
 def selection_changed_timeline(event):

From 1531708236cf9f27e459c2b20cd642e5f08905af Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 24 Mar 2023 16:30:46 +0100
Subject: [PATCH 137/151] Global: persistent staging directory for renders
 (#4583)

* OP-4258 - Settings for transient template

* OP-4258 - added collector for transient staging dir

Allows setting profiles to create persistent stagingDir.

* OP-4258 - implemented persistent stagingDir in cleanup

* OP-4258 - updated logging

* OP-4258 - updated settings

* OP-4258 - Hound

* OP-4258 - renamed class to better name

* OP-4258 - changed location of Settings

Should be used in create and collecting phase also.

* OP-4258 - remove version placeholder from transient template

It was discussed that it shouldn't be used for now.

* OP-4258 - extracted transient dir query logic

This should be used in collection and creation phase for DCCs which are storing staging dir path directly into nodes.

* OP-4258 - added use of scene_name placeholder in collector

DCC dependent, way how to implement versioning, might not be used.

* OP-4258 - fix scene_name

* OP-4258 - remove wrong defaults

* OP-4258 - added possibility of different template name

Studio might want to put renders to different place from caches.

* OP-4258 - renamed according to GH comments

* OP-4258 - use is active filter

* OP-4258 - use is active filter

* OP-4793 - added project_settings to signature

* OP-4793 - updated logging message

* OP-4793 - added documentation

* OP-4258 - fix function arguments

* OP-4258 - updates to documentation


* OP-4258 - added known issues to documentation

---------

Co-authored-by: Roy Nieterau <roy_nieterau@hotmail.com>
---
 openpype/pipeline/publish/contants.py         |   1 +
 openpype/pipeline/publish/lib.py              |  80 +++++++++++++++++-
 openpype/plugins/publish/cleanup.py           |   4 +
 openpype/plugins/publish/cleanup_farm.py      |   2 +-
 .../publish/collect_custom_staging_dir.py     |  67 +++++++++++++++
 .../defaults/project_anatomy/templates.json   |   6 +-
 .../defaults/project_settings/global.json     |   3 +-
 .../schemas/schema_global_tools.json          |  65 ++++++++++++++
 .../global_tools_custom_staging_dir.png       | Bin 0 -> 9940 bytes
 .../settings_project_global.md                |  29 ++++++-
 10 files changed, 249 insertions(+), 8 deletions(-)
 create mode 100644 openpype/plugins/publish/collect_custom_staging_dir.py
 create mode 100644 website/docs/project_settings/assets/global_tools_custom_staging_dir.png

diff --git a/openpype/pipeline/publish/contants.py b/openpype/pipeline/publish/contants.py
index 169eca2e5c..c5296afe9a 100644
--- a/openpype/pipeline/publish/contants.py
+++ b/openpype/pipeline/publish/contants.py
@@ -1,2 +1,3 @@
 DEFAULT_PUBLISH_TEMPLATE = "publish"
 DEFAULT_HERO_PUBLISH_TEMPLATE = "hero"
+TRANSIENT_DIR_TEMPLATE = "transient"
diff --git a/openpype/pipeline/publish/lib.py b/openpype/pipeline/publish/lib.py
index 1ec641bac4..81913bcdd5 100644
--- a/openpype/pipeline/publish/lib.py
+++ b/openpype/pipeline/publish/lib.py
@@ -20,13 +20,15 @@ from openpype.settings import (
     get_system_settings,
 )
 from openpype.pipeline import (
-    tempdir
+    tempdir,
+    Anatomy
 )
 from openpype.pipeline.plugin_discover import DiscoverResult
 
 from .contants import (
     DEFAULT_PUBLISH_TEMPLATE,
     DEFAULT_HERO_PUBLISH_TEMPLATE,
+    TRANSIENT_DIR_TEMPLATE
 )
 
 
@@ -690,3 +692,79 @@ def get_publish_repre_path(instance, repre, only_published=False):
     if os.path.exists(src_path):
         return src_path
     return None
+
+
+def get_custom_staging_dir_info(project_name, host_name, family, task_name,
+                                task_type, subset_name,
+                                project_settings=None,
+                                anatomy=None, log=None):
+    """Checks profiles if context should use special custom dir as staging.
+
+    Args:
+        project_name (str)
+        host_name (str)
+        family (str)
+        task_name (str)
+        task_type (str)
+        subset_name (str)
+        project_settings(Dict[str, Any]): Prepared project settings.
+        anatomy (Dict[str, Any])
+        log (Logger) (optional)
+
+    Returns:
+        (tuple)
+    Raises:
+        ValueError - if misconfigured template should be used
+    """
+    settings = project_settings or get_project_settings(project_name)
+    custom_staging_dir_profiles = (settings["global"]
+                                           ["tools"]
+                                           ["publish"]
+                                           ["custom_staging_dir_profiles"])
+    if not custom_staging_dir_profiles:
+        return None, None
+
+    if not log:
+        log = Logger.get_logger("get_custom_staging_dir_info")
+
+    filtering_criteria = {
+        "hosts": host_name,
+        "families": family,
+        "task_names": task_name,
+        "task_types": task_type,
+        "subsets": subset_name
+    }
+    profile = filter_profiles(custom_staging_dir_profiles,
+                              filtering_criteria,
+                              logger=log)
+
+    if not profile or not profile["active"]:
+        return None, None
+
+    if not anatomy:
+        anatomy = Anatomy(project_name)
+
+    template_name = profile["template_name"] or TRANSIENT_DIR_TEMPLATE
+    _validate_transient_template(project_name, template_name, anatomy)
+
+    custom_staging_dir = anatomy.templates[template_name]["folder"]
+    is_persistent = profile["custom_staging_dir_persistent"]
+
+    return custom_staging_dir, is_persistent
+
+
+def _validate_transient_template(project_name, template_name, anatomy):
+    """Check that transient template is correctly configured.
+
+    Raises:
+        ValueError - if misconfigured template
+    """
+    if template_name not in anatomy.templates:
+        raise ValueError(("Anatomy of project \"{}\" does not have set"
+                          " \"{}\" template key!"
+                          ).format(project_name, template_name))
+
+    if "folder" not in anatomy.templates[template_name]:
+        raise ValueError(("There is not set \"folder\" template in \"{}\" anatomy"  # noqa
+                             " for project \"{}\"."
+                         ).format(template_name, project_name))
diff --git a/openpype/plugins/publish/cleanup.py b/openpype/plugins/publish/cleanup.py
index ef312e391f..b90c88890d 100644
--- a/openpype/plugins/publish/cleanup.py
+++ b/openpype/plugins/publish/cleanup.py
@@ -93,6 +93,10 @@ class CleanUp(pyblish.api.InstancePlugin):
             self.log.info("No staging directory found: %s" % staging_dir)
             return
 
+        if instance.data.get("stagingDir_persistent"):
+            self.log.info("Staging dir: %s should be persistent" % staging_dir)
+            return
+
         self.log.info("Removing staging directory {}".format(staging_dir))
         shutil.rmtree(staging_dir)
 
diff --git a/openpype/plugins/publish/cleanup_farm.py b/openpype/plugins/publish/cleanup_farm.py
index b87d4698a2..8052f13734 100644
--- a/openpype/plugins/publish/cleanup_farm.py
+++ b/openpype/plugins/publish/cleanup_farm.py
@@ -37,7 +37,7 @@ class CleanUpFarm(pyblish.api.ContextPlugin):
         dirpaths_to_remove = set()
         for instance in context:
             staging_dir = instance.data.get("stagingDir")
-            if staging_dir:
+            if staging_dir and not instance.data.get("stagingDir_persistent"):
                 dirpaths_to_remove.add(os.path.normpath(staging_dir))
 
             if "representations" in instance.data:
diff --git a/openpype/plugins/publish/collect_custom_staging_dir.py b/openpype/plugins/publish/collect_custom_staging_dir.py
new file mode 100644
index 0000000000..72ab0fe34d
--- /dev/null
+++ b/openpype/plugins/publish/collect_custom_staging_dir.py
@@ -0,0 +1,67 @@
+"""
+Requires:
+    anatomy
+
+
+Provides:
+    instance.data     -> stagingDir (folder path)
+                      -> stagingDir_persistent (bool)
+"""
+import copy
+import os.path
+
+import pyblish.api
+
+from openpype.pipeline.publish.lib import get_custom_staging_dir_info
+
+
+class CollectCustomStagingDir(pyblish.api.InstancePlugin):
+    """Looks through profiles if stagingDir should be persistent and in special
+    location.
+
+    Transient staging dir could be useful in specific use cases where is
+    desirable to have temporary renders in specific, persistent folders, could
+    be on disks optimized for speed for example.
+
+    It is studio responsibility to clean up obsolete folders with data.
+
+    Location of the folder is configured in `project_anatomy/templates/others`.
+    ('transient' key is expected, with 'folder' key)
+
+    Which family/task type/subset is applicable is configured in:
+    `project_settings/global/tools/publish/custom_staging_dir_profiles`
+
+    """
+    label = "Collect Custom Staging Directory"
+    order = pyblish.api.CollectorOrder + 0.4990
+
+    template_key = "transient"
+
+    def process(self, instance):
+        family = instance.data["family"]
+        subset_name = instance.data["subset"]
+        host_name = instance.context.data["hostName"]
+        project_name = instance.context.data["projectName"]
+
+        anatomy = instance.context.data["anatomy"]
+        anatomy_data = copy.deepcopy(instance.data["anatomyData"])
+        task = anatomy_data.get("task", {})
+
+        transient_tml, is_persistent = get_custom_staging_dir_info(
+            project_name, host_name, family, task.get("name"),
+            task.get("type"), subset_name, anatomy=anatomy, log=self.log)
+        result_str = "Not adding"
+        if transient_tml:
+            anatomy_data["root"] = anatomy.roots
+            scene_name = instance.context.data.get("currentFile")
+            if scene_name:
+                anatomy_data["scene_name"] = os.path.basename(scene_name)
+            transient_dir = transient_tml.format(**anatomy_data)
+            instance.data["stagingDir"] = transient_dir
+
+            instance.data["stagingDir_persistent"] = is_persistent
+            result_str = "Adding '{}' as".format(transient_dir)
+
+        self.log.info("{} custom staging dir for instance with '{}'".format(
+            result_str, family
+        ))
diff --git a/openpype/settings/defaults/project_anatomy/templates.json b/openpype/settings/defaults/project_anatomy/templates.json
index 02c0e35377..e5e535bf19 100644
--- a/openpype/settings/defaults/project_anatomy/templates.json
+++ b/openpype/settings/defaults/project_anatomy/templates.json
@@ -58,12 +58,16 @@
             "file": "{originalBasename}.{ext}",
             "path": "{@folder}/{@file}"
         },
+        "transient": {
+            "folder": "{root[work]}/{project[name]}/{hierarchy}/{asset}/work/{family}/{subset}"
+        },
         "__dynamic_keys_labels__": {
             "maya2unreal": "Maya to Unreal",
             "simpleUnrealTextureHero": "Simple Unreal Texture - Hero",
             "simpleUnrealTexture": "Simple Unreal Texture",
             "online": "online",
-            "source": "source"
+            "source": "source",
+            "transient": "transient"
         }
     }
 }
diff --git a/openpype/settings/defaults/project_settings/global.json b/openpype/settings/defaults/project_settings/global.json
index aad17d54da..aba840da78 100644
--- a/openpype/settings/defaults/project_settings/global.json
+++ b/openpype/settings/defaults/project_settings/global.json
@@ -591,7 +591,8 @@
                     "task_names": [],
                     "template_name": "simpleUnrealTextureHero"
                 }
-            ]
+            ],
+            "custom_staging_dir_profiles": []
         }
     },
     "project_folder_structure": "{\"__project_root__\": {\"prod\": {}, \"resources\": {\"footage\": {\"plates\": {}, \"offline\": {}}, \"audio\": {}, \"art_dept\": {}}, \"editorial\": {}, \"assets\": {\"characters\": {}, \"locations\": {}}, \"shots\": {}}}",
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_tools.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_tools.json
index 962008d476..85ec482e73 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_tools.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_tools.json
@@ -408,6 +408,71 @@
                             }
                         ]
                     }
+                },
+                {
+                    "type": "list",
+                    "key": "custom_staging_dir_profiles",
+                    "label": "Custom Staging Dir Profiles",
+                    "use_label_wrap": true,
+                    "docstring": "Profiles to specify special location and persistence for staging dir. Could be used in Creators and Publish phase!",
+                    "object_type": {
+                        "type": "dict",
+                        "children": [
+                            {
+                                "type": "boolean",
+                                "key": "active",
+                                "label": "Is active",
+                                "default": true
+                            },
+                            {
+                                "type": "separator"
+                            },
+                            {
+                                "key": "hosts",
+                                "label": "Host names",
+                                "type": "hosts-enum",
+                                "multiselection": true
+                            },
+                            {
+                                "key": "task_types",
+                                "label": "Task types",
+                                "type": "task-types-enum"
+                            },
+                            {
+                                "key": "task_names",
+                                "label": "Task names",
+                                "type": "list",
+                                "object_type": "text"
+                            },
+                            {
+                                "key": "families",
+                                "label": "Families",
+                                "type": "list",
+                                "object_type": "text"
+                            },
+                            {
+                                "key": "subsets",
+                                "label": "Subset names",
+                                "type": "list",
+                                "object_type": "text"
+                            },
+                            {
+                                "type": "separator"
+                            },
+                            {
+                                "key": "custom_staging_dir_persistent",
+                                "label": "Custom Staging Folder Persistent",
+                                "type": "boolean",
+                                "default": false
+                            },
+                            {
+                                "key": "template_name",
+                                "label": "Template Name",
+                                "type": "text",
+                                "placeholder": "transient"
+                            }
+                        ]
+                    }
                 }
             ]
         }
diff --git a/website/docs/project_settings/assets/global_tools_custom_staging_dir.png b/website/docs/project_settings/assets/global_tools_custom_staging_dir.png
new file mode 100644
index 0000000000000000000000000000000000000000..f7e8660a8863239310a1934a49c2811b4e0c031b
GIT binary patch
literal 9940
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
VmwKMN3A}U$l9y4I&XY9q`!5KAZJhuB

literal 0
HcmV?d00001

diff --git a/website/docs/project_settings/settings_project_global.md b/website/docs/project_settings/settings_project_global.md
index b6d624caa8..821585ae21 100644
--- a/website/docs/project_settings/settings_project_global.md
+++ b/website/docs/project_settings/settings_project_global.md
@@ -230,10 +230,10 @@ Applicable context filters:
 ## Tools
 Settings for OpenPype tools.
 
-## Creator
+### Creator
 Settings related to [Creator tool](artist_tools_creator).
 
-### Subset name profiles
+#### Subset name profiles
 ![global_tools_creator_subset_template](assets/global_tools_creator_subset_template.png)
 
 Subset name helps to identify published content. More specific name helps with organization and avoid mixing of published content. Subset name is defined using one of templates defined in **Subset name profiles settings**. The template is filled with context information at the time of creation.
@@ -263,10 +263,31 @@ Template may look like `"{family}{Task}{Variant}"`.
 Some creators may have other keys as their context may require more information or more specific values. Make sure you've read documentation of host you're using.
 
 
-## Workfiles
+### Publish
+
+#### Custom Staging Directory Profiles
+With this feature, users can specify a custom data folder path based on presets, which can be used during the creation and publishing stages.
+
+![global_tools_custom_staging_dir](assets/global_tools_custom_staging_dir.png)
+
+Staging directories are used as a destination for intermediate files (as renders) before they are renamed and copied to proper location during the integration phase. They could be created completely dynamically in the temp folder or for some DCCs in the `work` area.
+Example could be Nuke where artist might want to temporarily render pictures into `work` area to check them before they get published with the choice of "Use existing frames" on the write node.
+
+One of the key advantages of this feature is that it allows users to choose the folder for writing such intermediate files to take advantage of faster storage for rendering, which can help improve workflow efficiency. Additionally, this feature allows users to keep their intermediate extracted data persistent, and use their own infrastructure for regular cleaning.
+
+In some cases, these DCCs (Nuke, Houdini, Maya) automatically add a rendering path during the creation stage, which is then used in publishing. Creators and extractors of such DCCs need to use these profiles to fill paths in DCC's nodes to use this functionality.
+
+The custom staging folder uses a path template configured in `project_anatomy/templates/others` with `transient` being a default example path that could be used. The template requires a 'folder' key for it to be usable as custom staging folder.
+
+##### Known issues
+- Any DCC that uses prefilled paths and store them inside of workfile nodes needs to implement resolving these paths with a configured profiles.
+- If studio uses Site Sync remote artists need to have access to configured custom staging folder!
+- Each node on the rendering farm must have access to configured custom staging folder!
+
+### Workfiles
 All settings related to Workfile tool.
 
-### Open last workfile at launch
+#### Open last workfile at launch
 This feature allows you to define a rule for each task/host or toggle the feature globally to all tasks as they are visible in the picture.
 
 ![global_tools_workfile_open_last_version](assets/global_tools_workfile_open_last_version.png)

From 09faa840aeff7b479c865fe04185689b1aa75f5f Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Fri, 24 Mar 2023 17:18:33 +0100
Subject: [PATCH 138/151] updating project_action

---
 .github/workflows/project_actions.yml | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/.github/workflows/project_actions.yml b/.github/workflows/project_actions.yml
index 9c8c9da7dd..ec5578d2fe 100644
--- a/.github/workflows/project_actions.yml
+++ b/.github/workflows/project_actions.yml
@@ -2,9 +2,7 @@ name: project-actions
 
 on:
   pull_request:
-    types: [review_requested, closed]
-  pull_request_review:
-    types: [submitted]
+    types: [review_requested]
 
 jobs:
   pr_review_requested:
@@ -16,7 +14,6 @@ jobs:
         uses: leonsteinhaeuser/project-beta-automations@v2.1.0
         with:
           gh_token: ${{ secrets.YNPUT_BOT_TOKEN }}
-          user: ${{ secrets.CI_USER }}
           organization: ynput
           project_id: 11
           resource_node_id: ${{ github.event.pull_request.node_id }}

From 3253c03e3b147c69609e1faf0730f955e32add86 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Fri, 24 Mar 2023 17:29:34 +0100
Subject: [PATCH 139/151] returning trigger to project action

---
 .github/workflows/project_actions.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/project_actions.yml b/.github/workflows/project_actions.yml
index ec5578d2fe..ca94f3ae77 100644
--- a/.github/workflows/project_actions.yml
+++ b/.github/workflows/project_actions.yml
@@ -3,6 +3,8 @@ name: project-actions
 on:
   pull_request:
     types: [review_requested]
+  pull_request_review:
+    types: [submitted]
 
 jobs:
   pr_review_requested:

From 4ea987fb1f442069a3127bdf046c57bf2f8393af Mon Sep 17 00:00:00 2001
From: Ynbot <bot@ynput.io>
Date: Sat, 25 Mar 2023 03:26:01 +0000
Subject: [PATCH 140/151] [Automated] Bump version

---
 openpype/version.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/version.py b/openpype/version.py
index 5b6db12b5e..bc5ea7fe7c 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.15.3-nightly.3"
+__version__ = "3.15.3-nightly.4"

From 7e92f2184e52f2b75f8f85e930bb8974f8e4289c Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Sun, 26 Mar 2023 09:43:27 +0100
Subject: [PATCH 141/151] Default playblast compression to PNG

---
 openpype/settings/defaults/project_settings/maya.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/settings/defaults/project_settings/maya.json b/openpype/settings/defaults/project_settings/maya.json
index 4a97ea8a09..e914eb29f9 100644
--- a/openpype/settings/defaults/project_settings/maya.json
+++ b/openpype/settings/defaults/project_settings/maya.json
@@ -790,7 +790,7 @@
         "ExtractPlayblast": {
             "capture_preset": {
                 "Codec": {
-                    "compression": "jpg",
+                    "compression": "png",
                     "format": "image",
                     "quality": 95
                 },

From 09e0ba54f24c73a721f6f4d31ce23c3d786178c6 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Date: Mon, 27 Mar 2023 09:57:37 +0200
Subject: [PATCH 142/151] TVPaint: Optional Validation plugins can be
 de/activated by user (#4674)

* fix TVPaint validation plugins so they can be enabled/disabled

* add missing 'is_active' method usage

* added option to enable auto detet render creator

* added fps to instance data

* safe access to layers

* fix handling of missing render layer

* render passes are safer

* fix convertor plugin
---
 .../tvpaint/plugins/create/convert_legacy.py      |  4 ++--
 .../hosts/tvpaint/plugins/create/create_render.py | 15 ++++++++-------
 .../plugins/publish/collect_instance_frames.py    |  2 ++
 .../plugins/publish/validate_asset_name.py        | 12 ++++++++++--
 .../plugins/publish/validate_layers_visibility.py |  2 +-
 .../tvpaint/plugins/publish/validate_marks.py     | 13 +++++++++++--
 .../plugins/publish/validate_scene_settings.py    | 13 +++++++++++--
 .../plugins/publish/validate_start_frame.py       | 13 +++++++++++--
 .../defaults/project_settings/tvpaint.json        |  1 +
 .../projects_schema/schema_project_tvpaint.json   |  6 ++++++
 10 files changed, 63 insertions(+), 18 deletions(-)

diff --git a/openpype/hosts/tvpaint/plugins/create/convert_legacy.py b/openpype/hosts/tvpaint/plugins/create/convert_legacy.py
index 538c6e4c5e..5cfa1faa50 100644
--- a/openpype/hosts/tvpaint/plugins/create/convert_legacy.py
+++ b/openpype/hosts/tvpaint/plugins/create/convert_legacy.py
@@ -55,7 +55,7 @@ class TVPaintLegacyConverted(SubsetConvertorPlugin):
         self._convert_render_layers(
             to_convert["renderLayer"], current_instances)
         self._convert_render_passes(
-            to_convert["renderpass"], current_instances)
+            to_convert["renderPass"], current_instances)
         self._convert_render_scenes(
             to_convert["renderScene"], current_instances)
         self._convert_workfiles(
@@ -116,7 +116,7 @@ class TVPaintLegacyConverted(SubsetConvertorPlugin):
         render_layers_by_group_id = {}
         for instance in current_instances:
             if instance.get("creator_identifier") == "render.layer":
-                group_id = instance["creator_identifier"]["group_id"]
+                group_id = instance["creator_attributes"]["group_id"]
                 render_layers_by_group_id[group_id] = instance
 
         for render_pass in render_passes:
diff --git a/openpype/hosts/tvpaint/plugins/create/create_render.py b/openpype/hosts/tvpaint/plugins/create/create_render.py
index 9711024c79..2369c7329f 100644
--- a/openpype/hosts/tvpaint/plugins/create/create_render.py
+++ b/openpype/hosts/tvpaint/plugins/create/create_render.py
@@ -415,11 +415,11 @@ class CreateRenderPass(TVPaintCreator):
                 .get("creator_attributes", {})
                 .get("render_layer_instance_id")
             )
-            render_layer_info = render_layers.get(render_layer_instance_id)
+            render_layer_info = render_layers.get(render_layer_instance_id, {})
             self.update_instance_labels(
                 instance_data,
-                render_layer_info["variant"],
-                render_layer_info["template_data"]
+                render_layer_info.get("variant"),
+                render_layer_info.get("template_data")
             )
             instance = CreatedInstance.from_existing(instance_data, self)
             self._add_instance_to_context(instance)
@@ -607,11 +607,11 @@ class CreateRenderPass(TVPaintCreator):
         current_instances = self.host.list_instances()
         render_layers = [
             {
-                "value": instance["instance_id"],
-                "label": instance["subset"]
+                "value": inst["instance_id"],
+                "label": inst["subset"]
             }
-            for instance in current_instances
-            if instance["creator_identifier"] == CreateRenderlayer.identifier
+            for inst in current_instances
+            if inst.get("creator_identifier") == CreateRenderlayer.identifier
         ]
         if not render_layers:
             render_layers.append({"value": None, "label": "N/A"})
@@ -697,6 +697,7 @@ class TVPaintAutoDetectRenderCreator(TVPaintCreator):
             ["create"]
             ["auto_detect_render"]
         )
+        self.enabled = plugin_settings.get("enabled", False)
         self.allow_group_rename = plugin_settings["allow_group_rename"]
         self.group_name_template = plugin_settings["group_name_template"]
         self.group_idx_offset = plugin_settings["group_idx_offset"]
diff --git a/openpype/hosts/tvpaint/plugins/publish/collect_instance_frames.py b/openpype/hosts/tvpaint/plugins/publish/collect_instance_frames.py
index 5eb702a1da..63f04cf3ce 100644
--- a/openpype/hosts/tvpaint/plugins/publish/collect_instance_frames.py
+++ b/openpype/hosts/tvpaint/plugins/publish/collect_instance_frames.py
@@ -22,9 +22,11 @@ class CollectOutputFrameRange(pyblish.api.InstancePlugin):
         context = instance.context
 
         frame_start = asset_doc["data"]["frameStart"]
+        fps = asset_doc["data"]["fps"]
         frame_end = frame_start + (
             context.data["sceneMarkOut"] - context.data["sceneMarkIn"]
         )
+        instance.data["fps"] = fps
         instance.data["frameStart"] = frame_start
         instance.data["frameEnd"] = frame_end
         self.log.info(
diff --git a/openpype/hosts/tvpaint/plugins/publish/validate_asset_name.py b/openpype/hosts/tvpaint/plugins/publish/validate_asset_name.py
index 7e35726030..d7984ce971 100644
--- a/openpype/hosts/tvpaint/plugins/publish/validate_asset_name.py
+++ b/openpype/hosts/tvpaint/plugins/publish/validate_asset_name.py
@@ -1,5 +1,8 @@
 import pyblish.api
-from openpype.pipeline import PublishXmlValidationError
+from openpype.pipeline import (
+    PublishXmlValidationError,
+    OptionalPyblishPluginMixin,
+)
 from openpype.hosts.tvpaint.api.pipeline import (
     list_instances,
     write_instances,
@@ -31,7 +34,10 @@ class FixAssetNames(pyblish.api.Action):
         write_instances(new_instance_items)
 
 
-class ValidateAssetNames(pyblish.api.ContextPlugin):
+class ValidateAssetName(
+    OptionalPyblishPluginMixin,
+    pyblish.api.ContextPlugin
+):
     """Validate assset name present on instance.
 
     Asset name on instance should be the same as context's.
@@ -43,6 +49,8 @@ class ValidateAssetNames(pyblish.api.ContextPlugin):
     actions = [FixAssetNames]
 
     def process(self, context):
+        if not self.is_active(context.data):
+            return
         context_asset_name = context.data["asset"]
         for instance in context:
             asset_name = instance.data.get("asset")
diff --git a/openpype/hosts/tvpaint/plugins/publish/validate_layers_visibility.py b/openpype/hosts/tvpaint/plugins/publish/validate_layers_visibility.py
index 6a496a2e49..8e52a636f4 100644
--- a/openpype/hosts/tvpaint/plugins/publish/validate_layers_visibility.py
+++ b/openpype/hosts/tvpaint/plugins/publish/validate_layers_visibility.py
@@ -11,7 +11,7 @@ class ValidateLayersVisiblity(pyblish.api.InstancePlugin):
     families = ["review", "render"]
 
     def process(self, instance):
-        layers = instance.data["layers"]
+        layers = instance.data.get("layers")
         # Instance have empty layers
         # - it is not job of this validator to check that
         if not layers:
diff --git a/openpype/hosts/tvpaint/plugins/publish/validate_marks.py b/openpype/hosts/tvpaint/plugins/publish/validate_marks.py
index 0030b0fd1c..7b2cc62bb5 100644
--- a/openpype/hosts/tvpaint/plugins/publish/validate_marks.py
+++ b/openpype/hosts/tvpaint/plugins/publish/validate_marks.py
@@ -1,7 +1,10 @@
 import json
 
 import pyblish.api
-from openpype.pipeline import PublishXmlValidationError
+from openpype.pipeline import (
+    PublishXmlValidationError,
+    OptionalPyblishPluginMixin,
+)
 from openpype.hosts.tvpaint.api.lib import execute_george
 
 
@@ -23,7 +26,10 @@ class ValidateMarksRepair(pyblish.api.Action):
         )
 
 
-class ValidateMarks(pyblish.api.ContextPlugin):
+class ValidateMarks(
+    OptionalPyblishPluginMixin,
+    pyblish.api.ContextPlugin
+):
     """Validate mark in and out are enabled and it's duration.
 
     Mark In/Out does not have to match frameStart and frameEnd but duration is
@@ -59,6 +65,9 @@ class ValidateMarks(pyblish.api.ContextPlugin):
         }
 
     def process(self, context):
+        if not self.is_active(context.data):
+            return
+
         current_data = {
             "markIn": context.data["sceneMarkIn"],
             "markInState": context.data["sceneMarkInState"],
diff --git a/openpype/hosts/tvpaint/plugins/publish/validate_scene_settings.py b/openpype/hosts/tvpaint/plugins/publish/validate_scene_settings.py
index 4473e4b1b7..0ab8e811f5 100644
--- a/openpype/hosts/tvpaint/plugins/publish/validate_scene_settings.py
+++ b/openpype/hosts/tvpaint/plugins/publish/validate_scene_settings.py
@@ -1,11 +1,17 @@
 import json
 
 import pyblish.api
-from openpype.pipeline import PublishXmlValidationError
+from openpype.pipeline import (
+    PublishXmlValidationError,
+    OptionalPyblishPluginMixin,
+)
 
 
 # TODO @iLliCiTiT add fix action for fps
-class ValidateProjectSettings(pyblish.api.ContextPlugin):
+class ValidateProjectSettings(
+    OptionalPyblishPluginMixin,
+    pyblish.api.ContextPlugin
+):
     """Validate scene settings against database."""
 
     label = "Validate Scene Settings"
@@ -13,6 +19,9 @@ class ValidateProjectSettings(pyblish.api.ContextPlugin):
     optional = True
 
     def process(self, context):
+        if not self.is_active(context.data):
+            return
+
         expected_data = context.data["assetEntity"]["data"]
         scene_data = {
             "fps": context.data.get("sceneFps"),
diff --git a/openpype/hosts/tvpaint/plugins/publish/validate_start_frame.py b/openpype/hosts/tvpaint/plugins/publish/validate_start_frame.py
index 066e54c670..229ccfcd18 100644
--- a/openpype/hosts/tvpaint/plugins/publish/validate_start_frame.py
+++ b/openpype/hosts/tvpaint/plugins/publish/validate_start_frame.py
@@ -1,5 +1,8 @@
 import pyblish.api
-from openpype.pipeline import PublishXmlValidationError
+from openpype.pipeline import (
+    PublishXmlValidationError,
+    OptionalPyblishPluginMixin,
+)
 from openpype.hosts.tvpaint.api.lib import execute_george
 
 
@@ -14,7 +17,10 @@ class RepairStartFrame(pyblish.api.Action):
         execute_george("tv_startframe 0")
 
 
-class ValidateStartFrame(pyblish.api.ContextPlugin):
+class ValidateStartFrame(
+    OptionalPyblishPluginMixin,
+    pyblish.api.ContextPlugin
+):
     """Validate start frame being at frame 0."""
 
     label = "Validate Start Frame"
@@ -24,6 +30,9 @@ class ValidateStartFrame(pyblish.api.ContextPlugin):
     optional = True
 
     def process(self, context):
+        if not self.is_active(context.data):
+            return
+
         start_frame = execute_george("tv_startframe")
         if start_frame == 0:
             return
diff --git a/openpype/settings/defaults/project_settings/tvpaint.json b/openpype/settings/defaults/project_settings/tvpaint.json
index 9173a8c3d5..1671748e97 100644
--- a/openpype/settings/defaults/project_settings/tvpaint.json
+++ b/openpype/settings/defaults/project_settings/tvpaint.json
@@ -42,6 +42,7 @@
             "default_variants": []
         },
         "auto_detect_render": {
+            "enabled": false,
             "allow_group_rename": true,
             "group_name_template": "L{group_index}",
             "group_idx_offset": 10,
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_tvpaint.json b/openpype/settings/entities/schemas/projects_schema/schema_project_tvpaint.json
index 708b688ba5..1094595851 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_tvpaint.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_tvpaint.json
@@ -202,7 +202,13 @@
                     "key": "auto_detect_render",
                     "label": "Auto-Detect Create Render",
                     "is_group": true,
+                    "checkbox_key": "enabled",
                     "children": [
+                        {
+                            "type": "boolean",
+                            "key": "enabled",
+                            "label": "Enabled"
+                        },
                         {
                             "type": "label",
                             "label": "The creator tries to auto-detect Render Layers and Render Passes in scene. For Render Layers is used group name as a variant and for Render Passes is used TVPaint layer name.<br/><br/>Group names can be renamed by their used order in scene. The renaming template where can be used <b>{group_index}</b> formatting key which is filled by \"used position index of group\".<br/>- Template: <b>L{group_index}</b><br/>- Group offset: <b>10</b><br/>- Group padding: <b>3</b><br/>Would create group names \"<b>L010</b>\", \"<b>L020</b>\", ..."

From a178ca1569a43c1becfba3db0209ba3f982d4959 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Mon, 27 Mar 2023 17:35:45 +0800
Subject: [PATCH 143/151] remove duplicated imported function

---
 openpype/hosts/max/api/menu.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/max/api/menu.py b/openpype/hosts/max/api/menu.py
index b52acc3c38..066cc90039 100644
--- a/openpype/hosts/max/api/menu.py
+++ b/openpype/hosts/max/api/menu.py
@@ -5,7 +5,7 @@ from pymxs import runtime as rt
 
 from openpype.tools.utils import host_tools
 from openpype.hosts.max.api import lib
-from openpype.hosts.max.api import lib
+
 
 class OpenPypeMenu(object):
     """Object representing OpenPype menu.

From b9d1d560a78950142a145588ea46ed54d03415dd Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Mon, 27 Mar 2023 12:59:53 +0200
Subject: [PATCH 144/151] :bug: pass zoom settings if review is attached

---
 openpype/hosts/maya/plugins/publish/collect_review.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openpype/hosts/maya/plugins/publish/collect_review.py b/openpype/hosts/maya/plugins/publish/collect_review.py
index 548b1c996a..5d5ec294b1 100644
--- a/openpype/hosts/maya/plugins/publish/collect_review.py
+++ b/openpype/hosts/maya/plugins/publish/collect_review.py
@@ -79,6 +79,7 @@ class CollectReview(pyblish.api.InstancePlugin):
                 data['review_width'] = instance.data['review_width']
                 data['review_height'] = instance.data['review_height']
                 data["isolate"] = instance.data["isolate"]
+                data["panZoom"] = instance.data.get("panZoom", False)
                 cmds.setAttr(str(instance) + '.active', 1)
                 self.log.debug('data {}'.format(instance.context[i].data))
                 instance.context[i].data.update(data)

From 5b4b0e601b0f2a4adefc56ba2251a487e4818253 Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Mon, 27 Mar 2023 13:12:36 +0200
Subject: [PATCH 145/151] :bug: pass panel too

---
 openpype/hosts/maya/plugins/publish/collect_review.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openpype/hosts/maya/plugins/publish/collect_review.py b/openpype/hosts/maya/plugins/publish/collect_review.py
index 5d5ec294b1..71c65cc47e 100644
--- a/openpype/hosts/maya/plugins/publish/collect_review.py
+++ b/openpype/hosts/maya/plugins/publish/collect_review.py
@@ -80,6 +80,7 @@ class CollectReview(pyblish.api.InstancePlugin):
                 data['review_height'] = instance.data['review_height']
                 data["isolate"] = instance.data["isolate"]
                 data["panZoom"] = instance.data.get("panZoom", False)
+                data["panel"] =instance.data["panel"]
                 cmds.setAttr(str(instance) + '.active', 1)
                 self.log.debug('data {}'.format(instance.context[i].data))
                 instance.context[i].data.update(data)

From 5805e7d90041938da22eb63844679db433415d62 Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Mon, 27 Mar 2023 13:13:09 +0200
Subject: [PATCH 146/151] :rotating_light: add space

---
 openpype/hosts/maya/plugins/publish/collect_review.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/publish/collect_review.py b/openpype/hosts/maya/plugins/publish/collect_review.py
index 71c65cc47e..36affe852b 100644
--- a/openpype/hosts/maya/plugins/publish/collect_review.py
+++ b/openpype/hosts/maya/plugins/publish/collect_review.py
@@ -80,7 +80,7 @@ class CollectReview(pyblish.api.InstancePlugin):
                 data['review_height'] = instance.data['review_height']
                 data["isolate"] = instance.data["isolate"]
                 data["panZoom"] = instance.data.get("panZoom", False)
-                data["panel"] =instance.data["panel"]
+                data["panel"] = instance.data["panel"]
                 cmds.setAttr(str(instance) + '.active', 1)
                 self.log.debug('data {}'.format(instance.context[i].data))
                 instance.context[i].data.update(data)

From 2244a634b25a4191349db3d994c909359bed9c86 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Date: Mon, 27 Mar 2023 16:06:52 +0200
Subject: [PATCH 147/151] change minimum frame start/end to '0' (#4719)

---
 openpype/tools/project_manager/project_manager/view.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/tools/project_manager/project_manager/view.py b/openpype/tools/project_manager/project_manager/view.py
index b35491c5b2..2cf11b702d 100644
--- a/openpype/tools/project_manager/project_manager/view.py
+++ b/openpype/tools/project_manager/project_manager/view.py
@@ -72,8 +72,8 @@ class HierarchyView(QtWidgets.QTreeView):
     column_delegate_defs = {
         "name": NameDef(),
         "type": TypeDef(),
-        "frameStart": NumberDef(1),
-        "frameEnd": NumberDef(1),
+        "frameStart": NumberDef(0),
+        "frameEnd": NumberDef(0),
         "fps": NumberDef(1, decimals=3, step=1),
         "resolutionWidth": NumberDef(0),
         "resolutionHeight": NumberDef(0),

From 0778dd3ec763aa2257f235b310041aed18902b30 Mon Sep 17 00:00:00 2001
From: Ynbot <bot@ynput.io>
Date: Mon, 27 Mar 2023 15:28:21 +0000
Subject: [PATCH 148/151] [Automated] Release

---
 CHANGELOG.md        | 668 ++++++++++++++++++++++++++++++++++++++++++++
 openpype/version.py |   2 +-
 pyproject.toml      |   2 +-
 3 files changed, 670 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 145c2e2c1a..78ea53f3d0 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,674 @@
 # Changelog
 
 
+[Full Changelog](https://github.com/ynput/OpenPype/compare/3.15.2...3.15.3)
+
+### **🆕 New features**
+
+
+<details>
+<summary>Data Exchanges: Point Cloud for 3dsMax <a href="https://github.com/ynput/OpenPype/pull/4532">#4532</a></summary>
+
+<strong>Publish PRT format with tyFlow in 3dsmax
+
+</strong>Publish PRT format with tyFlow in 3dsmax and possibly set up loader to load the format too.
+- [x] creator
+- [x] extractor
+- [x] validator
+- [x] loader
+
+
+___
+
+</details>
+
+
+<details>
+<summary>MaxScene Family  <a href="https://github.com/ynput/OpenPype/pull/4615">#4615</a></summary>
+
+Introduction of the Max Scene Family
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Blender: Extract Review <a href="https://github.com/ynput/OpenPype/pull/3616">#3616</a></summary>
+
+<strong>Added Review to Blender.
+
+</strong>This implementation is based on #3508 but made compatible for the current implementation of OpenPype for Blender.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Global: persistent staging directory for renders <a href="https://github.com/ynput/OpenPype/pull/4583">#4583</a></summary>
+
+<strong>Allows configure if staging directory (`stagingDir`) should be persistent with use of profiles.
+
+</strong>With this feature, users can specify a transient data folder path based on presets, which can be used during the creation and publishing stages. In some cases, these DCCs automatically add a rendering path during the creation stage, which is then used in publishing.One of the key advantages of this feature is that it allows users to take advantage of faster storages for rendering, which can help improve workflow efficiency. Additionally, this feature allows users to keep their rendered data persistent, and use their own infrastructure for regular cleaning.However, it should be noted that some productions may want to use this feature without persistency. Furthermore, there may be a need for retargeting the rendering folder to faster storages, which is also not supported at the moment.It is studio responsibility to clean up obsolete folders with data.Location of the folder is configured in `project_anatomy/templates/others`. ('transient' key is expected, with 'folder' key, could be more templates)Which family/task type/subset is applicable is configured in:`project_settings/global/tools/publish/transient_dir_profiles`
+
+
+___
+
+</details>
+
+### **🚀 Enhancements**
+
+
+<details>
+<summary>Maya: Multiple values on single render attribute - OP-4131 <a href="https://github.com/ynput/OpenPype/pull/4631">#4631</a></summary>
+
+When validating render attributes, this adds support for multiple values. When repairing first value in list is used.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Maya: enable 2D Pan/Zoom for playblasts - OP-5213 <a href="https://github.com/ynput/OpenPype/pull/4687">#4687</a></summary>
+
+Setting for enabling 2D Pan/Zoom on reviews.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Houdini: Create button open new publisher's "create" tab <a href="https://github.com/ynput/OpenPype/pull/4601">#4601</a></summary>
+
+During a talk with @maxpareschi he mentioned that the new publisher in Houdini felt super confusing due to "Create" going to the older creator but now being completely empty and the publish button directly went to the publish tab.This resolves that by fixing the Create button to now open the new publisher but on the Create tab.Also made publish button enforce going to the "publish" tab for consistency in usage.@antirotor I think changing the Create button's callback was just missed in this commit or was there a specific reason to not change that around yet?
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Resolution settings referenced from DB record for 3dsMax <a href="https://github.com/ynput/OpenPype/pull/4652">#4652</a></summary>
+
+- Add Callback for setting the resolution according to DB after the new scene is created.
+- Add a new Action into openpype menu which allows the user to reset the resolution in 3dsMax
+
+
+___
+
+</details>
+
+
+<details>
+<summary>scene length setting referenced from DB record for 3dsMax <a href="https://github.com/ynput/OpenPype/pull/4665">#4665</a></summary>
+
+Setting the timeline length based on DB record in 3dsMax Hosts
+
+
+___
+
+</details>
+
+
+<details>
+<summary>increment workfile version 3dsmax <a href="https://github.com/ynput/OpenPype/pull/4685">#4685</a></summary>
+
+increment workfile version in 3dsmax as if in blender and maya hosts.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Copy existing or generate new Fusion profile on prelaunch <a href="https://github.com/ynput/OpenPype/pull/4572">#4572</a></summary>
+
+<strong>Fusion preferences will be copied to the predefined `~/.openpype/hosts/fusion/prefs` folder (or any other folder set in system settings) on launch.
+
+</strong>The idea is to create a copy of existing Fusion profile, adding an OpenPype menu to the Fusion instance.By default the copy setting is turned off, so no file copying is performed. Instead the clean Fusion profile is created by Fusion in the predefined folder. The default locaion is set to `~/.openpype/hosts/fusion/prefs`, to better comply with the other os platforms. After creating the default profile, some modifications are applied:
+- forced Python3
+- forced English interface
+- setup Openpype specific path maps.If the `copy_prefs` checkbox is toggled, a copy of existing Fusion profile folder will be placed in the mentioned location. Then they are altered the same way as described above. The operation is run only once, on the first launch, unless the `force_sync [Resync profile on each launch]` is toggled.English interface is forced because the `FUSION16_PROFILE_DIR` environment variable is not read otherwise (seems to be a Fusion bug).
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Fusion publish existing frames <a href="https://github.com/ynput/OpenPype/pull/4611">#4611</a></summary>
+
+This PR adds the function to publish existing frames instead of having to re-render all of them for each new publish.I have split the render_locally plugin so the review-part is its own plugin now.I also change the saver-creator-plugin's label from Saver to Render (saver) as I intend to add a Prerender creator like in Nuke.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Clockify: refresh and fix the integration <a href="https://github.com/ynput/OpenPype/pull/4607">#4607</a></summary>
+
+Due to recent API changes, Clockify requires `user_id` to operate with the timers. I updated this part and currently it is a WIP for making it fully functional. Most functions, such as start and stop timer, and projects sync are currently working. For the rate limiting task new dependency is added: https://pypi.org/project/ratelimiter/
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Publisher: Windows reduce command window pop-ups during Publishing <a href="https://github.com/ynput/OpenPype/pull/4672">#4672</a></summary>
+
+Reduce the command line pop-ups that show on Windows during publishing.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>CelAction: conditional workfile parameters from settings <a href="https://github.com/ynput/OpenPype/pull/4677">#4677</a></summary>
+
+Since some productions were requesting excluding some workfile parameters from publishing submission, we needed to move them to settings so those could be altered per project.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Fix name and docstring for Create Workdir Extra Folders prelaunch hook <a href="https://github.com/ynput/OpenPype/pull/4683">#4683</a></summary>
+
+Fix class name and docstring for Create Workdir Extra Folders prelaunch hookThe class name and docstring were originally copied from another plug-in and didn't match the plug-in logic.This also fixes potentially seeing this twice in your logs. Before:After:Where it was actually running both this prelaunch hook and the actual `AddLastWorkfileToLaunchArgs` plugin.
+
+
+___
+
+</details>
+
+### **🐛 Bug fixes**
+
+
+<details>
+<summary>Maya: Fix getting non-active model panel. <a href="https://github.com/ynput/OpenPype/pull/2968">#2968</a></summary>
+
+<strong>When capturing multiple cameras with image planes that have file sequences playing, only the active (first) camera will play through the file sequence.
+
+</strong>
+___
+
+</details>
+
+
+<details>
+<summary>Maya: Fix broken review publishing. <a href="https://github.com/ynput/OpenPype/pull/4549">#4549</a></summary>
+
+<strong>Resolves #4547
+
+</strong>
+___
+
+</details>
+
+
+<details>
+<summary>Maya: Avoid error on right click in Loader if `mtoa` is not loaded <a href="https://github.com/ynput/OpenPype/pull/4616">#4616</a></summary>
+
+Fix an error on right clicking in the Loader when `mtoa` is not a loaded plug-in.Additionally if `mtoa` isn't loaded the loader will now load the plug-in before trying to create the arnold standin.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Maya: Fix extract look colorspace detection <a href="https://github.com/ynput/OpenPype/pull/4618">#4618</a></summary>
+
+Fix the logic which guesses the colorspace using `arnold` python library.
+- Previously it'd error if `mtoa` was not available on path so it still required `mtoa` to be available.
+- The guessing colorspace logic doesn't actually require `mtoa` to be loaded, but just the `arnold` python library to be available. This changes the logic so it doesn't require the `mtoa` plugin to get loaded to guess the colorspace.
+- The if/else branch was likely not doing what was intended `cmds.loadPlugin("mtoa", quiet=True)` returns None if the plug-in was already loaded. So this would only ever be true if it ends up loading the `mtoa` plugin the first time.
+```python
+# Tested in Maya 2022.1
+print(cmds.loadPlugin("mtoa", quiet=True))
+# ['mtoa']
+print(cmds.loadPlugin("mtoa", quiet=True))
+# None
+```
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Maya: Maya Playblast Options overrides - OP-3847 <a href="https://github.com/ynput/OpenPype/pull/4634">#4634</a></summary>
+
+When publishing a review in Maya, the extractor would fail due to wrong (long) panel name.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Bugfix/op 2834 fix extract playblast <a href="https://github.com/ynput/OpenPype/pull/4701">#4701</a></summary>
+
+Paragraphs contain detailed information on the changes made to the product or service, providing an in-depth description of the updates and enhancements. They can be used to explain the reasoning behind the changes, or to highlight the importance of the new features. Paragraphs can often include links to further information or support documentation.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Bugfix/op 2834 fix extract playblast <a href="https://github.com/ynput/OpenPype/pull/4704">#4704</a></summary>
+
+Paragraphs contain detailed information on the changes made to the product or service, providing an in-depth description of the updates and enhancements. They can be used to explain the reasoning behind the changes, or to highlight the importance of the new features. Paragraphs can often include links to further information or support documentation.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Maya: bug fix for passing zoom settings if review is attached to subset <a href="https://github.com/ynput/OpenPype/pull/4716">#4716</a></summary>
+
+Fix for attaching review to subset with pan/zoom option.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Fixed a bug where a QThread in the splash screen could be destroyed before finishing execution <a href="https://github.com/ynput/OpenPype/pull/4647">#4647</a></summary>
+
+This should fix the occasional behavior of the QThread being destroyed before even its worker returns from the `run()` function.After quiting, it should wait for the QThread object to properly close itself.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Max: fix the bug of removing an instance <a href="https://github.com/ynput/OpenPype/pull/4617">#4617</a></summary>
+
+fix the bug of removing an instance in 3dsMax
+
+
+___
+
+</details>
+
+
+<details>
+<summary>bugfix for 3dsmax publishing error <a href="https://github.com/ynput/OpenPype/pull/4637">#4637</a></summary>
+
+fix the bug of failing publishing job in 3dsMax
+
+
+___
+
+</details>
+
+
+<details>
+<summary>3dsmax: opening last workfile <a href="https://github.com/ynput/OpenPype/pull/4644">#4644</a></summary>
+
+Supports opening last saved workfile in 3dsmax host.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Global | Nuke: fixing farm publishing workflow <a href="https://github.com/ynput/OpenPype/pull/4623">#4623</a></summary>
+
+After Nuke had adopted new publisher with new creators new issues were introduced. Those issues were addressed with this PR. Those are for example broken reviewable video files publishing if published via farm. Also fixed local publishing.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Nuke: Nukenodes family instance without frame range <a href="https://github.com/ynput/OpenPype/pull/4669">#4669</a></summary>
+
+No need to add frame range data into `nukenodes` (backdrop) family publishes - since those are timeless.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>TVPaint: Optional Validation plugins can be de/activated by user <a href="https://github.com/ynput/OpenPype/pull/4674">#4674</a></summary>
+
+Added `OptionalPyblishPluginMixin` to TVpaint plugins that can be optional.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Hiero: Creator with correct workfile numeric padding input <a href="https://github.com/ynput/OpenPype/pull/4666">#4666</a></summary>
+
+Creator was showing 99 in workfile input for long time, even if users set default value to 1001 in studio settings. This has been fixed now.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Hiero: correct container colors if UpToDate <a href="https://github.com/ynput/OpenPype/pull/4708">#4708</a></summary>
+
+Colors on loaded containers are now correctly identifying real state of version. `Red` for out of date and `green` for up to date.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Maya: tile assembly fail in draft - OP-4820 <a href="https://github.com/ynput/OpenPype/pull/4416">#4416</a></summary>
+
+<strong>Tile assembly in Deadline was broken.
+
+</strong>Initial bug report revealed other areas of the tile assembly that needed fixing.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Scene inventory: Fix code errors when "not found" entries are found <a href="https://github.com/ynput/OpenPype/pull/4594">#4594</a></summary>
+
+Whenever a "NOT FOUND" entry is present a lot of errors happened in the Scene Inventory:
+- It started spamming a lot of errors for the VersionDelegate since it had no numeric version (no version at all).Error reported on Discord:
+```python
+Traceback (most recent call last):
+  File "C:\Users\videopro\Documents\github\OpenPype\openpype\tools\utils\delegates.py", line 65, in paint
+    text = self.displayText(
+  File "C:\Users\videopro\Documents\github\OpenPype\openpype\tools\utils\delegates.py", line 33, in displayText
+    assert isinstance(value, numbers.Integral), (
+AssertionError: Version is not integer. "None" <class 'NoneType'>
+```
+- Right click menu would error on NOT FOUND entries, and thus not show. With this PR it will now _disregard_ not found items for "Set version" and "Remove" but still allow actions.This PR resolves those.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Ftrack: Ftrack additional families filtering <a href="https://github.com/ynput/OpenPype/pull/4633">#4633</a></summary>
+
+Ftrack family collector makes sure the subset family is also in instance families for additional families filtering.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>General: Use right validation for ffmpeg executable <a href="https://github.com/ynput/OpenPype/pull/4640">#4640</a></summary>
+
+Use ffmpeg exec validation for ffmpeg executables instead of oiio exec validation. The validation is used as last possible source of ffmpeg from `PATH` environment variables, which is an edge case but can cause issues.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Global: add tags field to thumbnail representation <a href="https://github.com/ynput/OpenPype/pull/4660">#4660</a></summary>
+
+Thumbnail representation might be missing tags field.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Kitsu: Slightly less strict with instance data <a href="https://github.com/ynput/OpenPype/pull/4678">#4678</a></summary>
+
+- Allow to take task name from context if asset doesn't have any. Fixes an issue with Photoshop's review instance not having `task` in data.
+- Allow to match "review" against both `instance.data["family"]` and `instance.data["families"]` because some instances don't have the primary family in families, e.g. in Photoshop and TVPaint.
+- Do not error on Integrate Kitsu Review whenever for whatever reason Integrate Kitsu Note did not created a comment but just log the message that it was unable to connect a review.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Refactor _capture <a href="https://github.com/ynput/OpenPype/pull/4702">#4702</a></summary>
+
+Paragraphs contain detailed information on the changes made to the product or service, providing an in-depth description of the updates and enhancements. They can be used to explain the reasoning behind the changes, or to highlight the importance of the new features. Paragraphs can often include links to further information or support documentation.
+
+
+___
+
+</details>
+
+### **🔀 Refactored code**
+
+
+<details>
+<summary>Look Assigner: Move Look Assigner tool since it's Maya only <a href="https://github.com/ynput/OpenPype/pull/4604">#4604</a></summary>
+
+Fix #4357: Move Look Assigner tool to maya since it's Maya only
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Maya: Remove unused functions from Extract Look <a href="https://github.com/ynput/OpenPype/pull/4671">#4671</a></summary>
+
+Remove unused functions from Maya Extract Look plug-in
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Extract Review code refactor <a href="https://github.com/ynput/OpenPype/pull/3930">#3930</a></summary>
+
+<strong>Trying to reduce complexity of Extract Review plug-in
+- Re-use profile filtering from lib
+- Remove "combination families" additional filtering which supposedly was from OP v2
+- Simplify 'formatting' for filling gaps
+- Use `legacy_io.Session` over `os.environ`
+
+</strong>
+___
+
+</details>
+
+
+<details>
+<summary>Update tests and documentation for  `ColormanagedPyblishPluginMixin` <a href="https://github.com/ynput/OpenPype/pull/4612">#4612</a></summary>
+
+Refactor `ExtractorColormanaged` to `ColormanagedPyblishPluginMixin` in tests and documentation.
+
+
+___
+
+</details>
+
+### **📃 Documentation**
+
+
+<details>
+<summary>Docs/add architecture document <a href="https://github.com/ynput/OpenPype/pull/4344">#4344</a></summary>
+
+<strong>Add `ARCHITECTURE.md` document.
+
+</strong>his document attemps to give a quick overview of the project to help onboarding, it's not an extensive documentation but more of a elevator pitch one-line descriptions of files/directories and what the attempt to do.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Docs: Fix some minor grammar/typos <a href="https://github.com/ynput/OpenPype/pull/4680">#4680</a></summary>
+
+Typo/grammar fixes in documentation.
+
+
+___
+
+</details>
+
+### **Merged pull requests**
+
+
+<details>
+<summary>Maya: Implement image file node loader <a href="https://github.com/ynput/OpenPype/pull/4313">#4313</a></summary>
+
+<strong>Implements a loader for loading texture image into a `file` node in Maya.
+
+</strong>Similar to Maya's hypershade creation of textures on load you have the option to choose for three modes of creating:
+- Texture
+- Projection
+- StencilThese should match what Maya generates if you create those in Maya.
+- [x] Load and manage file nodes
+- [x] Apply color spaces after #4195
+- [x] Support for _either_ UDIM or image sequence - currently it seems to always load sequences as UDIM automatically.
+- [ ] Add support for animation sequences of UDIM textures using the `<f>.<udim>.exr` path format?
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Maya Look Assigner: Don't rely on containers for get all assets <a href="https://github.com/ynput/OpenPype/pull/4600">#4600</a></summary>
+
+This resolves #4044 by not actually relying on containers in the scene but instead just rely on finding nodes with `cbId` attributes. As such, imported nodes would also be found and a shader can be assigned (similar to when using get from selection).**Please take into consideration the potential downsides below**Potential downsides would be:
+- IF an already loaded look has any dagNodes, say a 3D Projection node - then that will also show up as a loaded asset where previously nodes from loaded looks were ignored.
+- If any dag nodes were created locally - they would have gotten `cbId` attributes on scene save and thus the current asset would almost always show?
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Maya: Unify menu labels for "Set Frame Range" and "Set Resolution" <a href="https://github.com/ynput/OpenPype/pull/4605">#4605</a></summary>
+
+Fix #4109: Unify menu labels for "Set Frame Range" and "Set Resolution"This also tweaks it in Houdini from Reset Frame Range to Set Frame Range.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>3dsmax: make sure that startup script executes <a href="https://github.com/ynput/OpenPype/pull/4695">#4695</a></summary>
+
+Fixing reliability of OpenPype startup in 3dsmax.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Resolve missing OPENPYPE_MONGO in deadline global job preload  <a href="https://github.com/ynput/OpenPype/pull/4484">#4484</a></summary>
+
+<strong>In the GlobalJobPreLoad plugin, we propose to replace the SpawnProcess by a sub-process and to pass the environment variables in the parameters, since the SpawnProcess under Centos Linux does not pass the environment variables.
+
+</strong>In the GlobalJobPreLoad plugin, the Deadline SpawnProcess is used to start the OpenPype process. The problem is that the SpawnProcess does not pass environment variables, including OPENPYPE_MONGO, to the process when it is under Centos7 linux, and the process gets stuck. We propose to replace it by a subprocess and to pass the variable in the parameters.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Maya: Arnold don't reset maya timeline frame range on render creation (or setting render settings) <a href="https://github.com/ynput/OpenPype/pull/4603">#4603</a></summary>
+
+Fix #4429: Do not reset fps or playback timeline on applying or creating render settings
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Update artist_hosts_maya_arnold.md <a href="https://github.com/ynput/OpenPype/pull/4626">#4626</a></summary>
+
+Correct Arnold docs.
+___
+
+</details>
+
+
+<details>
+<summary>General: Filter available applications <a href="https://github.com/ynput/OpenPype/pull/4667">#4667</a></summary>
+
+Added option to filter applications that don't have valid executable available in settings in launcher and ftrack actions. This option can be disabled in new settings category `Applications`. The filtering is by default disabled.
+
+
+___
+
+</details>
+
+
+
+
 [Full Changelog](https://github.com/ynput/OpenPype/compare/3.15.1...3.15.2)
 
 ### **🆕 New features**
diff --git a/openpype/version.py b/openpype/version.py
index bc5ea7fe7c..b20b133914 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.15.3-nightly.4"
+__version__ = "3.15.3"
diff --git a/pyproject.toml b/pyproject.toml
index 02370a4f10..42ce5aa32c 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.15.2" # OpenPype
+version = "3.15.3" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From c758ec151fa93c8d43e3a0adc95d8cc6326edd7a Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Tue, 28 Mar 2023 12:57:44 +0200
Subject: [PATCH 149/151] fix action trigger to be only changes_requested

---
 .github/workflows/project_actions.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/project_actions.yml b/.github/workflows/project_actions.yml
index ca94f3ae77..26bc2b8a1f 100644
--- a/.github/workflows/project_actions.yml
+++ b/.github/workflows/project_actions.yml
@@ -10,7 +10,7 @@ jobs:
   pr_review_requested:
     name: pr_review_requested
     runs-on: ubuntu-latest
-    if: github.event_name == 'pull_request' && github.event.action == 'review_requested'
+    if: github.event_name == 'pull_request_review' && github.event.review.state == 'changes_requested'
     steps:
       - name: Move PR to 'Change Requested'
         uses: leonsteinhaeuser/project-beta-automations@v2.1.0

From 51cf5d2436932988fc1c2218ed1c1aec537b065a Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Tue, 28 Mar 2023 15:16:57 +0200
Subject: [PATCH 150/151] updating changelog.md

---
 CHANGELOG.md | 602 ++++++++++++++++++++++++++++++++++++---------------
 1 file changed, 430 insertions(+), 172 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 78ea53f3d0..4e22b783c4 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,11 +1,26 @@
 # Changelog
 
+## [3.15.3](https://github.com/ynput/OpenPype/tree/3.15.3)
+
 
 [Full Changelog](https://github.com/ynput/OpenPype/compare/3.15.2...3.15.3)
 
 ### **🆕 New features**
 
 
+<details>
+<summary>Blender: Extract Review <a href="https://github.com/ynput/OpenPype/pull/3616">#3616</a></summary>
+
+<strong>Added Review to Blender.
+
+</strong>This implementation is based on #3508 but made compatible for the current implementation of OpenPype for Blender.
+
+
+___
+
+</details>
+
+
 <details>
 <summary>Data Exchanges: Point Cloud for 3dsMax <a href="https://github.com/ynput/OpenPype/pull/4532">#4532</a></summary>
 
@@ -23,30 +38,6 @@ ___
 </details>
 
 
-<details>
-<summary>MaxScene Family  <a href="https://github.com/ynput/OpenPype/pull/4615">#4615</a></summary>
-
-Introduction of the Max Scene Family
-
-
-___
-
-</details>
-
-
-<details>
-<summary>Blender: Extract Review <a href="https://github.com/ynput/OpenPype/pull/3616">#3616</a></summary>
-
-<strong>Added Review to Blender.
-
-</strong>This implementation is based on #3508 but made compatible for the current implementation of OpenPype for Blender.
-
-
-___
-
-</details>
-
-
 <details>
 <summary>Global: persistent staging directory for renders <a href="https://github.com/ynput/OpenPype/pull/4583">#4583</a></summary>
 
@@ -55,6 +46,28 @@ ___
 </strong>With this feature, users can specify a transient data folder path based on presets, which can be used during the creation and publishing stages. In some cases, these DCCs automatically add a rendering path during the creation stage, which is then used in publishing.One of the key advantages of this feature is that it allows users to take advantage of faster storages for rendering, which can help improve workflow efficiency. Additionally, this feature allows users to keep their rendered data persistent, and use their own infrastructure for regular cleaning.However, it should be noted that some productions may want to use this feature without persistency. Furthermore, there may be a need for retargeting the rendering folder to faster storages, which is also not supported at the moment.It is studio responsibility to clean up obsolete folders with data.Location of the folder is configured in `project_anatomy/templates/others`. ('transient' key is expected, with 'folder' key, could be more templates)Which family/task type/subset is applicable is configured in:`project_settings/global/tools/publish/transient_dir_profiles`
 
 
+___
+
+</details>
+
+
+<details>
+<summary>Kitsu custom comment template <a href="https://github.com/ynput/OpenPype/pull/4599">#4599</a></summary>
+
+Kitsu allows to write markdown in its comment field. This can be something very powerful to deliver dynamic comments with the help the data from the instance.This feature is defaults to off so the admin have to manually set up the comment field the way they want.I have added a basic example on how the comment can look like as the comment-fields default value.To this I want to add some documentation also but that's on its way when the code itself looks good for the reviewers.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>MaxScene Family  <a href="https://github.com/ynput/OpenPype/pull/4615">#4615</a></summary>
+
+Introduction of the Max Scene Family
+
+
 ___
 
 </details>
@@ -84,6 +97,22 @@ ___
 </details>
 
 
+<details>
+<summary>Copy existing or generate new Fusion profile on prelaunch <a href="https://github.com/ynput/OpenPype/pull/4572">#4572</a></summary>
+
+<strong>Fusion preferences will be copied to the predefined `~/.openpype/hosts/fusion/prefs` folder (or any other folder set in system settings) on launch.
+
+</strong>The idea is to create a copy of existing Fusion profile, adding an OpenPype menu to the Fusion instance.By default the copy setting is turned off, so no file copying is performed. Instead the clean Fusion profile is created by Fusion in the predefined folder. The default locaion is set to `~/.openpype/hosts/fusion/prefs`, to better comply with the other os platforms. After creating the default profile, some modifications are applied:
+- forced Python3
+- forced English interface
+- setup Openpype specific path maps.If the `copy_prefs` checkbox is toggled, a copy of existing Fusion profile folder will be placed in the mentioned location. Then they are altered the same way as described above. The operation is run only once, on the first launch, unless the `force_sync [Resync profile on each launch]` is toggled.English interface is forced because the `FUSION16_PROFILE_DIR` environment variable is not read otherwise (seems to be a Fusion bug).
+
+
+___
+
+</details>
+
+
 <details>
 <summary>Houdini: Create button open new publisher's "create" tab <a href="https://github.com/ynput/OpenPype/pull/4601">#4601</a></summary>
 
@@ -95,6 +124,28 @@ ___
 </details>
 
 
+<details>
+<summary>Clockify: refresh and fix the integration <a href="https://github.com/ynput/OpenPype/pull/4607">#4607</a></summary>
+
+Due to recent API changes, Clockify requires `user_id` to operate with the timers. I updated this part and currently it is a WIP for making it fully functional. Most functions, such as start and stop timer, and projects sync are currently working. For the rate limiting task new dependency is added: https://pypi.org/project/ratelimiter/
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Fusion publish existing frames <a href="https://github.com/ynput/OpenPype/pull/4611">#4611</a></summary>
+
+This PR adds the function to publish existing frames instead of having to re-render all of them for each new publish.I have split the render_locally plugin so the review-part is its own plugin now.I also change the saver-creator-plugin's label from Saver to Render (saver) as I intend to add a Prerender creator like in Nuke.
+
+
+___
+
+</details>
+
+
 <details>
 <summary>Resolution settings referenced from DB record for 3dsMax <a href="https://github.com/ynput/OpenPype/pull/4652">#4652</a></summary>
 
@@ -107,6 +158,17 @@ ___
 </details>
 
 
+<details>
+<summary>3dsmax: render instance settings in Publish tab <a href="https://github.com/ynput/OpenPype/pull/4658">#4658</a></summary>
+
+Allows user preset the pools, group and use_published settings in Render Creator in the Max Hosts.User can set the settings before or after creating instance in the new publisher
+
+
+___
+
+</details>
+
+
 <details>
 <summary>scene length setting referenced from DB record for 3dsMax <a href="https://github.com/ynput/OpenPype/pull/4665">#4665</a></summary>
 
@@ -118,55 +180,6 @@ ___
 </details>
 
 
-<details>
-<summary>increment workfile version 3dsmax <a href="https://github.com/ynput/OpenPype/pull/4685">#4685</a></summary>
-
-increment workfile version in 3dsmax as if in blender and maya hosts.
-
-
-___
-
-</details>
-
-
-<details>
-<summary>Copy existing or generate new Fusion profile on prelaunch <a href="https://github.com/ynput/OpenPype/pull/4572">#4572</a></summary>
-
-<strong>Fusion preferences will be copied to the predefined `~/.openpype/hosts/fusion/prefs` folder (or any other folder set in system settings) on launch.
-
-</strong>The idea is to create a copy of existing Fusion profile, adding an OpenPype menu to the Fusion instance.By default the copy setting is turned off, so no file copying is performed. Instead the clean Fusion profile is created by Fusion in the predefined folder. The default locaion is set to `~/.openpype/hosts/fusion/prefs`, to better comply with the other os platforms. After creating the default profile, some modifications are applied:
-- forced Python3
-- forced English interface
-- setup Openpype specific path maps.If the `copy_prefs` checkbox is toggled, a copy of existing Fusion profile folder will be placed in the mentioned location. Then they are altered the same way as described above. The operation is run only once, on the first launch, unless the `force_sync [Resync profile on each launch]` is toggled.English interface is forced because the `FUSION16_PROFILE_DIR` environment variable is not read otherwise (seems to be a Fusion bug).
-
-
-___
-
-</details>
-
-
-<details>
-<summary>Fusion publish existing frames <a href="https://github.com/ynput/OpenPype/pull/4611">#4611</a></summary>
-
-This PR adds the function to publish existing frames instead of having to re-render all of them for each new publish.I have split the render_locally plugin so the review-part is its own plugin now.I also change the saver-creator-plugin's label from Saver to Render (saver) as I intend to add a Prerender creator like in Nuke.
-
-
-___
-
-</details>
-
-
-<details>
-<summary>Clockify: refresh and fix the integration <a href="https://github.com/ynput/OpenPype/pull/4607">#4607</a></summary>
-
-Due to recent API changes, Clockify requires `user_id` to operate with the timers. I updated this part and currently it is a WIP for making it fully functional. Most functions, such as start and stop timer, and projects sync are currently working. For the rate limiting task new dependency is added: https://pypi.org/project/ratelimiter/
-
-
-___
-
-</details>
-
-
 <details>
 <summary>Publisher: Windows reduce command window pop-ups during Publishing <a href="https://github.com/ynput/OpenPype/pull/4672">#4672</a></summary>
 
@@ -178,6 +191,17 @@ ___
 </details>
 
 
+<details>
+<summary>Publisher: Explicit save <a href="https://github.com/ynput/OpenPype/pull/4676">#4676</a></summary>
+
+Publisher have explicit button to save changes, so reset can happen without saving any changes. Save still happens automatically when publishing is started or on publisher window close. But a popup is shown if context of host has changed. Important context was enhanced by workfile path (if host integration supports it) so workfile changes are captured too. In that case a dialog with confirmation is shown to user. All callbacks that may require save of context were moved to main window to be able handle dialog show at one place. Save changes now returns success so the rest of logic is skipped -> publishing won't start, when save of instances fails.Save and reset buttons have shortcuts (Ctrl + s and Ctrls + r).
+
+
+___
+
+</details>
+
+
 <details>
 <summary>CelAction: conditional workfile parameters from settings <a href="https://github.com/ynput/OpenPype/pull/4677">#4677</a></summary>
 
@@ -189,12 +213,45 @@ ___
 </details>
 
 
+<details>
+<summary>Improve logging of used app + tool envs on application launch <a href="https://github.com/ynput/OpenPype/pull/4682">#4682</a></summary>
+
+Improve logging of what apps + tool environments got loaded for an application launch.
+
+
+___
+
+</details>
+
+
 <details>
 <summary>Fix name and docstring for Create Workdir Extra Folders prelaunch hook <a href="https://github.com/ynput/OpenPype/pull/4683">#4683</a></summary>
 
 Fix class name and docstring for Create Workdir Extra Folders prelaunch hookThe class name and docstring were originally copied from another plug-in and didn't match the plug-in logic.This also fixes potentially seeing this twice in your logs. Before:After:Where it was actually running both this prelaunch hook and the actual `AddLastWorkfileToLaunchArgs` plugin.
 
 
+___
+
+</details>
+
+
+<details>
+<summary>Application launch context: Include app group name in logger <a href="https://github.com/ynput/OpenPype/pull/4684">#4684</a></summary>
+
+Clarify in logs better what app group the ApplicationLaunchContext belongs to and what application is being launched.Before:After:
+
+
+___
+
+</details>
+
+
+<details>
+<summary>increment workfile version 3dsmax <a href="https://github.com/ynput/OpenPype/pull/4685">#4685</a></summary>
+
+increment workfile version in 3dsmax as if in blender and maya hosts.
+
+
 ___
 
 </details>
@@ -301,9 +358,64 @@ ___
 
 
 <details>
-<summary>Fixed a bug where a QThread in the splash screen could be destroyed before finishing execution <a href="https://github.com/ynput/OpenPype/pull/4647">#4647</a></summary>
+<summary>Maya: tile assembly fail in draft - OP-4820 <a href="https://github.com/ynput/OpenPype/pull/4416">#4416</a></summary>
 
-This should fix the occasional behavior of the QThread being destroyed before even its worker returns from the `run()` function.After quiting, it should wait for the QThread object to properly close itself.
+<strong>Tile assembly in Deadline was broken.
+
+</strong>Initial bug report revealed other areas of the tile assembly that needed fixing.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Maya: Yeti Validate Rig Input - OP-3454 <a href="https://github.com/ynput/OpenPype/pull/4554">#4554</a></summary>
+
+<strong>Fix Yeti Validate Rig Input
+
+</strong>Existing workflow was broken due to this #3297.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Scene inventory: Fix code errors when "not found" entries are found <a href="https://github.com/ynput/OpenPype/pull/4594">#4594</a></summary>
+
+Whenever a "NOT FOUND" entry is present a lot of errors happened in the Scene Inventory:
+- It started spamming a lot of errors for the VersionDelegate since it had no numeric version (no version at all).Error reported on Discord:
+```python
+Traceback (most recent call last):
+  File "C:\Users\videopro\Documents\github\OpenPype\openpype\tools\utils\delegates.py", line 65, in paint
+    text = self.displayText(
+  File "C:\Users\videopro\Documents\github\OpenPype\openpype\tools\utils\delegates.py", line 33, in displayText
+    assert isinstance(value, numbers.Integral), (
+AssertionError: Version is not integer. "None" <class 'NoneType'>
+```
+- Right click menu would error on NOT FOUND entries, and thus not show. With this PR it will now _disregard_ not found items for "Set version" and "Remove" but still allow actions.This PR resolves those.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Kitsu: Sync OP with zou, make sure value-data is int or float <a href="https://github.com/ynput/OpenPype/pull/4596">#4596</a></summary>
+
+Currently the data zou pulls is a string and not a value causing some bugs in the pipe where a value is expected (like `Set frame range` in Fusion).
+
+
+
+This PR makes sure each value is set with int() or float() so these bugs can't happen later on.
+
+
+
+_(A request to cgwire has also bin sent to allow force values only for some metadata columns, but currently the user can enter what ever they want in there)_
 
 
 ___
@@ -322,6 +434,39 @@ ___
 </details>
 
 
+<details>
+<summary>Global | Nuke: fixing farm publishing workflow <a href="https://github.com/ynput/OpenPype/pull/4623">#4623</a></summary>
+
+After Nuke had adopted new publisher with new creators new issues were introduced. Those issues were addressed with this PR. Those are for example broken reviewable video files publishing if published via farm. Also fixed local publishing.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Ftrack: Ftrack additional families filtering <a href="https://github.com/ynput/OpenPype/pull/4633">#4633</a></summary>
+
+Ftrack family collector makes sure the subset family is also in instance families for additional families filtering.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Ftrack: Hierarchical <> Non-Hierarchical attributes sync fix <a href="https://github.com/ynput/OpenPype/pull/4635">#4635</a></summary>
+
+Sync between hierarchical and non-hierarchical attributes should be fixed and work as expected. Action should sync the values as expected and event handler should do it too and only on newly created entities.
+
+
+___
+
+</details>
+
+
 <details>
 <summary>bugfix for 3dsmax publishing error <a href="https://github.com/ynput/OpenPype/pull/4637">#4637</a></summary>
 
@@ -333,6 +478,17 @@ ___
 </details>
 
 
+<details>
+<summary>General: Use right validation for ffmpeg executable <a href="https://github.com/ynput/OpenPype/pull/4640">#4640</a></summary>
+
+Use ffmpeg exec validation for ffmpeg executables instead of oiio exec validation. The validation is used as last possible source of ffmpeg from `PATH` environment variables, which is an edge case but can cause issues.
+
+
+___
+
+</details>
+
+
 <details>
 <summary>3dsmax: opening last workfile <a href="https://github.com/ynput/OpenPype/pull/4644">#4644</a></summary>
 
@@ -345,9 +501,53 @@ ___
 
 
 <details>
-<summary>Global | Nuke: fixing farm publishing workflow <a href="https://github.com/ynput/OpenPype/pull/4623">#4623</a></summary>
+<summary>Fixed a bug where a QThread in the splash screen could be destroyed before finishing execution <a href="https://github.com/ynput/OpenPype/pull/4647">#4647</a></summary>
 
-After Nuke had adopted new publisher with new creators new issues were introduced. Those issues were addressed with this PR. Those are for example broken reviewable video files publishing if published via farm. Also fixed local publishing.
+This should fix the occasional behavior of the QThread being destroyed before even its worker returns from the `run()` function.After quiting, it should wait for the QThread object to properly close itself.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>General: Use right plugin class for Collect Comment <a href="https://github.com/ynput/OpenPype/pull/4653">#4653</a></summary>
+
+Collect Comment plugin is instance plugin so should inherit from `InstancePlugin` instead of `ContextPlugin`.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Global: add tags field to thumbnail representation <a href="https://github.com/ynput/OpenPype/pull/4660">#4660</a></summary>
+
+Thumbnail representation might be missing tags field.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Integrator: Enforce unique destination transfers, disallow overwrites in queued transfers <a href="https://github.com/ynput/OpenPype/pull/4662">#4662</a></summary>
+
+Fix #4656 by enforcing unique destination transfers in the Integrator. It's now disallowed to a destination in the file transaction queue with a new source path during the publish.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Hiero: Creator with correct workfile numeric padding input <a href="https://github.com/ynput/OpenPype/pull/4666">#4666</a></summary>
+
+Creator was showing 99 in workfile input for long time, even if users set default value to 1001 in studio settings. This has been fixed now.
 
 
 ___
@@ -377,95 +577,6 @@ ___
 </details>
 
 
-<details>
-<summary>Hiero: Creator with correct workfile numeric padding input <a href="https://github.com/ynput/OpenPype/pull/4666">#4666</a></summary>
-
-Creator was showing 99 in workfile input for long time, even if users set default value to 1001 in studio settings. This has been fixed now.
-
-
-___
-
-</details>
-
-
-<details>
-<summary>Hiero: correct container colors if UpToDate <a href="https://github.com/ynput/OpenPype/pull/4708">#4708</a></summary>
-
-Colors on loaded containers are now correctly identifying real state of version. `Red` for out of date and `green` for up to date.
-
-
-___
-
-</details>
-
-
-<details>
-<summary>Maya: tile assembly fail in draft - OP-4820 <a href="https://github.com/ynput/OpenPype/pull/4416">#4416</a></summary>
-
-<strong>Tile assembly in Deadline was broken.
-
-</strong>Initial bug report revealed other areas of the tile assembly that needed fixing.
-
-
-___
-
-</details>
-
-
-<details>
-<summary>Scene inventory: Fix code errors when "not found" entries are found <a href="https://github.com/ynput/OpenPype/pull/4594">#4594</a></summary>
-
-Whenever a "NOT FOUND" entry is present a lot of errors happened in the Scene Inventory:
-- It started spamming a lot of errors for the VersionDelegate since it had no numeric version (no version at all).Error reported on Discord:
-```python
-Traceback (most recent call last):
-  File "C:\Users\videopro\Documents\github\OpenPype\openpype\tools\utils\delegates.py", line 65, in paint
-    text = self.displayText(
-  File "C:\Users\videopro\Documents\github\OpenPype\openpype\tools\utils\delegates.py", line 33, in displayText
-    assert isinstance(value, numbers.Integral), (
-AssertionError: Version is not integer. "None" <class 'NoneType'>
-```
-- Right click menu would error on NOT FOUND entries, and thus not show. With this PR it will now _disregard_ not found items for "Set version" and "Remove" but still allow actions.This PR resolves those.
-
-
-___
-
-</details>
-
-
-<details>
-<summary>Ftrack: Ftrack additional families filtering <a href="https://github.com/ynput/OpenPype/pull/4633">#4633</a></summary>
-
-Ftrack family collector makes sure the subset family is also in instance families for additional families filtering.
-
-
-___
-
-</details>
-
-
-<details>
-<summary>General: Use right validation for ffmpeg executable <a href="https://github.com/ynput/OpenPype/pull/4640">#4640</a></summary>
-
-Use ffmpeg exec validation for ffmpeg executables instead of oiio exec validation. The validation is used as last possible source of ffmpeg from `PATH` environment variables, which is an edge case but can cause issues.
-
-
-___
-
-</details>
-
-
-<details>
-<summary>Global: add tags field to thumbnail representation <a href="https://github.com/ynput/OpenPype/pull/4660">#4660</a></summary>
-
-Thumbnail representation might be missing tags field.
-
-
-___
-
-</details>
-
-
 <details>
 <summary>Kitsu: Slightly less strict with instance data <a href="https://github.com/ynput/OpenPype/pull/4678">#4678</a></summary>
 
@@ -479,12 +590,34 @@ ___
 </details>
 
 
+<details>
+<summary>Publisher: Fix reset shortcut sequence <a href="https://github.com/ynput/OpenPype/pull/4694">#4694</a></summary>
+
+Fix bug created in https://github.com/ynput/OpenPype/pull/4676 where key sequence is checked using unsupported method. The check was changed to convert event into `QKeySequence` object which can be compared to prepared sequence.
+
+
+___
+
+</details>
+
+
 <details>
 <summary>Refactor _capture <a href="https://github.com/ynput/OpenPype/pull/4702">#4702</a></summary>
 
 Paragraphs contain detailed information on the changes made to the product or service, providing an in-depth description of the updates and enhancements. They can be used to explain the reasoning behind the changes, or to highlight the importance of the new features. Paragraphs can often include links to further information or support documentation.
 
 
+___
+
+</details>
+
+
+<details>
+<summary>Hiero: correct container colors if UpToDate <a href="https://github.com/ynput/OpenPype/pull/4708">#4708</a></summary>
+
+Colors on loaded containers are now correctly identifying real state of version. `Red` for out of date and `green` for up to date.
+
+
 ___
 
 </details>
@@ -529,12 +662,34 @@ ___
 </details>
 
 
+<details>
+<summary>Maya: Replace last usages of Qt module <a href="https://github.com/ynput/OpenPype/pull/4610">#4610</a></summary>
+
+Replace last usage of `Qt` module with `qtpy`. This change is needed for `PySide6` support. All changes happened in Maya loader plugins.
+
+
+___
+
+</details>
+
+
 <details>
 <summary>Update tests and documentation for  `ColormanagedPyblishPluginMixin` <a href="https://github.com/ynput/OpenPype/pull/4612">#4612</a></summary>
 
 Refactor `ExtractorColormanaged` to `ColormanagedPyblishPluginMixin` in tests and documentation.
 
 
+___
+
+</details>
+
+
+<details>
+<summary>Improve logging of used app + tool envs on application launch (minor tweak) <a href="https://github.com/ynput/OpenPype/pull/4686">#4686</a></summary>
+
+Use `app.full_name` for change done in #4682
+
+
 ___
 
 </details>
@@ -555,6 +710,17 @@ ___
 </details>
 
 
+<details>
+<summary>Documentation: Tweak grammar and fix some typos <a href="https://github.com/ynput/OpenPype/pull/4613">#4613</a></summary>
+
+This resolves some grammar and typos in the documentation.Also fixes the extension of some images in after effects docs which used uppercase extension even though files were lowercase extension.
+
+
+___
+
+</details>
+
+
 <details>
 <summary>Docs: Fix some minor grammar/typos <a href="https://github.com/ynput/OpenPype/pull/4680">#4680</a></summary>
 
@@ -613,9 +779,11 @@ ___
 
 
 <details>
-<summary>3dsmax: make sure that startup script executes <a href="https://github.com/ynput/OpenPype/pull/4695">#4695</a></summary>
+<summary>Resolve missing OPENPYPE_MONGO in deadline global job preload  <a href="https://github.com/ynput/OpenPype/pull/4484">#4484</a></summary>
 
-Fixing reliability of OpenPype startup in 3dsmax.
+<strong>In the GlobalJobPreLoad plugin, we propose to replace the SpawnProcess by a sub-process and to pass the environment variables in the parameters, since the SpawnProcess under Centos Linux does not pass the environment variables.
+
+</strong>In the GlobalJobPreLoad plugin, the Deadline SpawnProcess is used to start the OpenPype process. The problem is that the SpawnProcess does not pass environment variables, including OPENPYPE_MONGO, to the process when it is under Centos7 linux, and the process gets stuck. We propose to replace it by a subprocess and to pass the variable in the parameters.
 
 
 ___
@@ -624,11 +792,9 @@ ___
 
 
 <details>
-<summary>Resolve missing OPENPYPE_MONGO in deadline global job preload  <a href="https://github.com/ynput/OpenPype/pull/4484">#4484</a></summary>
+<summary>Tests: Added setup_only to tests <a href="https://github.com/ynput/OpenPype/pull/4591">#4591</a></summary>
 
-<strong>In the GlobalJobPreLoad plugin, we propose to replace the SpawnProcess by a sub-process and to pass the environment variables in the parameters, since the SpawnProcess under Centos Linux does not pass the environment variables.
-
-</strong>In the GlobalJobPreLoad plugin, the Deadline SpawnProcess is used to start the OpenPype process. The problem is that the SpawnProcess does not pass environment variables, including OPENPYPE_MONGO, to the process when it is under Centos7 linux, and the process gets stuck. We propose to replace it by a subprocess and to pass the variable in the parameters.
+Allows to download test zip, unzip and restore DB in preparation for new test.
 
 
 ___
@@ -647,6 +813,64 @@ ___
 </details>
 
 
+<details>
+<summary>Bump @sideway/formula from 3.0.0 to 3.0.1 in /website <a href="https://github.com/ynput/OpenPype/pull/4609">#4609</a></summary>
+
+Bumps [@sideway/formula](https://github.com/sideway/formula) from 3.0.0 to 3.0.1.
+<details>
+<summary>Commits</summary>
+<ul>
+<li><a href="https://github.com/hapijs/formula/commit/5b44c1bffc38135616fb91d5ad46eaf64f03d23b"><code>5b44c1b</code></a> 3.0.1</li>
+<li><a href="https://github.com/hapijs/formula/commit/9fbc20a02d75ae809c37a610a57802cd1b41b3fe"><code>9fbc20a</code></a> chore: better number regex</li>
+<li><a href="https://github.com/hapijs/formula/commit/41ae98e0421913b100886adb0107a25d552d9e1a"><code>41ae98e</code></a> Cleanup</li>
+<li><a href="https://github.com/hapijs/formula/commit/c59f35ec401e18cead10e0cedfb44291517610b1"><code>c59f35e</code></a> Move to Sideway</li>
+<li>See full diff in <a href="https://github.com/sideway/formula/compare/v3.0.0...v3.0.1">compare view</a></li>
+</ul>
+</details>
+<details>
+<summary>Maintainer changes</summary>
+<p>This version was pushed to npm by <a href="https://www.npmjs.com/~marsup">marsup</a>, a new releaser for <code>@​sideway/formula</code> since your current version.</p>
+</details>
+<br />
+
+
+[![Dependabot compatibility score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=@sideway/formula&package-manager=npm_and_yarn&previous-version=3.0.0&new-version=3.0.1)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores)
+
+Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting `@dependabot rebase`.
+
+[//]: # (dependabot-automerge-start)
+[//]: # (dependabot-automerge-end)
+
+---
+
+<details>
+<summary>Dependabot commands and options</summary>
+<br />
+
+You can trigger Dependabot actions by commenting on this PR:
+- `@dependabot rebase` will rebase this PR
+- `@dependabot recreate` will recreate this PR, overwriting any edits that have been made to it
+- `@dependabot merge` will merge this PR after your CI passes on it
+- `@dependabot squash and merge` will squash and merge this PR after your CI passes on it
+- `@dependabot cancel merge` will cancel a previously requested merge and block automerging
+- `@dependabot reopen` will reopen this PR if it is closed
+- `@dependabot close` will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
+- `@dependabot ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
+- `@dependabot ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
+- `@dependabot ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)
+- `@dependabot use these labels` will set the current labels as the default for future PRs for this repo and language
+- `@dependabot use these reviewers` will set the current reviewers as the default for future PRs for this repo and language
+- `@dependabot use these assignees` will set the current assignees as the default for future PRs for this repo and language
+- `@dependabot use this milestone` will set the current milestone as the default for future PRs for this repo and language
+
+You can disable automated security fix PRs for this repo from the [Security Alerts page](https://github.com/ynput/OpenPype/network/alerts).
+
+</details>
+___
+
+</details>
+
+
 <details>
 <summary>Update artist_hosts_maya_arnold.md <a href="https://github.com/ynput/OpenPype/pull/4626">#4626</a></summary>
 
@@ -656,6 +880,17 @@ ___
 </details>
 
 
+<details>
+<summary>Maya: Add "Include Parent Hierarchy" option in animation creator plugin <a href="https://github.com/ynput/OpenPype/pull/4645">#4645</a></summary>
+
+Add an option in Project Settings > Maya > Creator Plugins > Create Animation to include (or not) parent hierarchy. This is to avoid artists to check manually the option for all create animation.
+
+
+___
+
+</details>
+
+
 <details>
 <summary>General: Filter available applications <a href="https://github.com/ynput/OpenPype/pull/4667">#4667</a></summary>
 
@@ -667,7 +902,30 @@ ___
 </details>
 
 
+<details>
+<summary>3dsmax: make sure that startup script executes <a href="https://github.com/ynput/OpenPype/pull/4695">#4695</a></summary>
 
+Fixing reliability of OpenPype startup in 3dsmax.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Project Manager: Change minimum frame start/end to '0' <a href="https://github.com/ynput/OpenPype/pull/4719">#4719</a></summary>
+
+Project manager can have frame start/end set to `0`.
+
+
+___
+
+</details>
+
+
+
+## [3.15.2](https://github.com/ynput/OpenPype/tree/3.15.2)
 
 [Full Changelog](https://github.com/ynput/OpenPype/compare/3.15.1...3.15.2)
 

From ba1e033815f25d9d9f30a110b3a0cdfc81f3ae36 Mon Sep 17 00:00:00 2001
From: Ynbot <bot@ynput.io>
Date: Wed, 29 Mar 2023 03:26:05 +0000
Subject: [PATCH 151/151] [Automated] Bump version

---
 openpype/version.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/version.py b/openpype/version.py
index b20b133914..4d6ee5590e 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.15.3"
+__version__ = "3.15.4-nightly.1"