From 314f789bc91e30a4ddd646225a4442faf3725a8b Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 16 Mar 2022 11:22:10 +0100
Subject: [PATCH 001/108] initial commit of publishing development docs

---
 website/docs/dev_publishing.md | 390 +++++++++++++++++++++++++++++++++
 website/sidebars.js            |   9 +-
 2 files changed, 398 insertions(+), 1 deletion(-)
 create mode 100644 website/docs/dev_publishing.md

diff --git a/website/docs/dev_publishing.md b/website/docs/dev_publishing.md
new file mode 100644
index 0000000000..0808818456
--- /dev/null
+++ b/website/docs/dev_publishing.md
@@ -0,0 +1,390 @@
+---
+id: dev_publishing
+title: Publishing
+sidebar_label: Publishing
+---
+
+Publishing workflow consist of 2 parts:
+- Creation - Mark what will be published and how.
+- Publishing - Use data from creation to go through pyblish process.
+
+OpenPype is using `pyblish` for publishing process. It is a little bit extented and modified mainly for UI purposes. The main differences are that OpenPype's publish UI allows to enable/disable instances or plugins during creation part instead of in publishing part and has limited actions only for failed validator plugins.
+
+# Creation
+Concept of creation does not have to "create" anything but prepare and store metadata about an "instance". Created instance always has `family` which defines what kind of data will be published, best example is `workfile` family. Storing of metadata is host specific and may be even a Creator plugin specific. In most of hosts are metadata stored to workfile (Maya scene, Nuke script, etc.) to an item or a node the same way so consistency of host implementation is kept, but some features may require different approach. Storing data to workfile gives ability to keep values so artist does not have to do create instances over and over.
+
+## Created instance
+Objected representation of created instance metadata defined by class **CreatedInstance**. Has access to **CreateContext** and **BaseCreator** that initialized the object. Is dictionary like object with few immutable keys (maked with start `*`) that are defined by creator plugin or create context on initialization. Can have more arbitrary data but keep in mind that some keys are reserved.
+
+| Key | Type | Description |
+|---|---|---|
+| *id | str | Identifier of metadata type. ATM constant **"pyblish.avalon.instance"** |
+| *instance_id | str | Unique ID of instance. Set automatically on instance creation using `str(uuid.uuid4())` |
+| *family | str | Instance's family representing type defined by creator plugin. |
+| *creator_identifier | str | Identifier of creator that collected/created the instance. |
+| *creator_attributes | dict | Dictionary of attributes that are defined by creator plugin (`get_instance_attr_defs`). |
+| *publish_attributes | dict | Dictionary of attributes that are defined by publish plugins. |
+| variant | str | Variant is entered by artist on creation and may affect **subset**. |
+| subset | str | Name of instance. This name will be used as subset name during publishing. |
+| active | bool | Is instance active and will be published or not. |
+| asset | str | Name of asset in which context was created. |
+| task | str | Name of task in which context was created. Can be set to `None`. |
+
+Task should not be required until subset name template expect it.
+
+## Create plugin
+Main responsibility of create plugin is to create, update, collect and remove instance metadata and propagate changes to create context. Has access to **CreateContext** (`self.create_context`) that discovered the plugin so has also access to other creators and instances.
+
+### BaseCreator
+Base implementation of creator plugin. It is not recommended to use this class as base for production plugins but rather use one of **AutoCreator** and **Creator** variants.
+
+**Abstractions**
+- **`family`** (class attr) - Tells what kind of instance will be created.
+```python
+class WorkfileCreator(Creator):
+    family = "workfile"
+```
+
+- **`collect_instances`** (method) - Collect already existing instances from workfile and add them to create context. This method is called on initialization or reset of **CreateContext**. Each creator is responsible to find it's instances metadata, convert them to **CreatedInstance** object and add the to create context (`self._add_instance_to_context(instnace_obj)`).
+```python
+def collect_instances(self):
+    # Using 'pipeline.list_instances' is just example how to get existing instances from scene
+    # - getting existing instances is different per host implementation
+    for instance_data in pipeline.list_instances():
+        # Process only instances that were created by this creator
+        creator_id = instance_data.get("creator_identifier")
+        if creator_id == self.identifier:
+            # Create instance object from existing data
+            instance = CreatedInstance.from_existing(
+                instance_data, self
+            )
+            # Add instance to create context
+            self._add_instance_to_context(instance)
+```
+
+- **`create`** (method) - Create new object of **CreatedInstance** store it's metadata to workfile and add the instance into create context. Failed creation should raise **CreatorError** if happens error that can artist fix or give him some useful information. Trigger and implementation differs for **Creator** and **AutoCreator**.
+
+- **`update_instances`** (method) - Update data of instances. Receives tuple with **instance** and **changes**.
+```python
+def update_instances(self, update_list):
+    # Loop over changed instances
+    for instance, changes in update_list:
+        # Example possible usage of 'changes' to use different node on change
+        #   of node id in instance data (MADE UP)
+        node = None
+        if "node_id" in changes:
+            old_value, new_value = changes["node_id"]
+            if new_value is not None:
+                node = pipeline.get_node_by_id(new_value)
+
+        if node is None:
+            node = pipeline.get_node_by_instance_id(instance.id)
+        # Get node in scene that represents the instance
+        # Imprind data to a node
+        pipeline.imprint(node, instance.data_to_store())
+
+
+# Most implementations will probably ignore 'changes' completely
+def update_instances(self, update_list):
+    for instance, _ in update_list:
+        # Get node from scene
+        node = pipeline.get_node_by_instance_id(instance.id)
+        # Imprint data to node
+        pipeline.imprint(node, instance.data_to_store())
+```
+
+- **`remove_instances`** (method) - Remove instance metadata from workfile and from create context.
+```python
+# Possible way how to remove instance
+def remove_instances(self, instances):
+    for instance in instances:
+        # Remove instance metadata from workflle
+        pipeline.remove_instance(instance.id)
+        # Remove instance from create context
+        self._remove_instance_from_context(instance)
+
+
+# Default implementation of `AutoCreator`
+def remove_instances(self, instances):
+    pass
+```
+
+:::note
+When host implementation use universal way how to store and load instances you should implement host specific creator plugin base class with implemented **collect_instances**, **update_instances** and **remove_instances**.
+:::
+
+**Optional implementations**
+
+- **`enabled`** (attr) - Boolean if creator plugin is enabled and used.
+- **`identifier`** (class attr) - Consistent unique string identifier of the creator plugin. Is used to identify source plugin of existing instances. There can't be 2 creator plugins with same identifier. Default implementation returns `family` attribute.
+```python
+class RenderLayerCreator(Creator):
+    family = "render"
+    identifier = "render_layer"
+
+
+class RenderPassCreator(Creator):
+    family = "render"
+    identifier = "render_pass"
+```
+
+- **`label`** (attr) - String label of creator plugin which will showed in UI, `identifier` is used when not set. It should be possible to use html tags.
+```python
+class RenderLayerCreator(Creator):
+    label = "Render Layer"
+```
+
+- **`icon`** (attr) - Icon of creator and it's instances. Value can be a path to image file, full name of qtawesome icon, `QPixmap` or `QIcon`. For complex cases or cases when `Qt` objects are returned it is recommended to override `get_icon` method and handle the logic or import `Qt` inside the method to not break headless usage of creator plugin. For list of qtawesome icons check qtawesome github repository (look for used version in pyproject.toml).
+- **`get_icon`** (method) - Default implementation returns `self.icon`.
+```python
+class RenderLayerCreator(Creator):
+    # Use font awesome 5 icon
+    icon = "fa5.building"
+```
+
+
+- **`get_instance_attr_defs`** (method) - Attribute definitions of instance. Creator can define attribute values with default values for each instance. These attributes may affect how will be instance processed during publishing. Attribute defiitions can be used from `openpype.pipeline.lib.attribute_definitions` (NOTE: Will be moved to `openpype.lib.attribute_definitions` soon). Attribute definitions define basic type of values for different cases e.g. boolean, number, string, enumerator, etc. Their advantage is that they can be created dynamically and
+```python
+from openpype.pipeline import attribute_definitions
+
+
+class RenderLayerCreator(Creator):
+    def get_instance_attr_defs(self):
+        # Return empty list if '_allow_farm_render' is not enabled (can be set during initialization)
+        if not self._allow_farm_render:
+            return []
+        # Give artist option to change if should be rendered on farm or locally
+        return [
+            attribute_definitions.BoolDef(
+                "render_farm",
+                default=False,
+                label="Render on Farm"
+            )
+        ]
+```
+
+- **`get_subset_name`** (method) - Calculate subset name based on passed data. Data can be extended using `get_dynamic_data` method.  Default implementation is using `get_subset_name` from `openpype.lib` which is recommended.
+
+- **`get_dynamic_data`** (method) - Can be used to extend data for subset template which may be required in some cases.
+
+
+### AutoCreator
+Creator that is triggered on reset of create context. Can be used for families that are expected to be created automatically without artist interaction (e.g. **workfile**). Method `create` is triggered after collecting of all creators.
+
+:::important
+**AutoCreator** has implemented **remove_instances** to do nothing as removing of auto created instances would in most of cases lead to create new instance immediately.
+:::
+
+```python
+def __init__(
+    self, create_context, system_settings, project_settings, *args, **kwargs
+):
+    super(MyCreator, self).__init__(
+        create_context, system_settings, project_settings, *args, **kwargs
+    )
+    # Get variant value from settings
+    variant_name = (
+        project_settings["my_host"][self.identifier]["variant"]
+    ).strip()
+    if not variant_name:
+        variant_name = "Main"
+    self._variant_name = variant_name
+
+# Create does not expect any arguments
+def create(self):
+    # Look for existing instance in create  context
+    existing_instance = None
+    for instance in self.create_context.instances:
+        if instance.creator_identifier == self.identifier:
+            existing_instance = instance
+            break
+
+    # Collect current context information
+    # - variant can be filled from settings
+    variant = self._variant_name
+    # Only place where we can look for current context
+    project_name = io.Session["AVALON_PROJECT"]
+    asset_name = io.Session["AVALON_ASSET"]
+    task_name = io.Session["AVALON_TASK"]
+    host_name = io.Session["AVALON_APP"]
+
+    # Create new instance if does not exist yet
+    if existing_instance is None:
+        asset_doc = io.find_one({"type": "asset", "name": asset_name})
+        subset_name = self.get_subset_name(
+            variant, task_name, asset_doc, project_name, host_name
+        )
+        data = {
+            "asset": asset_name,
+            "task": task_name,
+            "variant": variant
+        }
+        data.update(self.get_dynamic_data(
+            variant, task_name, asset_doc, project_name, host_name
+        ))
+
+        new_instance = CreatedInstance(
+            self.family, subset_name, data, self
+        )
+        self._add_instance_to_context(new_instance)
+
+    # Update instance context if is not the same
+    elif (
+        existing_instance["asset"] != asset_name
+        or existing_instance["task"] != task_name
+    ):
+        asset_doc = io.find_one({"type": "asset", "name": asset_name})
+        subset_name = self.get_subset_name(
+            variant, task_name, asset_doc, project_name, host_name
+        )
+        existing_instance["asset"] = asset_name
+        existing_instance["task"] = task_name
+```
+
+### Creator
+Implementation of creator plugin that is triggered manually by artist in UI (or by code). Has extended options for UI purposes than **AutoCreator** and **create** method expect more arguments.
+
+- **`create_allow_context_change`** (class attr) - Allow to set context in UI before creation. Some creator may not allow it or their logic would not use the context selection (e.g. bulk creators).
+```python
+class BulkRenderCreator(Creator):
+    create_allow_context_change = False
+```
+- **`get_default_variants`** (method) - Returns list of default variants that are showed in create dialog. Uses **default_variants** by default.
+- **`default_variants`** (attr) - Attribute for default implementation of **get_default_variants**.
+
+- **`get_default_variant`** (method) - Return default variant that is prefilled in UI. By default returns `None`, in that case first item from **get_default_variants** is used if there is any or **"Main"**.
+
+- **`get_description`** (method) - Returns short string description of creator. Uses **description** by default.
+- **`description`** (attr) - Attribute for default implementation of **get_description**.
+
+- **`get_detailed_description`** (method) - Returns detailed string description of creator. Can contain markdown. Uses **detailed_description** by default.
+- **`detailed_description`** (attr) - Attribute for default implementation of **get_detailed_description**.
+
+- **`get_pre_create_attr_defs`** (method) - Similar to **get_instance_attr_defs** returns attribute definitions but they are filled before creation. When creation is called from UI the values are passed to **create** method.
+
+- **`create`** (method) - Code where creation of metadata
+
+```python
+from openpype.pipeline import attribute_definitions
+
+
+class RenderLayerCreator(Creator):
+    def __init__(
+        self, context, system_settings, project_settings, *args, **kwargs
+    ):
+        super(RenderLayerCreator, self).__init__(
+            context, system_settings, project_settings, *args, **kwargs
+        )
+        plugin_settings = (
+            project_settings["my_host"]["create"][self.__class__.__name__]
+        )
+        self._allow_farm_render = plugin_settings["allow_farm_render"]
+
+    def get_instance_attr_defs(self):
+        # Return empty list if '_allow_farm_render' is not enabled (can be set during initialization)
+        if not self._allow_farm_render:
+            return []
+        # Give artist option to change if should be rendered on farm or locally
+        return [
+            attribute_definitions.BoolDef(
+                "render_farm",
+                default=False,
+                label="Render on Farm"
+            )
+        ]
+
+    def get_pre_create_attr_defs(self):
+        return [
+            # Give user option to use selection or not
+            attribute_definitions.BoolDef(
+                "use_selection",
+                default=False,
+                label="Use selection"
+            ),
+            # Set to render on farm in creator dialog
+            # - this value is not automatically passed to instance attributes
+            #   creator must do that during creation
+            attribute_definitions.BoolDef(
+                "render_farm",
+                default=False,
+                label="Render on Farm"
+            )
+        ]
+
+    def create(self, subset_name, instance_data, pre_create_data):
+        # ARGS:
+        # - 'subset_name' - precalculated subset name
+        # - 'instance_data' - context data
+        #    - 'asset' - asset name
+        #    - 'task' - task name
+        #    - 'variant' - variant
+        #    - 'family' - instnace family
+        # Check if should use selection or not
+        if pre_create_data.get("use_selection"):
+            items = pipeline.get_selection()
+        else:
+            items = [pipeline.create_write()]
+
+        # Validations related to selection
+        if len(items) > 1:
+            raise CreatorError("Please select only single item at time.")
+
+        elif not items:
+            raise CreatorError("Nothing to create. Select at least one item.")
+
+        # Create instence object
+        new_instance = CreatedInstance(self.family, subset_name, data, self)
+        # Pass value from pre create attribute to instance
+        # - use them only when pre create date contain the data
+        if "render_farm" in pre_create_data:
+            use_farm = pre_create_data["render_farm"]
+            new_instance.creator_attributes["render_farm"] = use_farm
+
+        # Store metadata to workfile
+        pipeline.imprint(new_instance.id, new_instance.data_to_store())
+
+        # Add instance to context
+        self._add_instance_to_context(new_instance)
+```
+
+## Create context
+Controller and wrapper around creation is `CreateContext` which cares about loading  `CreatedInstance`
+
+# Publish
+OpenPype is using `pyblish` for publishing process which is a little bit extented and modified mainly for UI purposes. The main differences are that OpenPype's publish UI does not allow to enable/disable instances or plugins that can be done during creation part. Also does support actions only for validators after validation exception.
+
+## Exceptions
+OpenPype define few specific exceptions that should be used in publish plugins.
+
+### Validation exception
+Validation plugins should raise `PublishValidationError` to show to an artist what's wrong and give him actions to fix it. The exception says that error happened in plugin can be fixed by artist himself (with or without action on plugin). Any other errors will stop publishing immediately. Exception `PublishValidationError` raised after validation order has same effect as any other exception.
+
+Exception `PublishValidationError` 3 arguments:
+- **message** Which is not used in UI but for headless publishing.
+- **title** Short description of error (2-5 words). Title is used for grouping of exceptions per plugin.
+- **description** Detailed description of happened issue where markdown and html can be used.
+
+
+### Known errors
+When there is a known error that can't be fixed by user (e.g. can't connect to deadline service, etc.) `KnownPublishError` should be raise. The only difference is that it's message is shown in UI to artist otherwise a neutral message without context is shown.
+
+## Plugin extension
+Publish plugins can be extended by additional logic when inherits from `OpenPypePyblishPluginMixin` which can be used as mixin (additional inheritance of class).
+
+```python
+import pyblish.api
+from openpype.pipeline import OpenPypePyblishPluginMixin
+
+
+# Example context plugin
+class MyExtendedPlugin(
+    pyblish.api.ContextPlugin, OpenPypePyblishPluginMixin
+):
+    pass
+
+```
+
+### Extensions
+Currently only extension is ability to define attributes for instances during creation. Method `get_attribute_defs` returns attribute definitions for families defined in plugin's `families` attribute if it's instance plugin or for whole context if it's context plugin. To convert existing values (or to remove legacy values) can be implemented `convert_attribute_values`. Values of publish attributes from created instance are never removed automatically so implementing of this method is best way to remove legacy data or convert them to new data structure.
+
+Possible attribute definitions can be found in `openpype/pipeline/lib/attribute_definitions.py`.
diff --git a/website/sidebars.js b/website/sidebars.js
index 16af1e1151..fe76336e7e 100644
--- a/website/sidebars.js
+++ b/website/sidebars.js
@@ -136,6 +136,13 @@ module.exports = {
         "dev_requirements",
         "dev_build",
         "dev_testing",
-        "dev_contribute"
+        "dev_contribute",
+        {
+            type: "category",
+            label: "Hosts development",
+            items: [
+                "dev_publishing"
+            ]
+        }
      ]
 };

From b70a22e4734acefc842792fbeff5dcd11c35025d Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 16 Mar 2022 14:40:00 +0100
Subject: [PATCH 002/108] added attributes as default return value for methods

---
 openpype/pipeline/create/creator_plugins.py | 57 ++++++++++++++++++---
 1 file changed, 50 insertions(+), 7 deletions(-)

diff --git a/openpype/pipeline/create/creator_plugins.py b/openpype/pipeline/create/creator_plugins.py
index 1ac2c420a2..cae55431a9 100644
--- a/openpype/pipeline/create/creator_plugins.py
+++ b/openpype/pipeline/create/creator_plugins.py
@@ -46,6 +46,11 @@ class BaseCreator:
     # - may not be used if `get_icon` is reimplemented
     icon = None
 
+    # Instance attribute definitions that can be changed per instance
+    # - returns list of attribute definitions from
+    #       `openpype.pipeline.attribute_definitions`
+    instance_attr_defs = []
+
     def __init__(
         self, create_context, system_settings, project_settings, headless=False
     ):
@@ -56,10 +61,13 @@ class BaseCreator:
         # - we may use UI inside processing this attribute should be checked
         self.headless = headless
 
-    @abstractproperty
+    @property
     def identifier(self):
-        """Identifier of creator (must be unique)."""
-        pass
+        """Identifier of creator (must be unique).
+
+        Default implementation returns plugin's family.
+        """
+        return self.family
 
     @abstractproperty
     def family(self):
@@ -90,11 +98,39 @@ class BaseCreator:
         pass
 
     @abstractmethod
-    def collect_instances(self, attr_plugins=None):
+    def collect_instances(self):
+        """Collect existing instances related to this creator plugin.
+
+        The implementation differs on host abilities. The creator has to
+        collect metadata about instance and create 'CreatedInstance' object
+        which should be added to 'CreateContext'.
+
+        Example:
+        ```python
+        def collect_instances(self):
+            # Getting existing instances is different per host implementation
+            for instance_data in pipeline.list_instances():
+                # Process only instances that were created by this creator
+                creator_id = instance_data.get("creator_identifier")
+                if creator_id == self.identifier:
+                    # Create instance object from existing data
+                    instance = CreatedInstance.from_existing(
+                        instance_data, self
+                    )
+                    # Add instance to create context
+                    self._add_instance_to_context(instance)
+        ```
+        """
         pass
 
     @abstractmethod
     def update_instances(self, update_list):
+        """Store changes of existing instances so they can be recollected.
+
+        Args:
+            update_list(list<UpdateData>): Gets list of tuples. Each item
+                contain changed instance and it's changes.
+        """
         pass
 
     @abstractmethod
@@ -178,7 +214,7 @@ class BaseCreator:
             list<AbtractAttrDef>: Attribute definitions that can be tweaked for
                 created instance.
         """
-        return []
+        return self.instance_attr_defs
 
 
 class Creator(BaseCreator):
@@ -191,6 +227,9 @@ class Creator(BaseCreator):
     # - default_variants may not be used if `get_default_variants` is overriden
     default_variants = []
 
+    # Default variant used in 'get_default_variant'
+    default_variant = None
+
     # Short description of family
     # - may not be used if `get_description` is overriden
     description = None
@@ -204,6 +243,10 @@ class Creator(BaseCreator):
     #      e.g. for buld creators
     create_allow_context_change = True
 
+    # Precreate attribute definitions showed before creation
+    # - similar to instance attribute definitions
+    pre_create_attr_defs = []
+
     @abstractmethod
     def create(self, subset_name, instance_data, pre_create_data):
         """Create new instance and store it.
@@ -263,7 +306,7 @@ class Creator(BaseCreator):
         `get_default_variants` should be used.
         """
 
-        return None
+        return self.default_variant
 
     def get_pre_create_attr_defs(self):
         """Plugin attribute definitions needed for creation.
@@ -276,7 +319,7 @@ class Creator(BaseCreator):
             list<AbtractAttrDef>: Attribute definitions that can be tweaked for
                 created instance.
         """
-        return []
+        return self.pre_create_attr_defs
 
 
 class AutoCreator(BaseCreator):

From 19edc98d4909b4e855cdc8f2d9a8fc7f5a155c4c Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 16 Mar 2022 14:40:16 +0100
Subject: [PATCH 003/108] update list has named tuple 'UpdateData'

---
 openpype/pipeline/create/context.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/openpype/pipeline/create/context.py b/openpype/pipeline/create/context.py
index c2757a4502..15417a4ff8 100644
--- a/openpype/pipeline/create/context.py
+++ b/openpype/pipeline/create/context.py
@@ -18,6 +18,8 @@ from openpype.api import (
     get_project_settings
 )
 
+UpdateData = collections.namedtuple("UpdateData", ["instance", "changes"])
+
 
 class ImmutableKeyError(TypeError):
     """Accessed key is immutable so does not allow changes or removements."""
@@ -1080,7 +1082,7 @@ class CreateContext:
             for instance in cretor_instances:
                 instance_changes = instance.changes()
                 if instance_changes:
-                    update_list.append((instance, instance_changes))
+                    update_list.append(UpdateData(instance, instance_changes))
 
             creator = self.creators[identifier]
             if update_list:

From d4abe6ea8788111ba77ff7dab5b64ef59a63182f Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 16 Mar 2022 15:39:41 +0100
Subject: [PATCH 004/108] added more information about publishing

---
 website/docs/dev_publishing.md | 203 +++++++++++++++++++++++++++------
 1 file changed, 165 insertions(+), 38 deletions(-)

diff --git a/website/docs/dev_publishing.md b/website/docs/dev_publishing.md
index 0808818456..b16a42bb43 100644
--- a/website/docs/dev_publishing.md
+++ b/website/docs/dev_publishing.md
@@ -8,7 +8,7 @@ Publishing workflow consist of 2 parts:
 - Creation - Mark what will be published and how.
 - Publishing - Use data from creation to go through pyblish process.
 
-OpenPype is using `pyblish` for publishing process. It is a little bit extented and modified mainly for UI purposes. The main differences are that OpenPype's publish UI allows to enable/disable instances or plugins during creation part instead of in publishing part and has limited actions only for failed validator plugins.
+OpenPype is using [pyblish](https://pyblish.com/) for publishing process. OpenPype a little bit extend and modify few functions mainly for reports and UI purposes. The main differences are that OpenPype's publish UI allows to enable/disable instances or plugins during creation part instead of in publishing part and has limited plugin actions only for failed validation plugins.
 
 # Creation
 Concept of creation does not have to "create" anything but prepare and store metadata about an "instance". Created instance always has `family` which defines what kind of data will be published, best example is `workfile` family. Storing of metadata is host specific and may be even a Creator plugin specific. In most of hosts are metadata stored to workfile (Maya scene, Nuke script, etc.) to an item or a node the same way so consistency of host implementation is kept, but some features may require different approach. Storing data to workfile gives ability to keep values so artist does not have to do create instances over and over.
@@ -30,7 +30,33 @@ Objected representation of created instance metadata defined by class **CreatedI
 | asset | str | Name of asset in which context was created. |
 | task | str | Name of task in which context was created. Can be set to `None`. |
 
+:::note
 Task should not be required until subset name template expect it.
+:::
+
+object of **CreatedInstance** has method **data_to_store** which returns dictionary that can be parsed to json string. This method will return all data related to instance so can be re-created using `CreatedInstance.from_existing(data)`.
+
+## Create context
+Controller and wrapper around creation is `CreateContext` which cares about loading of plugins needed for creation. And validates required functions in host implementation.
+
+Context discovers creator and publish plugins. Trigger collections of existing instances on creators and trigger creation itself. Also keeps in mind instance objects by their ids.
+
+Creator plugins can call **creator_adds_instance** or **creator_removed_instance** to add/remove instance but these methods are not meant to be called directly out of creator. The reason is that is creator's responsibility to remove metadata or decide if should remove the instance.
+
+### Required functions in host implementation
+Host implementation **must** have implemented **get_context_data** and **update_context_data**. These two functions are needed to store metadata that are not related to any instane but are needed for creation and publishing process. Right now are there stored data about enabled/disabled optional publish plugins. When data are not stored and loaded properly reset of publishing will cause that they will be set to default value. Similar to instance data can be context data also parsed to json string.
+
+There are also few optional functions. For UI purposes it is possible to implement **get_context_title** which can return string showed in UI as a title. Output string may contain html tags. It is recommended to return context path (it will be created function this purposes) in this order `"{project name}/{asset hierarchy}/<b>{asset name}</b>/{task name}"`.
+
+Another optional function is **get_current_context**. This function is handy in hosts where is possible to open multiple workfiles in one process so using global context variables are not relevant because artist can switch between opened workfiles without being acknowledged. When function is not implemented or won't return right keys the global
+```json
+# Expected keys in output
+{
+    "project_name": "MyProject",
+    "asset_name": "sq01_sh0010",
+    "task_name": "Modeling"
+}
+```
 
 ## Create plugin
 Main responsibility of create plugin is to create, update, collect and remove instance metadata and propagate changes to create context. Has access to **CreateContext** (`self.create_context`) that discovered the plugin so has also access to other creators and instances.
@@ -134,16 +160,17 @@ class RenderLayerCreator(Creator):
     label = "Render Layer"
 ```
 
-- **`icon`** (attr) - Icon of creator and it's instances. Value can be a path to image file, full name of qtawesome icon, `QPixmap` or `QIcon`. For complex cases or cases when `Qt` objects are returned it is recommended to override `get_icon` method and handle the logic or import `Qt` inside the method to not break headless usage of creator plugin. For list of qtawesome icons check qtawesome github repository (look for used version in pyproject.toml).
-- **`get_icon`** (method) - Default implementation returns `self.icon`.
+- **`get_icon`** (attr) - Icon of creator and it's instances. Value can be a path to image file, full name of qtawesome icon, `QPixmap` or `QIcon`. For complex cases or cases when `Qt` objects are returned it is recommended to override `get_icon` method and handle the logic or import `Qt` inside the method to not break headless usage of creator plugin. For list of qtawesome icons check qtawesome github repository (look for used version in pyproject.toml). Default implementation return **icon** attribute.
+- **`icon`** (method) - Attribute for default implementation of **get_icon**.
 ```python
 class RenderLayerCreator(Creator):
     # Use font awesome 5 icon
     icon = "fa5.building"
 ```
 
+- **`get_instance_attr_defs`** (method) - Attribute definitions of instance. Creator can define attribute values with default values for each instance. These attributes may affect how will be instance processed during publishing. Attribute defiitions can be used from `openpype.pipeline.lib.attribute_definitions` (NOTE: Will be moved to `openpype.lib.attribute_definitions` soon). Attribute definitions define basic type of values for different cases e.g. boolean, number, string, enumerator, etc. Default implementations returns **instance_attr_defs**.
+- **`instance_attr_defs`** (attr) - Attribute for default implementation of **get_instance_attr_defs**.
 
-- **`get_instance_attr_defs`** (method) - Attribute definitions of instance. Creator can define attribute values with default values for each instance. These attributes may affect how will be instance processed during publishing. Attribute defiitions can be used from `openpype.pipeline.lib.attribute_definitions` (NOTE: Will be moved to `openpype.lib.attribute_definitions` soon). Attribute definitions define basic type of values for different cases e.g. boolean, number, string, enumerator, etc. Their advantage is that they can be created dynamically and
 ```python
 from openpype.pipeline import attribute_definitions
 
@@ -172,7 +199,7 @@ class RenderLayerCreator(Creator):
 Creator that is triggered on reset of create context. Can be used for families that are expected to be created automatically without artist interaction (e.g. **workfile**). Method `create` is triggered after collecting of all creators.
 
 :::important
-**AutoCreator** has implemented **remove_instances** to do nothing as removing of auto created instances would in most of cases lead to create new instance immediately.
+**AutoCreator** has implemented **remove_instances** to do nothing as removing of auto created instances would lead to create new instance immediately or on refresh.
 :::
 
 ```python
@@ -244,41 +271,53 @@ def create(self):
 ### Creator
 Implementation of creator plugin that is triggered manually by artist in UI (or by code). Has extended options for UI purposes than **AutoCreator** and **create** method expect more arguments.
 
-- **`create_allow_context_change`** (class attr) - Allow to set context in UI before creation. Some creator may not allow it or their logic would not use the context selection (e.g. bulk creators).
+**Abstractions**
+- **`create`** (method) - Code where creation of metadata
+
+**Optional implementations**
+- **`create_allow_context_change`** (class attr) - Allow to set context in UI before creation. Some creator may not allow it or their logic would not use the context selection (e.g. bulk creators). Is set to `True` but default.
 ```python
 class BulkRenderCreator(Creator):
     create_allow_context_change = False
 ```
-- **`get_default_variants`** (method) - Returns list of default variants that are showed in create dialog. Uses **default_variants** by default.
+- **`get_default_variants`** (method) - Returns list of default variants that are listed in create dialog for user. Returns **default_variants** attribute by default.
 - **`default_variants`** (attr) - Attribute for default implementation of **get_default_variants**.
 
-- **`get_default_variant`** (method) - Return default variant that is prefilled in UI. By default returns `None`, in that case first item from **get_default_variants** is used if there is any or **"Main"**.
+- **`get_default_variant`** (method) - Returns default variant that is prefilled in UI (value does not have to be in default variants). By default returns **default_variant** attribute. If returns `None` then UI logic will take first item from **get_default_variants** if there is any otherwise **"Main"** is used.
+- **`default_variant`** (attr) - Attribute for default implementation of **get_default_variant**.
 
-- **`get_description`** (method) - Returns short string description of creator. Uses **description** by default.
+- **`get_description`** (method) - Returns short string description of creator. Returns **description** attribute by default.
 - **`description`** (attr) - Attribute for default implementation of **get_description**.
 
-- **`get_detailed_description`** (method) - Returns detailed string description of creator. Can contain markdown. Uses **detailed_description** by default.
+- **`get_detailed_description`** (method) - Returns detailed string description of creator. Can contain markdown. Returns **detailed_description** attribute by default.
 - **`detailed_description`** (attr) - Attribute for default implementation of **get_detailed_description**.
 
-- **`get_pre_create_attr_defs`** (method) - Similar to **get_instance_attr_defs** returns attribute definitions but they are filled before creation. When creation is called from UI the values are passed to **create** method.
-
-- **`create`** (method) - Code where creation of metadata
+- **`get_pre_create_attr_defs`** (method) - Similar to **get_instance_attr_defs** returns attribute definitions but they are filled before creation. When creation is called from UI the values are passed to **create** method. Returns **pre_create_attr_defs** attribute by default.
+- **`pre_create_attr_defs`** (attr) - Attribute for default implementation of **get_pre_create_attr_defs**.
 
 ```python
-from openpype.pipeline import attribute_definitions
+from openpype.pipeline import Creator, attribute_definitions
 
 
-class RenderLayerCreator(Creator):
+class CreateRender(Creator):
+    family = "render"
+    label = "Render"
+    icon = "fa.eye"
+    description = "Render scene viewport"
+
     def __init__(
         self, context, system_settings, project_settings, *args, **kwargs
     ):
-        super(RenderLayerCreator, self).__init__(
+        super(CreateRender, self).__init__(
             context, system_settings, project_settings, *args, **kwargs
         )
         plugin_settings = (
             project_settings["my_host"]["create"][self.__class__.__name__]
         )
+        # Get information if studio has enabled farm publishing
         self._allow_farm_render = plugin_settings["allow_farm_render"]
+        # Get default variants from settings
+        self.default_variants = plugin_settings["variants"]
 
     def get_instance_attr_defs(self):
         # Return empty list if '_allow_farm_render' is not enabled (can be set during initialization)
@@ -294,22 +333,26 @@ class RenderLayerCreator(Creator):
         ]
 
     def get_pre_create_attr_defs(self):
-        return [
-            # Give user option to use selection or not
+        # Give user option to use selection or not
+        attrs = [
             attribute_definitions.BoolDef(
                 "use_selection",
                 default=False,
                 label="Use selection"
-            ),
+            )
+        ]
+        if self._allow_farm_render:
             # Set to render on farm in creator dialog
             # - this value is not automatically passed to instance attributes
             #   creator must do that during creation
-            attribute_definitions.BoolDef(
-                "render_farm",
-                default=False,
-                label="Render on Farm"
+            attrs.append(
+                attribute_definitions.BoolDef(
+                    "render_farm",
+                    default=False,
+                    label="Render on Farm"
+                )
             )
-        ]
+        return attrs
 
     def create(self, subset_name, instance_data, pre_create_data):
         # ARGS:
@@ -319,6 +362,7 @@ class RenderLayerCreator(Creator):
         #    - 'task' - task name
         #    - 'variant' - variant
         #    - 'family' - instnace family
+
         # Check if should use selection or not
         if pre_create_data.get("use_selection"):
             items = pipeline.get_selection()
@@ -347,44 +391,127 @@ class RenderLayerCreator(Creator):
         self._add_instance_to_context(new_instance)
 ```
 
-## Create context
-Controller and wrapper around creation is `CreateContext` which cares about loading  `CreatedInstance`
-
 # Publish
-OpenPype is using `pyblish` for publishing process which is a little bit extented and modified mainly for UI purposes. The main differences are that OpenPype's publish UI does not allow to enable/disable instances or plugins that can be done during creation part. Also does support actions only for validators after validation exception.
-
 ## Exceptions
 OpenPype define few specific exceptions that should be used in publish plugins.
 
 ### Validation exception
 Validation plugins should raise `PublishValidationError` to show to an artist what's wrong and give him actions to fix it. The exception says that error happened in plugin can be fixed by artist himself (with or without action on plugin). Any other errors will stop publishing immediately. Exception `PublishValidationError` raised after validation order has same effect as any other exception.
 
-Exception `PublishValidationError` 3 arguments:
+Exception `PublishValidationError` expects 4 arguments:
 - **message** Which is not used in UI but for headless publishing.
 - **title** Short description of error (2-5 words). Title is used for grouping of exceptions per plugin.
 - **description** Detailed description of happened issue where markdown and html can be used.
+- **detail** Is optional to give even more detailed information for advanced users. At this moment is detail showed under description but it is in plan to have detail in collapsible widget.
 
+Extended version is `PublishXmlValidationError` which uses xml files with stored descriptions. This helps to avoid having huge markdown texts inside code. The exception has 4 arguments:
+- **plugin** The plugin object which raises the exception to find it's related xml file.
+- **message** Exception message for publishing without UI or different pyblish UI.
+- **key** Optional argument says which error from xml is used as validation plugin may raise error with different messages based on the current errors. Default is **"main"**.
+- **formatting_data** Optional dictionary to format data in the error. This is used to fill detailed description with data from the publishing so artist can get more precise information.
+
+**Where and how to create xml file**
+
+Xml files for `PublishXmlValidationError` must be located in **./help** subfolder next to plugin and the filename must match the filename of plugin.
+```
+# File location related to plugin file
+└ publish
+  ├ help
+  │ ├ validate_scene.xml
+  │ └ ...
+  ├ validate_scene.py
+  └ ...
+```
+
+Xml file content has **&ltroot&gt** node which may contain any amount of **&lterror&gt** nodes, but each of them must have **id** attribute with unique value. That is then used for **key**. Each error must have **&lttitle&gt** and **&ltdescription&gt** and **&ltdetail&gt**. Text content may contain python formatting keys that can be filled when exception is raised.
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<root>
+    <error id="main">
+        <title>Subset context</title>
+        <description>## Invalid subset context
+
+Context of the given subset doesn't match your current scene.
+
+### How to repair?
+
+Yout can fix this with "Repair" button on the right. This will use '{expected_asset}' asset name and overwrite '{found_asset}' asset name in scene metadata.
+
+After that restart publishing with Reload button.
+        </description>
+        <detail>
+### How could this happen?
+
+The subset was created in different scene with different context
+or the scene file was copy pasted from different context.
+        </detail>
+    </error>
+</root>
+```
 
 ### Known errors
 When there is a known error that can't be fixed by user (e.g. can't connect to deadline service, etc.) `KnownPublishError` should be raise. The only difference is that it's message is shown in UI to artist otherwise a neutral message without context is shown.
 
 ## Plugin extension
-Publish plugins can be extended by additional logic when inherits from `OpenPypePyblishPluginMixin` which can be used as mixin (additional inheritance of class).
+Publish plugins can be extended by additional logic when inherits from `OpenPypePyblishPluginMixin` which can be used as mixin (additional inheritance of class). Publish plugins that inherit from this mixin can define attributes that will be shown in **CreatedInstance**. One of most important usages is to be able turn on/off optional plugins.
+
+Attributes are defined by return value of `get_attribute_defs` method. Attribute definitions are for families defined in plugin's `families` attribute if it's instance plugin or for whole context if it's context plugin. To convert existing values (or to remove legacy values) can be re-implemented `convert_attribute_values`. Default implementation just converts the values to right types.
+
+:::important
+Values of publish attributes from created instance are never removed automatically so implementing of this method is best way to remove legacy data or convert them to new data structure.
+:::
+
+Possible attribute definitions can be found in `openpype/pipeline/lib/attribute_definitions.py`.
 
 ```python
 import pyblish.api
-from openpype.pipeline import OpenPypePyblishPluginMixin
+from openpype.pipeline import (
+    OpenPypePyblishPluginMixin,
+    attribute_definitions,
+)
 
 
 # Example context plugin
 class MyExtendedPlugin(
     pyblish.api.ContextPlugin, OpenPypePyblishPluginMixin
 ):
-    pass
+    optional = True
+    active = True
 
+    @classmethod
+    def get_attribute_defs(cls):
+        return [
+            attribute_definitions.BoolDef(
+                # Key under which it will be stored
+                "process",
+                # Use 'active' as default value
+                default=cls.active,
+                # Use plugin label as label for attribute
+                label=cls.label
+            )
+        ]
+
+    def process_plugin(self, context):
+        # First check if plugin is optional
+        if not self.optional:
+            return True
+
+        # Get 'process' key
+        process_value = (
+            context.data
+            .get("publish_attributes", {})
+            # Attribute values are stored by class names
+            .get(self.__class__.__name__, {})
+            # Access the key
+            .get("process")
+        )
+        if process_value or process_value is None:
+            return True
+        return False
+
+    def process(self, context):
+        if not self.process_plugin(context):
+            return
+        # Do plugin logic
+        ...
 ```
-
-### Extensions
-Currently only extension is ability to define attributes for instances during creation. Method `get_attribute_defs` returns attribute definitions for families defined in plugin's `families` attribute if it's instance plugin or for whole context if it's context plugin. To convert existing values (or to remove legacy values) can be implemented `convert_attribute_values`. Values of publish attributes from created instance are never removed automatically so implementing of this method is best way to remove legacy data or convert them to new data structure.
-
-Possible attribute definitions can be found in `openpype/pipeline/lib/attribute_definitions.py`.

From bf08a0241991ac97ad1544bebe1bad5efe82754e Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 16 Mar 2022 15:53:31 +0100
Subject: [PATCH 005/108] few minor changes

---
 website/docs/dev_publishing.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/website/docs/dev_publishing.md b/website/docs/dev_publishing.md
index b16a42bb43..58f271641d 100644
--- a/website/docs/dev_publishing.md
+++ b/website/docs/dev_publishing.md
@@ -11,10 +11,10 @@ Publishing workflow consist of 2 parts:
 OpenPype is using [pyblish](https://pyblish.com/) for publishing process. OpenPype a little bit extend and modify few functions mainly for reports and UI purposes. The main differences are that OpenPype's publish UI allows to enable/disable instances or plugins during creation part instead of in publishing part and has limited plugin actions only for failed validation plugins.
 
 # Creation
-Concept of creation does not have to "create" anything but prepare and store metadata about an "instance". Created instance always has `family` which defines what kind of data will be published, best example is `workfile` family. Storing of metadata is host specific and may be even a Creator plugin specific. In most of hosts are metadata stored to workfile (Maya scene, Nuke script, etc.) to an item or a node the same way so consistency of host implementation is kept, but some features may require different approach. Storing data to workfile gives ability to keep values so artist does not have to do create instances over and over.
+Concept of creation does not have to "create" anything but prepare and store metadata about an "instance" (becomes a subset after publish process). Created instance always has `family` which defines what kind of data will be published, best example is `workfile` family. Storing of metadata is host specific and may be even a Creator plugin specific. In most of hosts are metadata stored to workfile (Maya scene, Nuke script, etc.) to an item or a node the same way so consistency of host implementation is kept, but some features may require different approach that is the reason why it is creator plugin responsibility. Storing the metadata to workfile gives ability to keep values so artist does not have to do create and set what should be published and how over and over.
 
 ## Created instance
-Objected representation of created instance metadata defined by class **CreatedInstance**. Has access to **CreateContext** and **BaseCreator** that initialized the object. Is dictionary like object with few immutable keys (maked with start `*`) that are defined by creator plugin or create context on initialization. Can have more arbitrary data but keep in mind that some keys are reserved.
+Objected representation of created instance metadata defined by class **CreatedInstance**. Has access to **CreateContext** and **BaseCreator** that initialized the object. Is dictionary like object with few immutable keys (marked with start `*` in table). The immutable keys are set by creator plugin or create context on initialization and thei values can't change. Instance can have more arbitrary data, for example ids of nodes in scene but keep in mind that some keys are reserved.
 
 | Key | Type | Description |
 |---|---|---|
@@ -25,7 +25,7 @@ Objected representation of created instance metadata defined by class **CreatedI
 | *creator_attributes | dict | Dictionary of attributes that are defined by creator plugin (`get_instance_attr_defs`). |
 | *publish_attributes | dict | Dictionary of attributes that are defined by publish plugins. |
 | variant | str | Variant is entered by artist on creation and may affect **subset**. |
-| subset | str | Name of instance. This name will be used as subset name during publishing. |
+| subset | str | Name of instance. This name will be used as subset name during publishing. Can be changed on context change or variant change. |
 | active | bool | Is instance active and will be published or not. |
 | asset | str | Name of asset in which context was created. |
 | task | str | Name of task in which context was created. Can be set to `None`. |
@@ -48,7 +48,7 @@ Host implementation **must** have implemented **get_context_data** and **update_
 
 There are also few optional functions. For UI purposes it is possible to implement **get_context_title** which can return string showed in UI as a title. Output string may contain html tags. It is recommended to return context path (it will be created function this purposes) in this order `"{project name}/{asset hierarchy}/<b>{asset name}</b>/{task name}"`.
 
-Another optional function is **get_current_context**. This function is handy in hosts where is possible to open multiple workfiles in one process so using global context variables are not relevant because artist can switch between opened workfiles without being acknowledged. When function is not implemented or won't return right keys the global
+Another optional function is **get_current_context**. This function is handy in hosts where is possible to open multiple workfiles in one process so using global context variables is not relevant because artist can switch between opened workfiles without being acknowledged. When function is not implemented or won't return right keys the global context is used.
 ```json
 # Expected keys in output
 {
@@ -59,7 +59,7 @@ Another optional function is **get_current_context**. This function is handy in
 ```
 
 ## Create plugin
-Main responsibility of create plugin is to create, update, collect and remove instance metadata and propagate changes to create context. Has access to **CreateContext** (`self.create_context`) that discovered the plugin so has also access to other creators and instances.
+Main responsibility of create plugin is to create, update, collect and remove instance metadata and propagate changes to create context. Has access to **CreateContext** (`self.create_context`) that discovered the plugin so has also access to other creators and instances. Create plugins have a lot of responsibility so it is recommended to implement common code per host.
 
 ### BaseCreator
 Base implementation of creator plugin. It is not recommended to use this class as base for production plugins but rather use one of **AutoCreator** and **Creator** variants.

From 0b9febaf3e215f45ecfba9c2a053db2cb9053ae4 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 16 Mar 2022 16:05:17 +0100
Subject: [PATCH 006/108] changed sidebar label

---
 website/sidebars.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/sidebars.js b/website/sidebars.js
index fe76336e7e..105afc30eb 100644
--- a/website/sidebars.js
+++ b/website/sidebars.js
@@ -139,7 +139,7 @@ module.exports = {
         "dev_contribute",
         {
             type: "category",
-            label: "Hosts development",
+            label: "Hosts integrations",
             items: [
                 "dev_publishing"
             ]

From 5da139c957c79c5a51b1cff8c1973bf554f72853 Mon Sep 17 00:00:00 2001
From: Milan Kolar <milan@pype.club>
Date: Thu, 17 Mar 2022 11:53:57 +0100
Subject: [PATCH 007/108] minor styling tweaks

---
 website/docs/dev_publishing.md | 74 +++++++++++++++++++---------------
 1 file changed, 41 insertions(+), 33 deletions(-)

diff --git a/website/docs/dev_publishing.md b/website/docs/dev_publishing.md
index 58f271641d..49e720a7e0 100644
--- a/website/docs/dev_publishing.md
+++ b/website/docs/dev_publishing.md
@@ -2,18 +2,21 @@
 id: dev_publishing
 title: Publishing
 sidebar_label: Publishing
+toc_max_heading_level: 4
 ---
 
 Publishing workflow consist of 2 parts:
-- Creation - Mark what will be published and how.
-- Publishing - Use data from creation to go through pyblish process.
+- Creating - Mark what will be published and how.
+- Publishing - Use data from Creating to go through pyblish process.
 
-OpenPype is using [pyblish](https://pyblish.com/) for publishing process. OpenPype a little bit extend and modify few functions mainly for reports and UI purposes. The main differences are that OpenPype's publish UI allows to enable/disable instances or plugins during creation part instead of in publishing part and has limited plugin actions only for failed validation plugins.
+OpenPype is using [pyblish](https://pyblish.com/) for publishing process. OpenPype a little bit extend and modify few functions mainly for reports and UI purposes. The main differences are that OpenPype's publish UI allows to enable/disable instances or plugins during Creating part instead of in publishing part and has limited plugin actions only for failed validation plugins.
 
-# Creation
-Concept of creation does not have to "create" anything but prepare and store metadata about an "instance" (becomes a subset after publish process). Created instance always has `family` which defines what kind of data will be published, best example is `workfile` family. Storing of metadata is host specific and may be even a Creator plugin specific. In most of hosts are metadata stored to workfile (Maya scene, Nuke script, etc.) to an item or a node the same way so consistency of host implementation is kept, but some features may require different approach that is the reason why it is creator plugin responsibility. Storing the metadata to workfile gives ability to keep values so artist does not have to do create and set what should be published and how over and over.
+## **Creating**
+
+Concept of Creating does not have to "create" anything but prepare and store metadata about an "instance" (becomes a subset after publish process). Created instance always has `family` which defines what kind of data will be published, best example is `workfile` family. Storing of metadata is host specific and may be even a Creator plugin specific. In most of hosts are metadata stored to workfile (Maya scene, Nuke script, etc.) to an item or a node the same way so consistency of host implementation is kept, but some features may require different approach that is the reason why it is creator plugin responsibility. Storing the metadata to workfile gives ability to keep values so artist does not have to do create and set what should be published and how over and over.
+
+### Created instance
 
-## Created instance
 Objected representation of created instance metadata defined by class **CreatedInstance**. Has access to **CreateContext** and **BaseCreator** that initialized the object. Is dictionary like object with few immutable keys (marked with start `*` in table). The immutable keys are set by creator plugin or create context on initialization and thei values can't change. Instance can have more arbitrary data, for example ids of nodes in scene but keep in mind that some keys are reserved.
 
 | Key | Type | Description |
@@ -36,15 +39,16 @@ Task should not be required until subset name template expect it.
 
 object of **CreatedInstance** has method **data_to_store** which returns dictionary that can be parsed to json string. This method will return all data related to instance so can be re-created using `CreatedInstance.from_existing(data)`.
 
-## Create context
-Controller and wrapper around creation is `CreateContext` which cares about loading of plugins needed for creation. And validates required functions in host implementation.
+#### *Create context* {#category-doc-link}
 
-Context discovers creator and publish plugins. Trigger collections of existing instances on creators and trigger creation itself. Also keeps in mind instance objects by their ids.
+Controller and wrapper around Creating is `CreateContext` which cares about loading of plugins needed for Creating. And validates required functions in host implementation.
+
+Context discovers creator and publish plugins. Trigger collections of existing instances on creators and trigger Creating itself. Also keeps in mind instance objects by their ids.
 
 Creator plugins can call **creator_adds_instance** or **creator_removed_instance** to add/remove instance but these methods are not meant to be called directly out of creator. The reason is that is creator's responsibility to remove metadata or decide if should remove the instance.
 
-### Required functions in host implementation
-Host implementation **must** have implemented **get_context_data** and **update_context_data**. These two functions are needed to store metadata that are not related to any instane but are needed for creation and publishing process. Right now are there stored data about enabled/disabled optional publish plugins. When data are not stored and loaded properly reset of publishing will cause that they will be set to default value. Similar to instance data can be context data also parsed to json string.
+#### Required functions in host implementation
+Host implementation **must** have implemented **get_context_data** and **update_context_data**. These two functions are needed to store metadata that are not related to any instance but are needed for Creating and publishing process. Right now are there stored data about enabled/disabled optional publish plugins. When data are not stored and loaded properly reset of publishing will cause that they will be set to default value. Similar to instance data can be context data also parsed to json string.
 
 There are also few optional functions. For UI purposes it is possible to implement **get_context_title** which can return string showed in UI as a title. Output string may contain html tags. It is recommended to return context path (it will be created function this purposes) in this order `"{project name}/{asset hierarchy}/<b>{asset name}</b>/{task name}"`.
 
@@ -58,10 +62,10 @@ Another optional function is **get_current_context**. This function is handy in
 }
 ```
 
-## Create plugin
+### Create plugin
 Main responsibility of create plugin is to create, update, collect and remove instance metadata and propagate changes to create context. Has access to **CreateContext** (`self.create_context`) that discovered the plugin so has also access to other creators and instances. Create plugins have a lot of responsibility so it is recommended to implement common code per host.
 
-### BaseCreator
+#### *BaseCreator*
 Base implementation of creator plugin. It is not recommended to use this class as base for production plugins but rather use one of **AutoCreator** and **Creator** variants.
 
 **Abstractions**
@@ -88,7 +92,7 @@ def collect_instances(self):
             self._add_instance_to_context(instance)
 ```
 
-- **`create`** (method) - Create new object of **CreatedInstance** store it's metadata to workfile and add the instance into create context. Failed creation should raise **CreatorError** if happens error that can artist fix or give him some useful information. Trigger and implementation differs for **Creator** and **AutoCreator**.
+- **`create`** (method) - Create new object of **CreatedInstance** store it's metadata to workfile and add the instance into create context. Failed Creating should raise **CreatorError** if happens error that can artist fix or give him some useful information. Trigger and implementation differs for **Creator** and **AutoCreator**.
 
 - **`update_instances`** (method) - Update data of instances. Receives tuple with **instance** and **changes**.
 ```python
@@ -195,7 +199,7 @@ class RenderLayerCreator(Creator):
 - **`get_dynamic_data`** (method) - Can be used to extend data for subset template which may be required in some cases.
 
 
-### AutoCreator
+#### *AutoCreator*
 Creator that is triggered on reset of create context. Can be used for families that are expected to be created automatically without artist interaction (e.g. **workfile**). Method `create` is triggered after collecting of all creators.
 
 :::important
@@ -268,14 +272,11 @@ def create(self):
         existing_instance["task"] = task_name
 ```
 
-### Creator
+#### *Creator*
 Implementation of creator plugin that is triggered manually by artist in UI (or by code). Has extended options for UI purposes than **AutoCreator** and **create** method expect more arguments.
 
-**Abstractions**
-- **`create`** (method) - Code where creation of metadata
-
 **Optional implementations**
-- **`create_allow_context_change`** (class attr) - Allow to set context in UI before creation. Some creator may not allow it or their logic would not use the context selection (e.g. bulk creators). Is set to `True` but default.
+- **`create_allow_context_change`** (class attr) - Allow to set context in UI before Creating. Some creator may not allow it or their logic would not use the context selection (e.g. bulk creators). Is set to `True` but default.
 ```python
 class BulkRenderCreator(Creator):
     create_allow_context_change = False
@@ -391,11 +392,11 @@ class CreateRender(Creator):
         self._add_instance_to_context(new_instance)
 ```
 
-# Publish
-## Exceptions
+## **Publish**
+### Exceptions
 OpenPype define few specific exceptions that should be used in publish plugins.
 
-### Validation exception
+#### *Validation exception*
 Validation plugins should raise `PublishValidationError` to show to an artist what's wrong and give him actions to fix it. The exception says that error happened in plugin can be fixed by artist himself (with or without action on plugin). Any other errors will stop publishing immediately. Exception `PublishValidationError` raised after validation order has same effect as any other exception.
 
 Exception `PublishValidationError` expects 4 arguments:
@@ -449,10 +450,10 @@ or the scene file was copy pasted from different context.
 </root>
 ```
 
-### Known errors
+#### *Known errors*
 When there is a known error that can't be fixed by user (e.g. can't connect to deadline service, etc.) `KnownPublishError` should be raise. The only difference is that it's message is shown in UI to artist otherwise a neutral message without context is shown.
 
-## Plugin extension
+### Plugin extension
 Publish plugins can be extended by additional logic when inherits from `OpenPypePyblishPluginMixin` which can be used as mixin (additional inheritance of class). Publish plugins that inherit from this mixin can define attributes that will be shown in **CreatedInstance**. One of most important usages is to be able turn on/off optional plugins.
 
 Attributes are defined by return value of `get_attribute_defs` method. Attribute definitions are for families defined in plugin's `families` attribute if it's instance plugin or for whole context if it's context plugin. To convert existing values (or to remove legacy values) can be re-implemented `convert_attribute_values`. Default implementation just converts the values to right types.
@@ -463,18 +464,22 @@ Values of publish attributes from created instance are never removed automatical
 
 Possible attribute definitions can be found in `openpype/pipeline/lib/attribute_definitions.py`.
 
-```python
-import pyblish.api
-from openpype.pipeline import (
+<details>
+  <summary>Toggle me!</summary>
+
+    ``` python
+
+    import pyblish.api
+    from openpype.pipeline import (
     OpenPypePyblishPluginMixin,
     attribute_definitions,
-)
+    )
 
 
-# Example context plugin
-class MyExtendedPlugin(
+    # Example context plugin
+    class MyExtendedPlugin(
     pyblish.api.ContextPlugin, OpenPypePyblishPluginMixin
-):
+    ):
     optional = True
     active = True
 
@@ -514,4 +519,7 @@ class MyExtendedPlugin(
             return
         # Do plugin logic
         ...
-```
+    ```
+</details>
+
+

From 20e2bae01c06d009048c3386ce5145d6194c09a4 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakub@orbi.tools>
Date: Fri, 18 Mar 2022 17:39:56 +0100
Subject: [PATCH 008/108] flame: wirtetap accepts also path like color policy

---
 openpype/hosts/flame/api/scripts/wiretap_com.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/flame/api/scripts/wiretap_com.py b/openpype/hosts/flame/api/scripts/wiretap_com.py
index ee906c2608..a85a85ae25 100644
--- a/openpype/hosts/flame/api/scripts/wiretap_com.py
+++ b/openpype/hosts/flame/api/scripts/wiretap_com.py
@@ -422,7 +422,7 @@ class WireTapCom(object):
         color_policy = color_policy or "Legacy"
 
         # check if the colour policy in custom dir
-        if not os.path.exists(color_policy):
+        if "/" not in color_policy:
             color_policy = "/syncolor/policies/Autodesk/{}".format(
                 color_policy)
 

From c6735927dcc62b2060bbac7c3d5bd52aee740783 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakub@orbi.tools>
Date: Fri, 18 Mar 2022 17:41:23 +0100
Subject: [PATCH 009/108] flame: fixing head and tail could be string value

---
 openpype/hosts/flame/api/lib.py | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/flame/api/lib.py b/openpype/hosts/flame/api/lib.py
index 74d9e7607a..aa2cfcb96d 100644
--- a/openpype/hosts/flame/api/lib.py
+++ b/openpype/hosts/flame/api/lib.py
@@ -18,6 +18,7 @@ log = Logger.get_logger(__name__)
 
 FRAME_PATTERN = re.compile(r"[\._](\d+)[\.]")
 
+
 class CTX:
     # singleton used for passing data between api modules
     app_framework = None
@@ -538,9 +539,17 @@ def get_segment_attributes(segment):
 
     # head and tail with forward compatibility
     if segment.head:
-        clip_data["segment_head"] = int(segment.head)
+        # `infinite` can be also returned
+        if isinstance(segment.head, str):
+            clip_data["segment_head"] = 0
+        else:
+            clip_data["segment_head"] = int(segment.head)
     if segment.tail:
-        clip_data["segment_tail"] = int(segment.tail)
+        # `infinite` can be also returned
+        if isinstance(segment.tail, str):
+            clip_data["segment_tail"] = 0
+        else:
+            clip_data["segment_tail"] = int(segment.tail)
 
     # add all available shot tokens
     shot_tokens = _get_shot_tokens_values(segment, [

From 7825da773636eeaa96a2ac377db90836c0f32727 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakub@orbi.tools>
Date: Fri, 18 Mar 2022 17:43:04 +0100
Subject: [PATCH 010/108] flame: selected segments collected only once

---
 .../publish/collect_timeline_instances.py     | 173 +++++++++---------
 .../plugins/publish/collect_timeline_otio.py  |  41 +++--
 2 files changed, 110 insertions(+), 104 deletions(-)

diff --git a/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py b/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
index 70340ad7a2..390c55837c 100644
--- a/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
+++ b/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
@@ -34,119 +34,124 @@ class CollectTimelineInstances(pyblish.api.ContextPlugin):
     def process(self, context):
         project = context.data["flameProject"]
         sequence = context.data["flameSequence"]
+        selected_segments = context.data["flameSelectedSegments"]
+        self.log.debug("__ selected_segments: {}".format(selected_segments))
+
         self.otio_timeline = context.data["otioTimeline"]
         self.clips_in_reels = opfapi.get_clips_in_reels(project)
         self.fps = context.data["fps"]
 
         # process all sellected
-        with opfapi.maintained_segment_selection(sequence) as segments:
-            for segment in segments:
-                comment_attributes = self._get_comment_attributes(segment)
-                self.log.debug("_ comment_attributes: {}".format(
-                    pformat(comment_attributes)))
+        for segment in selected_segments:
+            comment_attributes = self._get_comment_attributes(segment)
+            self.log.debug("__ segment.name: {}".format(
+                segment.name
+            ))
+            self.log.debug("_ comment_attributes: {}".format(
+                pformat(comment_attributes)))
 
-                clip_data = opfapi.get_segment_attributes(segment)
-                clip_name = clip_data["segment_name"]
-                self.log.debug("clip_name: {}".format(clip_name))
+            clip_data = opfapi.get_segment_attributes(segment)
+            clip_name = clip_data["segment_name"]
+            self.log.debug("clip_name: {}".format(clip_name))
 
-                # get openpype tag data
-                marker_data = opfapi.get_segment_data_marker(segment)
-                self.log.debug("__ marker_data: {}".format(
-                    pformat(marker_data)))
+            # get openpype tag data
+            marker_data = opfapi.get_segment_data_marker(segment)
+            self.log.debug("__ marker_data: {}".format(
+                pformat(marker_data)))
 
-                if not marker_data:
-                    continue
+            if not marker_data:
+                continue
 
-                if marker_data.get("id") != "pyblish.avalon.instance":
-                    continue
+            if marker_data.get("id") != "pyblish.avalon.instance":
+                continue
 
-                # get file path
-                file_path = clip_data["fpath"]
+            # get file path
+            file_path = clip_data["fpath"]
 
-                # get source clip
-                source_clip = self._get_reel_clip(file_path)
+            # get source clip
+            source_clip = self._get_reel_clip(file_path)
 
-                first_frame = opfapi.get_frame_from_filename(file_path) or 0
+            first_frame = opfapi.get_frame_from_filename(file_path) or 0
 
-                head, tail = self._get_head_tail(clip_data, first_frame)
+            head, tail = self._get_head_tail(clip_data, first_frame)
 
-                # solve handles length
-                marker_data["handleStart"] = min(
-                    marker_data["handleStart"], head)
-                marker_data["handleEnd"] = min(
-                    marker_data["handleEnd"], tail)
+            # solve handles length
+            marker_data["handleStart"] = min(
+                marker_data["handleStart"], head)
+            marker_data["handleEnd"] = min(
+                marker_data["handleEnd"], tail)
 
-                with_audio = bool(marker_data.pop("audio"))
+            with_audio = bool(marker_data.pop("audio"))
 
-                # add marker data to instance data
-                inst_data = dict(marker_data.items())
+            # add marker data to instance data
+            inst_data = dict(marker_data.items())
 
-                asset = marker_data["asset"]
-                subset = marker_data["subset"]
+            asset = marker_data["asset"]
+            subset = marker_data["subset"]
 
-                # insert family into families
-                family = marker_data["family"]
-                families = [str(f) for f in marker_data["families"]]
-                families.insert(0, str(family))
+            # insert family into families
+            family = marker_data["family"]
+            families = [str(f) for f in marker_data["families"]]
+            families.insert(0, str(family))
 
-                # form label
-                label = asset
-                if asset != clip_name:
-                    label += " ({})".format(clip_name)
-                label += " {}".format(subset)
-                label += " {}".format("[" + ", ".join(families) + "]")
+            # form label
+            label = asset
+            if asset != clip_name:
+                label += " ({})".format(clip_name)
+            label += " {}".format(subset)
+            label += " {}".format("[" + ", ".join(families) + "]")
 
-                inst_data.update({
-                    "name": "{}_{}".format(asset, subset),
-                    "label": label,
-                    "asset": asset,
-                    "item": segment,
-                    "families": families,
-                    "publish": marker_data["publish"],
-                    "fps": self.fps,
-                    "flameSourceClip": source_clip,
-                    "sourceFirstFrame": int(first_frame),
-                    "path": file_path
-                })
+            inst_data.update({
+                "name": "{}_{}".format(asset, subset),
+                "label": label,
+                "asset": asset,
+                "item": segment,
+                "families": families,
+                "publish": marker_data["publish"],
+                "fps": self.fps,
+                "flameSourceClip": source_clip,
+                "sourceFirstFrame": int(first_frame),
+                "path": file_path
+            })
 
-                # get otio clip data
-                otio_data = self._get_otio_clip_instance_data(clip_data) or {}
-                self.log.debug("__ otio_data: {}".format(pformat(otio_data)))
+            # get otio clip data
+            otio_data = self._get_otio_clip_instance_data(clip_data) or {}
+            self.log.debug("__ otio_data: {}".format(pformat(otio_data)))
 
-                # add to instance data
-                inst_data.update(otio_data)
-                self.log.debug("__ inst_data: {}".format(pformat(inst_data)))
+            # add to instance data
+            inst_data.update(otio_data)
+            self.log.debug("__ inst_data: {}".format(pformat(inst_data)))
 
-                # add resolution
-                self._get_resolution_to_data(inst_data, context)
+            # add resolution
+            self._get_resolution_to_data(inst_data, context)
 
-                # add comment attributes if any
-                inst_data.update(comment_attributes)
+            # add comment attributes if any
+            inst_data.update(comment_attributes)
 
-                # create instance
-                instance = context.create_instance(**inst_data)
+            # create instance
+            instance = context.create_instance(**inst_data)
 
-                # add colorspace data
-                instance.data.update({
-                    "versionData": {
-                        "colorspace": clip_data["colour_space"],
-                    }
-                })
+            # add colorspace data
+            instance.data.update({
+                "versionData": {
+                    "colorspace": clip_data["colour_space"],
+                }
+            })
 
-                # create shot instance for shot attributes create/update
-                self._create_shot_instance(context, clip_name, **inst_data)
+            # create shot instance for shot attributes create/update
+            self._create_shot_instance(context, clip_name, **inst_data)
 
-                self.log.info("Creating instance: {}".format(instance))
-                self.log.info(
-                    "_ instance.data: {}".format(pformat(instance.data)))
+            self.log.info("Creating instance: {}".format(instance))
+            self.log.info(
+                "_ instance.data: {}".format(pformat(instance.data)))
 
-                if not with_audio:
-                    continue
+            if not with_audio:
+                continue
 
-                # add audioReview attribute to plate instance data
-                # if reviewTrack is on
-                if marker_data.get("reviewTrack") is not None:
-                    instance.data["reviewAudio"] = True
+            # add audioReview attribute to plate instance data
+            # if reviewTrack is on
+            if marker_data.get("reviewTrack") is not None:
+                instance.data["reviewAudio"] = True
 
     def _get_comment_attributes(self, segment):
         comment = segment.comment.get_value()
@@ -188,7 +193,7 @@ class CollectTimelineInstances(pyblish.api.ContextPlugin):
 
             # get pattern defined by type
             pattern = TXT_PATERN
-            if a_type in ("number" , "float"):
+            if a_type in ("number", "float"):
                 pattern = NUM_PATERN
 
             res_goup = pattern.findall(value)
diff --git a/openpype/hosts/flame/plugins/publish/collect_timeline_otio.py b/openpype/hosts/flame/plugins/publish/collect_timeline_otio.py
index faa5be9d68..c6aeae7730 100644
--- a/openpype/hosts/flame/plugins/publish/collect_timeline_otio.py
+++ b/openpype/hosts/flame/plugins/publish/collect_timeline_otio.py
@@ -31,27 +31,28 @@ class CollecTimelineOTIO(pyblish.api.ContextPlugin):
         )
 
         # adding otio timeline to context
-        with opfapi.maintained_segment_selection(sequence):
+        with opfapi.maintained_segment_selection(sequence) as selected_seg:
             otio_timeline = flame_export.create_otio_timeline(sequence)
 
-        instance_data = {
-            "name": subset_name,
-            "asset": asset_doc["name"],
-            "subset": subset_name,
-            "family": "workfile"
-        }
+            instance_data = {
+                "name": subset_name,
+                "asset": asset_doc["name"],
+                "subset": subset_name,
+                "family": "workfile"
+            }
 
-        # create instance with workfile
-        instance = context.create_instance(**instance_data)
-        self.log.info("Creating instance: {}".format(instance))
+            # create instance with workfile
+            instance = context.create_instance(**instance_data)
+            self.log.info("Creating instance: {}".format(instance))
 
-        # update context with main project attributes
-        context.data.update({
-            "flameProject": project,
-            "flameSequence": sequence,
-            "otioTimeline": otio_timeline,
-            "currentFile": "Flame/{}/{}".format(
-                project.name, sequence.name
-            ),
-            "fps": float(str(sequence.frame_rate)[:-4])
-        })
+            # update context with main project attributes
+            context.data.update({
+                "flameProject": project,
+                "flameSequence": sequence,
+                "otioTimeline": otio_timeline,
+                "currentFile": "Flame/{}/{}".format(
+                    project.name, sequence.name
+                ),
+                "flameSelectedSegments": selected_seg,
+                "fps": float(str(sequence.frame_rate)[:-4])
+            })

From 8956e70665926ee2c66fd3735bcf554d0f9137a4 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 23 Mar 2022 14:33:53 +0100
Subject: [PATCH 011/108] added discover login into openpype pipeline

---
 openpype/pipeline/plugin_discover.py | 208 +++++++++++++++++++++++++++
 1 file changed, 208 insertions(+)
 create mode 100644 openpype/pipeline/plugin_discover.py

diff --git a/openpype/pipeline/plugin_discover.py b/openpype/pipeline/plugin_discover.py
new file mode 100644
index 0000000000..305a8bab67
--- /dev/null
+++ b/openpype/pipeline/plugin_discover.py
@@ -0,0 +1,208 @@
+import os
+import inspect
+from openpype.lib.python_module_tools import (
+    modules_from_path,
+    classes_from_module,
+)
+
+
+class DiscoverResult:
+    """Hold result of publish plugins discovery.
+
+    Stores discovered plugins duplicated plugins and file paths which
+    crashed on execution of file.
+    """
+
+    def __init__(self):
+        self.plugins = []
+        self.crashed_file_paths = {}
+        self.duplicated_plugins = []
+        self.abstract_plugins = []
+        self.ignored_plugins = set()
+
+    def __iter__(self):
+        for plugin in self.plugins:
+            yield plugin
+
+    def __getitem__(self, item):
+        return self.plugins[item]
+
+    def __setitem__(self, item, value):
+        self.plugins[item] = value
+
+
+class PluginDiscoverContext(object):
+    """Store and discover registered types nad registered paths to types.
+
+    Keeps in memory all registered types and their paths. Paths are dynamically
+    loaded on discover so different discover calls won't return the same
+    class objects even if were loaded from same file.
+    """
+
+    def __init__(self):
+        self._registered_plugins = {}
+        self._registered_plugin_paths = {}
+        self._last_discovered_plugins = {}
+
+    def get_last_discovered_plugins(self, superclass):
+        return self._last_discovered_plugins.get(superclass)
+
+    def discover(
+        self, superclass, allow_duplicates=True, ignore_classes=None
+    ):
+        """Find and return subclasses of `superclass`
+
+        Args:
+            superclass (type): Class which determines discovered subclasses.
+            allow_duplicates (bool): Validate class name duplications.
+            ignore_classes (list): List of classes that will be ignored
+                and not added to result.
+
+        Returns:
+            DiscoverResult: Object holding succesfully discovered plugins,
+                ignored plugins, plugins with missing abstract implementation
+                and duplicated plugin.
+        """
+
+        if not ignore_classes:
+            ignore_classes = []
+
+        result = DiscoverResult()
+        plugin_names = set()
+        registered_classes = self._registered_plugins.get(superclass) or []
+        registered_paths = self._registered_plugin_paths.get(superclass) or []
+        for cls in registered_classes:
+            if cls is superclass or cls in ignore_classes:
+                result.ignored_plugins.add(cls)
+                continue
+
+            if inspect.isabstract(cls):
+                result.abstract_plugins.append(cls)
+                continue
+
+            class_name = cls.__name__
+            if class_name in plugin_names:
+                result.duplicated_plugins.append(cls)
+                continue
+            plugin_names.add(class_name)
+            result.plugins.append(cls)
+
+        # Include plug-ins from registered paths
+        for path in registered_paths:
+            modules, crashed = modules_from_path(path)
+            for item in crashed:
+                filepath, exc_info = item
+                result.crashed_file_paths[filepath] = exc_info
+
+            for item in modules:
+                filepath, module = item
+                for cls in classes_from_module(superclass, module):
+                    if cls is superclass or cls in ignore_classes:
+                        result.ignored_plugins.add(cls)
+                        continue
+
+                    if inspect.isabstract(cls):
+                        result.abstract_plugins.append(cls)
+                        continue
+
+                    if not allow_duplicates:
+                        class_name = cls.__name__
+                        if class_name in plugin_names:
+                            result.duplicated_plugins.append(cls)
+                            continue
+                        plugin_names.add(class_name)
+
+                    result.plugins.append(cls)
+
+        self._last_discovered_plugins[superclass] = list(
+            result.plugins
+        )
+        return result
+
+    def register_plugin(self, superclass, cls):
+        """Register an individual `obj` of type `superclass`
+
+        Arguments:
+            superclass (type): Superclass of plug-in
+            cls (object): Subclass of `superclass`
+        """
+
+        if superclass not in self._registered_plugins:
+            self._registered_plugins[superclass] = list()
+
+        if cls not in self._registered_plugins[superclass]:
+            self._registered_plugins[superclass].append(cls)
+
+    def register_plugin_path(self, superclass, path):
+        """Register a directory of one or more plug-ins
+
+        Arguments:
+            superclass (type): Superclass of plug-ins to look for during discovery
+            path (str): Absolute path to directory in which to discover plug-ins
+
+        """
+
+        if superclass not in self._registered_plugin_paths:
+            self._registered_plugin_paths[superclass] = list()
+
+        path = os.path.normpath(path)
+        if path not in self._registered_plugin_paths[superclass]:
+            self._registered_plugin_paths[superclass].append(path)
+
+    def registered_plugin_paths(self):
+        """Return all currently registered plug-in paths"""
+        # Prohibit editing in-place
+        duplicate = {
+            superclass: paths[:]
+            for superclass, paths in self._registered_plugin_paths.items()
+        }
+        return duplicate
+
+    def deregister_plugin(self, superclass, plugin):
+        """Oppsite of `register_plugin()`"""
+        if superclass in self._registered_plugins:
+            self._registered_plugins[superclass].remove(plugin)
+
+    def deregister_plugin_path(self, superclass, path):
+        """Oppsite of `register_plugin_path()`"""
+        self._registered_plugin_paths[superclass].remove(path)
+
+
+class GlobalDiscover:
+    _context = None
+
+    @classmethod
+    def get_context(cls):
+        if cls._context is None:
+            cls._context = PluginDiscoverContext()
+        return cls._context
+
+
+def discover(superclass, allow_duplicates=True):
+    context = GlobalDiscover.get_context()
+    return context.discover(superclass, allow_duplicates)
+
+
+def get_last_discovered_plugins(superclass):
+    context = GlobalDiscover.get_context()
+    return context.get_last_discovered_plugins(superclass)
+
+
+def register_plugin(superclass, cls):
+    context = GlobalDiscover.get_context()
+    context.register_plugin(superclass, cls)
+
+
+def register_plugin_path(superclass, path):
+    context = GlobalDiscover.get_context()
+    context.register_plugin_path(superclass, path)
+
+
+def deregister_plugin(superclass, cls):
+    context = GlobalDiscover.get_context()
+    context.deregister_plugin(superclass, cls)
+
+
+def deregister_plugin_path(superclass, path):
+    context = GlobalDiscover.get_context()
+    context.deregister_plugin_path(superclass, path)

From 239f70a8f76df1536b19a0f07d6c070b0cf74b3d Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 23 Mar 2022 14:51:04 +0100
Subject: [PATCH 012/108] added better check of classes and subclasses

---
 openpype/lib/python_module_tools.py | 21 ++++++++-------------
 1 file changed, 8 insertions(+), 13 deletions(-)

diff --git a/openpype/lib/python_module_tools.py b/openpype/lib/python_module_tools.py
index f62c848e4a..4ef31b5579 100644
--- a/openpype/lib/python_module_tools.py
+++ b/openpype/lib/python_module_tools.py
@@ -5,8 +5,9 @@ import importlib
 import inspect
 import logging
 
+import six
+
 log = logging.getLogger(__name__)
-PY3 = sys.version_info[0] == 3
 
 
 def import_filepath(filepath, module_name=None):
@@ -28,7 +29,7 @@ def import_filepath(filepath, module_name=None):
     # Prepare module object where content of file will be parsed
     module = types.ModuleType(module_name)
 
-    if PY3:
+    if six.PY3:
         # Use loader so module has full specs
         module_loader = importlib.machinery.SourceFileLoader(
             module_name, filepath
@@ -38,7 +39,7 @@ def import_filepath(filepath, module_name=None):
         # Execute module code and store content to module
         with open(filepath) as _stream:
             # Execute content and store it to module object
-            exec(_stream.read(), module.__dict__)
+            six.exec_(_stream.read(), module.__dict__)
 
         module.__file__ = filepath
     return module
@@ -129,20 +130,14 @@ def classes_from_module(superclass, module):
     for name in dir(module):
         # It could be anything at this point
         obj = getattr(module, name)
-        if not inspect.isclass(obj):
-            continue
-
-        # These are subclassed from nothing, not even `object`
-        if not len(obj.__bases__) > 0:
+        if not inspect.isclass(obj) or obj is superclass:
             continue
 
         # Use string comparison rather than `issubclass`
         # in order to support reloading of this module.
-        bases = recursive_bases_from_class(obj)
-        if not any(base.__name__ == superclass.__name__ for base in bases):
-            continue
+        if issubclass(obj, superclass):
+            classes.append(obj)
 
-        classes.append(obj)
     return classes
 
 
@@ -228,7 +223,7 @@ def import_module_from_dirpath(dirpath, folder_name, dst_module_name=None):
         dst_module_name(str): Parent module name under which can be loaded
             module added.
     """
-    if PY3:
+    if six.PY3:
         module = _import_module_from_dirpath_py3(
             dirpath, folder_name, dst_module_name
         )

From dc9852a0d6fde1c40b33bdb1508156738affae02 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 23 Mar 2022 14:53:14 +0100
Subject: [PATCH 013/108] use new register and discover functions for load,
 thumbnail and actions

---
 openpype/pipeline/actions.py      | 43 ++++++++++++-------------------
 openpype/pipeline/load/plugins.py | 40 ++++++++++++++--------------
 openpype/pipeline/thumbnail.py    | 17 ++++++------
 3 files changed, 44 insertions(+), 56 deletions(-)

diff --git a/openpype/pipeline/actions.py b/openpype/pipeline/actions.py
index a045c92aa7..6cb2e9a5a4 100644
--- a/openpype/pipeline/actions.py
+++ b/openpype/pipeline/actions.py
@@ -1,4 +1,11 @@
 import logging
+from openpype.pipeline.plugin_discover import (
+    discover,
+    register_plugin,
+    register_plugin_path,
+    deregister_plugin,
+    deregister_plugin_path
+)
 
 
 class LauncherAction(object):
@@ -90,57 +97,39 @@ class InventoryAction(object):
 
 # Launcher action
 def discover_launcher_actions():
-    import avalon.api
-
-    return avalon.api.discover(LauncherAction)
+    return discover(LauncherAction).plugins
 
 
 def register_launcher_action(plugin):
-    import avalon.api
-
-    return avalon.api.register_plugin(LauncherAction, plugin)
+    return register_plugin(LauncherAction, plugin)
 
 
 def register_launcher_action_path(path):
-    import avalon.api
-
-    return avalon.api.register_plugin_path(LauncherAction, path)
+    return register_plugin_path(LauncherAction, path)
 
 
 # Inventory action
 def discover_inventory_actions():
-    import avalon.api
-
-    actions = avalon.api.discover(InventoryAction)
+    actions = discover(InventoryAction).plugins
     filtered_actions = []
     for action in actions:
         if action is not InventoryAction:
-            print("DISCOVERED", action)
             filtered_actions.append(action)
-        else:
-            print("GOT SOURCE")
+
     return filtered_actions
 
 
 def register_inventory_action(plugin):
-    import avalon.api
-
-    return avalon.api.register_plugin(InventoryAction, plugin)
+    return register_plugin(InventoryAction, plugin)
 
 
 def deregister_inventory_action(plugin):
-    import avalon.api
-
-    avalon.api.deregister_plugin(InventoryAction, plugin)
+    deregister_plugin(InventoryAction, plugin)
 
 
 def register_inventory_action_path(path):
-    import avalon.api
-
-    return avalon.api.register_plugin_path(InventoryAction, path)
+    return register_plugin_path(InventoryAction, path)
 
 
 def deregister_inventory_action_path(path):
-    import avalon.api
-
-    return avalon.api.deregister_plugin_path(InventoryAction, path)
+    return deregister_plugin_path(InventoryAction, path)
diff --git a/openpype/pipeline/load/plugins.py b/openpype/pipeline/load/plugins.py
index 9b2b6bb084..fb5d1df9b5 100644
--- a/openpype/pipeline/load/plugins.py
+++ b/openpype/pipeline/load/plugins.py
@@ -1,5 +1,13 @@
 import logging
 
+from openpype.lib import set_plugin_attributes_from_settings
+from openpype.pipeline.plugin_discover import (
+    discover,
+    register_plugin,
+    register_plugin_path,
+    deregister_plugin,
+    deregister_plugin_path
+)
 from .utils import get_representation_path_from_context
 
 
@@ -102,30 +110,22 @@ class SubsetLoaderPlugin(LoaderPlugin):
 
 
 def discover_loader_plugins():
-    import avalon.api
-
-    return avalon.api.discover(LoaderPlugin)
+    plugins = discover(LoaderPlugin).plugins
+    set_plugin_attributes_from_settings(plugins, LoaderPlugin)
+    return plugins
 
 
 def register_loader_plugin(plugin):
-    import avalon.api
-
-    return avalon.api.register_plugin(LoaderPlugin, plugin)
-
-
-def deregister_loader_plugin_path(path):
-    import avalon.api
-
-    avalon.api.deregister_plugin_path(LoaderPlugin, path)
-
-
-def register_loader_plugin_path(path):
-    import avalon.api
-
-    return avalon.api.register_plugin_path(LoaderPlugin, path)
+    return register_plugin(LoaderPlugin, plugin)
 
 
 def deregister_loader_plugin(plugin):
-    import avalon.api
+    deregister_plugin(LoaderPlugin, plugin)
 
-    avalon.api.deregister_plugin(LoaderPlugin, plugin)
+
+def deregister_loader_plugin_path(path):
+    deregister_plugin_path(LoaderPlugin, path)
+
+
+def register_loader_plugin_path(path):
+    return register_plugin_path(LoaderPlugin, path)
diff --git a/openpype/pipeline/thumbnail.py b/openpype/pipeline/thumbnail.py
index 12bab83be6..47452b21e7 100644
--- a/openpype/pipeline/thumbnail.py
+++ b/openpype/pipeline/thumbnail.py
@@ -2,6 +2,11 @@ import os
 import copy
 import logging
 
+from .plugin_discover import (
+    discover,
+    register_plugin,
+    register_plugin_path,
+)
 log = logging.getLogger(__name__)
 
 
@@ -126,21 +131,15 @@ class BinaryThumbnail(ThumbnailResolver):
 
 # Thumbnail resolvers
 def discover_thumbnail_resolvers():
-    import avalon.api
-
-    return avalon.api.discover(ThumbnailResolver)
+    return discover(ThumbnailResolver).plugins
 
 
 def register_thumbnail_resolver(plugin):
-    import avalon.api
-
-    return avalon.api.register_plugin(ThumbnailResolver, plugin)
+    register_plugin(ThumbnailResolver, plugin)
 
 
 def register_thumbnail_resolver_path(path):
-    import avalon.api
-
-    return avalon.api.register_plugin_path(ThumbnailResolver, path)
+    register_plugin_path(ThumbnailResolver, path)
 
 
 register_thumbnail_resolver(TemplateResolver)

From 645531f4025f7606c90f92f6ce846876e9e05c51 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 23 Mar 2022 15:05:10 +0100
Subject: [PATCH 014/108] creators have their specific functions

---
 openpype/pipeline/__init__.py               | 14 ++++++
 openpype/pipeline/create/__init__.py        | 16 ++++++-
 openpype/pipeline/create/creator_plugins.py | 51 ++++++++++++++++++++-
 3 files changed, 79 insertions(+), 2 deletions(-)

diff --git a/openpype/pipeline/__init__.py b/openpype/pipeline/__init__.py
index d44fbad33e..eaee180619 100644
--- a/openpype/pipeline/__init__.py
+++ b/openpype/pipeline/__init__.py
@@ -15,6 +15,13 @@ from .create import (
 
     LegacyCreator,
     legacy_create,
+
+    discover_creator_plugins,
+    discover_legacy_creator_plugins,
+    register_creator_plugin,
+    deregister_creator_plugin,
+    register_creator_plugin_path,
+    deregister_creator_plugin_path,
 )
 
 from .load import (
@@ -81,6 +88,13 @@ __all__ = (
     "LegacyCreator",
     "legacy_create",
 
+    "discover_creator_plugins",
+    "discover_legacy_creator_plugins",
+    "register_creator_plugin",
+    "deregister_creator_plugin",
+    "register_creator_plugin_path",
+    "deregister_creator_plugin_path",
+
     # --- Load ---
     "HeroVersionType",
     "IncompatibleLoaderError",
diff --git a/openpype/pipeline/create/__init__.py b/openpype/pipeline/create/__init__.py
index 9571f56b8f..1beeb4267b 100644
--- a/openpype/pipeline/create/__init__.py
+++ b/openpype/pipeline/create/__init__.py
@@ -6,7 +6,14 @@ from .creator_plugins import (
 
     BaseCreator,
     Creator,
-    AutoCreator
+    AutoCreator,
+
+    discover_creator_plugins,
+    discover_legacy_creator_plugins,
+    register_creator_plugin,
+    deregister_creator_plugin,
+    register_creator_plugin_path,
+    deregister_creator_plugin_path,
 )
 
 from .context import (
@@ -29,6 +36,13 @@ __all__ = (
     "Creator",
     "AutoCreator",
 
+    "discover_creator_plugins",
+    "discover_legacy_creator_plugins",
+    "register_creator_plugin",
+    "deregister_creator_plugin",
+    "register_creator_plugin_path",
+    "deregister_creator_plugin_path",
+
     "CreatedInstance",
     "CreateContext",
 
diff --git a/openpype/pipeline/create/creator_plugins.py b/openpype/pipeline/create/creator_plugins.py
index 1ac2c420a2..dbeeb94050 100644
--- a/openpype/pipeline/create/creator_plugins.py
+++ b/openpype/pipeline/create/creator_plugins.py
@@ -8,7 +8,19 @@ from abc import (
 )
 import six
 
-from openpype.lib import get_subset_name_with_asset_doc
+from openpype.lib import (
+    get_subset_name_with_asset_doc,
+    set_plugin_attributes_from_settings,
+)
+from openpype.pipeline.plugin_discover import (
+    discover,
+    register_plugin,
+    register_plugin_path,
+    deregister_plugin,
+    deregister_plugin_path
+)
+
+from .legacy_create import LegacyCreator
 
 
 class CreatorError(Exception):
@@ -284,6 +296,43 @@ class AutoCreator(BaseCreator):
 
     Can be used e.g. for `workfile`.
     """
+
     def remove_instances(self, instances):
         """Skip removement."""
         pass
+
+
+def discover_creator_plugins():
+    return discover(BaseCreator).plugins
+
+
+def discover_legacy_creator_plugins():
+    plugins = discover(LegacyCreator).plugins
+    set_plugin_attributes_from_settings(plugins, LegacyCreator)
+    return plugins
+
+
+def register_creator_plugin(plugin):
+    if issubclass(plugin, BaseCreator):
+        register_plugin(BaseCreator, plugin)
+
+    elif issubclass(plugin, LegacyCreator):
+        register_plugin(LegacyCreator, plugin)
+
+
+def deregister_creator_plugin(plugin):
+    if issubclass(plugin, BaseCreator):
+        deregister_plugin(BaseCreator, plugin)
+
+    elif issubclass(plugin, LegacyCreator):
+        deregister_plugin(LegacyCreator, plugin)
+
+
+def register_creator_plugin_path(path):
+    register_plugin_path(BaseCreator, path)
+    register_plugin_path(LegacyCreator, path)
+
+
+def deregister_creator_plugin_path(path):
+    deregister_plugin_path(BaseCreator, path)
+    deregister_plugin_path(LegacyCreator, path)

From 77e2f6eb8d40315dd84cade6a40828e120f8811b Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 23 Mar 2022 15:11:43 +0100
Subject: [PATCH 015/108] use create register/discover functions in code

---
 openpype/hosts/aftereffects/api/pipeline.py         |  8 ++++----
 openpype/hosts/blender/api/pipeline.py              |  7 ++++---
 openpype/hosts/flame/api/pipeline.py                |  8 ++++----
 openpype/hosts/fusion/api/pipeline.py               | 10 +++++-----
 openpype/hosts/harmony/api/pipeline.py              |  7 ++++---
 openpype/hosts/hiero/api/pipeline.py                |  8 ++++----
 openpype/hosts/houdini/api/pipeline.py              |  4 ++--
 openpype/hosts/maya/api/pipeline.py                 |  6 ++++--
 openpype/hosts/nuke/api/lib.py                      |  3 ++-
 openpype/hosts/nuke/api/pipeline.py                 |  8 ++++----
 .../nuke/plugins/publish/validate_write_legacy.py   |  5 ++---
 openpype/hosts/photoshop/api/pipeline.py            |  7 ++++---
 openpype/hosts/resolve/api/pipeline.py              | 13 ++++++++-----
 openpype/hosts/tvpaint/api/pipeline.py              |  7 ++++---
 openpype/hosts/unreal/api/pipeline.py               |  7 ++++---
 openpype/lib/avalon_context.py                      |  4 ++--
 openpype/pipeline/create/context.py                 |  5 +++--
 openpype/tools/creator/model.py                     |  5 ++---
 18 files changed, 66 insertions(+), 56 deletions(-)

diff --git a/openpype/hosts/aftereffects/api/pipeline.py b/openpype/hosts/aftereffects/api/pipeline.py
index bb9affc9b6..94bc369856 100644
--- a/openpype/hosts/aftereffects/api/pipeline.py
+++ b/openpype/hosts/aftereffects/api/pipeline.py
@@ -5,15 +5,15 @@ from Qt import QtWidgets
 from bson.objectid import ObjectId
 
 import pyblish.api
-import avalon.api
 from avalon import io
 
 from openpype import lib
 from openpype.api import Logger
 from openpype.pipeline import (
-    LegacyCreator,
     register_loader_plugin_path,
+    register_creator_plugin_path,
     deregister_loader_plugin_path,
+    deregister_creator_plugin_path,
     AVALON_CONTAINER_ID,
 )
 import openpype.hosts.aftereffects
@@ -73,7 +73,7 @@ def install():
     pyblish.api.register_plugin_path(PUBLISH_PATH)
 
     register_loader_plugin_path(LOAD_PATH)
-    avalon.api.register_plugin_path(LegacyCreator, CREATE_PATH)
+    register_creator_plugin_path(CREATE_PATH)
     log.info(PUBLISH_PATH)
 
     pyblish.api.register_callback(
@@ -86,7 +86,7 @@ def install():
 def uninstall():
     pyblish.api.deregister_plugin_path(PUBLISH_PATH)
     deregister_loader_plugin_path(LOAD_PATH)
-    avalon.api.deregister_plugin_path(LegacyCreator, CREATE_PATH)
+    deregister_creator_plugin_path(CREATE_PATH)
 
 
 def on_pyblish_instance_toggled(instance, old_value, new_value):
diff --git a/openpype/hosts/blender/api/pipeline.py b/openpype/hosts/blender/api/pipeline.py
index 8c580cf214..b9ec2cfea4 100644
--- a/openpype/hosts/blender/api/pipeline.py
+++ b/openpype/hosts/blender/api/pipeline.py
@@ -14,9 +14,10 @@ import avalon.api
 from avalon import io, schema
 
 from openpype.pipeline import (
-    LegacyCreator,
     register_loader_plugin_path,
+    register_creator_plugin_path,
     deregister_loader_plugin_path,
+    deregister_creator_plugin_path,
     AVALON_CONTAINER_ID,
 )
 from openpype.api import Logger
@@ -54,7 +55,7 @@ def install():
     pyblish.api.register_plugin_path(str(PUBLISH_PATH))
 
     register_loader_plugin_path(str(LOAD_PATH))
-    avalon.api.register_plugin_path(LegacyCreator, str(CREATE_PATH))
+    register_creator_plugin_path(str(CREATE_PATH))
 
     lib.append_user_scripts()
 
@@ -76,7 +77,7 @@ def uninstall():
     pyblish.api.deregister_plugin_path(str(PUBLISH_PATH))
 
     deregister_loader_plugin_path(str(LOAD_PATH))
-    avalon.api.deregister_plugin_path(LegacyCreator, str(CREATE_PATH))
+    deregister_creator_plugin_path(str(CREATE_PATH))
 
     if not IS_HEADLESS:
         ops.unregister()
diff --git a/openpype/hosts/flame/api/pipeline.py b/openpype/hosts/flame/api/pipeline.py
index ca3f38c1bc..da44be1b15 100644
--- a/openpype/hosts/flame/api/pipeline.py
+++ b/openpype/hosts/flame/api/pipeline.py
@@ -3,14 +3,14 @@ Basic avalon integration
 """
 import os
 import contextlib
-from avalon import api as avalon
 from pyblish import api as pyblish
 
 from openpype.api import Logger
 from openpype.pipeline import (
-    LegacyCreator,
     register_loader_plugin_path,
+    register_creator_plugin_path,
     deregister_loader_plugin_path,
+    deregister_creator_plugin_path,
     AVALON_CONTAINER_ID,
 )
 from .lib import (
@@ -37,7 +37,7 @@ def install():
     pyblish.register_host("flame")
     pyblish.register_plugin_path(PUBLISH_PATH)
     register_loader_plugin_path(LOAD_PATH)
-    avalon.register_plugin_path(LegacyCreator, CREATE_PATH)
+    register_creator_plugin_path(CREATE_PATH)
     log.info("OpenPype Flame plug-ins registred ...")
 
     # register callback for switching publishable
@@ -52,7 +52,7 @@ def uninstall():
     log.info("Deregistering Flame plug-ins..")
     pyblish.deregister_plugin_path(PUBLISH_PATH)
     deregister_loader_plugin_path(LOAD_PATH)
-    avalon.deregister_plugin_path(LegacyCreator, CREATE_PATH)
+    deregister_creator_plugin_path(CREATE_PATH)
 
     # register callback for switching publishable
     pyblish.deregister_callback("instanceToggled", on_pyblish_instance_toggled)
diff --git a/openpype/hosts/fusion/api/pipeline.py b/openpype/hosts/fusion/api/pipeline.py
index c9cd76770a..0867b464d5 100644
--- a/openpype/hosts/fusion/api/pipeline.py
+++ b/openpype/hosts/fusion/api/pipeline.py
@@ -7,14 +7,14 @@ import logging
 import contextlib
 
 import pyblish.api
-import avalon.api
 
 from openpype.api import Logger
 from openpype.pipeline import (
-    LegacyCreator,
     register_loader_plugin_path,
-    deregister_loader_plugin_path,
+    register_creator_plugin_path,
     register_inventory_action_path,
+    deregister_loader_plugin_path,
+    deregister_creator_plugin_path,
     deregister_inventory_action_path,
     AVALON_CONTAINER_ID,
 )
@@ -70,7 +70,7 @@ def install():
     log.info("Registering Fusion plug-ins..")
 
     register_loader_plugin_path(LOAD_PATH)
-    avalon.api.register_plugin_path(LegacyCreator, CREATE_PATH)
+    register_creator_plugin_path(CREATE_PATH)
     register_inventory_action_path(INVENTORY_PATH)
 
     pyblish.api.register_callback(
@@ -94,7 +94,7 @@ def uninstall():
     log.info("Deregistering Fusion plug-ins..")
 
     deregister_loader_plugin_path(LOAD_PATH)
-    avalon.api.deregister_plugin_path(LegacyCreator, CREATE_PATH)
+    deregister_creator_plugin_path(CREATE_PATH)
     deregister_inventory_action_path(INVENTORY_PATH)
 
     pyblish.api.deregister_callback(
diff --git a/openpype/hosts/harmony/api/pipeline.py b/openpype/hosts/harmony/api/pipeline.py
index 420e9720db..b7d5941182 100644
--- a/openpype/hosts/harmony/api/pipeline.py
+++ b/openpype/hosts/harmony/api/pipeline.py
@@ -11,9 +11,10 @@ import avalon.api
 from openpype import lib
 from openpype.lib import register_event_callback
 from openpype.pipeline import (
-    LegacyCreator,
     register_loader_plugin_path,
+    register_creator_plugin_path,
     deregister_loader_plugin_path,
+    deregister_creator_plugin_path,
     AVALON_CONTAINER_ID,
 )
 import openpype.hosts.harmony
@@ -186,7 +187,7 @@ def install():
     pyblish.api.register_host("harmony")
     pyblish.api.register_plugin_path(PUBLISH_PATH)
     register_loader_plugin_path(LOAD_PATH)
-    avalon.api.register_plugin_path(LegacyCreator, CREATE_PATH)
+    register_creator_plugin_path(CREATE_PATH)
     log.info(PUBLISH_PATH)
 
     # Register callbacks.
@@ -200,7 +201,7 @@ def install():
 def uninstall():
     pyblish.api.deregister_plugin_path(PUBLISH_PATH)
     deregister_loader_plugin_path(LOAD_PATH)
-    avalon.api.deregister_plugin_path(LegacyCreator, CREATE_PATH)
+    deregister_creator_plugin_path(CREATE_PATH)
 
 
 def on_pyblish_instance_toggled(instance, old_value, new_value):
diff --git a/openpype/hosts/hiero/api/pipeline.py b/openpype/hosts/hiero/api/pipeline.py
index 0d3c8914ce..b334102129 100644
--- a/openpype/hosts/hiero/api/pipeline.py
+++ b/openpype/hosts/hiero/api/pipeline.py
@@ -5,13 +5,13 @@ import os
 import contextlib
 from collections import OrderedDict
 
-from avalon import api as avalon
 from avalon import schema
 from pyblish import api as pyblish
 from openpype.api import Logger
 from openpype.pipeline import (
-    LegacyCreator,
+    register_creator_plugin_path,
     register_loader_plugin_path,
+    deregister_creator_plugin_path,
     deregister_loader_plugin_path,
     AVALON_CONTAINER_ID,
 )
@@ -50,7 +50,7 @@ def install():
     pyblish.register_host("hiero")
     pyblish.register_plugin_path(PUBLISH_PATH)
     register_loader_plugin_path(LOAD_PATH)
-    avalon.register_plugin_path(LegacyCreator, CREATE_PATH)
+    register_creator_plugin_path(CREATE_PATH)
 
     # register callback for switching publishable
     pyblish.register_callback("instanceToggled", on_pyblish_instance_toggled)
@@ -71,7 +71,7 @@ def uninstall():
     pyblish.deregister_host("hiero")
     pyblish.deregister_plugin_path(PUBLISH_PATH)
     deregister_loader_plugin_path(LOAD_PATH)
-    avalon.deregister_plugin_path(LegacyCreator, CREATE_PATH)
+    deregister_creator_plugin_path(CREATE_PATH)
 
     # register callback for switching publishable
     pyblish.deregister_callback("instanceToggled", on_pyblish_instance_toggled)
diff --git a/openpype/hosts/houdini/api/pipeline.py b/openpype/hosts/houdini/api/pipeline.py
index d079c9ea81..8e093a89bc 100644
--- a/openpype/hosts/houdini/api/pipeline.py
+++ b/openpype/hosts/houdini/api/pipeline.py
@@ -11,7 +11,7 @@ import avalon.api
 from avalon.lib import find_submodule
 
 from openpype.pipeline import (
-    LegacyCreator,
+    register_creator_plugin_path,
     register_loader_plugin_path,
     AVALON_CONTAINER_ID,
 )
@@ -54,7 +54,7 @@ def install():
 
     pyblish.api.register_plugin_path(PUBLISH_PATH)
     register_loader_plugin_path(LOAD_PATH)
-    avalon.api.register_plugin_path(LegacyCreator, CREATE_PATH)
+    register_creator_plugin_path(CREATE_PATH)
 
     log.info("Installing callbacks ... ")
     # register_event_callback("init", on_init)
diff --git a/openpype/hosts/maya/api/pipeline.py b/openpype/hosts/maya/api/pipeline.py
index bb61128178..a8834d1ea3 100644
--- a/openpype/hosts/maya/api/pipeline.py
+++ b/openpype/hosts/maya/api/pipeline.py
@@ -23,8 +23,10 @@ from openpype.pipeline import (
     LegacyCreator,
     register_loader_plugin_path,
     register_inventory_action_path,
+    register_creator_plugin_path,
     deregister_loader_plugin_path,
     deregister_inventory_action_path,
+    deregister_creator_plugin_path,
     AVALON_CONTAINER_ID,
 )
 from openpype.hosts.maya.lib import copy_workspace_mel
@@ -60,7 +62,7 @@ def install():
     pyblish.api.register_host("maya")
 
     register_loader_plugin_path(LOAD_PATH)
-    avalon.api.register_plugin_path(LegacyCreator, CREATE_PATH)
+    register_creator_plugin_path(CREATE_PATH)
     register_inventory_action_path(INVENTORY_PATH)
     log.info(PUBLISH_PATH)
 
@@ -189,7 +191,7 @@ def uninstall():
     pyblish.api.deregister_host("maya")
 
     deregister_loader_plugin_path(LOAD_PATH)
-    avalon.api.deregister_plugin_path(LegacyCreator, CREATE_PATH)
+    deregister_creator_plugin_path(CREATE_PATH)
     deregister_inventory_action_path(INVENTORY_PATH)
 
     menu.uninstall()
diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index 3c8ba3e77c..c22488f728 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -26,6 +26,7 @@ from openpype.tools.utils import host_tools
 from openpype.lib.path_tools import HostDirmap
 from openpype.settings import get_project_settings
 from openpype.modules import ModulesManager
+from openpype.pipeline import discover_legacy_creator_plugins
 
 from .workio import (
     save_file,
@@ -1902,7 +1903,7 @@ def recreate_instance(origin_node, avalon_data=None):
     # create new node
     # get appropriate plugin class
     creator_plugin = None
-    for Creator in api.discover(api.Creator):
+    for Creator in discover_legacy_creator_plugins():
         if Creator.__name__ == data["creator"]:
             creator_plugin = Creator
             break
diff --git a/openpype/hosts/nuke/api/pipeline.py b/openpype/hosts/nuke/api/pipeline.py
index 1d110cb94a..6ee3d2ce05 100644
--- a/openpype/hosts/nuke/api/pipeline.py
+++ b/openpype/hosts/nuke/api/pipeline.py
@@ -5,7 +5,6 @@ from collections import OrderedDict
 import nuke
 
 import pyblish.api
-import avalon.api
 
 import openpype
 from openpype.api import (
@@ -15,10 +14,11 @@ from openpype.api import (
 )
 from openpype.lib import register_event_callback
 from openpype.pipeline import (
-    LegacyCreator,
     register_loader_plugin_path,
+    register_creator_plugin_path,
     register_inventory_action_path,
     deregister_loader_plugin_path,
+    deregister_creator_plugin_path,
     deregister_inventory_action_path,
     AVALON_CONTAINER_ID,
 )
@@ -106,7 +106,7 @@ def install():
     log.info("Registering Nuke plug-ins..")
     pyblish.api.register_plugin_path(PUBLISH_PATH)
     register_loader_plugin_path(LOAD_PATH)
-    avalon.api.register_plugin_path(LegacyCreator, CREATE_PATH)
+    register_creator_plugin_path(CREATE_PATH)
     register_inventory_action_path(INVENTORY_PATH)
 
     # Register Avalon event for workfiles loading.
@@ -132,7 +132,7 @@ def uninstall():
     pyblish.deregister_host("nuke")
     pyblish.api.deregister_plugin_path(PUBLISH_PATH)
     deregister_loader_plugin_path(LOAD_PATH)
-    avalon.api.deregister_plugin_path(LegacyCreator, CREATE_PATH)
+    deregister_creator_plugin_path(CREATE_PATH)
     deregister_inventory_action_path(INVENTORY_PATH)
 
     pyblish.api.deregister_callback(
diff --git a/openpype/hosts/nuke/plugins/publish/validate_write_legacy.py b/openpype/hosts/nuke/plugins/publish/validate_write_legacy.py
index 08f09f8097..9fb57c1698 100644
--- a/openpype/hosts/nuke/plugins/publish/validate_write_legacy.py
+++ b/openpype/hosts/nuke/plugins/publish/validate_write_legacy.py
@@ -1,11 +1,10 @@
-import os
 import toml
 
 import nuke
 
-from avalon import api
 import pyblish.api
 import openpype.api
+from openpype.pipeline import discover_creator_plugins
 from openpype.hosts.nuke.api.lib import get_avalon_knob_data
 
 
@@ -79,7 +78,7 @@ class ValidateWriteLegacy(pyblish.api.InstancePlugin):
 
         # get appropriate plugin class
         creator_plugin = None
-        for Creator in api.discover(api.Creator):
+        for Creator in discover_creator_plugins():
             if Creator.__name__ != Create_name:
                 continue
 
diff --git a/openpype/hosts/photoshop/api/pipeline.py b/openpype/hosts/photoshop/api/pipeline.py
index c2ad0ac7b0..7fdaa61b40 100644
--- a/openpype/hosts/photoshop/api/pipeline.py
+++ b/openpype/hosts/photoshop/api/pipeline.py
@@ -9,9 +9,10 @@ from avalon import io
 from openpype.api import Logger
 from openpype.lib import register_event_callback
 from openpype.pipeline import (
-    LegacyCreator,
     register_loader_plugin_path,
+    register_creator_plugin_path,
     deregister_loader_plugin_path,
+    deregister_creator_plugin_path,
     AVALON_CONTAINER_ID,
 )
 import openpype.hosts.photoshop
@@ -75,7 +76,7 @@ def install():
 
     pyblish.api.register_plugin_path(PUBLISH_PATH)
     register_loader_plugin_path(LOAD_PATH)
-    avalon.api.register_plugin_path(LegacyCreator, CREATE_PATH)
+    register_creator_plugin_path(CREATE_PATH)
     log.info(PUBLISH_PATH)
 
     pyblish.api.register_callback(
@@ -88,7 +89,7 @@ def install():
 def uninstall():
     pyblish.api.deregister_plugin_path(PUBLISH_PATH)
     deregister_loader_plugin_path(LOAD_PATH)
-    avalon.api.deregister_plugin_path(LegacyCreator, CREATE_PATH)
+    deregister_creator_plugin_path(CREATE_PATH)
 
 
 def ls():
diff --git a/openpype/hosts/resolve/api/pipeline.py b/openpype/hosts/resolve/api/pipeline.py
index e8b017ead5..636c826a11 100644
--- a/openpype/hosts/resolve/api/pipeline.py
+++ b/openpype/hosts/resolve/api/pipeline.py
@@ -4,14 +4,17 @@ Basic avalon integration
 import os
 import contextlib
 from collections import OrderedDict
-from avalon import api as avalon
-from avalon import schema
+
 from pyblish import api as pyblish
+
+from avalon import schema
+
 from openpype.api import Logger
 from openpype.pipeline import (
-    LegacyCreator,
     register_loader_plugin_path,
+    register_creator_plugin_path,
     deregister_loader_plugin_path,
+    deregister_creator_plugin_path,
     AVALON_CONTAINER_ID,
 )
 from . import lib
@@ -46,7 +49,7 @@ def install():
     log.info("Registering DaVinci Resovle plug-ins..")
 
     register_loader_plugin_path(LOAD_PATH)
-    avalon.register_plugin_path(LegacyCreator, CREATE_PATH)
+    register_creator_plugin_path(CREATE_PATH)
 
     # register callback for switching publishable
     pyblish.register_callback("instanceToggled", on_pyblish_instance_toggled)
@@ -70,7 +73,7 @@ def uninstall():
     log.info("Deregistering DaVinci Resovle plug-ins..")
 
     deregister_loader_plugin_path(LOAD_PATH)
-    avalon.deregister_plugin_path(LegacyCreator, CREATE_PATH)
+    deregister_creator_plugin_path(CREATE_PATH)
 
     # register callback for switching publishable
     pyblish.deregister_callback("instanceToggled", on_pyblish_instance_toggled)
diff --git a/openpype/hosts/tvpaint/api/pipeline.py b/openpype/hosts/tvpaint/api/pipeline.py
index ec880a1abc..cafdf0701d 100644
--- a/openpype/hosts/tvpaint/api/pipeline.py
+++ b/openpype/hosts/tvpaint/api/pipeline.py
@@ -15,9 +15,10 @@ from openpype.hosts import tvpaint
 from openpype.api import get_current_project_settings
 from openpype.lib import register_event_callback
 from openpype.pipeline import (
-    LegacyCreator,
     register_loader_plugin_path,
+    register_creator_plugin_path,
     deregister_loader_plugin_path,
+    deregister_creator_plugin_path,
     AVALON_CONTAINER_ID,
 )
 
@@ -82,7 +83,7 @@ def install():
     pyblish.api.register_host("tvpaint")
     pyblish.api.register_plugin_path(PUBLISH_PATH)
     register_loader_plugin_path(LOAD_PATH)
-    avalon.api.register_plugin_path(LegacyCreator, CREATE_PATH)
+    register_creator_plugin_path(CREATE_PATH)
 
     registered_callbacks = (
         pyblish.api.registered_callbacks().get("instanceToggled") or []
@@ -104,7 +105,7 @@ def uninstall():
     pyblish.api.deregister_host("tvpaint")
     pyblish.api.deregister_plugin_path(PUBLISH_PATH)
     deregister_loader_plugin_path(LOAD_PATH)
-    avalon.api.deregister_plugin_path(LegacyCreator, CREATE_PATH)
+    deregister_creator_plugin_path(CREATE_PATH)
 
 
 def containerise(
diff --git a/openpype/hosts/unreal/api/pipeline.py b/openpype/hosts/unreal/api/pipeline.py
index 713c588976..6d7a6ad1e2 100644
--- a/openpype/hosts/unreal/api/pipeline.py
+++ b/openpype/hosts/unreal/api/pipeline.py
@@ -7,9 +7,10 @@ import pyblish.api
 from avalon import api
 
 from openpype.pipeline import (
-    LegacyCreator,
     register_loader_plugin_path,
+    register_creator_plugin_path,
     deregister_loader_plugin_path,
+    deregister_creator_plugin_path,
     AVALON_CONTAINER_ID,
 )
 from openpype.tools.utils import host_tools
@@ -49,7 +50,7 @@ def install():
     logger.info("installing OpenPype for Unreal")
     pyblish.api.register_plugin_path(str(PUBLISH_PATH))
     register_loader_plugin_path(str(LOAD_PATH))
-    api.register_plugin_path(LegacyCreator, str(CREATE_PATH))
+    register_creator_plugin_path(str(CREATE_PATH))
     _register_callbacks()
     _register_events()
 
@@ -58,7 +59,7 @@ def uninstall():
     """Uninstall Unreal configuration for Avalon."""
     pyblish.api.deregister_plugin_path(str(PUBLISH_PATH))
     deregister_loader_plugin_path(str(LOAD_PATH))
-    api.deregister_plugin_path(LegacyCreator, str(CREATE_PATH))
+    deregister_creator_plugin_path(str(CREATE_PATH))
 
 
 def _register_callbacks():
diff --git a/openpype/lib/avalon_context.py b/openpype/lib/avalon_context.py
index 05d2ffd821..26e05ecd63 100644
--- a/openpype/lib/avalon_context.py
+++ b/openpype/lib/avalon_context.py
@@ -1604,13 +1604,13 @@ def get_creator_by_name(creator_name, case_sensitive=False):
     Returns:
         Creator: Return first matching plugin or `None`.
     """
-    from openpype.pipeline import LegacyCreator
+    from openpype.pipeline import discover_legacy_creator_plugins
 
     # Lower input creator name if is not case sensitive
     if not case_sensitive:
         creator_name = creator_name.lower()
 
-    for creator_plugin in avalon.api.discover(LegacyCreator):
+    for creator_plugin in discover_legacy_creator_plugins():
         _creator_name = creator_plugin.__name__
 
         # Lower creator plugin name if is not case sensitive
diff --git a/openpype/pipeline/create/context.py b/openpype/pipeline/create/context.py
index c2757a4502..21e726e060 100644
--- a/openpype/pipeline/create/context.py
+++ b/openpype/pipeline/create/context.py
@@ -10,7 +10,8 @@ from ..lib import UnknownDef
 from .creator_plugins import (
     BaseCreator,
     Creator,
-    AutoCreator
+    AutoCreator,
+    discover_creator_plugins,
 )
 
 from openpype.api import (
@@ -842,7 +843,7 @@ class CreateContext:
         creators = {}
         autocreators = {}
         manual_creators = {}
-        for creator_class in avalon.api.discover(BaseCreator):
+        for creator_class in discover_creator_plugins(BaseCreator):
             if inspect.isabstract(creator_class):
                 self.log.info(
                     "Skipping abstract Creator {}".format(str(creator_class))
diff --git a/openpype/tools/creator/model.py b/openpype/tools/creator/model.py
index ef61c6e0f0..d3d60b96f2 100644
--- a/openpype/tools/creator/model.py
+++ b/openpype/tools/creator/model.py
@@ -1,8 +1,7 @@
 import uuid
 from Qt import QtGui, QtCore
 
-from avalon import api
-from openpype.pipeline import LegacyCreator
+from openpype.pipeline import discover_legacy_creator_plugins
 
 from . constants import (
     FAMILY_ROLE,
@@ -22,7 +21,7 @@ class CreatorsModel(QtGui.QStandardItemModel):
         self._creators_by_id = {}
 
         items = []
-        creators = api.discover(LegacyCreator)
+        creators = discover_legacy_creator_plugins()
         for creator in creators:
             item_id = str(uuid.uuid4())
             self._creators_by_id[item_id] = creator

From 1612ad0f96d7a9778df9130dece9a29dae6fae8e Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 23 Mar 2022 15:12:18 +0100
Subject: [PATCH 016/108] call 'ls' directly in harmony

---
 openpype/hosts/harmony/api/pipeline.py | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/openpype/hosts/harmony/api/pipeline.py b/openpype/hosts/harmony/api/pipeline.py
index b7d5941182..88f11dd16f 100644
--- a/openpype/hosts/harmony/api/pipeline.py
+++ b/openpype/hosts/harmony/api/pipeline.py
@@ -6,7 +6,6 @@ from bson.objectid import ObjectId
 import pyblish.api
 
 from avalon import io
-import avalon.api
 
 from openpype import lib
 from openpype.lib import register_event_callback
@@ -109,9 +108,8 @@ def check_inventory():
     if not lib.any_outdated():
         return
 
-    host = avalon.api.registered_host()
     outdated_containers = []
-    for container in host.ls():
+    for container in ls():
         representation = container['representation']
         representation_doc = io.find_one(
             {

From b767458bff9573e221303ce6c9d0e7d4137596e7 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 23 Mar 2022 15:12:42 +0100
Subject: [PATCH 017/108] use direct imports of LegacyCreator

---
 .../hosts/aftereffects/plugins/create/create_render.py    | 8 +++++---
 openpype/hosts/fusion/plugins/create/create_exr_saver.py  | 4 ++--
 openpype/hosts/photoshop/plugins/create/create_image.py   | 4 ++--
 3 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/openpype/hosts/aftereffects/plugins/create/create_render.py b/openpype/hosts/aftereffects/plugins/create/create_render.py
index 41efb4b0ba..831085a5f1 100644
--- a/openpype/hosts/aftereffects/plugins/create/create_render.py
+++ b/openpype/hosts/aftereffects/plugins/create/create_render.py
@@ -1,12 +1,14 @@
-from openpype.pipeline import create
-from openpype.pipeline import CreatorError
+from openpype.pipeline import (
+    CreatorError,
+    LegacyCreator
+)
 from openpype.hosts.aftereffects.api import (
     get_stub,
     list_instances
 )
 
 
-class CreateRender(create.LegacyCreator):
+class CreateRender(LegacyCreator):
     """Render folder for publish.
 
         Creates subsets in format 'familyTaskSubsetname',
diff --git a/openpype/hosts/fusion/plugins/create/create_exr_saver.py b/openpype/hosts/fusion/plugins/create/create_exr_saver.py
index ff8bdb21ef..8bab5ee9b1 100644
--- a/openpype/hosts/fusion/plugins/create/create_exr_saver.py
+++ b/openpype/hosts/fusion/plugins/create/create_exr_saver.py
@@ -1,13 +1,13 @@
 import os
 
-from openpype.pipeline import create
+from openpype.pipeline import LegacyCreator
 from openpype.hosts.fusion.api import (
     get_current_comp,
     comp_lock_and_undo_chunk
 )
 
 
-class CreateOpenEXRSaver(create.LegacyCreator):
+class CreateOpenEXRSaver(LegacyCreator):
 
     name = "openexrDefault"
     label = "Create OpenEXR Saver"
diff --git a/openpype/hosts/photoshop/plugins/create/create_image.py b/openpype/hosts/photoshop/plugins/create/create_image.py
index a001b5f171..5078cbb587 100644
--- a/openpype/hosts/photoshop/plugins/create/create_image.py
+++ b/openpype/hosts/photoshop/plugins/create/create_image.py
@@ -1,9 +1,9 @@
 from Qt import QtWidgets
-from openpype.pipeline import create
+from openpype.pipeline import LegacyCreator
 from openpype.hosts.photoshop import api as photoshop
 
 
-class CreateImage(create.LegacyCreator):
+class CreateImage(LegacyCreator):
     """Image folder for publish."""
 
     name = "imageDefault"

From ea79f0908b9070cc8a9301183a8a0432b272a508 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 23 Mar 2022 15:14:22 +0100
Subject: [PATCH 018/108] fix test

---
 openpype/tests/test_avalon_plugin_presets.py | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/openpype/tests/test_avalon_plugin_presets.py b/openpype/tests/test_avalon_plugin_presets.py
index f1b1a94713..c491be1c05 100644
--- a/openpype/tests/test_avalon_plugin_presets.py
+++ b/openpype/tests/test_avalon_plugin_presets.py
@@ -1,6 +1,10 @@
 import avalon.api as api
 import openpype
-from openpype.pipeline import LegacyCreator
+from openpype.pipeline import (
+    LegacyCreator,
+    register_creator_plugin,
+    discover_creator_plugins,
+)
 
 
 class MyTestCreator(LegacyCreator):
@@ -27,8 +31,8 @@ def test_avalon_plugin_presets(monkeypatch, printer):
 
     openpype.install()
     api.register_host(Test())
-    api.register_plugin(LegacyCreator, MyTestCreator)
-    plugins = api.discover(LegacyCreator)
+    register_creator_plugin(MyTestCreator)
+    plugins = discover_creator_plugins()
     printer("Test if we got our test plugin")
     assert MyTestCreator in plugins
     for p in plugins:

From aac580bda4d77b4862ca99e61366955e73d8bf3f Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 23 Mar 2022 15:15:00 +0100
Subject: [PATCH 019/108] removed patched discover logic

---
 openpype/__init__.py | 75 +++++++-------------------------------------
 1 file changed, 11 insertions(+), 64 deletions(-)

diff --git a/openpype/__init__.py b/openpype/__init__.py
index 8b94b2dc3f..2820091bcc 100644
--- a/openpype/__init__.py
+++ b/openpype/__init__.py
@@ -2,20 +2,16 @@
 """Pype module."""
 import os
 import platform
-import functools
 import logging
 
 from .settings import get_project_settings
 from .lib import (
     Anatomy,
     filter_pyblish_plugins,
-    set_plugin_attributes_from_settings,
     change_timer_to_current_context,
     register_event_callback,
 )
 
-pyblish = avalon = _original_discover = None
-
 log = logging.getLogger(__name__)
 
 
@@ -27,60 +23,17 @@ PUBLISH_PATH = os.path.join(PLUGINS_DIR, "publish")
 LOAD_PATH = os.path.join(PLUGINS_DIR, "load")
 
 
-def import_wrapper(func):
-    """Wrap module imports to specific functions."""
-    @functools.wraps(func)
-    def decorated(*args, **kwargs):
-        global pyblish
-        global avalon
-        global _original_discover
-        if pyblish is None:
-            from pyblish import api as pyblish
-            from avalon import api as avalon
-
-            # we are monkey patching `avalon.api.discover()` to allow us to
-            # load plugin presets on plugins being discovered by avalon.
-            # Little bit of hacking, but it allows us to add out own features
-            # without need to modify upstream code.
-
-            _original_discover = avalon.discover
-
-        return func(*args, **kwargs)
-
-    return decorated
-
-
-@import_wrapper
-def patched_discover(superclass):
-    """Patch `avalon.api.discover()`.
-
-    Monkey patched version of :func:`avalon.api.discover()`. It allows
-    us to load presets on plugins being discovered.
-    """
-    # run original discover and get plugins
-    plugins = _original_discover(superclass)
-    filtered_plugins = [
-        plugin
-        for plugin in plugins
-        if issubclass(plugin, superclass)
-    ]
-
-    set_plugin_attributes_from_settings(filtered_plugins, superclass)
-
-    return filtered_plugins
-
-
-@import_wrapper
 def install():
     """Install Pype to Avalon."""
+    import avalon.api
+    import pyblish.api
     from pyblish.lib import MessageHandler
     from openpype.modules import load_modules
     from openpype.pipeline import (
-        LegacyCreator,
         register_loader_plugin_path,
         register_inventory_action,
+        register_creator_plugin_path,
     )
-    from avalon import pipeline
 
     # Make sure modules are loaded
     load_modules()
@@ -93,8 +46,8 @@ def install():
     MessageHandler.emit = modified_emit
 
     log.info("Registering global plug-ins..")
-    pyblish.register_plugin_path(PUBLISH_PATH)
-    pyblish.register_discovery_filter(filter_pyblish_plugins)
+    pyblish.api.register_plugin_path(PUBLISH_PATH)
+    pyblish.api.register_discovery_filter(filter_pyblish_plugins)
     register_loader_plugin_path(LOAD_PATH)
 
     project_name = os.environ.get("AVALON_PROJECT")
@@ -103,7 +56,7 @@ def install():
     if project_name:
         anatomy = Anatomy(project_name)
         anatomy.set_root_environments()
-        avalon.register_root(anatomy.roots)
+        avalon.api.register_root(anatomy.roots)
 
         project_settings = get_project_settings(project_name)
         platform_name = platform.system().lower()
@@ -122,17 +75,14 @@ def install():
             if not path or not os.path.exists(path):
                 continue
 
-            pyblish.register_plugin_path(path)
+            pyblish.api.register_plugin_path(path)
             register_loader_plugin_path(path)
-            avalon.register_plugin_path(LegacyCreator, path)
+            register_creator_plugin_path(path)
             register_inventory_action(path)
 
     # apply monkey patched discover to original one
     log.info("Patching discovery")
 
-    avalon.discover = patched_discover
-    pipeline.discover = patched_discover
-
     register_event_callback("taskChanged", _on_task_change)
 
 
@@ -140,16 +90,13 @@ def _on_task_change():
     change_timer_to_current_context()
 
 
-@import_wrapper
 def uninstall():
     """Uninstall Pype from Avalon."""
+    import pyblish.api
     from openpype.pipeline import deregister_loader_plugin_path
 
     log.info("Deregistering global plug-ins..")
-    pyblish.deregister_plugin_path(PUBLISH_PATH)
-    pyblish.deregister_discovery_filter(filter_pyblish_plugins)
+    pyblish.api.deregister_plugin_path(PUBLISH_PATH)
+    pyblish.api.deregister_discovery_filter(filter_pyblish_plugins)
     deregister_loader_plugin_path(LOAD_PATH)
     log.info("Global plug-ins unregistred")
-
-    # restore original discover
-    avalon.discover = _original_discover

From cd4e01f400344a0351246f70a7ef09b9e0b1cbba Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 23 Mar 2022 15:54:43 +0100
Subject: [PATCH 020/108] print report of failed parts of discover

---
 openpype/pipeline/plugin_discover.py | 56 ++++++++++++++++++++++++++++
 1 file changed, 56 insertions(+)

diff --git a/openpype/pipeline/plugin_discover.py b/openpype/pipeline/plugin_discover.py
index 305a8bab67..f4a133b0aa 100644
--- a/openpype/pipeline/plugin_discover.py
+++ b/openpype/pipeline/plugin_discover.py
@@ -1,5 +1,7 @@
 import os
 import inspect
+import traceback
+
 from openpype.lib.python_module_tools import (
     modules_from_path,
     classes_from_module,
@@ -30,6 +32,59 @@ class DiscoverResult:
     def __setitem__(self, item, value):
         self.plugins[item] = value
 
+    def get_report(self, only_errors=True, exc_info=True, full_report=False):
+        lines = []
+        if not only_errors:
+            # Successfully discovered plugins
+            if self.plugins or full_report:
+                lines.append(
+                    "*** Discovered {} plugins".format(len(self.plugins))
+                )
+                for cls in self.plugins:
+                    lines.append("- {}".format(cls.__class__.__name__))
+
+            # Plugin that were defined to be ignored
+            if self.ignored_plugins or full_report:
+                lines.append("*** Ignored plugins {}".format(len(
+                    self.ignored_plugins
+                )))
+                for cls in self.ignored_plugins:
+                    lines.append("- {}".format(cls.__class__.__name__))
+
+        # Abstract classes
+        if self.abstract_plugins or full_report:
+            lines.append("*** Discovered {} abstract plugins".format(len(
+                self.abstract_plugins
+            )))
+            for cls in self.abstract_plugins:
+                lines.append("- {}".format(cls.__class__.__name__))
+
+        # Abstract classes
+        if self.duplicated_plugins or full_report:
+            lines.append("*** There were {} duplicated plugins".format(len(
+                self.duplicated_plugins
+            )))
+            for cls in self.duplicated_plugins:
+                lines.append("- {}".format(cls.__class__.__name__))
+
+        if self.crashed_file_paths or full_report:
+            lines.append("*** Failed to load {} files".format(len(
+                self.crashed_file_paths
+            )))
+            for path, exc_info_args in self.crashed_file_paths.items():
+                lines.append("- {}".format(path))
+                if exc_info:
+                    lines.append(10 * "*")
+                    lines.extend(traceback.format_exception(*exc_info_args))
+                    lines.append(10 * "*")
+
+        return "\n".join(lines)
+
+    def print_report(self, only_errors=True, exc_info=True):
+        report = self.get_report(only_errors, exc_info)
+        if report:
+            print(report)
+
 
 class PluginDiscoverContext(object):
     """Store and discover registered types nad registered paths to types.
@@ -117,6 +172,7 @@ class PluginDiscoverContext(object):
         self._last_discovered_plugins[superclass] = list(
             result.plugins
         )
+        result.print_report()
         return result
 
     def register_plugin(self, superclass, cls):

From 6bb10852f5aaee9a85a66c83d5a66aeab439d6d1 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Date: Wed, 23 Mar 2022 18:18:59 +0100
Subject: [PATCH 021/108] Fix creator discover

Co-authored-by: Roy Nieterau <roy_nieterau@hotmail.com>
---
 openpype/pipeline/create/context.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/pipeline/create/context.py b/openpype/pipeline/create/context.py
index 21e726e060..d833e6f686 100644
--- a/openpype/pipeline/create/context.py
+++ b/openpype/pipeline/create/context.py
@@ -843,7 +843,7 @@ class CreateContext:
         creators = {}
         autocreators = {}
         manual_creators = {}
-        for creator_class in discover_creator_plugins(BaseCreator):
+        for creator_class in discover_creator_plugins():
             if inspect.isabstract(creator_class):
                 self.log.info(
                     "Skipping abstract Creator {}".format(str(creator_class))

From e3196a40236e4eb1540019333fc30c3a2b5b0cc7 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Date: Wed, 23 Mar 2022 18:30:28 +0100
Subject: [PATCH 022/108] Fix docstring

Co-authored-by: Roy Nieterau <roy_nieterau@hotmail.com>
---
 openpype/pipeline/plugin_discover.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/pipeline/plugin_discover.py b/openpype/pipeline/plugin_discover.py
index f4a133b0aa..a657df7994 100644
--- a/openpype/pipeline/plugin_discover.py
+++ b/openpype/pipeline/plugin_discover.py
@@ -190,7 +190,7 @@ class PluginDiscoverContext(object):
             self._registered_plugins[superclass].append(cls)
 
     def register_plugin_path(self, superclass, path):
-        """Register a directory of one or more plug-ins
+        """Register a directory containing plug-ins of type `superclass`
 
         Arguments:
             superclass (type): Superclass of plug-ins to look for during discovery

From 89d61723de876c02b061198e9462feb7f52d98ba Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 23 Mar 2022 19:20:37 +0100
Subject: [PATCH 023/108] applied comments

---
 openpype/lib/python_module_tools.py         |  2 -
 openpype/pipeline/actions.py                |  4 +-
 openpype/pipeline/create/creator_plugins.py |  4 +-
 openpype/pipeline/load/plugins.py           |  2 +-
 openpype/pipeline/plugin_discover.py        | 88 ++++++++++++++-------
 5 files changed, 66 insertions(+), 34 deletions(-)

diff --git a/openpype/lib/python_module_tools.py b/openpype/lib/python_module_tools.py
index 4ef31b5579..6fad3b547f 100644
--- a/openpype/lib/python_module_tools.py
+++ b/openpype/lib/python_module_tools.py
@@ -133,8 +133,6 @@ def classes_from_module(superclass, module):
         if not inspect.isclass(obj) or obj is superclass:
             continue
 
-        # Use string comparison rather than `issubclass`
-        # in order to support reloading of this module.
         if issubclass(obj, superclass):
             classes.append(obj)
 
diff --git a/openpype/pipeline/actions.py b/openpype/pipeline/actions.py
index 6cb2e9a5a4..b488fe3e1f 100644
--- a/openpype/pipeline/actions.py
+++ b/openpype/pipeline/actions.py
@@ -97,7 +97,7 @@ class InventoryAction(object):
 
 # Launcher action
 def discover_launcher_actions():
-    return discover(LauncherAction).plugins
+    return discover(LauncherAction)
 
 
 def register_launcher_action(plugin):
@@ -110,7 +110,7 @@ def register_launcher_action_path(path):
 
 # Inventory action
 def discover_inventory_actions():
-    actions = discover(InventoryAction).plugins
+    actions = discover(InventoryAction)
     filtered_actions = []
     for action in actions:
         if action is not InventoryAction:
diff --git a/openpype/pipeline/create/creator_plugins.py b/openpype/pipeline/create/creator_plugins.py
index dbeeb94050..c3ba8b1d1c 100644
--- a/openpype/pipeline/create/creator_plugins.py
+++ b/openpype/pipeline/create/creator_plugins.py
@@ -303,11 +303,11 @@ class AutoCreator(BaseCreator):
 
 
 def discover_creator_plugins():
-    return discover(BaseCreator).plugins
+    return discover(BaseCreator)
 
 
 def discover_legacy_creator_plugins():
-    plugins = discover(LegacyCreator).plugins
+    plugins = discover(LegacyCreator)
     set_plugin_attributes_from_settings(plugins, LegacyCreator)
     return plugins
 
diff --git a/openpype/pipeline/load/plugins.py b/openpype/pipeline/load/plugins.py
index fb5d1df9b5..d60aed0083 100644
--- a/openpype/pipeline/load/plugins.py
+++ b/openpype/pipeline/load/plugins.py
@@ -110,7 +110,7 @@ class SubsetLoaderPlugin(LoaderPlugin):
 
 
 def discover_loader_plugins():
-    plugins = discover(LoaderPlugin).plugins
+    plugins = discover(LoaderPlugin)
     set_plugin_attributes_from_settings(plugins, LoaderPlugin)
     return plugins
 
diff --git a/openpype/pipeline/plugin_discover.py b/openpype/pipeline/plugin_discover.py
index a657df7994..b5edda7e9d 100644
--- a/openpype/pipeline/plugin_discover.py
+++ b/openpype/pipeline/plugin_discover.py
@@ -2,25 +2,31 @@ import os
 import inspect
 import traceback
 
+from openpype.lib import Logger
 from openpype.lib.python_module_tools import (
     modules_from_path,
     classes_from_module,
 )
 
+log = Logger.get_logger(__name__)
+
 
 class DiscoverResult:
-    """Hold result of publish plugins discovery.
+    """Result of Plug-ins discovery of a single superclass type.
 
-    Stores discovered plugins duplicated plugins and file paths which
-    crashed on execution of file.
+    Stores discovered, duplicated, ignored and abstract plugins and file paths
+    which crashed on execution of file.
     """
 
-    def __init__(self):
+    def __init__(self, superclass):
+        self.superclass = superclass
         self.plugins = []
         self.crashed_file_paths = {}
         self.duplicated_plugins = []
         self.abstract_plugins = []
         self.ignored_plugins = set()
+        # Store loaded modules to keep them in memory
+        self._modules = set()
 
     def __iter__(self):
         for plugin in self.plugins:
@@ -32,6 +38,10 @@ class DiscoverResult:
     def __setitem__(self, item, value):
         self.plugins[item] = value
 
+    def add_module(self, module):
+        """Add dynamically loaded python module to keep it in memory."""
+        self._modules.add(module)
+
     def get_report(self, only_errors=True, exc_info=True, full_report=False):
         lines = []
         if not only_errors:
@@ -80,10 +90,10 @@ class DiscoverResult:
 
         return "\n".join(lines)
 
-    def print_report(self, only_errors=True, exc_info=True):
+    def log_report(self, only_errors=True, exc_info=True):
         report = self.get_report(only_errors, exc_info)
         if report:
-            print(report)
+            log.info(report)
 
 
 class PluginDiscoverContext(object):
@@ -98,12 +108,25 @@ class PluginDiscoverContext(object):
         self._registered_plugins = {}
         self._registered_plugin_paths = {}
         self._last_discovered_plugins = {}
+        # Store the last result to memory
+        self._last_discovered_results = {}
 
     def get_last_discovered_plugins(self, superclass):
+        """Access last discovered plugin by a subperclass.
+
+        Returns:
+            None: When superclass was not discovered yet.
+            list: Lastly discovered plugins of the superclass.
+        """
+
         return self._last_discovered_plugins.get(superclass)
 
     def discover(
-        self, superclass, allow_duplicates=True, ignore_classes=None
+        self,
+        superclass,
+        allow_duplicates=True,
+        ignore_classes=None,
+        return_report=False
     ):
         """Find and return subclasses of `superclass`
 
@@ -122,7 +145,7 @@ class PluginDiscoverContext(object):
         if not ignore_classes:
             ignore_classes = []
 
-        result = DiscoverResult()
+        result = DiscoverResult(superclass)
         plugin_names = set()
         registered_classes = self._registered_plugins.get(superclass) or []
         registered_paths = self._registered_plugin_paths.get(superclass) or []
@@ -151,6 +174,7 @@ class PluginDiscoverContext(object):
 
             for item in modules:
                 filepath, module = item
+                result.add_module(module)
                 for cls in classes_from_module(superclass, module):
                     if cls is superclass or cls in ignore_classes:
                         result.ignored_plugins.add(cls)
@@ -169,14 +193,18 @@ class PluginDiscoverContext(object):
 
                     result.plugins.append(cls)
 
+        # Store in memory last result to keep in memory loaded modules
+        self._last_discovered_results[superclass] = result
         self._last_discovered_plugins[superclass] = list(
             result.plugins
         )
-        result.print_report()
-        return result
+        result.log_report()
+        if return_report:
+            return result
+        return result.plugins
 
     def register_plugin(self, superclass, cls):
-        """Register an individual `obj` of type `superclass`
+        """Register a directory containing plug-ins of type `superclass`
 
         Arguments:
             superclass (type): Superclass of plug-in
@@ -190,12 +218,13 @@ class PluginDiscoverContext(object):
             self._registered_plugins[superclass].append(cls)
 
     def register_plugin_path(self, superclass, path):
-        """Register a directory containing plug-ins of type `superclass`
+        """Register a directory of one or more plug-ins
 
         Arguments:
-            superclass (type): Superclass of plug-ins to look for during discovery
-            path (str): Absolute path to directory in which to discover plug-ins
-
+            superclass (type): Superclass of plug-ins to look for during
+                discovery
+            path (str): Absolute path to directory in which to discover
+                plug-ins
         """
 
         if superclass not in self._registered_plugin_paths:
@@ -207,24 +236,29 @@ class PluginDiscoverContext(object):
 
     def registered_plugin_paths(self):
         """Return all currently registered plug-in paths"""
-        # Prohibit editing in-place
-        duplicate = {
+        # Return shallow copy so we the original data can't be changed
+        return {
             superclass: paths[:]
             for superclass, paths in self._registered_plugin_paths.items()
         }
-        return duplicate
 
     def deregister_plugin(self, superclass, plugin):
-        """Oppsite of `register_plugin()`"""
+        """Opposite of `register_plugin()`"""
         if superclass in self._registered_plugins:
             self._registered_plugins[superclass].remove(plugin)
 
     def deregister_plugin_path(self, superclass, path):
-        """Oppsite of `register_plugin_path()`"""
+        """Opposite of `register_plugin_path()`"""
         self._registered_plugin_paths[superclass].remove(path)
 
 
-class GlobalDiscover:
+class _GlobalDiscover:
+    """Access to global object of PluginDiscoverContext.
+
+    Using singleton object to register/deregister plugins and plugin paths
+    and then discover them by superclass.
+    """
+
     _context = None
 
     @classmethod
@@ -235,30 +269,30 @@ class GlobalDiscover:
 
 
 def discover(superclass, allow_duplicates=True):
-    context = GlobalDiscover.get_context()
+    context = _GlobalDiscover.get_context()
     return context.discover(superclass, allow_duplicates)
 
 
 def get_last_discovered_plugins(superclass):
-    context = GlobalDiscover.get_context()
+    context = _GlobalDiscover.get_context()
     return context.get_last_discovered_plugins(superclass)
 
 
 def register_plugin(superclass, cls):
-    context = GlobalDiscover.get_context()
+    context = _GlobalDiscover.get_context()
     context.register_plugin(superclass, cls)
 
 
 def register_plugin_path(superclass, path):
-    context = GlobalDiscover.get_context()
+    context = _GlobalDiscover.get_context()
     context.register_plugin_path(superclass, path)
 
 
 def deregister_plugin(superclass, cls):
-    context = GlobalDiscover.get_context()
+    context = _GlobalDiscover.get_context()
     context.deregister_plugin(superclass, cls)
 
 
 def deregister_plugin_path(superclass, path):
-    context = GlobalDiscover.get_context()
+    context = _GlobalDiscover.get_context()
     context.deregister_plugin_path(superclass, path)

From 2621225046ac8b60942834b03fd6c68655d48c31 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 24 Mar 2022 10:18:31 +0100
Subject: [PATCH 024/108] fix logger import

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

diff --git a/openpype/pipeline/plugin_discover.py b/openpype/pipeline/plugin_discover.py
index b5edda7e9d..fb860fe5f2 100644
--- a/openpype/pipeline/plugin_discover.py
+++ b/openpype/pipeline/plugin_discover.py
@@ -2,7 +2,7 @@ import os
 import inspect
 import traceback
 
-from openpype.lib import Logger
+from openpype.api import Logger
 from openpype.lib.python_module_tools import (
     modules_from_path,
     classes_from_module,

From be652995e8d4778f4c4997a6792e4510511a3c89 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 24 Mar 2022 11:21:41 +0100
Subject: [PATCH 025/108] added extractor converting pngs to exr from tvpaint

---
 .../plugins/publish/extract_convert_to_exr.py | 96 +++++++++++++++++++
 .../plugins/publish/extract_sequence.py       |  1 -
 2 files changed, 96 insertions(+), 1 deletion(-)
 create mode 100644 openpype/hosts/tvpaint/plugins/publish/extract_convert_to_exr.py

diff --git a/openpype/hosts/tvpaint/plugins/publish/extract_convert_to_exr.py b/openpype/hosts/tvpaint/plugins/publish/extract_convert_to_exr.py
new file mode 100644
index 0000000000..5fc9be9f42
--- /dev/null
+++ b/openpype/hosts/tvpaint/plugins/publish/extract_convert_to_exr.py
@@ -0,0 +1,96 @@
+"""Plugin converting png files from ExtractSequence into exrs.
+
+Requires:
+    ExtractSequence - source of PNG
+    ExtractReview - review was already created so we can convert to any exr
+"""
+import os
+import json
+
+import pyblish.api
+from openpype.lib import (
+    get_oiio_tools_path,
+    run_subprocess,
+)
+from openpype.pipeline import KnownPublishError
+
+
+class ExtractConvertToEXR(pyblish.api.InstancePlugin):
+    # Offset to get after ExtractSequence plugin.
+    order = pyblish.api.ExtractorOrder + 0.1
+    label = "Extract Sequence EXR"
+    hosts = ["tvpaint"]
+    families = ["render"]
+
+    active = False
+
+    replace_pngs = True
+    exr_compression = "DWAA"
+
+    def process(self, instance):
+        repres = instance.data.get("representations")
+        if not repres:
+            return
+
+        oiio_path = get_oiio_tools_path()
+        # Raise an exception when oiiotool is not available
+        # - this can currently happen on MacOS machines
+        if not os.path.exists(oiio_path):
+            KnownPublishError(
+                "OpenImageIO tool is not available on this machine."
+            )
+
+        new_repres = []
+        for repre in repres:
+            if repre["name"] != "png":
+                continue
+
+            self.log.info(
+                "Processing representation: {}".format(
+                    json.dumps(repre, sort_keys=True, indent=4)
+                )
+            )
+
+            src_filepaths = set()
+            new_filenames = []
+            for src_filename in repre["files"]:
+                dst_filename = os.path.splitext(src_filename)[0] + ".exr"
+                new_filenames.append(dst_filename)
+
+                src_filepath = os.path.join(repre["stagingDir"], src_filename)
+                dst_filepath = os.path.join(repre["stagingDir"], dst_filename)
+
+                src_filepaths.add(src_filepath)
+
+                args = [
+                    oiio_path, src_filepath,
+                    "--compression", self.exr_compression,
+                    # TODO how to define color conversion?
+                    "--colorconvert", "sRGB", "linear",
+                    "-o", dst_filepath
+                ]
+                run_subprocess(args)
+
+            new_repres.append(
+                {
+                    "name": "exr",
+                    "ext": "exr",
+                    "files": new_filenames,
+                    "stagingDir": repre["stagingDir"],
+                    "tags": list(repre["tags"])
+                }
+            )
+
+            if self.replace_pngs:
+                instance.data["representations"].remove(repre)
+                for filepath in src_filepaths:
+                    os.remove(filepath)
+
+        instance.data["representations"].extend(new_repres)
+        self.log.info(
+            "Representations: {}".format(
+                json.dumps(
+                    instance.data["representations"], sort_keys=True, indent=4
+                )
+            )
+        )
diff --git a/openpype/hosts/tvpaint/plugins/publish/extract_sequence.py b/openpype/hosts/tvpaint/plugins/publish/extract_sequence.py
index 729c545545..139dabadee 100644
--- a/openpype/hosts/tvpaint/plugins/publish/extract_sequence.py
+++ b/openpype/hosts/tvpaint/plugins/publish/extract_sequence.py
@@ -12,7 +12,6 @@ from openpype.hosts.tvpaint.lib import (
     fill_reference_frames,
     composite_rendered_layers,
     rename_filepaths_by_frame_start,
-    composite_images
 )
 
 

From 41a66e86775637a9215e6887a24627755d508a4a Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 24 Mar 2022 11:22:14 +0100
Subject: [PATCH 026/108] added settings for new plugin

---
 .../defaults/project_settings/tvpaint.json    |  5 +++
 .../schema_project_tvpaint.json               | 41 +++++++++++++++++++
 2 files changed, 46 insertions(+)

diff --git a/openpype/settings/defaults/project_settings/tvpaint.json b/openpype/settings/defaults/project_settings/tvpaint.json
index 528bf6de8e..46beeb85b9 100644
--- a/openpype/settings/defaults/project_settings/tvpaint.json
+++ b/openpype/settings/defaults/project_settings/tvpaint.json
@@ -28,6 +28,11 @@
             "enabled": true,
             "optional": true,
             "active": true
+        },
+        "ExtractConvertToEXR": {
+            "enabled": false,
+            "replace_pngs": true,
+            "exr_compression": "ZIP"
         }
     },
     "load": {
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 8286ed1193..97462a8b62 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_tvpaint.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_tvpaint.json
@@ -78,6 +78,47 @@
                             "docstring": "Validate if shot on instances metadata is same as workfiles shot"
                         }
                     ]
+                },
+                {
+                    "type": "dict",
+                    "key": "ExtractConvertToEXR",
+                    "label": "Extract Convert To EXR",
+                    "is_group": true,
+                    "checkbox_key": "enabled",
+                    "children": [
+                        {
+                            "type": "boolean",
+                            "key": "enabled",
+                            "label": "Enabled"
+                        },
+                        {
+                            "type": "label",
+                            "label": "<b>WARNING:</b> This plugin does not work on MacOS (using OIIO tool)."
+                        },
+                        {
+                            "type": "boolean",
+                            "key": "replace_pngs",
+                            "label": "Replace source PNG"
+                        },
+                        {
+                            "type": "enum",
+                            "key": "exr_compression",
+                            "label": "EXR Compression",
+                            "multiselection": false,
+                            "enum_items": [
+                                {"ZIP": "ZIP"},
+                                {"ZIPS": "ZIPS"},
+                                {"DWAA": "DWAA"},
+                                {"DWAB": "DWAB"},
+                                {"PIZ": "PIZ"},
+                                {"RLE": "RLE"},
+                                {"PXR24": "PXR24"},
+                                {"B44": "B44"},
+                                {"B44A": "B44A"},
+                                {"none": "None"}
+                            ]
+                        }
+                    ]
                 }
             ]
         },

From c68a93b467135fa02f48e41db10b3464ed9379bc Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 24 Mar 2022 12:10:43 +0100
Subject: [PATCH 027/108] added plugin which prepare keys for ExplicitCleanUp
 plugin

---
 .../plugins/publish/collect_cleanup_keys.py   | 21 +++++++++++++++++++
 1 file changed, 21 insertions(+)
 create mode 100644 openpype/plugins/publish/collect_cleanup_keys.py

diff --git a/openpype/plugins/publish/collect_cleanup_keys.py b/openpype/plugins/publish/collect_cleanup_keys.py
new file mode 100644
index 0000000000..635b038387
--- /dev/null
+++ b/openpype/plugins/publish/collect_cleanup_keys.py
@@ -0,0 +1,21 @@
+"""
+Requires:
+    None
+Provides:
+    context
+        - cleanupFullPaths (list)
+        - cleanupEmptyDirs (list)
+"""
+
+import pyblish.api
+
+
+class CollectCleanupKeys(pyblish.api.ContextPlugin):
+    """Prepare keys for 'ExplicitCleanUp' plugin."""
+
+    label = "Collect Cleanup Keys"
+    order = pyblish.api.CollectorOrder
+
+    def process(self, context):
+        context.data["cleanupFullPaths"] = []
+        context.data["cleanupEmptyDirs"] = []

From 62d7bcc0d027f26fc62620a0f670ec32f5fbd399 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 24 Mar 2022 12:11:01 +0100
Subject: [PATCH 028/108] changed default attributes

---
 .../hosts/tvpaint/plugins/publish/extract_convert_to_exr.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/tvpaint/plugins/publish/extract_convert_to_exr.py b/openpype/hosts/tvpaint/plugins/publish/extract_convert_to_exr.py
index 5fc9be9f42..522173803b 100644
--- a/openpype/hosts/tvpaint/plugins/publish/extract_convert_to_exr.py
+++ b/openpype/hosts/tvpaint/plugins/publish/extract_convert_to_exr.py
@@ -22,10 +22,12 @@ class ExtractConvertToEXR(pyblish.api.InstancePlugin):
     hosts = ["tvpaint"]
     families = ["render"]
 
-    active = False
+    enabled = False
 
+    # Replace source PNG files or just add
     replace_pngs = True
-    exr_compression = "DWAA"
+    # EXR compression
+    exr_compression = "ZIP"
 
     def process(self, instance):
         repres = instance.data.get("representations")

From 54b0e2ec9cf0e37228c1ece66f4728e2cb53ac79 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 24 Mar 2022 12:11:19 +0100
Subject: [PATCH 029/108] don't remove the files but add to cleanup data

---
 .../hosts/tvpaint/plugins/publish/extract_convert_to_exr.py    | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/tvpaint/plugins/publish/extract_convert_to_exr.py b/openpype/hosts/tvpaint/plugins/publish/extract_convert_to_exr.py
index 522173803b..ab5bbc5e2c 100644
--- a/openpype/hosts/tvpaint/plugins/publish/extract_convert_to_exr.py
+++ b/openpype/hosts/tvpaint/plugins/publish/extract_convert_to_exr.py
@@ -85,8 +85,9 @@ class ExtractConvertToEXR(pyblish.api.InstancePlugin):
 
             if self.replace_pngs:
                 instance.data["representations"].remove(repre)
+
                 for filepath in src_filepaths:
-                    os.remove(filepath)
+                    instance.context.data["cleanupFullPaths"].append(filepath)
 
         instance.data["representations"].extend(new_repres)
         self.log.info(

From 7d3053c6c358539795626db69f8a463283356fbc Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 24 Mar 2022 14:22:11 +0100
Subject: [PATCH 030/108] removed deprecated argument 'options'

---
 openpype/hosts/testhost/plugins/create/auto_creator.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/testhost/plugins/create/auto_creator.py b/openpype/hosts/testhost/plugins/create/auto_creator.py
index d5935602a0..4c22eea9dd 100644
--- a/openpype/hosts/testhost/plugins/create/auto_creator.py
+++ b/openpype/hosts/testhost/plugins/create/auto_creator.py
@@ -30,7 +30,7 @@ class MyAutoCreator(AutoCreator):
     def update_instances(self, update_list):
         pipeline.update_instances(update_list)
 
-    def create(self, options=None):
+    def create(self):
         existing_instance = None
         for instance in self.create_context.instances:
             if instance.family == self.family:

From 4767bd7f5e75102cea504cc7b66600430bf1420b Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 24 Mar 2022 15:41:04 +0100
Subject: [PATCH 031/108] fix import in tray publisher

---
 .../hosts/traypublisher/plugins/create/create_workfile.py   | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/traypublisher/plugins/create/create_workfile.py b/openpype/hosts/traypublisher/plugins/create/create_workfile.py
index 2db4770bbc..5e0af350f0 100644
--- a/openpype/hosts/traypublisher/plugins/create/create_workfile.py
+++ b/openpype/hosts/traypublisher/plugins/create/create_workfile.py
@@ -1,8 +1,8 @@
 from openpype.hosts.traypublisher.api import pipeline
+from openpype.lib import FileDef
 from openpype.pipeline import (
     Creator,
-    CreatedInstance,
-    lib
+    CreatedInstance
 )
 
 
@@ -80,7 +80,7 @@ class WorkfileCreator(Creator):
 
     def get_instance_attr_defs(self):
         output = [
-            lib.FileDef(
+            FileDef(
                 "filepath",
                 folders=False,
                 extensions=self.extensions,

From abf26fcaa47e067e4437bc2c11ac35bd1508e417 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 24 Mar 2022 15:41:18 +0100
Subject: [PATCH 032/108] changed Name to Variant in creator dialog

---
 openpype/tools/publisher/widgets/create_dialog.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/tools/publisher/widgets/create_dialog.py b/openpype/tools/publisher/widgets/create_dialog.py
index 27ce97955a..7d98609c2c 100644
--- a/openpype/tools/publisher/widgets/create_dialog.py
+++ b/openpype/tools/publisher/widgets/create_dialog.py
@@ -271,7 +271,7 @@ class CreateDialog(QtWidgets.QDialog):
         create_btn.setEnabled(False)
 
         form_layout = QtWidgets.QFormLayout()
-        form_layout.addRow("Name:", variant_layout)
+        form_layout.addRow("Variant:", variant_layout)
         form_layout.addRow("Subset:", subset_name_input)
 
         mid_widget = QtWidgets.QWidget(self)

From db66fe98fd0fc7bfdc9096a0e40fc380f8479aa4 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 24 Mar 2022 15:41:43 +0100
Subject: [PATCH 033/108] fixed typo

---
 openpype/modules/log_viewer/tray/app.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/modules/log_viewer/tray/app.py b/openpype/modules/log_viewer/tray/app.py
index 71827fcac9..def319e0e3 100644
--- a/openpype/modules/log_viewer/tray/app.py
+++ b/openpype/modules/log_viewer/tray/app.py
@@ -27,11 +27,11 @@ class LogsWindow(QtWidgets.QWidget):
 
         self.setStyleSheet(style.load_stylesheet())
 
-        self._frist_show = True
+        self._first_show = True
 
     def showEvent(self, event):
         super(LogsWindow, self).showEvent(event)
 
-        if self._frist_show:
-            self._frist_show = False
+        if self._first_show:
+            self._first_show = False
             self.logs_widget.refresh()

From 57feaee44b8bff1eb7156b25bad70c978b715fec Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 24 Mar 2022 15:44:50 +0100
Subject: [PATCH 034/108] added informative logs about not found icons

---
 openpype/tools/utils/lib.py | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/openpype/tools/utils/lib.py b/openpype/tools/utils/lib.py
index 93b156bef8..f4ba2106f2 100644
--- a/openpype/tools/utils/lib.py
+++ b/openpype/tools/utils/lib.py
@@ -17,6 +17,8 @@ from openpype.lib import filter_profiles
 from openpype.style import get_objected_colors
 from openpype.resources import get_image_path
 
+log = Logger.get_logger(__name__)
+
 
 def center_window(window):
     """Move window to center of it's screen."""
@@ -111,13 +113,23 @@ def get_qta_icon_by_name_and_color(icon_name, icon_color):
         variants.append("{0}.{1}".format(key, icon_name))
 
     icon = None
+    used_variant = None
     for variant in variants:
         try:
             icon = qtawesome.icon(variant, color=icon_color)
+            used_variant = variant
             break
         except Exception:
             pass
 
+    if used_variant is None:
+        log.info("Didn't find icon \"{}\"".format(icon_name))
+
+    elif used_variant != icon_name:
+        log.info("Icon \"{}\" was not found \"{}\" is used instead".format(
+            icon_name, used_variant
+        ))
+
     SharedObjects.icons[full_icon_name] = icon
     return icon
 

From d772236278b643e748e446db35b4200eb4b9eb48 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 24 Mar 2022 16:07:11 +0100
Subject: [PATCH 035/108] changed info log level to debug

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

diff --git a/openpype/tools/utils/lib.py b/openpype/tools/utils/lib.py
index f4ba2106f2..d069088932 100644
--- a/openpype/tools/utils/lib.py
+++ b/openpype/tools/utils/lib.py
@@ -126,7 +126,7 @@ def get_qta_icon_by_name_and_color(icon_name, icon_color):
         log.info("Didn't find icon \"{}\"".format(icon_name))
 
     elif used_variant != icon_name:
-        log.info("Icon \"{}\" was not found \"{}\" is used instead".format(
+        log.debug("Icon \"{}\" was not found \"{}\" is used instead".format(
             icon_name, used_variant
         ))
 

From 1c775b382fdb9d864e97bcfb557d2d2ad2383799 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 24 Mar 2022 16:24:40 +0100
Subject: [PATCH 036/108] use explicit icon names for asset

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

diff --git a/openpype/tools/utils/lib.py b/openpype/tools/utils/lib.py
index d069088932..422d0f5389 100644
--- a/openpype/tools/utils/lib.py
+++ b/openpype/tools/utils/lib.py
@@ -152,8 +152,8 @@ def get_asset_icon_name(asset_doc, has_children=True):
         return icon_name
 
     if has_children:
-        return "folder"
-    return "folder-o"
+        return "fa.folder"
+    return "fa.folder-o"
 
 
 def get_asset_icon_color(asset_doc):

From 9ae5474a929bba3553af854fef332ef623600133 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 24 Mar 2022 16:47:37 +0100
Subject: [PATCH 037/108] fix drop files in files widget

---
 openpype/widgets/attribute_defs/files_widget.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openpype/widgets/attribute_defs/files_widget.py b/openpype/widgets/attribute_defs/files_widget.py
index 87b98e2378..34f7d159ad 100644
--- a/openpype/widgets/attribute_defs/files_widget.py
+++ b/openpype/widgets/attribute_defs/files_widget.py
@@ -641,5 +641,6 @@ class SingleFileWidget(QtWidgets.QWidget):
                     filepaths.append(filepath)
             # TODO filter check
             if len(filepaths) == 1:
-                self.set_value(filepaths[0], False)
+                self._filepath_input.setText(filepaths[0])
+
         event.accept()

From 3534e9c448f30bc8c04f8bfce0837fb5f5ea80f6 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 24 Mar 2022 17:17:38 +0100
Subject: [PATCH 038/108] Fix plugin label

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

diff --git a/openpype/hosts/traypublisher/plugins/publish/validate_workfile.py b/openpype/hosts/traypublisher/plugins/publish/validate_workfile.py
index 88339d2aac..e8eeb46065 100644
--- a/openpype/hosts/traypublisher/plugins/publish/validate_workfile.py
+++ b/openpype/hosts/traypublisher/plugins/publish/validate_workfile.py
@@ -6,7 +6,7 @@ from openpype.pipeline import PublishValidationError
 class ValidateWorkfilePath(pyblish.api.InstancePlugin):
     """Validate existence of workfile instance existence."""
 
-    label = "Collect Workfile"
+    label = "Validate Workfile"
     order = pyblish.api.ValidatorOrder - 0.49
     families = ["workfile"]
     hosts = ["traypublisher"]

From dc86a0d2bc452546e9f99662090c78321222c0ad Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 26 Mar 2022 01:37:37 +0000
Subject: [PATCH 039/108] Bump node-forge from 1.2.1 to 1.3.0 in /website

Bumps [node-forge](https://github.com/digitalbazaar/forge) from 1.2.1 to 1.3.0.
- [Release notes](https://github.com/digitalbazaar/forge/releases)
- [Changelog](https://github.com/digitalbazaar/forge/blob/main/CHANGELOG.md)
- [Commits](https://github.com/digitalbazaar/forge/compare/v1.2.1...v1.3.0)

---
updated-dependencies:
- dependency-name: node-forge
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 website/yarn.lock | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/website/yarn.lock b/website/yarn.lock
index 7f677aaed7..0dd96f63ba 100644
--- a/website/yarn.lock
+++ b/website/yarn.lock
@@ -5207,9 +5207,9 @@ node-fetch@2.6.7:
     whatwg-url "^5.0.0"
 
 node-forge@^1.2.0:
-  version "1.2.1"
-  resolved "https://registry.yarnpkg.com/node-forge/-/node-forge-1.2.1.tgz#82794919071ef2eb5c509293325cec8afd0fd53c"
-  integrity sha512-Fcvtbb+zBcZXbTTVwqGA5W+MKBj56UjVRevvchv5XrcyXbmNdesfZL37nlcWOfpgHhgmxApw3tQbTr4CqNmX4w==
+  version "1.3.0"
+  resolved "https://registry.yarnpkg.com/node-forge/-/node-forge-1.3.0.tgz#37a874ea723855f37db091e6c186e5b67a01d4b2"
+  integrity sha512-08ARB91bUi6zNKzVmaj3QO7cr397uiDT2nJ63cHjyNtCTWIgvS47j3eT0WfzUwS9+6Z5YshRaoasFkXCKrIYbA==
 
 node-releases@^2.0.1:
   version "2.0.2"

From 4a68b1b00aa6c3c3476e97cd99badec073967799 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 26 Mar 2022 03:37:21 +0000
Subject: [PATCH 040/108] Bump minimist from 1.2.5 to 1.2.6 in /website

Bumps [minimist](https://github.com/substack/minimist) from 1.2.5 to 1.2.6.
- [Release notes](https://github.com/substack/minimist/releases)
- [Commits](https://github.com/substack/minimist/compare/1.2.5...1.2.6)

---
updated-dependencies:
- dependency-name: minimist
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 website/yarn.lock | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/website/yarn.lock b/website/yarn.lock
index 7f677aaed7..ed416a5cc4 100644
--- a/website/yarn.lock
+++ b/website/yarn.lock
@@ -5125,9 +5125,9 @@ minimatch@^3.0.4:
     brace-expansion "^1.1.7"
 
 minimist@^1.2.0, minimist@^1.2.5:
-  version "1.2.5"
-  resolved "https://registry.yarnpkg.com/minimist/-/minimist-1.2.5.tgz#67d66014b66a6a8aaa0c083c5fd58df4e4e97602"
-  integrity sha512-FM9nNUYrRBAELZQT3xeZQ7fmMOBg6nWNmJKTcgsJeaLstP/UODVpGsr5OhXhhXg6f+qtJ8uiZ+PUxkDWcgIXLw==
+  version "1.2.6"
+  resolved "https://registry.yarnpkg.com/minimist/-/minimist-1.2.6.tgz#8637a5b759ea0d6e98702cfb3a9283323c93af44"
+  integrity sha512-Jsjnk4bw3YJqYzbdyBiNsPWHPfO++UGG749Cxs6peCu5Xg4nrena6OVxOYxrQTqww0Jmwt+Ref8rggumkTLz9Q==
 
 mkdirp@^0.5.5:
   version "0.5.5"

From 9b097d40e2d3a9830d9fa49bd587d5b363ae8be2 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 28 Mar 2022 12:10:36 +0200
Subject: [PATCH 041/108] create a sequence output when converting sequence

---
 openpype/lib/transcoding.py | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/openpype/lib/transcoding.py b/openpype/lib/transcoding.py
index 6bab6a8160..8e79aba0ae 100644
--- a/openpype/lib/transcoding.py
+++ b/openpype/lib/transcoding.py
@@ -478,8 +478,14 @@ def convert_for_ffmpeg(
             oiio_cmd.extend(["--eraseattrib", attr_name])
 
     # Add last argument - path to output
-    base_file_name = os.path.basename(first_input_path)
-    output_path = os.path.join(output_dir, base_file_name)
+    if is_sequence:
+        ext = os.path.splitext(first_input_path)[1]
+        base_filename = "tmp.%{:0>2}d{}".format(
+            len(str(input_frame_end)), ext
+        )
+    else:
+        base_filename = os.path.basename(first_input_path)
+    output_path = os.path.join(output_dir, base_filename)
     oiio_cmd.extend([
         "-o", output_path
     ])

From 000461243200f36d654a639c12d35314007878da Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 29 Mar 2022 11:25:57 +0200
Subject: [PATCH 042/108] added settings of template name into hero integrator

---
 .../defaults/project_settings/global.json     |  30 +++---
 .../schemas/schema_global_publish.json        | 100 +++++++++++++-----
 2 files changed, 90 insertions(+), 40 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/global.json b/openpype/settings/defaults/project_settings/global.json
index 30a71b044a..24334b0045 100644
--- a/openpype/settings/defaults/project_settings/global.json
+++ b/openpype/settings/defaults/project_settings/global.json
@@ -33,20 +33,6 @@
             "enabled": false,
             "profiles": []
         },
-        "IntegrateHeroVersion": {
-            "enabled": true,
-            "optional": true,
-            "families": [
-                "model",
-                "rig",
-                "look",
-                "pointcache",
-                "animation",
-                "setdress",
-                "layout",
-                "mayaScene"
-            ]
-        },
         "ExtractJpegEXR": {
             "enabled": true,
             "ffmpeg_args": {
@@ -204,6 +190,22 @@
                 }
             ]
         },
+        "IntegrateHeroVersion": {
+            "enabled": true,
+            "optional": true,
+            "active": true,
+            "families": [
+                "model",
+                "rig",
+                "look",
+                "pointcache",
+                "animation",
+                "setdress",
+                "layout",
+                "mayaScene"
+            ],
+            "template_name_profiles": []
+        },
         "CleanUp": {
             "paterns": [],
             "remove_temp_renders": false
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
index 12043d4205..061874e31c 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_global_publish.json
@@ -122,32 +122,6 @@
                 }
             ]
         },
-        {
-            "type": "dict",
-            "collapsible": true,
-            "checkbox_key": "enabled",
-            "key": "IntegrateHeroVersion",
-            "label": "IntegrateHeroVersion",
-            "is_group": true,
-            "children": [
-                {
-                    "type": "boolean",
-                    "key": "enabled",
-                    "label": "Enabled"
-                },
-                {
-                    "type": "boolean",
-                    "key": "optional",
-                    "label": "Optional"
-                },
-                {
-                    "key": "families",
-                    "label": "Families",
-                    "type": "list",
-                    "object_type": "text"
-                }
-            ]
-        },
         {
             "type": "dict",
             "collapsible": true,
@@ -652,6 +626,80 @@
                 }
             ]
         },
+        {
+            "type": "dict",
+            "collapsible": true,
+            "checkbox_key": "enabled",
+            "key": "IntegrateHeroVersion",
+            "label": "IntegrateHeroVersion",
+            "is_group": true,
+            "children": [
+                {
+                    "type": "boolean",
+                    "key": "enabled",
+                    "label": "Enabled"
+                },
+                {
+                    "type": "boolean",
+                    "key": "optional",
+                    "label": "Optional"
+                },
+                {
+                    "type": "boolean",
+                    "key": "active",
+                    "label": "Active"
+                },
+                {
+                    "key": "families",
+                    "label": "Families",
+                    "type": "list",
+                    "object_type": "text"
+                },
+                {
+                    "type": "list",
+                    "key": "template_name_profiles",
+                    "label": "Template name profiles",
+                    "use_label_wrap": true,
+                    "object_type": {
+                        "type": "dict",
+                        "children": [
+                            {
+                                "key": "families",
+                                "label": "Families",
+                                "type": "list",
+                                "object_type": "text"
+                            },
+                            {
+                                "type": "hosts-enum",
+                                "key": "hosts",
+                                "label": "Hosts",
+                                "multiselection": true
+                            },
+                            {
+                                "key": "task_types",
+                                "label": "Task types",
+                                "type": "task-types-enum"
+                            },
+                            {
+                                "key": "task_names",
+                                "label": "Task names",
+                                "type": "list",
+                                "object_type": "text"
+                            },
+                            {
+                                "type": "separator"
+                            },
+                            {
+                                "type": "text",
+                                "key": "template_name",
+                                "label": "Template name",
+                                "tooltip": "Name of template from Anatomy templates"
+                            }
+                        ]
+                    }
+                }
+            ]
+        },
         {
             "type": "dict",
             "collapsible": true,

From 160247ab61d6c3e1a1e6eeab042a58d9d1b0933b Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 29 Mar 2022 11:26:29 +0200
Subject: [PATCH 043/108] remove unused template color

---
 .../schemas/template_color.json               | 30 -------------------
 1 file changed, 30 deletions(-)
 delete mode 100644 openpype/settings/entities/schemas/projects_schema/schemas/template_color.json

diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/template_color.json b/openpype/settings/entities/schemas/projects_schema/schemas/template_color.json
deleted file mode 100644
index af8fd9dae4..0000000000
--- a/openpype/settings/entities/schemas/projects_schema/schemas/template_color.json
+++ /dev/null
@@ -1,30 +0,0 @@
-[
-    {
-        "type": "list-strict",
-        "key": "{name}",
-        "label": "{label}",
-        "object_types": [
-            {
-                "label": "Red",
-                "type": "number",
-                "minimum": 0,
-                "maximum": 1,
-                "decimal": 3
-            },
-            {
-                "label": "Green",
-                "type": "number",
-                "minimum": 0,
-                "maximum": 1,
-                "decimal": 3
-            },
-            {
-                "label": "Blue",
-                "type": "number",
-                "minimum": 0,
-                "maximum": 1,
-                "decimal": 3
-            }
-        ]
-    }
-]

From 0114bbd965ec0975d179faf8d8f854b5a82004c5 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 29 Mar 2022 12:17:50 +0200
Subject: [PATCH 044/108] use new settings to define which template is used for
 her opublishing

---
 .../plugins/publish/integrate_hero_version.py | 105 ++++++++++++------
 1 file changed, 70 insertions(+), 35 deletions(-)

diff --git a/openpype/plugins/publish/integrate_hero_version.py b/openpype/plugins/publish/integrate_hero_version.py
index 466606d08b..9a50257a8b 100644
--- a/openpype/plugins/publish/integrate_hero_version.py
+++ b/openpype/plugins/publish/integrate_hero_version.py
@@ -7,8 +7,12 @@ import shutil
 from bson.objectid import ObjectId
 from pymongo import InsertOne, ReplaceOne
 import pyblish.api
+
 from avalon import api, io, schema
-from openpype.lib import create_hard_link
+from openpype.lib import (
+    create_hard_link,
+    filter_profiles
+)
 
 
 class IntegrateHeroVersion(pyblish.api.InstancePlugin):
@@ -17,7 +21,9 @@ class IntegrateHeroVersion(pyblish.api.InstancePlugin):
     order = pyblish.api.IntegratorOrder + 0.1
 
     optional = True
+    active = True
 
+    # Families are modified using settings
     families = [
         "model",
         "rig",
@@ -33,11 +39,13 @@ class IntegrateHeroVersion(pyblish.api.InstancePlugin):
         "project", "asset", "task", "subset", "representation",
         "family", "hierarchy", "task", "username"
     ]
-    # TODO add family filtering
     # QUESTION/TODO this process should happen on server if crashed due to
     # permissions error on files (files were used or user didn't have perms)
     # *but all other plugins must be sucessfully completed
 
+    template_name_profiles = []
+    _default_template_name = "hero"
+
     def process(self, instance):
         self.log.debug(
             "--- Integration of Hero version for subset `{}` begins.".format(
@@ -51,26 +59,34 @@ class IntegrateHeroVersion(pyblish.api.InstancePlugin):
             )
             return
 
-        project_name = api.Session["AVALON_PROJECT"]
+        template_key = self._get_template_key(instance)
 
-        # TODO raise error if Hero not set?
         anatomy = instance.context.data["anatomy"]
-        if "hero" not in anatomy.templates:
-            self.log.warning("!!! Anatomy does not have set `hero` key!")
-            return
-
-        if "path" not in anatomy.templates["hero"]:
+        project_name = api.Session["AVALON_PROJECT"]
+        if template_key not in anatomy.templates:
             self.log.warning((
-                "!!! There is not set `path` template in `hero` anatomy"
-                " for project \"{}\"."
-            ).format(project_name))
+                "!!! Anatomy of project \"{}\" does not have set"
+                " \"{}\" template key!"
+            ).format(project_name, template_key))
             return
 
-        hero_template = anatomy.templates["hero"]["path"]
+        if "path" not in anatomy.templates[template_key]:
+            self.log.warning((
+                "!!! There is not set \"path\" template in \"{}\" anatomy"
+                " for project \"{}\"."
+            ).format(template_key, project_name))
+            return
+
+        hero_template = anatomy.templates[template_key]["path"]
         self.log.debug("`hero` template check was successful. `{}`".format(
             hero_template
         ))
 
+        self.process_instance(instance, template_key, hero_template)
+
+    def process_instance(self, instance, template_key, hero_template):
+        anatomy = instance.context.data["anatomy"]
+        published_repres = instance.data["published_representations"]
         hero_publish_dir = self.get_publish_dir(instance)
 
         src_version_entity = instance.data.get("versionEntity")
@@ -271,12 +287,12 @@ class IntegrateHeroVersion(pyblish.api.InstancePlugin):
                     continue
 
                 # Prepare anatomy data
-                anatomy_data = repre_info["anatomy_data"]
+                anatomy_data = copy.deepcopy(repre_info["anatomy_data"])
                 anatomy_data.pop("version", None)
 
                 # Get filled path to repre context
                 anatomy_filled = anatomy.format(anatomy_data)
-                template_filled = anatomy_filled["hero"]["path"]
+                template_filled = anatomy_filled[template_key]["path"]
 
                 repre_data = {
                     "path": str(template_filled),
@@ -308,11 +324,11 @@ class IntegrateHeroVersion(pyblish.api.InstancePlugin):
                     collections, remainders = clique.assemble(published_files)
                     if remainders or not collections or len(collections) > 1:
                         raise Exception((
-                                            "Integrity error. Files of published representation "
-                                            "is combination of frame collections and single files."
-                                            "Collections: `{}` Single files: `{}`"
-                                        ).format(str(collections),
-                                                 str(remainders)))
+                            "Integrity error. Files of published"
+                            " representation is combination of frame"
+                            " collections and single files. Collections:"
+                            " `{}` Single files: `{}`"
+                        ).format(str(collections), str(remainders)))
 
                     src_col = collections[0]
 
@@ -320,7 +336,7 @@ class IntegrateHeroVersion(pyblish.api.InstancePlugin):
                     frame_splitter = "_-_FRAME_SPLIT_-_"
                     anatomy_data["frame"] = frame_splitter
                     _anatomy_filled = anatomy.format(anatomy_data)
-                    _template_filled = _anatomy_filled["hero"]["path"]
+                    _template_filled = _anatomy_filled[template_key]["path"]
                     head, tail = _template_filled.split(frame_splitter)
                     padding = int(
                         anatomy.templates["render"].get(
@@ -466,13 +482,13 @@ class IntegrateHeroVersion(pyblish.api.InstancePlugin):
                 files.append(_path)
         return files
 
-    def get_publish_dir(self, instance):
+    def get_publish_dir(self, instance, template_key):
         anatomy = instance.context.data["anatomy"]
         template_data = copy.deepcopy(instance.data["anatomyData"])
 
-        if "folder" in anatomy.templates["hero"]:
+        if "folder" in anatomy.templates[template_key]:
             anatomy_filled = anatomy.format(template_data)
-            publish_folder = anatomy_filled["hero"]["folder"]
+            publish_folder = anatomy_filled[template_key]["folder"]
         else:
             # This is for cases of Deprecated anatomy without `folder`
             # TODO remove when all clients have solved this issue
@@ -489,7 +505,7 @@ class IntegrateHeroVersion(pyblish.api.InstancePlugin):
                 " key underneath `publish` (in global of for project `{}`)."
             ).format(project_name))
 
-            file_path = anatomy_filled["hero"]["path"]
+            file_path = anatomy_filled[template_key]["path"]
             # Directory
             publish_folder = os.path.dirname(file_path)
 
@@ -499,6 +515,31 @@ class IntegrateHeroVersion(pyblish.api.InstancePlugin):
 
         return publish_folder
 
+    def _get_template_key(self, instance):
+        anatomy_data = instance.data["anatomyData"]
+        task_data = anatomy_data.get("task") or {}
+        task_name = task_data.get("name")
+        task_type = task_data.get("type")
+        host_name = instance.context.data["hostName"]
+        # TODO raise error if Hero not set?
+        family = self.main_family_from_instance(instance)
+        key_values = {
+            "families": family,
+            "task_names": task_name,
+            "task_types": task_type,
+            "hosts": host_name
+        }
+        profile = filter_profiles(
+            self.template_name_profiles,
+            key_values,
+            logger=self.log
+        )
+        if profile:
+            template_name = profile["template_name"]
+        else:
+            template_name = self._default_template_name
+        return template_name
+
     def copy_file(self, src_path, dst_path):
         # TODO check drives if are the same to check if cas hardlink
         dirname = os.path.dirname(dst_path)
@@ -564,22 +605,16 @@ class IntegrateHeroVersion(pyblish.api.InstancePlugin):
                 src_file (string) - original file path
                 dst_file (string) - hero file path
         """
-        _, rootless = anatomy.find_root_template_from_path(
-            dst_file
-        )
-        _, rtls_src = anatomy.find_root_template_from_path(
-            src_file
-        )
+        _, rootless = anatomy.find_root_template_from_path(dst_file)
+        _, rtls_src = anatomy.find_root_template_from_path(src_file)
         return path.replace(rtls_src, rootless)
 
     def _update_hash(self, hash, src_file_name, dst_file):
         """
             Updates hash value with proper hero name
         """
-        src_file_name = self._get_name_without_ext(
-            src_file_name)
-        hero_file_name = self._get_name_without_ext(
-            dst_file)
+        src_file_name = self._get_name_without_ext(src_file_name)
+        hero_file_name = self._get_name_without_ext(dst_file)
         return hash.replace(src_file_name, hero_file_name)
 
     def _get_name_without_ext(self, value):

From 952717440d550ed602b424b3a4f43a5aaa01f350 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 29 Mar 2022 13:46:38 +0200
Subject: [PATCH 045/108] bug fixes and implementing missing method

---
 openpype/plugins/publish/integrate_hero_version.py | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/openpype/plugins/publish/integrate_hero_version.py b/openpype/plugins/publish/integrate_hero_version.py
index 9a50257a8b..67c91634d2 100644
--- a/openpype/plugins/publish/integrate_hero_version.py
+++ b/openpype/plugins/publish/integrate_hero_version.py
@@ -82,12 +82,12 @@ class IntegrateHeroVersion(pyblish.api.InstancePlugin):
             hero_template
         ))
 
-        self.process_instance(instance, template_key, hero_template)
+        self.integrate_instance(instance, template_key, hero_template)
 
-    def process_instance(self, instance, template_key, hero_template):
+    def integrate_instance(self, instance, template_key, hero_template):
         anatomy = instance.context.data["anatomy"]
         published_repres = instance.data["published_representations"]
-        hero_publish_dir = self.get_publish_dir(instance)
+        hero_publish_dir = self.get_publish_dir(instance, template_key)
 
         src_version_entity = instance.data.get("versionEntity")
         filtered_repre_ids = []
@@ -540,6 +540,13 @@ class IntegrateHeroVersion(pyblish.api.InstancePlugin):
             template_name = self._default_template_name
         return template_name
 
+    def main_family_from_instance(self, instance):
+        """Returns main family of entered instance."""
+        family = instance.data.get("family")
+        if not family:
+            family = instance.data["families"][0]
+        return family
+
     def copy_file(self, src_path, dst_path):
         # TODO check drives if are the same to check if cas hardlink
         dirname = os.path.dirname(dst_path)

From 059020cabd21cf656bceadf76d63ab719ff59a58 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 29 Mar 2022 13:53:22 +0200
Subject: [PATCH 046/108] change frame padding access

---
 openpype/plugins/publish/integrate_hero_version.py | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/openpype/plugins/publish/integrate_hero_version.py b/openpype/plugins/publish/integrate_hero_version.py
index 67c91634d2..d50f2a4712 100644
--- a/openpype/plugins/publish/integrate_hero_version.py
+++ b/openpype/plugins/publish/integrate_hero_version.py
@@ -339,10 +339,7 @@ class IntegrateHeroVersion(pyblish.api.InstancePlugin):
                     _template_filled = _anatomy_filled[template_key]["path"]
                     head, tail = _template_filled.split(frame_splitter)
                     padding = int(
-                        anatomy.templates["render"].get(
-                            "frame_padding",
-                            anatomy.templates["render"].get("padding")
-                        )
+                        anatomy.templates[template_key]["frame_padding"]
                     )
 
                     dst_col = clique.Collection(

From e76c317d7700d0950e323a69ae33650889815543 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 29 Mar 2022 13:56:28 +0200
Subject: [PATCH 047/108] remove her publish dir on error before renaming it
 back

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

diff --git a/openpype/plugins/publish/integrate_hero_version.py b/openpype/plugins/publish/integrate_hero_version.py
index d50f2a4712..d6df6535d8 100644
--- a/openpype/plugins/publish/integrate_hero_version.py
+++ b/openpype/plugins/publish/integrate_hero_version.py
@@ -457,6 +457,8 @@ class IntegrateHeroVersion(pyblish.api.InstancePlugin):
                 backup_hero_publish_dir is not None and
                 os.path.exists(backup_hero_publish_dir)
             ):
+                if os.path.exists(hero_publish_dir):
+                    shutil.rmtree(hero_publish_dir)
                 os.rename(backup_hero_publish_dir, hero_publish_dir)
             self.log.error((
                 "!!! Creating of hero version failed."

From dfa5555535b06d9fadf7118858574d79f41d0155 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 29 Mar 2022 16:28:13 +0200
Subject: [PATCH 048/108] Fix creation of subset names in PS review and
 workfile

---
 .../hosts/photoshop/plugins/publish/collect_review.py  | 10 +++++++++-
 .../photoshop/plugins/publish/collect_workfile.py      | 10 +++++++++-
 2 files changed, 18 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/photoshop/plugins/publish/collect_review.py b/openpype/hosts/photoshop/plugins/publish/collect_review.py
index 5ab48b76da..df069efd1f 100644
--- a/openpype/hosts/photoshop/plugins/publish/collect_review.py
+++ b/openpype/hosts/photoshop/plugins/publish/collect_review.py
@@ -2,6 +2,8 @@ import os
 
 import pyblish.api
 
+from openpype.lib import get_subset_name
+
 
 class CollectReview(pyblish.api.ContextPlugin):
     """Gather the active document as review instance."""
@@ -13,7 +15,13 @@ class CollectReview(pyblish.api.ContextPlugin):
     def process(self, context):
         family = "review"
         task = os.getenv("AVALON_TASK", None)
-        subset = family + task.capitalize()
+        subset = get_subset_name(
+            family,
+            "",
+            task,
+            context.data["assetEntity"]["_id"],
+            host_name="photoshop"
+        )
 
         file_path = context.data["currentFile"]
         base_name = os.path.basename(file_path)
diff --git a/openpype/hosts/photoshop/plugins/publish/collect_workfile.py b/openpype/hosts/photoshop/plugins/publish/collect_workfile.py
index db1ede14d5..841db72cde 100644
--- a/openpype/hosts/photoshop/plugins/publish/collect_workfile.py
+++ b/openpype/hosts/photoshop/plugins/publish/collect_workfile.py
@@ -1,6 +1,8 @@
 import os
 import pyblish.api
 
+from openpype.lib import get_subset_name
+
 
 class CollectWorkfile(pyblish.api.ContextPlugin):
     """Collect current script for publish."""
@@ -12,7 +14,13 @@ class CollectWorkfile(pyblish.api.ContextPlugin):
     def process(self, context):
         family = "workfile"
         task = os.getenv("AVALON_TASK", None)
-        subset = family + task.capitalize()
+        subset = get_subset_name(
+            family,
+            "",
+            task,
+            context.data["assetEntity"]["_id"],
+            host_name="photoshop"
+        )
 
         file_path = context.data["currentFile"]
         staging_dir = os.path.dirname(file_path)

From a19983313c5c509cdb5cc1e02cfbb5aa0c918c88 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 29 Mar 2022 16:38:59 +0200
Subject: [PATCH 049/108] OP-2766 - Fix order of collector

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

diff --git a/openpype/hosts/photoshop/plugins/publish/collect_review.py b/openpype/hosts/photoshop/plugins/publish/collect_review.py
index df069efd1f..6c299a60f5 100644
--- a/openpype/hosts/photoshop/plugins/publish/collect_review.py
+++ b/openpype/hosts/photoshop/plugins/publish/collect_review.py
@@ -11,6 +11,7 @@ class CollectReview(pyblish.api.ContextPlugin):
     label = "Review"
     order = pyblish.api.CollectorOrder
     hosts = ["photoshop"]
+    order = pyblish.api.CollectorOrder + 0.1
 
     def process(self, context):
         family = "review"

From 653d0c1366f5d976bcd4458bfd1ceb903f216e83 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 29 Mar 2022 17:21:49 +0200
Subject: [PATCH 050/108] OP-2766 - Fix pulling task and project from context

---
 openpype/hosts/photoshop/plugins/publish/collect_review.py   | 4 ++--
 openpype/hosts/photoshop/plugins/publish/collect_workfile.py | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/photoshop/plugins/publish/collect_review.py b/openpype/hosts/photoshop/plugins/publish/collect_review.py
index 6c299a60f5..e219326d64 100644
--- a/openpype/hosts/photoshop/plugins/publish/collect_review.py
+++ b/openpype/hosts/photoshop/plugins/publish/collect_review.py
@@ -15,12 +15,12 @@ class CollectReview(pyblish.api.ContextPlugin):
 
     def process(self, context):
         family = "review"
-        task = os.getenv("AVALON_TASK", None)
         subset = get_subset_name(
             family,
             "",
-            task,
+            context.data["anatomyData"]["task"]["name"],
             context.data["assetEntity"]["_id"],
+            context.data["anatomyData"]["project"]["name"],
             host_name="photoshop"
         )
 
diff --git a/openpype/hosts/photoshop/plugins/publish/collect_workfile.py b/openpype/hosts/photoshop/plugins/publish/collect_workfile.py
index 841db72cde..ca1124fd24 100644
--- a/openpype/hosts/photoshop/plugins/publish/collect_workfile.py
+++ b/openpype/hosts/photoshop/plugins/publish/collect_workfile.py
@@ -13,12 +13,12 @@ class CollectWorkfile(pyblish.api.ContextPlugin):
 
     def process(self, context):
         family = "workfile"
-        task = os.getenv("AVALON_TASK", None)
         subset = get_subset_name(
             family,
             "",
-            task,
+            context.data["anatomyData"]["task"]["name"],
             context.data["assetEntity"]["_id"],
+            context.data["anatomyData"]["project"]["name"],
             host_name="photoshop"
         )
 

From 9d8df33d4af634614f0ec9c2cbf716ef014c7698 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 29 Mar 2022 16:38:59 +0200
Subject: [PATCH 051/108] Fix order of collector

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

diff --git a/openpype/hosts/photoshop/plugins/publish/collect_review.py b/openpype/hosts/photoshop/plugins/publish/collect_review.py
index df069efd1f..6c299a60f5 100644
--- a/openpype/hosts/photoshop/plugins/publish/collect_review.py
+++ b/openpype/hosts/photoshop/plugins/publish/collect_review.py
@@ -11,6 +11,7 @@ class CollectReview(pyblish.api.ContextPlugin):
     label = "Review"
     order = pyblish.api.CollectorOrder
     hosts = ["photoshop"]
+    order = pyblish.api.CollectorOrder + 0.1
 
     def process(self, context):
         family = "review"

From 8b1cfa7d19e476c3a6579fa63de89ef9c8c1e855 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 29 Mar 2022 17:21:49 +0200
Subject: [PATCH 052/108] Fix pulling task and project from context

---
 openpype/hosts/photoshop/plugins/publish/collect_review.py   | 4 ++--
 openpype/hosts/photoshop/plugins/publish/collect_workfile.py | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/photoshop/plugins/publish/collect_review.py b/openpype/hosts/photoshop/plugins/publish/collect_review.py
index 6c299a60f5..e219326d64 100644
--- a/openpype/hosts/photoshop/plugins/publish/collect_review.py
+++ b/openpype/hosts/photoshop/plugins/publish/collect_review.py
@@ -15,12 +15,12 @@ class CollectReview(pyblish.api.ContextPlugin):
 
     def process(self, context):
         family = "review"
-        task = os.getenv("AVALON_TASK", None)
         subset = get_subset_name(
             family,
             "",
-            task,
+            context.data["anatomyData"]["task"]["name"],
             context.data["assetEntity"]["_id"],
+            context.data["anatomyData"]["project"]["name"],
             host_name="photoshop"
         )
 
diff --git a/openpype/hosts/photoshop/plugins/publish/collect_workfile.py b/openpype/hosts/photoshop/plugins/publish/collect_workfile.py
index 841db72cde..ca1124fd24 100644
--- a/openpype/hosts/photoshop/plugins/publish/collect_workfile.py
+++ b/openpype/hosts/photoshop/plugins/publish/collect_workfile.py
@@ -13,12 +13,12 @@ class CollectWorkfile(pyblish.api.ContextPlugin):
 
     def process(self, context):
         family = "workfile"
-        task = os.getenv("AVALON_TASK", None)
         subset = get_subset_name(
             family,
             "",
-            task,
+            context.data["anatomyData"]["task"]["name"],
             context.data["assetEntity"]["_id"],
+            context.data["anatomyData"]["project"]["name"],
             host_name="photoshop"
         )
 

From 3baee04ada9b7ea11b4877ac0e30d29453ccb67f Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 29 Mar 2022 17:32:12 +0200
Subject: [PATCH 053/108] Fix order

---
 openpype/hosts/photoshop/plugins/publish/collect_review.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/openpype/hosts/photoshop/plugins/publish/collect_review.py b/openpype/hosts/photoshop/plugins/publish/collect_review.py
index e219326d64..8b7508cf5b 100644
--- a/openpype/hosts/photoshop/plugins/publish/collect_review.py
+++ b/openpype/hosts/photoshop/plugins/publish/collect_review.py
@@ -9,9 +9,8 @@ class CollectReview(pyblish.api.ContextPlugin):
     """Gather the active document as review instance."""
 
     label = "Review"
-    order = pyblish.api.CollectorOrder
-    hosts = ["photoshop"]
     order = pyblish.api.CollectorOrder + 0.1
+    hosts = ["photoshop"]
 
     def process(self, context):
         family = "review"

From b3391ebe7151ae540dc01201d43cf75651cd7979 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 29 Mar 2022 17:42:53 +0200
Subject: [PATCH 054/108] Fix order

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

diff --git a/openpype/hosts/photoshop/plugins/publish/collect_review.py b/openpype/hosts/photoshop/plugins/publish/collect_review.py
index 2f87af5d72..8b7508cf5b 100644
--- a/openpype/hosts/photoshop/plugins/publish/collect_review.py
+++ b/openpype/hosts/photoshop/plugins/publish/collect_review.py
@@ -11,7 +11,6 @@ class CollectReview(pyblish.api.ContextPlugin):
     label = "Review"
     order = pyblish.api.CollectorOrder + 0.1
     hosts = ["photoshop"]
-    order = pyblish.api.CollectorOrder + 0.1
 
     def process(self, context):
         family = "review"

From 505d73145c34a3379dae4e699f1d3b825ce0567c Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 29 Mar 2022 18:11:14 +0200
Subject: [PATCH 055/108] enhanced tool settings to have also filters

---
 .../defaults/system_settings/tools.json       | 12 +++++++--
 .../schemas/system_schema/schema_tools.json   | 25 ++++++++++++++++++-
 2 files changed, 34 insertions(+), 3 deletions(-)

diff --git a/openpype/settings/defaults/system_settings/tools.json b/openpype/settings/defaults/system_settings/tools.json
index 181236abe8..9e08465195 100644
--- a/openpype/settings/defaults/system_settings/tools.json
+++ b/openpype/settings/defaults/system_settings/tools.json
@@ -25,10 +25,18 @@
             },
             "variants": {
                 "3-2": {
-                    "MTOA_VERSION": "3.2"
+                    "host_names": [],
+                    "app_variants": [],
+                    "environment": {
+                        "MTOA_VERSION": "3.2"
+                    }
                 },
                 "3-1": {
-                    "MTOA_VERSION": "3.1"
+                    "host_names": [],
+                    "app_variants": [],
+                    "environment": {
+                        "MTOA_VERSION": "3.1"
+                    }
                 },
                 "__dynamic_keys_labels__": {
                     "3-2": "3.2",
diff --git a/openpype/settings/entities/schemas/system_schema/schema_tools.json b/openpype/settings/entities/schemas/system_schema/schema_tools.json
index 2346bef36d..7962fdd465 100644
--- a/openpype/settings/entities/schemas/system_schema/schema_tools.json
+++ b/openpype/settings/entities/schemas/system_schema/schema_tools.json
@@ -25,7 +25,30 @@
                         "key": "variants",
                         "collapsible_key": true,
                         "object_type": {
-                            "type": "raw-json"
+                            "type": "dict",
+                            "children": [
+                                {
+                                    "key": "host_names",
+                                    "label": "Hosts",
+                                    "type": "hosts-enum",
+                                    "multiselection": true
+                                },
+                                {
+                                    "key": "app_variants",
+                                    "label": "Applications",
+                                    "type": "apps-enum",
+                                    "multiselection": true,
+                                    "tooltip": "Applications are not \"live\" and may require to Save and refresh settings UI to update values."
+                                },
+                                {
+                                    "type": "separator"
+                                },
+                                {
+                                    "key": "environment",
+                                    "label": "Environments",
+                                    "type": "raw-json"
+                                }
+                            ]
                         }
                     }
                 ]

From 3fd989671acb44e9df400be7217243bd12d23ae2 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 29 Mar 2022 18:11:59 +0200
Subject: [PATCH 056/108] added backwards compatibility of tools right into
 settings lib function

---
 openpype/settings/lib.py | 34 +++++++++++++++++++++++++++++++++-
 1 file changed, 33 insertions(+), 1 deletion(-)

diff --git a/openpype/settings/lib.py b/openpype/settings/lib.py
index 1d303564d5..54502292dc 100644
--- a/openpype/settings/lib.py
+++ b/openpype/settings/lib.py
@@ -265,11 +265,43 @@ def save_project_anatomy(project_name, anatomy_data):
         raise SaveWarningExc(warnings)
 
 
+def _system_settings_backwards_compatible_conversion(studio_overrides):
+    # Backwards compatibility of tools 3.9.1 - 3.9.2 to keep
+    #   "tools" environments
+    if (
+        "tools" in studio_overrides
+        and "tool_groups" in studio_overrides["tools"]
+    ):
+        tool_groups = studio_overrides["tools"]["tool_groups"]
+        for tool_group, group_value in tool_groups.items():
+            if tool_group in METADATA_KEYS:
+                continue
+
+            variants = group_value.get("variants")
+            if not variants:
+                continue
+
+            for key in set(variants.keys()):
+                if key in METADATA_KEYS:
+                    continue
+
+                variant_value = variants[key]
+                if "environment" not in variant_value:
+                    variants[key] = {
+                        "environment": variant_value
+                    }
+
+
 @require_handler
 def get_studio_system_settings_overrides(return_version=False):
-    return _SETTINGS_HANDLER.get_studio_system_settings_overrides(
+    output = _SETTINGS_HANDLER.get_studio_system_settings_overrides(
         return_version
     )
+    value = output
+    if return_version:
+        value, version = output
+    _system_settings_backwards_compatible_conversion(value)
+    return output
 
 
 @require_handler

From b3463afa38d2ed80c3ccffe8f3f757ace44955ef Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 29 Mar 2022 18:14:09 +0200
Subject: [PATCH 057/108] load settings data in EnvironmentTool with backwards
 comatible way

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

diff --git a/openpype/lib/applications.py b/openpype/lib/applications.py
index ad59ae0dbc..e415120ac4 100644
--- a/openpype/lib/applications.py
+++ b/openpype/lib/applications.py
@@ -211,6 +211,7 @@ class ApplicationGroup:
         data (dict): Group defying data loaded from settings.
         manager (ApplicationManager): Manager that created the group.
     """
+
     def __init__(self, name, data, manager):
         self.name = name
         self.manager = manager
@@ -374,6 +375,7 @@ class ApplicationManager:
             will always use these values. Gives ability to create manager
             using different settings.
     """
+
     def __init__(self, system_settings=None):
         self.log = PypeLogger.get_logger(self.__class__.__name__)
 
@@ -530,13 +532,13 @@ class EnvironmentToolGroup:
         variants = data.get("variants") or {}
         label_by_key = variants.pop(M_DYNAMIC_KEY_LABEL, {})
         variants_by_name = {}
-        for variant_name, variant_env in variants.items():
+        for variant_name, variant_data in variants.items():
             if variant_name in METADATA_KEYS:
                 continue
 
             variant_label = label_by_key.get(variant_name) or variant_name
             tool = EnvironmentTool(
-                variant_name, variant_label, variant_env, self
+                variant_name, variant_label, variant_data, self
             )
             variants_by_name[variant_name] = tool
         self.variants = variants_by_name
@@ -560,15 +562,35 @@ class EnvironmentTool:
 
     Args:
         name (str): Name of the tool.
-        environment (dict): Variant environments.
+        variant_data (dict): Variant data with environments and
+            host and app variant filters.
         group (str): Name of group which wraps tool.
     """
 
-    def __init__(self, name, label, environment, group):
+    def __init__(self, name, label, variant_data, group):
+        # Backwards compatibility 3.9.1 - 3.9.2
+        # - 'variant_data' contained only environments but contain also host
+        #   and application variant filters
+        host_names = []
+        app_variants = []
+        if "host_names" in variant_data:
+            host_names = variant_data["host_names"]
+
+        if "app_variants" in variant_data:
+            app_variants = variant_data["app_variants"]
+
+        if "environment" in variant_data:
+            environment = variant_data["environemnt"]
+        else:
+            environment = variant_data
+
+        self.host_names = host_names
+        self.app_variants = app_variants
         self.name = name
         self.variant_label = label
         self.label = " ".join((group.label, label))
         self.group = group
+
         self._environment = environment
         self.full_name = "/".join((group.name, name))
 

From 39f84f8dfdb4f2ec7f369acf3b2e80971befea70 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 29 Mar 2022 18:14:24 +0200
Subject: [PATCH 058/108] added option to validate if tool is valid for
 application

---
 openpype/lib/applications.py | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/openpype/lib/applications.py b/openpype/lib/applications.py
index e415120ac4..176a9a2391 100644
--- a/openpype/lib/applications.py
+++ b/openpype/lib/applications.py
@@ -601,6 +601,19 @@ class EnvironmentTool:
     def environment(self):
         return copy.deepcopy(self._environment)
 
+    def is_valid_for_app(self, app):
+        """Is tool valid for application.
+
+        Args:
+            app (Application): Application for which are prepared environments.
+        """
+        if self.app_variants and app.full_name not in self.app_variants:
+            return False
+
+        if self.host_names and app.host_name not in self.host_names:
+            return False
+        return True
+
 
 class ApplicationExecutable:
     """Representation of executable loaded from settings."""
@@ -1406,7 +1419,7 @@ def prepare_app_environments(data, env_group=None, implementation_envs=True):
         # Make sure each tool group can be added only once
         for key in asset_doc["data"].get("tools_env") or []:
             tool = app.manager.tools.get(key)
-            if not tool:
+            if not tool or not tool.is_valid_for_app(app):
                 continue
             groups_by_name[tool.group.name] = tool.group
             tool_by_group_name[tool.group.name][tool.name] = tool

From 3bda53a54138b9e211f1d88d0e7e01a48fef9ac7 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Tue, 29 Mar 2022 18:21:10 +0200
Subject: [PATCH 059/108] fix typo

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

diff --git a/openpype/lib/applications.py b/openpype/lib/applications.py
index 176a9a2391..b496bd74e2 100644
--- a/openpype/lib/applications.py
+++ b/openpype/lib/applications.py
@@ -580,7 +580,7 @@ class EnvironmentTool:
             app_variants = variant_data["app_variants"]
 
         if "environment" in variant_data:
-            environment = variant_data["environemnt"]
+            environment = variant_data["environment"]
         else:
             environment = variant_data
 

From d26143198c59619a879ace67930f05cd0b792f61 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 29 Mar 2022 22:21:09 +0000
Subject: [PATCH 060/108] Bump paramiko from 2.9.2 to 2.10.1

Bumps [paramiko](https://github.com/paramiko/paramiko) from 2.9.2 to 2.10.1.
- [Release notes](https://github.com/paramiko/paramiko/releases)
- [Changelog](https://github.com/paramiko/paramiko/blob/main/NEWS)
- [Commits](https://github.com/paramiko/paramiko/compare/2.9.2...2.10.1)

---
updated-dependencies:
- dependency-name: paramiko
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 poetry.lock | 84 ++++++++++++++++++++++++++---------------------------
 1 file changed, 41 insertions(+), 43 deletions(-)

diff --git a/poetry.lock b/poetry.lock
index ed2b0dd3c2..7998ede693 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -680,15 +680,8 @@ category = "main"
 optional = false
 python-versions = "*"
 
-[package.dependencies]
-attrs = ">=17.4.0"
-importlib-metadata = {version = "*", markers = "python_version < \"3.8\""}
-pyrsistent = ">=0.14.0"
-six = ">=1.11.0"
-
 [package.extras]
-format = ["idna", "jsonpointer (>1.13)", "rfc3987", "strict-rfc3339", "webcolors"]
-format_nongpl = ["idna", "jsonpointer (>1.13)", "webcolors", "rfc3986-validator (>0.1.0)", "rfc3339-validator"]
+format = ["rfc3987", "strict-rfc3339", "webcolors"]
 
 [[package]]
 name = "keyring"
@@ -784,7 +777,7 @@ pyparsing = ">=2.0.2,<3.0.5 || >3.0.5"
 
 [[package]]
 name = "paramiko"
-version = "2.9.2"
+version = "2.10.1"
 description = "SSH2 protocol library"
 category = "main"
 optional = false
@@ -794,6 +787,7 @@ python-versions = "*"
 bcrypt = ">=3.1.3"
 cryptography = ">=2.5"
 pynacl = ">=1.0.1"
+six = "*"
 
 [package.extras]
 all = ["pyasn1 (>=0.1.7)", "pynacl (>=1.0.1)", "bcrypt (>=3.1.3)", "invoke (>=1.3)", "gssapi (>=1.4.1)", "pywin32 (>=2.1.8)"]
@@ -1087,14 +1081,6 @@ category = "main"
 optional = false
 python-versions = ">=2.6, !=3.0.*, !=3.1.*, !=3.2.*"
 
-[[package]]
-name = "pyrsistent"
-version = "0.18.1"
-description = "Persistent/Functional/Immutable data structures"
-category = "main"
-optional = false
-python-versions = ">=3.7"
-
 [[package]]
 name = "pysftp"
 version = "0.2.9"
@@ -1633,7 +1619,7 @@ testing = ["pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-flake8", "pytest-
 [metadata]
 lock-version = "1.1"
 python-versions = "3.7.*"
-content-hash = "2f78d48a6aad2d8a88b7dd7f31a76d907bec9fb65f0086fba6b6d2e1605f0f88"
+content-hash = "b02313c8255a1897b0f0617ad4884a5943696c363512921aab1cb2dd8f4fdbe0"
 
 [metadata.files]
 acre = []
@@ -2171,12 +2157,28 @@ log4mongo = [
     {file = "log4mongo-1.7.0.tar.gz", hash = "sha256:dc374617206162a0b14167fbb5feac01dbef587539a235dadba6200362984a68"},
 ]
 markupsafe = [
+    {file = "MarkupSafe-2.0.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:d8446c54dc28c01e5a2dbac5a25f071f6653e6e40f3a8818e8b45d790fe6ef53"},
+    {file = "MarkupSafe-2.0.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:36bc903cbb393720fad60fc28c10de6acf10dc6cc883f3e24ee4012371399a38"},
+    {file = "MarkupSafe-2.0.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:2d7d807855b419fc2ed3e631034685db6079889a1f01d5d9dac950f764da3dad"},
+    {file = "MarkupSafe-2.0.1-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:add36cb2dbb8b736611303cd3bfcee00afd96471b09cda130da3581cbdc56a6d"},
+    {file = "MarkupSafe-2.0.1-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:168cd0a3642de83558a5153c8bd34f175a9a6e7f6dc6384b9655d2697312a646"},
+    {file = "MarkupSafe-2.0.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:4dc8f9fb58f7364b63fd9f85013b780ef83c11857ae79f2feda41e270468dd9b"},
+    {file = "MarkupSafe-2.0.1-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:20dca64a3ef2d6e4d5d615a3fd418ad3bde77a47ec8a23d984a12b5b4c74491a"},
+    {file = "MarkupSafe-2.0.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:cdfba22ea2f0029c9261a4bd07e830a8da012291fbe44dc794e488b6c9bb353a"},
+    {file = "MarkupSafe-2.0.1-cp310-cp310-win32.whl", hash = "sha256:99df47edb6bda1249d3e80fdabb1dab8c08ef3975f69aed437cb69d0a5de1e28"},
+    {file = "MarkupSafe-2.0.1-cp310-cp310-win_amd64.whl", hash = "sha256:e0f138900af21926a02425cf736db95be9f4af72ba1bb21453432a07f6082134"},
     {file = "MarkupSafe-2.0.1-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:f9081981fe268bd86831e5c75f7de206ef275defcb82bc70740ae6dc507aee51"},
     {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux1_i686.whl", hash = "sha256:0955295dd5eec6cb6cc2fe1698f4c6d84af2e92de33fbcac4111913cd100a6ff"},
     {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux1_x86_64.whl", hash = "sha256:0446679737af14f45767963a1a9ef7620189912317d095f2d9ffa183a4d25d2b"},
     {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux2010_i686.whl", hash = "sha256:f826e31d18b516f653fe296d967d700fddad5901ae07c622bb3705955e1faa94"},
     {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux2010_x86_64.whl", hash = "sha256:fa130dd50c57d53368c9d59395cb5526eda596d3ffe36666cd81a44d56e48872"},
     {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux2014_aarch64.whl", hash = "sha256:905fec760bd2fa1388bb5b489ee8ee5f7291d692638ea5f67982d968366bef9f"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:bf5d821ffabf0ef3533c39c518f3357b171a1651c1ff6827325e4489b0e46c3c"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:0d4b31cc67ab36e3392bbf3862cfbadac3db12bdd8b02a2731f509ed5b829724"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:baa1a4e8f868845af802979fcdbf0bb11f94f1cb7ced4c4b8a351bb60d108145"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-musllinux_1_1_aarch64.whl", hash = "sha256:deb993cacb280823246a026e3b2d81c493c53de6acfd5e6bfe31ab3402bb37dd"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-musllinux_1_1_i686.whl", hash = "sha256:63f3268ba69ace99cab4e3e3b5840b03340efed0948ab8f78d2fd87ee5442a4f"},
+    {file = "MarkupSafe-2.0.1-cp36-cp36m-musllinux_1_1_x86_64.whl", hash = "sha256:8d206346619592c6200148b01a2142798c989edcb9c896f9ac9722a99d4e77e6"},
     {file = "MarkupSafe-2.0.1-cp36-cp36m-win32.whl", hash = "sha256:6c4ca60fa24e85fe25b912b01e62cb969d69a23a5d5867682dd3e80b5b02581d"},
     {file = "MarkupSafe-2.0.1-cp36-cp36m-win_amd64.whl", hash = "sha256:b2f4bf27480f5e5e8ce285a8c8fd176c0b03e93dcc6646477d4630e83440c6a9"},
     {file = "MarkupSafe-2.0.1-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:0717a7390a68be14b8c793ba258e075c6f4ca819f15edfc2a3a027c823718567"},
@@ -2185,14 +2187,27 @@ markupsafe = [
     {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux2010_i686.whl", hash = "sha256:d7f9850398e85aba693bb640262d3611788b1f29a79f0c93c565694658f4071f"},
     {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux2010_x86_64.whl", hash = "sha256:6a7fae0dd14cf60ad5ff42baa2e95727c3d81ded453457771d02b7d2b3f9c0c2"},
     {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux2014_aarch64.whl", hash = "sha256:b7f2d075102dc8c794cbde1947378051c4e5180d52d276987b8d28a3bd58c17d"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e9936f0b261d4df76ad22f8fee3ae83b60d7c3e871292cd42f40b81b70afae85"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:2a7d351cbd8cfeb19ca00de495e224dea7e7d919659c2841bbb7f420ad03e2d6"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:60bf42e36abfaf9aff1f50f52644b336d4f0a3fd6d8a60ca0d054ac9f713a864"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-musllinux_1_1_aarch64.whl", hash = "sha256:d6c7ebd4e944c85e2c3421e612a7057a2f48d478d79e61800d81468a8d842207"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:f0567c4dc99f264f49fe27da5f735f414c4e7e7dd850cfd8e69f0862d7c74ea9"},
+    {file = "MarkupSafe-2.0.1-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:89c687013cb1cd489a0f0ac24febe8c7a666e6e221b783e53ac50ebf68e45d86"},
     {file = "MarkupSafe-2.0.1-cp37-cp37m-win32.whl", hash = "sha256:a30e67a65b53ea0a5e62fe23682cfe22712e01f453b95233b25502f7c61cb415"},
     {file = "MarkupSafe-2.0.1-cp37-cp37m-win_amd64.whl", hash = "sha256:611d1ad9a4288cf3e3c16014564df047fe08410e628f89805e475368bd304914"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:5bb28c636d87e840583ee3adeb78172efc47c8b26127267f54a9c0ec251d41a9"},
     {file = "MarkupSafe-2.0.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:be98f628055368795d818ebf93da628541e10b75b41c559fdf36d104c5787066"},
     {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux1_i686.whl", hash = "sha256:1d609f577dc6e1aa17d746f8bd3c31aa4d258f4070d61b2aa5c4166c1539de35"},
     {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux1_x86_64.whl", hash = "sha256:7d91275b0245b1da4d4cfa07e0faedd5b0812efc15b702576d103293e252af1b"},
     {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux2010_i686.whl", hash = "sha256:01a9b8ea66f1658938f65b93a85ebe8bc016e6769611be228d797c9d998dd298"},
     {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux2010_x86_64.whl", hash = "sha256:47ab1e7b91c098ab893b828deafa1203de86d0bc6ab587b160f78fe6c4011f75"},
     {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux2014_aarch64.whl", hash = "sha256:97383d78eb34da7e1fa37dd273c20ad4320929af65d156e35a5e2d89566d9dfb"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6fcf051089389abe060c9cd7caa212c707e58153afa2c649f00346ce6d260f1b"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:5855f8438a7d1d458206a2466bf82b0f104a3724bf96a1c781ab731e4201731a"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:3dd007d54ee88b46be476e293f48c85048603f5f516008bee124ddd891398ed6"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:aca6377c0cb8a8253e493c6b451565ac77e98c2951c45f913e0b52facdcff83f"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:04635854b943835a6ea959e948d19dcd311762c5c0c6e1f0e16ee57022669194"},
+    {file = "MarkupSafe-2.0.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:6300b8454aa6930a24b9618fbb54b5a68135092bc666f7b06901f897fa5c2fee"},
     {file = "MarkupSafe-2.0.1-cp38-cp38-win32.whl", hash = "sha256:023cb26ec21ece8dc3907c0e8320058b2e0cb3c55cf9564da612bc325bed5e64"},
     {file = "MarkupSafe-2.0.1-cp38-cp38-win_amd64.whl", hash = "sha256:984d76483eb32f1bcb536dc27e4ad56bba4baa70be32fa87152832cdd9db0833"},
     {file = "MarkupSafe-2.0.1-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:2ef54abee730b502252bcdf31b10dacb0a416229b72c18b19e24a4509f273d26"},
@@ -2202,6 +2217,12 @@ markupsafe = [
     {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux2010_i686.whl", hash = "sha256:4efca8f86c54b22348a5467704e3fec767b2db12fc39c6d963168ab1d3fc9135"},
     {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux2010_x86_64.whl", hash = "sha256:ab3ef638ace319fa26553db0624c4699e31a28bb2a835c5faca8f8acf6a5a902"},
     {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux2014_aarch64.whl", hash = "sha256:f8ba0e8349a38d3001fae7eadded3f6606f0da5d748ee53cc1dab1d6527b9509"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c47adbc92fc1bb2b3274c4b3a43ae0e4573d9fbff4f54cd484555edbf030baf1"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:37205cac2a79194e3750b0af2a5720d95f786a55ce7df90c3af697bfa100eaac"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:1f2ade76b9903f39aa442b4aadd2177decb66525062db244b35d71d0ee8599b6"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:4296f2b1ce8c86a6aea78613c34bb1a672ea0e3de9c6ba08a960efe0b0a09047"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:9f02365d4e99430a12647f09b6cc8bab61a6564363f313126f775eb4f6ef798e"},
+    {file = "MarkupSafe-2.0.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:5b6d930f030f8ed98e3e6c98ffa0652bdb82601e7a016ec2ab5d7ff23baa78d1"},
     {file = "MarkupSafe-2.0.1-cp39-cp39-win32.whl", hash = "sha256:10f82115e21dc0dfec9ab5c0223652f7197feb168c940f3ef61563fc2d6beb74"},
     {file = "MarkupSafe-2.0.1-cp39-cp39-win_amd64.whl", hash = "sha256:693ce3f9e70a6cf7d2fb9e6c9d8b204b6b39897a2c4a1aa65728d5ac97dcc1d8"},
     {file = "MarkupSafe-2.0.1.tar.gz", hash = "sha256:594c67807fb16238b30c44bdf74f36c02cdf22d1c8cda91ef8a0ed8dabf5620a"},
@@ -2277,8 +2298,8 @@ packaging = [
     {file = "packaging-21.3.tar.gz", hash = "sha256:dd47c42927d89ab911e606518907cc2d3a1f38bbd026385970643f9c5b8ecfeb"},
 ]
 paramiko = [
-    {file = "paramiko-2.9.2-py2.py3-none-any.whl", hash = "sha256:04097dbd96871691cdb34c13db1883066b8a13a0df2afd4cb0a92221f51c2603"},
-    {file = "paramiko-2.9.2.tar.gz", hash = "sha256:944a9e5dbdd413ab6c7951ea46b0ab40713235a9c4c5ca81cfe45c6f14fa677b"},
+    {file = "paramiko-2.10.1-py2.py3-none-any.whl", hash = "sha256:f6cbd3e1204abfdbcd40b3ecbc9d32f04027cd3080fe666245e21e7540ccfc1b"},
+    {file = "paramiko-2.10.1.tar.gz", hash = "sha256:443f4da23ec24e9a9c0ea54017829c282abdda1d57110bf229360775ccd27a31"},
 ]
 parso = [
     {file = "parso-0.8.3-py2.py3-none-any.whl", hash = "sha256:c001d4636cd3aecdaf33cbb40aebb59b094be2a74c556778ef5576c175e19e75"},
@@ -2598,29 +2619,6 @@ pyparsing = [
     {file = "pyparsing-2.4.7-py2.py3-none-any.whl", hash = "sha256:ef9d7589ef3c200abe66653d3f1ab1033c3c419ae9b9bdb1240a85b024efc88b"},
     {file = "pyparsing-2.4.7.tar.gz", hash = "sha256:c203ec8783bf771a155b207279b9bccb8dea02d8f0c9e5f8ead507bc3246ecc1"},
 ]
-pyrsistent = [
-    {file = "pyrsistent-0.18.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:df46c854f490f81210870e509818b729db4488e1f30f2a1ce1698b2295a878d1"},
-    {file = "pyrsistent-0.18.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:5d45866ececf4a5fff8742c25722da6d4c9e180daa7b405dc0a2a2790d668c26"},
-    {file = "pyrsistent-0.18.1-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:4ed6784ceac462a7d6fcb7e9b663e93b9a6fb373b7f43594f9ff68875788e01e"},
-    {file = "pyrsistent-0.18.1-cp310-cp310-win32.whl", hash = "sha256:e4f3149fd5eb9b285d6bfb54d2e5173f6a116fe19172686797c056672689daf6"},
-    {file = "pyrsistent-0.18.1-cp310-cp310-win_amd64.whl", hash = "sha256:636ce2dc235046ccd3d8c56a7ad54e99d5c1cd0ef07d9ae847306c91d11b5fec"},
-    {file = "pyrsistent-0.18.1-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:e92a52c166426efbe0d1ec1332ee9119b6d32fc1f0bbfd55d5c1088070e7fc1b"},
-    {file = "pyrsistent-0.18.1-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d7a096646eab884bf8bed965bad63ea327e0d0c38989fc83c5ea7b8a87037bfc"},
-    {file = "pyrsistent-0.18.1-cp37-cp37m-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:cdfd2c361b8a8e5d9499b9082b501c452ade8bbf42aef97ea04854f4a3f43b22"},
-    {file = "pyrsistent-0.18.1-cp37-cp37m-win32.whl", hash = "sha256:7ec335fc998faa4febe75cc5268a9eac0478b3f681602c1f27befaf2a1abe1d8"},
-    {file = "pyrsistent-0.18.1-cp37-cp37m-win_amd64.whl", hash = "sha256:6455fc599df93d1f60e1c5c4fe471499f08d190d57eca040c0ea182301321286"},
-    {file = "pyrsistent-0.18.1-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:fd8da6d0124efa2f67d86fa70c851022f87c98e205f0594e1fae044e7119a5a6"},
-    {file = "pyrsistent-0.18.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7bfe2388663fd18bd8ce7db2c91c7400bf3e1a9e8bd7d63bf7e77d39051b85ec"},
-    {file = "pyrsistent-0.18.1-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:0e3e1fcc45199df76053026a51cc59ab2ea3fc7c094c6627e93b7b44cdae2c8c"},
-    {file = "pyrsistent-0.18.1-cp38-cp38-win32.whl", hash = "sha256:b568f35ad53a7b07ed9b1b2bae09eb15cdd671a5ba5d2c66caee40dbf91c68ca"},
-    {file = "pyrsistent-0.18.1-cp38-cp38-win_amd64.whl", hash = "sha256:d1b96547410f76078eaf66d282ddca2e4baae8964364abb4f4dcdde855cd123a"},
-    {file = "pyrsistent-0.18.1-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:f87cc2863ef33c709e237d4b5f4502a62a00fab450c9e020892e8e2ede5847f5"},
-    {file = "pyrsistent-0.18.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:6bc66318fb7ee012071b2792024564973ecc80e9522842eb4e17743604b5e045"},
-    {file = "pyrsistent-0.18.1-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:914474c9f1d93080338ace89cb2acee74f4f666fb0424896fcfb8d86058bf17c"},
-    {file = "pyrsistent-0.18.1-cp39-cp39-win32.whl", hash = "sha256:1b34eedd6812bf4d33814fca1b66005805d3640ce53140ab8bbb1e2651b0d9bc"},
-    {file = "pyrsistent-0.18.1-cp39-cp39-win_amd64.whl", hash = "sha256:e24a828f57e0c337c8d8bb9f6b12f09dfdf0273da25fda9e314f0b684b415a07"},
-    {file = "pyrsistent-0.18.1.tar.gz", hash = "sha256:d4d61f8b993a7255ba714df3aca52700f8125289f84f704cf80916517c46eb96"},
-]
 pysftp = [
     {file = "pysftp-0.2.9.tar.gz", hash = "sha256:fbf55a802e74d663673400acd92d5373c1c7ee94d765b428d9f977567ac4854a"},
 ]

From 3f8f9b9008238f7220b2b101bcceedefb70cc9f4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jakub=20Je=C5=BEek?= <jakub@orbi.tools>
Date: Wed, 30 Mar 2022 10:47:55 +0200
Subject: [PATCH 061/108] Update
 openpype/hosts/flame/plugins/publish/collect_timeline_instances.py

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 .../hosts/flame/plugins/publish/collect_timeline_instances.py  | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py b/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
index 390c55837c..bc5c60a97d 100644
--- a/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
+++ b/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
@@ -98,8 +98,7 @@ class CollectTimelineInstances(pyblish.api.ContextPlugin):
             label = asset
             if asset != clip_name:
                 label += " ({})".format(clip_name)
-            label += " {}".format(subset)
-            label += " {}".format("[" + ", ".join(families) + "]")
+            label += " {} [{}]".format(subset, ", ".join(families))
 
             inst_data.update({
                 "name": "{}_{}".format(asset, subset),

From fbe34f74a3c18901c31b5735ddbdec38093f156d Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakub@orbi.tools>
Date: Wed, 30 Mar 2022 10:49:53 +0200
Subject: [PATCH 062/108] flame: flip order of processing

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

diff --git a/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py b/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
index bc5c60a97d..2482abd9c7 100644
--- a/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
+++ b/openpype/hosts/flame/plugins/publish/collect_timeline_instances.py
@@ -43,17 +43,6 @@ class CollectTimelineInstances(pyblish.api.ContextPlugin):
 
         # process all sellected
         for segment in selected_segments:
-            comment_attributes = self._get_comment_attributes(segment)
-            self.log.debug("__ segment.name: {}".format(
-                segment.name
-            ))
-            self.log.debug("_ comment_attributes: {}".format(
-                pformat(comment_attributes)))
-
-            clip_data = opfapi.get_segment_attributes(segment)
-            clip_name = clip_data["segment_name"]
-            self.log.debug("clip_name: {}".format(clip_name))
-
             # get openpype tag data
             marker_data = opfapi.get_segment_data_marker(segment)
             self.log.debug("__ marker_data: {}".format(
@@ -65,6 +54,19 @@ class CollectTimelineInstances(pyblish.api.ContextPlugin):
             if marker_data.get("id") != "pyblish.avalon.instance":
                 continue
 
+            self.log.debug("__ segment.name: {}".format(
+                segment.name
+            ))
+
+            comment_attributes = self._get_comment_attributes(segment)
+
+            self.log.debug("_ comment_attributes: {}".format(
+                pformat(comment_attributes)))
+
+            clip_data = opfapi.get_segment_attributes(segment)
+            clip_name = clip_data["segment_name"]
+            self.log.debug("clip_name: {}".format(clip_name))
+
             # get file path
             file_path = clip_data["fpath"]
 

From ee96827ff225fb1dff1419074acc89103b0cdd08 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakub@orbi.tools>
Date: Wed, 30 Mar 2022 10:59:01 +0200
Subject: [PATCH 063/108] flame: improving handling color policy input

---
 openpype/hosts/flame/api/scripts/wiretap_com.py | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/flame/api/scripts/wiretap_com.py b/openpype/hosts/flame/api/scripts/wiretap_com.py
index a85a85ae25..54993d34eb 100644
--- a/openpype/hosts/flame/api/scripts/wiretap_com.py
+++ b/openpype/hosts/flame/api/scripts/wiretap_com.py
@@ -422,7 +422,13 @@ class WireTapCom(object):
         color_policy = color_policy or "Legacy"
 
         # check if the colour policy in custom dir
-        if "/" not in color_policy:
+        if "/" in color_policy:
+            # if unlikelly full path was used make it redundant
+            color_policy = color_policy.replace("/syncolor/policies/", "")
+            # expecting input is `Shared/NameOfPolicy`
+            color_policy = "/syncolor/policies/{}".format(
+                color_policy)
+        else:
             color_policy = "/syncolor/policies/Autodesk/{}".format(
                 color_policy)
 

From 36a43d402012e0115a856f1d6058397ab29e4fd2 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Date: Wed, 30 Mar 2022 11:11:37 +0200
Subject: [PATCH 064/108] Simplified getting host and app filter acess.

Co-authored-by: Roy Nieterau <roy_nieterau@hotmail.com>
---
 openpype/lib/applications.py | 9 ++-------
 1 file changed, 2 insertions(+), 7 deletions(-)

diff --git a/openpype/lib/applications.py b/openpype/lib/applications.py
index b496bd74e2..5821c863d7 100644
--- a/openpype/lib/applications.py
+++ b/openpype/lib/applications.py
@@ -571,13 +571,8 @@ class EnvironmentTool:
         # Backwards compatibility 3.9.1 - 3.9.2
         # - 'variant_data' contained only environments but contain also host
         #   and application variant filters
-        host_names = []
-        app_variants = []
-        if "host_names" in variant_data:
-            host_names = variant_data["host_names"]
-
-        if "app_variants" in variant_data:
-            app_variants = variant_data["app_variants"]
+        host_names = variant_data.get("host_names", [])
+        app_variants = variant_data.get("app_variants", [])
 
         if "environment" in variant_data:
             environment = variant_data["environment"]

From a62d98235c9d316a5c878c9376b254472d37b3de Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 30 Mar 2022 11:50:05 +0200
Subject: [PATCH 065/108] force completer to be shown inactive

---
 openpype/tools/settings/settings/widgets.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/openpype/tools/settings/settings/widgets.py b/openpype/tools/settings/settings/widgets.py
index 577c2630ab..b3518cffd9 100644
--- a/openpype/tools/settings/settings/widgets.py
+++ b/openpype/tools/settings/settings/widgets.py
@@ -97,6 +97,9 @@ class CompleterView(QtWidgets.QListView):
             QtCore.Qt.FramelessWindowHint
             | QtCore.Qt.Tool
         )
+
+        # Open the widget unactivated
+        self.setAttribute(QtCore.Qt.WA_ShowWithoutActivating)
         delegate = QtWidgets.QStyledItemDelegate()
         self.setItemDelegate(delegate)
 

From ccf563d60ab7a11dc3dcd7ab81c45134d0a5c387 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Wed, 30 Mar 2022 11:54:38 +0200
Subject: [PATCH 066/108] `METADATA_KEYS` constant as `frozenset` for optimal
 immutable lookup

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

diff --git a/openpype/settings/constants.py b/openpype/settings/constants.py
index 8b8acf5714..19ff953eb4 100644
--- a/openpype/settings/constants.py
+++ b/openpype/settings/constants.py
@@ -8,11 +8,11 @@ M_ENVIRONMENT_KEY = "__environment_keys__"
 # Metadata key for storing dynamic created labels
 M_DYNAMIC_KEY_LABEL = "__dynamic_keys_labels__"
 
-METADATA_KEYS = (
+METADATA_KEYS = frozenset([
     M_OVERRIDDEN_KEY,
     M_ENVIRONMENT_KEY,
     M_DYNAMIC_KEY_LABEL
-)
+])
 
 # Keys where studio's system overrides are stored
 GLOBAL_SETTINGS_KEY = "global_settings"

From a6a98ae104c3747bec65ebd19c2d81110021acc1 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Wed, 30 Mar 2022 13:27:59 +0200
Subject: [PATCH 067/108] Switched subset function according to review comments

---
 .../hosts/photoshop/plugins/publish/collect_review.py     | 8 ++++----
 .../hosts/photoshop/plugins/publish/collect_workfile.py   | 8 ++++----
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/openpype/hosts/photoshop/plugins/publish/collect_review.py b/openpype/hosts/photoshop/plugins/publish/collect_review.py
index 8b7508cf5b..f3842b9ee5 100644
--- a/openpype/hosts/photoshop/plugins/publish/collect_review.py
+++ b/openpype/hosts/photoshop/plugins/publish/collect_review.py
@@ -2,7 +2,7 @@ import os
 
 import pyblish.api
 
-from openpype.lib import get_subset_name
+from openpype.lib import get_subset_name_with_asset_doc
 
 
 class CollectReview(pyblish.api.ContextPlugin):
@@ -14,13 +14,13 @@ class CollectReview(pyblish.api.ContextPlugin):
 
     def process(self, context):
         family = "review"
-        subset = get_subset_name(
+        subset = get_subset_name_with_asset_doc(
             family,
             "",
             context.data["anatomyData"]["task"]["name"],
-            context.data["assetEntity"]["_id"],
+            context.data["assetEntity"],
             context.data["anatomyData"]["project"]["name"],
-            host_name="photoshop"
+            host_name=context.data["hostName"]
         )
 
         file_path = context.data["currentFile"]
diff --git a/openpype/hosts/photoshop/plugins/publish/collect_workfile.py b/openpype/hosts/photoshop/plugins/publish/collect_workfile.py
index ca1124fd24..0dbe2c6609 100644
--- a/openpype/hosts/photoshop/plugins/publish/collect_workfile.py
+++ b/openpype/hosts/photoshop/plugins/publish/collect_workfile.py
@@ -1,7 +1,7 @@
 import os
 import pyblish.api
 
-from openpype.lib import get_subset_name
+from openpype.lib import get_subset_name_with_asset_doc
 
 
 class CollectWorkfile(pyblish.api.ContextPlugin):
@@ -13,13 +13,13 @@ class CollectWorkfile(pyblish.api.ContextPlugin):
 
     def process(self, context):
         family = "workfile"
-        subset = get_subset_name(
+        subset = get_subset_name_with_asset_doc(
             family,
             "",
             context.data["anatomyData"]["task"]["name"],
-            context.data["assetEntity"]["_id"],
+            context.data["assetEntity"],
             context.data["anatomyData"]["project"]["name"],
-            host_name="photoshop"
+            host_name=context.data["hostName"]
         )
 
         file_path = context.data["currentFile"]

From 57ba944ad3759136d000e7d946a6c438e56d6faa Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakub@orbi.tools>
Date: Wed, 30 Mar 2022 14:10:09 +0200
Subject: [PATCH 068/108] nuke: settings for read raw

reordering ui attributes for better logic
---
 .../defaults/project_settings/nuke.json       |  7 +++--
 .../schemas/schema_nuke_publish.json          | 29 ++++++++++++-------
 2 files changed, 23 insertions(+), 13 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/nuke.json b/openpype/settings/defaults/project_settings/nuke.json
index 6992fb6e3e..2fb6a372e4 100644
--- a/openpype/settings/defaults/project_settings/nuke.json
+++ b/openpype/settings/defaults/project_settings/nuke.json
@@ -119,11 +119,10 @@
                         "families": [],
                         "sebsets": []
                     },
-                    "extension": "mov",
+                    "read_raw": false,
                     "viewer_process_override": "",
                     "bake_viewer_process": true,
                     "bake_viewer_input_process": true,
-                    "add_tags": [],
                     "reformat_node_add": false,
                     "reformat_node_config": [
                         {
@@ -151,7 +150,9 @@
                             "name": "pbb",
                             "value": false
                         }
-                    ]
+                    ],
+                    "extension": "mov",
+                    "add_tags": []
                 }
             }
         },
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_publish.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_publish.json
index 1636a8d700..673e12d54b 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_publish.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_publish.json
@@ -208,9 +208,10 @@
                                 "type": "separator"
                             },
                             {
-                                "type": "text",
-                                "key": "extension",
-                                "label": "File extension"
+                                "type": "boolean",
+                                "key": "read_raw",
+                                "label": "Read colorspace RAW",
+                                "default": false
                             },
                             {
                                 "type": "text",
@@ -227,12 +228,6 @@
                                 "key": "bake_viewer_input_process",
                                 "label": "Bake Viewer Input Process (LUTs)"
                             },
-                            {
-                                "key": "add_tags",
-                                "label": "Add additional tags to representations",
-                                "type": "list",
-                                "object_type": "text"
-                            },
                             {
                                 "type": "separator"
                             },
@@ -246,7 +241,7 @@
                                 "type": "collapsible-wrap",
                                 "label": "Reformat Node Knobs",
                                 "collapsible": true,
-                                "collapsed": false,
+                                "collapsed": true,
                                 "children": [
                                     {
                                         "type": "list",
@@ -347,6 +342,20 @@
                                         }
                                     }
                                 ]
+                            },
+                            {
+                                "type": "separator"
+                            },
+                            {
+                                "type": "text",
+                                "key": "extension",
+                                "label": "Write node file type"
+                            },
+                            {
+                                "key": "add_tags",
+                                "label": "Add additional tags to representations",
+                                "type": "list",
+                                "object_type": "text"
                             }
                         ]
                     }

From 65d93ca9f109ae9dad81d2c9058dee423feda6fb Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakub@orbi.tools>
Date: Wed, 30 Mar 2022 14:15:22 +0200
Subject: [PATCH 069/108] nuke: adding read raw baking preset attr

---
 openpype/hosts/nuke/api/plugin.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/openpype/hosts/nuke/api/plugin.py b/openpype/hosts/nuke/api/plugin.py
index d0bb45a05d..3ac750a48f 100644
--- a/openpype/hosts/nuke/api/plugin.py
+++ b/openpype/hosts/nuke/api/plugin.py
@@ -450,6 +450,7 @@ class ExporterReviewMov(ExporterReview):
 
     def generate_mov(self, farm=False, **kwargs):
         self.publish_on_farm = farm
+        read_raw = kwargs["read_raw"]
         reformat_node_add = kwargs["reformat_node_add"]
         reformat_node_config = kwargs["reformat_node_config"]
         bake_viewer_process = kwargs["bake_viewer_process"]
@@ -484,6 +485,9 @@ class ExporterReviewMov(ExporterReview):
         r_node["origlast"].setValue(self.last_frame)
         r_node["colorspace"].setValue(self.write_colorspace)
 
+        if read_raw:
+            r_node["raw"].setValue(1)
+
         # connect
         self._temp_nodes[subset].append(r_node)
         self.previous_node = r_node

From 215da09d3dcf92138eeddfc97bf48a9fd5728729 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 30 Mar 2022 15:24:23 +0200
Subject: [PATCH 070/108] Change default value of force copy to True

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

diff --git a/openpype/hosts/maya/plugins/create/create_look.py b/openpype/hosts/maya/plugins/create/create_look.py
index 56e2640919..d9521d1860 100644
--- a/openpype/hosts/maya/plugins/create/create_look.py
+++ b/openpype/hosts/maya/plugins/create/create_look.py
@@ -22,4 +22,4 @@ class CreateLook(plugin.Creator):
         self.data["maketx"] = self.make_tx
 
         # Enable users to force a copy.
-        self.data["forceCopy"] = False
+        self.data["forceCopy"] = True

From 8eab6ae180fe308e03bc4d3df7cd53bd030b59ce Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 30 Mar 2022 16:25:37 +0200
Subject: [PATCH 071/108] disable hardlink on windows for look publishing

---
 openpype/hosts/maya/plugins/create/create_look.py   | 4 +++-
 openpype/hosts/maya/plugins/publish/extract_look.py | 7 ++++++-
 2 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/maya/plugins/create/create_look.py b/openpype/hosts/maya/plugins/create/create_look.py
index d9521d1860..44e439fe1f 100644
--- a/openpype/hosts/maya/plugins/create/create_look.py
+++ b/openpype/hosts/maya/plugins/create/create_look.py
@@ -22,4 +22,6 @@ class CreateLook(plugin.Creator):
         self.data["maketx"] = self.make_tx
 
         # Enable users to force a copy.
-        self.data["forceCopy"] = True
+        # - on Windows is "forceCopy" always changed to `True` because of
+        #   windows implementation of hardlinks
+        self.data["forceCopy"] = False
diff --git a/openpype/hosts/maya/plugins/publish/extract_look.py b/openpype/hosts/maya/plugins/publish/extract_look.py
index a8893072d0..137683ca6d 100644
--- a/openpype/hosts/maya/plugins/publish/extract_look.py
+++ b/openpype/hosts/maya/plugins/publish/extract_look.py
@@ -4,6 +4,7 @@ import os
 import sys
 import json
 import tempfile
+import platform
 import contextlib
 import subprocess
 from collections import OrderedDict
@@ -334,7 +335,11 @@ class ExtractLook(openpype.api.Extractor):
         transfers = []
         hardlinks = []
         hashes = {}
-        force_copy = instance.data.get("forceCopy", False)
+        # Temporary fix to NOT create hardlinks on windows machines
+        if platform.system().lower() == "windows":
+            force_copy = True
+        else:
+            force_copy = instance.data.get("forceCopy", False)
 
         for filepath in files_metadata:
 

From 58085d3b4ed15ac8506b2a86ae402e68be176f51 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 30 Mar 2022 16:31:41 +0200
Subject: [PATCH 072/108] removed unused function

---
 openpype/modules/ftrack/lib/avalon_sync.py | 15 ---------------
 1 file changed, 15 deletions(-)

diff --git a/openpype/modules/ftrack/lib/avalon_sync.py b/openpype/modules/ftrack/lib/avalon_sync.py
index 5301ec568e..c5b58ca94d 100644
--- a/openpype/modules/ftrack/lib/avalon_sync.py
+++ b/openpype/modules/ftrack/lib/avalon_sync.py
@@ -286,21 +286,6 @@ def from_dict_to_set(data, is_project):
     return result
 
 
-def get_avalon_project_template(project_name):
-    """Get avalon template
-    Args:
-        project_name: (string)
-    Returns:
-        dictionary with templates
-    """
-    templates = Anatomy(project_name).templates
-    return {
-        "workfile": templates["avalon"]["workfile"],
-        "work": templates["avalon"]["work"],
-        "publish": templates["avalon"]["publish"]
-    }
-
-
 def get_project_apps(in_app_list):
     """ Application definitions for app name.
 

From 8940830787fc68d043febecd26040d944e5d91d9 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 30 Mar 2022 16:38:45 +0200
Subject: [PATCH 073/108] added info log about changing hardlink

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

diff --git a/openpype/hosts/maya/plugins/publish/extract_look.py b/openpype/hosts/maya/plugins/publish/extract_look.py
index 137683ca6d..6fcc308f78 100644
--- a/openpype/hosts/maya/plugins/publish/extract_look.py
+++ b/openpype/hosts/maya/plugins/publish/extract_look.py
@@ -337,6 +337,9 @@ class ExtractLook(openpype.api.Extractor):
         hashes = {}
         # Temporary fix to NOT create hardlinks on windows machines
         if platform.system().lower() == "windows":
+            self.log.info(
+                "Forcing copy instead of hardlink due to issues on Windows..."
+            )
             force_copy = True
         else:
             force_copy = instance.data.get("forceCopy", False)

From 1f1b15e2fcf07b117c34d6e429e7d92677d8dd66 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 31 Mar 2022 11:03:42 +0200
Subject: [PATCH 074/108] hide completer using timer

---
 openpype/tools/settings/settings/widgets.py | 26 ++++++++++++++-------
 1 file changed, 17 insertions(+), 9 deletions(-)

diff --git a/openpype/tools/settings/settings/widgets.py b/openpype/tools/settings/settings/widgets.py
index b3518cffd9..6db001f2f6 100644
--- a/openpype/tools/settings/settings/widgets.py
+++ b/openpype/tools/settings/settings/widgets.py
@@ -228,10 +228,18 @@ class SettingsLineEdit(PlaceholderLineEdit):
     def __init__(self, *args, **kwargs):
         super(SettingsLineEdit, self).__init__(*args, **kwargs)
 
-        self._completer = None
+        # Timer which will get started on focus in and stopped on focus out
+        # - callback checks if line edit or completer have focus
+        #   and hide completer if not
+        focus_timer = QtCore.QTimer()
+        focus_timer.setInterval(50)
 
+        focus_timer.timeout.connect(self._on_focus_timer)
         self.textChanged.connect(self._on_text_change)
 
+        self._completer = None
+        self._focus_timer = focus_timer
+
     def _on_text_change(self, text):
         if self._completer is not None:
             self._completer.set_text_filter(text)
@@ -243,19 +251,19 @@ class SettingsLineEdit(PlaceholderLineEdit):
         new_point = self.mapToGlobal(point)
         self._completer.move(new_point)
 
+    def _on_focus_timer(self):
+        if not self.hasFocus() and not self._completer.hasFocus():
+            self._completer.hide()
+            self._focus_timer.stop()
+
     def focusInEvent(self, event):
         super(SettingsLineEdit, self).focusInEvent(event)
         self.focused_in.emit()
 
-        if self._completer is None:
-            return
-        self._completer.show()
-        self._update_completer()
-
-    def focusOutEvent(self, event):
-        super(SettingsLineEdit, self).focusOutEvent(event)
         if self._completer is not None:
-            self._completer.hide()
+            self._focus_timer.start()
+            self._completer.show()
+            self._update_completer()
 
     def paintEvent(self, event):
         super(SettingsLineEdit, self).paintEvent(event)

From 4891f336ed50ec51ab8d3736c5af483f08334acc Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Thu, 31 Mar 2022 11:09:57 +0200
Subject: [PATCH 075/108] Fix - handle better exception when no file opened in
 AE

Occured when no scene was opened and Workfile wanted to open existing workfile
---
 openpype/hosts/aftereffects/api/workio.py | 23 ++++++++++++++---------
 1 file changed, 14 insertions(+), 9 deletions(-)

diff --git a/openpype/hosts/aftereffects/api/workio.py b/openpype/hosts/aftereffects/api/workio.py
index 5a8f86ead5..70815bda6b 100644
--- a/openpype/hosts/aftereffects/api/workio.py
+++ b/openpype/hosts/aftereffects/api/workio.py
@@ -5,14 +5,6 @@ from openpype.pipeline import HOST_WORKFILE_EXTENSIONS
 from .launch_logic import get_stub
 
 
-def _active_document():
-    document_name = get_stub().get_active_document_name()
-    if not document_name:
-        return None
-
-    return document_name
-
-
 def file_extensions():
     return HOST_WORKFILE_EXTENSIONS["aftereffects"]
 
@@ -39,7 +31,8 @@ def current_file():
         full_name = get_stub().get_active_document_full_name()
         if full_name and full_name != "null":
             return os.path.normpath(full_name).replace("\\", "/")
-    except Exception:
+    except ValueError:
+        print("Nothing opened")
         pass
 
     return None
@@ -47,3 +40,15 @@ def current_file():
 
 def work_root(session):
     return os.path.normpath(session["AVALON_WORKDIR"]).replace("\\", "/")
+
+
+def _active_document():
+    # TODO merge with current_file - even in extension
+    document_name = None
+    try:
+        document_name = get_stub().get_active_document_name()
+    except ValueError:
+        print("Nothing opened")
+        pass
+
+    return document_name
\ No newline at end of file

From d6b423e2082f0cc3e0cff7a4b3d8730ca44533d4 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Date: Thu, 31 Mar 2022 11:15:34 +0200
Subject: [PATCH 076/108] Change Pype to OpenPype
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Ondřej Samohel <33513211+antirotor@users.noreply.github.com>
---
 openpype/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/__init__.py b/openpype/__init__.py
index 2820091bcc..7fc7e63e61 100644
--- a/openpype/__init__.py
+++ b/openpype/__init__.py
@@ -24,7 +24,7 @@ LOAD_PATH = os.path.join(PLUGINS_DIR, "load")
 
 
 def install():
-    """Install Pype to Avalon."""
+    """Install OpenPype to Avalon."""
     import avalon.api
     import pyblish.api
     from pyblish.lib import MessageHandler

From 1499fecc73af170f095b1bdd3bd244e63413a54d Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 31 Mar 2022 11:18:32 +0200
Subject: [PATCH 077/108] fix thumbnail discovery

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

diff --git a/openpype/pipeline/thumbnail.py b/openpype/pipeline/thumbnail.py
index 47452b21e7..c09dab70eb 100644
--- a/openpype/pipeline/thumbnail.py
+++ b/openpype/pipeline/thumbnail.py
@@ -131,7 +131,7 @@ class BinaryThumbnail(ThumbnailResolver):
 
 # Thumbnail resolvers
 def discover_thumbnail_resolvers():
-    return discover(ThumbnailResolver).plugins
+    return discover(ThumbnailResolver)
 
 
 def register_thumbnail_resolver(plugin):

From f630b8cb7d2c76d512c9dde35ba0a620cb7d1237 Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Thu, 31 Mar 2022 12:46:24 +0200
Subject: [PATCH 078/108] fix setuptools

---
 setup.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 3ee6ad43ea..5739356084 100644
--- a/setup.py
+++ b/setup.py
@@ -187,5 +187,6 @@ setup(
             "build_dir": (openpype_root / "docs" / "build").as_posix()
         }
     },
-    executables=executables
+    executables=executables,
+    package_dir=[]
 )

From 790850697f4742081779bccdc8230c1c04100f39 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Thu, 31 Mar 2022 13:16:52 +0200
Subject: [PATCH 079/108] OP-2517 - fix renaming subset incorrectly in PS

---
 .../hosts/photoshop/plugins/publish/validate_naming.py   | 9 +++++----
 .../settings/defaults/project_settings/photoshop.json    | 2 +-
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/openpype/hosts/photoshop/plugins/publish/validate_naming.py b/openpype/hosts/photoshop/plugins/publish/validate_naming.py
index b40e44d016..583e9c7a4e 100644
--- a/openpype/hosts/photoshop/plugins/publish/validate_naming.py
+++ b/openpype/hosts/photoshop/plugins/publish/validate_naming.py
@@ -29,7 +29,8 @@ class ValidateNamingRepair(pyblish.api.Action):
         stub = photoshop.stub()
         for instance in instances:
             self.log.info("validate_naming instance {}".format(instance))
-            metadata = stub.read(instance[0])
+            layer_item = instance.data["layer"]
+            metadata = stub.read(layer_item)
             self.log.info("metadata instance {}".format(metadata))
             layer_name = None
             if metadata.get("uuid"):
@@ -43,11 +44,11 @@ class ValidateNamingRepair(pyblish.api.Action):
                     stub.rename_layer(instance.data["uuid"], layer_name)
 
             subset_name = re.sub(invalid_chars, replace_char,
-                                 instance.data["name"])
+                                 instance.data["subset"])
 
-            instance[0].Name = layer_name or subset_name
+            layer_item.name = layer_name or subset_name
             metadata["subset"] = subset_name
-            stub.imprint(instance[0], metadata)
+            stub.imprint(layer_item, metadata)
 
         return True
 
diff --git a/openpype/settings/defaults/project_settings/photoshop.json b/openpype/settings/defaults/project_settings/photoshop.json
index 118b9c721e..822a94a8eb 100644
--- a/openpype/settings/defaults/project_settings/photoshop.json
+++ b/openpype/settings/defaults/project_settings/photoshop.json
@@ -18,7 +18,7 @@
             "active": true
         },
         "ValidateNaming": {
-            "invalid_chars": "[ \\\\/+\\*\\?\\(\\)\\[\\]\\{\\}:,]",
+            "invalid_chars": "[ \\\\/+\\*\\?\\(\\)\\[\\]\\{\\}:,;]",
             "replace_char": "_"
         },
         "ExtractImage": {

From 5b81a43c7c7db30171d8f4110018f3a17e77f2b8 Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Thu, 31 Mar 2022 13:31:18 +0200
Subject: [PATCH 080/108] print log if build fails

---
 tools/build.ps1 | 3 +++
 tools/build.sh  | 4 ++--
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/tools/build.ps1 b/tools/build.ps1
index 10da3d0b83..ff28544954 100644
--- a/tools/build.ps1
+++ b/tools/build.ps1
@@ -180,6 +180,9 @@ $out = &  "$($env:POETRY_HOME)\bin\poetry" run python setup.py build 2>&1
 Set-Content -Path "$($openpype_root)\build\build.log" -Value $out
 if ($LASTEXITCODE -ne 0)
 {
+    Write-Host "------------------------------------------" -ForegroundColor Red
+    Get-Content "$($openpype_root)\build\build.log"
+    Write-Host "------------------------------------------" -ForegroundColor Red
     Write-Host "!!! " -NoNewLine -ForegroundColor Red
     Write-Host "Build failed. Check the log: " -NoNewline
     Write-Host ".\build\build.log" -ForegroundColor Yellow
diff --git a/tools/build.sh b/tools/build.sh
index 301f26023a..79fb748cd5 100755
--- a/tools/build.sh
+++ b/tools/build.sh
@@ -185,9 +185,9 @@ if [ "$disable_submodule_update" == 1 ]; then
   fi
   echo -e "${BIGreen}>>>${RST} Building ..."
   if [[ "$OSTYPE" == "linux-gnu"* ]]; then
-    "$POETRY_HOME/bin/poetry" run python "$openpype_root/setup.py" build &> "$openpype_root/build/build.log" || { echo -e "${BIRed}!!!${RST} Build failed, see the build log."; return 1; }
+    "$POETRY_HOME/bin/poetry" run python "$openpype_root/setup.py" build &> "$openpype_root/build/build.log" || { echo -e "${BIRed}------------------------------------------${RST}"; cat "$openpype_root/build/build.log"; echo -e "${BIRed}------------------------------------------${RST}"; echo -e "${BIRed}!!!${RST} Build failed, see the build log."; return 1; }
   elif [[ "$OSTYPE" == "darwin"* ]]; then
-    "$POETRY_HOME/bin/poetry" run python "$openpype_root/setup.py" bdist_mac &> "$openpype_root/build/build.log" || { echo -e "${BIRed}!!!${RST} Build failed, see the build log."; return 1; }
+    "$POETRY_HOME/bin/poetry" run python "$openpype_root/setup.py" bdist_mac &> "$openpype_root/build/build.log" || { echo -e "${BIRed}------------------------------------------${RST}"; cat "$openpype_root/build/build.log"; echo -e "${BIRed}------------------------------------------${RST}"; echo -e "${BIRed}!!!${RST} Build failed, see the build log."; return 1; }
   fi
   "$POETRY_HOME/bin/poetry" run python "$openpype_root/tools/build_dependencies.py"
 

From 67bc56c8bca8dde59b7b56e4823b437d3c547e5d Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@orbi.tools>
Date: Thu, 31 Mar 2022 14:12:38 +0200
Subject: [PATCH 081/108] fix argument

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 5739356084..bf42602b52 100644
--- a/setup.py
+++ b/setup.py
@@ -188,5 +188,5 @@ setup(
         }
     },
     executables=executables,
-    package_dir=[]
+    packages=[]
 )

From 8c213809effe28eaf92f09e876adae71900d8922 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakub@orbi.tools>
Date: Thu, 31 Mar 2022 15:47:37 +0200
Subject: [PATCH 082/108] flame: adding extract review data to bypass baking

---
 .../plugins/publish/extract_review_data.py    | 41 +++++++++++++++++++
 .../defaults/project_settings/nuke.json       |  3 ++
 .../schemas/schema_nuke_publish.json          | 15 +++++++
 3 files changed, 59 insertions(+)
 create mode 100644 openpype/hosts/nuke/plugins/publish/extract_review_data.py

diff --git a/openpype/hosts/nuke/plugins/publish/extract_review_data.py b/openpype/hosts/nuke/plugins/publish/extract_review_data.py
new file mode 100644
index 0000000000..19c894448d
--- /dev/null
+++ b/openpype/hosts/nuke/plugins/publish/extract_review_data.py
@@ -0,0 +1,41 @@
+import os
+import pyblish.api
+import openpype
+from pprint import pformat
+
+
+class ExtractReviewData(openpype.api.Extractor):
+    """Extracts review tag into available representation
+    """
+
+    order = pyblish.api.ExtractorOrder + 0.01
+    # order = pyblish.api.CollectorOrder + 0.499
+    label = "Extract Review Data"
+
+    families = ["review"]
+    hosts = ["nuke"]
+
+    def process(self, instance):
+        fpath = instance.data["path"]
+        ext = os.path.splitext(fpath)[-1][1:]
+
+        representations = instance.data.get("representations", [])
+
+        if "render.farm" in instance.data["families"]:
+            instance.data["families"].remove("review")
+
+        for repre in representations:
+            if ext not in repre["ext"]:
+                continue
+
+            if not repre.get("tags"):
+                repre["tags"] = []
+
+            if "review" not in repre["tags"]:
+                repre["tags"].append("review")
+
+            self.log.debug("Matching representation: {}".format(
+                pformat(repre)
+            ))
+
+        instance.data["representations"] = representations
diff --git a/openpype/settings/defaults/project_settings/nuke.json b/openpype/settings/defaults/project_settings/nuke.json
index 6992fb6e3e..d3d6252be7 100644
--- a/openpype/settings/defaults/project_settings/nuke.json
+++ b/openpype/settings/defaults/project_settings/nuke.json
@@ -106,6 +106,9 @@
                 ]
             }
         },
+        "ExtractReviewData": {
+            "enabled": false
+        },
         "ExtractReviewDataLut": {
             "enabled": false
         },
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_publish.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_publish.json
index 1636a8d700..6776f316d9 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_publish.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_publish.json
@@ -138,6 +138,21 @@
                 }
             ]
         },
+        {
+            "type": "dict",
+            "collapsible": true,
+            "checkbox_key": "enabled",
+            "key": "ExtractReviewData",
+            "label": "ExtractReviewData",
+            "is_group": true,
+            "children": [
+                {
+                    "type": "boolean",
+                    "key": "enabled",
+                    "label": "Enabled"
+                }
+            ]
+        },
         {
             "type": "dict",
             "collapsible": true,

From 15f4d110699249a540f4889b08b319056f42f29b Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakub@orbi.tools>
Date: Thu, 31 Mar 2022 15:47:37 +0200
Subject: [PATCH 083/108] nuke: adding extract review data to bypass baking

---
 .../plugins/publish/extract_review_data.py    | 41 +++++++++++++++++++
 .../defaults/project_settings/nuke.json       |  3 ++
 .../schemas/schema_nuke_publish.json          | 15 +++++++
 3 files changed, 59 insertions(+)
 create mode 100644 openpype/hosts/nuke/plugins/publish/extract_review_data.py

diff --git a/openpype/hosts/nuke/plugins/publish/extract_review_data.py b/openpype/hosts/nuke/plugins/publish/extract_review_data.py
new file mode 100644
index 0000000000..19c894448d
--- /dev/null
+++ b/openpype/hosts/nuke/plugins/publish/extract_review_data.py
@@ -0,0 +1,41 @@
+import os
+import pyblish.api
+import openpype
+from pprint import pformat
+
+
+class ExtractReviewData(openpype.api.Extractor):
+    """Extracts review tag into available representation
+    """
+
+    order = pyblish.api.ExtractorOrder + 0.01
+    # order = pyblish.api.CollectorOrder + 0.499
+    label = "Extract Review Data"
+
+    families = ["review"]
+    hosts = ["nuke"]
+
+    def process(self, instance):
+        fpath = instance.data["path"]
+        ext = os.path.splitext(fpath)[-1][1:]
+
+        representations = instance.data.get("representations", [])
+
+        if "render.farm" in instance.data["families"]:
+            instance.data["families"].remove("review")
+
+        for repre in representations:
+            if ext not in repre["ext"]:
+                continue
+
+            if not repre.get("tags"):
+                repre["tags"] = []
+
+            if "review" not in repre["tags"]:
+                repre["tags"].append("review")
+
+            self.log.debug("Matching representation: {}".format(
+                pformat(repre)
+            ))
+
+        instance.data["representations"] = representations
diff --git a/openpype/settings/defaults/project_settings/nuke.json b/openpype/settings/defaults/project_settings/nuke.json
index 6992fb6e3e..d3d6252be7 100644
--- a/openpype/settings/defaults/project_settings/nuke.json
+++ b/openpype/settings/defaults/project_settings/nuke.json
@@ -106,6 +106,9 @@
                 ]
             }
         },
+        "ExtractReviewData": {
+            "enabled": false
+        },
         "ExtractReviewDataLut": {
             "enabled": false
         },
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_publish.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_publish.json
index 1636a8d700..6776f316d9 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_publish.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_publish.json
@@ -138,6 +138,21 @@
                 }
             ]
         },
+        {
+            "type": "dict",
+            "collapsible": true,
+            "checkbox_key": "enabled",
+            "key": "ExtractReviewData",
+            "label": "ExtractReviewData",
+            "is_group": true,
+            "children": [
+                {
+                    "type": "boolean",
+                    "key": "enabled",
+                    "label": "Enabled"
+                }
+            ]
+        },
         {
             "type": "dict",
             "collapsible": true,

From dc2da01f52be73061de77e868f19e6252f8c2510 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jakub=20Je=C5=BEek?= <jakub@orbi.tools>
Date: Thu, 31 Mar 2022 16:03:22 +0200
Subject: [PATCH 084/108] Update
 openpype/hosts/nuke/plugins/publish/extract_review_data.py

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 openpype/hosts/nuke/plugins/publish/extract_review_data.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/nuke/plugins/publish/extract_review_data.py b/openpype/hosts/nuke/plugins/publish/extract_review_data.py
index 19c894448d..d973e6accd 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(openpype.api.Extractor):
             instance.data["families"].remove("review")
 
         for repre in representations:
-            if ext not in repre["ext"]:
+            if ext != repre["ext"]:
                 continue
 
             if not repre.get("tags"):

From 3ee7c213c38f08a15dd7ca4e3d9edd8a0ec1072f Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 31 Mar 2022 19:16:16 +0200
Subject: [PATCH 085/108] added some ui examples

---
 website/docs/assets/publisher_card_view.png   | Bin 0 -> 103961 bytes
 .../docs/assets/publisher_create_dialog.png   | Bin 0 -> 59900 bytes
 website/docs/assets/publisher_list_view.png   | Bin 0 -> 29456 bytes
 website/docs/dev_publishing.md                |  25 ++++++++++++++++++
 4 files changed, 25 insertions(+)
 create mode 100644 website/docs/assets/publisher_card_view.png
 create mode 100644 website/docs/assets/publisher_create_dialog.png
 create mode 100644 website/docs/assets/publisher_list_view.png

diff --git a/website/docs/assets/publisher_card_view.png b/website/docs/assets/publisher_card_view.png
new file mode 100644
index 0000000000000000000000000000000000000000..57b012cb6ddd1399bf89fe766a536a9fa13ae5d0
GIT binary patch
literal 103961
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

literal 0
HcmV?d00001

diff --git a/website/docs/assets/publisher_create_dialog.png b/website/docs/assets/publisher_create_dialog.png
new file mode 100644
index 0000000000000000000000000000000000000000..6e9275062d5bcf688a0466e7893ad157a2e8a581
GIT binary patch
literal 59900
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
Cxfq`S

literal 0
HcmV?d00001

diff --git a/website/docs/assets/publisher_list_view.png b/website/docs/assets/publisher_list_view.png
new file mode 100644
index 0000000000000000000000000000000000000000..e9dc8a607af520f37ae403b775c5800af071894f
GIT binary patch
literal 29456
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

literal 0
HcmV?d00001

diff --git a/website/docs/dev_publishing.md b/website/docs/dev_publishing.md
index 49e720a7e0..ec01a941b6 100644
--- a/website/docs/dev_publishing.md
+++ b/website/docs/dev_publishing.md
@@ -522,4 +522,29 @@ Possible attribute definitions can be found in `openpype/pipeline/lib/attribute_
     ```
 </details>
 
+## **UI examples**
+### Main publish window
+Main window of publisher shows instances and their values, collected by creators.
 
+**Card view**
+![Publisher UI - Card view](assets/publisher_card_view.png)
+**List view**
+![Publisher UI - List view](assets/publisher_list_view.png)
+
+#### *Instances views*
+List of instances always contains `Options` item which is used to show attributes of context plugins. Values from the item are saved and loaded using [host implementation](#required-functions-in-host-implementation) **get_context_data** and **update_context_data**. Instances are grouped by family and can be shown in card view (single selection) or list view (multi selection).
+
+Instance view has at the bottom 3 buttons. Plus sign opens [create dialog](#create-dialog), bin removes selected instances and stripes swap card and list view.
+
+#### *Context options*
+It is possible to change variant or asset and task context of instances at the top part but all changes there must be confirmed. Confirmation will trigger recalculation of subset names and all new data are stored to instances.
+
+#### *Create attributes*
+Instance attributes display all create attributes of all selected instances. All attributes that have same definition are grouped into one input and is visually indicated if values are not same for selected instances. In most of cases have **< Multiselection >** placeholder.
+
+#### *Publish attributes*
+Publish attributes work the same way as create attributes but the source of attribute definitions are pyblish plugins. Attributes are filtered based on families of selected instances and families defined in pyblish plugin.
+
+### Create dialog
+![Publisher UI - Create dialog](assets/publisher_create_dialog.png)
+Create dialog is used by artist to create new instances in a context. The context selection can be enabled/disabled by changing `create_allow_context_change` on [creator plugin](#creator). In middle part artist select what will be created and what variant it is. On right side is information about selected creator and it's pre-create attributes. There is also question mark button which extends window and display more detailed information about the creator.

From 2e890b5500b82d5ec480ca22a2ae97bd7f7162a9 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Thu, 31 Mar 2022 19:16:22 +0200
Subject: [PATCH 086/108] fix example plugin

---
 website/docs/dev_publishing.md | 36 ++++++++++++++++------------------
 1 file changed, 17 insertions(+), 19 deletions(-)

diff --git a/website/docs/dev_publishing.md b/website/docs/dev_publishing.md
index ec01a941b6..710090af40 100644
--- a/website/docs/dev_publishing.md
+++ b/website/docs/dev_publishing.md
@@ -465,21 +465,21 @@ Values of publish attributes from created instance are never removed automatical
 Possible attribute definitions can be found in `openpype/pipeline/lib/attribute_definitions.py`.
 
 <details>
-  <summary>Toggle me!</summary>
+<summary>Example plugin</summary>
+<p>
 
-    ``` python
-
-    import pyblish.api
-    from openpype.pipeline import (
+```python
+import pyblish.api
+from openpype.pipeline import (
     OpenPypePyblishPluginMixin,
     attribute_definitions,
-    )
+)
 
 
-    # Example context plugin
-    class MyExtendedPlugin(
+# Example context plugin
+class MyExtendedPlugin(
     pyblish.api.ContextPlugin, OpenPypePyblishPluginMixin
-    ):
+):
     optional = True
     active = True
 
@@ -501,16 +501,13 @@ Possible attribute definitions can be found in `openpype/pipeline/lib/attribute_
         if not self.optional:
             return True
 
+        # Attribute values are stored by class names
+        # - for those purposes was implemented 'get_attr_values_from_data'
+        #   to help with accessing it
+        attribute_values = self.get_attr_values_from_data(context.data)
         # Get 'process' key
-        process_value = (
-            context.data
-            .get("publish_attributes", {})
-            # Attribute values are stored by class names
-            .get(self.__class__.__name__, {})
-            # Access the key
-            .get("process")
-        )
-        if process_value or process_value is None:
+        process_value = attribute_values.get("process")
+        if process_value is None or process_value:
             return True
         return False
 
@@ -519,7 +516,8 @@ Possible attribute definitions can be found in `openpype/pipeline/lib/attribute_
             return
         # Do plugin logic
         ...
-    ```
+```
+</p>
 </details>
 
 ## **UI examples**

From 1994a11fe1a259707d58e369d82cdf77bb865e7e Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 1 Apr 2022 11:48:36 +0200
Subject: [PATCH 087/108] modified collect instance

---
 .../plugins/publish/collect_instances.py      | 35 ++++++++++++-------
 1 file changed, 23 insertions(+), 12 deletions(-)

diff --git a/openpype/hosts/tvpaint/plugins/publish/collect_instances.py b/openpype/hosts/tvpaint/plugins/publish/collect_instances.py
index 9cbfb61550..0008248405 100644
--- a/openpype/hosts/tvpaint/plugins/publish/collect_instances.py
+++ b/openpype/hosts/tvpaint/plugins/publish/collect_instances.py
@@ -20,21 +20,35 @@ class CollectInstances(pyblish.api.ContextPlugin):
             json.dumps(workfile_instances, indent=4)
         ))
 
+        filtered_instance_data = []
+        # Check if there is any created instance
+        any_created_instance = False
         # Backwards compatibility for workfiles that already have review
         #   instance in metadata.
         review_instance_exist = False
         for instance_data in workfile_instances:
-            if instance_data["family"] == "review":
+            family = instance_data["family"]
+            if family == "review":
                 review_instance_exist = True
-                break
+
+            elif family in ("renderPass", "renderLayer"):
+                any_created_instance = True
+
+            else:
+                self.log.info("Unknown family \"{}\". Skipping {}".format(
+                    family, json.dumps(instance_data, indent=4)
+                ))
+                continue
+
+            filtered_instance_data.append(instance_data)
 
         # Fake review instance if review was not found in metadata families
         if not review_instance_exist:
-            workfile_instances.append(
+            filtered_instance_data.append(
                 self._create_review_instance_data(context)
             )
 
-        for instance_data in workfile_instances:
+        for instance_data in filtered_instance_data:
             instance_data["fps"] = context.data["sceneFps"]
 
             # Store workfile instance data to instance data
@@ -42,8 +56,11 @@ class CollectInstances(pyblish.api.ContextPlugin):
             # Global instance data modifications
             # Fill families
             family = instance_data["family"]
+            families = [family]
+            if family != "review":
+                families.append("review")
             # Add `review` family for thumbnail integration
-            instance_data["families"] = [family, "review"]
+            instance_data["families"] = families
 
             # Instance name
             subset_name = instance_data["subset"]
@@ -78,7 +95,7 @@ class CollectInstances(pyblish.api.ContextPlugin):
                 # Project name from workfile context
                 project_name = context.data["workfile_context"]["project"]
                 # Host name from environment variable
-                host_name = os.environ["AVALON_APP"]
+                host_name = context.data["hostName"]
                 # Use empty variant value
                 variant = ""
                 task_name = io.Session["AVALON_TASK"]
@@ -106,12 +123,6 @@ class CollectInstances(pyblish.api.ContextPlugin):
                 instance = self.create_render_pass_instance(
                     context, instance_data
                 )
-            else:
-                raise AssertionError(
-                    "Instance with unknown family \"{}\": {}".format(
-                        family, instance_data
-                    )
-                )
 
             if instance is None:
                 continue

From a29a7a67f23b7a132b099b7c1487084403ad7b1c Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 1 Apr 2022 11:59:27 +0200
Subject: [PATCH 088/108] added collector which collects renderScene family

---
 .../plugins/publish/collect_scene_render.py   | 104 ++++++++++++++++++
 1 file changed, 104 insertions(+)
 create mode 100644 openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py

diff --git a/openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py b/openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py
new file mode 100644
index 0000000000..2dcdab5c69
--- /dev/null
+++ b/openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py
@@ -0,0 +1,104 @@
+import json
+import copy
+import pyblish.api
+from avalon import io
+
+from openpype.lib import get_subset_name_with_asset_doc
+
+
+class CollectRenderScene(pyblish.api.ContextPlugin):
+    """Collect instance which renders whole scene in PNG.
+
+    Creates instance with family 'renderScene' which will have all layers
+    to render which will be composite into one result. The instance is not
+    collected from scene.
+
+    Scene will be rendered with all visible layers similar way like review is.
+
+    Instance is disabled if there are any created instances of 'renderLayer'
+    or 'renderPass'. That is because it is expected that this instance is
+    used as lazy publish of TVPaint file.
+
+    Subset name is created similar way like 'renderLayer' family. It can use
+    `renderPass` and `renderLayer` keys which can be set using settings and
+    `variant` is filled using `renderPass` value.
+    """
+    label = "Collect Render Scene"
+    order = pyblish.api.CollectorOrder - 0.4
+    hosts = ["tvpaint"]
+
+    # Settings attributes
+    enabled = False
+    # Value of 'renderLayer' for subset name template
+    render_layer_name = "Scene"
+    # Value of 'renderPass' for subset name template
+    render_pass_name = "Beauty"
+
+    def process(self, context):
+        # Check if there are created instances of renderPass and renderLayer
+        # - that will define if renderScene instance is enabled after
+        #   collection
+        any_created_instance = False
+        for instance in context:
+            family = instance.data["family"]
+            if family in ("renderPass", "renderLayer"):
+                any_created_instance = True
+                break
+
+        # Global instance data modifications
+        # Fill families
+        family = "renderScene"
+        # Add `review` family for thumbnail integration
+        families = [family, "review"]
+
+        # Collect asset doc to get asset id
+        # - not sure if it's good idea to require asset id in
+        #   get_subset_name?
+        asset_name = context.data["workfile_context"]["asset"]
+        asset_doc = io.find_one({
+            "type": "asset",
+            "name": asset_name
+        })
+
+        # Project name from workfile context
+        project_name = context.data["workfile_context"]["project"]
+        # Host name from environment variable
+        host_name = context.data["hostName"]
+        # Variant is using render pass name
+        variant = self.render_pass_name
+        dynamic_data = {
+            "renderLayer": self.render_layer_name,
+            "renderPass": self.render_pass_name,
+        }
+        task_name = io.Session["AVALON_TASK"]
+        subset_name = get_subset_name_with_asset_doc(
+            family,
+            variant,
+            task_name,
+            asset_doc,
+            project_name,
+            host_name,
+            dynamic_data=dynamic_data
+        )
+
+        instance_data = {
+            "family": family,
+            "families": families,
+            "fps": context.data["sceneFps"],
+            "name": subset_name,
+            "label": "{} [{}-{}]".format(
+                subset_name,
+                context.data["sceneMarkIn"] + 1,
+                context.data["sceneMarkOut"] + 1
+            ),
+            "active": not any_created_instance,
+            "publish": not any_created_instance,
+            "representations": [],
+            "layers": copy.deepcopy(context.data["layersData"])
+        }
+
+        instance = context.create_instance(**instance_data)
+
+        self.log.debug("Created instance: {}\n{}".format(
+            instance, json.dumps(instance.data, indent=4)
+        ))

From 288fa288c1dcca485febdf588becac109e76daa5 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 1 Apr 2022 12:01:53 +0200
Subject: [PATCH 089/108] added renderScene into other tvpaint plugins related
 to the renderScene logic

---
 openpype/hosts/tvpaint/plugins/publish/extract_sequence.py  | 6 +++---
 .../tvpaint/plugins/publish/validate_layers_visibility.py   | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/tvpaint/plugins/publish/extract_sequence.py b/openpype/hosts/tvpaint/plugins/publish/extract_sequence.py
index 139dabadee..73daf60567 100644
--- a/openpype/hosts/tvpaint/plugins/publish/extract_sequence.py
+++ b/openpype/hosts/tvpaint/plugins/publish/extract_sequence.py
@@ -18,7 +18,7 @@ from openpype.hosts.tvpaint.lib import (
 class ExtractSequence(pyblish.api.Extractor):
     label = "Extract Sequence"
     hosts = ["tvpaint"]
-    families = ["review", "renderPass", "renderLayer"]
+    families = ["review", "renderPass", "renderLayer", "renderScene"]
 
     # Modifiable with settings
     review_bg = [255, 255, 255, 255]
@@ -159,7 +159,7 @@ class ExtractSequence(pyblish.api.Extractor):
 
         # Fill tags and new families
         tags = []
-        if family_lowered in ("review", "renderlayer"):
+        if family_lowered in ("review", "renderlayer", "renderScene"):
             tags.append("review")
 
         # Sequence of one frame
@@ -185,7 +185,7 @@ class ExtractSequence(pyblish.api.Extractor):
 
         instance.data["representations"].append(new_repre)
 
-        if family_lowered in ("renderpass", "renderlayer"):
+        if family_lowered in ("renderpass", "renderlayer", "renderscene"):
             # Change family to render
             instance.data["family"] = "render"
 
diff --git a/openpype/hosts/tvpaint/plugins/publish/validate_layers_visibility.py b/openpype/hosts/tvpaint/plugins/publish/validate_layers_visibility.py
index 7ea0587b8f..d3a04cc69f 100644
--- a/openpype/hosts/tvpaint/plugins/publish/validate_layers_visibility.py
+++ b/openpype/hosts/tvpaint/plugins/publish/validate_layers_visibility.py
@@ -8,7 +8,7 @@ class ValidateLayersVisiblity(pyblish.api.InstancePlugin):
 
     label = "Validate Layers Visibility"
     order = pyblish.api.ValidatorOrder
-    families = ["review", "renderPass", "renderLayer"]
+    families = ["review", "renderPass", "renderLayer", "renderScene"]
 
     def process(self, instance):
         layer_names = set()

From 2951fe77469716bf7e105ccf408f8bcba3f41db8 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 1 Apr 2022 12:26:39 +0200
Subject: [PATCH 090/108] styling tweaks, mostly adding of articles

---
 website/docs/dev_publishing.md | 104 ++++++++++++++++-----------------
 1 file changed, 52 insertions(+), 52 deletions(-)

diff --git a/website/docs/dev_publishing.md b/website/docs/dev_publishing.md
index 710090af40..8ee3b7e85f 100644
--- a/website/docs/dev_publishing.md
+++ b/website/docs/dev_publishing.md
@@ -5,19 +5,19 @@ sidebar_label: Publishing
 toc_max_heading_level: 4
 ---
 
-Publishing workflow consist of 2 parts:
+Publishing workflow consists of 2 parts:
 - Creating - Mark what will be published and how.
-- Publishing - Use data from Creating to go through pyblish process.
+- Publishing - Use data from Creating to go through the pyblish process.
 
-OpenPype is using [pyblish](https://pyblish.com/) for publishing process. OpenPype a little bit extend and modify few functions mainly for reports and UI purposes. The main differences are that OpenPype's publish UI allows to enable/disable instances or plugins during Creating part instead of in publishing part and has limited plugin actions only for failed validation plugins.
+OpenPype is using [pyblish](https://pyblish.com/) for the publishing process. OpenPype extends and modifies its few functions a bit, mainly for reports and UI purposes. The main differences are that OpenPype's publish UI allows to enable/disable instances or plugins during Creating part instead of in the publishing part and has limited plugin actions only for failed validation plugins.
 
 ## **Creating**
 
-Concept of Creating does not have to "create" anything but prepare and store metadata about an "instance" (becomes a subset after publish process). Created instance always has `family` which defines what kind of data will be published, best example is `workfile` family. Storing of metadata is host specific and may be even a Creator plugin specific. In most of hosts are metadata stored to workfile (Maya scene, Nuke script, etc.) to an item or a node the same way so consistency of host implementation is kept, but some features may require different approach that is the reason why it is creator plugin responsibility. Storing the metadata to workfile gives ability to keep values so artist does not have to do create and set what should be published and how over and over.
+Concept of Creating does not have to "create" anything yet, but prepare and store metadata about an "instance" (becomes a subset after the publish process). Created instance always has `family` which defines what kind of data will be published, the best example is `workfile` family. Storing of metadata is host specific and may be even a Creator plugin specific. Most hosts are storing metadata into a workfile (Maya scene, Nuke script, etc.) to an item or a node the same way as regular Pyblish instances, so consistency of host implementation is kept, but some features may require a different approach that is the reason why it is creator plugin responsibility. Storing the metadata to the workfile persists values, so the artist does not have to create and set what should be published and how over and over.
 
 ### Created instance
 
-Objected representation of created instance metadata defined by class **CreatedInstance**. Has access to **CreateContext** and **BaseCreator** that initialized the object. Is dictionary like object with few immutable keys (marked with start `*` in table). The immutable keys are set by creator plugin or create context on initialization and thei values can't change. Instance can have more arbitrary data, for example ids of nodes in scene but keep in mind that some keys are reserved.
+Objected representation of created instance metadata defined by class **CreatedInstance**. Has access to **CreateContext** and **BaseCreator** that initialized the object. Is a dictionary-like object with few immutable keys (marked with start `*` in table). The immutable keys are set by the creator plugin or create context on initialization and their values can't change. Instance can have more arbitrary data, for example ids of nodes in scene but keep in mind that some keys are reserved.
 
 | Key | Type | Description |
 |---|---|---|
@@ -25,34 +25,34 @@ Objected representation of created instance metadata defined by class **CreatedI
 | *instance_id | str | Unique ID of instance. Set automatically on instance creation using `str(uuid.uuid4())` |
 | *family | str | Instance's family representing type defined by creator plugin. |
 | *creator_identifier | str | Identifier of creator that collected/created the instance. |
-| *creator_attributes | dict | Dictionary of attributes that are defined by creator plugin (`get_instance_attr_defs`). |
+| *creator_attributes | dict | Dictionary of attributes that are defined by the creator plugin (`get_instance_attr_defs`). |
 | *publish_attributes | dict | Dictionary of attributes that are defined by publish plugins. |
-| variant | str | Variant is entered by artist on creation and may affect **subset**. |
-| subset | str | Name of instance. This name will be used as subset name during publishing. Can be changed on context change or variant change. |
-| active | bool | Is instance active and will be published or not. |
+| variant | str | Variant is entered by the artist on creation and may affect **subset**. |
+| subset | str | Name of instance. This name will be used as a subset name during publishing. Can be changed on context change or variant change. |
+| active | bool | Is the instance active and will be published or not. |
 | asset | str | Name of asset in which context was created. |
 | task | str | Name of task in which context was created. Can be set to `None`. |
 
 :::note
-Task should not be required until subset name template expect it.
+Task should not be required until the subset name template expects it.
 :::
 
-object of **CreatedInstance** has method **data_to_store** which returns dictionary that can be parsed to json string. This method will return all data related to instance so can be re-created using `CreatedInstance.from_existing(data)`.
+object of **CreatedInstance** has method **data_to_store** which returns a dictionary that can be parsed to a json string. This method will return all data related to the instance so it can be re-created using `CreatedInstance.from_existing(data)`.
 
 #### *Create context* {#category-doc-link}
 
 Controller and wrapper around Creating is `CreateContext` which cares about loading of plugins needed for Creating. And validates required functions in host implementation.
 
-Context discovers creator and publish plugins. Trigger collections of existing instances on creators and trigger Creating itself. Also keeps in mind instance objects by their ids.
+Context discovers creator and publish plugins. Trigger collections of existing instances on creators and trigger Creating itself. Also it keeps in mind instance objects by their ids.
 
-Creator plugins can call **creator_adds_instance** or **creator_removed_instance** to add/remove instance but these methods are not meant to be called directly out of creator. The reason is that is creator's responsibility to remove metadata or decide if should remove the instance.
+Creator plugins can call **creator_adds_instance** or **creator_removed_instance** to add/remove instances but these methods are not meant to be called directly out of the creator. The reason is that it is the creator's responsibility to remove metadata or decide if it should remove the instance.
 
 #### Required functions in host implementation
-Host implementation **must** have implemented **get_context_data** and **update_context_data**. These two functions are needed to store metadata that are not related to any instance but are needed for Creating and publishing process. Right now are there stored data about enabled/disabled optional publish plugins. When data are not stored and loaded properly reset of publishing will cause that they will be set to default value. Similar to instance data can be context data also parsed to json string.
+Host implementation **must** implement **get_context_data** and **update_context_data**. These two functions are needed to store metadata that are not related to any instance but are needed for Creating and publishing process. Right now only data about enabled/disabled optional publish plugins is stored there. When data is not stored and loaded properly, reset of publishing will cause that they will be set to default value. Context data also parsed to json string similarly as instance data.
 
-There are also few optional functions. For UI purposes it is possible to implement **get_context_title** which can return string showed in UI as a title. Output string may contain html tags. It is recommended to return context path (it will be created function this purposes) in this order `"{project name}/{asset hierarchy}/<b>{asset name}</b>/{task name}"`.
+There are also few optional functions. For UI purposes it is possible to implement **get_context_title** which can return a string shown in UI as a title. Output string may contain html tags. It is recommended to return context path (it will be created function this purposes) in this order `"{project name}/{asset hierarchy}/<b>{asset name}</b>/{task name}"`.
 
-Another optional function is **get_current_context**. This function is handy in hosts where is possible to open multiple workfiles in one process so using global context variables is not relevant because artist can switch between opened workfiles without being acknowledged. When function is not implemented or won't return right keys the global context is used.
+Another optional function is **get_current_context**. This function is handy in hosts where it is possible to open multiple workfiles in one process so using global context variables is not relevant because artists can switch between opened workfiles without being acknowledged. When a function is not implemented or won't return the right keys the global context is used.
 ```json
 # Expected keys in output
 {
@@ -75,7 +75,7 @@ class WorkfileCreator(Creator):
     family = "workfile"
 ```
 
-- **`collect_instances`** (method) - Collect already existing instances from workfile and add them to create context. This method is called on initialization or reset of **CreateContext**. Each creator is responsible to find it's instances metadata, convert them to **CreatedInstance** object and add the to create context (`self._add_instance_to_context(instnace_obj)`).
+- **`collect_instances`** (method) - Collect already existing instances from the workfile and add them to create context. This method is called on initialization or reset of **CreateContext**. Each creator is responsible to find its instance metadata, convert them to **CreatedInstance** object and add them to create context (`self._add_instance_to_context(instnace_obj)`).
 ```python
 def collect_instances(self):
     # Using 'pipeline.list_instances' is just example how to get existing instances from scene
@@ -92,7 +92,7 @@ def collect_instances(self):
             self._add_instance_to_context(instance)
 ```
 
-- **`create`** (method) - Create new object of **CreatedInstance** store it's metadata to workfile and add the instance into create context. Failed Creating should raise **CreatorError** if happens error that can artist fix or give him some useful information. Trigger and implementation differs for **Creator** and **AutoCreator**.
+- **`create`** (method) - Create a new object of **CreatedInstance** store its metadata to the workfile and add the instance into the created context. Failed Creating should raise **CreatorError** if an error happens that artists can fix or give them some useful information. Triggers and implementation differs for **Creator** and **AutoCreator**.
 
 - **`update_instances`** (method) - Update data of instances. Receives tuple with **instance** and **changes**.
 ```python
@@ -145,8 +145,8 @@ When host implementation use universal way how to store and load instances you s
 
 **Optional implementations**
 
-- **`enabled`** (attr) - Boolean if creator plugin is enabled and used.
-- **`identifier`** (class attr) - Consistent unique string identifier of the creator plugin. Is used to identify source plugin of existing instances. There can't be 2 creator plugins with same identifier. Default implementation returns `family` attribute.
+- **`enabled`** (attr) - Boolean if the creator plugin is enabled and used.
+- **`identifier`** (class attr) - Consistent unique string identifier of the creator plugin. Is used to identify source plugin of existing instances. There can't be 2 creator plugins with the same identifier. Default implementation returns `family` attribute.
 ```python
 class RenderLayerCreator(Creator):
     family = "render"
@@ -158,13 +158,13 @@ class RenderPassCreator(Creator):
     identifier = "render_pass"
 ```
 
-- **`label`** (attr) - String label of creator plugin which will showed in UI, `identifier` is used when not set. It should be possible to use html tags.
+- **`label`** (attr) - String label of creator plugin which will show up in UI, `identifier` is used when not set. It should be possible to use html tags.
 ```python
 class RenderLayerCreator(Creator):
     label = "Render Layer"
 ```
 
-- **`get_icon`** (attr) - Icon of creator and it's instances. Value can be a path to image file, full name of qtawesome icon, `QPixmap` or `QIcon`. For complex cases or cases when `Qt` objects are returned it is recommended to override `get_icon` method and handle the logic or import `Qt` inside the method to not break headless usage of creator plugin. For list of qtawesome icons check qtawesome github repository (look for used version in pyproject.toml). Default implementation return **icon** attribute.
+- **`get_icon`** (attr) - Icon of creator and its instances. Value can be a path to an image file, full name of qtawesome icon, `QPixmap` or `QIcon`. For complex cases or cases when `Qt` objects are returned it is recommended to override `get_icon` method and handle the logic or import `Qt` inside the method to not break headless usage of creator plugin. For list of qtawesome icons check qtawesome github repository (look for the used version in pyproject.toml). Default implementation return **icon** attribute.
 - **`icon`** (method) - Attribute for default implementation of **get_icon**.
 ```python
 class RenderLayerCreator(Creator):
@@ -172,7 +172,7 @@ class RenderLayerCreator(Creator):
     icon = "fa5.building"
 ```
 
-- **`get_instance_attr_defs`** (method) - Attribute definitions of instance. Creator can define attribute values with default values for each instance. These attributes may affect how will be instance processed during publishing. Attribute defiitions can be used from `openpype.pipeline.lib.attribute_definitions` (NOTE: Will be moved to `openpype.lib.attribute_definitions` soon). Attribute definitions define basic type of values for different cases e.g. boolean, number, string, enumerator, etc. Default implementations returns **instance_attr_defs**.
+- **`get_instance_attr_defs`** (method) - Attribute definitions of instance. Creator can define attribute values with default values for each instance. These attributes may affect how instances will be instance processed during publishing. Attribute defiitions can be used from `openpype.pipeline.lib.attribute_definitions` (NOTE: Will be moved to `openpype.lib.attribute_definitions` soon). Attribute definitions define basic types of values for different cases e.g. boolean, number, string, enumerator, etc. Default implementation returns **instance_attr_defs**.
 - **`instance_attr_defs`** (attr) - Attribute for default implementation of **get_instance_attr_defs**.
 
 ```python
@@ -194,16 +194,16 @@ class RenderLayerCreator(Creator):
         ]
 ```
 
-- **`get_subset_name`** (method) - Calculate subset name based on passed data. Data can be extended using `get_dynamic_data` method.  Default implementation is using `get_subset_name` from `openpype.lib` which is recommended.
+- **`get_subset_name`** (method) - Calculate subset name based on passed data. Data can be extended using the `get_dynamic_data` method. Default implementation is using `get_subset_name` from `openpype.lib` which is recommended.
 
-- **`get_dynamic_data`** (method) - Can be used to extend data for subset template which may be required in some cases.
+- **`get_dynamic_data`** (method) - Can be used to extend data for subset templates which may be required in some cases.
 
 
 #### *AutoCreator*
-Creator that is triggered on reset of create context. Can be used for families that are expected to be created automatically without artist interaction (e.g. **workfile**). Method `create` is triggered after collecting of all creators.
+Creator that is triggered on reset of create context. Can be used for families that are expected to be created automatically without artist interaction (e.g. **workfile**). Method `create` is triggered after collecting all creators.
 
 :::important
-**AutoCreator** has implemented **remove_instances** to do nothing as removing of auto created instances would lead to create new instance immediately or on refresh.
+**AutoCreator** has implemented **remove_instances** to do nothing as removing of auto created instances would lead to creating new instance immediately or on refresh.
 :::
 
 ```python
@@ -273,10 +273,10 @@ def create(self):
 ```
 
 #### *Creator*
-Implementation of creator plugin that is triggered manually by artist in UI (or by code). Has extended options for UI purposes than **AutoCreator** and **create** method expect more arguments.
+Implementation of creator plugin that is triggered manually by the artist in UI (or by code). Has extended options for UI purposes than **AutoCreator** and **create** method expect more arguments.
 
 **Optional implementations**
-- **`create_allow_context_change`** (class attr) - Allow to set context in UI before Creating. Some creator may not allow it or their logic would not use the context selection (e.g. bulk creators). Is set to `True` but default.
+- **`create_allow_context_change`** (class attr) - Allow to set context in UI before Creating. Some creators may not allow it or their logic would not use the context selection (e.g. bulk creators). Is set to `True` but default.
 ```python
 class BulkRenderCreator(Creator):
     create_allow_context_change = False
@@ -287,7 +287,7 @@ class BulkRenderCreator(Creator):
 - **`get_default_variant`** (method) - Returns default variant that is prefilled in UI (value does not have to be in default variants). By default returns **default_variant** attribute. If returns `None` then UI logic will take first item from **get_default_variants** if there is any otherwise **"Main"** is used.
 - **`default_variant`** (attr) - Attribute for default implementation of **get_default_variant**.
 
-- **`get_description`** (method) - Returns short string description of creator. Returns **description** attribute by default.
+- **`get_description`** (method) - Returns a short string description of the creator. Returns **description** attribute by default.
 - **`description`** (attr) - Attribute for default implementation of **get_description**.
 
 - **`get_detailed_description`** (method) - Returns detailed string description of creator. Can contain markdown. Returns **detailed_description** attribute by default.
@@ -397,34 +397,34 @@ class CreateRender(Creator):
 OpenPype define few specific exceptions that should be used in publish plugins.
 
 #### *Validation exception*
-Validation plugins should raise `PublishValidationError` to show to an artist what's wrong and give him actions to fix it. The exception says that error happened in plugin can be fixed by artist himself (with or without action on plugin). Any other errors will stop publishing immediately. Exception `PublishValidationError` raised after validation order has same effect as any other exception.
+Validation plugins should raise `PublishValidationError` to show to an artist what's wrong and give him actions to fix it. The exception says that errors in the plugin can be fixed by the artist himself (with or without action on plugin). Any other errors will stop publishing immediately. The exception `PublishValidationError` raised after validation order has the same effect as any other exception.
 
 Exception `PublishValidationError` expects 4 arguments:
 - **message** Which is not used in UI but for headless publishing.
 - **title** Short description of error (2-5 words). Title is used for grouping of exceptions per plugin.
-- **description** Detailed description of happened issue where markdown and html can be used.
-- **detail** Is optional to give even more detailed information for advanced users. At this moment is detail showed under description but it is in plan to have detail in collapsible widget.
+- **description** Detailed description of the issue where markdown and html can be used.
+- **detail** Is optional to give even more detailed information for advanced users. At this moment the detail is shown directly under description but it is in plan to have detail in a collapsible widget.
 
 Extended version is `PublishXmlValidationError` which uses xml files with stored descriptions. This helps to avoid having huge markdown texts inside code. The exception has 4 arguments:
-- **plugin** The plugin object which raises the exception to find it's related xml file.
+- **plugin** The plugin object which raises the exception to find its related xml file.
 - **message** Exception message for publishing without UI or different pyblish UI.
-- **key** Optional argument says which error from xml is used as validation plugin may raise error with different messages based on the current errors. Default is **"main"**.
+- **key** Optional argument says which error from xml is used as a validation plugin may raise error with different messages based on the current errors. Default is **"main"**.
 - **formatting_data** Optional dictionary to format data in the error. This is used to fill detailed description with data from the publishing so artist can get more precise information.
 
 **Where and how to create xml file**
 
-Xml files for `PublishXmlValidationError` must be located in **./help** subfolder next to plugin and the filename must match the filename of plugin.
+Xml files for `PublishXmlValidationError` must be located in **./help** subfolder next to the plugin and the filename must match the filename of the plugin.
 ```
 # File location related to plugin file
 └ publish
-  ├ help
-  │ ├ validate_scene.xml
-  │ └ ...
-  ├ validate_scene.py
-  └ ...
+ ├ help
+ │ ├ validate_scene.xml
+ │ └ ...
+ ├ validate_scene.py
+ └ ...
 ```
 
-Xml file content has **&ltroot&gt** node which may contain any amount of **&lterror&gt** nodes, but each of them must have **id** attribute with unique value. That is then used for **key**. Each error must have **&lttitle&gt** and **&ltdescription&gt** and **&ltdetail&gt**. Text content may contain python formatting keys that can be filled when exception is raised.
+Xml file content has **&ltroot&gt** node which may contain any amount of **&lterror&gt** nodes, but each of them must have **id** attribute with unique value. That is then used for **key**. Each error must have **&lttitle&gt** and **&ltdescription&gt** and **&ltdetail&gt**. Text content may contain python formatting keys that can be filled when an exception is raised.
 ```xml
 <?xml version="1.0" encoding="UTF-8"?>
 <root>
@@ -436,7 +436,7 @@ Context of the given subset doesn't match your current scene.
 
 ### How to repair?
 
-Yout can fix this with "Repair" button on the right. This will use '{expected_asset}' asset name and overwrite '{found_asset}' asset name in scene metadata.
+You can fix this with the "Repair" button on the right. This will use '{expected_asset}' asset name and overwrite '{found_asset}' asset name in scene metadata.
 
 After that restart publishing with Reload button.
         </description>
@@ -451,15 +451,15 @@ or the scene file was copy pasted from different context.
 ```
 
 #### *Known errors*
-When there is a known error that can't be fixed by user (e.g. can't connect to deadline service, etc.) `KnownPublishError` should be raise. The only difference is that it's message is shown in UI to artist otherwise a neutral message without context is shown.
+When there is a known error that can't be fixed by the user (e.g. can't connect to deadline service, etc.) `KnownPublishError` should be raised. The only difference is that its message is shown in UI to the artist otherwise a neutral message without context is shown.
 
 ### Plugin extension
-Publish plugins can be extended by additional logic when inherits from `OpenPypePyblishPluginMixin` which can be used as mixin (additional inheritance of class). Publish plugins that inherit from this mixin can define attributes that will be shown in **CreatedInstance**. One of most important usages is to be able turn on/off optional plugins.
+Publish plugins can be extended by additional logic when inheriting from `OpenPypePyblishPluginMixin` which can be used as mixin (additional inheritance of class). Publish plugins that inherit from this mixin can define attributes that will be shown in **CreatedInstance**. One of the most important usages is to be able turn on/off optional plugins.
 
-Attributes are defined by return value of `get_attribute_defs` method. Attribute definitions are for families defined in plugin's `families` attribute if it's instance plugin or for whole context if it's context plugin. To convert existing values (or to remove legacy values) can be re-implemented `convert_attribute_values`. Default implementation just converts the values to right types.
+Attributes are defined by the return value of `get_attribute_defs` method. Attribute definitions are for families defined in plugin's `families` attribute if it's instance plugin or for whole context if it's context plugin. To convert existing values (or to remove legacy values) can be re-implemented `convert_attribute_values`. Default implementation just converts the values to right types.
 
-:::important
-Values of publish attributes from created instance are never removed automatically so implementing of this method is best way to remove legacy data or convert them to new data structure.
+:::Important
+Values of publish attributes from created instance are never removed automatically so implementing this method is the best way to remove legacy data or convert them to new data structure.
 :::
 
 Possible attribute definitions can be found in `openpype/pipeline/lib/attribute_definitions.py`.
@@ -530,7 +530,7 @@ Main window of publisher shows instances and their values, collected by creators
 ![Publisher UI - List view](assets/publisher_list_view.png)
 
 #### *Instances views*
-List of instances always contains `Options` item which is used to show attributes of context plugins. Values from the item are saved and loaded using [host implementation](#required-functions-in-host-implementation) **get_context_data** and **update_context_data**. Instances are grouped by family and can be shown in card view (single selection) or list view (multi selection).
+List of instances always contains an `Options` item which is used to show attributes of context plugins. Values from the item are saved and loaded using [host implementation](#required-functions-in-host-implementation) **get_context_data** and **update_context_data**. Instances are grouped by family and can be shown in card view (single selection) or list view (multi selection).
 
 Instance view has at the bottom 3 buttons. Plus sign opens [create dialog](#create-dialog), bin removes selected instances and stripes swap card and list view.
 
@@ -538,11 +538,11 @@ Instance view has at the bottom 3 buttons. Plus sign opens [create dialog](#crea
 It is possible to change variant or asset and task context of instances at the top part but all changes there must be confirmed. Confirmation will trigger recalculation of subset names and all new data are stored to instances.
 
 #### *Create attributes*
-Instance attributes display all create attributes of all selected instances. All attributes that have same definition are grouped into one input and is visually indicated if values are not same for selected instances. In most of cases have **< Multiselection >** placeholder.
+Instance attributes display all created attributes of all selected instances. All attributes that have the same definition are grouped into one input and are visually indicated if values are not the same for selected instances. In most cases have **< Multiselection >** placeholder.
 
 #### *Publish attributes*
-Publish attributes work the same way as create attributes but the source of attribute definitions are pyblish plugins. Attributes are filtered based on families of selected instances and families defined in pyblish plugin.
+Publish attributes work the same way as create attributes but the source of attribute definitions are pyblish plugins. Attributes are filtered based on families of selected instances and families defined in the pyblish plugin.
 
 ### Create dialog
 ![Publisher UI - Create dialog](assets/publisher_create_dialog.png)
-Create dialog is used by artist to create new instances in a context. The context selection can be enabled/disabled by changing `create_allow_context_change` on [creator plugin](#creator). In middle part artist select what will be created and what variant it is. On right side is information about selected creator and it's pre-create attributes. There is also question mark button which extends window and display more detailed information about the creator.
+Create dialog is used by artist to create new instances in a context. The context selection can be enabled/disabled by changing `create_allow_context_change` on [creator plugin](#creator). In the middle part the artist selects what will be created and what variant it is. On the right side is information about the selected creator and its pre-create attributes. There is also a question mark button which extends the window and displays more detailed information about the creator.
\ No newline at end of file

From 77b7b4b1bc3e6ea467d5a0c38eb3fd96523d69ce Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 1 Apr 2022 13:16:02 +0200
Subject: [PATCH 091/108] Fix - remove doubled dot in workfile created from
 template

---
 openpype/lib/avalon_context.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openpype/lib/avalon_context.py b/openpype/lib/avalon_context.py
index cc6bcba58e..0348d88be2 100644
--- a/openpype/lib/avalon_context.py
+++ b/openpype/lib/avalon_context.py
@@ -1965,6 +1965,7 @@ def get_last_workfile(
         data.pop("comment", None)
         if not data.get("ext"):
             data["ext"] = extensions[0]
+        data["ext"] = data["ext"].replace('.', '')
         filename = StringTemplate.format_strict_template(file_template, data)
 
     if full_path:

From 7bfc66efed073f47fb1c4e13692020074b155ced Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 1 Apr 2022 13:42:12 +0200
Subject: [PATCH 092/108] Added mention of adding My Drive as a root

---
 website/docs/module_site_sync.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/website/docs/module_site_sync.md b/website/docs/module_site_sync.md
index 78f482352e..2e9cf01102 100644
--- a/website/docs/module_site_sync.md
+++ b/website/docs/module_site_sync.md
@@ -123,6 +123,10 @@ To get working connection to Google Drive there are some necessary steps:
 - add new site back in OpenPype Settings, name as you want, provider needs to be 'gdrive'
 - distribute credentials file via shared mounted disk location
 
+:::note
+If you are using regular personal GDrive for testing don't forget adding `/My Drive` as the prefix in root configuration. Business accounts and share drives don't need this.
+:::
+
 ### SFTP
 
 SFTP provider is used to connect to SFTP server. Currently authentication with `user:password` or `user:ssh key` is implemented.

From 82d2a4be19c011378f898020a61b8668c888d109 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 1 Apr 2022 14:19:42 +0200
Subject: [PATCH 093/108] added settings and pass is now defined only by plugin

---
 .../plugins/publish/collect_scene_render.py   | 15 ++++++------
 .../defaults/project_settings/tvpaint.json    |  4 ++++
 .../schema_project_tvpaint.json               | 24 +++++++++++++++++++
 3 files changed, 36 insertions(+), 7 deletions(-)

diff --git a/openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py b/openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py
index 2dcdab5c69..dc9c63f3bd 100644
--- a/openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py
+++ b/openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py
@@ -27,12 +27,13 @@ class CollectRenderScene(pyblish.api.ContextPlugin):
     order = pyblish.api.CollectorOrder - 0.4
     hosts = ["tvpaint"]
 
+    # Value of 'render_pass' in subset name template
+    render_pass = "beauty"
+
     # Settings attributes
     enabled = False
-    # Value of 'renderLayer' for subset name template
-    render_layer_name = "Scene"
-    # Value of 'renderPass' for subset name template
-    render_pass_name = "Beauty"
+    # Value of 'render_layer' and 'variant' in subset name template
+    render_layer = "Main"
 
     def process(self, context):
         # Check if there are created instances of renderPass and renderLayer
@@ -65,10 +66,10 @@ class CollectRenderScene(pyblish.api.ContextPlugin):
         # Host name from environment variable
         host_name = context.data["hostName"]
         # Variant is using render pass name
-        variant = self.render_pass_name
+        variant = self.render_layer
         dynamic_data = {
-            "renderLayer": self.render_layer_name,
-            "renderPass": self.render_pass_name,
+            "render_layer": self.render_layer,
+            "render_pass": self.render_pass
         }
         task_name = io.Session["AVALON_TASK"]
         subset_name = get_subset_name_with_asset_doc(
diff --git a/openpype/settings/defaults/project_settings/tvpaint.json b/openpype/settings/defaults/project_settings/tvpaint.json
index 46beeb85b9..88b5a598cd 100644
--- a/openpype/settings/defaults/project_settings/tvpaint.json
+++ b/openpype/settings/defaults/project_settings/tvpaint.json
@@ -1,6 +1,10 @@
 {
     "stop_timer_on_application_exit": false,
     "publish": {
+        "CollectRenderScene": {
+            "enabled": false,
+            "render_layer": "Main"
+        },
         "ExtractSequence": {
             "review_bg": [
                 255,
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 97462a8b62..e1166dc2bb 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_tvpaint.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_tvpaint.json
@@ -16,6 +16,30 @@
             "key": "publish",
             "label": "Publish plugins",
             "children": [
+                {
+                    "type": "dict",
+                    "collapsible": true,
+                    "key": "CollectRenderScene",
+                    "label": "Collect Render Scene",
+                    "is_group": true,
+                    "checkbox_key": "enabled",
+                    "children": [
+                        {
+                            "type": "boolean",
+                            "key": "enabled",
+                            "label": "Enabled"
+                        },
+                        {
+                            "type": "label",
+                            "label": "It is possible to fill 'render_layer' or 'variant' in subset name template with custom value. Value of 'render_pass' is \"Beauty\"."
+                        },
+                        {
+                            "type": "text",
+                            "key": "render_layer",
+                            "label": "Render Layer"
+                        }
+                    ]
+                },
                 {
                     "type": "dict",
                     "collapsible": true,

From 53c95cd1ab48fc8ff30fb53fdd4e3da14d64f4a5 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakub@orbi.tools>
Date: Fri, 1 Apr 2022 14:22:15 +0200
Subject: [PATCH 094/108] nuke: adding comments and fixing condition

---
 .../hosts/nuke/plugins/publish/extract_review_data.py     | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/nuke/plugins/publish/extract_review_data.py b/openpype/hosts/nuke/plugins/publish/extract_review_data.py
index d973e6accd..38a8140cff 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_review_data.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_review_data.py
@@ -21,9 +21,15 @@ class ExtractReviewData(openpype.api.Extractor):
 
         representations = instance.data.get("representations", [])
 
-        if "render.farm" in instance.data["families"]:
+        # review can be removed since `ProcessSubmittedJobOnFarm` will create
+        # reviable representation if needed
+        if (
+            "render.farm" in instance.data["families"]
+            and "review" in instance.data["families"]
+        ):
             instance.data["families"].remove("review")
 
+        # iterate representations and add `review` tag
         for repre in representations:
             if ext != repre["ext"]:
                 continue

From 7ce9095115653f0b0ef9e0f5faf26e4d9a24c2fd Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 1 Apr 2022 14:27:23 +0200
Subject: [PATCH 095/108] change order

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

diff --git a/openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py b/openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py
index dc9c63f3bd..38dc431778 100644
--- a/openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py
+++ b/openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py
@@ -24,7 +24,7 @@ class CollectRenderScene(pyblish.api.ContextPlugin):
     `variant` is filled using `renderPass` value.
     """
     label = "Collect Render Scene"
-    order = pyblish.api.CollectorOrder - 0.4
+    order = pyblish.api.CollectorOrder - 0.39
     hosts = ["tvpaint"]
 
     # Value of 'render_pass' in subset name template

From 1bde9c0fa96c3b20101316ceedb0c84b07673882 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 1 Apr 2022 14:30:45 +0200
Subject: [PATCH 096/108] remove unused variable

---
 .../hosts/tvpaint/plugins/publish/collect_instances.py     | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/openpype/hosts/tvpaint/plugins/publish/collect_instances.py b/openpype/hosts/tvpaint/plugins/publish/collect_instances.py
index 0008248405..5e8d13592c 100644
--- a/openpype/hosts/tvpaint/plugins/publish/collect_instances.py
+++ b/openpype/hosts/tvpaint/plugins/publish/collect_instances.py
@@ -21,8 +21,6 @@ class CollectInstances(pyblish.api.ContextPlugin):
         ))
 
         filtered_instance_data = []
-        # Check if there is any created instance
-        any_created_instance = False
         # Backwards compatibility for workfiles that already have review
         #   instance in metadata.
         review_instance_exist = False
@@ -31,10 +29,7 @@ class CollectInstances(pyblish.api.ContextPlugin):
             if family == "review":
                 review_instance_exist = True
 
-            elif family in ("renderPass", "renderLayer"):
-                any_created_instance = True
-
-            else:
+            elif family not in ("renderPass", "renderLayer"):
                 self.log.info("Unknown family \"{}\". Skipping {}".format(
                     family, json.dumps(instance_data, indent=4)
                 ))

From 83ad95bed5f180cf90c551b389db970bb0cc92b0 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 1 Apr 2022 15:27:35 +0200
Subject: [PATCH 097/108] OP-2895 - added flatten_subset_template to Settings
 for PS

Used as a subset name for ephemeral instance created if no image instance present in a workfile.
---
 .../defaults/project_settings/photoshop.json    |  5 ++++-
 .../schema_project_photoshop.json               | 17 +++++++++++++++++
 2 files changed, 21 insertions(+), 1 deletion(-)

diff --git a/openpype/settings/defaults/project_settings/photoshop.json b/openpype/settings/defaults/project_settings/photoshop.json
index 822a94a8eb..d9b7a8083f 100644
--- a/openpype/settings/defaults/project_settings/photoshop.json
+++ b/openpype/settings/defaults/project_settings/photoshop.json
@@ -12,6 +12,9 @@
             "flatten_subset_template": "",
             "color_code_mapping": []
         },
+        "CollectInstances": {
+            "flatten_subset_template": ""
+        },
         "ValidateContainers": {
             "enabled": true,
             "optional": true,
@@ -44,4 +47,4 @@
         "create_first_version": false,
         "custom_templates": []
     }
-}
+}
\ No newline at end of file
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_photoshop.json b/openpype/settings/entities/schemas/projects_schema/schema_project_photoshop.json
index b499ccc4be..f6e0e51f49 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_photoshop.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_photoshop.json
@@ -108,6 +108,23 @@
                         }
                     ]
                 },
+                {
+                    "type": "dict",
+                    "collapsible": true,
+                    "key": "CollectInstances",
+                    "label": "Collect Instances",
+                    "children": [
+                        {
+                            "type": "label",
+                            "label": "Name for flatten image created if no image instance present"
+                        },
+                        {
+                            "type": "text",
+                            "key": "flatten_subset_template",
+                            "label": "Subset template for flatten image"
+                        }
+                    ]
+                },
                 {
                     "type": "schema_template",
                     "name": "template_publish_plugin",

From 2e35be01507e9af8abec4fa538d2ceb6e8b17ad2 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 1 Apr 2022 15:28:32 +0200
Subject: [PATCH 098/108] OP-2895 - added functionality to create flatten image
 if no instances present

---
 .../plugins/publish/collect_instances.py      | 36 +++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/openpype/hosts/photoshop/plugins/publish/collect_instances.py b/openpype/hosts/photoshop/plugins/publish/collect_instances.py
index c3e27e9646..f1446f045f 100644
--- a/openpype/hosts/photoshop/plugins/publish/collect_instances.py
+++ b/openpype/hosts/photoshop/plugins/publish/collect_instances.py
@@ -1,6 +1,9 @@
+from avalon import api
 import pyblish.api
 
+from openpype.settings import get_project_settings
 from openpype.hosts.photoshop import api as photoshop
+from openpype.lib import prepare_template_data
 
 
 class CollectInstances(pyblish.api.ContextPlugin):
@@ -19,13 +22,16 @@ class CollectInstances(pyblish.api.ContextPlugin):
     families_mapping = {
         "image": []
     }
+    flatten_subset_template = ""
 
     def process(self, context):
         stub = photoshop.stub()
         layers = stub.get_layers()
         layers_meta = stub.get_layers_metadata()
         instance_names = []
+        all_layer_ids = []
         for layer in layers:
+            all_layer_ids.append(layer.id)
             layer_data = stub.read(layer, layers_meta)
 
             # Skip layers without metadata.
@@ -59,3 +65,33 @@ class CollectInstances(pyblish.api.ContextPlugin):
         if len(instance_names) != len(set(instance_names)):
             self.log.warning("Duplicate instances found. " +
                              "Remove unwanted via SubsetManager")
+
+        if len(instance_names) == 0 and self.flatten_subset_template:
+            project_name = context.data["projectEntity"]["name"]
+            variants = get_project_settings(project_name).get(
+                "photoshop", {}).get(
+                "create", {}).get(
+                "CreateImage", {}).get(
+                "defaults", [''])
+            family = "image"
+            task_name = api.Session["AVALON_TASK"]
+            asset_name = context.data["assetEntity"]["name"]
+
+            fill_pairs = {
+                "variant": variants[0],
+                "family": family,
+                "task": task_name
+            }
+
+            subset = self.flatten_subset_template.format(
+                **prepare_template_data(fill_pairs))
+
+            instance = context.create_instance(subset)
+            instance.data["family"] = family
+            instance.data["asset"] = asset_name
+            instance.data["subset"] = subset
+            instance.data["ids"] = all_layer_ids
+            instance.data["families"] = self.families_mapping[family]
+            instance.data["publish"] = True
+
+            self.log.info("flatten instance: {} ".format(instance.data))

From ee0bb56459f170ff0644b64c8b07fa982bcef914 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 1 Apr 2022 15:30:56 +0200
Subject: [PATCH 099/108] OP-2895 - updates for flatten image

New ephemeral instance doesn't have any layer, previous implementation depended on it.
---
 openpype/hosts/photoshop/plugins/publish/extract_image.py  | 4 +++-
 openpype/hosts/photoshop/plugins/publish/extract_review.py | 3 +++
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/photoshop/plugins/publish/extract_image.py b/openpype/hosts/photoshop/plugins/publish/extract_image.py
index 04ce77ee34..b07d0740c1 100644
--- a/openpype/hosts/photoshop/plugins/publish/extract_image.py
+++ b/openpype/hosts/photoshop/plugins/publish/extract_image.py
@@ -26,8 +26,10 @@ class ExtractImage(openpype.api.Extractor):
         with photoshop.maintained_selection():
             self.log.info("Extracting %s" % str(list(instance)))
             with photoshop.maintained_visibility():
+                ids = set()
                 layer = instance.data.get("layer")
-                ids = set([layer.id])
+                if layer:
+                    ids.add(layer.id)
                 add_ids = instance.data.pop("ids", None)
                 if add_ids:
                     ids.update(set(add_ids))
diff --git a/openpype/hosts/photoshop/plugins/publish/extract_review.py b/openpype/hosts/photoshop/plugins/publish/extract_review.py
index b8f4470c7b..d076610ead 100644
--- a/openpype/hosts/photoshop/plugins/publish/extract_review.py
+++ b/openpype/hosts/photoshop/plugins/publish/extract_review.py
@@ -155,6 +155,9 @@ class ExtractReview(openpype.api.Extractor):
         for image_instance in instance.context:
             if image_instance.data["family"] != "image":
                 continue
+            if not image_instance.data.get("layer"):
+                # dummy instance for flatten image
+                continue
             layers.append(image_instance.data.get("layer"))
 
         return sorted(layers)

From f0189f4703bdbee8684ef6d19b96fda2249216a2 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 1 Apr 2022 15:42:14 +0200
Subject: [PATCH 100/108] OP-2895 - added documentation

---
 .../hosts/photoshop/plugins/publish/collect_instances.py     | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/openpype/hosts/photoshop/plugins/publish/collect_instances.py b/openpype/hosts/photoshop/plugins/publish/collect_instances.py
index f1446f045f..6198ed0156 100644
--- a/openpype/hosts/photoshop/plugins/publish/collect_instances.py
+++ b/openpype/hosts/photoshop/plugins/publish/collect_instances.py
@@ -12,6 +12,10 @@ class CollectInstances(pyblish.api.ContextPlugin):
     This collector takes into account assets that are associated with
     an LayerSet and marked with a unique identifier;
 
+    If no image instances are explicitly created, it looks if there is value
+    in `flatten_subset_template` (configurable in Settings), in that case it
+    produces flatten image with all visible layers.
+
     Identifier:
         id (str): "pyblish.avalon.instance"
     """
@@ -22,6 +26,7 @@ class CollectInstances(pyblish.api.ContextPlugin):
     families_mapping = {
         "image": []
     }
+    # configurable in Settings
     flatten_subset_template = ""
 
     def process(self, context):

From eb400c2b9eae5fd7e51d15c61c96c2506884226b Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 1 Apr 2022 15:46:24 +0200
Subject: [PATCH 101/108] OP-2895 - added documentation

---
 .../schemas/projects_schema/schema_project_photoshop.json       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_photoshop.json b/openpype/settings/entities/schemas/projects_schema/schema_project_photoshop.json
index f6e0e51f49..badf94229b 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_photoshop.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_photoshop.json
@@ -42,7 +42,7 @@
                     "children": [
                         {
                             "type": "label",
-                            "label": "Set color for publishable layers, set its resulting family and template for subset name. Can create flatten image from published instances"
+                            "label": "Set color for publishable layers, set its resulting family and template for subset name. \nCan create flatten image from published instances.(Applicable only for remote publishing!)"
                         },
                         {
                             "type": "boolean",

From f3f5007af5b3fdc4512adc2fdba85b9a4030e5a0 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 1 Apr 2022 15:47:18 +0200
Subject: [PATCH 102/108] added asset and task on instance data

---
 .../tvpaint/plugins/publish/collect_scene_render.py    | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py b/openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py
index 38dc431778..df3f715853 100644
--- a/openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py
+++ b/openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py
@@ -55,7 +55,8 @@ class CollectRenderScene(pyblish.api.ContextPlugin):
         # Collect asset doc to get asset id
         # - not sure if it's good idea to require asset id in
         #   get_subset_name?
-        asset_name = context.data["workfile_context"]["asset"]
+        workfile_context = context.data["workfile_context"]
+        asset_name = workfile_context["asset"]
         asset_doc = io.find_one({
             "type": "asset",
             "name": asset_name
@@ -71,7 +72,8 @@ class CollectRenderScene(pyblish.api.ContextPlugin):
             "render_layer": self.render_layer,
             "render_pass": self.render_pass
         }
-        task_name = io.Session["AVALON_TASK"]
+
+        task_name = workfile_context["task"]
         subset_name = get_subset_name_with_asset_doc(
             family,
             variant,
@@ -95,7 +97,9 @@ class CollectRenderScene(pyblish.api.ContextPlugin):
             "active": not any_created_instance,
             "publish": not any_created_instance,
             "representations": [],
-            "layers": copy.deepcopy(context.data["layersData"])
+            "layers": copy.deepcopy(context.data["layersData"]),
+            "asset": asset_name,
+            "task": task_name
         }
 
         instance = context.create_instance(**instance_data)

From 3dbd2ef7493a620e2de584cff640f3ad0b45ce4f Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 1 Apr 2022 15:52:04 +0200
Subject: [PATCH 103/108] OP-2895 - added documentation for simplified workflow

---
 website/docs/artist_hosts_photoshop.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/website/docs/artist_hosts_photoshop.md b/website/docs/artist_hosts_photoshop.md
index b2b5fd58da..a140170c49 100644
--- a/website/docs/artist_hosts_photoshop.md
+++ b/website/docs/artist_hosts_photoshop.md
@@ -49,6 +49,12 @@ With the `Creator` you have a variety of options to create:
 - Uncheck `Use selection`.
     - This will create a single group named after the `Subset` in the `Creator`.
 
+#### Simplified publish
+
+There is a simplified workflow for simple use case where only single image should be created containing all visible layers.
+No image instances must be present in a workfile and `project_settings/photoshop/publish/CollectInstances/flatten_subset_template` must be filled in Settings.
+Then artists just need to hit 'Publish' button in menu.
+
 ### Publish
 
 When you are ready to share some work, you will need to publish. This is done by opening the `Pyblish` through the extensions `Publish` button.

From 486ccff38f6837465698b107c6682ec4e586415b Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 1 Apr 2022 15:52:56 +0200
Subject: [PATCH 104/108] added missing subset key

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

diff --git a/openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py b/openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py
index df3f715853..9d5c4dbb62 100644
--- a/openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py
+++ b/openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py
@@ -88,6 +88,7 @@ class CollectRenderScene(pyblish.api.ContextPlugin):
             "family": family,
             "families": families,
             "fps": context.data["sceneFps"],
+            "subset": subset_name,
             "name": subset_name,
             "label": "{} [{}-{}]".format(
                 subset_name,

From ee827e8dd2e3ec5209969f33392c0dea5c952195 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 1 Apr 2022 16:02:19 +0200
Subject: [PATCH 105/108] fix case family

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

diff --git a/openpype/hosts/tvpaint/plugins/publish/extract_sequence.py b/openpype/hosts/tvpaint/plugins/publish/extract_sequence.py
index 73daf60567..d4fd1dff4b 100644
--- a/openpype/hosts/tvpaint/plugins/publish/extract_sequence.py
+++ b/openpype/hosts/tvpaint/plugins/publish/extract_sequence.py
@@ -159,7 +159,7 @@ class ExtractSequence(pyblish.api.Extractor):
 
         # Fill tags and new families
         tags = []
-        if family_lowered in ("review", "renderlayer", "renderScene"):
+        if family_lowered in ("review", "renderlayer", "renderscene"):
             tags.append("review")
 
         # Sequence of one frame

From 81bbdc972f31e4dc5d7c25f6e3a4a136b1ef220d Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 1 Apr 2022 16:05:24 +0200
Subject: [PATCH 106/108] fix family used to get subset name

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

diff --git a/openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py b/openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py
index 9d5c4dbb62..0af9a9a400 100644
--- a/openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py
+++ b/openpype/hosts/tvpaint/plugins/publish/collect_scene_render.py
@@ -75,7 +75,7 @@ class CollectRenderScene(pyblish.api.ContextPlugin):
 
         task_name = workfile_context["task"]
         subset_name = get_subset_name_with_asset_doc(
-            family,
+            "render",
             variant,
             task_name,
             asset_doc,

From 8c1fbf88d5e431156254583380ff24ec251832e5 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 1 Apr 2022 16:20:15 +0200
Subject: [PATCH 107/108] added more info into label

---
 .../schemas/projects_schema/schema_project_tvpaint.json         | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

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 e1166dc2bb..20fe5b0855 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_tvpaint.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_tvpaint.json
@@ -31,7 +31,7 @@
                         },
                         {
                             "type": "label",
-                            "label": "It is possible to fill 'render_layer' or 'variant' in subset name template with custom value. Value of 'render_pass' is \"Beauty\"."
+                            "label": "It is possible to fill <b>'render_layer'</b> or <b>'variant'</b> in subset name template with custom value.<br/>- value of <b>'render_pass'</b> is always \"beauty\"."
                         },
                         {
                             "type": "text",

From ea3cae8bc413474673a8242b47985b91dfd1eee6 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 1 Apr 2022 17:36:18 +0200
Subject: [PATCH 108/108] remove path existence checks in
 'add_implementation_envs'

---
 openpype/hosts/blender/__init__.py | 4 ++--
 openpype/hosts/hiero/__init__.py   | 2 +-
 openpype/hosts/houdini/__init__.py | 4 ++--
 openpype/hosts/maya/__init__.py    | 2 +-
 openpype/hosts/nuke/__init__.py    | 2 +-
 5 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/openpype/hosts/blender/__init__.py b/openpype/hosts/blender/__init__.py
index 3081d3c9ba..0f27882c7e 100644
--- a/openpype/hosts/blender/__init__.py
+++ b/openpype/hosts/blender/__init__.py
@@ -29,12 +29,12 @@ def add_implementation_envs(env, _app):
         env.get("OPENPYPE_BLENDER_USER_SCRIPTS") or ""
     )
     for path in openpype_blender_user_scripts.split(os.pathsep):
-        if path and os.path.exists(path):
+        if path:
             previous_user_scripts.add(os.path.normpath(path))
 
     blender_user_scripts = env.get("BLENDER_USER_SCRIPTS") or ""
     for path in blender_user_scripts.split(os.pathsep):
-        if path and os.path.exists(path):
+        if path:
             previous_user_scripts.add(os.path.normpath(path))
 
     # Remove implementation path from user script paths as is set to
diff --git a/openpype/hosts/hiero/__init__.py b/openpype/hosts/hiero/__init__.py
index 2d674b3fa7..d2ac82391b 100644
--- a/openpype/hosts/hiero/__init__.py
+++ b/openpype/hosts/hiero/__init__.py
@@ -10,7 +10,7 @@ def add_implementation_envs(env, _app):
     ]
     old_hiero_path = env.get("HIERO_PLUGIN_PATH") or ""
     for path in old_hiero_path.split(os.pathsep):
-        if not path or not os.path.exists(path):
+        if not path:
             continue
 
         norm_path = os.path.normpath(path)
diff --git a/openpype/hosts/houdini/__init__.py b/openpype/hosts/houdini/__init__.py
index 8c12d13c81..a3ee38db8d 100644
--- a/openpype/hosts/houdini/__init__.py
+++ b/openpype/hosts/houdini/__init__.py
@@ -15,7 +15,7 @@ def add_implementation_envs(env, _app):
     old_houdini_menu_path = env.get("HOUDINI_MENU_PATH") or ""
 
     for path in old_houdini_path.split(os.pathsep):
-        if not path or not os.path.exists(path):
+        if not path:
             continue
 
         norm_path = os.path.normpath(path)
@@ -23,7 +23,7 @@ def add_implementation_envs(env, _app):
             new_houdini_path.append(norm_path)
 
     for path in old_houdini_menu_path.split(os.pathsep):
-        if not path or not os.path.exists(path):
+        if not path:
             continue
 
         norm_path = os.path.normpath(path)
diff --git a/openpype/hosts/maya/__init__.py b/openpype/hosts/maya/__init__.py
index b7d26a7818..c1c82c62e5 100644
--- a/openpype/hosts/maya/__init__.py
+++ b/openpype/hosts/maya/__init__.py
@@ -9,7 +9,7 @@ def add_implementation_envs(env, _app):
     ]
     old_python_path = env.get("PYTHONPATH") or ""
     for path in old_python_path.split(os.pathsep):
-        if not path or not os.path.exists(path):
+        if not path:
             continue
 
         norm_path = os.path.normpath(path)
diff --git a/openpype/hosts/nuke/__init__.py b/openpype/hosts/nuke/__init__.py
index 60b37ce1dd..134a6621c4 100644
--- a/openpype/hosts/nuke/__init__.py
+++ b/openpype/hosts/nuke/__init__.py
@@ -10,7 +10,7 @@ def add_implementation_envs(env, _app):
     ]
     old_nuke_path = env.get("NUKE_PATH") or ""
     for path in old_nuke_path.split(os.pathsep):
-        if not path or not os.path.exists(path):
+        if not path:
             continue
 
         norm_path = os.path.normpath(path)