Add UI delegation plugin

Add first draft of a UI delegate plugin. This is functional, but
limited, and could be cleaner. Ideally work will be done upstream in
FPT to make this easier.

Provide asset browsers fo both published files and workfiles.

Workfiles are a particular pain point, since they cannot be queried from
the server, i.e. they just exist on disk in strictly structured paths.

Opening a workfile also triggers several FPT processes, and so we can't
simply return a reference to the host application. Future work will have
the manager plugin trigger these processes only once the workfile is
resolved, via some mechanism to signal to FPT that the workfile is
being resolved with the intention of opening it in a DCC (e.g. via the
Context.locale).

Provide an entity info panel showing asset information about the
selected entity. This is an interesting case since it relies on the
host asynchronously communicating the currently selected entity to the
delegated UI element.

Only read cases supported - i.e. no publishing support - at the moment.

Due to the need to import sgtk apps at runtime, many classes must be
defined inline. Alternative strategies exist, but this is left for
future work.

Since we're adapting pre-existing widgets, several overrides and fixes
must be applied. In particular, we use a "widget stash" to keep FPT
widgets alive as long as possible, to avoid issues with QThreads being
destroyed without proper cleanup.

Bump minimum version of OpenAssetIO to 1.0.0, where the UI delegation
API is available; and MediaCreation to alpha.12, where some UI-specific
traits are defined.

Author: feltech

plugin/fpt_openassetio_manager/FPTManagerInterface.py

@@ -36,14 +36,16 @@
 
 class FPTManagerInterface(ManagerInterface):
     """
-    Implement the OpenAssetIO ManagerInterface for Flow Production Tracking.
+    Implement the OpenAssetIO ManagerInterface for Flow Production
+    Tracking.
+
     https://openassetio.github.io/OpenAssetIO/classopenassetio_1_1v1_1_1manager_api_1_1_manager_interface.html
     """
 
     # Entity references provided to this asset manager should be
     # prefixed with this string to be considered valid.
     # e.g. "fpt://asset/PublishedFile/123"
-    __reference_prefix = "fpt://"
+    reference_prefix = "fpt://"
 
     def __init__(self):
         super().__init__()
@@ -66,7 +68,7 @@ def __init__(self):
 
     def identifier(self):
         """
-        Unique identifier of this manager plugin.
+        Retrieve the unique identifier of this manager plugin.
         """
         return "org.foundry.fpt"
 
@@ -143,7 +145,7 @@ def info(self):
         """
         Arbitrary metadata about this plugin.
         """
-        return {constants.kInfoKey_EntityReferencesMatchPrefix: self.__reference_prefix}
+        return {constants.kInfoKey_EntityReferencesMatchPrefix: self.reference_prefix}
 
     def managementPolicy(self, traitSets, policyAccess, _context, _hostSession):
         """
@@ -191,7 +193,7 @@ def isEntityReferenceString(self, someString, _hostSession):
         function will rarely, if ever, be called.
         """
         # Check if the string starts with our prefix.
-        return someString.startswith(self.__reference_prefix)
+        return someString.startswith(self.reference_prefix)
 
     def entityTraits(
         self,
@@ -430,13 +432,15 @@ def __parse_reference(self, ref_str: str) -> Optional["_ParsedReference"]:
           - fpt://asset/{asset_type}/{asset_id}
           - fpt://workfile/{template_name}/{field1}/{field2}...
         """
-        if not ref_str.startswith(self.__reference_prefix):
+        if not ref_str.startswith(self.reference_prefix):
             return None
 
         # Remove prefix and split path
-        ref_type, *parts = ref_str[len(self.__reference_prefix) :].split("/")
+        ref_type, *parts = ref_str[len(self.reference_prefix):].split("/")
+
+        min_num_parts = 2
 
-        if len(parts) < 2:
+        if len(parts) < min_num_parts:
             return None
 
         if ref_type == "asset":
@@ -457,7 +461,9 @@ def __parse_asset_reference(
 
         I.e. fpt://asset/{asset_type}/{asset_id}
         """
-        if len(parts) != 2:
+        expected_num_parts = 2
+
+        if len(parts) != expected_num_parts:
             return None
 
         obj_type, ident_str = parts