From c264a6abf1a2c6605b9d7d51d2e2cdb6c0d9a63b Mon Sep 17 00:00:00 2001 From: Toke Stuart Jepsen Date: Mon, 24 Jul 2023 08:14:57 +0100 Subject: [PATCH 01/36] Disable hardlinking. --- .../hosts/maya/plugins/publish/extract_look.py | 15 ++++++--------- 1 file changed, 6 insertions(+), 9 deletions(-) diff --git a/openpype/hosts/maya/plugins/publish/extract_look.py b/openpype/hosts/maya/plugins/publish/extract_look.py index e2c88ef44a..50a6db3bf7 100644 --- a/openpype/hosts/maya/plugins/publish/extract_look.py +++ b/openpype/hosts/maya/plugins/publish/extract_look.py @@ -6,7 +6,6 @@ import contextlib import json import logging import os -import platform import tempfile import six import attr @@ -585,14 +584,12 @@ class ExtractLook(publish.Extractor): resources = instance.data["resources"] color_management = lib.get_color_management_preferences() - # 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) + # Temporary disable all hardlinking, due to the feature not being used + # or properly working. + self.log.info( + "Forcing copy instead of hardlink." + ) + force_copy = True destinations_cache = {} From 1db5d5f838b78a4e807385ab5a202cd13134f1d5 Mon Sep 17 00:00:00 2001 From: Toke Stuart Jepsen Date: Fri, 28 Jul 2023 08:27:37 +0100 Subject: [PATCH 02/36] Ensure legacy_io_distinct is not used in AYON --- openpype/hosts/maya/plugins/publish/extract_look.py | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/openpype/hosts/maya/plugins/publish/extract_look.py b/openpype/hosts/maya/plugins/publish/extract_look.py index 50a6db3bf7..ec01a817b3 100644 --- a/openpype/hosts/maya/plugins/publish/extract_look.py +++ b/openpype/hosts/maya/plugins/publish/extract_look.py @@ -18,6 +18,7 @@ from openpype.lib.vendor_bin_utils import find_executable from openpype.lib import source_hash, run_subprocess, get_oiio_tools_path from openpype.pipeline import legacy_io, publish, KnownPublishError from openpype.hosts.maya.api import lib +from openpype import AYON_SERVER_ENABLED # Modes for transfer COPY = 1 @@ -50,6 +51,12 @@ def find_paths_by_hash(texture_hash): str: path to texture if found. """ + if AYON_SERVER_ENABLED: + raise ValueError( + "This is a bug. \"find_paths_by_hash\" is not compatible with " + "AYON." + ) + key = "data.sourceHashes.{0}".format(texture_hash) return legacy_io.distinct(key, {"type": "version"}) From c72c8f332cbfbf3ded76ba9c6b2fcb9cbd9b1522 Mon Sep 17 00:00:00 2001 From: Kayla Man Date: Tue, 8 Aug 2023 15:00:17 +0800 Subject: [PATCH 03/36] switching asset can maintain linkages on the modifiers and other data --- openpype/hosts/max/plugins/load/load_max_scene.py | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/openpype/hosts/max/plugins/load/load_max_scene.py b/openpype/hosts/max/plugins/load/load_max_scene.py index 76cd3bf367..c98b7909ee 100644 --- a/openpype/hosts/max/plugins/load/load_max_scene.py +++ b/openpype/hosts/max/plugins/load/load_max_scene.py @@ -24,7 +24,9 @@ class MaxSceneLoader(load.LoaderPlugin): path = os.path.normpath(path) # import the max scene by using "merge file" path = path.replace('\\', '/') - rt.MergeMaxFile(path) + rt.MergeMaxFile( + path, rt.Name("autoRenameDups"), + includeFullGroup=True) max_objects = rt.getLastMergedNodes() max_container = rt.Container(name=f"{name}") for max_object in max_objects: @@ -38,11 +40,11 @@ class MaxSceneLoader(load.LoaderPlugin): path = get_representation_path(representation) node_name = container["instance_node"] - - rt.MergeMaxFile(path, - rt.Name("noRedraw"), - rt.Name("deleteOldDups"), - rt.Name("useSceneMtlDups")) + merged_max_objects = rt.getLastMergedNodes() + rt.MergeMaxFile( + path, rt.Name("autoRenameDups"), + mergedNodes=merged_max_objects, + includeFullGroup=True) max_objects = rt.getLastMergedNodes() container_node = rt.GetNodeByName(node_name) From d51c1fa9fb3ba534d9b2ba5b0cd3c6254c465290 Mon Sep 17 00:00:00 2001 From: Kayla Man Date: Tue, 8 Aug 2023 15:11:13 +0800 Subject: [PATCH 04/36] do not use autorename duplicate when updating or switching version --- openpype/hosts/max/plugins/load/load_max_scene.py | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/openpype/hosts/max/plugins/load/load_max_scene.py b/openpype/hosts/max/plugins/load/load_max_scene.py index c98b7909ee..3af4613d1a 100644 --- a/openpype/hosts/max/plugins/load/load_max_scene.py +++ b/openpype/hosts/max/plugins/load/load_max_scene.py @@ -42,8 +42,7 @@ class MaxSceneLoader(load.LoaderPlugin): node_name = container["instance_node"] merged_max_objects = rt.getLastMergedNodes() rt.MergeMaxFile( - path, rt.Name("autoRenameDups"), - mergedNodes=merged_max_objects, + path, mergedNodes=merged_max_objects, includeFullGroup=True) max_objects = rt.getLastMergedNodes() From ab1172b277eaa396f3c3e992b3ad5759ff1635bf Mon Sep 17 00:00:00 2001 From: Kayla Man Date: Tue, 8 Aug 2023 15:54:35 +0800 Subject: [PATCH 05/36] delete old duplicates --- .../hosts/max/plugins/load/load_max_scene.py | 22 ++++++++----------- 1 file changed, 9 insertions(+), 13 deletions(-) diff --git a/openpype/hosts/max/plugins/load/load_max_scene.py b/openpype/hosts/max/plugins/load/load_max_scene.py index 3af4613d1a..92e1bdc59a 100644 --- a/openpype/hosts/max/plugins/load/load_max_scene.py +++ b/openpype/hosts/max/plugins/load/load_max_scene.py @@ -25,31 +25,27 @@ class MaxSceneLoader(load.LoaderPlugin): # import the max scene by using "merge file" path = path.replace('\\', '/') rt.MergeMaxFile( - path, rt.Name("autoRenameDups"), + path, rt.Name("mergeDups"), includeFullGroup=True) max_objects = rt.getLastMergedNodes() - max_container = rt.Container(name=f"{name}") - for max_object in max_objects: - max_object.Parent = max_container return containerise( - name, [max_container], context, loader=self.__class__.__name__) + name, [max_objects], context, loader=self.__class__.__name__) def update(self, container, representation): from pymxs import runtime as rt path = get_representation_path(representation) - node_name = container["instance_node"] - merged_max_objects = rt.getLastMergedNodes() + prev_max_objects = rt.getLastMergedNodes() + merged_max_objects = [obj.name for obj + in prev_max_objects] rt.MergeMaxFile( - path, mergedNodes=merged_max_objects, + path, merged_max_objects, + rt.Name("deleteOldDups"), + quiet=True, + mergedNodes=prev_max_objects, includeFullGroup=True) - max_objects = rt.getLastMergedNodes() - container_node = rt.GetNodeByName(node_name) - for max_object in max_objects: - max_object.Parent = container_node - lib.imprint(container["instance_node"], { "representation": str(representation["_id"]) }) From 70cb60a17eb98ca7796674f4555f115019e27abe Mon Sep 17 00:00:00 2001 From: Kayla Man Date: Tue, 8 Aug 2023 17:19:42 +0800 Subject: [PATCH 06/36] deletion of the old objects --- openpype/hosts/max/plugins/load/load_max_scene.py | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/openpype/hosts/max/plugins/load/load_max_scene.py b/openpype/hosts/max/plugins/load/load_max_scene.py index 92e1bdc59a..1d105f1bc0 100644 --- a/openpype/hosts/max/plugins/load/load_max_scene.py +++ b/openpype/hosts/max/plugins/load/load_max_scene.py @@ -45,6 +45,11 @@ class MaxSceneLoader(load.LoaderPlugin): quiet=True, mergedNodes=prev_max_objects, includeFullGroup=True) + current_max_objects = rt.getLastMergedNodes() + for current_object in current_max_objects: + prev_max_objects = prev_max_objects.remove(current_object) + for prev_object in prev_max_objects: + rt.Delete(prev_object) lib.imprint(container["instance_node"], { "representation": str(representation["_id"]) From 444cca4213128d470641a58ffac4602b9ac5f833 Mon Sep 17 00:00:00 2001 From: Kayla Man Date: Mon, 21 Aug 2023 15:30:46 +0800 Subject: [PATCH 07/36] load max scene wip --- .../hosts/max/plugins/load/load_max_scene.py | 66 +++++++++++++------ 1 file changed, 47 insertions(+), 19 deletions(-) diff --git a/openpype/hosts/max/plugins/load/load_max_scene.py b/openpype/hosts/max/plugins/load/load_max_scene.py index 1d105f1bc0..6dfb3d0115 100644 --- a/openpype/hosts/max/plugins/load/load_max_scene.py +++ b/openpype/hosts/max/plugins/load/load_max_scene.py @@ -1,7 +1,11 @@ import os from openpype.hosts.max.api import lib -from openpype.hosts.max.api.pipeline import containerise +from openpype.hosts.max.api.lib import unique_namespace +from openpype.hosts.max.api.pipeline import ( + containerise, import_custom_attribute_data, + update_custom_attribute_data +) from openpype.pipeline import get_representation_path, load @@ -19,37 +23,61 @@ class MaxSceneLoader(load.LoaderPlugin): def load(self, context, name=None, namespace=None, data=None): from pymxs import runtime as rt - path = self.filepath_from_context(context) path = os.path.normpath(path) # import the max scene by using "merge file" path = path.replace('\\', '/') - rt.MergeMaxFile( - path, rt.Name("mergeDups"), - includeFullGroup=True) + rt.MergeMaxFile(path, quiet=True, includeFullGroup=True) max_objects = rt.getLastMergedNodes() + # implement the OP/AYON custom attributes before load + max_container = [] + namespace = unique_namespace( + name + "_", + suffix="_", + ) + container = rt.Container(name=f"{namespace}:{name}") + import_custom_attribute_data(container, max_objects) + max_container.append(container) + max_container.extend(max_objects) return containerise( - name, [max_objects], context, loader=self.__class__.__name__) + name, max_container, context, + namespace, loader=self.__class__.__name__) def update(self, container, representation): from pymxs import runtime as rt path = get_representation_path(representation) - prev_max_objects = rt.getLastMergedNodes() - merged_max_objects = [obj.name for obj - in prev_max_objects] - rt.MergeMaxFile( - path, merged_max_objects, - rt.Name("deleteOldDups"), - quiet=True, - mergedNodes=prev_max_objects, - includeFullGroup=True) + node_name = container["instance_node"] + + node = rt.getNodeByName(node_name) + param_container = node_name.split("_CON")[0] + + # delete the old container with attribute + # delete old duplicate + prev_max_object_names = [obj.name for obj + in rt.getLastMergedNodes()] + rt.MergeMaxFile(path, rt.Name("deleteOldDups")) + current_max_objects = rt.getLastMergedNodes() - for current_object in current_max_objects: - prev_max_objects = prev_max_objects.remove(current_object) - for prev_object in prev_max_objects: - rt.Delete(prev_object) + current_max_object_names = [obj.name for obj + in current_max_objects] + for name in current_max_object_names: + idx = rt.findItem(prev_max_object_names, name) + if idx: + prev_max_object_names = rt.deleteItem( + prev_max_object_names, idx) + for object_name in prev_max_object_names: + prev_max_object = rt.getNodeByName(object_name) + rt.Delete(prev_max_object) + + for max_object in current_max_objects: + max_object.Parent = node + for children in node.Children: + if rt.classOf(children) == rt.Container: + if children.name == param_container: + update_custom_attribute_data( + children, current_max_objects) lib.imprint(container["instance_node"], { "representation": str(representation["_id"]) From dfd748ccd191e3d6058529d8deaf2865c7a9ec89 Mon Sep 17 00:00:00 2001 From: Toke Stuart Jepsen Date: Tue, 22 Aug 2023 08:27:52 +0100 Subject: [PATCH 08/36] Remove force copy option --- openpype/hosts/maya/plugins/create/create_look.py | 8 +------- 1 file changed, 1 insertion(+), 7 deletions(-) diff --git a/openpype/hosts/maya/plugins/create/create_look.py b/openpype/hosts/maya/plugins/create/create_look.py index 385ae81e01..11a69151fd 100644 --- a/openpype/hosts/maya/plugins/create/create_look.py +++ b/openpype/hosts/maya/plugins/create/create_look.py @@ -37,13 +37,7 @@ class CreateLook(plugin.MayaCreator): label="Convert textures to .rstex", tooltip="Whether to generate Redshift .rstex files for " "your textures", - default=self.rs_tex), - BoolDef("forceCopy", - label="Force Copy", - tooltip="Enable users to force a copy instead of hardlink." - "\nNote: On Windows copy is always forced due to " - "bugs in windows' implementation of hardlinks.", - default=False) + default=self.rs_tex) ] def get_pre_create_attr_defs(self): From 71bd10fffb7e3715108e0253203d28f32441998a Mon Sep 17 00:00:00 2001 From: Toke Jepsen Date: Tue, 5 Sep 2023 08:32:22 +0100 Subject: [PATCH 09/36] Update openpype/hosts/maya/plugins/publish/extract_look.py 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/hosts/maya/plugins/publish/extract_look.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/openpype/hosts/maya/plugins/publish/extract_look.py b/openpype/hosts/maya/plugins/publish/extract_look.py index ec01a817b3..043d88db6d 100644 --- a/openpype/hosts/maya/plugins/publish/extract_look.py +++ b/openpype/hosts/maya/plugins/publish/extract_look.py @@ -52,7 +52,7 @@ def find_paths_by_hash(texture_hash): """ if AYON_SERVER_ENABLED: - raise ValueError( + raise KnownPublishError( "This is a bug. \"find_paths_by_hash\" is not compatible with " "AYON." ) From 93a9ae2a6fa977b523de16b9f524e76d2d5fbf86 Mon Sep 17 00:00:00 2001 From: Toke Stuart Jepsen Date: Tue, 5 Sep 2023 08:33:49 +0100 Subject: [PATCH 10/36] Add TODO --- openpype/hosts/maya/plugins/publish/extract_look.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/openpype/hosts/maya/plugins/publish/extract_look.py b/openpype/hosts/maya/plugins/publish/extract_look.py index 043d88db6d..2708a6d916 100644 --- a/openpype/hosts/maya/plugins/publish/extract_look.py +++ b/openpype/hosts/maya/plugins/publish/extract_look.py @@ -591,8 +591,8 @@ class ExtractLook(publish.Extractor): resources = instance.data["resources"] color_management = lib.get_color_management_preferences() - # Temporary disable all hardlinking, due to the feature not being used - # or properly working. + # TODO: Temporary disable all hardlinking, due to the feature not being + # used or properly working. self.log.info( "Forcing copy instead of hardlink." ) From 8dd4b70aa3c153ece4cb26fb4ee590742850c990 Mon Sep 17 00:00:00 2001 From: Jakub Jezek Date: Wed, 6 Sep 2023 16:52:34 +0200 Subject: [PATCH 11/36] nuke: remove redundant workfile colorspace profiles --- .../defaults/project_settings/nuke.json | 6 +----- .../schemas/schema_nuke_imageio.json | 20 ------------------- 2 files changed, 1 insertion(+), 25 deletions(-) diff --git a/openpype/settings/defaults/project_settings/nuke.json b/openpype/settings/defaults/project_settings/nuke.json index b736c462ff..7961e77113 100644 --- a/openpype/settings/defaults/project_settings/nuke.json +++ b/openpype/settings/defaults/project_settings/nuke.json @@ -28,11 +28,7 @@ "colorManagement": "Nuke", "OCIO_config": "nuke-default", "workingSpaceLUT": "linear", - "monitorLut": "sRGB", - "int8Lut": "sRGB", - "int16Lut": "sRGB", - "logLut": "Cineon", - "floatLut": "linear" + "monitorLut": "sRGB" }, "nodes": { "requiredNodes": [ diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_imageio.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_imageio.json index d4cd332ef8..af826fcf46 100644 --- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_imageio.json +++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_imageio.json @@ -106,26 +106,6 @@ "type": "text", "key": "monitorLut", "label": "monitor" - }, - { - "type": "text", - "key": "int8Lut", - "label": "8-bit files" - }, - { - "type": "text", - "key": "int16Lut", - "label": "16-bit files" - }, - { - "type": "text", - "key": "logLut", - "label": "log files" - }, - { - "type": "text", - "key": "floatLut", - "label": "float files" } ] } From 359ead27a2e6f637dda576ae1daf1801bf00f348 Mon Sep 17 00:00:00 2001 From: Jakub Jezek Date: Wed, 6 Sep 2023 16:53:41 +0200 Subject: [PATCH 12/36] nuke-addon: remove redundant workfile colorspace names --- server_addon/nuke/server/settings/imageio.py | 32 -------------------- 1 file changed, 32 deletions(-) diff --git a/server_addon/nuke/server/settings/imageio.py b/server_addon/nuke/server/settings/imageio.py index b43017ef8b..3f5ac0b8f9 100644 --- a/server_addon/nuke/server/settings/imageio.py +++ b/server_addon/nuke/server/settings/imageio.py @@ -66,22 +66,6 @@ def ocio_configs_switcher_enum(): class WorkfileColorspaceSettings(BaseSettingsModel): """Nuke workfile colorspace preset. """ - """# TODO: enhance settings with host api: - we need to add mapping to resolve properly keys. - Nuke is excpecting camel case key names, - but for better code consistency we need to - be using snake_case: - - color_management = colorManagement - ocio_config = OCIO_config - working_space_name = workingSpaceLUT - monitor_name = monitorLut - monitor_out_name = monitorOutLut - int_8_name = int8Lut - int_16_name = int16Lut - log_name = logLut - float_name = floatLut - """ colorManagement: Literal["Nuke", "OCIO"] = Field( title="Color Management" @@ -100,18 +84,6 @@ class WorkfileColorspaceSettings(BaseSettingsModel): monitorLut: str = Field( title="Monitor" ) - int8Lut: str = Field( - title="8-bit files" - ) - int16Lut: str = Field( - title="16-bit files" - ) - logLut: str = Field( - title="Log files" - ) - floatLut: str = Field( - title="Float files" - ) class ReadColorspaceRulesItems(BaseSettingsModel): @@ -238,10 +210,6 @@ DEFAULT_IMAGEIO_SETTINGS = { "OCIO_config": "nuke-default", "workingSpaceLUT": "linear", "monitorLut": "sRGB", - "int8Lut": "sRGB", - "int16Lut": "sRGB", - "logLut": "Cineon", - "floatLut": "linear" }, "nodes": { "requiredNodes": [ From 81446b1bbb972bcb8ee8fa9c9df06868d7c008aa Mon Sep 17 00:00:00 2001 From: Simone Barbieri Date: Mon, 11 Sep 2023 11:55:49 +0100 Subject: [PATCH 13/36] Remove hardcoded subset name for reviews --- openpype/hosts/blender/plugins/publish/collect_review.py | 4 ---- 1 file changed, 4 deletions(-) diff --git a/openpype/hosts/blender/plugins/publish/collect_review.py b/openpype/hosts/blender/plugins/publish/collect_review.py index 6459927015..3bf2e39e24 100644 --- a/openpype/hosts/blender/plugins/publish/collect_review.py +++ b/openpype/hosts/blender/plugins/publish/collect_review.py @@ -39,15 +39,11 @@ class CollectReview(pyblish.api.InstancePlugin): ] if not instance.data.get("remove"): - - task = instance.context.data["task"] - # Store focal length in `burninDataMembers` burninData = instance.data.setdefault("burninDataMembers", {}) burninData["focalLength"] = focal_length instance.data.update({ - "subset": f"{task}Review", "review_camera": camera, "frameStart": instance.context.data["frameStart"], "frameEnd": instance.context.data["frameEnd"], From ae02fe220aefb292f705f715fea4def1b2192782 Mon Sep 17 00:00:00 2001 From: Petr Kalis Date: Mon, 11 Sep 2023 16:28:11 +0200 Subject: [PATCH 14/36] AfterEffects: fix imports of image sequences (#5581) * Fix loading image sequence in AE * Fix logic Files might be list or str * Update openpype/hosts/aftereffects/plugins/load/load_file.py Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com> --------- Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com> --- openpype/hosts/aftereffects/plugins/load/load_file.py | 9 ++------- 1 file changed, 2 insertions(+), 7 deletions(-) diff --git a/openpype/hosts/aftereffects/plugins/load/load_file.py b/openpype/hosts/aftereffects/plugins/load/load_file.py index def7c927ab..8d52aac546 100644 --- a/openpype/hosts/aftereffects/plugins/load/load_file.py +++ b/openpype/hosts/aftereffects/plugins/load/load_file.py @@ -31,13 +31,8 @@ class FileLoader(api.AfterEffectsLoader): path = self.filepath_from_context(context) - repr_cont = context["representation"]["context"] - if "#" not in path: - frame = repr_cont.get("frame") - if frame: - padding = len(frame) - path = path.replace(frame, "#" * padding) - import_options['sequence'] = True + if len(context["representation"]["files"]) > 1: + import_options['sequence'] = True if not path: repr_id = context["representation"]["_id"] From 1fdbe05905995641f02b4c4c3b2d7e27be6ecf3a Mon Sep 17 00:00:00 2001 From: Petr Kalis Date: Mon, 11 Sep 2023 17:21:38 +0200 Subject: [PATCH 15/36] Photoshop: fixed blank Flatten image (#5600) * OP-6763 - refresh all visible for Flatten image Previously newly added layers were missing. * OP-6763 - added explicit image collector Creator was adding 'layer' metadata from workfile only during collect_instances, it was missing for newly added layers. This should be cleaner approach * OP-6763 - removed unnecessary method overwrite Creator is not adding layer to instance, separate collector created. * OP-6763 - cleanup of names Was failing when template for subset name for image family contained {layer} * OP-6763 - cleanup, removed adding layer metadata Separate collector created, cleaner. Fixed propagation of mark_for_review * OP-6763 - using members instead of layer data Members should be more reliable. * OP-6763 - updated image from Settings Explicit subset name template was removed some time ago as confusing. * OP-6763 - added explicit local plugin Automated plugin has different logic, local would need to handle if auto_image is disabled by artist * OP-6763 - Hound * OP-6345 - fix - review for image family Image family instance contained flattened content. Now it reuses previously extracted file without need to re-extract. --- .../plugins/create/create_flatten_image.py | 40 +++++++++--- .../photoshop/plugins/create/create_image.py | 17 ++--- .../publish/collect_auto_image_refresh.py | 24 +++++++ .../plugins/publish/collect_image.py | 20 ++++++ .../plugins/publish/extract_image.py | 8 ++- .../plugins/publish/extract_review.py | 59 +++++++++++++++--- website/docs/admin_hosts_photoshop.md | 7 +-- .../assets/admin_hosts_photoshop_settings.png | Bin 14364 -> 16718 bytes 8 files changed, 144 insertions(+), 31 deletions(-) create mode 100644 openpype/hosts/photoshop/plugins/publish/collect_auto_image_refresh.py create mode 100644 openpype/hosts/photoshop/plugins/publish/collect_image.py diff --git a/openpype/hosts/photoshop/plugins/create/create_flatten_image.py b/openpype/hosts/photoshop/plugins/create/create_flatten_image.py index 9d4189a1a3..e4229788bd 100644 --- a/openpype/hosts/photoshop/plugins/create/create_flatten_image.py +++ b/openpype/hosts/photoshop/plugins/create/create_flatten_image.py @@ -4,6 +4,7 @@ from openpype.lib import BoolDef import openpype.hosts.photoshop.api as api from openpype.hosts.photoshop.lib import PSAutoCreator from openpype.pipeline.create import get_subset_name +from openpype.lib import prepare_template_data from openpype.client import get_asset_by_name @@ -37,19 +38,14 @@ class AutoImageCreator(PSAutoCreator): asset_doc = get_asset_by_name(project_name, asset_name) if existing_instance is None: - subset_name = get_subset_name( - self.family, self.default_variant, task_name, asset_doc, + subset_name = self.get_subset_name( + self.default_variant, task_name, asset_doc, project_name, host_name ) - publishable_ids = [layer.id for layer in api.stub().get_layers() - if layer.visible] data = { "asset": asset_name, "task": task_name, - # ids are "virtual" layers, won't get grouped as 'members' do - # same difference in color coded layers in WP - "ids": publishable_ids } if not self.active_on_create: @@ -69,8 +65,8 @@ class AutoImageCreator(PSAutoCreator): existing_instance["asset"] != asset_name or existing_instance["task"] != task_name ): - subset_name = get_subset_name( - self.family, self.default_variant, task_name, asset_doc, + subset_name = self.get_subset_name( + self.default_variant, task_name, asset_doc, project_name, host_name ) @@ -118,3 +114,29 @@ class AutoImageCreator(PSAutoCreator): Artist might disable this instance from publishing or from creating review for it though. """ + + def get_subset_name( + self, + variant, + task_name, + asset_doc, + project_name, + host_name=None, + instance=None + ): + dynamic_data = prepare_template_data({"layer": "{layer}"}) + subset_name = get_subset_name( + self.family, variant, task_name, asset_doc, + project_name, host_name, dynamic_data=dynamic_data + ) + return self._clean_subset_name(subset_name) + + def _clean_subset_name(self, subset_name): + """Clean all variants leftover {layer} from subset name.""" + dynamic_data = prepare_template_data({"layer": "{layer}"}) + for value in dynamic_data.values(): + if value in subset_name: + return (subset_name.replace(value, "") + .replace("__", "_") + .replace("..", ".")) + return subset_name diff --git a/openpype/hosts/photoshop/plugins/create/create_image.py b/openpype/hosts/photoshop/plugins/create/create_image.py index 8d3ac9f459..af20d456e0 100644 --- a/openpype/hosts/photoshop/plugins/create/create_image.py +++ b/openpype/hosts/photoshop/plugins/create/create_image.py @@ -94,12 +94,17 @@ class ImageCreator(Creator): name = self._clean_highlights(stub, directory) layer_names_in_hierarchy.append(name) - data.update({"subset": subset_name}) - data.update({"members": [str(group.id)]}) - data.update({"layer_name": layer_name}) - data.update({"long_name": "_".join(layer_names_in_hierarchy)}) + data_update = { + "subset": subset_name, + "members": [str(group.id)], + "layer_name": layer_name, + "long_name": "_".join(layer_names_in_hierarchy) + } + data.update(data_update) - creator_attributes = {"mark_for_review": self.mark_for_review} + mark_for_review = (pre_create_data.get("mark_for_review") or + self.mark_for_review) + creator_attributes = {"mark_for_review": mark_for_review} data.update({"creator_attributes": creator_attributes}) if not self.active_on_create: @@ -124,8 +129,6 @@ class ImageCreator(Creator): if creator_id == self.identifier: instance_data = self._handle_legacy(instance_data) - layer = api.stub().get_layer(instance_data["members"][0]) - instance_data["layer"] = layer instance = CreatedInstance.from_existing( instance_data, self ) diff --git a/openpype/hosts/photoshop/plugins/publish/collect_auto_image_refresh.py b/openpype/hosts/photoshop/plugins/publish/collect_auto_image_refresh.py new file mode 100644 index 0000000000..741fb0e9cd --- /dev/null +++ b/openpype/hosts/photoshop/plugins/publish/collect_auto_image_refresh.py @@ -0,0 +1,24 @@ +import pyblish.api + +from openpype.hosts.photoshop import api as photoshop + + +class CollectAutoImageRefresh(pyblish.api.ContextPlugin): + """Refreshes auto_image instance with currently visible layers.. + """ + + label = "Collect Auto Image Refresh" + order = pyblish.api.CollectorOrder + hosts = ["photoshop"] + order = pyblish.api.CollectorOrder + 0.2 + + def process(self, context): + for instance in context: + creator_identifier = instance.data.get("creator_identifier") + if creator_identifier and creator_identifier == "auto_image": + self.log.debug("Auto image instance found, won't create new") + # refresh existing auto image instance with current visible + publishable_ids = [layer.id for layer in photoshop.stub().get_layers() # noqa + if layer.visible] + instance.data["ids"] = publishable_ids + return diff --git a/openpype/hosts/photoshop/plugins/publish/collect_image.py b/openpype/hosts/photoshop/plugins/publish/collect_image.py new file mode 100644 index 0000000000..64727cef33 --- /dev/null +++ b/openpype/hosts/photoshop/plugins/publish/collect_image.py @@ -0,0 +1,20 @@ +import pyblish.api + +from openpype.hosts.photoshop import api + + +class CollectImage(pyblish.api.InstancePlugin): + """Collect layer metadata into a instance. + + Used later in validation + """ + order = pyblish.api.CollectorOrder + 0.200 + label = 'Collect Image' + + hosts = ["photoshop"] + families = ["image"] + + def process(self, instance): + if instance.data.get("members"): + layer = api.stub().get_layer(instance.data["members"][0]) + instance.data["layer"] = layer diff --git a/openpype/hosts/photoshop/plugins/publish/extract_image.py b/openpype/hosts/photoshop/plugins/publish/extract_image.py index cdb28c742d..680f580cc0 100644 --- a/openpype/hosts/photoshop/plugins/publish/extract_image.py +++ b/openpype/hosts/photoshop/plugins/publish/extract_image.py @@ -45,9 +45,11 @@ class ExtractImage(pyblish.api.ContextPlugin): # Perform extraction files = {} ids = set() - layer = instance.data.get("layer") - if layer: - ids.add(layer.id) + # real layers and groups + members = instance.data("members") + if members: + ids.update(set([int(member) for member in members])) + # virtual groups collected by color coding or auto_image 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 4aa7a05bd1..afddbdba31 100644 --- a/openpype/hosts/photoshop/plugins/publish/extract_review.py +++ b/openpype/hosts/photoshop/plugins/publish/extract_review.py @@ -1,4 +1,5 @@ import os +import shutil from PIL import Image from openpype.lib import ( @@ -55,6 +56,7 @@ class ExtractReview(publish.Extractor): } if instance.data["family"] != "review": + self.log.debug("Existing extracted file from image family used.") # enable creation of review, without this jpg review would clash # with jpg of the image family output_name = repre_name @@ -62,8 +64,15 @@ class ExtractReview(publish.Extractor): repre_skeleton.update({"name": repre_name, "outputName": output_name}) - if self.make_image_sequence and len(layers) > 1: - self.log.info("Extract layers to image sequence.") + img_file = self.output_seq_filename % 0 + self._prepare_file_for_image_family(img_file, instance, + staging_dir) + repre_skeleton.update({ + "files": img_file, + }) + processed_img_names = [img_file] + elif self.make_image_sequence and len(layers) > 1: + self.log.debug("Extract layers to image sequence.") img_list = self._save_sequence_images(staging_dir, layers) repre_skeleton.update({ @@ -72,17 +81,17 @@ class ExtractReview(publish.Extractor): "fps": fps, "files": img_list, }) - instance.data["representations"].append(repre_skeleton) processed_img_names = img_list else: - self.log.info("Extract layers to flatten image.") - img_list = self._save_flatten_image(staging_dir, layers) + self.log.debug("Extract layers to flatten image.") + img_file = self._save_flatten_image(staging_dir, layers) repre_skeleton.update({ - "files": img_list, + "files": img_file, }) - instance.data["representations"].append(repre_skeleton) - processed_img_names = [img_list] + processed_img_names = [img_file] + + instance.data["representations"].append(repre_skeleton) ffmpeg_args = get_ffmpeg_tool_args("ffmpeg") @@ -111,6 +120,35 @@ class ExtractReview(publish.Extractor): self.log.info(f"Extracted {instance} to {staging_dir}") + def _prepare_file_for_image_family(self, img_file, instance, staging_dir): + """Converts existing file for image family to .jpg + + Image instance could have its own separate review (instance per layer + for example). This uses extracted file instead of extracting again. + Args: + img_file (str): name of output file (with 0000 value for ffmpeg + later) + instance: + staging_dir (str): temporary folder where extracted file is located + """ + repre_file = instance.data["representations"][0] + source_file_path = os.path.join(repre_file["stagingDir"], + repre_file["files"]) + if not os.path.exists(source_file_path): + raise RuntimeError(f"{source_file_path} doesn't exist for " + "review to create from") + _, ext = os.path.splitext(repre_file["files"]) + if ext != ".jpg": + im = Image.open(source_file_path) + # without this it produces messy low quality jpg + rgb_im = Image.new("RGBA", (im.width, im.height), "#ffffff") + rgb_im.alpha_composite(im) + rgb_im.convert("RGB").save(os.path.join(staging_dir, img_file)) + else: + # handles already .jpg + shutil.copy(source_file_path, + os.path.join(staging_dir, img_file)) + def _generate_mov(self, ffmpeg_path, instance, fps, no_of_frames, source_files_pattern, staging_dir): """Generates .mov to upload to Ftrack. @@ -218,6 +256,11 @@ class ExtractReview(publish.Extractor): (list) of PSItem """ layers = [] + # creating review for existing 'image' instance + if instance.data["family"] == "image" and instance.data.get("layer"): + layers.append(instance.data["layer"]) + return layers + for image_instance in instance.context: if image_instance.data["family"] != "image": continue diff --git a/website/docs/admin_hosts_photoshop.md b/website/docs/admin_hosts_photoshop.md index de684f01d2..d79789760e 100644 --- a/website/docs/admin_hosts_photoshop.md +++ b/website/docs/admin_hosts_photoshop.md @@ -33,7 +33,6 @@ Provides list of [variants](artist_concepts.md#variant) that will be shown to an Provides simplified publishing process. It will create single `image` instance for artist automatically. This instance will produce flatten image from all visible layers in a workfile. -- Subset template for flatten image - provide template for subset name for this instance (example `imageBeauty`) - Review - should be separate review created for this instance ### Create Review @@ -111,11 +110,11 @@ Set Byte limit for review file. Applicable if gigantic `image` instances are pro #### Extract jpg Options -Handles tags for produced `.jpg` representation. `Create review` and `Add review to Ftrack` are defaults. +Handles tags for produced `.jpg` representation. `Create review` and `Add review to Ftrack` are defaults. #### Extract mov Options -Handles tags for produced `.mov` representation. `Create review` and `Add review to Ftrack` are defaults. +Handles tags for produced `.mov` representation. `Create review` and `Add review to Ftrack` are defaults. ### Workfile Builder @@ -124,4 +123,4 @@ Allows to open prepared workfile for an artist when no workfile exists. Useful t Could be configured per `Task type`, eg. `composition` task type could use different `.psd` template file than `art` task. Workfile template must be accessible for all artists. -(Currently not handled by [SiteSync](module_site_sync.md)) \ No newline at end of file +(Currently not handled by [SiteSync](module_site_sync.md)) diff --git a/website/docs/assets/admin_hosts_photoshop_settings.png b/website/docs/assets/admin_hosts_photoshop_settings.png index aaa6ecbed7b353733f8424abe3c2df0cb903935a..9478fbedf785ca8ae66132a14cb400c38e2dccc9 100644 GIT binary patch literal 16718 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 literal 14364 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 Date: Mon, 11 Sep 2023 17:23:08 +0200 Subject: [PATCH 16/36] AfterEffects: added validator for missing files in FootageItems (#5590) * OP-6345 - updated logic to return path and comp for FootageItem Used later to check existance of file in published comps * OP-6345 - added validator if footage files exist Comp could contain multiple FootageItems, eg imported file(s). If file is missing render triggered by jsx fails silently. * OP-6345 - updated extension * OP-6345 - small updates after testing * OP-6345 - fix - handle Solid Footage items JSX failed silently on Solid item as it doesn't have any `.file` * OP-6345 - enhance documentation * OP-6345 - remove optionality This plugin shouldn't be optional as when needed and skipped it result in really weird behavior. * OP-6345 - updated documentation Added missing plugins. * OP-6345 - missed functionality for optionality * OP-6345 - removed unneeded import --- openpype/hosts/aftereffects/api/extension.zxp | Bin 102930 -> 103005 bytes .../api/extension/CSXS/manifest.xml | 24 ++++----- .../api/extension/jsx/hostscript.jsx | 16 +++++- openpype/hosts/aftereffects/api/ws_stub.py | 8 ++- .../publish/help/validate_footage_items.xml | 14 +++++ .../plugins/publish/validate_footage_items.py | 49 ++++++++++++++++++ website/docs/admin_hosts_aftereffects.md | 8 +++ 7 files changed, 104 insertions(+), 15 deletions(-) create mode 100644 openpype/hosts/aftereffects/plugins/publish/help/validate_footage_items.xml create mode 100644 openpype/hosts/aftereffects/plugins/publish/validate_footage_items.py diff --git a/openpype/hosts/aftereffects/api/extension.zxp b/openpype/hosts/aftereffects/api/extension.zxp index 358e9740d3c2479b88dff08af47eba3d74be63ce..933dc7dc6cab34b6a1630b25d11a2167fa0aef7a 100644 GIT binary patch delta 10917 zcmZvC1ymi)((O68y9E!yodkDxceh}{-QnQw2ROL91q<#32yVe4KyZiP{*v7P{`Y?G zy_q%BHPuyJwYsNg?KQQNis06Y;1a^26G&g{q9%cVTChG;`k%Jp4oV&Eub_m91@%`j z!xlq@2?}7)0#}l|zf&iDHT!L6He+CErYr{yg988n5CDI=7i{LcxS#<5Td??B572+x zjcY2nEVE(=(0sT@ubAwGN|F~GOvn#pA4~fRjW{k}3O|QXHJ_?4gEnQfj{DMsfxTZ% zOmK8^y3%ZO66DezA$lcQY#P*D6=u+kvD1~tDrlp_GI{%j;i$>a`S=Pi!+DFHJWHW` z#wrWmAU&_|g=Z5CO1Pn68pTg!G9B46mp@UQj6*ElPGmnA zYLIBHkAe9q4yC0m*Gky?DORTU-ADr?y6C|eYKq`QsV-_KNci&IR#XiBj9CfBh2Pt8 zA`xA35@qq9+WE!OQ&|D;_@x_XERN|TKfdLtn5)?D6t>ET!qi&Pno(YMINNknr@ztL zTCK_DtT}n`P`g5VQ3y(Gj?W7!APb9}NwRv2EtAz*03E!AD$u+ zus18qd_Qqx4mzidB}lnSko4*=b%s+D{pf(0U0zbpm91)28AVC;qIl-tAVvOi#S6lm zI}8`NEneXhf0{Z;9Y(!1uOT^62c5Y~qEAse2}k)X5OsA+Yw4i|_4XAH2Ng2-V$J-_ zg5Fn@m)GiJ%``+@AL$)o??ru8 z!CI58AQNG)8ULVN&j3-8-L#c1WlR+&2oK=8PDr9`X(D+XYAq}mtwrhJa``SrA#WtC zt~eeRdBRG0!19YOd<|)NCC0Z8bFYn$}F*m}0}3D0j{yYKbjZhG(%w6An#+K(N=SU|cyEN%$6~e;c!< z8$7;2yoN8o{h5Br<_QpFecxK#7ILMI!Y~m&*1MySbkbmoUaVJTs*~dTt2;X21r|&e zMhK>%a`?MT)2VX)?nz#1HLSlv0=M43g&9n6kN)3H-5_f~|1YhF!z3mQFbYEpEF0(r z&$hq%XYV$Q1WrT$OPd?&`fn|mFf8G3jOwtgzeCH1*U*VBo@@krl zL!aK8gqN}`xuz>rP)??$?Txa-5muO|*L7!QcPtfjbv;wlN13SnqGR#m+%%;vkn=}c z2>7 zz|C-Hu3|%s`22dfaZ(WUh#IUk>f)}fw)RnG0DmlC13qoCjE;Skq&C^I!5Xc*(u*SO zmvy(jz_?sb{bzE2uo>QRSV@^TTZRy;1GfQIsWHtsq^6Vt1g)VCB|vJ$#jH zfzt>F>D=>K*m>5k_qDHjarc?+Q$jeDYQkJjE1G`hQv?Bo{Cty4WWN8#MUo)LFI)cP7r4q`)=s9CFD zky?JplJdL0n4LV(+_1ryzo>N`Rm8DhPESS+;Q@S{@==U%0N+}vr_*DQ4Mk$4^bqSr zD>u_6REUL}Z+1jQX*;1b%yU5*RzRWeU6s%+a* zhEwj|$9C!QyiQ5I{XK*+3aimZDN$Z zm_OJ}^`N91@n`{C6N>{h&1?-VK;s9ERiq+Uy^%LEvyK0wL3|Xe=2OxyaF8Xr!5lxO z?wxXN&S9Ps00q#FFm)|%tV{bM5Uz=}^HQxEf3+vw*SLQRjdY9QZ}7|V-V9L@x{kBT zJNA?c>w{IeGZ`j(G;YhM8ks@Fw*V>nFwfCxa?gIeB~<9X60u`YcemF88N}T1hS$M) zKz#$4$tZWuRpE-;WXQ~t!!mn?_7pKlp#;IT3IP?O91tfJN_3Lp45aFHLbh2C-8&pRqlPJygpAP>*Gt0B=2!I+OgT_+V* z$I6oJ42oRbEd)&v3em$&g#IL(C74#hYpiBhT5Y%xDU7;PgH1{Z2B)oz;#`zUl`y_H zXl<7w(cdIFpC!}eRfy$2={B>I^Gk<5L)n%{@5=sp*UF5e2$vAAmtUK||F6TP3%yy@ z;p~OTES7EB@g>r&4>zsQ7B=ac*#b8&=X32JPq3D$i%+pYRZ{SeM~m;98~T6lnAVw^ z*$xC4P;DGStI7FmP~$GrDQ6ioS|d1X84Ral!(jWv6l!6=+{G*P#QJwU3cN%M!5t5i z#i(p<%));IXE`FQe$S3EEfa%xY0ptH^-U^fn3u3{RoQND`z{%a0ka^*bw;)s_RQs?N1o`Jn0U4MmLh@3W=%AmI2jI}O zm$SEPiK*u*tzg$&->&BId_}&pjX=^yxHk~j<2;RhYYJ_mv4u}O-5=CY?%4Ak!%x_4 z#fCn8quG!7?A;zGOAKk1b8Tf0&QILoux1q6#{NfgkQA99y;?L-ABu}qY--RS0WmG^ zps5+#NUj-iCw#lGI9#Qx`Me92c_||>PIsC2aquLM65p)IEc~lYk1p)DBkX`@(w&H? z;&x1UAozYq16kG+L#Pm+NZUZ!u&8VfGmF zY$tG5Aq*sD^vtwkfgF~lBh`KlwXjK z+^cCdTK6UdvOd!e_c#y?hX(#^JbSPn)PW65ei@f@*v)39if-#_q@B2*EiEa&yf2yM zbu$qiGj*m-G-!2kDeZ#VB4>ONmd1W?!t%%Q8Nal^amDUw#L2_|K!(q>gWQ_TVoax} z0IG)d-3;Cw%2jD)XM`bR7NqZ)$()iBN3NY(6TQrw!^TigudM_3>K@f zx%mtey`sij1_7cSSi0DRLoXR7^}!+tBS<(vX8<;XGr63x`>>EX>iGI&2a&tDN?4xb zdVNT9ur-8s5%#%l)3Zyv0c z!k`yJf+xn8!H!S^6Qa)i=tc|2rppny=`ccFP8*K}qtk2}qU<*4YDv;4zbSb99kh`) znRIM`x5qN#t8>NcJV7V)@n`={2T8G4)Y~D~)&{~r^cOspdSOu<>ZS2WN)$DpNB@t$ z{}Mq&_mKIi;bj-Dytr-YW4IW%tX;!A#ONDH50!)a z0k)=L5yst!UM^%5Ik{O`WL@0;7$6d)Au*ZW&6v0!IaxWRLPVXsPm^2CmgpAo;b-}j zIb8zxqZiZn!QWK5`-&Qug%q^3&T}Cx8pJpQJ=&CPgcWbJVfjiZ3-LGSsD*zX!$U@? zUrAlGloroG>qYO6*UtPq)<#{VB~v00ZPE$tkO|#|nta|!+7(#a9xK9M(||ZgH1FT& zAUm&N>oF|(L$DD84u;9UJJ50~hq#$8zf%qGef=)02wxh}$hp*NcbC3{OYqqo5B*u4 zWP;%R#4asc63T{%9m;Lzp0~?E{A1a(p)qREM+@8BZ{)MwA-V8|U1TOM8%ytzbZ1cvlFJ^CR9Yx5Nu{eyvo}tl%2pf$To&bUWNBmChXG zg^0k9rAKSgwQ%i>6!dw7g4RS>y%|O^P=9oGZq(A-vkCLM-{=?Twb>hr(-auNT$h;F z9^hzpO!gmlIp?_PSr<=~# z8G%N3%;mk2+=@jxY;>zSac7IB(=7$-0{crU0j~LcpVGBl)zvbRiuM+DJ(1kQP3tYr zUUmH+lxa1=HoAzETk>xh5OJz7DOxp?uDKErq2DvP(j_}=K_QBhsr3Zfrb%LNekmLJ zY$keKo@_;C%)~j_(b)s~q|XH>&Re z25zVzswFMTC=Q~?I72RSMsCsG+eb&89%*TGvfc5gd_eDIdb0eE(s)p@>k~YCj9M0) zR7hG_ykFG|h@(yU@d4E1K; z;x_6doDApqXy|HD%;0^!bK6VYO!XXp#T99T2zm3W*XruMN*M{H5WinMw1{_m)xnXj z$rt{@rp_7cV(GSb7o#~*d0?nJSwgkSU0F~+!}L=;AkJvIbI-i2)w7B5lO{?;o8}I> znDsSYM=TuekMGK$UQI0-c`rU|5&WB39wiGGvGR^KMBZkTPtah?!Ak$=ceSezeTCHL ziIi+hZqZ=IMGZrL(Tf=Au;MMGUkphEuCxXMpGSUUE(2=J6xVE1s?k?3Oq4slwPF4d z3wlEb`zO$+kP%$^ppuL!Jnp1!pR#!{G{9hC*Mgz^TxzbcR8*& z0n%6r-dcE9@RsozSw(E2IJ!Bvddr=_y{iB_Td13GSqg>6GkN@2VrVFt5k{!(Sb+Dv zaFV0kI|XsnUj}O`2{FFBxHt#?wUTxHIVi+2j)m#kRZAAAeC%FWU2NMhsut_y;RJvCW%M z0l(`0+USupdEZHi_DJV=Ymd^ii9ooVRK(QcoL=Z@%|PqWC2BtDh?}~pv#0H)NR*)7 zB>faGP9kMjg;r_OfwzQc5;o=^kY|I44DFp<_zVKcg|wRxBr?}&GIp#l0KL~vUcr8jGxDu6C{Ij@C(u=))+smF zV603Oj5A5uZJ{Gr{wgX%fSKy4Q#1?{ad3Toz#&15M8PHx_W-!i!Xbg5o%Pt`e%@!H zAI9WSPGGEcZKB{pEhO$3uJKeIl&`8ECdSkI747PT^_D-&lN3dXXzX%PeZ3-Sm$oyi z2SgmhL+e))K?ra+7^oW2t2KhBT1KFHNu#1Q+a6fr$D;U>Vb7S-;2E$RayU$wBJa(~ zh}YoGjwo>)+bLhcQBf)#DsFoe;5EAT0uz->{KmQ;O;w8t)_$qunIY~VrY3w+@dt5u z+owd5nX=Svlv;NJ?C6nh%}(LH2+t3?*q}`YlK}?F0|iF2a71}9EJF6_8ofyyHeXOy zU|dmmlInp+P^*Rdn$SV|3t|W{q?T}!B7=%Hxsotcr$~lBBcVSIm;H4;bkxo~-k(Tn znbJ_jZkAkQ;fUWbXvt^w3SB`2%klIlJU(8Un`vP5{0yZZl6fPeTB&M<;t<>_K1iu@ z#Ji-n`FqaNxe&?6eqNuj5>%)5VS0AziAh#=a)rTsAboCQOGe;Uvq#yI^<>04>CnoL zVPS?O{;h0DoX@xKZDbx31-fizgg;TS(nYT>BA;s)$qiWTBy`MiX4x|9UQ~w}*e5|* zyWaXEqGiuh5%_cQMlFHppUljn+ig;@A<4hFyxg!FxorWwsrhH7abd5W0<=DPw3& zy7(-iT$RiT!$G~{TUp|M#V^i--b$%p170*oQR_?|ua`y1I<}&;WNnR*h<>gt+yCJo z!O~(@Q3ex>q0jSTk!A4X(*j89d!dDZ!2q8!Yy@VG25T2d8Za3LL&S%t!kcRRjc9ny zt9cSjsM7${y=CRr^}|H;tdivV$6MJ#gk04r9WLHROM0i+uW+2TXJ7J13HjQ(`$Q4u zFoj~Nb1kTT{ivB@TU0k-t3Y6@_>~B=tgg+^i4avkKrCw4Vb>sC_q5jP;y7 zr&V!D|Eh0qz*iUwceuX=Xu})+YMfXqrh#Q(Nh02f3|)bRH%3#Vh^PQoRkxrbVq_0l ziT8ko6uxO}_|`y0N|*Ul`hgTK^WdR{X?}aurH@Hs;rzNpipun6temz~Sn`{Ye57=A^XsX;jkj%wwJ*E+Tm!)N} zk*99@gx;rr7`9TVQ1Wykvy?kKmXj&-UB+QzmG+m8eqka@i$PzkK&uJ}yz}*gaMZ7y0(RAW2@BE%`t1ZDwdsCHo0dVM9 z%~2OjSt62$*fwa5(9t>w0k4Tzv)k6+z&HxQR#=f`pcG)-XAbQ^fCw&>(bTw*xH|n*zj1ckL?RKJOT6uqy9ia&dGK}P8|zqO7(7+lCdGQJWRA{02s)-+|M;zOYcZ`FE?SJx7mUb}47sovw@h2aV64tX37 zraD;{E%;^5mq@z)=$OYM=$i_%>q0vuje`DyWvFI#U>6pa68=0$Y!qqhUeqW#9b}lR zv;fjDx*^4obd@Kutsr_risu_D19`J0-PHoWp*by7e@pVsrzrGENhxmZGU;Pg@qZmsfbJs=W^ z)Eb}pzK&dWAaoyVm_XsonZ-Q-LfqVa4X$`QX?5c92fTg1DPc|(AF<_(-jx+VTaC8Uec@aTeVpLGJ~Z@!~vkF z3sZxhGgH;xTW^D}=X~iK`1Zmq0Ua0@ZGdfa_RzDrwyfBT(FJqDUi=rl*)M5SHb8_* zZXK-#D+3@Et~=^_*_oh&!X=W0rG3S#y243%A@&1$YXs)_`b?r*0)MaB1`4u-wn#cZY;fBJcG0>-3; zzq(kYhMpT^-A&^=Gl3Vo?6RHb+Usn8y)=4VBdN7-R-z+J=6vpA>}8e76{iEGx~EPT z6(pJZt~})SiS@L4^J8^XD0{^9Xs&|f#k|?fLpQ(dn`C!&c`DLKhFk7A7_^0oU&5=PfCGH=d zCMEb8ceCMY=ryHYg}B-il;X~fo+&acX$rY$_6i&NZ-)vCg~+48CTzhe;oUP zyri*&QKU`jvKUfixa-_2!9REwQt!;#1rlNShIAb`nahke?$-4LB7pxGzrm45GU(BQ z_eI*F=w6(1d_cGPD|dpk?zbY_13Gl{Ig^s`B2C9n0*pSQ``j$X@D{`2p|GyRzG9jC zK0ZWwdIeA;%2|>wNRF0PwXEp&6rGy9;mvQ<*mg>3r0F<=`d&nuRGYntH43=!d_ZwE zovFb5DMqkQWtfpQ=mOt-H->4gC?Vl7JyNs|iY}qmQKG3Y6(WG5_-5i)BCZl`Vpwq* z|1DbQ`w3F7eRG~`@kz(8J~#VW-Lb~p`t%9}Dw^}tII~^urpySd>M3gpD2<)7!Yl3e z@ojz>LU?j(?|SCA`JG%slyVdbBJA>lM+*!_C`A#|(&JS_=ptHH|d{h{hy0XDEhxD_J8`bCez^|2m!z# z(7$c|v~y`o_Jt#OVQ24lNOTY67=S3G+=uq%fZ*PMakG!71W~&Ds|y(5-@xjUP{`j3x+#kXdqv9(3jR`h82u3zu9C zM*=fhe2}Qa>3kuarQ`M)WMbJ~N78e9f$q>C59;!FYZ+=SP0-|jxGFVEWHoHx8FNPgPA zW1&V@`2nvM9cGq^=tsMo(fPmD$+})h;CLqq(>Si>aIQustc5<$fF9J2KzMP!IcbqW znA=8hKr!W?I$vpTj>V~B<~*N$mf z@qu{w+_|nbT9#4h%P|a`$qnMo82Q@;UlwEOlu(wxMLf25EM25axpQK=Np{o14ZY*& z)?Hxk?m60e%X90xxoK0c+|^D0TyCt+cevKGsnEtFCNpS%+zfId)Ku7x*O=}h!+~oKs~+ZP#*G=Ov}mxf-g*pvqLL-w z1z1#Bu^N88yOf3JqffZS`9|d}aWii+F9w#SbesF|JZcpN+??3CIeE@*SM-*HPdJ$t zX#>d5tTj|Iw1BGAZWcWf-v~>`T>YS_?n&_#bmT*T?8t5Z?<>)&}{P&e6l0Eb%UuCE0#Q0$x}i`l*)8bZBj zSq*VXihj^fs98&CkYv?N{agygV!`eR%w+-o;`rB@0R#hV`n8fBTkJg=!n&Sk67OEc zRJcs_D;IM)XcR=1NjomQHy-yYK@zSvEv%88Q8{Oe(LK4hop!q3QxyEYe2KO z=I+-b1_T?FWwVIQsT9F#O8#sSn!)GSE`hHZqYfZHht@dXvcPJWAp1+-8;e{rrVX&i zi|aN%NTCpivyemR=?>cccKDdswQgK@W)9mvm?VnXYSHfJ5VnBGkf?)sSGtQP^ig)} z)4;Ky?%L-LB~sVr4Y8z@xT}MtO`|sZ7&;xctJj#OGW`fT9x`c%0xz(~;NV?56 zm^7exEN$H3JCxkPn_MX)v=3++G*KIiFy%8G(>r$**$gN>t^H1t@SHTZsy~?B4rH&| z-e763hk2V~jd}L}DnN7{n<53bPM8>Zul)?boJBxIworaIiNyU=_K=!ob=96!KznHG zzR*(ZLXFV8c^VUD#+l&oZc4G#{rCW0sZtf>u^a{kVoz=`As%oKpNvq}Hpma2mq(R( zt=TEX+?Whj%FL%!n3aOGiEA5lriF-gta(DaD-MWfgj|VNb)-dgJ|LZc8*d==5`6!0 zapyv9L@_7o7!Eg+@5r#M2^n^}XL)*WoWM1=Z_Qb8Kw8b=E{6Yv*|b>cGvbq_KZg=1 zsUvvK4u@MH?5Lz6V zCrO7xer@-7x$gT&viX6H6gEtwLPRBqp6hbsp3c^OlOsr%L0rF~*J1>APYjV`!{VR| zs&sI;j+?jM9Z^T%BjgnKYbl`&MX97!ESZoa{kr?+>;W8}QbBA^TfoY#V`^2QfofC= z2h9;bEEOxZLuQ&2A46$X#w*-&xvdEYzhdrG>A|SYAs&|NQO}M|1G=nrI4~77RdtzB z%8B1^L&+>DrW+_ylw|f@AAEj>b@;@&7y=;_sodyj9@-uiZ~j>*$27@D#sckOqqkB_ z_9)Pdk+$Be_=`M{MBX0nnhC4!jpF8ob$oKenmtJS@KF@?GQXJ%S%*3X3{lZbVgu1Q zJ+#rUW;&9Y;I+E=%HqUuFld5&$Sd0wU^6P(waMdY>5ZMd$Q(i+GPI5?PxS`)6@h_B zaI%Xg%#pJLVH&Y&0C;n0PMlGAmsl&_;b@n`47;IkIm=uWcn5Ei?!ao4WG*9?4+g}6 zodyKczG$!&IwzU;?+?*ptqni!y>r6u!-*s6b3)c$3n5mG+O7PExVZ(IZ~DDNVOa{9 zNj7>pea=suqq3S-+R@UV874nq?YgP8YpAooyStwRXQJhx1eje<11(lKBy3y*G(Hj9 zSee!jW%F3d|72Y&!rtjleCM!o0zti>G`O1tX|hzKgF;@R{s{~aUpfToeuIQR7XrWr z0P&6hS|a}!2xvZz0CoWXvi=}dQ9xFbKXg82IUp1%;QvGTgWN{}KS2LBfv`ja8K7P$ zA^OokFihkQ`sKWyOP@DdwL;@L(1)>2lAd9g;Nnjy_Ebey-N;LqmPYo$#IUYy^`5Xr% z1>!*_;(!XkLA&aspJXTi0P7!N4#EQfq<8=T z{y&0?1pLo9kfcN)8Owj1|C7W&-?RT-&Qi!mB9MUaUrw-ae^Mp+eeNOv049;Z-%tMs D9WP{T delta 10814 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 BS&;w$ diff --git a/openpype/hosts/aftereffects/api/extension/CSXS/manifest.xml b/openpype/hosts/aftereffects/api/extension/CSXS/manifest.xml index 0057758320..7329a9e723 100644 --- a/openpype/hosts/aftereffects/api/extension/CSXS/manifest.xml +++ b/openpype/hosts/aftereffects/api/extension/CSXS/manifest.xml @@ -1,5 +1,5 @@ - @@ -10,22 +10,22 @@ - + - + - - + + - + - - + + - + @@ -63,7 +63,7 @@ 550 400 --> - + ./icons/iconNormal.png @@ -71,9 +71,9 @@ ./icons/iconDisabled.png ./icons/iconDarkNormal.png ./icons/iconDarkRollover.png - + - \ No newline at end of file + diff --git a/openpype/hosts/aftereffects/api/extension/jsx/hostscript.jsx b/openpype/hosts/aftereffects/api/extension/jsx/hostscript.jsx index bc443930df..c00844e637 100644 --- a/openpype/hosts/aftereffects/api/extension/jsx/hostscript.jsx +++ b/openpype/hosts/aftereffects/api/extension/jsx/hostscript.jsx @@ -215,6 +215,8 @@ function _getItem(item, comps, folders, footages){ * Refactor */ var item_type = ''; + var path = ''; + var containing_comps = []; if (item instanceof FolderItem){ item_type = 'folder'; if (!folders){ @@ -222,10 +224,18 @@ function _getItem(item, comps, folders, footages){ } } if (item instanceof FootageItem){ - item_type = 'footage'; if (!footages){ return "{}"; } + item_type = 'footage'; + if (item.file){ + path = item.file.fsName; + } + if (item.usedIn){ + for (j = 0; j < item.usedIn.length; ++j){ + containing_comps.push(item.usedIn[j].id); + } + } } if (item instanceof CompItem){ item_type = 'comp'; @@ -236,7 +246,9 @@ function _getItem(item, comps, folders, footages){ var item = {"name": item.name, "id": item.id, - "type": item_type}; + "type": item_type, + "path": path, + "containing_comps": containing_comps}; return JSON.stringify(item); } diff --git a/openpype/hosts/aftereffects/api/ws_stub.py b/openpype/hosts/aftereffects/api/ws_stub.py index f5b96fa63a..18f530e272 100644 --- a/openpype/hosts/aftereffects/api/ws_stub.py +++ b/openpype/hosts/aftereffects/api/ws_stub.py @@ -37,6 +37,9 @@ class AEItem(object): height = attr.ib(default=None) is_placeholder = attr.ib(default=False) uuid = attr.ib(default=False) + path = attr.ib(default=False) # path to FootageItem to validate + # list of composition Footage is in + containing_comps = attr.ib(factory=list) class AfterEffectsServerStub(): @@ -704,7 +707,10 @@ class AfterEffectsServerStub(): d.get("instance_id"), d.get("width"), d.get("height"), - d.get("is_placeholder")) + d.get("is_placeholder"), + d.get("uuid"), + d.get("path"), + d.get("containing_comps"),) ret.append(item) return ret diff --git a/openpype/hosts/aftereffects/plugins/publish/help/validate_footage_items.xml b/openpype/hosts/aftereffects/plugins/publish/help/validate_footage_items.xml new file mode 100644 index 0000000000..01c8966015 --- /dev/null +++ b/openpype/hosts/aftereffects/plugins/publish/help/validate_footage_items.xml @@ -0,0 +1,14 @@ + + + +Footage item missing + +## Footage item missing + + FootageItem `{name}` contains missing `{path}`. Render will not produce any frames and AE will stop react to any integration +### How to repair? + +Remove `{name}` or provide missing file. + + + diff --git a/openpype/hosts/aftereffects/plugins/publish/validate_footage_items.py b/openpype/hosts/aftereffects/plugins/publish/validate_footage_items.py new file mode 100644 index 0000000000..40a08a2c3f --- /dev/null +++ b/openpype/hosts/aftereffects/plugins/publish/validate_footage_items.py @@ -0,0 +1,49 @@ +# -*- coding: utf-8 -*- +"""Validate presence of footage items in composition +Requires: +""" +import os + +import pyblish.api + +from openpype.pipeline import ( + PublishXmlValidationError +) +from openpype.hosts.aftereffects.api import get_stub + + +class ValidateFootageItems(pyblish.api.InstancePlugin): + """ + Validates if FootageItems contained in composition exist. + + AE fails silently and doesn't render anything if footage item file is + missing. This will result in nonresponsiveness of AE UI as it expects + reaction from user, but it will not provide dialog. + This validator tries to check existence of the files. + It will not protect from missing frame in multiframes though + (as AE api doesn't provide this information and it cannot be told how many + frames should be there easily). Missing frame is replaced by placeholder. + """ + + order = pyblish.api.ValidatorOrder + label = "Validate Footage Items" + families = ["render.farm", "render.local", "render"] + hosts = ["aftereffects"] + optional = True + + def process(self, instance): + """Plugin entry point.""" + + comp_id = instance.data["comp_id"] + for footage_item in get_stub().get_items(comps=False, folders=False, + footages=True): + self.log.info(footage_item) + if comp_id not in footage_item.containing_comps: + continue + + path = footage_item.path + if path and not os.path.exists(path): + msg = f"File {path} not found." + formatting = {"name": footage_item.name, "path": path} + raise PublishXmlValidationError(self, msg, + formatting_data=formatting) diff --git a/website/docs/admin_hosts_aftereffects.md b/website/docs/admin_hosts_aftereffects.md index 974428fe06..72fdb32faf 100644 --- a/website/docs/admin_hosts_aftereffects.md +++ b/website/docs/admin_hosts_aftereffects.md @@ -18,6 +18,10 @@ Location: Settings > Project > AfterEffects ## Publish plugins +### Collect Review + +Enable/disable creation of auto instance of review. + ### Validate Scene Settings #### Skip Resolution Check for Tasks @@ -28,6 +32,10 @@ Set regex pattern(s) to look for in a Task name to skip resolution check against Set regex pattern(s) to look for in a Task name to skip `frameStart`, `frameEnd` check against values from DB. +### ValidateContainers + +By default this validator will look loaded items with lower version than latest. This validator is context wide so it must be disabled in Context button. + ### AfterEffects Submit to Deadline * `Use Published scene` - Set to True (green) when Deadline should take published scene as a source instead of uploaded local one. From 651177dedbfe75c03022c2b1f7930fdda5b93315 Mon Sep 17 00:00:00 2001 From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com> Date: Tue, 12 Sep 2023 16:17:22 +0200 Subject: [PATCH 17/36] TVPaint: Fix tool callbacks (#5608) * don't wait for tools to show * use 'deque' instead of 'Queue' --- .../hosts/tvpaint/api/communication_server.py | 24 +++++++++---------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/openpype/hosts/tvpaint/api/communication_server.py b/openpype/hosts/tvpaint/api/communication_server.py index 6f76c25e0c..d67ef8f798 100644 --- a/openpype/hosts/tvpaint/api/communication_server.py +++ b/openpype/hosts/tvpaint/api/communication_server.py @@ -11,7 +11,7 @@ import filecmp import tempfile import threading import shutil -from queue import Queue + from contextlib import closing from aiohttp import web @@ -319,19 +319,19 @@ class QtTVPaintRpc(BaseTVPaintRpc): async def workfiles_tool(self): log.info("Triggering Workfile tool") item = MainThreadItem(self.tools_helper.show_workfiles) - self._execute_in_main_thread(item) + self._execute_in_main_thread(item, wait=False) return async def loader_tool(self): log.info("Triggering Loader tool") item = MainThreadItem(self.tools_helper.show_loader) - self._execute_in_main_thread(item) + self._execute_in_main_thread(item, wait=False) return async def publish_tool(self): log.info("Triggering Publish tool") item = MainThreadItem(self.tools_helper.show_publisher_tool) - self._execute_in_main_thread(item) + self._execute_in_main_thread(item, wait=False) return async def scene_inventory_tool(self): @@ -350,13 +350,13 @@ class QtTVPaintRpc(BaseTVPaintRpc): async def library_loader_tool(self): log.info("Triggering Library loader tool") item = MainThreadItem(self.tools_helper.show_library_loader) - self._execute_in_main_thread(item) + self._execute_in_main_thread(item, wait=False) return async def experimental_tools(self): log.info("Triggering Library loader tool") item = MainThreadItem(self.tools_helper.show_experimental_tools_dialog) - self._execute_in_main_thread(item) + self._execute_in_main_thread(item, wait=False) return async def _async_execute_in_main_thread(self, item, **kwargs): @@ -867,7 +867,7 @@ class QtCommunicator(BaseCommunicator): def __init__(self, qt_app): super().__init__() - self.callback_queue = Queue() + self.callback_queue = collections.deque() self.qt_app = qt_app def _create_routes(self): @@ -880,14 +880,14 @@ class QtCommunicator(BaseCommunicator): def execute_in_main_thread(self, main_thread_item, wait=True): """Add `MainThreadItem` to callback queue and wait for result.""" - self.callback_queue.put(main_thread_item) + self.callback_queue.append(main_thread_item) if wait: return main_thread_item.wait() return async def async_execute_in_main_thread(self, main_thread_item, wait=True): """Add `MainThreadItem` to callback queue and wait for result.""" - self.callback_queue.put(main_thread_item) + self.callback_queue.append(main_thread_item) if wait: return await main_thread_item.async_wait() @@ -904,9 +904,9 @@ class QtCommunicator(BaseCommunicator): self._exit() return None - if self.callback_queue.empty(): - return None - return self.callback_queue.get() + if self.callback_queue: + return self.callback_queue.popleft() + return None def _on_client_connect(self): super()._on_client_connect() From 2142d596038aa37d382f5dd5c5df947ec437f58b Mon Sep 17 00:00:00 2001 From: Ynbot Date: Tue, 12 Sep 2023 14:37:04 +0000 Subject: [PATCH 18/36] [Automated] Release --- CHANGELOG.md | 237 ++++++++++++++++++++++++++++++++++++++++++++ openpype/version.py | 2 +- pyproject.toml | 2 +- 3 files changed, 239 insertions(+), 2 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index c4f9ff57ea..0d7620869b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,6 +1,243 @@ # Changelog +## [3.16.6](https://github.com/ynput/OpenPype/tree/3.16.6) + + +[Full Changelog](https://github.com/ynput/OpenPype/compare/3.16.5...3.16.6) + +### **🆕 New features** + + +
+Workfiles tool: Refactor workfiles tool (for AYON) #5550 + +Refactored workfiles tool to new tool. Separated backend and frontend logic. Refactored logic is AYON-centric and is used only in AYON mode, so it does not affect OpenPype. + + +___ + +
+ + +
+AfterEffects: added validator for missing files in FootageItems #5590 + +Published composition in AE could contain multiple FootageItems as a layers. If FootageItem contains imported file and it doesn't exist, render triggered by Publish process will silently fail and no output is generated. This could cause failure later in the process with unclear reason. (In `ExtractReview`).This PR adds validation to protect from this. + + +___ + +
+ +### **🚀 Enhancements** + + +
+Maya: Yeti Cache Include viewport preview settings from source #5561 + +When publishing and loading yeti caches persist the display output and preview colors + settings to ensure consistency in the view + + +___ + +
+ + +
+Houdini: validate colorspace in review rop #5322 + +Adding a validator that checks if 'OCIO Colorspace' parameter on review rop was set to a valid value.It is a step towards managing colorspace in review ropvalid values are the ones in the dropdown menuthis validator also provides some helper actions This PR is related to #4836 and #4833 + + +___ + +
+ + +
+Colorspace: adding abstraction of publishing related functions #5497 + +The functionality of Colorspace has been abstracted for greater usability. + + +___ + +
+ + +
+Nuke: removing redundant workfile colorspace attributes #5580 + +Nuke root workfile colorspace data type knobs are long time configured automatically via config roles or the default values are also working well. Therefore there is no need for pipeline managed knobs. + + +___ + +
+ + +
+Ftrack: Less verbose logs for Ftrack integration in artist facing logs #5596 + +- Reduce artist-facing logs for component integration for Ftrack +- Avoid "Comment is not set" log in artist facing report for Kitsu and Ftrack +- Remove info log about `ffprobe` inspecting a file (changed to debug log) +- interesting to see however that it ffprobes the same jpeg twice - but maybe once for thumbnail? + + +___ + +
+ +### **🐛 Bug fixes** + + +
+Maya: Fix rig validators for new out_SET and controls_SET names #5595 + +Fix usage of `out_SET` and `controls_SET` since #5310 because they can now be prefixed by the subset name. + + +___ + +
+ + +
+TrayPublisher: set default frame values to sequential data #5530 + +We are inheriting default frame handles and fps data either from project or setting them to 0. This is just for case a production will decide not to injest the sequential representations with asset based metadata. + + +___ + +
+ + +
+Publisher: Screenshot opacity value fix #5576 + +Fix opacity value. + + +___ + +
+ + +
+AfterEffects: fix imports of image sequences #5581 + +#4602 broke imports of image sequences. + + +___ + +
+ + +
+AYON: Fix representation context conversion #5591 + +Do not fix `"folder"` key in representation context until it is needed. + + +___ + +
+ + +
+ayon-nuke: default factory to lists #5594 + +Default factory were missing in settings schemas for complicated objects like lists and it was causing settings to be failing saving. + + +___ + +
+ + +
+Maya: Fix look assigner showing no asset if 'not found' representations are present #5597 + +Fix Maya Look assigner failing to show any content if it finds an invalid container for which it can't find the asset in the current project. (This can happen when e.g. loading something from a library project).There was logic already to avoid this but there was a bug where it used variable `_id` which did not exist and likely had to be `asset_id`.I've fixed that and improved the logged message a bit, e.g.: +``` +// Warning: openpype.hosts.maya.tools.mayalookassigner.commands : Id found on 22 nodes for which no asset is found database, skipping '641d78ec85c3c5b102e836b0' +``` +Example not found representation in Loader:The issue isn't necessarily related to NOT FOUND representations but in essence boils down to finding nodes with asset ids that do not exist in the current project which could very well just be local meshes in your scene.**Note:**I've excluded logging the nodes themselves because that tends to be a very long list of nodes. Only downside to removing that is that it's unclear which nodes are related to that `id`. If there are any ideas on how to still provide a concise informational message about that that'd be great so I could add it. Things I had considered: +- Report the containers, issue here is that it's about asset ids on nodes which don't HAVE to be in containers - it could be local geometry +- Report the namespaces, issue here is that it could be nodes without namespaces (plus potentially not about ALL nodes in a namespace) +- Report the short names of the nodes; it's shorter and readable but still likely a lot of nodes.@tokejepsen @LiborBatek any other ideas? + + +___ + +
+ + +
+Photoshop: fixed blank Flatten image #5600 + +Flatten image is simplified publishing approach where all visible layers are "flatten" and published together. This image could be used as a reference etc.This is implemented by auto creator which wasn't updated after first publish. This would result in missing newly created layers after `auto_image` instance was created. + + +___ + +
+ + +
+Blender: Remove Hardcoded Subset Name for Reviews #5603 + +Fixes hardcoded subset name for Reviews in Blender. + + +___ + +
+ + +
+TVPaint: Fix tool callbacks #5608 + +Do not wait for callback to finish. + + +___ + +
+ +### **🔀 Refactored code** + + +
+Chore: Remove unused variables and cleanup #5588 + +Removing some unused variables. In some cases the unused variables _seemed like they should've been used - maybe?_ so please **double check the code whether it doesn't hint to an already existing bug**.Also tweaked some other small bugs in code + tweaked logging levels. + + +___ + +
+ +### **Merged pull requests** + + +
+Chore: Loader log deprecation warning for 'fname' attribute #5587 + +Since https://github.com/ynput/OpenPype/pull/4602 the `fname` attribute on the `LoaderPlugin` should've been deprecated and set for removal over time. However, no deprecation warning was logged whatsoever and thus one usage appears to have sneaked in (fixed with this PR) and a new one tried to sneak in with a recent PR + + +___ + +
+ + + + ## [3.16.5](https://github.com/ynput/OpenPype/tree/3.16.5) diff --git a/openpype/version.py b/openpype/version.py index b6c56296bc..9d3938dc04 100644 --- a/openpype/version.py +++ b/openpype/version.py @@ -1,3 +1,3 @@ # -*- coding: utf-8 -*- """Package declaring Pype version.""" -__version__ = "3.16.6-nightly.1" +__version__ = "3.16.6" diff --git a/pyproject.toml b/pyproject.toml index 68fbf19c91..f859e1aff4 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "OpenPype" -version = "3.16.5" # OpenPype +version = "3.16.6" # OpenPype description = "Open VFX and Animation pipeline with support." authors = ["OpenPype Team "] license = "MIT License" From 9143703a73931b6a4b0c63d0aa939870186c8c43 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Tue, 12 Sep 2023 14:38:07 +0000 Subject: [PATCH 19/36] chore(): update bug report / version --- .github/ISSUE_TEMPLATE/bug_report.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml index 7a39103859..eb8053f2b3 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yml +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -35,6 +35,7 @@ body: label: Version description: What version are you running? Look to OpenPype Tray options: + - 3.16.6 - 3.16.6-nightly.1 - 3.16.5 - 3.16.5-nightly.5 @@ -134,7 +135,6 @@ body: - 3.14.9-nightly.5 - 3.14.9-nightly.4 - 3.14.9-nightly.3 - - 3.14.9-nightly.2 validations: required: true - type: dropdown From df96f085f2e21d4a3c8a2cb5e3d33001eb40b99d Mon Sep 17 00:00:00 2001 From: Ynbot Date: Wed, 13 Sep 2023 03:24:29 +0000 Subject: [PATCH 20/36] [Automated] Bump version --- openpype/version.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/openpype/version.py b/openpype/version.py index 9d3938dc04..c4a87e7843 100644 --- a/openpype/version.py +++ b/openpype/version.py @@ -1,3 +1,3 @@ # -*- coding: utf-8 -*- """Package declaring Pype version.""" -__version__ = "3.16.6" +__version__ = "3.16.7-nightly.1" From 5de7dc96dda39f51e0664bbd3e572639cf3d3130 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Wed, 13 Sep 2023 03:25:10 +0000 Subject: [PATCH 21/36] chore(): update bug report / version --- .github/ISSUE_TEMPLATE/bug_report.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml index eb8053f2b3..35564c2bf0 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yml +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -35,6 +35,7 @@ body: label: Version description: What version are you running? Look to OpenPype Tray options: + - 3.16.7-nightly.1 - 3.16.6 - 3.16.6-nightly.1 - 3.16.5 @@ -134,7 +135,6 @@ body: - 3.14.9 - 3.14.9-nightly.5 - 3.14.9-nightly.4 - - 3.14.9-nightly.3 validations: required: true - type: dropdown From 9369d4d931f8bd9f7e02e480099d64a4bb89f9b9 Mon Sep 17 00:00:00 2001 From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com> Date: Wed, 13 Sep 2023 09:46:48 +0200 Subject: [PATCH 22/36] plugin does recreate menu items when reopened (#5610) --- .../tvpaint_plugin/plugin_code/library.cpp | 106 +++++++++--------- .../windows_x64/plugin/OpenPypePlugin.dll | Bin 5811200 -> 5811200 bytes .../windows_x86/plugin/OpenPypePlugin.dll | Bin 5571072 -> 5571072 bytes 3 files changed, 56 insertions(+), 50 deletions(-) diff --git a/openpype/hosts/tvpaint/tvpaint_plugin/plugin_code/library.cpp b/openpype/hosts/tvpaint/tvpaint_plugin/plugin_code/library.cpp index 88106bc770..ec45a45123 100644 --- a/openpype/hosts/tvpaint/tvpaint_plugin/plugin_code/library.cpp +++ b/openpype/hosts/tvpaint/tvpaint_plugin/plugin_code/library.cpp @@ -573,56 +573,6 @@ void FAR PASCAL PI_Close( PIFilter* iFilter ) } -/**************************************************************************************/ -// we have something to do ! - -int FAR PASCAL PI_Parameters( PIFilter* iFilter, char* iArg ) -{ - if( !iArg ) - { - - // If the requester is not open, we open it. - if( Data.mReq == 0) - { - // Create empty requester because menu items are defined with - // `define_menu` callback - DWORD req = TVOpenFilterReqEx( - iFilter, - 185, - 20, - NULL, - NULL, - PIRF_STANDARD_REQ | PIRF_COLLAPSABLE_REQ, - FILTERREQ_NO_TBAR - ); - if( req == 0 ) - { - TVWarning( iFilter, TXT_REQUESTER_ERROR ); - return 0; - } - - - Data.mReq = req; - // This is a very simple requester, so we create it's content right here instead - // of waiting for the PICBREQ_OPEN message... - // Not recommended for more complex requesters. (see the other examples) - - // Sets the title of the requester. - TVSetReqTitle( iFilter, Data.mReq, TXT_REQUESTER ); - // Request to listen to ticks - TVGrabTicks(iFilter, req, PITICKS_FLAG_ON); - } - else - { - // If it is already open, we just put it on front of all other requesters. - TVReqToFront( iFilter, Data.mReq ); - } - } - - return 1; -} - - int newMenuItemsProcess(PIFilter* iFilter) { // Menu items defined with `define_menu` should be propagated. @@ -702,6 +652,62 @@ int newMenuItemsProcess(PIFilter* iFilter) { return 1; } + +/**************************************************************************************/ +// we have something to do ! + +int FAR PASCAL PI_Parameters( PIFilter* iFilter, char* iArg ) +{ + if( !iArg ) + { + + // If the requester is not open, we open it. + if( Data.mReq == 0) + { + // Create empty requester because menu items are defined with + // `define_menu` callback + DWORD req = TVOpenFilterReqEx( + iFilter, + 185, + 20, + NULL, + NULL, + PIRF_STANDARD_REQ | PIRF_COLLAPSABLE_REQ, + FILTERREQ_NO_TBAR + ); + if( req == 0 ) + { + TVWarning( iFilter, TXT_REQUESTER_ERROR ); + return 0; + } + + Data.mReq = req; + + // This is a very simple requester, so we create it's content right here instead + // of waiting for the PICBREQ_OPEN message... + // Not recommended for more complex requesters. (see the other examples) + + // Sets the title of the requester. + TVSetReqTitle( iFilter, Data.mReq, TXT_REQUESTER ); + // Request to listen to ticks + TVGrabTicks(iFilter, req, PITICKS_FLAG_ON); + + if ( Data.firstParams == true ) { + Data.firstParams = false; + } else { + newMenuItemsProcess(iFilter); + } + } + else + { + // If it is already open, we just put it on front of all other requesters. + TVReqToFront( iFilter, Data.mReq ); + } + } + + return 1; +} + /**************************************************************************************/ // something happened that needs our attention. // Global variable where current button up data are stored diff --git a/openpype/hosts/tvpaint/tvpaint_plugin/plugin_files/windows_x64/plugin/OpenPypePlugin.dll b/openpype/hosts/tvpaint/tvpaint_plugin/plugin_files/windows_x64/plugin/OpenPypePlugin.dll index 7081778beee266e9b08d20ba7e48710dd7c4f20c..9c6e969e24601f3686477dfe6d7127561f2a3d9a 100644 GIT binary patch delta 102578 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 delta 102519 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 *Se&+ey$67@Jm_y**9-A6__l_Z!+$mA~tGn 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 diff --git a/openpype/hosts/tvpaint/tvpaint_plugin/plugin_files/windows_x86/plugin/OpenPypePlugin.dll b/openpype/hosts/tvpaint/tvpaint_plugin/plugin_files/windows_x86/plugin/OpenPypePlugin.dll index 0f2afec245f7f73ec3a8d0f72b5892653f5d51cd..b573476a21d7fd73ea1e4b4a53794377954fd845 100644 GIT binary patch delta 108350 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úl`=?-?uIQ>)<~_KXD}Pc7LfyFP38jG-ZCa?IXkf1 z#eSHp@B1Ig^}C}p1aHvNr3Qh5ms zOf|PgmWb2c-Q(0tfG}j`Y?#o)eOHYdc^kI$#L^G%2=49WE)b&%y>+YVA^O#P~6|MTA5#tAdfMz9T+7ALLTm)22LKIS}Tx3n*jAZ$cf>hJv?Xa?{3{Vc#HOJ8PIM*CF)ka z)HvybDyc@Qs5b!SvPACz?sWL@EFlgNBcOJ%$!&Vz^TPJ__z5>2x2H8F7zwjhby@!}Kxp0QX5 zmsQOmqhmpSLisiw#0rBy0vWF3K#Kiicp^vG^FWSNbw1I2eIR#q_P^?WJ7F-)XF!~{ zG7U}!()(!((){Cw$6r+ZKg@pz^J4RjZbzqY;Q~u|6sTMWf>p=7HnJHZ z`a`hX&M>z#jarsb%LdXV{v$qX_y-I=3}pY9Z}X#0f%{7f3Ci;q6Rp%o01US6jzXY0B8_H23)4#TZ=aah}0^AR`boe33!hNa?FO zvyey_jzyZCT%N1V*u0GucDk519CcPT-0f9`XQ}YpVWf5PTxZ+|(i0z0-9{{JWIB$+ zMxc>fBea-fgcvtMt#9Wc87t7Y013-p*LU$8lfquZdR`YzMq-I+yOpqQ5u=3R>=W_79(QND4gyEMVrw$X=l<{6I+ zGu+=|_{j!s*D62KnN|VWEUd7YnC?zW^nak!Qw*j88Rs-0o#W`c;5NPU$@|WgP~!%% z8+u;P0-bLQpgrpSW#l|x;so5E;r4Y(HM4P=!5e|JehZMro(xppi`f}CP!5`S=NQZd zQasP_`3AR(;bYKNvP}3>4WKAkB;fsBQ&8 zDDTmUe++-X;2|KLIBNLg2LCT7BF2emoD&f^ab~Q$RYHa7e&wRgP3Voc7&hZ|G43Yx zl1ecT$ztpvccU7ZKW{>J!1R8T8(#$-CHjnWcSB(B9mi>~k1kA+SOFG&W*5Ng>#I`} zfp+=-x>Gk?{w}=6G;#HKbovY99j7Hz)~@0(SKp3(S6ikC9sd{FGjbdT?Jo%)D)FOazR{r_U$~&)o_V)B&1Ps!(DN^;u6_%$z>wb zGNc|gHDa)QH79axG|M8ia!ef}8_6;WmqD~7Ttc*Fe&^m}^S*EI>*w?1>v_)qoc~$= zXSr~>Q1i1aeTnhTBChs!;b;DF0T#%)AZ<$?NM|$O`;lf>r?7wpX?8tGvl~4n6Bp>B z_rpEi3DWGpcnk43u5^9)@jj3~ranXT-pTZhoLuo~IJ*j@kE=miX)Q>bO#e}~I~-15 zWzTPcG=lD8&s#D6CW5@_mK7D(O9V#R14b+eJB7co8sQa8`C^oxwY zal?+}z`?MeT#))%0b**sHsgIg+m^A+!z}X)Z}4~oEMFEbqnCNh#v^3vS-R2Nh3pRe zN8xM&-U+}H-oxX4-J$~J;jG8K4ihlcMI*x#w4Je(ai2GKg6|D~{n&7JBO`|cfQ~@| zV@ojfk{P5orA{DqNc%r#ZaCs&#`@YO%?#I5KZDf=(y_aXJ#WSMiMMv5PwLZ-nbosR zwh;`Ov*)cCKk+V7^9QoRwI(nofz(`LX~Kx@agt9Oc$P(e8RKD)nt#F4Uo+kb^(+>p zvsjb{ymu$j*k(~$`lrIRYF@=y4br%&1?kDbVJs)*JxjmBcqg(; zy^GUurj&XerX!$p9|$|k0_mj90%^|!-dJR}&YBP&WSW)db)O!(BfgCsT>npp$`57b z!BBZHT)z7ZSOvThGw@@qia^+^6r@)B7|TG~*2CTbSPMK}!qP~H0jXIh#srX>C9(W^ zGaUboUffLj5`-lWdn0DzRlrm>JATGtAZ^kpmLA85U${o;K2zE3_!)G{QGsqdi`gkSRN~u&x);M#WwuE#hyj6d1=@WXpLh)>MaYT-e!S!yisms=|zlB zfuYlmrC((HwN?M?6$brIwB`Mn?MnzAVIIMdM=<0O{2v}!dJ*GOV8|m&zsUH1d883k zS{C-R54>|2mgHi0D9iSB?GRwOx&JM<%IlsTy7IN1gR?fq3YYI>c|+#lepTcx#N()H z5`J9kZJUEgyUOOeg0Tvuy*bO$ml(0j%tfSKWpiD@SOtd6S^5$qcA2?|w5e<#@G}kr z=@^Y->2ZwMWl;NIKlVl1^#rz0CNc6LEvB>ldUmokvXhNF5FR3G)74uz58ry^*?mDT z_h!t)j$HpyxZ921#(DG}y5K*XLRqLpR1q7m?cPmTMDX*yUh`2fz#iv%W9R!u4_uFe zw21-6T#&k5!P3t${<>9t$Yv3w(NgC9I6rh9j$hy#X=JhUV-`qr^BDsmtu+^Zhd@(z0Udp%+q~-@%`ZLBmJx^ehl*A^92WcGBe%|osCH;8>S9b=!%p+XRqSOveB(TpvaBW-*gl%p~9)K*`tyR$&sWkpEzB z)1$tn(QT{QZ-iU{>Cj#Ao?eas#5+%x`$i`6E!nS2fwUcdkT!D|NS&s&^zL2Z>l~5T z)iYQ4?rpZs8@s~SCF)vNyj>t3(dIq*UaOA2E(!S6N(cowFJXnRQ^cVDA^V8R5IZ-2 zYe00&aqs2|pVsUZPgvr@mzz&MJ_gJQmcPDgR;pqOu?xP&vXf%2;Ho1#~Bmy654Dom28B`AiB0(t79E7s&#s?fj z{ua?(Da5ygZ4h5#qEHyBhy2la2yv}o1SRP{Qv($lnGZgbc;tjVu9Z z9aIWcLosbpE*8()p|19D4pl&D9bf~k!!#E`ovZOB;o0U~!q?~#ln0eT+&9k*h;I%3 z4r&9%Ky9H|s2$WE>HysXb%Z)WaZqQd3)B^ghwg>CK?zWIC=t33>H+nHdO^LRB&ZLR z4E2TjLH(ft(ESh(36Ka$kPIo13TcoI8ITDP$bxLhfn3NB4TJ_k4?roi zm3*YIQiv2+ijh($$uE^iJ>-@0IXOjXp%$v=)M;9Y)?P2sI~szq*BEL}4w~o8404Xh zR*4m9XV{1A6z7nW;+D9m4Xb205XoooC-@BEoRA_O5>rrVq+BRxDCd-EYNS@ErRarv zq_NVtW|WwbWF?8TR-&$zcBHe|iF6mchiF|0_VM_d!WZ(}`7-__pCXJA0z&W^VJq6( zN#w;6QI-m&Ytmx*n!H%KhRV;WDcT-QM)mED5>%gJ7Q(?El40$!de|j)52pl8MfC_; z4*O$!zP*qnj1*=FPYQ*?pM}FhjgTSE5?>Hs7Y~Rh#2>_#QX+gr%G2Z%=)fLD4XT6H zO=^icL|dT!QF}@IOjGqC`W$_|{tx}EezzeSBaKPMQX}8kX6!INGw#8ZB$`R)08=-I zm{ZJU=0@|+<}veI^MZNVY%m+mU(m#85<~7GT}dKIA_FjSCh?OYWH?DDW5`4@jbxJm zSxTND%SkYwJWmSACQ?LRCvTG7WFPr}93r2Qi^R1awGLUe)(>`pv)eiA#JR5fdv~%s z&wbK;9uxGgd))of{o4KB{mJDLuuL%mllZy(dj1uD4}XEb!Z-2FgziFbp}!yrhTsZA zgb_l9Fiw~v%*N2?3VA|)5CgSEC>FL0yM_0Kqrx}BW#PKeOYA3#qAogOiujP2E{+wm z#F^rJaf$e(xJq0rZVq*-Abp$H`feW(BP^)-G$e^_f*+oeo;}*?sLydzzht zh}~>owtunrIoF*w?m%~}Z?z2V+=IX;@Bf1%yS+k7TJkAIwhnSYH}1P8;q zTzDCycue?*a7OrExFNI`{FYoUAC`|JDo@GP@&);_+#ol~zsQkFv=W2fcU2OVBxQgiE2iRChA6|8bY+Y( zQJJP>D*j6|_rX-7D^v&7lroOFC{3RZEkTj@5qIAplZ zSjQRyZ6|+??<}MXFCcDui>cx=afetVMoYt`0?hIVxj?RzW0jH0N;I#9I#kWZN;{%9 zsi|6lR;k76nR>AvtkDy(zz(2g_nR}#)#j(>PiAj2n!G`dU?Y*OXRMRhOp-B0tL@!r zR)Zbuh|UyewNvgiIGx>8H^(hN)0*felNQar2_*7^_-wv_FXwCcL?Knk5eg9Al|qBi zSsWxz5toa_VmX=`AtieM^>Ie4V2ur8xmK!zLM6=CJW~JF=rjlg{vO3b+8jWV}wSKln*vsr4_9;8s zF`aDetMOR6#V(f>jgL~q2eu)Kj`974wLxLOP$$HSrkE{m!jftxB}*%$9nwWfkcY}a z`BV8v4CFNISLYO4-GXM=+7|5;cE*+Z9=%deHl`WHMw20%Yt18Of3g;1*WX%e9kG%T z*az%*C(}6q=b7#SmkZ!eBEWe(g1DHk!}tsmg3k-z3IoKa#N*<aY`_kA)`&Gtb1_E4M`n<> zNVGK^XTd3}yZx~JG|ra$oma88bT{9!hcZZsk~|R=xEH^!}*bWG6dwoo&t$tf&$0D)&Qd-&_&?%0(~~3?|z3 z4&NQodQq4xevYZwE>%hmQY=ChgfZpmaP?I zQkt}6eTn{#UZY1FgAt(n5f`qx$}GnnqAlq{dXoD|Dw&MK=S^~o46!a-H?81N`!1)o zGvC3d3A>Zrx7lv||Gzp>EB$@JiGEw#`oiH8oIJV0*Q!mp^ zqs;J|WjKP9NhUc-R^X0s%F^vO>=W3^4mus(huk&pJ8rpqfp)GUyp6^2sr)iNSciQq zRX8YI6FP}K#c|>`>|%qY9BGsEjnq$GgK&(%j<8fIQg$g9lxTI3I$h0Cx2ikUGwNmB z9Y$$uw2fK|y}xeiMS3@5j*)A`nd#noyXk(j1+g&KhltM_Z>_dk*nhC6+6(M2;d%nL zq_*xi@E63pMng+uB!86u3R}W6f-F{vJ*2hL-LfT5NAPWzzr@aXw<2O!+@V~>Opgxj zh?VMXHCbDx?bmK=J#|sf*RNw=OgD0jO~yZs_U4w*&X|n(Uqkkjo5ZlDV@I=M4W$LZL*HYx{{BTBmZvHCp@9$uS(RZ^s# z)Ouj)ditxnY-Ab>jhQbP<;G#7(x}3IUTZX9E#GanGkchQ%%Nt6IT1Vj0`m#;X|vee zWgf>}uNJc!L3~6b1Ia^V6q!Qi;TpGjuAhSsSvt`T+^?k5hOW8SJ7NeF|T0M z_vCr}7ahUjxF2vFha-N#DI5;@0WadP-w${#hdqA4yE*Le13t!K^Y3ug=zOfml|ttB zGB?71>L)X0iP*|C!la`4yrv@7s@s)YVlUG;LxmBq=%TccdR0m>RH$>X;$>xJrPR}O zk)fs+N13nuBe~MTt%{4hl{hI^<-m$-v30{C4{RK&I2pUu^{ar4xK}ED@aVN1bSMMQ zM;le-d@2dX_N0OW#@#C(!-@?Ny#G?=gRzU8&k-V(+Bz56!xVq|D8agVvIl=WQ)P$UL~T7jaY0R2fAxn?fHSsgBaG zY88^E#8#b5Mk>#${!K!Z+ZN8mK`&ODA>c4`tV;}k8|w8o8wfquOzBhO2&t@C*L*|z z>WyvJ5M(UNE}0MOQmcuu^1X>R?4(-L$ReevRtx&aJH^ZXA<0p!9Xy0xZ%f-F9XyDv zfI}C-0;>jmqP7aHeU13&3u^BYNVGDi?i$12`HH^YP_kRGcCJVEE3KW~%=SJrF-rYI zoONuxNr-y#nKH$>Mzi6DI-ORxTti3;C_EkTn9K`MLrw?$OHT*fHd1?+?>kO8=Uh*? z_tXTYZ<8#Er&7ViE=(v-NvENwOuKC~{$5(ZeWYJ8Mi-*qQ#lK|vaFY8W5_c;g2wN3l5S07qwI(mQ_;Ly2$uoSuXcTw0=%~drAv^lx)}4yy(#I2rqPv zF5+SoH2Orsm5Xl9xL}{$?i<=Y`YWCu7TV9zyvXrbV1OE50M(L|Dioly{K?+^%VBLshAm#cSX@Nqit=pCMmlmWR@PFs#ciTjvy>iVHxQzH z8oQ8;)z2PxmoMh<@$SS&SvI~Qsi;3O{x^!+mXHuk1}eGucc$Jt(VbGYwbEhoLZMfN z3A`I2S%A5TP9lw!50mx8MxQmsfe6EvqLAC8x$;vUPpyLwY&`7`LL}vUQYU*NoF zo}RBaoqj+dYn9xYCA6@OK5v#gso?dCL7CD6U6coI)zG$B&FO9Gz7EAolPVO(Ik##4 zBBl4-F7)#nWy4%YDrM4WcNOEd992Hl&&MWZ(%MTs|jQ z>0!Ybw2yv@ZgCQ~W{cP0U*{!nc$JO9t3bI#jPy}U%?R;O5|+KJc5H@5z!ZhMl#e(i zAtRSQnXdRjGn&^{p9oz@wLvKwp2K$~C~m71W_}|sVBLhel8K72d?@LoL@lpRB9+C< z1IijED8h;l+(NEsOfQaC8mv5z7P4q%eR@4!sk6$TzHO&OuNpuGDW_ItkT%MI)iwCC ztPUli%Ei^e;Nl=`~rlyGJz3Cp;A?vJrL}|9Ep}x+RVcL(qTmL{A$!@5u-yTcV zp?dQjR;Zu;ip$OtlYd8)&Wy6QvK4Vrf_7aMO|VY6YhuGyaCbjKvh_>${6^@V;YtU6 zM`iIIYkjtU9icaeDxH6CL2Q&czxN<^%FW*oapl|BgH%%f+INT~Dp{k-|edo#A#97Hd`AKPZvW;FkRfXcS=xuT(f*z<=o((Zlyz_3OiK}*|2?^H+orxx7 zyt4bO6$(b~*=sbvqq6GUSL1nIOpMZpPgNRwSQ4GW&Z}gmvi5=%st&vG1&#UMixmj6 zb@-AK_Ir3~7_L`P{%<%#|K``Fd7bo*mrV#Q3RI3ReJ$ zR?}mh7Nx$7Lv!q^OfB3`k9+IAZ}{VyC{u6RlPUU@H}4aYrA)i+i&gCQWwJs)?~Vr% zS~W3&HhGervB|tHPU3SkHg{_a9~&DgYv^m;^Fb5ZMd@>YrgS6-byHba*-9z8Ka12- zrac&elkn`p3QLWa@F-Ob!5YQwQDY_f zaR@!vUb+0(QaSyozGC(yme}j3J~>OcqIP(e#EU$w=%DW8P_cTE`-0~S4eH(JWfGdR zf|t9vYkd_=sZTd(Ub%v;^7oq|rN8Zz32z7gsDHcU`|pkK_R=^5zMX!;`*qxpSpRK? zLw8eLK3?QSu~y`LT7ZzgPf<5Qi@Pb=#YtG`T|TcAD*f%sO_^!B=shU>B+if}x{_!A zX48tU{Go8Uv%Y4d0T21s3@2pHw+LdUsNdSqOI4KmCEg@M8C-IJ-ZKB)j_f0reayFR*g#N4vVv5DM-|CdQi&}vC0zu1*9LBzkp^Th7@HGUG8;V2v9&tf zH7EAM=Mr5;6|$Wq!;UJXBk^NJRY))N$X}tW1sP0VR%5#@h$SJBaJm}#gTz9bC9x-6 zV4EdbPw#$#U@LNwtbkh9NO=r&vL^LO0F1XLO-LMMS(9~SCv>zSwaI)KX+uir@gj(= zPQqwGWjIxxq>;_gy#~^o4P$GNWAw{M=2??mC-l_^sAxwV=(!K9ksUz=`}m&u)FOij zSqhoX)fQg36WiKOWi2s2hU#kH;Sd8X zG8YfxN}CS)q%%tE;^c?2GB3e=P`KxL_3%?Zh{p+?kvjaAuACN?dY|GDnA?QZBOPE@ z6SA1}gSMVH+YT_N32`QgknBk&o2~oX&{5MnzwXeX8MfU94=>VPtd4CE;7PoN5Y-2c zdXXNc^FI6-2flie#v~hpo01;%^Lt43B50`L9)eaQ-v7Yk7DkKpz}O3^&xJ9~2vk}6 zt_($MeXF(NBzuz-dh0DLK4)wN1>VG&78hptkT9|RTjZyrH)$;NQKMm@59venp!$#; zQWe(u5_kIW8eH*3865+oo0DK-&yF-Fn+Tc2hP5PX2)%KMNv+9hLVVfAHdsM^W&UkR zCZR^>ASsDdXGQIZj?xv6ls%&@NgT5dKpheNaY5j(cBC)U2aysYs&^5V1IR#T(TThx za>i}`9MCU_G+`~fkQ&(ICSn}uNIY43H)2Aoh=o5tsX1hYkSAmfq<1Ht6>eTHYlVK@ zNMrU-cT^`TAAtqkNqq?ENlYrY{nLP=%~J@A>PhCKp*qMhoWVAfR21W{;E?CKlc|su zO77Cl`?cP?!?5>*{Bpe)vD`3%R>&$x!|>}%OvLV&uy>>s6lkNDT;8>*0?u)t@~GCvzwn4I>7lR5`s8W269HtKXj_jr(cZ1<0$x^Z(zKlc@P!Vd!;!qQzRV>+Lk&jEq zDQZJ`gs4XkLgmqz%+YOx)}u)cv-na3jufU2hi;?Dj;ic{p;yE24DN+WqfzVLtT%Kr z?^oKcG1TV(1dl>TFnu)HT6NBTLsvg+;{O|}$jBICT_GIn(>s&YKb*jRG_f|Wk@lr~ zn7SLLjv;m~)ys7XQ!65r=I`Vu_&fO{2_NCK_M9Jb*zqys4`bp9vlGxBjfb2Ba*24u z+(cZfO0Yc?2{>_#G4MbU4tsiZMvPa(ae)!R|bVft^96&mk8(})Ljm`ZxlZ`ktoPDAj>R#-iibflM-K>Z}rlh)b_t*2qLJLDxH;iN5` zFiAo4RWyy%g#pQ=B3TI0$z;DcDH~O7RuXB)D^ifw-7Kh;Oj<+Bsl*iPOs12bQtPZT z&cHhbxd?{r>4>^|Gv}-$*##YDAoy()X9^jet}!};1fmOdPbDcRz`IjPH3uE&jD*uM zMlr)I3VMX7pEGnuF-FlwXP37~EAA1d_GOP#NfIHQVCXC|gm08&<3QD$)$iJ{F6quaUgp>QOGoCnNDip#AVGVjxaf$#Fpaii^qv9_mZJLQfblX^%0UpZ43#H0 z6pEK&Owj{2We_LQ2+n4ZF2oY7fo!cZe3HR{q>HOCA!Zb!)`crTx>ptcQ++ZKnr4y^ zG8Sg@!T}00QI6jxfbLhcjcXz7SM=m@Fozd@z2zmg7R$L4_5l@6gsRS7$N#W;Tm!mqcOIY{6#;6u?_1`C`b_OUQgbW>9An~ve%Qn-@u*M z5?Hbcom@}$a1-}w8(?}CKFdLNC5v1oBndWeK~Lz&+HK{??cm`yM0R9NwsYj3aCrwJ zr$U{bZc!_kbBMgM*wx=qV@LyQ zego(EFgZ)F^n;#9NPC*y4}9(*Ge?e)Y>XJAj*{iLF=g~PnS>h>n0kUVE!&y0vnNOl zp>KLYvp+Bm(`=IyJNpM&NnrCI#0{37CUL_1jyk2vj-Jpj7Z>BLf0j)iA!ZdrG#<3^ zUBLMaxh~cV))^^n-y8h?S+bDFyIJSRK>FSvRmuEkv+RW%#b5i zbdkr3e#|7BRkQTvZ(7EJ@PuD zI~SsOV^mp4KEcxhL}oWQ@>_pae3QroEl9~NVvRCneVg1vi7&d1%`V`52PZm`8Q;Y= zL29mp#cn26;C+w0uq3`eX1UBiXYvk?(CUtswojMQA%iAThS(2iaPEYb()6EXqA`NSs}2z+S*u20daxIoZTaz(7r1T9;Y ztHeUtUD+7CpOI%&YMgPKSm8{1tE4L#2eVXi949j9IYL8V*>i*vA?z=VsRkRR}#`Z)i3C)!9HnxvaCqXUTd;{Lx*$d`HgW^RoBEpZ;S9 zU*D56Xr*#LAg?))`#17h+!pdal8anmU5asy4u2xQqTGiS;i{la6_cAJn$gd=!N3VH z{ep%p6PkP>LxsUsI;CTNAl&_e=J19cbomDtAg>dP|A*)Z&9;R~Ux*WK_hG}oWQg$2 zLc{L%mBf+}aPTW>LDhk*_$zMPPzmRha9Q;LT+5f14%X$CU6by&{$N9CNflG8(x$R% z<|0suh@YyJihU#t5~(GjxfT#EQAgx`hD1ez&R~vA8zAp{WjaK7Xrgg5(3nP(a5!yD zT{-I?j47^HBXgK5)B2osM-w_&7-y^@UofH3^mS$CU4b4YWt(cSG^Ojl1Am&*J!Jsf zREah-Mh0$IqX~rOQ|N6)2M7nl4a;xE&RWq?__RjgYeRiVO*YPkrV+Fl->TCbR4i75 zdJ(dMy{t)bhPJ>IJK9Y6XHZ#ZJ31A!OrN2HJ$1v7Ho=~bC;iz=`%>iEht-|n$59@LhU_WvE)HK9vObB3?)unL|Ok9~AQl)2XS z%(xl7M(Le5aK{H}r?ZB>^e>91GGNn^)**+WMN2yJJJ=A;AxM0{yA`b?th#D!IJ1Go zRq zBDB9$I{d}9REPGZpe=Iv^PT%bYP8<9L$hWF1?_1) z`uRMs`(4OCYYeLwh&G}af^qj%f7*~1oda}yj`Yeos24zYli^ShKbW0dU2r*R@i5l48;vJqC>#%_&7pHQ zT9-M5aA7)?3lZIEGc>Hw9Yq^WPY-1B+;HaEgQlQAhu?bAR>YOP?@413`y@p4rp@Tc zNU)2eHn6)l9a6i>NnPgE6dY0-Z-lS13rt=9km4HG)x>sCG(kyWp|S4BtkC$^qGzeR~!p-r=wO`LFF0Lj&x=XXV6~=hPN!0`jc(! z-&D@zUKlrvdeIl7AbS>_X7_E$593& zPmJ`9c@^&jk3ooPLIzKui*`XvG9Zh7fxt~T&cbXQr&2Tw%))WnY{79(Z^m(?Q#DwNt$30Iq1iajnr%1^ zJr>8*?Wj0p6Xfiq59rB}uwoZIZ}Kt5*l1+lu(U6*_?v7G3wP6S+;6_#jW*03D(}Ha zpdvKcL*2eHlgN*&OJ+jmM zAT~zE{%C~P2WV&d2A|;&ePt|at)P_ zBCShNaPSz?dK&qog|mPO?}FplF_Jl+p!JA&v$wGp=0e0toFfxRIY|eh-rwg%NAUXt zt-|x6u$9Wm2u(CcxoT7oWL%e3*Po1JQaoh0V6iOz~0p?;HvIq|4(hc-{2N;}( zA;n@?kw;I^)4?$440_9#;jsG*ZAyNJr)SWzCo#LTv@Zrm@htHiP7j*8L+5ER?jU}@ zfKk+`b}afL?Lf#B*mH^YM#pBHPwx>Q_AH;aAjE_@UZJ?Dz%0^L>PauQfd{3 zB8V=i=qg=dx!B*JREAwz+5RCKvaV5}uUdfLpR_S)!N&bbD-!IHbe(!xPHN7lP4}Wk z+Jy7z0fnI&x4-d%;+geZSJw0uJ&s4}6It;ax{_Elv-|HOn6s>RC~WZQ4SK_dA232C zb=a1_(Q~4FJo`w;kyWhUC!DHE4%WP{#@||CMJRAGyepzJF~cyim>$ze4ERi^5&F)8 z-TJ~UiAMHcZiOA#wy)o-{{4piNT=VY3jw7_xOKyw`fwI02ocnhUQS%I~HCl9+|T6IM2Q3RuHk(^Bpp+&X)Z?Yk}DtAp_Jd3Kq(e0sL0 z5MR_fUnYZ(i_nChs<{X+>9uFjx4zIs%zPsoDQ$|Zzqi}Mt@^@CG7Rz>2%e(LYpofB z8f#aX6|k_+b=V;3nV!(1Q$jp&j{+wRabAqj_{Hbnp-yNgBj@2sh~)1RD$X!oquo zuI}(_W1$gFW^QA|F@+b6g^^`AJa^GV7+nU^H+R6qQy5hSV>FuSiP#@*gXASN#!Z#C zm(U(JJyX2!b{qlMrosjuDKr&==&@;V;f1jc^JpeG6Z7*A46AywRIfZ(l(*29+u$ue zf*08N3YPHRM{vcIX)Rx&4XpANEFjKTXe4}nEgNn{D2(|E$#{PbH(0_klZLl6DG_-i zy_&>qS_|QL4TB}L5ylY2dgdp55mJ*Yz>zs7R_se#VHzRZA+bFQ?4x9+Z!fGO^y*dU z5g>T+ZO7aIAzUKi>{%z_qKM}J`+|iAczpUGSg@>+S%_oxeu?H=S?AVJC^;r;8W#{E ze4=lULaXjVeQTEj*(iP10E|L&XZ69qw$>HRL)5A;t-H{aOk(=(_;9%P_j(8otY`hn zaXk#U4Zq`#0f(M~CoMb-y?df~ZG^c!h3E9ZAp?Dz_gDWf`nRvbZ@q-89Jx2@!nFe$ zvgwuo3;EM!sNGX=)$ROTQqrTlItVU=3LS|hvkpV8v3AY>zxr6hT6h$?_7!Sl zI5MU$uI=3!ET^wI*N13X|#S?GQCgxJW;3Ga#V> z7(86Cq&6pinxpA#+i+nBq0^5WNMMlX6eYBxC-%V5D4Y%}m=%R$Y{PP+gh4{H-5X?n zfMD*7N7(UV+S{}*C7$ZyU2^$Dh8YN!9WuP_5vo4i0Ru(~E{-wS7tgP4Fud!JXV;5% z@QJOaMHreJz}(wN;ZGrJy9^6oVcJiJJ2BxoPi&78EHPCBql8x$YqlEnqFnxX5rfeJ z`s%bTT8l<(5z87Q7!zSawhZJpv82~iSzergnc9}1jzwcz2^NeK-07X);pjNQ4MT(1 z2y*p|$D%8Aa?2~Q)gBBpUO!jO6a$-0-SR{NyIB2neIpaJ(Hg}28 z4Gjbe+7We9sjyvNBptPpzft^2B#!mnfo^InB>Vu;&U3*G4MS(w4Y zB=Nb`f(sGg@6|#AH?nI`p43@PT_c1NehXrq&=X@+Wu4HHo|_Gq*P#XQWyb5dVH(L2 zHgHB(%!UreqBGpvi0X81Hgnk|VDK3X!!`>iF`?^{C5*+K>GCX`JDJ-OvpNb zwKE~=pjPX0NLWq(mc22+>y8Gud-9=#~bsEwd^?FW7 zMNFO05VaRVxpTI6=5Y+x=@{n!~=ULLBMGoUh^f z)4AzTSjpG{)a$}dE=C17>dkZ(UC8IPCv3cdE)|{p4K#IDV09B0ZUij2DX8@30!X|i zJSNLw&uzg1^B`ky;{pY0P&;<&wqQACU#pzmLe^;>X{?LQhm7e;4)_^poA~CJcq4MoFO4|cHQty8=3H0J9 z7V4VvDEnZ}UEvZp0gr@M7&I@tC#2&wA;ZVHWo9 zC&CgOc+OKC_*7eV>Z#D3VwT_fIZ9}u4Dn8!27nV(V6vGn;OB=Iumi?Fk_-WeADBg~=tMa<@392FU5UvVIMYY}9Ypo_S* zXj!!QjnrpRM7%_>^cKW>1kY=%C2=cm@J>kLFia#m%i=;T7%ws*$XG-(1ka4cg*0z5 zBOuLYiLYpu61mob!@41Y$d*-=a)foDT~C}H%+2-`9WeSR?kVm>A;{{5lM~H?dW(*P9zOuFp<)wZ)(HtNFTvv%REtpY z9?i*QnPFmGf)|O7^btL+njHH+49_=cp-D6|?u$hDcA}r?DV#b|N~1C)^g|k-GNDg@ z@imsL!vL{0z6Sww2I2$s2kUSwG9W8lETQVJkUdCjg)zv}LE=rE_2UtuCuX-kMu=_k zYLfS0MD5FR2Xk2+3`Ik5-EA_tmb!rXFfkI-jtRq1(CCfj%q0?^8!eu96t3G~u#U#n z#g~yrAa#ET7=e@E2$3Viwe;i)(8Y-1xKoRY5gEo1_9L+ob6z9GA@u1X*f>%QB@5u6 zkzxpvh?!SL=EHrcr&6&`M#K$j1^T3 z1`9@s`{+OWVc}@88*cjVjz(qd4{l?ysK}DWhtmyLF_^QS_y>-;wi*johWu8c&jr}bg5>(R$KUTn|vKOPeL8Hhpb5` zAr07tNjP~H=XM}s7bholsA;)|Tb)iBQ^aW~wMkRNnilq2vlm{pD{W3>+oy=N2{{NC zr;2`fWzTGyID}ZkxM}z-H@AYr1f;Hq>(fMU+HCqO3=gM^2{<+VW{5-SxlM3%2HM+S zpk#*VZ19DtI1}N}F;&E~_KmPG6A1|2)CbL9-C2zdeOK2J2z%EL_9cvqf)uZXFz*tqm|6rv`h@5xdZvYrjv;9MOZc2jjV@BG~|Q z(QZco%)_<8u>2RalUw20FX)UGLu8s5L0_!KKwP|wN{}^Q%)rBp*6BE>6(BiX3_~+l zkS_i~pQpg81)?oImjVYDh_3wfZ-MAUUrdKe3&jyMZw*UaC`$a`A!(85N6!KrTZFWX zA#AaDn%+nP`z3f~33q}^#2d&ODB@f^UUXQBp0YIP_^80LrD)r5y_bn&`0&fbC7AN9 znt_kse2MmK7BDdbg?Q6i$jlHwa61Snl0D%Dh{N$>T$@a>o%Q+@ZOzQJ6sTsBKCNY$ znc`TAdF%=+#3@x*Pb*v4QkyjjV1@XSW{-z-5Idu$U0#Vcaz3nGCEDU599|_>r%%?g z!d1AE)N`Bxi#{C-L2JZ1wBs1?%M`1_%r&A5vbG1YcvtO0aglXpNWIa@J#9P#+$y$EoiG6E=v~(e!lL zh+2Yo%r}YwWCE~_XlXjJn;S(_d}$4@frzz1mxT&TS%WOJ=JaGVi^&#E2~F8xI1gz1 zE-lc!>?OfpqWJUa(vrlqiMr6-fPcAjR0j_)HwB3r5UP6Ok1)0SaEYH2*MPTMM9Hz4 z)}QZ=@#1-7wcZa{Tj;eLz-FuHMejvIx2>W}856K_n&53f}A#yV5seC z2lj23I1pcG2#1s%q9dg26|Ly84UoB4oJJ>2fRbF4zhjLBnOFMgvGT_FpDPP_rSE?# z6Mw_XU*mtqwD}z?KacylGKW|8{kf9$*(V;O!~&}C7kly4@_z9*JTP)RAg)85Idwox zqqllPkAq@f<@Y@#qx9JhxJwLCpY~ubhs47KH!)8SqjAFG2)bKzFh|AR^iBwb9239M zJHZfg9Oq#LEIuxJ)r<@_%q4EyxX6_4<8&p>)Gl!UIEF6UA?1YVWt-6Lf8h=61`m#l z_VDHe&Ut(G{G>RP)I8P^`I?hMIbXlwZ=MTVxE(>Y9*a69W)ory=DA`9pVsVLu{Rpc zZ@DN}2)g7USmisIjUZh-h|ij{q4^BLRer$P99|s$qx~#z{|>Y4vlxca`x~Ioc?>~} zfSt$5xYeGGxPYd<(l9^Ho0xVn{P~Sm@cTt^F@_#Nm&A|sjUTkm=kmgm^U*uGXJ-X!p*Z`kxGJf<4nv2AIXq(S{pLYMPmJ!=$eeRBhE+J5=02Eb=GJYr7) zxF)v5?M~xAMV!YrcrKR$Mb|`M`cDh4pS2+5PxMvWVEUiP*oYR8vP-mvTYrl6sdEcx zeFFiz>u8c9An3YyirP1alzgmPAxbXvt}g@^h<$}rUrj;aTmkN#%)z!0_f8QIRw(ww z^PX*mq8sS}Hw!U>d*jVX7SoT-z~`p88uQ!*H$`{upmn!!gAoBmx5W1Jofm6)TdXh8 z(~TkOp4bSJIm_;0IMo-f-V^83^B!#QeG#t>_`%BuqCKvH=|e1xpy5NY7JcA`7YT9C zb<7P$Jw*3D8#X@_F&XM6!KH&zJ#cs=y3sq0AmovlDYS27sI3d;kHsFwXBrwN76zM3 z)nM9VF@%OU}#=w%`;!rm_RXC))Kgd2%?09pM*A-#QLDV7Mq|_)O;iQ3I(+#W$+$L z<-RH^$3DqODB+FRm0N~4=wfR^mA5$5BL_az5N-tDiVe+w_x_3cW_bPnDCg zpv~W?b(>($-(p)~sI3GGCrZ91P0~(u4^e9)czL2!8z;j3BQDDRni@=tn?UAAu@=e_ z`zQ_-s?;o-x5`RLQ7IEcKZ&UZc9>AaH&+JN+m$ewP>dc0XRjC~E5wG|Oe^-G80{(U zvA2D}9nVUZ_7Cn`d1qTz=c{N!xwMvu{@gf}pyQbY`Vx#=*J}QHSyQP7y=}g%yEL2h zT2?5z85D#_z80*qWE357Lo|;OV{Fp{eL~bt(2Gb-_+-o_QZ3Q|vWRqv<0n$dP3Tcc zf^Z_$fpb)172Bwv1<%nK*b$x>@=m4?bvd%AWb%a*0r_~zqAmT4m4IW68$swnj$5iF{r zv__SeiKM;V49@maJ8}SG?4_>sk&f-Rm+T}QzQ9T9MT{))Nlo!~#)o>6myC&Fmqt>3+!Oa`B-JIqL1H7xp1&m6NE+aB ztj)QJG_YD=xwcZHv>7s+NR#VTzssjdR~nCFaMPE+ zrSD**uDSI+dy`)_xTiD{_eRG(C3l;fH-8$fbR$!|8FXIK;L3xwR&6K`Nbr(U?7WZ% z9O;*n<;Ln?Iv9g$O{D}(I?it@&E+>kEWM@1m@^CVmXfi^^_CW*5{3ClW_YCwqI{)G zxVQ9fE?qzmBDIj#>t_CGARewB-oTiDl5 zI)d$WW;kJ!~ke*Q*?z z(-lt>)a5%2^O$xz`~+X$PyS9K2~B&4A6fAURq<87p*ZkBxWo(GF0cg4x#GT z?cgyCiQd@`Az1PlZx~{%LU5>5J+QLj?c7jx^7j9GjLOk-QT{^Je*dGrVvI+qilZV; zJUcWSE?HH3w#Bf*$fk}Uk1a#hzqf(!aGbpvfV-$Me0vos)vtqFErXOB9t)pGRijHv z%6fGPRr9vO@JOj4rfZf&N>QWO$bS*iH~pZ%5yl?+4~4HAzazNduE65K z!T%tP`hlRvO8u$2fp@405u>DPJOmhpvoQxYjY3s5hPtD1G78s2@6otQ*f<(3d^)V* z&?q=MTB>Urw4T$~8AMD88Ey^6W6*a#SO;CkNDYnk>kO^X*q>BW@~dKUV2oseCg8U* z(lBbV4lW*)s#n65Gv(`T8m7Kl3x08^gScUhlX~(vIS!Qzw}E4^zzb@;z}t7cs16q6 zq+ohxH4Gakb>o4@ILVR6;p1@ST|kVNeCV51&^lhKL(i>(A@R8M%K+k~hPKhGe(-Em zPAN=7RlJlDk6s7k_jswN?SqvD#PrVQs&kN$(I;)8oqDQyD@E;#LveK^NEt6#*D2DY zEBO)1stDq=lnG^@P&FR*kCz%GchE>`D#>Lxaq@{@boj`O%&js_OpJo*rnP z8)&M<&%ryMHLkF>pX`Bw+Fi*f)#oLk-qy}|%?fvN) z*CJT%8Er#VS0EFm0QzJ(beJgl^9!33rMBF{Oq3igR_@{G->Ku2ID?dcamS5cA%CJ& z$HL}kgodFgn)4FSTjTHvsGLE+!oCSoec$BWKd}*qU^zBW4gbmf`6)GPk6POyQS!5h z1MxqhXE>}##9d%?rltw^6VY`bwwj1u<5mXPPeQZz3czoY47#;M2!c-}e zzM2nyGo^5DRc1=lFjlaeg^^P#Y?&p^qo02Pui4Thn)C}t@_>7@B~#L!y__vg7JB8( zM0fs{M+Be7R}58i5kvqL>m-lmbn4ch+p~UdH$@y%HKi0sr_o4-1HVWGq&8cUCT$Vu z+v(71A^O|(@XJEnYNf#Tg;H1UP8Oo!d6)v77fGWC>h&TFECb-#B55qWnhgCGqXEKQ z+hTO*m@QZ=d32`JL?iCbswZn?rPR8liJdb zQ((bFsX5fjK;(aZKtEp{}VZTuIY`I3mBbBy) z;O#!4>em0!?&*i^A))FoY(3sCG~C@O%#@Pw!NY!)j^eSi^>V2<<+ndq;sT9>11qIA zd}Xkp@8emERnk<-UvFO{)!{CF4N9dK6t6*X#0|w-)aSqBz;`Vw{nTN*IZzK;t__kE{V)@9H%LvY97Vb2ZT>Mv>7spz z`a4wED0$IWvEa8+%HnUXZp5)(jpSps$HT7RO;Wp-&Z+;`FxFW6eV7Ue;8#>$^h&qg z!E>iQ`F90e)K@d$!X~M{&50R551WH9N<=THvQcV8-^M_z&C)*lJQ6-`M(N!TPFd1G z{KCMDEGe1(Ih+aE(i8!8CV3k=)XhT;6PS`@YJ{J#n5e@ES5pjirKg~?Sk5+FPqSN7 zIHD;ke*cr|`v~@QyW}OB-yf)1hf>Y9fChUc+s5ZhYfEj$GX#IK8GCO|ay1=6E?0P30mA;PxTh1I=a5ho!N^#36>y zg2M@Os1hJq8NPnNZXS^q5aW<&LkpM%NO-3JKbyd|9>aV{+fSX#cB|1VTjOUupZjrSbP>yTuVWG+2E|?NAXe?r;ewTVdo@& z+P@TR2FK4K@<0CC*w_7`&Uu8FYcQU$%{Y%?NsCg@3Lc!tp!iOEjTYWbynxR*r4$T> zbr+<&7;B|mlvdK4ZK2jBe2kUQ|B|#CeDg8-sG5)KdKjALOULNHZQ$R0blWRg|I1Po zMdNz%Dmuf{u;-d&0shx8n890f*U(RXYQgBAQm}w7u}2~9Es&`~oct%=U~vQEc6@2~ zh7?Wz?gr;?NOR4@yP*X^o8o1#D+9X0{#%lp?$>6h%$U!CH@Bo3mA-W?#R*kQy2A0B zIR2upyn7w!a!VR$Zc^IrVW9C(7XuBvo}u27YMXB9qIJg2=W4LLEnTL$+hCx%V6*Rz zgdb0s2P^JM1NcpryVBoyg8%9sUSI9gL4*cbLMR-)FI5+w28pmT3op$(g2@96=!QY> z2htefbzo_=H+*~`HOIHAJRV}&vn#NN=&Al{1eG75bsN=4R2Ib9u`Q3J#*}-eC%DVU zZ`C}N>}X*F=I~T<)-}A{03R0<6+T94qJwCp#^WCz5a7q>wmUuk#$PYB#cy`ts~B%~ zu=v-gOJp=V@KW$vvr47h};#@@r>?7pG%}rCu?@Z?(81&GOf%7s5_s z*^^Xa4~^vslwOmeZw1*KgVeq;`d zSzyD!T;4@7S`V_27m`Fw>B@unja6?;tpqFilJwo2&$5-ATOLp`sdLwY}qnZC|Zw)|NfUYRNHeT~AJI^jGkM!mZ1l!BboI;|#Z0|Ltd}F2t z{67>1lt+p;P^hiku8N;(Lq6;|AFs>v@js{(mPdN?8iF0<`Iwfu?I3UDXKuCe<~W|+ z){&R+Fu9K0nTJ~l(RHt2M;*Bn-ST z&hj!sXQ^7{3H+KfzU%eDMV?W4)su3Z9)Q&PvSWDYBf;oJz4Ty`npfg^rRZIYg7gl= zEFdrKUD`R-7aOtiQ;Xb$cWD!JX#;JALVkm`n%bf~sU8}THq9nIK#UPX_+<#Ac>_g^ zo5Tk4W}Yi*AO}_OeaeT|rA>RAk!x&)#@NDD?u{oOBV1)W`e-lAb(LN5M#^ul@(KLH z(i~U0A-`eBIIQbj6G)9se zSg*!1<_h2b20Bl9Y2}Hx%1wg;TRr7jm7m`%S7!vRyyT|B{@Vf`npr4s-6SF7v7k8Q zS>cuWEH4?q5gZ2v&5$N;ZM@|U^!{~r&0C&HgsTPLyO7;%yssQj+V{UE7-8UQ5Y-74 zVu;!aD-cruzA6~`28mcFsm-*y7^9K|vBX=wfK3>bp=?)(p=x#3poMHI(d^%ukDq)5 z-*|(fwlc#v2zIrTTVWFVRXceK9@>v+FW1CiepY+AuJ`zJ6PX}zoPflm2 z2Rz0#!dKBlRA)n5X;3%-9<-NhRJJbP*$Yhk<@&OB(D+pxl1QmZ*}05VMM&c*6Xh>&Vk*s}?(^>un zPfpr*kyqpP{$Upxzs+F-*4<0y;nw0c`Y97dH0fo z(9Kew!#BXu0#fy}&a##8RPhCgJ!Ca|F$t_UmPLGm%;q}^@qvZg4ZvFQ` zgsiQC;k6+?A(^9*u_NnX*9a7Ybx<@y_Jg7^$kqF`-#b`e%>Ka@MieVkUk<~Fq7B5x z;aYpKlW}s2geM~Y6XoUny|#%m|K7;(1bHIVOq6TFrv$k!^iPznpmCzyfaYhyz(izF zfnO8l4tP84VWRBIuUkx#{pclt@JVPC7QxC%a!Y<8j~Dow#$=rIOBoP8S#AZlCL`5- zlaXr8DMckzP)>xE%xrNp~!nM_G z;6m$gnBu;L=n(2LuSM24;p|=F#^Il$(coF2njnP^K*M z#IzB&({MX=l{JcL$7*Y=XZ}L8mwUZzVn&NezC)b*)%mNfZ_rZ za_mxW87IR%jB0|X6V_NUM8rzXI@I0MYuVT9tTTmzFIemAQ0i*%(hl5}5q2N^`ZU&W zyETAz^|o6>a7ca4cIz$LCfs2Sf-$byVZDiVKk+?l9pS5EZ0∓^R(ytjX5wL>pP1 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 Date: Wed, 13 Sep 2023 18:16:35 +0800 Subject: [PATCH 23/36] unparenting all the objects to the containers & uses the OP data to get previous objects --- openpype/hosts/max/api/pipeline.py | 23 ++++++-- .../hosts/max/plugins/load/load_camera_fbx.py | 38 +++++------- .../hosts/max/plugins/load/load_max_scene.py | 40 ++++++------- openpype/hosts/max/plugins/load/load_model.py | 20 +++---- .../hosts/max/plugins/load/load_model_fbx.py | 59 ++++++++----------- .../hosts/max/plugins/load/load_model_obj.py | 32 +++++----- .../hosts/max/plugins/load/load_model_usd.py | 55 ++++++++--------- .../hosts/max/plugins/load/load_pointcache.py | 21 +++---- .../hosts/max/plugins/load/load_pointcloud.py | 20 +++---- .../max/plugins/load/load_redshift_proxy.py | 24 +++----- 10 files changed, 148 insertions(+), 184 deletions(-) diff --git a/openpype/hosts/max/api/pipeline.py b/openpype/hosts/max/api/pipeline.py index 72163f5ecf..6c40acc56b 100644 --- a/openpype/hosts/max/api/pipeline.py +++ b/openpype/hosts/max/api/pipeline.py @@ -164,12 +164,11 @@ def containerise(name: str, nodes: list, context, "loader": loader, "representation": context["representation"]["_id"], } - container_name = f"{namespace}:{name}{suffix}" container = rt.container(name=container_name) - for node in nodes: - node.Parent = container - + #for node in nodes: + # node.Parent = container + import_custom_attribute_data(container, nodes) if not lib.imprint(container_name, data): print(f"imprinting of {container_name} failed.") return container @@ -223,3 +222,19 @@ def update_custom_attribute_data(container: str, selections: list): if container.modifiers[0].name == "OP Data": rt.deleteModifier(container, container.modifiers[0]) import_custom_attribute_data(container, selections) + +def get_previous_loaded_object(container: str): + """Get previous loaded_object through the OP data + + Args: + container (str): the container which stores the OP data + + Returns: + node_list(list): list of nodes which are previously loaded + """ + node_list = [] + sel_list = rt.getProperty(container.modifiers[0].openPypeData, "sel_list") + for obj in rt.Objects: + if str(obj) in sel_list: + node_list.append(obj) + return node_list diff --git a/openpype/hosts/max/plugins/load/load_camera_fbx.py b/openpype/hosts/max/plugins/load/load_camera_fbx.py index f040115417..39bbf79d0f 100644 --- a/openpype/hosts/max/plugins/load/load_camera_fbx.py +++ b/openpype/hosts/max/plugins/load/load_camera_fbx.py @@ -8,7 +8,7 @@ from openpype.hosts.max.api.lib import ( ) from openpype.hosts.max.api.pipeline import ( containerise, - import_custom_attribute_data, + get_previous_loaded_object, update_custom_attribute_data ) from openpype.pipeline import get_representation_path, load @@ -22,7 +22,6 @@ class FbxLoader(load.LoaderPlugin): order = -9 icon = "code-fork" color = "white" - postfix = "param" def load(self, context, name=None, namespace=None, data=None): from pymxs import runtime as rt @@ -42,17 +41,13 @@ class FbxLoader(load.LoaderPlugin): name + "_", suffix="_", ) - container = rt.container( - name=f"{namespace}:{name}_{self.postfix}") selections = rt.GetCurrentSelection() - import_custom_attribute_data(container, selections) for selection in selections: - selection.Parent = container selection.name = f"{namespace}:{selection.name}" return containerise( - name, [container], context, + name, selections, context, namespace, loader=self.__class__.__name__) def update(self, container, representation): @@ -61,12 +56,13 @@ class FbxLoader(load.LoaderPlugin): path = get_representation_path(representation) node_name = container["instance_node"] node = rt.getNodeByName(node_name) - namespace, name = get_namespace(node_name) - sub_node_name = f"{namespace}:{name}_{self.postfix}" - inst_container = rt.getNodeByName(sub_node_name) - rt.Select(inst_container.Children) - transform_data = object_transform_set(inst_container.Children) - for prev_fbx_obj in rt.selection: + namespace, _ = get_namespace(node_name) + + node_list = get_previous_loaded_object(node) + rt.Select(node_list) + prev_fbx_objects = rt.GetCurrentSelection() + transform_data = object_transform_set(prev_fbx_objects) + for prev_fbx_obj in prev_fbx_objects: if rt.isValidNode(prev_fbx_obj): rt.Delete(prev_fbx_obj) @@ -78,20 +74,14 @@ class FbxLoader(load.LoaderPlugin): rt.ImportFile( path, rt.name("noPrompt"), using=rt.FBXIMP) current_fbx_objects = rt.GetCurrentSelection() + update_custom_attribute_data(node, current_fbx_objects) for fbx_object in current_fbx_objects: - if fbx_object.Parent != inst_container: - fbx_object.Parent = inst_container - fbx_object.name = f"{namespace}:{fbx_object.name}" + fbx_object.name = f"{namespace}:{fbx_object.name}" + if fbx_object in node_list: fbx_object.pos = transform_data[ - f"{fbx_object.name}.transform"] + f"{fbx_object.name}.transform"] or fbx_object.pos fbx_object.scale = transform_data[ - f"{fbx_object.name}.scale"] - - for children in node.Children: - if rt.classOf(children) == rt.Container: - if children.name == sub_node_name: - update_custom_attribute_data( - children, current_fbx_objects) + f"{fbx_object.name}.scale"] or fbx_object.scale with maintained_selection(): rt.Select(node) diff --git a/openpype/hosts/max/plugins/load/load_max_scene.py b/openpype/hosts/max/plugins/load/load_max_scene.py index 98e9be96e1..86b7637c90 100644 --- a/openpype/hosts/max/plugins/load/load_max_scene.py +++ b/openpype/hosts/max/plugins/load/load_max_scene.py @@ -7,7 +7,7 @@ from openpype.hosts.max.api.lib import ( object_transform_set ) from openpype.hosts.max.api.pipeline import ( - containerise, import_custom_attribute_data, + containerise, get_previous_loaded_object, update_custom_attribute_data ) from openpype.pipeline import get_representation_path, load @@ -24,7 +24,6 @@ class MaxSceneLoader(load.LoaderPlugin): order = -8 icon = "code-fork" color = "green" - postfix = "param" def load(self, context, name=None, namespace=None, data=None): from pymxs import runtime as rt @@ -37,18 +36,14 @@ class MaxSceneLoader(load.LoaderPlugin): max_object_names = [obj.name for obj in max_objects] # implement the OP/AYON custom attributes before load max_container = [] - namespace = unique_namespace( name + "_", suffix="_", ) - container_name = f"{namespace}:{name}_{self.postfix}" - container = rt.Container(name=container_name) - import_custom_attribute_data(container, max_objects) - max_container.append(container) - max_container.extend(max_objects) for max_obj, obj_name in zip(max_objects, max_object_names): max_obj.name = f"{namespace}:{obj_name}" + max_container.append(rt.getNodeByName(max_obj.name)) + return containerise( name, max_container, context, namespace, loader=self.__class__.__name__) @@ -60,32 +55,31 @@ class MaxSceneLoader(load.LoaderPlugin): node_name = container["instance_node"] node = rt.getNodeByName(node_name) - namespace, name = get_namespace(node_name) - sub_container_name = f"{namespace}:{name}_{self.postfix}" + namespace, _ = get_namespace(node_name) # delete the old container with attribute # delete old duplicate - rt.Select(node.Children) - transform_data = object_transform_set(node.Children) - for prev_max_obj in rt.GetCurrentSelection(): - if rt.isValidNode(prev_max_obj) and prev_max_obj.name != sub_container_name: # noqa + # use the modifier OP data to delete the data + node_list = get_previous_loaded_object(node) + rt.Select(node_list) + prev_max_objects = rt.GetCurrentSelection() + transform_data = object_transform_set(prev_max_objects) + for prev_max_obj in prev_max_objects: + if rt.isValidNode(prev_max_obj): # noqa rt.Delete(prev_max_obj) rt.MergeMaxFile(path, rt.Name("deleteOldDups")) current_max_objects = rt.getLastMergedNodes() current_max_object_names = [obj.name for obj in current_max_objects] - sub_container = rt.getNodeByName(sub_container_name) - update_custom_attribute_data(sub_container, current_max_objects) - for max_object in current_max_objects: - max_object.Parent = node + update_custom_attribute_data(node, current_max_objects) for max_obj, obj_name in zip(current_max_objects, current_max_object_names): max_obj.name = f"{namespace}:{obj_name}" - max_obj.pos = transform_data[ - f"{max_obj.name}.transform"] - max_obj.scale = transform_data[ - f"{max_obj.name}.scale"] - + if max_obj in node_list: + max_obj.pos = transform_data[ + f"{max_obj.name}.transform"] or max_obj.pos + max_obj.scale = transform_data[ + f"{max_obj.name}.scale"] or max_obj.scale lib.imprint(container["instance_node"], { "representation": str(representation["_id"]) }) diff --git a/openpype/hosts/max/plugins/load/load_model.py b/openpype/hosts/max/plugins/load/load_model.py index c5a73b4327..5acb57b923 100644 --- a/openpype/hosts/max/plugins/load/load_model.py +++ b/openpype/hosts/max/plugins/load/load_model.py @@ -2,8 +2,7 @@ import os from openpype.pipeline import load, get_representation_path from openpype.hosts.max.api.pipeline import ( containerise, - import_custom_attribute_data, - update_custom_attribute_data + get_previous_loaded_object ) from openpype.hosts.max.api import lib from openpype.hosts.max.api.lib import ( @@ -20,7 +19,6 @@ class ModelAbcLoader(load.LoaderPlugin): order = -10 icon = "code-fork" color = "orange" - postfix = "param" def load(self, context, name=None, namespace=None, data=None): from pymxs import runtime as rt @@ -52,21 +50,22 @@ class ModelAbcLoader(load.LoaderPlugin): self.log.error("Something failed when loading.") abc_container = abc_containers.pop() - import_custom_attribute_data( - abc_container, abc_container.Children) namespace = unique_namespace( name + "_", suffix="_", ) + abc_objects = [] for abc_object in abc_container.Children: abc_object.name = f"{namespace}:{abc_object.name}" + abc_objects.append(abc_object) # rename the abc container with namespace - abc_container_name = f"{namespace}:{name}_{self.postfix}" + abc_container_name = f"{namespace}:{name}" abc_container.name = abc_container_name + abc_objects.append(abc_container) return containerise( - name, [abc_container], context, + name, abc_objects, context, namespace, loader=self.__class__.__name__ ) @@ -75,20 +74,19 @@ class ModelAbcLoader(load.LoaderPlugin): path = get_representation_path(representation) node = rt.GetNodeByName(container["instance_node"]) - + node_list = [n for n in get_previous_loaded_object(node) + if rt.ClassOf(n) == rt.AlembicContainer] with maintained_selection(): - rt.Select(node.Children) + rt.Select(node_list) for alembic in rt.Selection: abc = rt.GetNodeByName(alembic.name) - update_custom_attribute_data(abc, abc.Children) rt.Select(abc.Children) for abc_con in abc.Children: abc_con.source = path rt.Select(abc_con.Children) for abc_obj in abc_con.Children: abc_obj.source = path - lib.imprint( container["instance_node"], {"representation": str(representation["_id"])}, diff --git a/openpype/hosts/max/plugins/load/load_model_fbx.py b/openpype/hosts/max/plugins/load/load_model_fbx.py index 56c8768675..a8f6ea90d6 100644 --- a/openpype/hosts/max/plugins/load/load_model_fbx.py +++ b/openpype/hosts/max/plugins/load/load_model_fbx.py @@ -1,7 +1,7 @@ import os from openpype.pipeline import load, get_representation_path from openpype.hosts.max.api.pipeline import ( - containerise, import_custom_attribute_data, + containerise, get_previous_loaded_object, update_custom_attribute_data ) from openpype.hosts.max.api import lib @@ -21,79 +21,68 @@ class FbxModelLoader(load.LoaderPlugin): order = -9 icon = "code-fork" color = "white" - postfix = "param" def load(self, context, name=None, namespace=None, data=None): from pymxs import runtime as rt - - filepath = os.path.normpath(self.filepath_from_context(context)) + filepath = self.filepath_from_context(context) + filepath = os.path.normpath(filepath) rt.FBXImporterSetParam("Animation", False) rt.FBXImporterSetParam("Cameras", False) rt.FBXImporterSetParam("Mode", rt.Name("create")) rt.FBXImporterSetParam("Preserveinstances", True) - rt.importFile(filepath, rt.name("noPrompt"), using=rt.FBXIMP) + rt.importFile( + filepath, rt.name("noPrompt"), using=rt.FBXIMP) namespace = unique_namespace( name + "_", suffix="_", ) - container = rt.container( - name=f"{namespace}:{name}_{self.postfix}") selections = rt.GetCurrentSelection() - import_custom_attribute_data(container, selections) for selection in selections: - selection.Parent = container selection.name = f"{namespace}:{selection.name}" return containerise( - name, [container], context, - namespace, loader=self.__class__.__name__ - ) + name, selections, context, + namespace, loader=self.__class__.__name__) def update(self, container, representation): from pymxs import runtime as rt + path = get_representation_path(representation) node_name = container["instance_node"] node = rt.getNodeByName(node_name) - namespace, name = get_namespace(node_name) - sub_node_name = f"{namespace}:{name}_{self.postfix}" - inst_container = rt.getNodeByName(sub_node_name) - rt.Select(inst_container.Children) - transform_data = object_transform_set(inst_container.Children) - for prev_fbx_obj in rt.selection: + namespace, _ = get_namespace(node_name) + + node_list = get_previous_loaded_object(node) + rt.Select(node_list) + prev_fbx_objects = rt.GetCurrentSelection() + transform_data = object_transform_set(prev_fbx_objects) + for prev_fbx_obj in prev_fbx_objects: if rt.isValidNode(prev_fbx_obj): rt.Delete(prev_fbx_obj) rt.FBXImporterSetParam("Animation", False) rt.FBXImporterSetParam("Cameras", False) - rt.FBXImporterSetParam("Mode", rt.Name("merge")) - rt.FBXImporterSetParam("AxisConversionMethod", True) + rt.FBXImporterSetParam("Mode", rt.Name("create")) rt.FBXImporterSetParam("Preserveinstances", True) rt.importFile(path, rt.name("noPrompt"), using=rt.FBXIMP) current_fbx_objects = rt.GetCurrentSelection() + update_custom_attribute_data(node, current_fbx_objects) for fbx_object in current_fbx_objects: - if fbx_object.Parent != inst_container: - fbx_object.Parent = inst_container - fbx_object.name = f"{namespace}:{fbx_object.name}" + fbx_object.name = f"{namespace}:{fbx_object.name}" + if fbx_object in node_list: fbx_object.pos = transform_data[ - f"{fbx_object.name}.transform"] + f"{fbx_object.name}.transform"] or fbx_object.pos fbx_object.scale = transform_data[ - f"{fbx_object.name}.scale"] - - for children in node.Children: - if rt.classOf(children) == rt.Container: - if children.name == sub_node_name: - update_custom_attribute_data( - children, current_fbx_objects) + f"{fbx_object.name}.scale"] or fbx_object.scale with maintained_selection(): rt.Select(node) - lib.imprint( - node_name, - {"representation": str(representation["_id"])}, - ) + lib.imprint(container["instance_node"], { + "representation": str(representation["_id"]) + }) def switch(self, container, representation): self.update(container, representation) diff --git a/openpype/hosts/max/plugins/load/load_model_obj.py b/openpype/hosts/max/plugins/load/load_model_obj.py index 314889e6ec..421bd34e62 100644 --- a/openpype/hosts/max/plugins/load/load_model_obj.py +++ b/openpype/hosts/max/plugins/load/load_model_obj.py @@ -10,7 +10,7 @@ from openpype.hosts.max.api.lib import ( from openpype.hosts.max.api.lib import maintained_selection from openpype.hosts.max.api.pipeline import ( containerise, - import_custom_attribute_data, + get_previous_loaded_object, update_custom_attribute_data ) from openpype.pipeline import get_representation_path, load @@ -24,7 +24,6 @@ class ObjLoader(load.LoaderPlugin): order = -9 icon = "code-fork" color = "white" - postfix = "param" def load(self, context, name=None, namespace=None, data=None): from pymxs import runtime as rt @@ -39,15 +38,12 @@ class ObjLoader(load.LoaderPlugin): suffix="_", ) # create "missing" container for obj import - container = rt.Container(name=f"{namespace}:{name}_{self.postfix}") selections = rt.GetCurrentSelection() - import_custom_attribute_data(container, selections) # get current selection for selection in selections: - selection.Parent = container selection.name = f"{namespace}:{selection.name}" return containerise( - name, [container], context, + name, selections, context, namespace, loader=self.__class__.__name__) def update(self, container, representation): @@ -56,26 +52,26 @@ class ObjLoader(load.LoaderPlugin): path = get_representation_path(representation) node_name = container["instance_node"] node = rt.getNodeByName(node_name) - namespace, name = get_namespace(node_name) - sub_node_name = f"{namespace}:{name}_{self.postfix}" - inst_container = rt.getNodeByName(sub_node_name) - rt.Select(inst_container.Children) - transform_data = object_transform_set(inst_container.Children) - for prev_obj in rt.selection: + namespace, _ = get_namespace(node_name) + node_list = get_previous_loaded_object(node) + rt.Select(node_list) + previous_objects = rt.GetCurrentSelection() + transform_data = object_transform_set(previous_objects) + for prev_obj in previous_objects: if rt.isValidNode(prev_obj): rt.Delete(prev_obj) rt.Execute(f'importFile @"{path}" #noPrompt using:ObjImp') # get current selection selections = rt.GetCurrentSelection() - update_custom_attribute_data(inst_container, selections) for selection in selections: - selection.Parent = inst_container selection.name = f"{namespace}:{selection.name}" - selection.pos = transform_data[ - f"{selection.name}.transform"] - selection.scale = transform_data[ - f"{selection.name}.scale"] + if selection in node_list: + selection.pos = transform_data[ + f"{selection.name}.transform"] or selection.pos + selection.scale = transform_data[ + f"{selection.name}.scale"] or selection.scale + update_custom_attribute_data(node, selections) with maintained_selection(): rt.Select(node) diff --git a/openpype/hosts/max/plugins/load/load_model_usd.py b/openpype/hosts/max/plugins/load/load_model_usd.py index f35d8e6327..09566c2e78 100644 --- a/openpype/hosts/max/plugins/load/load_model_usd.py +++ b/openpype/hosts/max/plugins/load/load_model_usd.py @@ -1,5 +1,7 @@ import os +from pymxs import runtime as rt + from openpype.hosts.max.api import lib from openpype.hosts.max.api.lib import ( unique_namespace, @@ -9,7 +11,8 @@ from openpype.hosts.max.api.lib import ( from openpype.hosts.max.api.lib import maintained_selection from openpype.hosts.max.api.pipeline import ( containerise, - import_custom_attribute_data + get_previous_loaded_object, + update_custom_attribute_data ) from openpype.pipeline import get_representation_path, load @@ -23,16 +26,13 @@ class ModelUSDLoader(load.LoaderPlugin): order = -10 icon = "code-fork" color = "orange" - postfix = "param" def load(self, context, name=None, namespace=None, data=None): - from pymxs import runtime as rt - # asset_filepath filepath = os.path.normpath(self.filepath_from_context(context)) import_options = rt.USDImporter.CreateOptions() base_filename = os.path.basename(filepath) - filename, ext = os.path.splitext(base_filename) + _, ext = os.path.splitext(base_filename) log_filepath = filepath.replace(ext, "txt") rt.LogPath = log_filepath @@ -44,35 +44,32 @@ class ModelUSDLoader(load.LoaderPlugin): suffix="_", ) asset = rt.GetNodeByName(name) - import_custom_attribute_data(asset, asset.Children) + usd_objects = [] + for usd_asset in asset.Children: usd_asset.name = f"{namespace}:{usd_asset.name}" + usd_objects.append(usd_asset) - asset_name = f"{namespace}:{name}_{self.postfix}" + asset_name = f"{namespace}:{name}" asset.name = asset_name # need to get the correct container after renamed asset = rt.GetNodeByName(asset_name) - + usd_objects.append(asset) return containerise( - name, [asset], context, + name, usd_objects, context, namespace, loader=self.__class__.__name__) def update(self, container, representation): - from pymxs import runtime as rt - path = get_representation_path(representation) node_name = container["instance_node"] node = rt.GetNodeByName(node_name) namespace, name = get_namespace(node_name) - sub_node_name = f"{namespace}:{name}_{self.postfix}" - transform_data = None - for n in node.Children: - rt.Select(n.Children) - transform_data = object_transform_set(n.Children) - for prev_usd_asset in rt.selection: - if rt.isValidNode(prev_usd_asset): - rt.Delete(prev_usd_asset) + node_list = get_previous_loaded_object(node) + rt.Select(node_list) + prev_objects = rt.GetCurrentSelection() + transform_data = object_transform_set(prev_objects) + for n in prev_objects: rt.Delete(n) import_options = rt.USDImporter.CreateOptions() @@ -86,17 +83,19 @@ class ModelUSDLoader(load.LoaderPlugin): path, importOptions=import_options) asset = rt.GetNodeByName(name) - asset.Parent = node - import_custom_attribute_data(asset, asset.Children) + usd_objects = [] for children in asset.Children: children.name = f"{namespace}:{children.name}" - children.pos = transform_data[ - f"{children.name}.transform"] - children.scale = transform_data[ - f"{children.name}.scale"] - - asset.name = sub_node_name + usd_objects.append(children) + if children in node_list: + children.pos = transform_data[ + f"{children.name}.transform"] or children.pos + children.scale = transform_data[ + f"{children.name}.scale"] or children.scale + asset.name = f"{namespace}:{asset.name}" + usd_objects.append(asset) + update_custom_attribute_data(node, usd_objects) with maintained_selection(): rt.Select(node) @@ -108,7 +107,5 @@ class ModelUSDLoader(load.LoaderPlugin): self.update(container, representation) def remove(self, container): - from pymxs import runtime as rt - node = rt.GetNodeByName(container["instance_node"]) rt.Delete(node) diff --git a/openpype/hosts/max/plugins/load/load_pointcache.py b/openpype/hosts/max/plugins/load/load_pointcache.py index 070dea88d4..995e56ca37 100644 --- a/openpype/hosts/max/plugins/load/load_pointcache.py +++ b/openpype/hosts/max/plugins/load/load_pointcache.py @@ -10,8 +10,7 @@ from openpype.hosts.max.api import lib, maintained_selection from openpype.hosts.max.api.lib import unique_namespace from openpype.hosts.max.api.pipeline import ( containerise, - import_custom_attribute_data, - update_custom_attribute_data + get_previous_loaded_object ) @@ -24,7 +23,6 @@ class AbcLoader(load.LoaderPlugin): order = -10 icon = "code-fork" color = "orange" - postfix = "param" def load(self, context, name=None, namespace=None, data=None): from pymxs import runtime as rt @@ -55,8 +53,6 @@ class AbcLoader(load.LoaderPlugin): abc_container = abc_containers.pop() selections = rt.GetCurrentSelection() - import_custom_attribute_data( - abc_container, abc_container.Children) for abc in selections: for cam_shape in abc.Children: cam_shape.playbackType = 2 @@ -65,15 +61,17 @@ class AbcLoader(load.LoaderPlugin): name + "_", suffix="_", ) - + abc_objects = [] for abc_object in abc_container.Children: abc_object.name = f"{namespace}:{abc_object.name}" + abc_objects.append(abc_object) # rename the abc container with namespace - abc_container_name = f"{namespace}:{name}_{self.postfix}" + abc_container_name = f"{namespace}:{name}" abc_container.name = abc_container_name + abc_objects.append(abc_container) return containerise( - name, [abc_container], context, + name, abc_objects, context, namespace, loader=self.__class__.__name__ ) @@ -82,20 +80,19 @@ class AbcLoader(load.LoaderPlugin): path = get_representation_path(representation) node = rt.GetNodeByName(container["instance_node"]) - + abc_container = [n for n in get_previous_loaded_object(node) + if rt.ClassOf(n) == rt.AlembicContainer] with maintained_selection(): - rt.Select(node.Children) + rt.Select(abc_container) for alembic in rt.Selection: abc = rt.GetNodeByName(alembic.name) - update_custom_attribute_data(abc, abc.Children) rt.Select(abc.Children) for abc_con in abc.Children: abc_con.source = path rt.Select(abc_con.Children) for abc_obj in abc_con.Children: abc_obj.source = path - lib.imprint( container["instance_node"], {"representation": str(representation["_id"])}, diff --git a/openpype/hosts/max/plugins/load/load_pointcloud.py b/openpype/hosts/max/plugins/load/load_pointcloud.py index c4c4cfbc6c..2309d3aebf 100644 --- a/openpype/hosts/max/plugins/load/load_pointcloud.py +++ b/openpype/hosts/max/plugins/load/load_pointcloud.py @@ -2,11 +2,11 @@ import os from openpype.hosts.max.api import lib, maintained_selection from openpype.hosts.max.api.lib import ( - unique_namespace, get_namespace + unique_namespace ) from openpype.hosts.max.api.pipeline import ( containerise, - import_custom_attribute_data, + get_previous_loaded_object, update_custom_attribute_data ) from openpype.pipeline import get_representation_path, load @@ -34,14 +34,10 @@ class PointCloudLoader(load.LoaderPlugin): name + "_", suffix="_", ) - prt_container = rt.Container( - name=f"{namespace}:{name}_{self.postfix}") - import_custom_attribute_data(prt_container, [obj]) - obj.Parent = prt_container obj.name = f"{namespace}:{obj.name}" return containerise( - name, [prt_container], context, + name, [obj], context, namespace, loader=self.__class__.__name__) def update(self, container, representation): @@ -50,14 +46,12 @@ class PointCloudLoader(load.LoaderPlugin): path = get_representation_path(representation) node = rt.GetNodeByName(container["instance_node"]) - namespace, name = get_namespace(container["instance_node"]) - sub_node_name = f"{namespace}:{name}_{self.postfix}" - inst_container = rt.getNodeByName(sub_node_name) + node_list = get_previous_loaded_object(node) update_custom_attribute_data( - inst_container, inst_container.Children) + node, node_list) with maintained_selection(): - rt.Select(node.Children) - for prt in inst_container.Children: + rt.Select(node_list) + for prt in rt.Selection: prt.filename = path lib.imprint(container["instance_node"], { "representation": str(representation["_id"]) diff --git a/openpype/hosts/max/plugins/load/load_redshift_proxy.py b/openpype/hosts/max/plugins/load/load_redshift_proxy.py index f7dd95962b..36bc7ac9e2 100644 --- a/openpype/hosts/max/plugins/load/load_redshift_proxy.py +++ b/openpype/hosts/max/plugins/load/load_redshift_proxy.py @@ -7,12 +7,12 @@ from openpype.pipeline import ( ) from openpype.hosts.max.api.pipeline import ( containerise, - import_custom_attribute_data, - update_custom_attribute_data + update_custom_attribute_data, + get_previous_loaded_object ) from openpype.hosts.max.api import lib from openpype.hosts.max.api.lib import ( - unique_namespace, get_namespace + unique_namespace ) @@ -25,7 +25,6 @@ class RedshiftProxyLoader(load.LoaderPlugin): order = -9 icon = "code-fork" color = "white" - postfix = "param" def load(self, context, name=None, namespace=None, data=None): from pymxs import runtime as rt @@ -42,27 +41,22 @@ class RedshiftProxyLoader(load.LoaderPlugin): name + "_", suffix="_", ) - container = rt.Container( - name=f"{namespace}:{name}_{self.postfix}") - rs_proxy.Parent = container rs_proxy.name = f"{namespace}:{rs_proxy.name}" - import_custom_attribute_data(container, [rs_proxy]) return containerise( - name, [container], context, + name, [rs_proxy], context, namespace, loader=self.__class__.__name__) def update(self, container, representation): from pymxs import runtime as rt path = get_representation_path(representation) - namespace, name = get_namespace(container["instance_node"]) - sub_node_name = f"{namespace}:{name}_{self.postfix}" - inst_container = rt.getNodeByName(sub_node_name) - + node = rt.getNodeByName(container["instance_node"]) + node_list = get_previous_loaded_object(node) + rt.Select(node_list) update_custom_attribute_data( - inst_container, inst_container.Children) - for proxy in inst_container.Children: + node, rt.Selection) + for proxy in rt.Selection: proxy.file = path lib.imprint(container["instance_node"], { From 78ec30cb392bd3fbe686101329089d63da797e86 Mon Sep 17 00:00:00 2001 From: Kayla Man Date: Wed, 13 Sep 2023 18:21:17 +0800 Subject: [PATCH 24/36] hound --- openpype/hosts/max/api/pipeline.py | 4 ++-- openpype/hosts/max/plugins/load/load_camera_fbx.py | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/openpype/hosts/max/api/pipeline.py b/openpype/hosts/max/api/pipeline.py index 6c40acc56b..86a0a99ca9 100644 --- a/openpype/hosts/max/api/pipeline.py +++ b/openpype/hosts/max/api/pipeline.py @@ -166,8 +166,6 @@ def containerise(name: str, nodes: list, context, } container_name = f"{namespace}:{name}{suffix}" container = rt.container(name=container_name) - #for node in nodes: - # node.Parent = container import_custom_attribute_data(container, nodes) if not lib.imprint(container_name, data): print(f"imprinting of {container_name} failed.") @@ -211,6 +209,7 @@ def import_custom_attribute_data(container: str, selections: list): container.modifiers[0].openPypeData, "sel_list", sel_list) + def update_custom_attribute_data(container: str, selections: list): """Updating the Openpype/AYON custom parameter built by the creator @@ -223,6 +222,7 @@ def update_custom_attribute_data(container: str, selections: list): rt.deleteModifier(container, container.modifiers[0]) import_custom_attribute_data(container, selections) + def get_previous_loaded_object(container: str): """Get previous loaded_object through the OP data diff --git a/openpype/hosts/max/plugins/load/load_camera_fbx.py b/openpype/hosts/max/plugins/load/load_camera_fbx.py index 39bbf79d0f..d28364d5c2 100644 --- a/openpype/hosts/max/plugins/load/load_camera_fbx.py +++ b/openpype/hosts/max/plugins/load/load_camera_fbx.py @@ -81,7 +81,7 @@ class FbxLoader(load.LoaderPlugin): fbx_object.pos = transform_data[ f"{fbx_object.name}.transform"] or fbx_object.pos fbx_object.scale = transform_data[ - f"{fbx_object.name}.scale"] or fbx_object.scale + f"{fbx_object.name}.scale"] or fbx_object.scale with maintained_selection(): rt.Select(node) From bdaeb3c92f3ba5c2744ce69fa3aadd3135f33699 Mon Sep 17 00:00:00 2001 From: Kayla Man Date: Wed, 13 Sep 2023 19:08:09 +0800 Subject: [PATCH 25/36] add loadError for loaders which uses external plugins --- openpype/hosts/max/api/lib.py | 16 ++++++++++++++++ .../hosts/max/plugins/load/load_model_usd.py | 8 ++++++-- .../hosts/max/plugins/load/load_pointcloud.py | 4 ++-- .../max/plugins/load/load_redshift_proxy.py | 8 ++++++-- 4 files changed, 30 insertions(+), 6 deletions(-) diff --git a/openpype/hosts/max/api/lib.py b/openpype/hosts/max/api/lib.py index 8287341456..4a150067e1 100644 --- a/openpype/hosts/max/api/lib.py +++ b/openpype/hosts/max/api/lib.py @@ -407,3 +407,19 @@ def object_transform_set(container_children): name = f"{node.name}.scale" transform_set[name] = node.scale return transform_set + + +def get_plugins() -> list: + """Get all loaded plugins in 3dsMax + + Returns: + plugin_info_list: a list of loaded plugins + """ + manager = rt.PluginManager + count = manager.pluginDllCount + plugin_info_list = [] + for p in range(1, count + 1): + plugin_info = manager.pluginDllName(p) + plugin_info_list.append(plugin_info) + + return plugin_info_list diff --git a/openpype/hosts/max/plugins/load/load_model_usd.py b/openpype/hosts/max/plugins/load/load_model_usd.py index 09566c2e78..67d0e75259 100644 --- a/openpype/hosts/max/plugins/load/load_model_usd.py +++ b/openpype/hosts/max/plugins/load/load_model_usd.py @@ -1,12 +1,13 @@ import os from pymxs import runtime as rt - +from openpype.pipeline.load import LoadError from openpype.hosts.max.api import lib from openpype.hosts.max.api.lib import ( unique_namespace, get_namespace, - object_transform_set + object_transform_set, + get_plugins ) from openpype.hosts.max.api.lib import maintained_selection from openpype.hosts.max.api.pipeline import ( @@ -29,6 +30,9 @@ class ModelUSDLoader(load.LoaderPlugin): def load(self, context, name=None, namespace=None, data=None): # asset_filepath + plugin_info = get_plugins() + if "usdimport.dli" not in plugin_info: + raise LoadError("No USDImporter loaded/installed in Max..") filepath = os.path.normpath(self.filepath_from_context(context)) import_options = rt.USDImporter.CreateOptions() base_filename = os.path.basename(filepath) diff --git a/openpype/hosts/max/plugins/load/load_pointcloud.py b/openpype/hosts/max/plugins/load/load_pointcloud.py index 2309d3aebf..e0317a2e22 100644 --- a/openpype/hosts/max/plugins/load/load_pointcloud.py +++ b/openpype/hosts/max/plugins/load/load_pointcloud.py @@ -2,7 +2,8 @@ import os from openpype.hosts.max.api import lib, maintained_selection from openpype.hosts.max.api.lib import ( - unique_namespace + unique_namespace, + ) from openpype.hosts.max.api.pipeline import ( containerise, @@ -25,7 +26,6 @@ class PointCloudLoader(load.LoaderPlugin): def load(self, context, name=None, namespace=None, data=None): """load point cloud by tyCache""" from pymxs import runtime as rt - filepath = os.path.normpath(self.filepath_from_context(context)) obj = rt.tyCache() obj.filename = filepath diff --git a/openpype/hosts/max/plugins/load/load_redshift_proxy.py b/openpype/hosts/max/plugins/load/load_redshift_proxy.py index 36bc7ac9e2..daf6d3e169 100644 --- a/openpype/hosts/max/plugins/load/load_redshift_proxy.py +++ b/openpype/hosts/max/plugins/load/load_redshift_proxy.py @@ -5,6 +5,7 @@ from openpype.pipeline import ( load, get_representation_path ) +from openpype.pipeline.load import LoadError from openpype.hosts.max.api.pipeline import ( containerise, update_custom_attribute_data, @@ -12,7 +13,8 @@ from openpype.hosts.max.api.pipeline import ( ) from openpype.hosts.max.api import lib from openpype.hosts.max.api.lib import ( - unique_namespace + unique_namespace, + get_plugins ) @@ -28,7 +30,9 @@ class RedshiftProxyLoader(load.LoaderPlugin): def load(self, context, name=None, namespace=None, data=None): from pymxs import runtime as rt - + plugin_info = get_plugins() + if "redshift4max.dlr" not in plugin_info: + raise LoadError("Redshift not loaded/installed in Max..") filepath = self.filepath_from_context(context) rs_proxy = rt.RedshiftProxy() rs_proxy.file = filepath From 8c890641ad9bb8a6f30f82fb2b668e0a6c05281d Mon Sep 17 00:00:00 2001 From: Kayla Man Date: Wed, 13 Sep 2023 21:18:30 +0800 Subject: [PATCH 26/36] fixing the issue of duplciated contents during switching assets --- openpype/hosts/max/plugins/load/load_camera_fbx.py | 4 ++-- openpype/hosts/max/plugins/load/load_max_scene.py | 7 +++---- openpype/hosts/max/plugins/load/load_model_fbx.py | 4 ++-- openpype/hosts/max/plugins/load/load_model_obj.py | 4 ++-- openpype/hosts/max/plugins/load/load_model_usd.py | 4 ++-- 5 files changed, 11 insertions(+), 12 deletions(-) diff --git a/openpype/hosts/max/plugins/load/load_camera_fbx.py b/openpype/hosts/max/plugins/load/load_camera_fbx.py index d28364d5c2..156e8dcaf6 100644 --- a/openpype/hosts/max/plugins/load/load_camera_fbx.py +++ b/openpype/hosts/max/plugins/load/load_camera_fbx.py @@ -79,9 +79,9 @@ class FbxLoader(load.LoaderPlugin): fbx_object.name = f"{namespace}:{fbx_object.name}" if fbx_object in node_list: fbx_object.pos = transform_data[ - f"{fbx_object.name}.transform"] or fbx_object.pos + f"{fbx_object.name}.transform"] or 0 fbx_object.scale = transform_data[ - f"{fbx_object.name}.scale"] or fbx_object.scale + f"{fbx_object.name}.scale"] or 0 with maintained_selection(): rt.Select(node) diff --git a/openpype/hosts/max/plugins/load/load_max_scene.py b/openpype/hosts/max/plugins/load/load_max_scene.py index 86b7637c90..b7ce5bfe39 100644 --- a/openpype/hosts/max/plugins/load/load_max_scene.py +++ b/openpype/hosts/max/plugins/load/load_max_scene.py @@ -60,8 +60,7 @@ class MaxSceneLoader(load.LoaderPlugin): # delete old duplicate # use the modifier OP data to delete the data node_list = get_previous_loaded_object(node) - rt.Select(node_list) - prev_max_objects = rt.GetCurrentSelection() + prev_max_objects = rt.getLastMergedNodes() transform_data = object_transform_set(prev_max_objects) for prev_max_obj in prev_max_objects: if rt.isValidNode(prev_max_obj): # noqa @@ -77,9 +76,9 @@ class MaxSceneLoader(load.LoaderPlugin): max_obj.name = f"{namespace}:{obj_name}" if max_obj in node_list: max_obj.pos = transform_data[ - f"{max_obj.name}.transform"] or max_obj.pos + f"{max_obj.name}.transform"] or 0 max_obj.scale = transform_data[ - f"{max_obj.name}.scale"] or max_obj.scale + f"{max_obj.name}.scale"] or 0 lib.imprint(container["instance_node"], { "representation": str(representation["_id"]) }) diff --git a/openpype/hosts/max/plugins/load/load_model_fbx.py b/openpype/hosts/max/plugins/load/load_model_fbx.py index a8f6ea90d6..bea4d28fb7 100644 --- a/openpype/hosts/max/plugins/load/load_model_fbx.py +++ b/openpype/hosts/max/plugins/load/load_model_fbx.py @@ -73,9 +73,9 @@ class FbxModelLoader(load.LoaderPlugin): fbx_object.name = f"{namespace}:{fbx_object.name}" if fbx_object in node_list: fbx_object.pos = transform_data[ - f"{fbx_object.name}.transform"] or fbx_object.pos + f"{fbx_object.name}.transform"] or 0 fbx_object.scale = transform_data[ - f"{fbx_object.name}.scale"] or fbx_object.scale + f"{fbx_object.name}.scale"] or 0 with maintained_selection(): rt.Select(node) diff --git a/openpype/hosts/max/plugins/load/load_model_obj.py b/openpype/hosts/max/plugins/load/load_model_obj.py index 421bd34e62..ca970fb9d7 100644 --- a/openpype/hosts/max/plugins/load/load_model_obj.py +++ b/openpype/hosts/max/plugins/load/load_model_obj.py @@ -68,9 +68,9 @@ class ObjLoader(load.LoaderPlugin): selection.name = f"{namespace}:{selection.name}" if selection in node_list: selection.pos = transform_data[ - f"{selection.name}.transform"] or selection.pos + f"{selection.name}.transform"] or 0 selection.scale = transform_data[ - f"{selection.name}.scale"] or selection.scale + f"{selection.name}.scale"] or 0 update_custom_attribute_data(node, selections) with maintained_selection(): rt.Select(node) diff --git a/openpype/hosts/max/plugins/load/load_model_usd.py b/openpype/hosts/max/plugins/load/load_model_usd.py index 67d0e75259..6476f65a04 100644 --- a/openpype/hosts/max/plugins/load/load_model_usd.py +++ b/openpype/hosts/max/plugins/load/load_model_usd.py @@ -93,9 +93,9 @@ class ModelUSDLoader(load.LoaderPlugin): usd_objects.append(children) if children in node_list: children.pos = transform_data[ - f"{children.name}.transform"] or children.pos + f"{children.name}.transform"] or 0 children.scale = transform_data[ - f"{children.name}.scale"] or children.scale + f"{children.name}.scale"] or 0 asset.name = f"{namespace}:{asset.name}" usd_objects.append(asset) From 70bab9fdb8e673350e76e2e7fc18e967b86c6e8e Mon Sep 17 00:00:00 2001 From: Kayla Man Date: Wed, 13 Sep 2023 21:59:57 +0800 Subject: [PATCH 27/36] fixing the issue of duplciated contents during switching assets --- openpype/hosts/max/plugins/load/load_camera_fbx.py | 5 ++++- openpype/hosts/max/plugins/load/load_model_fbx.py | 4 +++- openpype/hosts/max/plugins/load/load_model_obj.py | 4 +++- openpype/hosts/max/plugins/load/load_model_usd.py | 4 +++- 4 files changed, 13 insertions(+), 4 deletions(-) diff --git a/openpype/hosts/max/plugins/load/load_camera_fbx.py b/openpype/hosts/max/plugins/load/load_camera_fbx.py index 156e8dcaf6..5e4623fe4c 100644 --- a/openpype/hosts/max/plugins/load/load_camera_fbx.py +++ b/openpype/hosts/max/plugins/load/load_camera_fbx.py @@ -73,7 +73,10 @@ class FbxLoader(load.LoaderPlugin): rt.FBXImporterSetParam("Preserveinstances", True) rt.ImportFile( path, rt.name("noPrompt"), using=rt.FBXIMP) - current_fbx_objects = rt.GetCurrentSelection() + current_fbx_objects = [sel for sel in rt.GetCurrentSelection() + if sel != rt.Container + and sel.name == node_name] + update_custom_attribute_data(node, current_fbx_objects) for fbx_object in current_fbx_objects: fbx_object.name = f"{namespace}:{fbx_object.name}" diff --git a/openpype/hosts/max/plugins/load/load_model_fbx.py b/openpype/hosts/max/plugins/load/load_model_fbx.py index bea4d28fb7..9542eaa74e 100644 --- a/openpype/hosts/max/plugins/load/load_model_fbx.py +++ b/openpype/hosts/max/plugins/load/load_model_fbx.py @@ -56,7 +56,9 @@ class FbxModelLoader(load.LoaderPlugin): node_list = get_previous_loaded_object(node) rt.Select(node_list) - prev_fbx_objects = rt.GetCurrentSelection() + prev_fbx_objects = [sel for sel in rt.GetCurrentSelection() + if sel != rt.Container + and sel.name == node_name] transform_data = object_transform_set(prev_fbx_objects) for prev_fbx_obj in prev_fbx_objects: if rt.isValidNode(prev_fbx_obj): diff --git a/openpype/hosts/max/plugins/load/load_model_obj.py b/openpype/hosts/max/plugins/load/load_model_obj.py index ca970fb9d7..38ba5e3e8f 100644 --- a/openpype/hosts/max/plugins/load/load_model_obj.py +++ b/openpype/hosts/max/plugins/load/load_model_obj.py @@ -55,7 +55,9 @@ class ObjLoader(load.LoaderPlugin): namespace, _ = get_namespace(node_name) node_list = get_previous_loaded_object(node) rt.Select(node_list) - previous_objects = rt.GetCurrentSelection() + previous_objects = [sel for sel in rt.GetCurrentSelection() + if sel != rt.Container + and sel.name == node_name] transform_data = object_transform_set(previous_objects) for prev_obj in previous_objects: if rt.isValidNode(prev_obj): diff --git a/openpype/hosts/max/plugins/load/load_model_usd.py b/openpype/hosts/max/plugins/load/load_model_usd.py index 6476f65a04..cabcdaa6b5 100644 --- a/openpype/hosts/max/plugins/load/load_model_usd.py +++ b/openpype/hosts/max/plugins/load/load_model_usd.py @@ -71,7 +71,9 @@ class ModelUSDLoader(load.LoaderPlugin): namespace, name = get_namespace(node_name) node_list = get_previous_loaded_object(node) rt.Select(node_list) - prev_objects = rt.GetCurrentSelection() + prev_objects = [sel for sel in rt.GetCurrentSelection() + if sel != rt.Container + and sel.name == node_name] transform_data = object_transform_set(prev_objects) for n in prev_objects: rt.Delete(n) From c53abb50f07c5e7e1df185425e034f744d2314a8 Mon Sep 17 00:00:00 2001 From: Kayla Man Date: Wed, 13 Sep 2023 22:06:11 +0800 Subject: [PATCH 28/36] fixing the issue of duplciated contents during switching assets --- openpype/hosts/max/plugins/load/load_camera_fbx.py | 2 +- openpype/hosts/max/plugins/load/load_model_fbx.py | 2 +- openpype/hosts/max/plugins/load/load_model_usd.py | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/openpype/hosts/max/plugins/load/load_camera_fbx.py b/openpype/hosts/max/plugins/load/load_camera_fbx.py index 5e4623fe4c..1f891e19b3 100644 --- a/openpype/hosts/max/plugins/load/load_camera_fbx.py +++ b/openpype/hosts/max/plugins/load/load_camera_fbx.py @@ -75,7 +75,7 @@ class FbxLoader(load.LoaderPlugin): path, rt.name("noPrompt"), using=rt.FBXIMP) current_fbx_objects = [sel for sel in rt.GetCurrentSelection() if sel != rt.Container - and sel.name == node_name] + and sel.name != node_name] update_custom_attribute_data(node, current_fbx_objects) for fbx_object in current_fbx_objects: diff --git a/openpype/hosts/max/plugins/load/load_model_fbx.py b/openpype/hosts/max/plugins/load/load_model_fbx.py index 9542eaa74e..cdc5667d78 100644 --- a/openpype/hosts/max/plugins/load/load_model_fbx.py +++ b/openpype/hosts/max/plugins/load/load_model_fbx.py @@ -58,7 +58,7 @@ class FbxModelLoader(load.LoaderPlugin): rt.Select(node_list) prev_fbx_objects = [sel for sel in rt.GetCurrentSelection() if sel != rt.Container - and sel.name == node_name] + and sel.name != node_name] transform_data = object_transform_set(prev_fbx_objects) for prev_fbx_obj in prev_fbx_objects: if rt.isValidNode(prev_fbx_obj): diff --git a/openpype/hosts/max/plugins/load/load_model_usd.py b/openpype/hosts/max/plugins/load/load_model_usd.py index cabcdaa6b5..38233cfd62 100644 --- a/openpype/hosts/max/plugins/load/load_model_usd.py +++ b/openpype/hosts/max/plugins/load/load_model_usd.py @@ -73,7 +73,7 @@ class ModelUSDLoader(load.LoaderPlugin): rt.Select(node_list) prev_objects = [sel for sel in rt.GetCurrentSelection() if sel != rt.Container - and sel.name == node_name] + and sel.name != node_name] transform_data = object_transform_set(prev_objects) for n in prev_objects: rt.Delete(n) From 559021b5f6d42d644ed0efde7ae09ccba2399c6f Mon Sep 17 00:00:00 2001 From: Kayla Man Date: Thu, 14 Sep 2023 16:27:49 +0800 Subject: [PATCH 29/36] fix the bug of the 3dsmax OP data not being collected during switching version --- .../hosts/max/plugins/load/load_camera_fbx.py | 18 ++++++------- .../hosts/max/plugins/load/load_max_scene.py | 25 ++++++++++++------- .../hosts/max/plugins/load/load_model_fbx.py | 17 +++++++------ .../hosts/max/plugins/load/load_model_obj.py | 10 +++----- .../hosts/max/plugins/load/load_model_usd.py | 6 ++--- 5 files changed, 39 insertions(+), 37 deletions(-) diff --git a/openpype/hosts/max/plugins/load/load_camera_fbx.py b/openpype/hosts/max/plugins/load/load_camera_fbx.py index 1f891e19b3..ce1427a980 100644 --- a/openpype/hosts/max/plugins/load/load_camera_fbx.py +++ b/openpype/hosts/max/plugins/load/load_camera_fbx.py @@ -73,22 +73,18 @@ class FbxLoader(load.LoaderPlugin): rt.FBXImporterSetParam("Preserveinstances", True) rt.ImportFile( path, rt.name("noPrompt"), using=rt.FBXIMP) - current_fbx_objects = [sel for sel in rt.GetCurrentSelection() - if sel != rt.Container - and sel.name != node_name] - - update_custom_attribute_data(node, current_fbx_objects) + current_fbx_objects = rt.GetCurrentSelection() + fbx_objects = [] for fbx_object in current_fbx_objects: fbx_object.name = f"{namespace}:{fbx_object.name}" - if fbx_object in node_list: - fbx_object.pos = transform_data[ - f"{fbx_object.name}.transform"] or 0 + fbx_objects.append(fbx_object) + fbx_transform = f"{fbx_object.name}.transform" + if fbx_transform in transform_data.keys(): + fbx_object.pos = transform_data[fbx_transform] or 0 fbx_object.scale = transform_data[ f"{fbx_object.name}.scale"] or 0 - with maintained_selection(): - rt.Select(node) - + update_custom_attribute_data(node, fbx_objects) lib.imprint(container["instance_node"], { "representation": str(representation["_id"]) }) diff --git a/openpype/hosts/max/plugins/load/load_max_scene.py b/openpype/hosts/max/plugins/load/load_max_scene.py index b7ce5bfe39..4b66dbff6f 100644 --- a/openpype/hosts/max/plugins/load/load_max_scene.py +++ b/openpype/hosts/max/plugins/load/load_max_scene.py @@ -43,7 +43,6 @@ class MaxSceneLoader(load.LoaderPlugin): for max_obj, obj_name in zip(max_objects, max_object_names): max_obj.name = f"{namespace}:{obj_name}" max_container.append(rt.getNodeByName(max_obj.name)) - return containerise( name, max_container, context, namespace, loader=self.__class__.__name__) @@ -53,32 +52,40 @@ class MaxSceneLoader(load.LoaderPlugin): path = get_representation_path(representation) node_name = container["instance_node"] - + print(node_name) node = rt.getNodeByName(node_name) namespace, _ = get_namespace(node_name) # delete the old container with attribute # delete old duplicate # use the modifier OP data to delete the data node_list = get_previous_loaded_object(node) - prev_max_objects = rt.getLastMergedNodes() + rt.select(node_list) + prev_max_objects = rt.GetCurrentSelection() + print(f"{node_list}") transform_data = object_transform_set(prev_max_objects) + for prev_max_obj in prev_max_objects: if rt.isValidNode(prev_max_obj): # noqa rt.Delete(prev_max_obj) - rt.MergeMaxFile(path, rt.Name("deleteOldDups")) + rt.MergeMaxFile(path, quiet=True) current_max_objects = rt.getLastMergedNodes() + current_max_object_names = [obj.name for obj in current_max_objects] - update_custom_attribute_data(node, current_max_objects) + + max_objects = [] for max_obj, obj_name in zip(current_max_objects, - current_max_object_names): + current_max_object_names): max_obj.name = f"{namespace}:{obj_name}" - if max_obj in node_list: - max_obj.pos = transform_data[ - f"{max_obj.name}.transform"] or 0 + max_objects.append(max_obj) + max_transform = f"{max_obj.name}.transform" + if max_transform in transform_data.keys(): + max_obj.pos = transform_data[max_transform] or 0 max_obj.scale = transform_data[ f"{max_obj.name}.scale"] or 0 + + update_custom_attribute_data(node, max_objects) lib.imprint(container["instance_node"], { "representation": str(representation["_id"]) }) diff --git a/openpype/hosts/max/plugins/load/load_model_fbx.py b/openpype/hosts/max/plugins/load/load_model_fbx.py index cdc5667d78..71fc382eed 100644 --- a/openpype/hosts/max/plugins/load/load_model_fbx.py +++ b/openpype/hosts/max/plugins/load/load_model_fbx.py @@ -52,13 +52,13 @@ class FbxModelLoader(load.LoaderPlugin): path = get_representation_path(representation) node_name = container["instance_node"] node = rt.getNodeByName(node_name) + if not node: + rt.Container(name=node_name) namespace, _ = get_namespace(node_name) node_list = get_previous_loaded_object(node) rt.Select(node_list) - prev_fbx_objects = [sel for sel in rt.GetCurrentSelection() - if sel != rt.Container - and sel.name != node_name] + prev_fbx_objects = rt.GetCurrentSelection() transform_data = object_transform_set(prev_fbx_objects) for prev_fbx_obj in prev_fbx_objects: if rt.isValidNode(prev_fbx_obj): @@ -70,18 +70,19 @@ class FbxModelLoader(load.LoaderPlugin): rt.FBXImporterSetParam("Preserveinstances", True) rt.importFile(path, rt.name("noPrompt"), using=rt.FBXIMP) current_fbx_objects = rt.GetCurrentSelection() - update_custom_attribute_data(node, current_fbx_objects) + fbx_objects = [] for fbx_object in current_fbx_objects: fbx_object.name = f"{namespace}:{fbx_object.name}" - if fbx_object in node_list: - fbx_object.pos = transform_data[ - f"{fbx_object.name}.transform"] or 0 + fbx_objects.append(fbx_object) + fbx_transform = f"{fbx_object.name}.transform" + if fbx_transform in transform_data.keys(): + fbx_object.pos = transform_data[fbx_transform] or 0 fbx_object.scale = transform_data[ f"{fbx_object.name}.scale"] or 0 with maintained_selection(): rt.Select(node) - + update_custom_attribute_data(node, fbx_objects) lib.imprint(container["instance_node"], { "representation": str(representation["_id"]) }) diff --git a/openpype/hosts/max/plugins/load/load_model_obj.py b/openpype/hosts/max/plugins/load/load_model_obj.py index 38ba5e3e8f..aedb288a2d 100644 --- a/openpype/hosts/max/plugins/load/load_model_obj.py +++ b/openpype/hosts/max/plugins/load/load_model_obj.py @@ -55,9 +55,7 @@ class ObjLoader(load.LoaderPlugin): namespace, _ = get_namespace(node_name) node_list = get_previous_loaded_object(node) rt.Select(node_list) - previous_objects = [sel for sel in rt.GetCurrentSelection() - if sel != rt.Container - and sel.name == node_name] + previous_objects = rt.GetCurrentSelection() transform_data = object_transform_set(previous_objects) for prev_obj in previous_objects: if rt.isValidNode(prev_obj): @@ -68,9 +66,9 @@ class ObjLoader(load.LoaderPlugin): selections = rt.GetCurrentSelection() for selection in selections: selection.name = f"{namespace}:{selection.name}" - if selection in node_list: - selection.pos = transform_data[ - f"{selection.name}.transform"] or 0 + selection_transform = f"{selection.name}.transform" + if selection_transform in transform_data.keys(): + selection.pos = transform_data[selection_transform] or 0 selection.scale = transform_data[ f"{selection.name}.scale"] or 0 update_custom_attribute_data(node, selections) diff --git a/openpype/hosts/max/plugins/load/load_model_usd.py b/openpype/hosts/max/plugins/load/load_model_usd.py index 38233cfd62..bce4bd4a9a 100644 --- a/openpype/hosts/max/plugins/load/load_model_usd.py +++ b/openpype/hosts/max/plugins/load/load_model_usd.py @@ -93,9 +93,9 @@ class ModelUSDLoader(load.LoaderPlugin): for children in asset.Children: children.name = f"{namespace}:{children.name}" usd_objects.append(children) - if children in node_list: - children.pos = transform_data[ - f"{children.name}.transform"] or 0 + children_transform = f"{children.name}.transform" + if children_transform in transform_data.keys(): + children.pos = transform_data[children_transform] or 0 children.scale = transform_data[ f"{children.name}.scale"] or 0 From cad715ad0182cbfaa2093b7217723170af293887 Mon Sep 17 00:00:00 2001 From: Kayla Man Date: Thu, 14 Sep 2023 16:32:04 +0800 Subject: [PATCH 30/36] remove print & hound --- openpype/hosts/max/plugins/load/load_max_scene.py | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/openpype/hosts/max/plugins/load/load_max_scene.py b/openpype/hosts/max/plugins/load/load_max_scene.py index 4b66dbff6f..0b5f0a2858 100644 --- a/openpype/hosts/max/plugins/load/load_max_scene.py +++ b/openpype/hosts/max/plugins/load/load_max_scene.py @@ -52,7 +52,6 @@ class MaxSceneLoader(load.LoaderPlugin): path = get_representation_path(representation) node_name = container["instance_node"] - print(node_name) node = rt.getNodeByName(node_name) namespace, _ = get_namespace(node_name) # delete the old container with attribute @@ -61,7 +60,6 @@ class MaxSceneLoader(load.LoaderPlugin): node_list = get_previous_loaded_object(node) rt.select(node_list) prev_max_objects = rt.GetCurrentSelection() - print(f"{node_list}") transform_data = object_transform_set(prev_max_objects) for prev_max_obj in prev_max_objects: @@ -76,7 +74,7 @@ class MaxSceneLoader(load.LoaderPlugin): max_objects = [] for max_obj, obj_name in zip(current_max_objects, - current_max_object_names): + current_max_object_names): max_obj.name = f"{namespace}:{obj_name}" max_objects.append(max_obj) max_transform = f"{max_obj.name}.transform" From 93fb76f359c1d511eb491667a771088e02bb5131 Mon Sep 17 00:00:00 2001 From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com> Date: Thu, 14 Sep 2023 13:55:25 +0200 Subject: [PATCH 31/36] Extract Review: Multilayer specification for ffmpeg (#5613) * added function to extract more information about channels * specify layer name which should be used for ffmpeg * changed 'get_channels_info_by_layer_name' to 'get_review_info_by_layer_name' * modify docstring * fix dosctring again --- openpype/lib/transcoding.py | 168 ++++++++++++++++----- openpype/plugins/publish/extract_review.py | 32 +++- 2 files changed, 160 insertions(+), 40 deletions(-) diff --git a/openpype/lib/transcoding.py b/openpype/lib/transcoding.py index 6e323f55c1..97c8dd41ab 100644 --- a/openpype/lib/transcoding.py +++ b/openpype/lib/transcoding.py @@ -315,6 +315,92 @@ def parse_oiio_xml_output(xml_string, logger=None): return output +def get_review_info_by_layer_name(channel_names): + """Get channels info grouped by layer name. + + Finds all layers in channel names and returns list of dictionaries with + information about channels in layer. + Example output (not real world example): + [ + { + "name": "Main", + "review_channels": { + "R": "Main.red", + "G": "Main.green", + "B": "Main.blue", + "A": None, + } + }, + { + "name": "Composed", + "review_channels": { + "R": "Composed.R", + "G": "Composed.G", + "B": "Composed.B", + "A": "Composed.A", + } + }, + ... + ] + + Args: + channel_names (list[str]): List of channel names. + + Returns: + list[dict]: List of channels information. + """ + + layer_names_order = [] + rgba_by_layer_name = collections.defaultdict(dict) + channels_by_layer_name = collections.defaultdict(dict) + + for channel_name in channel_names: + layer_name = "" + last_part = channel_name + if "." in channel_name: + layer_name, last_part = channel_name.rsplit(".", 1) + + channels_by_layer_name[layer_name][channel_name] = last_part + if last_part.lower() not in { + "r", "red", + "g", "green", + "b", "blue", + "a", "alpha" + }: + continue + + if layer_name not in layer_names_order: + layer_names_order.append(layer_name) + # R, G, B or A + channel = last_part[0].upper() + rgba_by_layer_name[layer_name][channel] = channel_name + + # Put empty layer to the beginning of the list + # - if input has R, G, B, A channels they should be used for review + if "" in layer_names_order: + layer_names_order.remove("") + layer_names_order.insert(0, "") + + output = [] + for layer_name in layer_names_order: + rgba_layer_info = rgba_by_layer_name[layer_name] + red = rgba_layer_info.get("R") + green = rgba_layer_info.get("G") + blue = rgba_layer_info.get("B") + if not red or not green or not blue: + continue + output.append({ + "name": layer_name, + "review_channels": { + "R": red, + "G": green, + "B": blue, + "A": rgba_layer_info.get("A"), + } + }) + return output + + def get_convert_rgb_channels(channel_names): """Get first available RGB(A) group from channels info. @@ -323,7 +409,7 @@ def get_convert_rgb_channels(channel_names): # Ideal situation channels_info: [ "R", "G", "B", "A" - } + ] ``` Result will be `("R", "G", "B", "A")` @@ -331,50 +417,60 @@ def get_convert_rgb_channels(channel_names): # Not ideal situation channels_info: [ "beauty.red", - "beuaty.green", + "beauty.green", "beauty.blue", "depth.Z" ] ``` Result will be `("beauty.red", "beauty.green", "beauty.blue", None)` + Args: + channel_names (list[str]): List of channel names. + Returns: - NoneType: There is not channel combination that matches RGB - combination. - tuple: Tuple of 4 channel names defying channel names for R, G, B, A - where A can be None. + Union[NoneType, tuple[str, str, str, Union[str, None]]]: Tuple of + 4 channel names defying channel names for R, G, B, A or None + if there is not any layer with RGB combination. """ - rgb_by_main_name = collections.defaultdict(dict) - main_name_order = [""] - for channel_name in channel_names: - name_parts = channel_name.split(".") - rgb_part = name_parts.pop(-1).lower() - main_name = ".".join(name_parts) - if rgb_part in ("r", "red"): - rgb_by_main_name[main_name]["R"] = channel_name - elif rgb_part in ("g", "green"): - rgb_by_main_name[main_name]["G"] = channel_name - elif rgb_part in ("b", "blue"): - rgb_by_main_name[main_name]["B"] = channel_name - elif rgb_part in ("a", "alpha"): - rgb_by_main_name[main_name]["A"] = channel_name - else: - continue - if main_name not in main_name_order: - main_name_order.append(main_name) - output = None - for main_name in main_name_order: - colors = rgb_by_main_name.get(main_name) or {} - red = colors.get("R") - green = colors.get("G") - blue = colors.get("B") - alpha = colors.get("A") - if red is not None and green is not None and blue is not None: - output = (red, green, blue, alpha) - break + channels_info = get_review_info_by_layer_name(channel_names) + for item in channels_info: + review_channels = item["review_channels"] + return ( + review_channels["R"], + review_channels["G"], + review_channels["B"], + review_channels["A"] + ) + return None - return output + +def get_review_layer_name(src_filepath): + """Find layer name that could be used for review. + + Args: + src_filepath (str): Path to input file. + + Returns: + Union[str, None]: Layer name of None. + """ + + ext = os.path.splitext(src_filepath)[-1].lower() + if ext != ".exr": + return None + + # Load info about file from oiio tool + input_info = get_oiio_info_for_input(src_filepath) + if not input_info: + return None + + channel_names = input_info["channelnames"] + channels_info = get_review_info_by_layer_name(channel_names) + for item in channels_info: + # Layer name can be '', when review channels are 'R', 'G', 'B' + # without layer + return item["name"] or None + return None def should_convert_for_ffmpeg(src_filepath): @@ -395,7 +491,7 @@ def should_convert_for_ffmpeg(src_filepath): if not is_oiio_supported(): return None - # Load info about info from oiio tool + # Load info about file from oiio tool input_info = get_oiio_info_for_input(src_filepath) if not input_info: return None diff --git a/openpype/plugins/publish/extract_review.py b/openpype/plugins/publish/extract_review.py index 9cc456872e..0ae941511c 100644 --- a/openpype/plugins/publish/extract_review.py +++ b/openpype/plugins/publish/extract_review.py @@ -21,6 +21,7 @@ from openpype.lib.transcoding import ( IMAGE_EXTENSIONS, get_ffprobe_streams, should_convert_for_ffmpeg, + get_review_layer_name, convert_input_paths_for_ffmpeg, get_transcode_temp_directory, ) @@ -266,6 +267,8 @@ class ExtractReview(pyblish.api.InstancePlugin): )) continue + layer_name = get_review_layer_name(first_input_path) + # Do conversion if needed # - change staging dir of source representation # - must be set back after output definitions processing @@ -284,7 +287,8 @@ class ExtractReview(pyblish.api.InstancePlugin): instance, repre, src_repre_staging_dir, - filtered_output_defs + filtered_output_defs, + layer_name ) finally: @@ -298,7 +302,12 @@ class ExtractReview(pyblish.api.InstancePlugin): shutil.rmtree(new_staging_dir) def _render_output_definitions( - self, instance, repre, src_repre_staging_dir, output_definitions + self, + instance, + repre, + src_repre_staging_dir, + output_definitions, + layer_name ): fill_data = copy.deepcopy(instance.data["anatomyData"]) for _output_def in output_definitions: @@ -370,7 +379,12 @@ class ExtractReview(pyblish.api.InstancePlugin): try: # temporary until oiiotool is supported cross platform ffmpeg_args = self._ffmpeg_arguments( - output_def, instance, new_repre, temp_data, fill_data + output_def, + instance, + new_repre, + temp_data, + fill_data, + layer_name, ) except ZeroDivisionError: # TODO recalculate width and height using OIIO before @@ -531,7 +545,13 @@ class ExtractReview(pyblish.api.InstancePlugin): } def _ffmpeg_arguments( - self, output_def, instance, new_repre, temp_data, fill_data + self, + output_def, + instance, + new_repre, + temp_data, + fill_data, + layer_name ): """Prepares ffmpeg arguments for expected extraction. @@ -599,6 +619,10 @@ class ExtractReview(pyblish.api.InstancePlugin): duration_seconds = float(output_frames_len / temp_data["fps"]) + # Define which layer should be used + if layer_name: + ffmpeg_input_args.extend(["-layer", layer_name]) + if temp_data["input_is_sequence"]: # Set start frame of input sequence (just frame in filename) # - definition of input filepath From 8729cf023c3138e5c69b32dac21eb6def73c41fc Mon Sep 17 00:00:00 2001 From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com> Date: Thu, 14 Sep 2023 18:57:23 +0200 Subject: [PATCH 32/36] Publisher: Fix screenshot widget (#5615) * fix called super method name * remove fade animation * use paths to draw background * use same opacity for lines * add render hints * minor cleanup --- .../publisher/widgets/screenshot_widget.py | 44 +++++++------------ 1 file changed, 17 insertions(+), 27 deletions(-) diff --git a/openpype/tools/publisher/widgets/screenshot_widget.py b/openpype/tools/publisher/widgets/screenshot_widget.py index 64cccece6c..3504b419b4 100644 --- a/openpype/tools/publisher/widgets/screenshot_widget.py +++ b/openpype/tools/publisher/widgets/screenshot_widget.py @@ -26,14 +26,6 @@ class ScreenMarquee(QtWidgets.QDialog): self.setCursor(QtCore.Qt.CrossCursor) self.setMouseTracking(True) - fade_anim = QtCore.QVariantAnimation() - fade_anim.setStartValue(0) - fade_anim.setEndValue(50) - fade_anim.setDuration(200) - fade_anim.setEasingCurve(QtCore.QEasingCurve.OutCubic) - - fade_anim.valueChanged.connect(self._on_fade_anim) - app = QtWidgets.QApplication.instance() if hasattr(app, "screenAdded"): app.screenAdded.connect(self._on_screen_added) @@ -45,12 +37,10 @@ class ScreenMarquee(QtWidgets.QDialog): for screen in QtWidgets.QApplication.screens(): screen.geometryChanged.connect(self._fit_screen_geometry) - self._opacity = fade_anim.startValue() + self._opacity = 50 self._click_pos = None self._capture_rect = None - self._fade_anim = fade_anim - def get_captured_pixmap(self): if self._capture_rect is None: return QtGui.QPixmap() @@ -67,28 +57,33 @@ class ScreenMarquee(QtWidgets.QDialog): click_pos = self.mapFromGlobal(self._click_pos) painter = QtGui.QPainter(self) + painter.setRenderHints( + QtGui.QPainter.Antialiasing + | QtGui.QPainter.SmoothPixmapTransform + ) # Draw background. Aside from aesthetics, this makes the full # tool region accept mouse events. painter.setBrush(QtGui.QColor(0, 0, 0, self._opacity)) painter.setPen(QtCore.Qt.NoPen) - painter.drawRect(event.rect()) + rect = event.rect() + fill_path = QtGui.QPainterPath() + fill_path.addRect(rect) # Clear the capture area if click_pos is not None: + sub_path = QtGui.QPainterPath() capture_rect = QtCore.QRect(click_pos, mouse_pos) - painter.setCompositionMode( - QtGui.QPainter.CompositionMode_Clear) - painter.drawRect(capture_rect) - painter.setCompositionMode( - QtGui.QPainter.CompositionMode_SourceOver) + sub_path.addRect(capture_rect) + fill_path = fill_path.subtracted(sub_path) - pen_color = QtGui.QColor(255, 255, 255, 64) + painter.drawPath(fill_path) + + pen_color = QtGui.QColor(255, 255, 255, self._opacity) pen = QtGui.QPen(pen_color, 1, QtCore.Qt.DotLine) painter.setPen(pen) # Draw cropping markers at click position - rect = event.rect() if click_pos is not None: painter.drawLine( rect.left(), click_pos.y(), @@ -108,6 +103,7 @@ class ScreenMarquee(QtWidgets.QDialog): mouse_pos.x(), rect.top(), mouse_pos.x(), rect.bottom() ) + painter.end() def mousePressEvent(self, event): """Mouse click event""" @@ -138,13 +134,13 @@ class ScreenMarquee(QtWidgets.QDialog): if event.key() == QtCore.Qt.Key_Escape: self._click_pos = None self._capture_rect = None + event.accept() self.close() return - return super(ScreenMarquee, self).mousePressEvent(event) + return super(ScreenMarquee, self).keyPressEvent(event) def showEvent(self, event): self._fit_screen_geometry() - self._fade_anim.start() def _fit_screen_geometry(self): # Compute the union of all screen geometries, and resize to fit. @@ -153,12 +149,6 @@ class ScreenMarquee(QtWidgets.QDialog): workspace_rect = workspace_rect.united(screen.geometry()) self.setGeometry(workspace_rect) - def _on_fade_anim(self): - """Animation callback for opacity.""" - - self._opacity = self._fade_anim.currentValue() - self.repaint() - def _on_screen_added(self): for screen in QtGui.QGuiApplication.screens(): screen.geometryChanged.connect(self._fit_screen_geometry) From b50258874360687b4a1e36eff9935084db526456 Mon Sep 17 00:00:00 2001 From: Petr Kalis Date: Fri, 15 Sep 2023 10:54:53 +0200 Subject: [PATCH 33/36] Fix - images without alpha will not fail (#5620) --- .../photoshop/plugins/publish/extract_review.py | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/openpype/hosts/photoshop/plugins/publish/extract_review.py b/openpype/hosts/photoshop/plugins/publish/extract_review.py index afddbdba31..d5dac417d7 100644 --- a/openpype/hosts/photoshop/plugins/publish/extract_review.py +++ b/openpype/hosts/photoshop/plugins/publish/extract_review.py @@ -140,10 +140,14 @@ class ExtractReview(publish.Extractor): _, ext = os.path.splitext(repre_file["files"]) if ext != ".jpg": im = Image.open(source_file_path) - # without this it produces messy low quality jpg - rgb_im = Image.new("RGBA", (im.width, im.height), "#ffffff") - rgb_im.alpha_composite(im) - rgb_im.convert("RGB").save(os.path.join(staging_dir, img_file)) + if (im.mode in ('RGBA', 'LA') or ( + im.mode == 'P' and 'transparency' in im.info)): + # without this it produces messy low quality jpg + rgb_im = Image.new("RGBA", (im.width, im.height), "#ffffff") + rgb_im.alpha_composite(im) + rgb_im.convert("RGB").save(os.path.join(staging_dir, img_file)) + else: + im.save(os.path.join(staging_dir, img_file)) else: # handles already .jpg shutil.copy(source_file_path, From 67abbaad3c2bdbbf561bc7d30d6ac1adc5b21ed8 Mon Sep 17 00:00:00 2001 From: Petr Kalis Date: Fri, 15 Sep 2023 11:02:37 +0200 Subject: [PATCH 34/36] Fussion: added support for Fusion 17 (#5614) * OP-6780 - vendorized necessary libraries for Python 3.6 * OP-6780 - better resolution of app_version * Update openpype/hosts/fusion/addon.py Co-authored-by: Roy Nieterau * OP-6780 - add vendorized libraries even before menu creation This should help when version of Fusion > 17, but it is still using 3.6 * OP-6780 - added todo message to remember to remove this * OP-6780 - move injection of PYTHONPATH much sooner At previous position it was too late. * OP-6780 - better capture of broken imports * OP-6780 - SyntaxError is thrown only if directly importing * OP-6780 - remove unnecessary imports Only urllib3 and attrs are actually needed * OP-6780 - vendorize even directly in Fusion if Python < 3.7 * OP-6780 - remove update of PYTHONPATH in addon More important and required is check directly in interpreter in Fusion, it doesn't make sense to pollute addon and have it on two places. It might get removed altogether in next-minor. * OP-6780 - added comment --------- Co-authored-by: Roy Nieterau --- openpype/hosts/fusion/addon.py | 3 +- .../deploy/MenuScripts/openpype_menu.py | 13 + openpype/hosts/fusion/vendor/attr/__init__.py | 78 + .../hosts/fusion/vendor/attr/__init__.pyi | 475 +++ openpype/hosts/fusion/vendor/attr/_cmp.py | 152 + openpype/hosts/fusion/vendor/attr/_cmp.pyi | 14 + openpype/hosts/fusion/vendor/attr/_compat.py | 242 ++ openpype/hosts/fusion/vendor/attr/_config.py | 23 + openpype/hosts/fusion/vendor/attr/_funcs.py | 395 +++ openpype/hosts/fusion/vendor/attr/_make.py | 3052 +++++++++++++++++ .../hosts/fusion/vendor/attr/_next_gen.py | 158 + .../hosts/fusion/vendor/attr/_version_info.py | 85 + .../fusion/vendor/attr/_version_info.pyi | 9 + .../hosts/fusion/vendor/attr/converters.py | 111 + .../hosts/fusion/vendor/attr/converters.pyi | 13 + .../hosts/fusion/vendor/attr/exceptions.py | 92 + .../hosts/fusion/vendor/attr/exceptions.pyi | 18 + openpype/hosts/fusion/vendor/attr/filters.py | 52 + openpype/hosts/fusion/vendor/attr/filters.pyi | 7 + openpype/hosts/fusion/vendor/attr/py.typed | 0 openpype/hosts/fusion/vendor/attr/setters.py | 77 + openpype/hosts/fusion/vendor/attr/setters.pyi | 20 + .../hosts/fusion/vendor/attr/validators.py | 379 ++ .../hosts/fusion/vendor/attr/validators.pyi | 68 + .../hosts/fusion/vendor/urllib3/__init__.py | 85 + .../fusion/vendor/urllib3/_collections.py | 337 ++ .../hosts/fusion/vendor/urllib3/_version.py | 2 + .../hosts/fusion/vendor/urllib3/connection.py | 539 +++ .../fusion/vendor/urllib3/connectionpool.py | 1067 ++++++ .../fusion/vendor/urllib3/contrib/__init__.py | 0 .../urllib3/contrib/_appengine_environ.py | 36 + .../contrib/_securetransport/__init__.py | 0 .../contrib/_securetransport/bindings.py | 519 +++ .../contrib/_securetransport/low_level.py | 396 +++ .../vendor/urllib3/contrib/appengine.py | 314 ++ .../fusion/vendor/urllib3/contrib/ntlmpool.py | 130 + .../vendor/urllib3/contrib/pyopenssl.py | 511 +++ .../vendor/urllib3/contrib/securetransport.py | 922 +++++ .../fusion/vendor/urllib3/contrib/socks.py | 216 ++ .../hosts/fusion/vendor/urllib3/exceptions.py | 323 ++ .../hosts/fusion/vendor/urllib3/fields.py | 274 ++ .../hosts/fusion/vendor/urllib3/filepost.py | 98 + .../vendor/urllib3/packages/__init__.py | 5 + .../urllib3/packages/backports/__init__.py | 0 .../urllib3/packages/backports/makefile.py | 51 + .../fusion/vendor/urllib3/packages/six.py | 1077 ++++++ .../packages/ssl_match_hostname/__init__.py | 24 + .../ssl_match_hostname/_implementation.py | 160 + .../fusion/vendor/urllib3/poolmanager.py | 536 +++ .../hosts/fusion/vendor/urllib3/request.py | 170 + .../hosts/fusion/vendor/urllib3/response.py | 821 +++++ .../fusion/vendor/urllib3/util/__init__.py | 49 + .../fusion/vendor/urllib3/util/connection.py | 150 + .../hosts/fusion/vendor/urllib3/util/proxy.py | 56 + .../hosts/fusion/vendor/urllib3/util/queue.py | 22 + .../fusion/vendor/urllib3/util/request.py | 143 + .../fusion/vendor/urllib3/util/response.py | 107 + .../hosts/fusion/vendor/urllib3/util/retry.py | 602 ++++ .../hosts/fusion/vendor/urllib3/util/ssl_.py | 495 +++ .../vendor/urllib3/util/ssltransport.py | 221 ++ .../fusion/vendor/urllib3/util/timeout.py | 268 ++ .../hosts/fusion/vendor/urllib3/util/url.py | 432 +++ .../hosts/fusion/vendor/urllib3/util/wait.py | 153 + 63 files changed, 16846 insertions(+), 1 deletion(-) create mode 100644 openpype/hosts/fusion/vendor/attr/__init__.py create mode 100644 openpype/hosts/fusion/vendor/attr/__init__.pyi create mode 100644 openpype/hosts/fusion/vendor/attr/_cmp.py create mode 100644 openpype/hosts/fusion/vendor/attr/_cmp.pyi create mode 100644 openpype/hosts/fusion/vendor/attr/_compat.py create mode 100644 openpype/hosts/fusion/vendor/attr/_config.py create mode 100644 openpype/hosts/fusion/vendor/attr/_funcs.py create mode 100644 openpype/hosts/fusion/vendor/attr/_make.py create mode 100644 openpype/hosts/fusion/vendor/attr/_next_gen.py create mode 100644 openpype/hosts/fusion/vendor/attr/_version_info.py create mode 100644 openpype/hosts/fusion/vendor/attr/_version_info.pyi create mode 100644 openpype/hosts/fusion/vendor/attr/converters.py create mode 100644 openpype/hosts/fusion/vendor/attr/converters.pyi create mode 100644 openpype/hosts/fusion/vendor/attr/exceptions.py create mode 100644 openpype/hosts/fusion/vendor/attr/exceptions.pyi create mode 100644 openpype/hosts/fusion/vendor/attr/filters.py create mode 100644 openpype/hosts/fusion/vendor/attr/filters.pyi create mode 100644 openpype/hosts/fusion/vendor/attr/py.typed create mode 100644 openpype/hosts/fusion/vendor/attr/setters.py create mode 100644 openpype/hosts/fusion/vendor/attr/setters.pyi create mode 100644 openpype/hosts/fusion/vendor/attr/validators.py create mode 100644 openpype/hosts/fusion/vendor/attr/validators.pyi create mode 100644 openpype/hosts/fusion/vendor/urllib3/__init__.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/_collections.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/_version.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/connection.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/connectionpool.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/contrib/__init__.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/contrib/_appengine_environ.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/contrib/_securetransport/__init__.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/contrib/_securetransport/bindings.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/contrib/_securetransport/low_level.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/contrib/appengine.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/contrib/ntlmpool.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/contrib/pyopenssl.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/contrib/securetransport.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/contrib/socks.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/exceptions.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/fields.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/filepost.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/packages/__init__.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/packages/backports/__init__.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/packages/backports/makefile.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/packages/six.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/packages/ssl_match_hostname/__init__.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/packages/ssl_match_hostname/_implementation.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/poolmanager.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/request.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/response.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/util/__init__.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/util/connection.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/util/proxy.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/util/queue.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/util/request.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/util/response.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/util/retry.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/util/ssl_.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/util/ssltransport.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/util/timeout.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/util/url.py create mode 100644 openpype/hosts/fusion/vendor/urllib3/util/wait.py diff --git a/openpype/hosts/fusion/addon.py b/openpype/hosts/fusion/addon.py index 45683cfbde..8343f3c79d 100644 --- a/openpype/hosts/fusion/addon.py +++ b/openpype/hosts/fusion/addon.py @@ -60,8 +60,9 @@ class FusionAddon(OpenPypeModule, IHostAddon): return [] return [os.path.join(FUSION_HOST_DIR, "hooks")] - def add_implementation_envs(self, env, _app): + def add_implementation_envs(self, env, app): # Set default values if are not already set via settings + defaults = {"OPENPYPE_LOG_NO_COLORS": "Yes"} for key, value in defaults.items(): if not env.get(key): diff --git a/openpype/hosts/fusion/deploy/MenuScripts/openpype_menu.py b/openpype/hosts/fusion/deploy/MenuScripts/openpype_menu.py index 685e58d58f..1c58ee50e4 100644 --- a/openpype/hosts/fusion/deploy/MenuScripts/openpype_menu.py +++ b/openpype/hosts/fusion/deploy/MenuScripts/openpype_menu.py @@ -1,6 +1,19 @@ import os import sys +if sys.version_info < (3, 7): + # hack to handle discrepancy between distributed libraries and Python 3.6 + # mostly because wrong version of urllib3 + # TODO remove when not necessary + from openpype import PACKAGE_DIR + FUSION_HOST_DIR = os.path.join(PACKAGE_DIR, "hosts", "fusion") + + vendor_path = os.path.join(FUSION_HOST_DIR, "vendor") + if vendor_path not in sys.path: + sys.path.insert(0, vendor_path) + + print(f"Added vendorized libraries from {vendor_path}") + from openpype.lib import Logger from openpype.pipeline import ( install_host, diff --git a/openpype/hosts/fusion/vendor/attr/__init__.py b/openpype/hosts/fusion/vendor/attr/__init__.py new file mode 100644 index 0000000000..b1ce7fe248 --- /dev/null +++ b/openpype/hosts/fusion/vendor/attr/__init__.py @@ -0,0 +1,78 @@ +from __future__ import absolute_import, division, print_function + +import sys + +from functools import partial + +from . import converters, exceptions, filters, setters, validators +from ._cmp import cmp_using +from ._config import get_run_validators, set_run_validators +from ._funcs import asdict, assoc, astuple, evolve, has, resolve_types +from ._make import ( + NOTHING, + Attribute, + Factory, + attrib, + attrs, + fields, + fields_dict, + make_class, + validate, +) +from ._version_info import VersionInfo + + +__version__ = "21.2.0" +__version_info__ = VersionInfo._from_version_string(__version__) + +__title__ = "attrs" +__description__ = "Classes Without Boilerplate" +__url__ = "https://www.attrs.org/" +__uri__ = __url__ +__doc__ = __description__ + " <" + __uri__ + ">" + +__author__ = "Hynek Schlawack" +__email__ = "hs@ox.cx" + +__license__ = "MIT" +__copyright__ = "Copyright (c) 2015 Hynek Schlawack" + + +s = attributes = attrs +ib = attr = attrib +dataclass = partial(attrs, auto_attribs=True) # happy Easter ;) + +__all__ = [ + "Attribute", + "Factory", + "NOTHING", + "asdict", + "assoc", + "astuple", + "attr", + "attrib", + "attributes", + "attrs", + "cmp_using", + "converters", + "evolve", + "exceptions", + "fields", + "fields_dict", + "filters", + "get_run_validators", + "has", + "ib", + "make_class", + "resolve_types", + "s", + "set_run_validators", + "setters", + "validate", + "validators", +] + +if sys.version_info[:2] >= (3, 6): + from ._next_gen import define, field, frozen, mutable + + __all__.extend((define, field, frozen, mutable)) diff --git a/openpype/hosts/fusion/vendor/attr/__init__.pyi b/openpype/hosts/fusion/vendor/attr/__init__.pyi new file mode 100644 index 0000000000..3503b073b4 --- /dev/null +++ b/openpype/hosts/fusion/vendor/attr/__init__.pyi @@ -0,0 +1,475 @@ +import sys + +from typing import ( + Any, + Callable, + Dict, + Generic, + List, + Mapping, + Optional, + Sequence, + Tuple, + Type, + TypeVar, + Union, + overload, +) + +# `import X as X` is required to make these public +from . import converters as converters +from . import exceptions as exceptions +from . import filters as filters +from . import setters as setters +from . import validators as validators +from ._version_info import VersionInfo + + +__version__: str +__version_info__: VersionInfo +__title__: str +__description__: str +__url__: str +__uri__: str +__author__: str +__email__: str +__license__: str +__copyright__: str + +_T = TypeVar("_T") +_C = TypeVar("_C", bound=type) + +_EqOrderType = Union[bool, Callable[[Any], Any]] +_ValidatorType = Callable[[Any, Attribute[_T], _T], Any] +_ConverterType = Callable[[Any], Any] +_FilterType = Callable[[Attribute[_T], _T], bool] +_ReprType = Callable[[Any], str] +_ReprArgType = Union[bool, _ReprType] +_OnSetAttrType = Callable[[Any, Attribute[Any], Any], Any] +_OnSetAttrArgType = Union[ + _OnSetAttrType, List[_OnSetAttrType], setters._NoOpType +] +_FieldTransformer = Callable[[type, List[Attribute[Any]]], List[Attribute[Any]]] +# FIXME: in reality, if multiple validators are passed they must be in a list +# or tuple, but those are invariant and so would prevent subtypes of +# _ValidatorType from working when passed in a list or tuple. +_ValidatorArgType = Union[_ValidatorType[_T], Sequence[_ValidatorType[_T]]] + +# _make -- + +NOTHING: object + +# NOTE: Factory lies about its return type to make this possible: +# `x: List[int] # = Factory(list)` +# Work around mypy issue #4554 in the common case by using an overload. +if sys.version_info >= (3, 8): + from typing import Literal + + @overload + def Factory(factory: Callable[[], _T]) -> _T: ... + @overload + def Factory( + factory: Callable[[Any], _T], + takes_self: Literal[True], + ) -> _T: ... + @overload + def Factory( + factory: Callable[[], _T], + takes_self: Literal[False], + ) -> _T: ... +else: + @overload + def Factory(factory: Callable[[], _T]) -> _T: ... + @overload + def Factory( + factory: Union[Callable[[Any], _T], Callable[[], _T]], + takes_self: bool = ..., + ) -> _T: ... + +# Static type inference support via __dataclass_transform__ implemented as per: +# https://github.com/microsoft/pyright/blob/1.1.135/specs/dataclass_transforms.md +# This annotation must be applied to all overloads of "define" and "attrs" +# +# NOTE: This is a typing construct and does not exist at runtime. Extensions +# wrapping attrs decorators should declare a separate __dataclass_transform__ +# signature in the extension module using the specification linked above to +# provide pyright support. +def __dataclass_transform__( + *, + eq_default: bool = True, + order_default: bool = False, + kw_only_default: bool = False, + field_descriptors: Tuple[Union[type, Callable[..., Any]], ...] = (()), +) -> Callable[[_T], _T]: ... + +class Attribute(Generic[_T]): + name: str + default: Optional[_T] + validator: Optional[_ValidatorType[_T]] + repr: _ReprArgType + cmp: _EqOrderType + eq: _EqOrderType + order: _EqOrderType + hash: Optional[bool] + init: bool + converter: Optional[_ConverterType] + metadata: Dict[Any, Any] + type: Optional[Type[_T]] + kw_only: bool + on_setattr: _OnSetAttrType + + def evolve(self, **changes: Any) -> "Attribute[Any]": ... + +# NOTE: We had several choices for the annotation to use for type arg: +# 1) Type[_T] +# - Pros: Handles simple cases correctly +# - Cons: Might produce less informative errors in the case of conflicting +# TypeVars e.g. `attr.ib(default='bad', type=int)` +# 2) Callable[..., _T] +# - Pros: Better error messages than #1 for conflicting TypeVars +# - Cons: Terrible error messages for validator checks. +# e.g. attr.ib(type=int, validator=validate_str) +# -> error: Cannot infer function type argument +# 3) type (and do all of the work in the mypy plugin) +# - Pros: Simple here, and we could customize the plugin with our own errors. +# - Cons: Would need to write mypy plugin code to handle all the cases. +# We chose option #1. + +# `attr` lies about its return type to make the following possible: +# attr() -> Any +# attr(8) -> int +# attr(validator=) -> Whatever the callable expects. +# This makes this type of assignments possible: +# x: int = attr(8) +# +# This form catches explicit None or no default but with no other arguments +# returns Any. +@overload +def attrib( + default: None = ..., + validator: None = ..., + repr: _ReprArgType = ..., + cmp: Optional[_EqOrderType] = ..., + hash: Optional[bool] = ..., + init: bool = ..., + metadata: Optional[Mapping[Any, Any]] = ..., + type: None = ..., + converter: None = ..., + factory: None = ..., + kw_only: bool = ..., + eq: Optional[_EqOrderType] = ..., + order: Optional[_EqOrderType] = ..., + on_setattr: Optional[_OnSetAttrArgType] = ..., +) -> Any: ... + +# This form catches an explicit None or no default and infers the type from the +# other arguments. +@overload +def attrib( + default: None = ..., + validator: Optional[_ValidatorArgType[_T]] = ..., + repr: _ReprArgType = ..., + cmp: Optional[_EqOrderType] = ..., + hash: Optional[bool] = ..., + init: bool = ..., + metadata: Optional[Mapping[Any, Any]] = ..., + type: Optional[Type[_T]] = ..., + converter: Optional[_ConverterType] = ..., + factory: Optional[Callable[[], _T]] = ..., + kw_only: bool = ..., + eq: Optional[_EqOrderType] = ..., + order: Optional[_EqOrderType] = ..., + on_setattr: Optional[_OnSetAttrArgType] = ..., +) -> _T: ... + +# This form catches an explicit default argument. +@overload +def attrib( + default: _T, + validator: Optional[_ValidatorArgType[_T]] = ..., + repr: _ReprArgType = ..., + cmp: Optional[_EqOrderType] = ..., + hash: Optional[bool] = ..., + init: bool = ..., + metadata: Optional[Mapping[Any, Any]] = ..., + type: Optional[Type[_T]] = ..., + converter: Optional[_ConverterType] = ..., + factory: Optional[Callable[[], _T]] = ..., + kw_only: bool = ..., + eq: Optional[_EqOrderType] = ..., + order: Optional[_EqOrderType] = ..., + on_setattr: Optional[_OnSetAttrArgType] = ..., +) -> _T: ... + +# This form covers type=non-Type: e.g. forward references (str), Any +@overload +def attrib( + default: Optional[_T] = ..., + validator: Optional[_ValidatorArgType[_T]] = ..., + repr: _ReprArgType = ..., + cmp: Optional[_EqOrderType] = ..., + hash: Optional[bool] = ..., + init: bool = ..., + metadata: Optional[Mapping[Any, Any]] = ..., + type: object = ..., + converter: Optional[_ConverterType] = ..., + factory: Optional[Callable[[], _T]] = ..., + kw_only: bool = ..., + eq: Optional[_EqOrderType] = ..., + order: Optional[_EqOrderType] = ..., + on_setattr: Optional[_OnSetAttrArgType] = ..., +) -> Any: ... +@overload +def field( + *, + default: None = ..., + validator: None = ..., + repr: _ReprArgType = ..., + hash: Optional[bool] = ..., + init: bool = ..., + metadata: Optional[Mapping[Any, Any]] = ..., + converter: None = ..., + factory: None = ..., + kw_only: bool = ..., + eq: Optional[bool] = ..., + order: Optional[bool] = ..., + on_setattr: Optional[_OnSetAttrArgType] = ..., +) -> Any: ... + +# This form catches an explicit None or no default and infers the type from the +# other arguments. +@overload +def field( + *, + default: None = ..., + validator: Optional[_ValidatorArgType[_T]] = ..., + repr: _ReprArgType = ..., + hash: Optional[bool] = ..., + init: bool = ..., + metadata: Optional[Mapping[Any, Any]] = ..., + converter: Optional[_ConverterType] = ..., + factory: Optional[Callable[[], _T]] = ..., + kw_only: bool = ..., + eq: Optional[_EqOrderType] = ..., + order: Optional[_EqOrderType] = ..., + on_setattr: Optional[_OnSetAttrArgType] = ..., +) -> _T: ... + +# This form catches an explicit default argument. +@overload +def field( + *, + default: _T, + validator: Optional[_ValidatorArgType[_T]] = ..., + repr: _ReprArgType = ..., + hash: Optional[bool] = ..., + init: bool = ..., + metadata: Optional[Mapping[Any, Any]] = ..., + converter: Optional[_ConverterType] = ..., + factory: Optional[Callable[[], _T]] = ..., + kw_only: bool = ..., + eq: Optional[_EqOrderType] = ..., + order: Optional[_EqOrderType] = ..., + on_setattr: Optional[_OnSetAttrArgType] = ..., +) -> _T: ... + +# This form covers type=non-Type: e.g. forward references (str), Any +@overload +def field( + *, + default: Optional[_T] = ..., + validator: Optional[_ValidatorArgType[_T]] = ..., + repr: _ReprArgType = ..., + hash: Optional[bool] = ..., + init: bool = ..., + metadata: Optional[Mapping[Any, Any]] = ..., + converter: Optional[_ConverterType] = ..., + factory: Optional[Callable[[], _T]] = ..., + kw_only: bool = ..., + eq: Optional[_EqOrderType] = ..., + order: Optional[_EqOrderType] = ..., + on_setattr: Optional[_OnSetAttrArgType] = ..., +) -> Any: ... +@overload +@__dataclass_transform__(order_default=True, field_descriptors=(attrib, field)) +def attrs( + maybe_cls: _C, + these: Optional[Dict[str, Any]] = ..., + repr_ns: Optional[str] = ..., + repr: bool = ..., + cmp: Optional[_EqOrderType] = ..., + hash: Optional[bool] = ..., + init: bool = ..., + slots: bool = ..., + frozen: bool = ..., + weakref_slot: bool = ..., + str: bool = ..., + auto_attribs: bool = ..., + kw_only: bool = ..., + cache_hash: bool = ..., + auto_exc: bool = ..., + eq: Optional[_EqOrderType] = ..., + order: Optional[_EqOrderType] = ..., + auto_detect: bool = ..., + collect_by_mro: bool = ..., + getstate_setstate: Optional[bool] = ..., + on_setattr: Optional[_OnSetAttrArgType] = ..., + field_transformer: Optional[_FieldTransformer] = ..., +) -> _C: ... +@overload +@__dataclass_transform__(order_default=True, field_descriptors=(attrib, field)) +def attrs( + maybe_cls: None = ..., + these: Optional[Dict[str, Any]] = ..., + repr_ns: Optional[str] = ..., + repr: bool = ..., + cmp: Optional[_EqOrderType] = ..., + hash: Optional[bool] = ..., + init: bool = ..., + slots: bool = ..., + frozen: bool = ..., + weakref_slot: bool = ..., + str: bool = ..., + auto_attribs: bool = ..., + kw_only: bool = ..., + cache_hash: bool = ..., + auto_exc: bool = ..., + eq: Optional[_EqOrderType] = ..., + order: Optional[_EqOrderType] = ..., + auto_detect: bool = ..., + collect_by_mro: bool = ..., + getstate_setstate: Optional[bool] = ..., + on_setattr: Optional[_OnSetAttrArgType] = ..., + field_transformer: Optional[_FieldTransformer] = ..., +) -> Callable[[_C], _C]: ... +@overload +@__dataclass_transform__(field_descriptors=(attrib, field)) +def define( + maybe_cls: _C, + *, + these: Optional[Dict[str, Any]] = ..., + repr: bool = ..., + hash: Optional[bool] = ..., + init: bool = ..., + slots: bool = ..., + frozen: bool = ..., + weakref_slot: bool = ..., + str: bool = ..., + auto_attribs: bool = ..., + kw_only: bool = ..., + cache_hash: bool = ..., + auto_exc: bool = ..., + eq: Optional[bool] = ..., + order: Optional[bool] = ..., + auto_detect: bool = ..., + getstate_setstate: Optional[bool] = ..., + on_setattr: Optional[_OnSetAttrArgType] = ..., + field_transformer: Optional[_FieldTransformer] = ..., +) -> _C: ... +@overload +@__dataclass_transform__(field_descriptors=(attrib, field)) +def define( + maybe_cls: None = ..., + *, + these: Optional[Dict[str, Any]] = ..., + repr: bool = ..., + hash: Optional[bool] = ..., + init: bool = ..., + slots: bool = ..., + frozen: bool = ..., + weakref_slot: bool = ..., + str: bool = ..., + auto_attribs: bool = ..., + kw_only: bool = ..., + cache_hash: bool = ..., + auto_exc: bool = ..., + eq: Optional[bool] = ..., + order: Optional[bool] = ..., + auto_detect: bool = ..., + getstate_setstate: Optional[bool] = ..., + on_setattr: Optional[_OnSetAttrArgType] = ..., + field_transformer: Optional[_FieldTransformer] = ..., +) -> Callable[[_C], _C]: ... + +mutable = define +frozen = define # they differ only in their defaults + +# TODO: add support for returning NamedTuple from the mypy plugin +class _Fields(Tuple[Attribute[Any], ...]): + def __getattr__(self, name: str) -> Attribute[Any]: ... + +def fields(cls: type) -> _Fields: ... +def fields_dict(cls: type) -> Dict[str, Attribute[Any]]: ... +def validate(inst: Any) -> None: ... +def resolve_types( + cls: _C, + globalns: Optional[Dict[str, Any]] = ..., + localns: Optional[Dict[str, Any]] = ..., + attribs: Optional[List[Attribute[Any]]] = ..., +) -> _C: ... + +# TODO: add support for returning a proper attrs class from the mypy plugin +# we use Any instead of _CountingAttr so that e.g. `make_class('Foo', +# [attr.ib()])` is valid +def make_class( + name: str, + attrs: Union[List[str], Tuple[str, ...], Dict[str, Any]], + bases: Tuple[type, ...] = ..., + repr_ns: Optional[str] = ..., + repr: bool = ..., + cmp: Optional[_EqOrderType] = ..., + hash: Optional[bool] = ..., + init: bool = ..., + slots: bool = ..., + frozen: bool = ..., + weakref_slot: bool = ..., + str: bool = ..., + auto_attribs: bool = ..., + kw_only: bool = ..., + cache_hash: bool = ..., + auto_exc: bool = ..., + eq: Optional[_EqOrderType] = ..., + order: Optional[_EqOrderType] = ..., + collect_by_mro: bool = ..., + on_setattr: Optional[_OnSetAttrArgType] = ..., + field_transformer: Optional[_FieldTransformer] = ..., +) -> type: ... + +# _funcs -- + +# TODO: add support for returning TypedDict from the mypy plugin +# FIXME: asdict/astuple do not honor their factory args. Waiting on one of +# these: +# https://github.com/python/mypy/issues/4236 +# https://github.com/python/typing/issues/253 +def asdict( + inst: Any, + recurse: bool = ..., + filter: Optional[_FilterType[Any]] = ..., + dict_factory: Type[Mapping[Any, Any]] = ..., + retain_collection_types: bool = ..., + value_serializer: Optional[Callable[[type, Attribute[Any], Any], Any]] = ..., +) -> Dict[str, Any]: ... + +# TODO: add support for returning NamedTuple from the mypy plugin +def astuple( + inst: Any, + recurse: bool = ..., + filter: Optional[_FilterType[Any]] = ..., + tuple_factory: Type[Sequence[Any]] = ..., + retain_collection_types: bool = ..., +) -> Tuple[Any, ...]: ... +def has(cls: type) -> bool: ... +def assoc(inst: _T, **changes: Any) -> _T: ... +def evolve(inst: _T, **changes: Any) -> _T: ... + +# _config -- + +def set_run_validators(run: bool) -> None: ... +def get_run_validators() -> bool: ... + +# aliases -- + +s = attributes = attrs +ib = attr = attrib +dataclass = attrs # Technically, partial(attrs, auto_attribs=True) ;) diff --git a/openpype/hosts/fusion/vendor/attr/_cmp.py b/openpype/hosts/fusion/vendor/attr/_cmp.py new file mode 100644 index 0000000000..b747b603f1 --- /dev/null +++ b/openpype/hosts/fusion/vendor/attr/_cmp.py @@ -0,0 +1,152 @@ +from __future__ import absolute_import, division, print_function + +import functools + +from ._compat import new_class +from ._make import _make_ne + + +_operation_names = {"eq": "==", "lt": "<", "le": "<=", "gt": ">", "ge": ">="} + + +def cmp_using( + eq=None, + lt=None, + le=None, + gt=None, + ge=None, + require_same_type=True, + class_name="Comparable", +): + """ + Create a class that can be passed into `attr.ib`'s ``eq``, ``order``, and + ``cmp`` arguments to customize field comparison. + + The resulting class will have a full set of ordering methods if + at least one of ``{lt, le, gt, ge}`` and ``eq`` are provided. + + :param Optional[callable] eq: `callable` used to evaluate equality + of two objects. + :param Optional[callable] lt: `callable` used to evaluate whether + one object is less than another object. + :param Optional[callable] le: `callable` used to evaluate whether + one object is less than or equal to another object. + :param Optional[callable] gt: `callable` used to evaluate whether + one object is greater than another object. + :param Optional[callable] ge: `callable` used to evaluate whether + one object is greater than or equal to another object. + + :param bool require_same_type: When `True`, equality and ordering methods + will return `NotImplemented` if objects are not of the same type. + + :param Optional[str] class_name: Name of class. Defaults to 'Comparable'. + + See `comparison` for more details. + + .. versionadded:: 21.1.0 + """ + + body = { + "__slots__": ["value"], + "__init__": _make_init(), + "_requirements": [], + "_is_comparable_to": _is_comparable_to, + } + + # Add operations. + num_order_functions = 0 + has_eq_function = False + + if eq is not None: + has_eq_function = True + body["__eq__"] = _make_operator("eq", eq) + body["__ne__"] = _make_ne() + + if lt is not None: + num_order_functions += 1 + body["__lt__"] = _make_operator("lt", lt) + + if le is not None: + num_order_functions += 1 + body["__le__"] = _make_operator("le", le) + + if gt is not None: + num_order_functions += 1 + body["__gt__"] = _make_operator("gt", gt) + + if ge is not None: + num_order_functions += 1 + body["__ge__"] = _make_operator("ge", ge) + + type_ = new_class(class_name, (object,), {}, lambda ns: ns.update(body)) + + # Add same type requirement. + if require_same_type: + type_._requirements.append(_check_same_type) + + # Add total ordering if at least one operation was defined. + if 0 < num_order_functions < 4: + if not has_eq_function: + # functools.total_ordering requires __eq__ to be defined, + # so raise early error here to keep a nice stack. + raise ValueError( + "eq must be define is order to complete ordering from " + "lt, le, gt, ge." + ) + type_ = functools.total_ordering(type_) + + return type_ + + +def _make_init(): + """ + Create __init__ method. + """ + + def __init__(self, value): + """ + Initialize object with *value*. + """ + self.value = value + + return __init__ + + +def _make_operator(name, func): + """ + Create operator method. + """ + + def method(self, other): + if not self._is_comparable_to(other): + return NotImplemented + + result = func(self.value, other.value) + if result is NotImplemented: + return NotImplemented + + return result + + method.__name__ = "__%s__" % (name,) + method.__doc__ = "Return a %s b. Computed by attrs." % ( + _operation_names[name], + ) + + return method + + +def _is_comparable_to(self, other): + """ + Check whether `other` is comparable to `self`. + """ + for func in self._requirements: + if not func(self, other): + return False + return True + + +def _check_same_type(self, other): + """ + Return True if *self* and *other* are of the same type, False otherwise. + """ + return other.value.__class__ is self.value.__class__ diff --git a/openpype/hosts/fusion/vendor/attr/_cmp.pyi b/openpype/hosts/fusion/vendor/attr/_cmp.pyi new file mode 100644 index 0000000000..7093550f0f --- /dev/null +++ b/openpype/hosts/fusion/vendor/attr/_cmp.pyi @@ -0,0 +1,14 @@ +from typing import Type + +from . import _CompareWithType + + +def cmp_using( + eq: Optional[_CompareWithType], + lt: Optional[_CompareWithType], + le: Optional[_CompareWithType], + gt: Optional[_CompareWithType], + ge: Optional[_CompareWithType], + require_same_type: bool, + class_name: str, +) -> Type: ... diff --git a/openpype/hosts/fusion/vendor/attr/_compat.py b/openpype/hosts/fusion/vendor/attr/_compat.py new file mode 100644 index 0000000000..6939f338da --- /dev/null +++ b/openpype/hosts/fusion/vendor/attr/_compat.py @@ -0,0 +1,242 @@ +from __future__ import absolute_import, division, print_function + +import platform +import sys +import types +import warnings + + +PY2 = sys.version_info[0] == 2 +PYPY = platform.python_implementation() == "PyPy" + + +if PYPY or sys.version_info[:2] >= (3, 6): + ordered_dict = dict +else: + from collections import OrderedDict + + ordered_dict = OrderedDict + + +if PY2: + from collections import Mapping, Sequence + + from UserDict import IterableUserDict + + # We 'bundle' isclass instead of using inspect as importing inspect is + # fairly expensive (order of 10-15 ms for a modern machine in 2016) + def isclass(klass): + return isinstance(klass, (type, types.ClassType)) + + def new_class(name, bases, kwds, exec_body): + """ + A minimal stub of types.new_class that we need for make_class. + """ + ns = {} + exec_body(ns) + + return type(name, bases, ns) + + # TYPE is used in exceptions, repr(int) is different on Python 2 and 3. + TYPE = "type" + + def iteritems(d): + return d.iteritems() + + # Python 2 is bereft of a read-only dict proxy, so we make one! + class ReadOnlyDict(IterableUserDict): + """ + Best-effort read-only dict wrapper. + """ + + def __setitem__(self, key, val): + # We gently pretend we're a Python 3 mappingproxy. + raise TypeError( + "'mappingproxy' object does not support item assignment" + ) + + def update(self, _): + # We gently pretend we're a Python 3 mappingproxy. + raise AttributeError( + "'mappingproxy' object has no attribute 'update'" + ) + + def __delitem__(self, _): + # We gently pretend we're a Python 3 mappingproxy. + raise TypeError( + "'mappingproxy' object does not support item deletion" + ) + + def clear(self): + # We gently pretend we're a Python 3 mappingproxy. + raise AttributeError( + "'mappingproxy' object has no attribute 'clear'" + ) + + def pop(self, key, default=None): + # We gently pretend we're a Python 3 mappingproxy. + raise AttributeError( + "'mappingproxy' object has no attribute 'pop'" + ) + + def popitem(self): + # We gently pretend we're a Python 3 mappingproxy. + raise AttributeError( + "'mappingproxy' object has no attribute 'popitem'" + ) + + def setdefault(self, key, default=None): + # We gently pretend we're a Python 3 mappingproxy. + raise AttributeError( + "'mappingproxy' object has no attribute 'setdefault'" + ) + + def __repr__(self): + # Override to be identical to the Python 3 version. + return "mappingproxy(" + repr(self.data) + ")" + + def metadata_proxy(d): + res = ReadOnlyDict() + res.data.update(d) # We blocked update, so we have to do it like this. + return res + + def just_warn(*args, **kw): # pragma: no cover + """ + We only warn on Python 3 because we are not aware of any concrete + consequences of not setting the cell on Python 2. + """ + + +else: # Python 3 and later. + from collections.abc import Mapping, Sequence # noqa + + def just_warn(*args, **kw): + """ + We only warn on Python 3 because we are not aware of any concrete + consequences of not setting the cell on Python 2. + """ + warnings.warn( + "Running interpreter doesn't sufficiently support code object " + "introspection. Some features like bare super() or accessing " + "__class__ will not work with slotted classes.", + RuntimeWarning, + stacklevel=2, + ) + + def isclass(klass): + return isinstance(klass, type) + + TYPE = "class" + + def iteritems(d): + return d.items() + + new_class = types.new_class + + def metadata_proxy(d): + return types.MappingProxyType(dict(d)) + + +def make_set_closure_cell(): + """Return a function of two arguments (cell, value) which sets + the value stored in the closure cell `cell` to `value`. + """ + # pypy makes this easy. (It also supports the logic below, but + # why not do the easy/fast thing?) + if PYPY: + + def set_closure_cell(cell, value): + cell.__setstate__((value,)) + + return set_closure_cell + + # Otherwise gotta do it the hard way. + + # Create a function that will set its first cellvar to `value`. + def set_first_cellvar_to(value): + x = value + return + + # This function will be eliminated as dead code, but + # not before its reference to `x` forces `x` to be + # represented as a closure cell rather than a local. + def force_x_to_be_a_cell(): # pragma: no cover + return x + + try: + # Extract the code object and make sure our assumptions about + # the closure behavior are correct. + if PY2: + co = set_first_cellvar_to.func_code + else: + co = set_first_cellvar_to.__code__ + if co.co_cellvars != ("x",) or co.co_freevars != (): + raise AssertionError # pragma: no cover + + # Convert this code object to a code object that sets the + # function's first _freevar_ (not cellvar) to the argument. + if sys.version_info >= (3, 8): + # CPython 3.8+ has an incompatible CodeType signature + # (added a posonlyargcount argument) but also added + # CodeType.replace() to do this without counting parameters. + set_first_freevar_code = co.replace( + co_cellvars=co.co_freevars, co_freevars=co.co_cellvars + ) + else: + args = [co.co_argcount] + if not PY2: + args.append(co.co_kwonlyargcount) + args.extend( + [ + co.co_nlocals, + co.co_stacksize, + co.co_flags, + co.co_code, + co.co_consts, + co.co_names, + co.co_varnames, + co.co_filename, + co.co_name, + co.co_firstlineno, + co.co_lnotab, + # These two arguments are reversed: + co.co_cellvars, + co.co_freevars, + ] + ) + set_first_freevar_code = types.CodeType(*args) + + def set_closure_cell(cell, value): + # Create a function using the set_first_freevar_code, + # whose first closure cell is `cell`. Calling it will + # change the value of that cell. + setter = types.FunctionType( + set_first_freevar_code, {}, "setter", (), (cell,) + ) + # And call it to set the cell. + setter(value) + + # Make sure it works on this interpreter: + def make_func_with_cell(): + x = None + + def func(): + return x # pragma: no cover + + return func + + if PY2: + cell = make_func_with_cell().func_closure[0] + else: + cell = make_func_with_cell().__closure__[0] + set_closure_cell(cell, 100) + if cell.cell_contents != 100: + raise AssertionError # pragma: no cover + + except Exception: + return just_warn + else: + return set_closure_cell + + +set_closure_cell = make_set_closure_cell() diff --git a/openpype/hosts/fusion/vendor/attr/_config.py b/openpype/hosts/fusion/vendor/attr/_config.py new file mode 100644 index 0000000000..8ec920962d --- /dev/null +++ b/openpype/hosts/fusion/vendor/attr/_config.py @@ -0,0 +1,23 @@ +from __future__ import absolute_import, division, print_function + + +__all__ = ["set_run_validators", "get_run_validators"] + +_run_validators = True + + +def set_run_validators(run): + """ + Set whether or not validators are run. By default, they are run. + """ + if not isinstance(run, bool): + raise TypeError("'run' must be bool.") + global _run_validators + _run_validators = run + + +def get_run_validators(): + """ + Return whether or not validators are run. + """ + return _run_validators diff --git a/openpype/hosts/fusion/vendor/attr/_funcs.py b/openpype/hosts/fusion/vendor/attr/_funcs.py new file mode 100644 index 0000000000..fda508c5c4 --- /dev/null +++ b/openpype/hosts/fusion/vendor/attr/_funcs.py @@ -0,0 +1,395 @@ +from __future__ import absolute_import, division, print_function + +import copy + +from ._compat import iteritems +from ._make import NOTHING, _obj_setattr, fields +from .exceptions import AttrsAttributeNotFoundError + + +def asdict( + inst, + recurse=True, + filter=None, + dict_factory=dict, + retain_collection_types=False, + value_serializer=None, +): + """ + Return the ``attrs`` attribute values of *inst* as a dict. + + Optionally recurse into other ``attrs``-decorated classes. + + :param inst: Instance of an ``attrs``-decorated class. + :param bool recurse: Recurse into classes that are also + ``attrs``-decorated. + :param callable filter: A callable whose return code determines whether an + attribute or element is included (``True``) or dropped (``False``). Is + called with the `attr.Attribute` as the first argument and the + value as the second argument. + :param callable dict_factory: A callable to produce dictionaries from. For + example, to produce ordered dictionaries instead of normal Python + dictionaries, pass in ``collections.OrderedDict``. + :param bool retain_collection_types: Do not convert to ``list`` when + encountering an attribute whose type is ``tuple`` or ``set``. Only + meaningful if ``recurse`` is ``True``. + :param Optional[callable] value_serializer: A hook that is called for every + attribute or dict key/value. It receives the current instance, field + and value and must return the (updated) value. The hook is run *after* + the optional *filter* has been applied. + + :rtype: return type of *dict_factory* + + :raise attr.exceptions.NotAnAttrsClassError: If *cls* is not an ``attrs`` + class. + + .. versionadded:: 16.0.0 *dict_factory* + .. versionadded:: 16.1.0 *retain_collection_types* + .. versionadded:: 20.3.0 *value_serializer* + """ + attrs = fields(inst.__class__) + rv = dict_factory() + for a in attrs: + v = getattr(inst, a.name) + if filter is not None and not filter(a, v): + continue + + if value_serializer is not None: + v = value_serializer(inst, a, v) + + if recurse is True: + if has(v.__class__): + rv[a.name] = asdict( + v, + True, + filter, + dict_factory, + retain_collection_types, + value_serializer, + ) + elif isinstance(v, (tuple, list, set, frozenset)): + cf = v.__class__ if retain_collection_types is True else list + rv[a.name] = cf( + [ + _asdict_anything( + i, + filter, + dict_factory, + retain_collection_types, + value_serializer, + ) + for i in v + ] + ) + elif isinstance(v, dict): + df = dict_factory + rv[a.name] = df( + ( + _asdict_anything( + kk, + filter, + df, + retain_collection_types, + value_serializer, + ), + _asdict_anything( + vv, + filter, + df, + retain_collection_types, + value_serializer, + ), + ) + for kk, vv in iteritems(v) + ) + else: + rv[a.name] = v + else: + rv[a.name] = v + return rv + + +def _asdict_anything( + val, + filter, + dict_factory, + retain_collection_types, + value_serializer, +): + """ + ``asdict`` only works on attrs instances, this works on anything. + """ + if getattr(val.__class__, "__attrs_attrs__", None) is not None: + # Attrs class. + rv = asdict( + val, + True, + filter, + dict_factory, + retain_collection_types, + value_serializer, + ) + elif isinstance(val, (tuple, list, set, frozenset)): + cf = val.__class__ if retain_collection_types is True else list + rv = cf( + [ + _asdict_anything( + i, + filter, + dict_factory, + retain_collection_types, + value_serializer, + ) + for i in val + ] + ) + elif isinstance(val, dict): + df = dict_factory + rv = df( + ( + _asdict_anything( + kk, filter, df, retain_collection_types, value_serializer + ), + _asdict_anything( + vv, filter, df, retain_collection_types, value_serializer + ), + ) + for kk, vv in iteritems(val) + ) + else: + rv = val + if value_serializer is not None: + rv = value_serializer(None, None, rv) + + return rv + + +def astuple( + inst, + recurse=True, + filter=None, + tuple_factory=tuple, + retain_collection_types=False, +): + """ + Return the ``attrs`` attribute values of *inst* as a tuple. + + Optionally recurse into other ``attrs``-decorated classes. + + :param inst: Instance of an ``attrs``-decorated class. + :param bool recurse: Recurse into classes that are also + ``attrs``-decorated. + :param callable filter: A callable whose return code determines whether an + attribute or element is included (``True``) or dropped (``False``). Is + called with the `attr.Attribute` as the first argument and the + value as the second argument. + :param callable tuple_factory: A callable to produce tuples from. For + example, to produce lists instead of tuples. + :param bool retain_collection_types: Do not convert to ``list`` + or ``dict`` when encountering an attribute which type is + ``tuple``, ``dict`` or ``set``. Only meaningful if ``recurse`` is + ``True``. + + :rtype: return type of *tuple_factory* + + :raise attr.exceptions.NotAnAttrsClassError: If *cls* is not an ``attrs`` + class. + + .. versionadded:: 16.2.0 + """ + attrs = fields(inst.__class__) + rv = [] + retain = retain_collection_types # Very long. :/ + for a in attrs: + v = getattr(inst, a.name) + if filter is not None and not filter(a, v): + continue + if recurse is True: + if has(v.__class__): + rv.append( + astuple( + v, + recurse=True, + filter=filter, + tuple_factory=tuple_factory, + retain_collection_types=retain, + ) + ) + elif isinstance(v, (tuple, list, set, frozenset)): + cf = v.__class__ if retain is True else list + rv.append( + cf( + [ + astuple( + j, + recurse=True, + filter=filter, + tuple_factory=tuple_factory, + retain_collection_types=retain, + ) + if has(j.__class__) + else j + for j in v + ] + ) + ) + elif isinstance(v, dict): + df = v.__class__ if retain is True else dict + rv.append( + df( + ( + astuple( + kk, + tuple_factory=tuple_factory, + retain_collection_types=retain, + ) + if has(kk.__class__) + else kk, + astuple( + vv, + tuple_factory=tuple_factory, + retain_collection_types=retain, + ) + if has(vv.__class__) + else vv, + ) + for kk, vv in iteritems(v) + ) + ) + else: + rv.append(v) + else: + rv.append(v) + + return rv if tuple_factory is list else tuple_factory(rv) + + +def has(cls): + """ + Check whether *cls* is a class with ``attrs`` attributes. + + :param type cls: Class to introspect. + :raise TypeError: If *cls* is not a class. + + :rtype: bool + """ + return getattr(cls, "__attrs_attrs__", None) is not None + + +def assoc(inst, **changes): + """ + Copy *inst* and apply *changes*. + + :param inst: Instance of a class with ``attrs`` attributes. + :param changes: Keyword changes in the new copy. + + :return: A copy of inst with *changes* incorporated. + + :raise attr.exceptions.AttrsAttributeNotFoundError: If *attr_name* couldn't + be found on *cls*. + :raise attr.exceptions.NotAnAttrsClassError: If *cls* is not an ``attrs`` + class. + + .. deprecated:: 17.1.0 + Use `evolve` instead. + """ + import warnings + + warnings.warn( + "assoc is deprecated and will be removed after 2018/01.", + DeprecationWarning, + stacklevel=2, + ) + new = copy.copy(inst) + attrs = fields(inst.__class__) + for k, v in iteritems(changes): + a = getattr(attrs, k, NOTHING) + if a is NOTHING: + raise AttrsAttributeNotFoundError( + "{k} is not an attrs attribute on {cl}.".format( + k=k, cl=new.__class__ + ) + ) + _obj_setattr(new, k, v) + return new + + +def evolve(inst, **changes): + """ + Create a new instance, based on *inst* with *changes* applied. + + :param inst: Instance of a class with ``attrs`` attributes. + :param changes: Keyword changes in the new copy. + + :return: A copy of inst with *changes* incorporated. + + :raise TypeError: If *attr_name* couldn't be found in the class + ``__init__``. + :raise attr.exceptions.NotAnAttrsClassError: If *cls* is not an ``attrs`` + class. + + .. versionadded:: 17.1.0 + """ + cls = inst.__class__ + attrs = fields(cls) + for a in attrs: + if not a.init: + continue + attr_name = a.name # To deal with private attributes. + init_name = attr_name if attr_name[0] != "_" else attr_name[1:] + if init_name not in changes: + changes[init_name] = getattr(inst, attr_name) + + return cls(**changes) + + +def resolve_types(cls, globalns=None, localns=None, attribs=None): + """ + Resolve any strings and forward annotations in type annotations. + + This is only required if you need concrete types in `Attribute`'s *type* + field. In other words, you don't need to resolve your types if you only + use them for static type checking. + + With no arguments, names will be looked up in the module in which the class + was created. If this is not what you want, e.g. if the name only exists + inside a method, you may pass *globalns* or *localns* to specify other + dictionaries in which to look up these names. See the docs of + `typing.get_type_hints` for more details. + + :param type cls: Class to resolve. + :param Optional[dict] globalns: Dictionary containing global variables. + :param Optional[dict] localns: Dictionary containing local variables. + :param Optional[list] attribs: List of attribs for the given class. + This is necessary when calling from inside a ``field_transformer`` + since *cls* is not an ``attrs`` class yet. + + :raise TypeError: If *cls* is not a class. + :raise attr.exceptions.NotAnAttrsClassError: If *cls* is not an ``attrs`` + class and you didn't pass any attribs. + :raise NameError: If types cannot be resolved because of missing variables. + + :returns: *cls* so you can use this function also as a class decorator. + Please note that you have to apply it **after** `attr.s`. That means + the decorator has to come in the line **before** `attr.s`. + + .. versionadded:: 20.1.0 + .. versionadded:: 21.1.0 *attribs* + + """ + try: + # Since calling get_type_hints is expensive we cache whether we've + # done it already. + cls.__attrs_types_resolved__ + except AttributeError: + import typing + + hints = typing.get_type_hints(cls, globalns=globalns, localns=localns) + for field in fields(cls) if attribs is None else attribs: + if field.name in hints: + # Since fields have been frozen we must work around it. + _obj_setattr(field, "type", hints[field.name]) + cls.__attrs_types_resolved__ = True + + # Return the class so you can use it as a decorator too. + return cls diff --git a/openpype/hosts/fusion/vendor/attr/_make.py b/openpype/hosts/fusion/vendor/attr/_make.py new file mode 100644 index 0000000000..a1912b1233 --- /dev/null +++ b/openpype/hosts/fusion/vendor/attr/_make.py @@ -0,0 +1,3052 @@ +from __future__ import absolute_import, division, print_function + +import copy +import inspect +import linecache +import sys +import threading +import uuid +import warnings + +from operator import itemgetter + +from . import _config, setters +from ._compat import ( + PY2, + PYPY, + isclass, + iteritems, + metadata_proxy, + new_class, + ordered_dict, + set_closure_cell, +) +from .exceptions import ( + DefaultAlreadySetError, + FrozenInstanceError, + NotAnAttrsClassError, + PythonTooOldError, + UnannotatedAttributeError, +) + + +if not PY2: + import typing + + +# This is used at least twice, so cache it here. +_obj_setattr = object.__setattr__ +_init_converter_pat = "__attr_converter_%s" +_init_factory_pat = "__attr_factory_{}" +_tuple_property_pat = ( + " {attr_name} = _attrs_property(_attrs_itemgetter({index}))" +) +_classvar_prefixes = ( + "typing.ClassVar", + "t.ClassVar", + "ClassVar", + "typing_extensions.ClassVar", +) +# we don't use a double-underscore prefix because that triggers +# name mangling when trying to create a slot for the field +# (when slots=True) +_hash_cache_field = "_attrs_cached_hash" + +_empty_metadata_singleton = metadata_proxy({}) + +# Unique object for unequivocal getattr() defaults. +_sentinel = object() + + +class _Nothing(object): + """ + Sentinel class to indicate the lack of a value when ``None`` is ambiguous. + + ``_Nothing`` is a singleton. There is only ever one of it. + + .. versionchanged:: 21.1.0 ``bool(NOTHING)`` is now False. + """ + + _singleton = None + + def __new__(cls): + if _Nothing._singleton is None: + _Nothing._singleton = super(_Nothing, cls).__new__(cls) + return _Nothing._singleton + + def __repr__(self): + return "NOTHING" + + def __bool__(self): + return False + + def __len__(self): + return 0 # __bool__ for Python 2 + + +NOTHING = _Nothing() +""" +Sentinel to indicate the lack of a value when ``None`` is ambiguous. +""" + + +class _CacheHashWrapper(int): + """ + An integer subclass that pickles / copies as None + + This is used for non-slots classes with ``cache_hash=True``, to avoid + serializing a potentially (even likely) invalid hash value. Since ``None`` + is the default value for uncalculated hashes, whenever this is copied, + the copy's value for the hash should automatically reset. + + See GH #613 for more details. + """ + + if PY2: + # For some reason `type(None)` isn't callable in Python 2, but we don't + # actually need a constructor for None objects, we just need any + # available function that returns None. + def __reduce__(self, _none_constructor=getattr, _args=(0, "", None)): + return _none_constructor, _args + + else: + + def __reduce__(self, _none_constructor=type(None), _args=()): + return _none_constructor, _args + + +def attrib( + default=NOTHING, + validator=None, + repr=True, + cmp=None, + hash=None, + init=True, + metadata=None, + type=None, + converter=None, + factory=None, + kw_only=False, + eq=None, + order=None, + on_setattr=None, +): + """ + Create a new attribute on a class. + + .. warning:: + + Does *not* do anything unless the class is also decorated with + `attr.s`! + + :param default: A value that is used if an ``attrs``-generated ``__init__`` + is used and no value is passed while instantiating or the attribute is + excluded using ``init=False``. + + If the value is an instance of `Factory`, its callable will be + used to construct a new value (useful for mutable data types like lists + or dicts). + + If a default is not set (or set manually to `attr.NOTHING`), a value + *must* be supplied when instantiating; otherwise a `TypeError` + will be raised. + + The default can also be set using decorator notation as shown below. + + :type default: Any value + + :param callable factory: Syntactic sugar for + ``default=attr.Factory(factory)``. + + :param validator: `callable` that is called by ``attrs``-generated + ``__init__`` methods after the instance has been initialized. They + receive the initialized instance, the `Attribute`, and the + passed value. + + The return value is *not* inspected so the validator has to throw an + exception itself. + + If a `list` is passed, its items are treated as validators and must + all pass. + + Validators can be globally disabled and re-enabled using + `get_run_validators`. + + The validator can also be set using decorator notation as shown below. + + :type validator: `callable` or a `list` of `callable`\\ s. + + :param repr: Include this attribute in the generated ``__repr__`` + method. If ``True``, include the attribute; if ``False``, omit it. By + default, the built-in ``repr()`` function is used. To override how the + attribute value is formatted, pass a ``callable`` that takes a single + value and returns a string. Note that the resulting string is used + as-is, i.e. it will be used directly *instead* of calling ``repr()`` + (the default). + :type repr: a `bool` or a `callable` to use a custom function. + + :param eq: If ``True`` (default), include this attribute in the + generated ``__eq__`` and ``__ne__`` methods that check two instances + for equality. To override how the attribute value is compared, + pass a ``callable`` that takes a single value and returns the value + to be compared. + :type eq: a `bool` or a `callable`. + + :param order: If ``True`` (default), include this attributes in the + generated ``__lt__``, ``__le__``, ``__gt__`` and ``__ge__`` methods. + To override how the attribute value is ordered, + pass a ``callable`` that takes a single value and returns the value + to be ordered. + :type order: a `bool` or a `callable`. + + :param cmp: Setting *cmp* is equivalent to setting *eq* and *order* to the + same value. Must not be mixed with *eq* or *order*. + :type cmp: a `bool` or a `callable`. + + :param Optional[bool] hash: Include this attribute in the generated + ``__hash__`` method. If ``None`` (default), mirror *eq*'s value. This + is the correct behavior according the Python spec. Setting this value + to anything else than ``None`` is *discouraged*. + :param bool init: Include this attribute in the generated ``__init__`` + method. It is possible to set this to ``False`` and set a default + value. In that case this attributed is unconditionally initialized + with the specified default value or factory. + :param callable converter: `callable` that is called by + ``attrs``-generated ``__init__`` methods to convert attribute's value + to the desired format. It is given the passed-in value, and the + returned value will be used as the new value of the attribute. The + value is converted before being passed to the validator, if any. + :param metadata: An arbitrary mapping, to be used by third-party + components. See `extending_metadata`. + :param type: The type of the attribute. In Python 3.6 or greater, the + preferred method to specify the type is using a variable annotation + (see `PEP 526 `_). + This argument is provided for backward compatibility. + Regardless of the approach used, the type will be stored on + ``Attribute.type``. + + Please note that ``attrs`` doesn't do anything with this metadata by + itself. You can use it as part of your own code or for + `static type checking `. + :param kw_only: Make this attribute keyword-only (Python 3+) + in the generated ``__init__`` (if ``init`` is ``False``, this + parameter is ignored). + :param on_setattr: Allows to overwrite the *on_setattr* setting from + `attr.s`. If left `None`, the *on_setattr* value from `attr.s` is used. + Set to `attr.setters.NO_OP` to run **no** `setattr` hooks for this + attribute -- regardless of the setting in `attr.s`. + :type on_setattr: `callable`, or a list of callables, or `None`, or + `attr.setters.NO_OP` + + .. versionadded:: 15.2.0 *convert* + .. versionadded:: 16.3.0 *metadata* + .. versionchanged:: 17.1.0 *validator* can be a ``list`` now. + .. versionchanged:: 17.1.0 + *hash* is ``None`` and therefore mirrors *eq* by default. + .. versionadded:: 17.3.0 *type* + .. deprecated:: 17.4.0 *convert* + .. versionadded:: 17.4.0 *converter* as a replacement for the deprecated + *convert* to achieve consistency with other noun-based arguments. + .. versionadded:: 18.1.0 + ``factory=f`` is syntactic sugar for ``default=attr.Factory(f)``. + .. versionadded:: 18.2.0 *kw_only* + .. versionchanged:: 19.2.0 *convert* keyword argument removed. + .. versionchanged:: 19.2.0 *repr* also accepts a custom callable. + .. deprecated:: 19.2.0 *cmp* Removal on or after 2021-06-01. + .. versionadded:: 19.2.0 *eq* and *order* + .. versionadded:: 20.1.0 *on_setattr* + .. versionchanged:: 20.3.0 *kw_only* backported to Python 2 + .. versionchanged:: 21.1.0 + *eq*, *order*, and *cmp* also accept a custom callable + .. versionchanged:: 21.1.0 *cmp* undeprecated + """ + eq, eq_key, order, order_key = _determine_attrib_eq_order( + cmp, eq, order, True + ) + + if hash is not None and hash is not True and hash is not False: + raise TypeError( + "Invalid value for hash. Must be True, False, or None." + ) + + if factory is not None: + if default is not NOTHING: + raise ValueError( + "The `default` and `factory` arguments are mutually " + "exclusive." + ) + if not callable(factory): + raise ValueError("The `factory` argument must be a callable.") + default = Factory(factory) + + if metadata is None: + metadata = {} + + # Apply syntactic sugar by auto-wrapping. + if isinstance(on_setattr, (list, tuple)): + on_setattr = setters.pipe(*on_setattr) + + if validator and isinstance(validator, (list, tuple)): + validator = and_(*validator) + + if converter and isinstance(converter, (list, tuple)): + converter = pipe(*converter) + + return _CountingAttr( + default=default, + validator=validator, + repr=repr, + cmp=None, + hash=hash, + init=init, + converter=converter, + metadata=metadata, + type=type, + kw_only=kw_only, + eq=eq, + eq_key=eq_key, + order=order, + order_key=order_key, + on_setattr=on_setattr, + ) + + +def _compile_and_eval(script, globs, locs=None, filename=""): + """ + "Exec" the script with the given global (globs) and local (locs) variables. + """ + bytecode = compile(script, filename, "exec") + eval(bytecode, globs, locs) + + +def _make_method(name, script, filename, globs=None): + """ + Create the method with the script given and return the method object. + """ + locs = {} + if globs is None: + globs = {} + + _compile_and_eval(script, globs, locs, filename) + + # In order of debuggers like PDB being able to step through the code, + # we add a fake linecache entry. + linecache.cache[filename] = ( + len(script), + None, + script.splitlines(True), + filename, + ) + + return locs[name] + + +def _make_attr_tuple_class(cls_name, attr_names): + """ + Create a tuple subclass to hold `Attribute`s for an `attrs` class. + + The subclass is a bare tuple with properties for names. + + class MyClassAttributes(tuple): + __slots__ = () + x = property(itemgetter(0)) + """ + attr_class_name = "{}Attributes".format(cls_name) + attr_class_template = [ + "class {}(tuple):".format(attr_class_name), + " __slots__ = ()", + ] + if attr_names: + for i, attr_name in enumerate(attr_names): + attr_class_template.append( + _tuple_property_pat.format(index=i, attr_name=attr_name) + ) + else: + attr_class_template.append(" pass") + globs = {"_attrs_itemgetter": itemgetter, "_attrs_property": property} + _compile_and_eval("\n".join(attr_class_template), globs) + return globs[attr_class_name] + + +# Tuple class for extracted attributes from a class definition. +# `base_attrs` is a subset of `attrs`. +_Attributes = _make_attr_tuple_class( + "_Attributes", + [ + # all attributes to build dunder methods for + "attrs", + # attributes that have been inherited + "base_attrs", + # map inherited attributes to their originating classes + "base_attrs_map", + ], +) + + +def _is_class_var(annot): + """ + Check whether *annot* is a typing.ClassVar. + + The string comparison hack is used to avoid evaluating all string + annotations which would put attrs-based classes at a performance + disadvantage compared to plain old classes. + """ + annot = str(annot) + + # Annotation can be quoted. + if annot.startswith(("'", '"')) and annot.endswith(("'", '"')): + annot = annot[1:-1] + + return annot.startswith(_classvar_prefixes) + + +def _has_own_attribute(cls, attrib_name): + """ + Check whether *cls* defines *attrib_name* (and doesn't just inherit it). + + Requires Python 3. + """ + attr = getattr(cls, attrib_name, _sentinel) + if attr is _sentinel: + return False + + for base_cls in cls.__mro__[1:]: + a = getattr(base_cls, attrib_name, None) + if attr is a: + return False + + return True + + +def _get_annotations(cls): + """ + Get annotations for *cls*. + """ + if _has_own_attribute(cls, "__annotations__"): + return cls.__annotations__ + + return {} + + +def _counter_getter(e): + """ + Key function for sorting to avoid re-creating a lambda for every class. + """ + return e[1].counter + + +def _collect_base_attrs(cls, taken_attr_names): + """ + Collect attr.ibs from base classes of *cls*, except *taken_attr_names*. + """ + base_attrs = [] + base_attr_map = {} # A dictionary of base attrs to their classes. + + # Traverse the MRO and collect attributes. + for base_cls in reversed(cls.__mro__[1:-1]): + for a in getattr(base_cls, "__attrs_attrs__", []): + if a.inherited or a.name in taken_attr_names: + continue + + a = a.evolve(inherited=True) + base_attrs.append(a) + base_attr_map[a.name] = base_cls + + # For each name, only keep the freshest definition i.e. the furthest at the + # back. base_attr_map is fine because it gets overwritten with every new + # instance. + filtered = [] + seen = set() + for a in reversed(base_attrs): + if a.name in seen: + continue + filtered.insert(0, a) + seen.add(a.name) + + return filtered, base_attr_map + + +def _collect_base_attrs_broken(cls, taken_attr_names): + """ + Collect attr.ibs from base classes of *cls*, except *taken_attr_names*. + + N.B. *taken_attr_names* will be mutated. + + Adhere to the old incorrect behavior. + + Notably it collects from the front and considers inherited attributes which + leads to the buggy behavior reported in #428. + """ + base_attrs = [] + base_attr_map = {} # A dictionary of base attrs to their classes. + + # Traverse the MRO and collect attributes. + for base_cls in cls.__mro__[1:-1]: + for a in getattr(base_cls, "__attrs_attrs__", []): + if a.name in taken_attr_names: + continue + + a = a.evolve(inherited=True) + taken_attr_names.add(a.name) + base_attrs.append(a) + base_attr_map[a.name] = base_cls + + return base_attrs, base_attr_map + + +def _transform_attrs( + cls, these, auto_attribs, kw_only, collect_by_mro, field_transformer +): + """ + Transform all `_CountingAttr`s on a class into `Attribute`s. + + If *these* is passed, use that and don't look for them on the class. + + *collect_by_mro* is True, collect them in the correct MRO order, otherwise + use the old -- incorrect -- order. See #428. + + Return an `_Attributes`. + """ + cd = cls.__dict__ + anns = _get_annotations(cls) + + if these is not None: + ca_list = [(name, ca) for name, ca in iteritems(these)] + + if not isinstance(these, ordered_dict): + ca_list.sort(key=_counter_getter) + elif auto_attribs is True: + ca_names = { + name + for name, attr in cd.items() + if isinstance(attr, _CountingAttr) + } + ca_list = [] + annot_names = set() + for attr_name, type in anns.items(): + if _is_class_var(type): + continue + annot_names.add(attr_name) + a = cd.get(attr_name, NOTHING) + + if not isinstance(a, _CountingAttr): + if a is NOTHING: + a = attrib() + else: + a = attrib(default=a) + ca_list.append((attr_name, a)) + + unannotated = ca_names - annot_names + if len(unannotated) > 0: + raise UnannotatedAttributeError( + "The following `attr.ib`s lack a type annotation: " + + ", ".join( + sorted(unannotated, key=lambda n: cd.get(n).counter) + ) + + "." + ) + else: + ca_list = sorted( + ( + (name, attr) + for name, attr in cd.items() + if isinstance(attr, _CountingAttr) + ), + key=lambda e: e[1].counter, + ) + + own_attrs = [ + Attribute.from_counting_attr( + name=attr_name, ca=ca, type=anns.get(attr_name) + ) + for attr_name, ca in ca_list + ] + + if collect_by_mro: + base_attrs, base_attr_map = _collect_base_attrs( + cls, {a.name for a in own_attrs} + ) + else: + base_attrs, base_attr_map = _collect_base_attrs_broken( + cls, {a.name for a in own_attrs} + ) + + attr_names = [a.name for a in base_attrs + own_attrs] + + AttrsClass = _make_attr_tuple_class(cls.__name__, attr_names) + + if kw_only: + own_attrs = [a.evolve(kw_only=True) for a in own_attrs] + base_attrs = [a.evolve(kw_only=True) for a in base_attrs] + + attrs = AttrsClass(base_attrs + own_attrs) + + # Mandatory vs non-mandatory attr order only matters when they are part of + # the __init__ signature and when they aren't kw_only (which are moved to + # the end and can be mandatory or non-mandatory in any order, as they will + # be specified as keyword args anyway). Check the order of those attrs: + had_default = False + for a in (a for a in attrs if a.init is not False and a.kw_only is False): + if had_default is True and a.default is NOTHING: + raise ValueError( + "No mandatory attributes allowed after an attribute with a " + "default value or factory. Attribute in question: %r" % (a,) + ) + + if had_default is False and a.default is not NOTHING: + had_default = True + + if field_transformer is not None: + attrs = field_transformer(cls, attrs) + return _Attributes((attrs, base_attrs, base_attr_map)) + + +if PYPY: + + def _frozen_setattrs(self, name, value): + """ + Attached to frozen classes as __setattr__. + """ + if isinstance(self, BaseException) and name in ( + "__cause__", + "__context__", + ): + BaseException.__setattr__(self, name, value) + return + + raise FrozenInstanceError() + + +else: + + def _frozen_setattrs(self, name, value): + """ + Attached to frozen classes as __setattr__. + """ + raise FrozenInstanceError() + + +def _frozen_delattrs(self, name): + """ + Attached to frozen classes as __delattr__. + """ + raise FrozenInstanceError() + + +class _ClassBuilder(object): + """ + Iteratively build *one* class. + """ + + __slots__ = ( + "_attr_names", + "_attrs", + "_base_attr_map", + "_base_names", + "_cache_hash", + "_cls", + "_cls_dict", + "_delete_attribs", + "_frozen", + "_has_pre_init", + "_has_post_init", + "_is_exc", + "_on_setattr", + "_slots", + "_weakref_slot", + "_has_own_setattr", + "_has_custom_setattr", + ) + + def __init__( + self, + cls, + these, + slots, + frozen, + weakref_slot, + getstate_setstate, + auto_attribs, + kw_only, + cache_hash, + is_exc, + collect_by_mro, + on_setattr, + has_custom_setattr, + field_transformer, + ): + attrs, base_attrs, base_map = _transform_attrs( + cls, + these, + auto_attribs, + kw_only, + collect_by_mro, + field_transformer, + ) + + self._cls = cls + self._cls_dict = dict(cls.__dict__) if slots else {} + self._attrs = attrs + self._base_names = set(a.name for a in base_attrs) + self._base_attr_map = base_map + self._attr_names = tuple(a.name for a in attrs) + self._slots = slots + self._frozen = frozen + self._weakref_slot = weakref_slot + self._cache_hash = cache_hash + self._has_pre_init = bool(getattr(cls, "__attrs_pre_init__", False)) + self._has_post_init = bool(getattr(cls, "__attrs_post_init__", False)) + self._delete_attribs = not bool(these) + self._is_exc = is_exc + self._on_setattr = on_setattr + + self._has_custom_setattr = has_custom_setattr + self._has_own_setattr = False + + self._cls_dict["__attrs_attrs__"] = self._attrs + + if frozen: + self._cls_dict["__setattr__"] = _frozen_setattrs + self._cls_dict["__delattr__"] = _frozen_delattrs + + self._has_own_setattr = True + + if getstate_setstate: + ( + self._cls_dict["__getstate__"], + self._cls_dict["__setstate__"], + ) = self._make_getstate_setstate() + + def __repr__(self): + return "<_ClassBuilder(cls={cls})>".format(cls=self._cls.__name__) + + def build_class(self): + """ + Finalize class based on the accumulated configuration. + + Builder cannot be used after calling this method. + """ + if self._slots is True: + return self._create_slots_class() + else: + return self._patch_original_class() + + def _patch_original_class(self): + """ + Apply accumulated methods and return the class. + """ + cls = self._cls + base_names = self._base_names + + # Clean class of attribute definitions (`attr.ib()`s). + if self._delete_attribs: + for name in self._attr_names: + if ( + name not in base_names + and getattr(cls, name, _sentinel) is not _sentinel + ): + try: + delattr(cls, name) + except AttributeError: + # This can happen if a base class defines a class + # variable and we want to set an attribute with the + # same name by using only a type annotation. + pass + + # Attach our dunder methods. + for name, value in self._cls_dict.items(): + setattr(cls, name, value) + + # If we've inherited an attrs __setattr__ and don't write our own, + # reset it to object's. + if not self._has_own_setattr and getattr( + cls, "__attrs_own_setattr__", False + ): + cls.__attrs_own_setattr__ = False + + if not self._has_custom_setattr: + cls.__setattr__ = object.__setattr__ + + return cls + + def _create_slots_class(self): + """ + Build and return a new class with a `__slots__` attribute. + """ + cd = { + k: v + for k, v in iteritems(self._cls_dict) + if k not in tuple(self._attr_names) + ("__dict__", "__weakref__") + } + + # If our class doesn't have its own implementation of __setattr__ + # (either from the user or by us), check the bases, if one of them has + # an attrs-made __setattr__, that needs to be reset. We don't walk the + # MRO because we only care about our immediate base classes. + # XXX: This can be confused by subclassing a slotted attrs class with + # XXX: a non-attrs class and subclass the resulting class with an attrs + # XXX: class. See `test_slotted_confused` for details. For now that's + # XXX: OK with us. + if not self._has_own_setattr: + cd["__attrs_own_setattr__"] = False + + if not self._has_custom_setattr: + for base_cls in self._cls.__bases__: + if base_cls.__dict__.get("__attrs_own_setattr__", False): + cd["__setattr__"] = object.__setattr__ + break + + # Traverse the MRO to collect existing slots + # and check for an existing __weakref__. + existing_slots = dict() + weakref_inherited = False + for base_cls in self._cls.__mro__[1:-1]: + if base_cls.__dict__.get("__weakref__", None) is not None: + weakref_inherited = True + existing_slots.update( + { + name: getattr(base_cls, name) + for name in getattr(base_cls, "__slots__", []) + } + ) + + base_names = set(self._base_names) + + names = self._attr_names + if ( + self._weakref_slot + and "__weakref__" not in getattr(self._cls, "__slots__", ()) + and "__weakref__" not in names + and not weakref_inherited + ): + names += ("__weakref__",) + + # We only add the names of attributes that aren't inherited. + # Setting __slots__ to inherited attributes wastes memory. + slot_names = [name for name in names if name not in base_names] + # There are slots for attributes from current class + # that are defined in parent classes. + # As their descriptors may be overriden by a child class, + # we collect them here and update the class dict + reused_slots = { + slot: slot_descriptor + for slot, slot_descriptor in iteritems(existing_slots) + if slot in slot_names + } + slot_names = [name for name in slot_names if name not in reused_slots] + cd.update(reused_slots) + if self._cache_hash: + slot_names.append(_hash_cache_field) + cd["__slots__"] = tuple(slot_names) + + qualname = getattr(self._cls, "__qualname__", None) + if qualname is not None: + cd["__qualname__"] = qualname + + # Create new class based on old class and our methods. + cls = type(self._cls)(self._cls.__name__, self._cls.__bases__, cd) + + # The following is a fix for + # https://github.com/python-attrs/attrs/issues/102. On Python 3, + # if a method mentions `__class__` or uses the no-arg super(), the + # compiler will bake a reference to the class in the method itself + # as `method.__closure__`. Since we replace the class with a + # clone, we rewrite these references so it keeps working. + for item in cls.__dict__.values(): + if isinstance(item, (classmethod, staticmethod)): + # Class- and staticmethods hide their functions inside. + # These might need to be rewritten as well. + closure_cells = getattr(item.__func__, "__closure__", None) + elif isinstance(item, property): + # Workaround for property `super()` shortcut (PY3-only). + # There is no universal way for other descriptors. + closure_cells = getattr(item.fget, "__closure__", None) + else: + closure_cells = getattr(item, "__closure__", None) + + if not closure_cells: # Catch None or the empty list. + continue + for cell in closure_cells: + try: + match = cell.cell_contents is self._cls + except ValueError: # ValueError: Cell is empty + pass + else: + if match: + set_closure_cell(cell, cls) + + return cls + + def add_repr(self, ns): + self._cls_dict["__repr__"] = self._add_method_dunders( + _make_repr(self._attrs, ns=ns) + ) + return self + + def add_str(self): + repr = self._cls_dict.get("__repr__") + if repr is None: + raise ValueError( + "__str__ can only be generated if a __repr__ exists." + ) + + def __str__(self): + return self.__repr__() + + self._cls_dict["__str__"] = self._add_method_dunders(__str__) + return self + + def _make_getstate_setstate(self): + """ + Create custom __setstate__ and __getstate__ methods. + """ + # __weakref__ is not writable. + state_attr_names = tuple( + an for an in self._attr_names if an != "__weakref__" + ) + + def slots_getstate(self): + """ + Automatically created by attrs. + """ + return tuple(getattr(self, name) for name in state_attr_names) + + hash_caching_enabled = self._cache_hash + + def slots_setstate(self, state): + """ + Automatically created by attrs. + """ + __bound_setattr = _obj_setattr.__get__(self, Attribute) + for name, value in zip(state_attr_names, state): + __bound_setattr(name, value) + + # The hash code cache is not included when the object is + # serialized, but it still needs to be initialized to None to + # indicate that the first call to __hash__ should be a cache + # miss. + if hash_caching_enabled: + __bound_setattr(_hash_cache_field, None) + + return slots_getstate, slots_setstate + + def make_unhashable(self): + self._cls_dict["__hash__"] = None + return self + + def add_hash(self): + self._cls_dict["__hash__"] = self._add_method_dunders( + _make_hash( + self._cls, + self._attrs, + frozen=self._frozen, + cache_hash=self._cache_hash, + ) + ) + + return self + + def add_init(self): + self._cls_dict["__init__"] = self._add_method_dunders( + _make_init( + self._cls, + self._attrs, + self._has_pre_init, + self._has_post_init, + self._frozen, + self._slots, + self._cache_hash, + self._base_attr_map, + self._is_exc, + self._on_setattr is not None + and self._on_setattr is not setters.NO_OP, + attrs_init=False, + ) + ) + + return self + + def add_attrs_init(self): + self._cls_dict["__attrs_init__"] = self._add_method_dunders( + _make_init( + self._cls, + self._attrs, + self._has_pre_init, + self._has_post_init, + self._frozen, + self._slots, + self._cache_hash, + self._base_attr_map, + self._is_exc, + self._on_setattr is not None + and self._on_setattr is not setters.NO_OP, + attrs_init=True, + ) + ) + + return self + + def add_eq(self): + cd = self._cls_dict + + cd["__eq__"] = self._add_method_dunders( + _make_eq(self._cls, self._attrs) + ) + cd["__ne__"] = self._add_method_dunders(_make_ne()) + + return self + + def add_order(self): + cd = self._cls_dict + + cd["__lt__"], cd["__le__"], cd["__gt__"], cd["__ge__"] = ( + self._add_method_dunders(meth) + for meth in _make_order(self._cls, self._attrs) + ) + + return self + + def add_setattr(self): + if self._frozen: + return self + + sa_attrs = {} + for a in self._attrs: + on_setattr = a.on_setattr or self._on_setattr + if on_setattr and on_setattr is not setters.NO_OP: + sa_attrs[a.name] = a, on_setattr + + if not sa_attrs: + return self + + if self._has_custom_setattr: + # We need to write a __setattr__ but there already is one! + raise ValueError( + "Can't combine custom __setattr__ with on_setattr hooks." + ) + + # docstring comes from _add_method_dunders + def __setattr__(self, name, val): + try: + a, hook = sa_attrs[name] + except KeyError: + nval = val + else: + nval = hook(self, a, val) + + _obj_setattr(self, name, nval) + + self._cls_dict["__attrs_own_setattr__"] = True + self._cls_dict["__setattr__"] = self._add_method_dunders(__setattr__) + self._has_own_setattr = True + + return self + + def _add_method_dunders(self, method): + """ + Add __module__ and __qualname__ to a *method* if possible. + """ + try: + method.__module__ = self._cls.__module__ + except AttributeError: + pass + + try: + method.__qualname__ = ".".join( + (self._cls.__qualname__, method.__name__) + ) + except AttributeError: + pass + + try: + method.__doc__ = "Method generated by attrs for class %s." % ( + self._cls.__qualname__, + ) + except AttributeError: + pass + + return method + + +_CMP_DEPRECATION = ( + "The usage of `cmp` is deprecated and will be removed on or after " + "2021-06-01. Please use `eq` and `order` instead." +) + + +def _determine_attrs_eq_order(cmp, eq, order, default_eq): + """ + Validate the combination of *cmp*, *eq*, and *order*. Derive the effective + values of eq and order. If *eq* is None, set it to *default_eq*. + """ + if cmp is not None and any((eq is not None, order is not None)): + raise ValueError("Don't mix `cmp` with `eq' and `order`.") + + # cmp takes precedence due to bw-compatibility. + if cmp is not None: + return cmp, cmp + + # If left None, equality is set to the specified default and ordering + # mirrors equality. + if eq is None: + eq = default_eq + + if order is None: + order = eq + + if eq is False and order is True: + raise ValueError("`order` can only be True if `eq` is True too.") + + return eq, order + + +def _determine_attrib_eq_order(cmp, eq, order, default_eq): + """ + Validate the combination of *cmp*, *eq*, and *order*. Derive the effective + values of eq and order. If *eq* is None, set it to *default_eq*. + """ + if cmp is not None and any((eq is not None, order is not None)): + raise ValueError("Don't mix `cmp` with `eq' and `order`.") + + def decide_callable_or_boolean(value): + """ + Decide whether a key function is used. + """ + if callable(value): + value, key = True, value + else: + key = None + return value, key + + # cmp takes precedence due to bw-compatibility. + if cmp is not None: + cmp, cmp_key = decide_callable_or_boolean(cmp) + return cmp, cmp_key, cmp, cmp_key + + # If left None, equality is set to the specified default and ordering + # mirrors equality. + if eq is None: + eq, eq_key = default_eq, None + else: + eq, eq_key = decide_callable_or_boolean(eq) + + if order is None: + order, order_key = eq, eq_key + else: + order, order_key = decide_callable_or_boolean(order) + + if eq is False and order is True: + raise ValueError("`order` can only be True if `eq` is True too.") + + return eq, eq_key, order, order_key + + +def _determine_whether_to_implement( + cls, flag, auto_detect, dunders, default=True +): + """ + Check whether we should implement a set of methods for *cls*. + + *flag* is the argument passed into @attr.s like 'init', *auto_detect* the + same as passed into @attr.s and *dunders* is a tuple of attribute names + whose presence signal that the user has implemented it themselves. + + Return *default* if no reason for either for or against is found. + + auto_detect must be False on Python 2. + """ + if flag is True or flag is False: + return flag + + if flag is None and auto_detect is False: + return default + + # Logically, flag is None and auto_detect is True here. + for dunder in dunders: + if _has_own_attribute(cls, dunder): + return False + + return default + + +def attrs( + maybe_cls=None, + these=None, + repr_ns=None, + repr=None, + cmp=None, + hash=None, + init=None, + slots=False, + frozen=False, + weakref_slot=True, + str=False, + auto_attribs=False, + kw_only=False, + cache_hash=False, + auto_exc=False, + eq=None, + order=None, + auto_detect=False, + collect_by_mro=False, + getstate_setstate=None, + on_setattr=None, + field_transformer=None, +): + r""" + A class decorator that adds `dunder + `_\ -methods according to the + specified attributes using `attr.ib` or the *these* argument. + + :param these: A dictionary of name to `attr.ib` mappings. This is + useful to avoid the definition of your attributes within the class body + because you can't (e.g. if you want to add ``__repr__`` methods to + Django models) or don't want to. + + If *these* is not ``None``, ``attrs`` will *not* search the class body + for attributes and will *not* remove any attributes from it. + + If *these* is an ordered dict (`dict` on Python 3.6+, + `collections.OrderedDict` otherwise), the order is deduced from + the order of the attributes inside *these*. Otherwise the order + of the definition of the attributes is used. + + :type these: `dict` of `str` to `attr.ib` + + :param str repr_ns: When using nested classes, there's no way in Python 2 + to automatically detect that. Therefore it's possible to set the + namespace explicitly for a more meaningful ``repr`` output. + :param bool auto_detect: Instead of setting the *init*, *repr*, *eq*, + *order*, and *hash* arguments explicitly, assume they are set to + ``True`` **unless any** of the involved methods for one of the + arguments is implemented in the *current* class (i.e. it is *not* + inherited from some base class). + + So for example by implementing ``__eq__`` on a class yourself, + ``attrs`` will deduce ``eq=False`` and will create *neither* + ``__eq__`` *nor* ``__ne__`` (but Python classes come with a sensible + ``__ne__`` by default, so it *should* be enough to only implement + ``__eq__`` in most cases). + + .. warning:: + + If you prevent ``attrs`` from creating the ordering methods for you + (``order=False``, e.g. by implementing ``__le__``), it becomes + *your* responsibility to make sure its ordering is sound. The best + way is to use the `functools.total_ordering` decorator. + + + Passing ``True`` or ``False`` to *init*, *repr*, *eq*, *order*, + *cmp*, or *hash* overrides whatever *auto_detect* would determine. + + *auto_detect* requires Python 3. Setting it ``True`` on Python 2 raises + a `PythonTooOldError`. + + :param bool repr: Create a ``__repr__`` method with a human readable + representation of ``attrs`` attributes.. + :param bool str: Create a ``__str__`` method that is identical to + ``__repr__``. This is usually not necessary except for + `Exception`\ s. + :param Optional[bool] eq: If ``True`` or ``None`` (default), add ``__eq__`` + and ``__ne__`` methods that check two instances for equality. + + They compare the instances as if they were tuples of their ``attrs`` + attributes if and only if the types of both classes are *identical*! + :param Optional[bool] order: If ``True``, add ``__lt__``, ``__le__``, + ``__gt__``, and ``__ge__`` methods that behave like *eq* above and + allow instances to be ordered. If ``None`` (default) mirror value of + *eq*. + :param Optional[bool] cmp: Setting *cmp* is equivalent to setting *eq* + and *order* to the same value. Must not be mixed with *eq* or *order*. + :param Optional[bool] hash: If ``None`` (default), the ``__hash__`` method + is generated according how *eq* and *frozen* are set. + + 1. If *both* are True, ``attrs`` will generate a ``__hash__`` for you. + 2. If *eq* is True and *frozen* is False, ``__hash__`` will be set to + None, marking it unhashable (which it is). + 3. If *eq* is False, ``__hash__`` will be left untouched meaning the + ``__hash__`` method of the base class will be used (if base class is + ``object``, this means it will fall back to id-based hashing.). + + Although not recommended, you can decide for yourself and force + ``attrs`` to create one (e.g. if the class is immutable even though you + didn't freeze it programmatically) by passing ``True`` or not. Both of + these cases are rather special and should be used carefully. + + See our documentation on `hashing`, Python's documentation on + `object.__hash__`, and the `GitHub issue that led to the default \ + behavior `_ for more + details. + :param bool init: Create a ``__init__`` method that initializes the + ``attrs`` attributes. Leading underscores are stripped for the argument + name. If a ``__attrs_pre_init__`` method exists on the class, it will + be called before the class is initialized. If a ``__attrs_post_init__`` + method exists on the class, it will be called after the class is fully + initialized. + + If ``init`` is ``False``, an ``__attrs_init__`` method will be + injected instead. This allows you to define a custom ``__init__`` + method that can do pre-init work such as ``super().__init__()``, + and then call ``__attrs_init__()`` and ``__attrs_post_init__()``. + :param bool slots: Create a `slotted class ` that's more + memory-efficient. Slotted classes are generally superior to the default + dict classes, but have some gotchas you should know about, so we + encourage you to read the `glossary entry `. + :param bool frozen: Make instances immutable after initialization. If + someone attempts to modify a frozen instance, + `attr.exceptions.FrozenInstanceError` is raised. + + .. note:: + + 1. This is achieved by installing a custom ``__setattr__`` method + on your class, so you can't implement your own. + + 2. True immutability is impossible in Python. + + 3. This *does* have a minor a runtime performance `impact + ` when initializing new instances. In other words: + ``__init__`` is slightly slower with ``frozen=True``. + + 4. If a class is frozen, you cannot modify ``self`` in + ``__attrs_post_init__`` or a self-written ``__init__``. You can + circumvent that limitation by using + ``object.__setattr__(self, "attribute_name", value)``. + + 5. Subclasses of a frozen class are frozen too. + + :param bool weakref_slot: Make instances weak-referenceable. This has no + effect unless ``slots`` is also enabled. + :param bool auto_attribs: If ``True``, collect `PEP 526`_-annotated + attributes (Python 3.6 and later only) from the class body. + + In this case, you **must** annotate every field. If ``attrs`` + encounters a field that is set to an `attr.ib` but lacks a type + annotation, an `attr.exceptions.UnannotatedAttributeError` is + raised. Use ``field_name: typing.Any = attr.ib(...)`` if you don't + want to set a type. + + If you assign a value to those attributes (e.g. ``x: int = 42``), that + value becomes the default value like if it were passed using + ``attr.ib(default=42)``. Passing an instance of `Factory` also + works as expected in most cases (see warning below). + + Attributes annotated as `typing.ClassVar`, and attributes that are + neither annotated nor set to an `attr.ib` are **ignored**. + + .. warning:: + For features that use the attribute name to create decorators (e.g. + `validators `), you still *must* assign `attr.ib` to + them. Otherwise Python will either not find the name or try to use + the default value to call e.g. ``validator`` on it. + + These errors can be quite confusing and probably the most common bug + report on our bug tracker. + + .. _`PEP 526`: https://www.python.org/dev/peps/pep-0526/ + :param bool kw_only: Make all attributes keyword-only (Python 3+) + in the generated ``__init__`` (if ``init`` is ``False``, this + parameter is ignored). + :param bool cache_hash: Ensure that the object's hash code is computed + only once and stored on the object. If this is set to ``True``, + hashing must be either explicitly or implicitly enabled for this + class. If the hash code is cached, avoid any reassignments of + fields involved in hash code computation or mutations of the objects + those fields point to after object creation. If such changes occur, + the behavior of the object's hash code is undefined. + :param bool auto_exc: If the class subclasses `BaseException` + (which implicitly includes any subclass of any exception), the + following happens to behave like a well-behaved Python exceptions + class: + + - the values for *eq*, *order*, and *hash* are ignored and the + instances compare and hash by the instance's ids (N.B. ``attrs`` will + *not* remove existing implementations of ``__hash__`` or the equality + methods. It just won't add own ones.), + - all attributes that are either passed into ``__init__`` or have a + default value are additionally available as a tuple in the ``args`` + attribute, + - the value of *str* is ignored leaving ``__str__`` to base classes. + :param bool collect_by_mro: Setting this to `True` fixes the way ``attrs`` + collects attributes from base classes. The default behavior is + incorrect in certain cases of multiple inheritance. It should be on by + default but is kept off for backward-compatability. + + See issue `#428 `_ for + more details. + + :param Optional[bool] getstate_setstate: + .. note:: + This is usually only interesting for slotted classes and you should + probably just set *auto_detect* to `True`. + + If `True`, ``__getstate__`` and + ``__setstate__`` are generated and attached to the class. This is + necessary for slotted classes to be pickleable. If left `None`, it's + `True` by default for slotted classes and ``False`` for dict classes. + + If *auto_detect* is `True`, and *getstate_setstate* is left `None`, + and **either** ``__getstate__`` or ``__setstate__`` is detected directly + on the class (i.e. not inherited), it is set to `False` (this is usually + what you want). + + :param on_setattr: A callable that is run whenever the user attempts to set + an attribute (either by assignment like ``i.x = 42`` or by using + `setattr` like ``setattr(i, "x", 42)``). It receives the same arguments + as validators: the instance, the attribute that is being modified, and + the new value. + + If no exception is raised, the attribute is set to the return value of + the callable. + + If a list of callables is passed, they're automatically wrapped in an + `attr.setters.pipe`. + + :param Optional[callable] field_transformer: + A function that is called with the original class object and all + fields right before ``attrs`` finalizes the class. You can use + this, e.g., to automatically add converters or validators to + fields based on their types. See `transform-fields` for more details. + + .. versionadded:: 16.0.0 *slots* + .. versionadded:: 16.1.0 *frozen* + .. versionadded:: 16.3.0 *str* + .. versionadded:: 16.3.0 Support for ``__attrs_post_init__``. + .. versionchanged:: 17.1.0 + *hash* supports ``None`` as value which is also the default now. + .. versionadded:: 17.3.0 *auto_attribs* + .. versionchanged:: 18.1.0 + If *these* is passed, no attributes are deleted from the class body. + .. versionchanged:: 18.1.0 If *these* is ordered, the order is retained. + .. versionadded:: 18.2.0 *weakref_slot* + .. deprecated:: 18.2.0 + ``__lt__``, ``__le__``, ``__gt__``, and ``__ge__`` now raise a + `DeprecationWarning` if the classes compared are subclasses of + each other. ``__eq`` and ``__ne__`` never tried to compared subclasses + to each other. + .. versionchanged:: 19.2.0 + ``__lt__``, ``__le__``, ``__gt__``, and ``__ge__`` now do not consider + subclasses comparable anymore. + .. versionadded:: 18.2.0 *kw_only* + .. versionadded:: 18.2.0 *cache_hash* + .. versionadded:: 19.1.0 *auto_exc* + .. deprecated:: 19.2.0 *cmp* Removal on or after 2021-06-01. + .. versionadded:: 19.2.0 *eq* and *order* + .. versionadded:: 20.1.0 *auto_detect* + .. versionadded:: 20.1.0 *collect_by_mro* + .. versionadded:: 20.1.0 *getstate_setstate* + .. versionadded:: 20.1.0 *on_setattr* + .. versionadded:: 20.3.0 *field_transformer* + .. versionchanged:: 21.1.0 + ``init=False`` injects ``__attrs_init__`` + .. versionchanged:: 21.1.0 Support for ``__attrs_pre_init__`` + .. versionchanged:: 21.1.0 *cmp* undeprecated + """ + if auto_detect and PY2: + raise PythonTooOldError( + "auto_detect only works on Python 3 and later." + ) + + eq_, order_ = _determine_attrs_eq_order(cmp, eq, order, None) + hash_ = hash # work around the lack of nonlocal + + if isinstance(on_setattr, (list, tuple)): + on_setattr = setters.pipe(*on_setattr) + + def wrap(cls): + + if getattr(cls, "__class__", None) is None: + raise TypeError("attrs only works with new-style classes.") + + is_frozen = frozen or _has_frozen_base_class(cls) + is_exc = auto_exc is True and issubclass(cls, BaseException) + has_own_setattr = auto_detect and _has_own_attribute( + cls, "__setattr__" + ) + + if has_own_setattr and is_frozen: + raise ValueError("Can't freeze a class with a custom __setattr__.") + + builder = _ClassBuilder( + cls, + these, + slots, + is_frozen, + weakref_slot, + _determine_whether_to_implement( + cls, + getstate_setstate, + auto_detect, + ("__getstate__", "__setstate__"), + default=slots, + ), + auto_attribs, + kw_only, + cache_hash, + is_exc, + collect_by_mro, + on_setattr, + has_own_setattr, + field_transformer, + ) + if _determine_whether_to_implement( + cls, repr, auto_detect, ("__repr__",) + ): + builder.add_repr(repr_ns) + if str is True: + builder.add_str() + + eq = _determine_whether_to_implement( + cls, eq_, auto_detect, ("__eq__", "__ne__") + ) + if not is_exc and eq is True: + builder.add_eq() + if not is_exc and _determine_whether_to_implement( + cls, order_, auto_detect, ("__lt__", "__le__", "__gt__", "__ge__") + ): + builder.add_order() + + builder.add_setattr() + + if ( + hash_ is None + and auto_detect is True + and _has_own_attribute(cls, "__hash__") + ): + hash = False + else: + hash = hash_ + if hash is not True and hash is not False and hash is not None: + # Can't use `hash in` because 1 == True for example. + raise TypeError( + "Invalid value for hash. Must be True, False, or None." + ) + elif hash is False or (hash is None and eq is False) or is_exc: + # Don't do anything. Should fall back to __object__'s __hash__ + # which is by id. + if cache_hash: + raise TypeError( + "Invalid value for cache_hash. To use hash caching," + " hashing must be either explicitly or implicitly " + "enabled." + ) + elif hash is True or ( + hash is None and eq is True and is_frozen is True + ): + # Build a __hash__ if told so, or if it's safe. + builder.add_hash() + else: + # Raise TypeError on attempts to hash. + if cache_hash: + raise TypeError( + "Invalid value for cache_hash. To use hash caching," + " hashing must be either explicitly or implicitly " + "enabled." + ) + builder.make_unhashable() + + if _determine_whether_to_implement( + cls, init, auto_detect, ("__init__",) + ): + builder.add_init() + else: + builder.add_attrs_init() + if cache_hash: + raise TypeError( + "Invalid value for cache_hash. To use hash caching," + " init must be True." + ) + + return builder.build_class() + + # maybe_cls's type depends on the usage of the decorator. It's a class + # if it's used as `@attrs` but ``None`` if used as `@attrs()`. + if maybe_cls is None: + return wrap + else: + return wrap(maybe_cls) + + +_attrs = attrs +""" +Internal alias so we can use it in functions that take an argument called +*attrs*. +""" + + +if PY2: + + def _has_frozen_base_class(cls): + """ + Check whether *cls* has a frozen ancestor by looking at its + __setattr__. + """ + return ( + getattr(cls.__setattr__, "__module__", None) + == _frozen_setattrs.__module__ + and cls.__setattr__.__name__ == _frozen_setattrs.__name__ + ) + + +else: + + def _has_frozen_base_class(cls): + """ + Check whether *cls* has a frozen ancestor by looking at its + __setattr__. + """ + return cls.__setattr__ == _frozen_setattrs + + +def _generate_unique_filename(cls, func_name): + """ + Create a "filename" suitable for a function being generated. + """ + unique_id = uuid.uuid4() + extra = "" + count = 1 + + while True: + unique_filename = "".format( + func_name, + cls.__module__, + getattr(cls, "__qualname__", cls.__name__), + extra, + ) + # To handle concurrency we essentially "reserve" our spot in + # the linecache with a dummy line. The caller can then + # set this value correctly. + cache_line = (1, None, (str(unique_id),), unique_filename) + if ( + linecache.cache.setdefault(unique_filename, cache_line) + == cache_line + ): + return unique_filename + + # Looks like this spot is taken. Try again. + count += 1 + extra = "-{0}".format(count) + + +def _make_hash(cls, attrs, frozen, cache_hash): + attrs = tuple( + a for a in attrs if a.hash is True or (a.hash is None and a.eq is True) + ) + + tab = " " + + unique_filename = _generate_unique_filename(cls, "hash") + type_hash = hash(unique_filename) + + hash_def = "def __hash__(self" + hash_func = "hash((" + closing_braces = "))" + if not cache_hash: + hash_def += "):" + else: + if not PY2: + hash_def += ", *" + + hash_def += ( + ", _cache_wrapper=" + + "__import__('attr._make')._make._CacheHashWrapper):" + ) + hash_func = "_cache_wrapper(" + hash_func + closing_braces += ")" + + method_lines = [hash_def] + + def append_hash_computation_lines(prefix, indent): + """ + Generate the code for actually computing the hash code. + Below this will either be returned directly or used to compute + a value which is then cached, depending on the value of cache_hash + """ + + method_lines.extend( + [ + indent + prefix + hash_func, + indent + " %d," % (type_hash,), + ] + ) + + for a in attrs: + method_lines.append(indent + " self.%s," % a.name) + + method_lines.append(indent + " " + closing_braces) + + if cache_hash: + method_lines.append(tab + "if self.%s is None:" % _hash_cache_field) + if frozen: + append_hash_computation_lines( + "object.__setattr__(self, '%s', " % _hash_cache_field, tab * 2 + ) + method_lines.append(tab * 2 + ")") # close __setattr__ + else: + append_hash_computation_lines( + "self.%s = " % _hash_cache_field, tab * 2 + ) + method_lines.append(tab + "return self.%s" % _hash_cache_field) + else: + append_hash_computation_lines("return ", tab) + + script = "\n".join(method_lines) + return _make_method("__hash__", script, unique_filename) + + +def _add_hash(cls, attrs): + """ + Add a hash method to *cls*. + """ + cls.__hash__ = _make_hash(cls, attrs, frozen=False, cache_hash=False) + return cls + + +def _make_ne(): + """ + Create __ne__ method. + """ + + def __ne__(self, other): + """ + Check equality and either forward a NotImplemented or + return the result negated. + """ + result = self.__eq__(other) + if result is NotImplemented: + return NotImplemented + + return not result + + return __ne__ + + +def _make_eq(cls, attrs): + """ + Create __eq__ method for *cls* with *attrs*. + """ + attrs = [a for a in attrs if a.eq] + + unique_filename = _generate_unique_filename(cls, "eq") + lines = [ + "def __eq__(self, other):", + " if other.__class__ is not self.__class__:", + " return NotImplemented", + ] + + # We can't just do a big self.x = other.x and... clause due to + # irregularities like nan == nan is false but (nan,) == (nan,) is true. + globs = {} + if attrs: + lines.append(" return (") + others = [" ) == ("] + for a in attrs: + if a.eq_key: + cmp_name = "_%s_key" % (a.name,) + # Add the key function to the global namespace + # of the evaluated function. + globs[cmp_name] = a.eq_key + lines.append( + " %s(self.%s)," + % ( + cmp_name, + a.name, + ) + ) + others.append( + " %s(other.%s)," + % ( + cmp_name, + a.name, + ) + ) + else: + lines.append(" self.%s," % (a.name,)) + others.append(" other.%s," % (a.name,)) + + lines += others + [" )"] + else: + lines.append(" return True") + + script = "\n".join(lines) + + return _make_method("__eq__", script, unique_filename, globs) + + +def _make_order(cls, attrs): + """ + Create ordering methods for *cls* with *attrs*. + """ + attrs = [a for a in attrs if a.order] + + def attrs_to_tuple(obj): + """ + Save us some typing. + """ + return tuple( + key(value) if key else value + for value, key in ( + (getattr(obj, a.name), a.order_key) for a in attrs + ) + ) + + def __lt__(self, other): + """ + Automatically created by attrs. + """ + if other.__class__ is self.__class__: + return attrs_to_tuple(self) < attrs_to_tuple(other) + + return NotImplemented + + def __le__(self, other): + """ + Automatically created by attrs. + """ + if other.__class__ is self.__class__: + return attrs_to_tuple(self) <= attrs_to_tuple(other) + + return NotImplemented + + def __gt__(self, other): + """ + Automatically created by attrs. + """ + if other.__class__ is self.__class__: + return attrs_to_tuple(self) > attrs_to_tuple(other) + + return NotImplemented + + def __ge__(self, other): + """ + Automatically created by attrs. + """ + if other.__class__ is self.__class__: + return attrs_to_tuple(self) >= attrs_to_tuple(other) + + return NotImplemented + + return __lt__, __le__, __gt__, __ge__ + + +def _add_eq(cls, attrs=None): + """ + Add equality methods to *cls* with *attrs*. + """ + if attrs is None: + attrs = cls.__attrs_attrs__ + + cls.__eq__ = _make_eq(cls, attrs) + cls.__ne__ = _make_ne() + + return cls + + +_already_repring = threading.local() + + +def _make_repr(attrs, ns): + """ + Make a repr method that includes relevant *attrs*, adding *ns* to the full + name. + """ + + # Figure out which attributes to include, and which function to use to + # format them. The a.repr value can be either bool or a custom callable. + attr_names_with_reprs = tuple( + (a.name, repr if a.repr is True else a.repr) + for a in attrs + if a.repr is not False + ) + + def __repr__(self): + """ + Automatically created by attrs. + """ + try: + working_set = _already_repring.working_set + except AttributeError: + working_set = set() + _already_repring.working_set = working_set + + if id(self) in working_set: + return "..." + real_cls = self.__class__ + if ns is None: + qualname = getattr(real_cls, "__qualname__", None) + if qualname is not None: + class_name = qualname.rsplit(">.", 1)[-1] + else: + class_name = real_cls.__name__ + else: + class_name = ns + "." + real_cls.__name__ + + # Since 'self' remains on the stack (i.e.: strongly referenced) for the + # duration of this call, it's safe to depend on id(...) stability, and + # not need to track the instance and therefore worry about properties + # like weakref- or hash-ability. + working_set.add(id(self)) + try: + result = [class_name, "("] + first = True + for name, attr_repr in attr_names_with_reprs: + if first: + first = False + else: + result.append(", ") + result.extend( + (name, "=", attr_repr(getattr(self, name, NOTHING))) + ) + return "".join(result) + ")" + finally: + working_set.remove(id(self)) + + return __repr__ + + +def _add_repr(cls, ns=None, attrs=None): + """ + Add a repr method to *cls*. + """ + if attrs is None: + attrs = cls.__attrs_attrs__ + + cls.__repr__ = _make_repr(attrs, ns) + return cls + + +def fields(cls): + """ + Return the tuple of ``attrs`` attributes for a class. + + The tuple also allows accessing the fields by their names (see below for + examples). + + :param type cls: Class to introspect. + + :raise TypeError: If *cls* is not a class. + :raise attr.exceptions.NotAnAttrsClassError: If *cls* is not an ``attrs`` + class. + + :rtype: tuple (with name accessors) of `attr.Attribute` + + .. versionchanged:: 16.2.0 Returned tuple allows accessing the fields + by name. + """ + if not isclass(cls): + raise TypeError("Passed object must be a class.") + attrs = getattr(cls, "__attrs_attrs__", None) + if attrs is None: + raise NotAnAttrsClassError( + "{cls!r} is not an attrs-decorated class.".format(cls=cls) + ) + return attrs + + +def fields_dict(cls): + """ + Return an ordered dictionary of ``attrs`` attributes for a class, whose + keys are the attribute names. + + :param type cls: Class to introspect. + + :raise TypeError: If *cls* is not a class. + :raise attr.exceptions.NotAnAttrsClassError: If *cls* is not an ``attrs`` + class. + + :rtype: an ordered dict where keys are attribute names and values are + `attr.Attribute`\\ s. This will be a `dict` if it's + naturally ordered like on Python 3.6+ or an + :class:`~collections.OrderedDict` otherwise. + + .. versionadded:: 18.1.0 + """ + if not isclass(cls): + raise TypeError("Passed object must be a class.") + attrs = getattr(cls, "__attrs_attrs__", None) + if attrs is None: + raise NotAnAttrsClassError( + "{cls!r} is not an attrs-decorated class.".format(cls=cls) + ) + return ordered_dict(((a.name, a) for a in attrs)) + + +def validate(inst): + """ + Validate all attributes on *inst* that have a validator. + + Leaves all exceptions through. + + :param inst: Instance of a class with ``attrs`` attributes. + """ + if _config._run_validators is False: + return + + for a in fields(inst.__class__): + v = a.validator + if v is not None: + v(inst, a, getattr(inst, a.name)) + + +def _is_slot_cls(cls): + return "__slots__" in cls.__dict__ + + +def _is_slot_attr(a_name, base_attr_map): + """ + Check if the attribute name comes from a slot class. + """ + return a_name in base_attr_map and _is_slot_cls(base_attr_map[a_name]) + + +def _make_init( + cls, + attrs, + pre_init, + post_init, + frozen, + slots, + cache_hash, + base_attr_map, + is_exc, + has_global_on_setattr, + attrs_init, +): + if frozen and has_global_on_setattr: + raise ValueError("Frozen classes can't use on_setattr.") + + needs_cached_setattr = cache_hash or frozen + filtered_attrs = [] + attr_dict = {} + for a in attrs: + if not a.init and a.default is NOTHING: + continue + + filtered_attrs.append(a) + attr_dict[a.name] = a + + if a.on_setattr is not None: + if frozen is True: + raise ValueError("Frozen classes can't use on_setattr.") + + needs_cached_setattr = True + elif ( + has_global_on_setattr and a.on_setattr is not setters.NO_OP + ) or _is_slot_attr(a.name, base_attr_map): + needs_cached_setattr = True + + unique_filename = _generate_unique_filename(cls, "init") + + script, globs, annotations = _attrs_to_init_script( + filtered_attrs, + frozen, + slots, + pre_init, + post_init, + cache_hash, + base_attr_map, + is_exc, + needs_cached_setattr, + has_global_on_setattr, + attrs_init, + ) + if cls.__module__ in sys.modules: + # This makes typing.get_type_hints(CLS.__init__) resolve string types. + globs.update(sys.modules[cls.__module__].__dict__) + + globs.update({"NOTHING": NOTHING, "attr_dict": attr_dict}) + + if needs_cached_setattr: + # Save the lookup overhead in __init__ if we need to circumvent + # setattr hooks. + globs["_cached_setattr"] = _obj_setattr + + init = _make_method( + "__attrs_init__" if attrs_init else "__init__", + script, + unique_filename, + globs, + ) + init.__annotations__ = annotations + + return init + + +def _setattr(attr_name, value_var, has_on_setattr): + """ + Use the cached object.setattr to set *attr_name* to *value_var*. + """ + return "_setattr('%s', %s)" % (attr_name, value_var) + + +def _setattr_with_converter(attr_name, value_var, has_on_setattr): + """ + Use the cached object.setattr to set *attr_name* to *value_var*, but run + its converter first. + """ + return "_setattr('%s', %s(%s))" % ( + attr_name, + _init_converter_pat % (attr_name,), + value_var, + ) + + +def _assign(attr_name, value, has_on_setattr): + """ + Unless *attr_name* has an on_setattr hook, use normal assignment. Otherwise + relegate to _setattr. + """ + if has_on_setattr: + return _setattr(attr_name, value, True) + + return "self.%s = %s" % (attr_name, value) + + +def _assign_with_converter(attr_name, value_var, has_on_setattr): + """ + Unless *attr_name* has an on_setattr hook, use normal assignment after + conversion. Otherwise relegate to _setattr_with_converter. + """ + if has_on_setattr: + return _setattr_with_converter(attr_name, value_var, True) + + return "self.%s = %s(%s)" % ( + attr_name, + _init_converter_pat % (attr_name,), + value_var, + ) + + +if PY2: + + def _unpack_kw_only_py2(attr_name, default=None): + """ + Unpack *attr_name* from _kw_only dict. + """ + if default is not None: + arg_default = ", %s" % default + else: + arg_default = "" + return "%s = _kw_only.pop('%s'%s)" % ( + attr_name, + attr_name, + arg_default, + ) + + def _unpack_kw_only_lines_py2(kw_only_args): + """ + Unpack all *kw_only_args* from _kw_only dict and handle errors. + + Given a list of strings "{attr_name}" and "{attr_name}={default}" + generates list of lines of code that pop attrs from _kw_only dict and + raise TypeError similar to builtin if required attr is missing or + extra key is passed. + + >>> print("\n".join(_unpack_kw_only_lines_py2(["a", "b=42"]))) + try: + a = _kw_only.pop('a') + b = _kw_only.pop('b', 42) + except KeyError as _key_error: + raise TypeError( + ... + if _kw_only: + raise TypeError( + ... + """ + lines = ["try:"] + lines.extend( + " " + _unpack_kw_only_py2(*arg.split("=")) + for arg in kw_only_args + ) + lines += """\ +except KeyError as _key_error: + raise TypeError( + '__init__() missing required keyword-only argument: %s' % _key_error + ) +if _kw_only: + raise TypeError( + '__init__() got an unexpected keyword argument %r' + % next(iter(_kw_only)) + ) +""".split( + "\n" + ) + return lines + + +def _attrs_to_init_script( + attrs, + frozen, + slots, + pre_init, + post_init, + cache_hash, + base_attr_map, + is_exc, + needs_cached_setattr, + has_global_on_setattr, + attrs_init, +): + """ + Return a script of an initializer for *attrs* and a dict of globals. + + The globals are expected by the generated script. + + If *frozen* is True, we cannot set the attributes directly so we use + a cached ``object.__setattr__``. + """ + lines = [] + if pre_init: + lines.append("self.__attrs_pre_init__()") + + if needs_cached_setattr: + lines.append( + # Circumvent the __setattr__ descriptor to save one lookup per + # assignment. + # Note _setattr will be used again below if cache_hash is True + "_setattr = _cached_setattr.__get__(self, self.__class__)" + ) + + if frozen is True: + if slots is True: + fmt_setter = _setattr + fmt_setter_with_converter = _setattr_with_converter + else: + # Dict frozen classes assign directly to __dict__. + # But only if the attribute doesn't come from an ancestor slot + # class. + # Note _inst_dict will be used again below if cache_hash is True + lines.append("_inst_dict = self.__dict__") + + def fmt_setter(attr_name, value_var, has_on_setattr): + if _is_slot_attr(attr_name, base_attr_map): + return _setattr(attr_name, value_var, has_on_setattr) + + return "_inst_dict['%s'] = %s" % (attr_name, value_var) + + def fmt_setter_with_converter( + attr_name, value_var, has_on_setattr + ): + if has_on_setattr or _is_slot_attr(attr_name, base_attr_map): + return _setattr_with_converter( + attr_name, value_var, has_on_setattr + ) + + return "_inst_dict['%s'] = %s(%s)" % ( + attr_name, + _init_converter_pat % (attr_name,), + value_var, + ) + + else: + # Not frozen. + fmt_setter = _assign + fmt_setter_with_converter = _assign_with_converter + + args = [] + kw_only_args = [] + attrs_to_validate = [] + + # This is a dictionary of names to validator and converter callables. + # Injecting this into __init__ globals lets us avoid lookups. + names_for_globals = {} + annotations = {"return": None} + + for a in attrs: + if a.validator: + attrs_to_validate.append(a) + + attr_name = a.name + has_on_setattr = a.on_setattr is not None or ( + a.on_setattr is not setters.NO_OP and has_global_on_setattr + ) + arg_name = a.name.lstrip("_") + + has_factory = isinstance(a.default, Factory) + if has_factory and a.default.takes_self: + maybe_self = "self" + else: + maybe_self = "" + + if a.init is False: + if has_factory: + init_factory_name = _init_factory_pat.format(a.name) + if a.converter is not None: + lines.append( + fmt_setter_with_converter( + attr_name, + init_factory_name + "(%s)" % (maybe_self,), + has_on_setattr, + ) + ) + conv_name = _init_converter_pat % (a.name,) + names_for_globals[conv_name] = a.converter + else: + lines.append( + fmt_setter( + attr_name, + init_factory_name + "(%s)" % (maybe_self,), + has_on_setattr, + ) + ) + names_for_globals[init_factory_name] = a.default.factory + else: + if a.converter is not None: + lines.append( + fmt_setter_with_converter( + attr_name, + "attr_dict['%s'].default" % (attr_name,), + has_on_setattr, + ) + ) + conv_name = _init_converter_pat % (a.name,) + names_for_globals[conv_name] = a.converter + else: + lines.append( + fmt_setter( + attr_name, + "attr_dict['%s'].default" % (attr_name,), + has_on_setattr, + ) + ) + elif a.default is not NOTHING and not has_factory: + arg = "%s=attr_dict['%s'].default" % (arg_name, attr_name) + if a.kw_only: + kw_only_args.append(arg) + else: + args.append(arg) + + if a.converter is not None: + lines.append( + fmt_setter_with_converter( + attr_name, arg_name, has_on_setattr + ) + ) + names_for_globals[ + _init_converter_pat % (a.name,) + ] = a.converter + else: + lines.append(fmt_setter(attr_name, arg_name, has_on_setattr)) + + elif has_factory: + arg = "%s=NOTHING" % (arg_name,) + if a.kw_only: + kw_only_args.append(arg) + else: + args.append(arg) + lines.append("if %s is not NOTHING:" % (arg_name,)) + + init_factory_name = _init_factory_pat.format(a.name) + if a.converter is not None: + lines.append( + " " + + fmt_setter_with_converter( + attr_name, arg_name, has_on_setattr + ) + ) + lines.append("else:") + lines.append( + " " + + fmt_setter_with_converter( + attr_name, + init_factory_name + "(" + maybe_self + ")", + has_on_setattr, + ) + ) + names_for_globals[ + _init_converter_pat % (a.name,) + ] = a.converter + else: + lines.append( + " " + fmt_setter(attr_name, arg_name, has_on_setattr) + ) + lines.append("else:") + lines.append( + " " + + fmt_setter( + attr_name, + init_factory_name + "(" + maybe_self + ")", + has_on_setattr, + ) + ) + names_for_globals[init_factory_name] = a.default.factory + else: + if a.kw_only: + kw_only_args.append(arg_name) + else: + args.append(arg_name) + + if a.converter is not None: + lines.append( + fmt_setter_with_converter( + attr_name, arg_name, has_on_setattr + ) + ) + names_for_globals[ + _init_converter_pat % (a.name,) + ] = a.converter + else: + lines.append(fmt_setter(attr_name, arg_name, has_on_setattr)) + + if a.init is True: + if a.type is not None and a.converter is None: + annotations[arg_name] = a.type + elif a.converter is not None and not PY2: + # Try to get the type from the converter. + sig = None + try: + sig = inspect.signature(a.converter) + except (ValueError, TypeError): # inspect failed + pass + if sig: + sig_params = list(sig.parameters.values()) + if ( + sig_params + and sig_params[0].annotation + is not inspect.Parameter.empty + ): + annotations[arg_name] = sig_params[0].annotation + + if attrs_to_validate: # we can skip this if there are no validators. + names_for_globals["_config"] = _config + lines.append("if _config._run_validators is True:") + for a in attrs_to_validate: + val_name = "__attr_validator_" + a.name + attr_name = "__attr_" + a.name + lines.append( + " %s(self, %s, self.%s)" % (val_name, attr_name, a.name) + ) + names_for_globals[val_name] = a.validator + names_for_globals[attr_name] = a + + if post_init: + lines.append("self.__attrs_post_init__()") + + # because this is set only after __attrs_post_init is called, a crash + # will result if post-init tries to access the hash code. This seemed + # preferable to setting this beforehand, in which case alteration to + # field values during post-init combined with post-init accessing the + # hash code would result in silent bugs. + if cache_hash: + if frozen: + if slots: + # if frozen and slots, then _setattr defined above + init_hash_cache = "_setattr('%s', %s)" + else: + # if frozen and not slots, then _inst_dict defined above + init_hash_cache = "_inst_dict['%s'] = %s" + else: + init_hash_cache = "self.%s = %s" + lines.append(init_hash_cache % (_hash_cache_field, "None")) + + # For exceptions we rely on BaseException.__init__ for proper + # initialization. + if is_exc: + vals = ",".join("self." + a.name for a in attrs if a.init) + + lines.append("BaseException.__init__(self, %s)" % (vals,)) + + args = ", ".join(args) + if kw_only_args: + if PY2: + lines = _unpack_kw_only_lines_py2(kw_only_args) + lines + + args += "%s**_kw_only" % (", " if args else "",) # leading comma + else: + args += "%s*, %s" % ( + ", " if args else "", # leading comma + ", ".join(kw_only_args), # kw_only args + ) + return ( + """\ +def {init_name}(self, {args}): + {lines} +""".format( + init_name=("__attrs_init__" if attrs_init else "__init__"), + args=args, + lines="\n ".join(lines) if lines else "pass", + ), + names_for_globals, + annotations, + ) + + +class Attribute(object): + """ + *Read-only* representation of an attribute. + + Instances of this class are frequently used for introspection purposes + like: + + - `fields` returns a tuple of them. + - Validators get them passed as the first argument. + - The *field transformer* hook receives a list of them. + + :attribute name: The name of the attribute. + :attribute inherited: Whether or not that attribute has been inherited from + a base class. + + Plus *all* arguments of `attr.ib` (except for ``factory`` + which is only syntactic sugar for ``default=Factory(...)``. + + .. versionadded:: 20.1.0 *inherited* + .. versionadded:: 20.1.0 *on_setattr* + .. versionchanged:: 20.2.0 *inherited* is not taken into account for + equality checks and hashing anymore. + .. versionadded:: 21.1.0 *eq_key* and *order_key* + + For the full version history of the fields, see `attr.ib`. + """ + + __slots__ = ( + "name", + "default", + "validator", + "repr", + "eq", + "eq_key", + "order", + "order_key", + "hash", + "init", + "metadata", + "type", + "converter", + "kw_only", + "inherited", + "on_setattr", + ) + + def __init__( + self, + name, + default, + validator, + repr, + cmp, # XXX: unused, remove along with other cmp code. + hash, + init, + inherited, + metadata=None, + type=None, + converter=None, + kw_only=False, + eq=None, + eq_key=None, + order=None, + order_key=None, + on_setattr=None, + ): + eq, eq_key, order, order_key = _determine_attrib_eq_order( + cmp, eq_key or eq, order_key or order, True + ) + + # Cache this descriptor here to speed things up later. + bound_setattr = _obj_setattr.__get__(self, Attribute) + + # Despite the big red warning, people *do* instantiate `Attribute` + # themselves. + bound_setattr("name", name) + bound_setattr("default", default) + bound_setattr("validator", validator) + bound_setattr("repr", repr) + bound_setattr("eq", eq) + bound_setattr("eq_key", eq_key) + bound_setattr("order", order) + bound_setattr("order_key", order_key) + bound_setattr("hash", hash) + bound_setattr("init", init) + bound_setattr("converter", converter) + bound_setattr( + "metadata", + ( + metadata_proxy(metadata) + if metadata + else _empty_metadata_singleton + ), + ) + bound_setattr("type", type) + bound_setattr("kw_only", kw_only) + bound_setattr("inherited", inherited) + bound_setattr("on_setattr", on_setattr) + + def __setattr__(self, name, value): + raise FrozenInstanceError() + + @classmethod + def from_counting_attr(cls, name, ca, type=None): + # type holds the annotated value. deal with conflicts: + if type is None: + type = ca.type + elif ca.type is not None: + raise ValueError( + "Type annotation and type argument cannot both be present" + ) + inst_dict = { + k: getattr(ca, k) + for k in Attribute.__slots__ + if k + not in ( + "name", + "validator", + "default", + "type", + "inherited", + ) # exclude methods and deprecated alias + } + return cls( + name=name, + validator=ca._validator, + default=ca._default, + type=type, + cmp=None, + inherited=False, + **inst_dict + ) + + @property + def cmp(self): + """ + Simulate the presence of a cmp attribute and warn. + """ + warnings.warn(_CMP_DEPRECATION, DeprecationWarning, stacklevel=2) + + return self.eq and self.order + + # Don't use attr.evolve since fields(Attribute) doesn't work + def evolve(self, **changes): + """ + Copy *self* and apply *changes*. + + This works similarly to `attr.evolve` but that function does not work + with ``Attribute``. + + It is mainly meant to be used for `transform-fields`. + + .. versionadded:: 20.3.0 + """ + new = copy.copy(self) + + new._setattrs(changes.items()) + + return new + + # Don't use _add_pickle since fields(Attribute) doesn't work + def __getstate__(self): + """ + Play nice with pickle. + """ + return tuple( + getattr(self, name) if name != "metadata" else dict(self.metadata) + for name in self.__slots__ + ) + + def __setstate__(self, state): + """ + Play nice with pickle. + """ + self._setattrs(zip(self.__slots__, state)) + + def _setattrs(self, name_values_pairs): + bound_setattr = _obj_setattr.__get__(self, Attribute) + for name, value in name_values_pairs: + if name != "metadata": + bound_setattr(name, value) + else: + bound_setattr( + name, + metadata_proxy(value) + if value + else _empty_metadata_singleton, + ) + + +_a = [ + Attribute( + name=name, + default=NOTHING, + validator=None, + repr=True, + cmp=None, + eq=True, + order=False, + hash=(name != "metadata"), + init=True, + inherited=False, + ) + for name in Attribute.__slots__ +] + +Attribute = _add_hash( + _add_eq( + _add_repr(Attribute, attrs=_a), + attrs=[a for a in _a if a.name != "inherited"], + ), + attrs=[a for a in _a if a.hash and a.name != "inherited"], +) + + +class _CountingAttr(object): + """ + Intermediate representation of attributes that uses a counter to preserve + the order in which the attributes have been defined. + + *Internal* data structure of the attrs library. Running into is most + likely the result of a bug like a forgotten `@attr.s` decorator. + """ + + __slots__ = ( + "counter", + "_default", + "repr", + "eq", + "eq_key", + "order", + "order_key", + "hash", + "init", + "metadata", + "_validator", + "converter", + "type", + "kw_only", + "on_setattr", + ) + __attrs_attrs__ = tuple( + Attribute( + name=name, + default=NOTHING, + validator=None, + repr=True, + cmp=None, + hash=True, + init=True, + kw_only=False, + eq=True, + eq_key=None, + order=False, + order_key=None, + inherited=False, + on_setattr=None, + ) + for name in ( + "counter", + "_default", + "repr", + "eq", + "order", + "hash", + "init", + "on_setattr", + ) + ) + ( + Attribute( + name="metadata", + default=None, + validator=None, + repr=True, + cmp=None, + hash=False, + init=True, + kw_only=False, + eq=True, + eq_key=None, + order=False, + order_key=None, + inherited=False, + on_setattr=None, + ), + ) + cls_counter = 0 + + def __init__( + self, + default, + validator, + repr, + cmp, + hash, + init, + converter, + metadata, + type, + kw_only, + eq, + eq_key, + order, + order_key, + on_setattr, + ): + _CountingAttr.cls_counter += 1 + self.counter = _CountingAttr.cls_counter + self._default = default + self._validator = validator + self.converter = converter + self.repr = repr + self.eq = eq + self.eq_key = eq_key + self.order = order + self.order_key = order_key + self.hash = hash + self.init = init + self.metadata = metadata + self.type = type + self.kw_only = kw_only + self.on_setattr = on_setattr + + def validator(self, meth): + """ + Decorator that adds *meth* to the list of validators. + + Returns *meth* unchanged. + + .. versionadded:: 17.1.0 + """ + if self._validator is None: + self._validator = meth + else: + self._validator = and_(self._validator, meth) + return meth + + def default(self, meth): + """ + Decorator that allows to set the default for an attribute. + + Returns *meth* unchanged. + + :raises DefaultAlreadySetError: If default has been set before. + + .. versionadded:: 17.1.0 + """ + if self._default is not NOTHING: + raise DefaultAlreadySetError() + + self._default = Factory(meth, takes_self=True) + + return meth + + +_CountingAttr = _add_eq(_add_repr(_CountingAttr)) + + +class Factory(object): + """ + Stores a factory callable. + + If passed as the default value to `attr.ib`, the factory is used to + generate a new value. + + :param callable factory: A callable that takes either none or exactly one + mandatory positional argument depending on *takes_self*. + :param bool takes_self: Pass the partially initialized instance that is + being initialized as a positional argument. + + .. versionadded:: 17.1.0 *takes_self* + """ + + __slots__ = ("factory", "takes_self") + + def __init__(self, factory, takes_self=False): + """ + `Factory` is part of the default machinery so if we want a default + value here, we have to implement it ourselves. + """ + self.factory = factory + self.takes_self = takes_self + + def __getstate__(self): + """ + Play nice with pickle. + """ + return tuple(getattr(self, name) for name in self.__slots__) + + def __setstate__(self, state): + """ + Play nice with pickle. + """ + for name, value in zip(self.__slots__, state): + setattr(self, name, value) + + +_f = [ + Attribute( + name=name, + default=NOTHING, + validator=None, + repr=True, + cmp=None, + eq=True, + order=False, + hash=True, + init=True, + inherited=False, + ) + for name in Factory.__slots__ +] + +Factory = _add_hash(_add_eq(_add_repr(Factory, attrs=_f), attrs=_f), attrs=_f) + + +def make_class(name, attrs, bases=(object,), **attributes_arguments): + """ + A quick way to create a new class called *name* with *attrs*. + + :param str name: The name for the new class. + + :param attrs: A list of names or a dictionary of mappings of names to + attributes. + + If *attrs* is a list or an ordered dict (`dict` on Python 3.6+, + `collections.OrderedDict` otherwise), the order is deduced from + the order of the names or attributes inside *attrs*. Otherwise the + order of the definition of the attributes is used. + :type attrs: `list` or `dict` + + :param tuple bases: Classes that the new class will subclass. + + :param attributes_arguments: Passed unmodified to `attr.s`. + + :return: A new class with *attrs*. + :rtype: type + + .. versionadded:: 17.1.0 *bases* + .. versionchanged:: 18.1.0 If *attrs* is ordered, the order is retained. + """ + if isinstance(attrs, dict): + cls_dict = attrs + elif isinstance(attrs, (list, tuple)): + cls_dict = dict((a, attrib()) for a in attrs) + else: + raise TypeError("attrs argument must be a dict or a list.") + + pre_init = cls_dict.pop("__attrs_pre_init__", None) + post_init = cls_dict.pop("__attrs_post_init__", None) + user_init = cls_dict.pop("__init__", None) + + body = {} + if pre_init is not None: + body["__attrs_pre_init__"] = pre_init + if post_init is not None: + body["__attrs_post_init__"] = post_init + if user_init is not None: + body["__init__"] = user_init + + type_ = new_class(name, bases, {}, lambda ns: ns.update(body)) + + # For pickling to work, the __module__ variable needs to be set to the + # frame where the class is created. Bypass this step in environments where + # sys._getframe is not defined (Jython for example) or sys._getframe is not + # defined for arguments greater than 0 (IronPython). + try: + type_.__module__ = sys._getframe(1).f_globals.get( + "__name__", "__main__" + ) + except (AttributeError, ValueError): + pass + + # We do it here for proper warnings with meaningful stacklevel. + cmp = attributes_arguments.pop("cmp", None) + ( + attributes_arguments["eq"], + attributes_arguments["order"], + ) = _determine_attrs_eq_order( + cmp, + attributes_arguments.get("eq"), + attributes_arguments.get("order"), + True, + ) + + return _attrs(these=cls_dict, **attributes_arguments)(type_) + + +# These are required by within this module so we define them here and merely +# import into .validators / .converters. + + +@attrs(slots=True, hash=True) +class _AndValidator(object): + """ + Compose many validators to a single one. + """ + + _validators = attrib() + + def __call__(self, inst, attr, value): + for v in self._validators: + v(inst, attr, value) + + +def and_(*validators): + """ + A validator that composes multiple validators into one. + + When called on a value, it runs all wrapped validators. + + :param callables validators: Arbitrary number of validators. + + .. versionadded:: 17.1.0 + """ + vals = [] + for validator in validators: + vals.extend( + validator._validators + if isinstance(validator, _AndValidator) + else [validator] + ) + + return _AndValidator(tuple(vals)) + + +def pipe(*converters): + """ + A converter that composes multiple converters into one. + + When called on a value, it runs all wrapped converters, returning the + *last* value. + + Type annotations will be inferred from the wrapped converters', if + they have any. + + :param callables converters: Arbitrary number of converters. + + .. versionadded:: 20.1.0 + """ + + def pipe_converter(val): + for converter in converters: + val = converter(val) + + return val + + if not PY2: + if not converters: + # If the converter list is empty, pipe_converter is the identity. + A = typing.TypeVar("A") + pipe_converter.__annotations__ = {"val": A, "return": A} + else: + # Get parameter type. + sig = None + try: + sig = inspect.signature(converters[0]) + except (ValueError, TypeError): # inspect failed + pass + if sig: + params = list(sig.parameters.values()) + if ( + params + and params[0].annotation is not inspect.Parameter.empty + ): + pipe_converter.__annotations__["val"] = params[ + 0 + ].annotation + # Get return type. + sig = None + try: + sig = inspect.signature(converters[-1]) + except (ValueError, TypeError): # inspect failed + pass + if sig and sig.return_annotation is not inspect.Signature().empty: + pipe_converter.__annotations__[ + "return" + ] = sig.return_annotation + + return pipe_converter diff --git a/openpype/hosts/fusion/vendor/attr/_next_gen.py b/openpype/hosts/fusion/vendor/attr/_next_gen.py new file mode 100644 index 0000000000..fab0af966a --- /dev/null +++ b/openpype/hosts/fusion/vendor/attr/_next_gen.py @@ -0,0 +1,158 @@ +""" +These are Python 3.6+-only and keyword-only APIs that call `attr.s` and +`attr.ib` with different default values. +""" + +from functools import partial + +from attr.exceptions import UnannotatedAttributeError + +from . import setters +from ._make import NOTHING, _frozen_setattrs, attrib, attrs + + +def define( + maybe_cls=None, + *, + these=None, + repr=None, + hash=None, + init=None, + slots=True, + frozen=False, + weakref_slot=True, + str=False, + auto_attribs=None, + kw_only=False, + cache_hash=False, + auto_exc=True, + eq=None, + order=False, + auto_detect=True, + getstate_setstate=None, + on_setattr=None, + field_transformer=None, +): + r""" + The only behavioral differences are the handling of the *auto_attribs* + option: + + :param Optional[bool] auto_attribs: If set to `True` or `False`, it behaves + exactly like `attr.s`. If left `None`, `attr.s` will try to guess: + + 1. If any attributes are annotated and no unannotated `attr.ib`\ s + are found, it assumes *auto_attribs=True*. + 2. Otherwise it assumes *auto_attribs=False* and tries to collect + `attr.ib`\ s. + + and that mutable classes (``frozen=False``) validate on ``__setattr__``. + + .. versionadded:: 20.1.0 + """ + + def do_it(cls, auto_attribs): + return attrs( + maybe_cls=cls, + these=these, + repr=repr, + hash=hash, + init=init, + slots=slots, + frozen=frozen, + weakref_slot=weakref_slot, + str=str, + auto_attribs=auto_attribs, + kw_only=kw_only, + cache_hash=cache_hash, + auto_exc=auto_exc, + eq=eq, + order=order, + auto_detect=auto_detect, + collect_by_mro=True, + getstate_setstate=getstate_setstate, + on_setattr=on_setattr, + field_transformer=field_transformer, + ) + + def wrap(cls): + """ + Making this a wrapper ensures this code runs during class creation. + + We also ensure that frozen-ness of classes is inherited. + """ + nonlocal frozen, on_setattr + + had_on_setattr = on_setattr not in (None, setters.NO_OP) + + # By default, mutable classes validate on setattr. + if frozen is False and on_setattr is None: + on_setattr = setters.validate + + # However, if we subclass a frozen class, we inherit the immutability + # and disable on_setattr. + for base_cls in cls.__bases__: + if base_cls.__setattr__ is _frozen_setattrs: + if had_on_setattr: + raise ValueError( + "Frozen classes can't use on_setattr " + "(frozen-ness was inherited)." + ) + + on_setattr = setters.NO_OP + break + + if auto_attribs is not None: + return do_it(cls, auto_attribs) + + try: + return do_it(cls, True) + except UnannotatedAttributeError: + return do_it(cls, False) + + # maybe_cls's type depends on the usage of the decorator. It's a class + # if it's used as `@attrs` but ``None`` if used as `@attrs()`. + if maybe_cls is None: + return wrap + else: + return wrap(maybe_cls) + + +mutable = define +frozen = partial(define, frozen=True, on_setattr=None) + + +def field( + *, + default=NOTHING, + validator=None, + repr=True, + hash=None, + init=True, + metadata=None, + converter=None, + factory=None, + kw_only=False, + eq=None, + order=None, + on_setattr=None, +): + """ + Identical to `attr.ib`, except keyword-only and with some arguments + removed. + + .. versionadded:: 20.1.0 + """ + return attrib( + default=default, + validator=validator, + repr=repr, + hash=hash, + init=init, + metadata=metadata, + converter=converter, + factory=factory, + kw_only=kw_only, + eq=eq, + order=order, + on_setattr=on_setattr, + ) diff --git a/openpype/hosts/fusion/vendor/attr/_version_info.py b/openpype/hosts/fusion/vendor/attr/_version_info.py new file mode 100644 index 0000000000..014e78a1b4 --- /dev/null +++ b/openpype/hosts/fusion/vendor/attr/_version_info.py @@ -0,0 +1,85 @@ +from __future__ import absolute_import, division, print_function + +from functools import total_ordering + +from ._funcs import astuple +from ._make import attrib, attrs + + +@total_ordering +@attrs(eq=False, order=False, slots=True, frozen=True) +class VersionInfo(object): + """ + A version object that can be compared to tuple of length 1--4: + + >>> attr.VersionInfo(19, 1, 0, "final") <= (19, 2) + True + >>> attr.VersionInfo(19, 1, 0, "final") < (19, 1, 1) + True + >>> vi = attr.VersionInfo(19, 2, 0, "final") + >>> vi < (19, 1, 1) + False + >>> vi < (19,) + False + >>> vi == (19, 2,) + True + >>> vi == (19, 2, 1) + False + + .. versionadded:: 19.2 + """ + + year = attrib(type=int) + minor = attrib(type=int) + micro = attrib(type=int) + releaselevel = attrib(type=str) + + @classmethod + def _from_version_string(cls, s): + """ + Parse *s* and return a _VersionInfo. + """ + v = s.split(".") + if len(v) == 3: + v.append("final") + + return cls( + year=int(v[0]), minor=int(v[1]), micro=int(v[2]), releaselevel=v[3] + ) + + def _ensure_tuple(self, other): + """ + Ensure *other* is a tuple of a valid length. + + Returns a possibly transformed *other* and ourselves as a tuple of + the same length as *other*. + """ + + if self.__class__ is other.__class__: + other = astuple(other) + + if not isinstance(other, tuple): + raise NotImplementedError + + if not (1 <= len(other) <= 4): + raise NotImplementedError + + return astuple(self)[: len(other)], other + + def __eq__(self, other): + try: + us, them = self._ensure_tuple(other) + except NotImplementedError: + return NotImplemented + + return us == them + + def __lt__(self, other): + try: + us, them = self._ensure_tuple(other) + except NotImplementedError: + return NotImplemented + + # Since alphabetically "dev0" < "final" < "post1" < "post2", we don't + # have to do anything special with releaselevel for now. + return us < them diff --git a/openpype/hosts/fusion/vendor/attr/_version_info.pyi b/openpype/hosts/fusion/vendor/attr/_version_info.pyi new file mode 100644 index 0000000000..45ced08633 --- /dev/null +++ b/openpype/hosts/fusion/vendor/attr/_version_info.pyi @@ -0,0 +1,9 @@ +class VersionInfo: + @property + def year(self) -> int: ... + @property + def minor(self) -> int: ... + @property + def micro(self) -> int: ... + @property + def releaselevel(self) -> str: ... diff --git a/openpype/hosts/fusion/vendor/attr/converters.py b/openpype/hosts/fusion/vendor/attr/converters.py new file mode 100644 index 0000000000..2777db6d0a --- /dev/null +++ b/openpype/hosts/fusion/vendor/attr/converters.py @@ -0,0 +1,111 @@ +""" +Commonly useful converters. +""" + +from __future__ import absolute_import, division, print_function + +from ._compat import PY2 +from ._make import NOTHING, Factory, pipe + + +if not PY2: + import inspect + import typing + + +__all__ = [ + "pipe", + "optional", + "default_if_none", +] + + +def optional(converter): + """ + A converter that allows an attribute to be optional. An optional attribute + is one which can be set to ``None``. + + Type annotations will be inferred from the wrapped converter's, if it + has any. + + :param callable converter: the converter that is used for non-``None`` + values. + + .. versionadded:: 17.1.0 + """ + + def optional_converter(val): + if val is None: + return None + return converter(val) + + if not PY2: + sig = None + try: + sig = inspect.signature(converter) + except (ValueError, TypeError): # inspect failed + pass + if sig: + params = list(sig.parameters.values()) + if params and params[0].annotation is not inspect.Parameter.empty: + optional_converter.__annotations__["val"] = typing.Optional[ + params[0].annotation + ] + if sig.return_annotation is not inspect.Signature.empty: + optional_converter.__annotations__["return"] = typing.Optional[ + sig.return_annotation + ] + + return optional_converter + + +def default_if_none(default=NOTHING, factory=None): + """ + A converter that allows to replace ``None`` values by *default* or the + result of *factory*. + + :param default: Value to be used if ``None`` is passed. Passing an instance + of `attr.Factory` is supported, however the ``takes_self`` option + is *not*. + :param callable factory: A callable that takes no parameters whose result + is used if ``None`` is passed. + + :raises TypeError: If **neither** *default* or *factory* is passed. + :raises TypeError: If **both** *default* and *factory* are passed. + :raises ValueError: If an instance of `attr.Factory` is passed with + ``takes_self=True``. + + .. versionadded:: 18.2.0 + """ + if default is NOTHING and factory is None: + raise TypeError("Must pass either `default` or `factory`.") + + if default is not NOTHING and factory is not None: + raise TypeError( + "Must pass either `default` or `factory` but not both." + ) + + if factory is not None: + default = Factory(factory) + + if isinstance(default, Factory): + if default.takes_self: + raise ValueError( + "`takes_self` is not supported by default_if_none." + ) + + def default_if_none_converter(val): + if val is not None: + return val + + return default.factory() + + else: + + def default_if_none_converter(val): + if val is not None: + return val + + return default + + return default_if_none_converter diff --git a/openpype/hosts/fusion/vendor/attr/converters.pyi b/openpype/hosts/fusion/vendor/attr/converters.pyi new file mode 100644 index 0000000000..84a57590b0 --- /dev/null +++ b/openpype/hosts/fusion/vendor/attr/converters.pyi @@ -0,0 +1,13 @@ +from typing import Callable, Optional, TypeVar, overload + +from . import _ConverterType + + +_T = TypeVar("_T") + +def pipe(*validators: _ConverterType) -> _ConverterType: ... +def optional(converter: _ConverterType) -> _ConverterType: ... +@overload +def default_if_none(default: _T) -> _ConverterType: ... +@overload +def default_if_none(*, factory: Callable[[], _T]) -> _ConverterType: ... diff --git a/openpype/hosts/fusion/vendor/attr/exceptions.py b/openpype/hosts/fusion/vendor/attr/exceptions.py new file mode 100644 index 0000000000..f6f9861bea --- /dev/null +++ b/openpype/hosts/fusion/vendor/attr/exceptions.py @@ -0,0 +1,92 @@ +from __future__ import absolute_import, division, print_function + + +class FrozenError(AttributeError): + """ + A frozen/immutable instance or attribute have been attempted to be + modified. + + It mirrors the behavior of ``namedtuples`` by using the same error message + and subclassing `AttributeError`. + + .. versionadded:: 20.1.0 + """ + + msg = "can't set attribute" + args = [msg] + + +class FrozenInstanceError(FrozenError): + """ + A frozen instance has been attempted to be modified. + + .. versionadded:: 16.1.0 + """ + + +class FrozenAttributeError(FrozenError): + """ + A frozen attribute has been attempted to be modified. + + .. versionadded:: 20.1.0 + """ + + +class AttrsAttributeNotFoundError(ValueError): + """ + An ``attrs`` function couldn't find an attribute that the user asked for. + + .. versionadded:: 16.2.0 + """ + + +class NotAnAttrsClassError(ValueError): + """ + A non-``attrs`` class has been passed into an ``attrs`` function. + + .. versionadded:: 16.2.0 + """ + + +class DefaultAlreadySetError(RuntimeError): + """ + A default has been set using ``attr.ib()`` and is attempted to be reset + using the decorator. + + .. versionadded:: 17.1.0 + """ + + +class UnannotatedAttributeError(RuntimeError): + """ + A class with ``auto_attribs=True`` has an ``attr.ib()`` without a type + annotation. + + .. versionadded:: 17.3.0 + """ + + +class PythonTooOldError(RuntimeError): + """ + It was attempted to use an ``attrs`` feature that requires a newer Python + version. + + .. versionadded:: 18.2.0 + """ + + +class NotCallableError(TypeError): + """ + A ``attr.ib()`` requiring a callable has been set with a value + that is not callable. + + .. versionadded:: 19.2.0 + """ + + def __init__(self, msg, value): + super(TypeError, self).__init__(msg, value) + self.msg = msg + self.value = value + + def __str__(self): + return str(self.msg) diff --git a/openpype/hosts/fusion/vendor/attr/exceptions.pyi b/openpype/hosts/fusion/vendor/attr/exceptions.pyi new file mode 100644 index 0000000000..a800fb26bb --- /dev/null +++ b/openpype/hosts/fusion/vendor/attr/exceptions.pyi @@ -0,0 +1,18 @@ +from typing import Any + + +class FrozenError(AttributeError): + msg: str = ... + +class FrozenInstanceError(FrozenError): ... +class FrozenAttributeError(FrozenError): ... +class AttrsAttributeNotFoundError(ValueError): ... +class NotAnAttrsClassError(ValueError): ... +class DefaultAlreadySetError(RuntimeError): ... +class UnannotatedAttributeError(RuntimeError): ... +class PythonTooOldError(RuntimeError): ... + +class NotCallableError(TypeError): + msg: str = ... + value: Any = ... + def __init__(self, msg: str, value: Any) -> None: ... diff --git a/openpype/hosts/fusion/vendor/attr/filters.py b/openpype/hosts/fusion/vendor/attr/filters.py new file mode 100644 index 0000000000..dc47e8fa38 --- /dev/null +++ b/openpype/hosts/fusion/vendor/attr/filters.py @@ -0,0 +1,52 @@ +""" +Commonly useful filters for `attr.asdict`. +""" + +from __future__ import absolute_import, division, print_function + +from ._compat import isclass +from ._make import Attribute + + +def _split_what(what): + """ + Returns a tuple of `frozenset`s of classes and attributes. + """ + return ( + frozenset(cls for cls in what if isclass(cls)), + frozenset(cls for cls in what if isinstance(cls, Attribute)), + ) + + +def include(*what): + """ + Whitelist *what*. + + :param what: What to whitelist. + :type what: `list` of `type` or `attr.Attribute`\\ s + + :rtype: `callable` + """ + cls, attrs = _split_what(what) + + def include_(attribute, value): + return value.__class__ in cls or attribute in attrs + + return include_ + + +def exclude(*what): + """ + Blacklist *what*. + + :param what: What to blacklist. + :type what: `list` of classes or `attr.Attribute`\\ s. + + :rtype: `callable` + """ + cls, attrs = _split_what(what) + + def exclude_(attribute, value): + return value.__class__ not in cls and attribute not in attrs + + return exclude_ diff --git a/openpype/hosts/fusion/vendor/attr/filters.pyi b/openpype/hosts/fusion/vendor/attr/filters.pyi new file mode 100644 index 0000000000..f7b63f1bb4 --- /dev/null +++ b/openpype/hosts/fusion/vendor/attr/filters.pyi @@ -0,0 +1,7 @@ +from typing import Any, Union + +from . import Attribute, _FilterType + + +def include(*what: Union[type, Attribute[Any]]) -> _FilterType[Any]: ... +def exclude(*what: Union[type, Attribute[Any]]) -> _FilterType[Any]: ... diff --git a/openpype/hosts/fusion/vendor/attr/py.typed b/openpype/hosts/fusion/vendor/attr/py.typed new file mode 100644 index 0000000000..e69de29bb2 diff --git a/openpype/hosts/fusion/vendor/attr/setters.py b/openpype/hosts/fusion/vendor/attr/setters.py new file mode 100644 index 0000000000..240014b3c1 --- /dev/null +++ b/openpype/hosts/fusion/vendor/attr/setters.py @@ -0,0 +1,77 @@ +""" +Commonly used hooks for on_setattr. +""" + +from __future__ import absolute_import, division, print_function + +from . import _config +from .exceptions import FrozenAttributeError + + +def pipe(*setters): + """ + Run all *setters* and return the return value of the last one. + + .. versionadded:: 20.1.0 + """ + + def wrapped_pipe(instance, attrib, new_value): + rv = new_value + + for setter in setters: + rv = setter(instance, attrib, rv) + + return rv + + return wrapped_pipe + + +def frozen(_, __, ___): + """ + Prevent an attribute to be modified. + + .. versionadded:: 20.1.0 + """ + raise FrozenAttributeError() + + +def validate(instance, attrib, new_value): + """ + Run *attrib*'s validator on *new_value* if it has one. + + .. versionadded:: 20.1.0 + """ + if _config._run_validators is False: + return new_value + + v = attrib.validator + if not v: + return new_value + + v(instance, attrib, new_value) + + return new_value + + +def convert(instance, attrib, new_value): + """ + Run *attrib*'s converter -- if it has one -- on *new_value* and return the + result. + + .. versionadded:: 20.1.0 + """ + c = attrib.converter + if c: + return c(new_value) + + return new_value + + +NO_OP = object() +""" +Sentinel for disabling class-wide *on_setattr* hooks for certain attributes. + +Does not work in `pipe` or within lists. + +.. versionadded:: 20.1.0 +""" diff --git a/openpype/hosts/fusion/vendor/attr/setters.pyi b/openpype/hosts/fusion/vendor/attr/setters.pyi new file mode 100644 index 0000000000..a921e07deb --- /dev/null +++ b/openpype/hosts/fusion/vendor/attr/setters.pyi @@ -0,0 +1,20 @@ +from typing import Any, NewType, NoReturn, TypeVar, cast + +from . import Attribute, _OnSetAttrType + + +_T = TypeVar("_T") + +def frozen( + instance: Any, attribute: Attribute[Any], new_value: Any +) -> NoReturn: ... +def pipe(*setters: _OnSetAttrType) -> _OnSetAttrType: ... +def validate(instance: Any, attribute: Attribute[_T], new_value: _T) -> _T: ... + +# convert is allowed to return Any, because they can be chained using pipe. +def convert( + instance: Any, attribute: Attribute[Any], new_value: Any +) -> Any: ... + +_NoOpType = NewType("_NoOpType", object) +NO_OP: _NoOpType diff --git a/openpype/hosts/fusion/vendor/attr/validators.py b/openpype/hosts/fusion/vendor/attr/validators.py new file mode 100644 index 0000000000..b9a73054e9 --- /dev/null +++ b/openpype/hosts/fusion/vendor/attr/validators.py @@ -0,0 +1,379 @@ +""" +Commonly useful validators. +""" + +from __future__ import absolute_import, division, print_function + +import re + +from ._make import _AndValidator, and_, attrib, attrs +from .exceptions import NotCallableError + + +__all__ = [ + "and_", + "deep_iterable", + "deep_mapping", + "in_", + "instance_of", + "is_callable", + "matches_re", + "optional", + "provides", +] + + +@attrs(repr=False, slots=True, hash=True) +class _InstanceOfValidator(object): + type = attrib() + + def __call__(self, inst, attr, value): + """ + We use a callable class to be able to change the ``__repr__``. + """ + if not isinstance(value, self.type): + raise TypeError( + "'{name}' must be {type!r} (got {value!r} that is a " + "{actual!r}).".format( + name=attr.name, + type=self.type, + actual=value.__class__, + value=value, + ), + attr, + self.type, + value, + ) + + def __repr__(self): + return "".format( + type=self.type + ) + + +def instance_of(type): + """ + A validator that raises a `TypeError` if the initializer is called + with a wrong type for this particular attribute (checks are performed using + `isinstance` therefore it's also valid to pass a tuple of types). + + :param type: The type to check for. + :type type: type or tuple of types + + :raises TypeError: With a human readable error message, the attribute + (of type `attr.Attribute`), the expected type, and the value it + got. + """ + return _InstanceOfValidator(type) + + +@attrs(repr=False, frozen=True, slots=True) +class _MatchesReValidator(object): + regex = attrib() + flags = attrib() + match_func = attrib() + + def __call__(self, inst, attr, value): + """ + We use a callable class to be able to change the ``__repr__``. + """ + if not self.match_func(value): + raise ValueError( + "'{name}' must match regex {regex!r}" + " ({value!r} doesn't)".format( + name=attr.name, regex=self.regex.pattern, value=value + ), + attr, + self.regex, + value, + ) + + def __repr__(self): + return "".format( + regex=self.regex + ) + + +def matches_re(regex, flags=0, func=None): + r""" + A validator that raises `ValueError` if the initializer is called + with a string that doesn't match *regex*. + + :param str regex: a regex string to match against + :param int flags: flags that will be passed to the underlying re function + (default 0) + :param callable func: which underlying `re` function to call (options + are `re.fullmatch`, `re.search`, `re.match`, default + is ``None`` which means either `re.fullmatch` or an emulation of + it on Python 2). For performance reasons, they won't be used directly + but on a pre-`re.compile`\ ed pattern. + + .. versionadded:: 19.2.0 + """ + fullmatch = getattr(re, "fullmatch", None) + valid_funcs = (fullmatch, None, re.search, re.match) + if func not in valid_funcs: + raise ValueError( + "'func' must be one of %s." + % ( + ", ".join( + sorted( + e and e.__name__ or "None" for e in set(valid_funcs) + ) + ), + ) + ) + + pattern = re.compile(regex, flags) + if func is re.match: + match_func = pattern.match + elif func is re.search: + match_func = pattern.search + else: + if fullmatch: + match_func = pattern.fullmatch + else: + pattern = re.compile(r"(?:{})\Z".format(regex), flags) + match_func = pattern.match + + return _MatchesReValidator(pattern, flags, match_func) + + +@attrs(repr=False, slots=True, hash=True) +class _ProvidesValidator(object): + interface = attrib() + + def __call__(self, inst, attr, value): + """ + We use a callable class to be able to change the ``__repr__``. + """ + if not self.interface.providedBy(value): + raise TypeError( + "'{name}' must provide {interface!r} which {value!r} " + "doesn't.".format( + name=attr.name, interface=self.interface, value=value + ), + attr, + self.interface, + value, + ) + + def __repr__(self): + return "".format( + interface=self.interface + ) + + +def provides(interface): + """ + A validator that raises a `TypeError` if the initializer is called + with an object that does not provide the requested *interface* (checks are + performed using ``interface.providedBy(value)`` (see `zope.interface + `_). + + :param interface: The interface to check for. + :type interface: ``zope.interface.Interface`` + + :raises TypeError: With a human readable error message, the attribute + (of type `attr.Attribute`), the expected interface, and the + value it got. + """ + return _ProvidesValidator(interface) + + +@attrs(repr=False, slots=True, hash=True) +class _OptionalValidator(object): + validator = attrib() + + def __call__(self, inst, attr, value): + if value is None: + return + + self.validator(inst, attr, value) + + def __repr__(self): + return "".format( + what=repr(self.validator) + ) + + +def optional(validator): + """ + A validator that makes an attribute optional. An optional attribute is one + which can be set to ``None`` in addition to satisfying the requirements of + the sub-validator. + + :param validator: A validator (or a list of validators) that is used for + non-``None`` values. + :type validator: callable or `list` of callables. + + .. versionadded:: 15.1.0 + .. versionchanged:: 17.1.0 *validator* can be a list of validators. + """ + if isinstance(validator, list): + return _OptionalValidator(_AndValidator(validator)) + return _OptionalValidator(validator) + + +@attrs(repr=False, slots=True, hash=True) +class _InValidator(object): + options = attrib() + + def __call__(self, inst, attr, value): + try: + in_options = value in self.options + except TypeError: # e.g. `1 in "abc"` + in_options = False + + if not in_options: + raise ValueError( + "'{name}' must be in {options!r} (got {value!r})".format( + name=attr.name, options=self.options, value=value + ) + ) + + def __repr__(self): + return "".format( + options=self.options + ) + + +def in_(options): + """ + A validator that raises a `ValueError` if the initializer is called + with a value that does not belong in the options provided. The check is + performed using ``value in options``. + + :param options: Allowed options. + :type options: list, tuple, `enum.Enum`, ... + + :raises ValueError: With a human readable error message, the attribute (of + type `attr.Attribute`), the expected options, and the value it + got. + + .. versionadded:: 17.1.0 + """ + return _InValidator(options) + + +@attrs(repr=False, slots=False, hash=True) +class _IsCallableValidator(object): + def __call__(self, inst, attr, value): + """ + We use a callable class to be able to change the ``__repr__``. + """ + if not callable(value): + message = ( + "'{name}' must be callable " + "(got {value!r} that is a {actual!r})." + ) + raise NotCallableError( + msg=message.format( + name=attr.name, value=value, actual=value.__class__ + ), + value=value, + ) + + def __repr__(self): + return "" + + +def is_callable(): + """ + A validator that raises a `attr.exceptions.NotCallableError` if the + initializer is called with a value for this particular attribute + that is not callable. + + .. versionadded:: 19.1.0 + + :raises `attr.exceptions.NotCallableError`: With a human readable error + message containing the attribute (`attr.Attribute`) name, + and the value it got. + """ + return _IsCallableValidator() + + +@attrs(repr=False, slots=True, hash=True) +class _DeepIterable(object): + member_validator = attrib(validator=is_callable()) + iterable_validator = attrib( + default=None, validator=optional(is_callable()) + ) + + def __call__(self, inst, attr, value): + """ + We use a callable class to be able to change the ``__repr__``. + """ + if self.iterable_validator is not None: + self.iterable_validator(inst, attr, value) + + for member in value: + self.member_validator(inst, attr, member) + + def __repr__(self): + iterable_identifier = ( + "" + if self.iterable_validator is None + else " {iterable!r}".format(iterable=self.iterable_validator) + ) + return ( + "" + ).format( + iterable_identifier=iterable_identifier, + member=self.member_validator, + ) + + +def deep_iterable(member_validator, iterable_validator=None): + """ + A validator that performs deep validation of an iterable. + + :param member_validator: Validator to apply to iterable members + :param iterable_validator: Validator to apply to iterable itself + (optional) + + .. versionadded:: 19.1.0 + + :raises TypeError: if any sub-validators fail + """ + return _DeepIterable(member_validator, iterable_validator) + + +@attrs(repr=False, slots=True, hash=True) +class _DeepMapping(object): + key_validator = attrib(validator=is_callable()) + value_validator = attrib(validator=is_callable()) + mapping_validator = attrib(default=None, validator=optional(is_callable())) + + def __call__(self, inst, attr, value): + """ + We use a callable class to be able to change the ``__repr__``. + """ + if self.mapping_validator is not None: + self.mapping_validator(inst, attr, value) + + for key in value: + self.key_validator(inst, attr, key) + self.value_validator(inst, attr, value[key]) + + def __repr__(self): + return ( + "" + ).format(key=self.key_validator, value=self.value_validator) + + +def deep_mapping(key_validator, value_validator, mapping_validator=None): + """ + A validator that performs deep validation of a dictionary. + + :param key_validator: Validator to apply to dictionary keys + :param value_validator: Validator to apply to dictionary values + :param mapping_validator: Validator to apply to top-level mapping + attribute (optional) + + .. versionadded:: 19.1.0 + + :raises TypeError: if any sub-validators fail + """ + return _DeepMapping(key_validator, value_validator, mapping_validator) diff --git a/openpype/hosts/fusion/vendor/attr/validators.pyi b/openpype/hosts/fusion/vendor/attr/validators.pyi new file mode 100644 index 0000000000..fe92aac421 --- /dev/null +++ b/openpype/hosts/fusion/vendor/attr/validators.pyi @@ -0,0 +1,68 @@ +from typing import ( + Any, + AnyStr, + Callable, + Container, + Iterable, + List, + Mapping, + Match, + Optional, + Tuple, + Type, + TypeVar, + Union, + overload, +) + +from . import _ValidatorType + + +_T = TypeVar("_T") +_T1 = TypeVar("_T1") +_T2 = TypeVar("_T2") +_T3 = TypeVar("_T3") +_I = TypeVar("_I", bound=Iterable) +_K = TypeVar("_K") +_V = TypeVar("_V") +_M = TypeVar("_M", bound=Mapping) + +# To be more precise on instance_of use some overloads. +# If there are more than 3 items in the tuple then we fall back to Any +@overload +def instance_of(type: Type[_T]) -> _ValidatorType[_T]: ... +@overload +def instance_of(type: Tuple[Type[_T]]) -> _ValidatorType[_T]: ... +@overload +def instance_of( + type: Tuple[Type[_T1], Type[_T2]] +) -> _ValidatorType[Union[_T1, _T2]]: ... +@overload +def instance_of( + type: Tuple[Type[_T1], Type[_T2], Type[_T3]] +) -> _ValidatorType[Union[_T1, _T2, _T3]]: ... +@overload +def instance_of(type: Tuple[type, ...]) -> _ValidatorType[Any]: ... +def provides(interface: Any) -> _ValidatorType[Any]: ... +def optional( + validator: Union[_ValidatorType[_T], List[_ValidatorType[_T]]] +) -> _ValidatorType[Optional[_T]]: ... +def in_(options: Container[_T]) -> _ValidatorType[_T]: ... +def and_(*validators: _ValidatorType[_T]) -> _ValidatorType[_T]: ... +def matches_re( + regex: AnyStr, + flags: int = ..., + func: Optional[ + Callable[[AnyStr, AnyStr, int], Optional[Match[AnyStr]]] + ] = ..., +) -> _ValidatorType[AnyStr]: ... +def deep_iterable( + member_validator: _ValidatorType[_T], + iterable_validator: Optional[_ValidatorType[_I]] = ..., +) -> _ValidatorType[_I]: ... +def deep_mapping( + key_validator: _ValidatorType[_K], + value_validator: _ValidatorType[_V], + mapping_validator: Optional[_ValidatorType[_M]] = ..., +) -> _ValidatorType[_M]: ... +def is_callable() -> _ValidatorType[_T]: ... diff --git a/openpype/hosts/fusion/vendor/urllib3/__init__.py b/openpype/hosts/fusion/vendor/urllib3/__init__.py new file mode 100644 index 0000000000..fe86b59d78 --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/__init__.py @@ -0,0 +1,85 @@ +""" +Python HTTP library with thread-safe connection pooling, file post support, user friendly, and more +""" +from __future__ import absolute_import + +# Set default logging handler to avoid "No handler found" warnings. +import logging +import warnings +from logging import NullHandler + +from . import exceptions +from ._version import __version__ +from .connectionpool import HTTPConnectionPool, HTTPSConnectionPool, connection_from_url +from .filepost import encode_multipart_formdata +from .poolmanager import PoolManager, ProxyManager, proxy_from_url +from .response import HTTPResponse +from .util.request import make_headers +from .util.retry import Retry +from .util.timeout import Timeout +from .util.url import get_host + +__author__ = "Andrey Petrov (andrey.petrov@shazow.net)" +__license__ = "MIT" +__version__ = __version__ + +__all__ = ( + "HTTPConnectionPool", + "HTTPSConnectionPool", + "PoolManager", + "ProxyManager", + "HTTPResponse", + "Retry", + "Timeout", + "add_stderr_logger", + "connection_from_url", + "disable_warnings", + "encode_multipart_formdata", + "get_host", + "make_headers", + "proxy_from_url", +) + +logging.getLogger(__name__).addHandler(NullHandler()) + + +def add_stderr_logger(level=logging.DEBUG): + """ + Helper for quickly adding a StreamHandler to the logger. Useful for + debugging. + + Returns the handler after adding it. + """ + # This method needs to be in this __init__.py to get the __name__ correct + # even if urllib3 is vendored within another package. + logger = logging.getLogger(__name__) + handler = logging.StreamHandler() + handler.setFormatter(logging.Formatter("%(asctime)s %(levelname)s %(message)s")) + logger.addHandler(handler) + logger.setLevel(level) + logger.debug("Added a stderr logging handler to logger: %s", __name__) + return handler + + +# ... Clean up. +del NullHandler + + +# All warning filters *must* be appended unless you're really certain that they +# shouldn't be: otherwise, it's very hard for users to use most Python +# mechanisms to silence them. +# SecurityWarning's always go off by default. +warnings.simplefilter("always", exceptions.SecurityWarning, append=True) +# SubjectAltNameWarning's should go off once per host +warnings.simplefilter("default", exceptions.SubjectAltNameWarning, append=True) +# InsecurePlatformWarning's don't vary between requests, so we keep it default. +warnings.simplefilter("default", exceptions.InsecurePlatformWarning, append=True) +# SNIMissingWarnings should go off only once. +warnings.simplefilter("default", exceptions.SNIMissingWarning, append=True) + + +def disable_warnings(category=exceptions.HTTPWarning): + """ + Helper for quickly disabling all urllib3 warnings. + """ + warnings.simplefilter("ignore", category) diff --git a/openpype/hosts/fusion/vendor/urllib3/_collections.py b/openpype/hosts/fusion/vendor/urllib3/_collections.py new file mode 100644 index 0000000000..da9857e986 --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/_collections.py @@ -0,0 +1,337 @@ +from __future__ import absolute_import + +try: + from collections.abc import Mapping, MutableMapping +except ImportError: + from collections import Mapping, MutableMapping +try: + from threading import RLock +except ImportError: # Platform-specific: No threads available + + class RLock: + def __enter__(self): + pass + + def __exit__(self, exc_type, exc_value, traceback): + pass + + +from collections import OrderedDict + +from .exceptions import InvalidHeader +from .packages import six +from .packages.six import iterkeys, itervalues + +__all__ = ["RecentlyUsedContainer", "HTTPHeaderDict"] + + +_Null = object() + + +class RecentlyUsedContainer(MutableMapping): + """ + Provides a thread-safe dict-like container which maintains up to + ``maxsize`` keys while throwing away the least-recently-used keys beyond + ``maxsize``. + + :param maxsize: + Maximum number of recent elements to retain. + + :param dispose_func: + Every time an item is evicted from the container, + ``dispose_func(value)`` is called. Callback which will get called + """ + + ContainerCls = OrderedDict + + def __init__(self, maxsize=10, dispose_func=None): + self._maxsize = maxsize + self.dispose_func = dispose_func + + self._container = self.ContainerCls() + self.lock = RLock() + + def __getitem__(self, key): + # Re-insert the item, moving it to the end of the eviction line. + with self.lock: + item = self._container.pop(key) + self._container[key] = item + return item + + def __setitem__(self, key, value): + evicted_value = _Null + with self.lock: + # Possibly evict the existing value of 'key' + evicted_value = self._container.get(key, _Null) + self._container[key] = value + + # If we didn't evict an existing value, we might have to evict the + # least recently used item from the beginning of the container. + if len(self._container) > self._maxsize: + _key, evicted_value = self._container.popitem(last=False) + + if self.dispose_func and evicted_value is not _Null: + self.dispose_func(evicted_value) + + def __delitem__(self, key): + with self.lock: + value = self._container.pop(key) + + if self.dispose_func: + self.dispose_func(value) + + def __len__(self): + with self.lock: + return len(self._container) + + def __iter__(self): + raise NotImplementedError( + "Iteration over this class is unlikely to be threadsafe." + ) + + def clear(self): + with self.lock: + # Copy pointers to all values, then wipe the mapping + values = list(itervalues(self._container)) + self._container.clear() + + if self.dispose_func: + for value in values: + self.dispose_func(value) + + def keys(self): + with self.lock: + return list(iterkeys(self._container)) + + +class HTTPHeaderDict(MutableMapping): + """ + :param headers: + An iterable of field-value pairs. Must not contain multiple field names + when compared case-insensitively. + + :param kwargs: + Additional field-value pairs to pass in to ``dict.update``. + + A ``dict`` like container for storing HTTP Headers. + + Field names are stored and compared case-insensitively in compliance with + RFC 7230. Iteration provides the first case-sensitive key seen for each + case-insensitive pair. + + Using ``__setitem__`` syntax overwrites fields that compare equal + case-insensitively in order to maintain ``dict``'s api. For fields that + compare equal, instead create a new ``HTTPHeaderDict`` and use ``.add`` + in a loop. + + If multiple fields that are equal case-insensitively are passed to the + constructor or ``.update``, the behavior is undefined and some will be + lost. + + >>> headers = HTTPHeaderDict() + >>> headers.add('Set-Cookie', 'foo=bar') + >>> headers.add('set-cookie', 'baz=quxx') + >>> headers['content-length'] = '7' + >>> headers['SET-cookie'] + 'foo=bar, baz=quxx' + >>> headers['Content-Length'] + '7' + """ + + def __init__(self, headers=None, **kwargs): + super(HTTPHeaderDict, self).__init__() + self._container = OrderedDict() + if headers is not None: + if isinstance(headers, HTTPHeaderDict): + self._copy_from(headers) + else: + self.extend(headers) + if kwargs: + self.extend(kwargs) + + def __setitem__(self, key, val): + self._container[key.lower()] = [key, val] + return self._container[key.lower()] + + def __getitem__(self, key): + val = self._container[key.lower()] + return ", ".join(val[1:]) + + def __delitem__(self, key): + del self._container[key.lower()] + + def __contains__(self, key): + return key.lower() in self._container + + def __eq__(self, other): + if not isinstance(other, Mapping) and not hasattr(other, "keys"): + return False + if not isinstance(other, type(self)): + other = type(self)(other) + return dict((k.lower(), v) for k, v in self.itermerged()) == dict( + (k.lower(), v) for k, v in other.itermerged() + ) + + def __ne__(self, other): + return not self.__eq__(other) + + if six.PY2: # Python 2 + iterkeys = MutableMapping.iterkeys + itervalues = MutableMapping.itervalues + + __marker = object() + + def __len__(self): + return len(self._container) + + def __iter__(self): + # Only provide the originally cased names + for vals in self._container.values(): + yield vals[0] + + def pop(self, key, default=__marker): + """D.pop(k[,d]) -> v, remove specified key and return the corresponding value. + If key is not found, d is returned if given, otherwise KeyError is raised. + """ + # Using the MutableMapping function directly fails due to the private marker. + # Using ordinary dict.pop would expose the internal structures. + # So let's reinvent the wheel. + try: + value = self[key] + except KeyError: + if default is self.__marker: + raise + return default + else: + del self[key] + return value + + def discard(self, key): + try: + del self[key] + except KeyError: + pass + + def add(self, key, val): + """Adds a (name, value) pair, doesn't overwrite the value if it already + exists. + + >>> headers = HTTPHeaderDict(foo='bar') + >>> headers.add('Foo', 'baz') + >>> headers['foo'] + 'bar, baz' + """ + key_lower = key.lower() + new_vals = [key, val] + # Keep the common case aka no item present as fast as possible + vals = self._container.setdefault(key_lower, new_vals) + if new_vals is not vals: + vals.append(val) + + def extend(self, *args, **kwargs): + """Generic import function for any type of header-like object. + Adapted version of MutableMapping.update in order to insert items + with self.add instead of self.__setitem__ + """ + if len(args) > 1: + raise TypeError( + "extend() takes at most 1 positional " + "arguments ({0} given)".format(len(args)) + ) + other = args[0] if len(args) >= 1 else () + + if isinstance(other, HTTPHeaderDict): + for key, val in other.iteritems(): + self.add(key, val) + elif isinstance(other, Mapping): + for key in other: + self.add(key, other[key]) + elif hasattr(other, "keys"): + for key in other.keys(): + self.add(key, other[key]) + else: + for key, value in other: + self.add(key, value) + + for key, value in kwargs.items(): + self.add(key, value) + + def getlist(self, key, default=__marker): + """Returns a list of all the values for the named field. Returns an + empty list if the key doesn't exist.""" + try: + vals = self._container[key.lower()] + except KeyError: + if default is self.__marker: + return [] + return default + else: + return vals[1:] + + # Backwards compatibility for httplib + getheaders = getlist + getallmatchingheaders = getlist + iget = getlist + + # Backwards compatibility for http.cookiejar + get_all = getlist + + def __repr__(self): + return "%s(%s)" % (type(self).__name__, dict(self.itermerged())) + + def _copy_from(self, other): + for key in other: + val = other.getlist(key) + if isinstance(val, list): + # Don't need to convert tuples + val = list(val) + self._container[key.lower()] = [key] + val + + def copy(self): + clone = type(self)() + clone._copy_from(self) + return clone + + def iteritems(self): + """Iterate over all header lines, including duplicate ones.""" + for key in self: + vals = self._container[key.lower()] + for val in vals[1:]: + yield vals[0], val + + def itermerged(self): + """Iterate over all headers, merging duplicate ones together.""" + for key in self: + val = self._container[key.lower()] + yield val[0], ", ".join(val[1:]) + + def items(self): + return list(self.iteritems()) + + @classmethod + def from_httplib(cls, message): # Python 2 + """Read headers from a Python 2 httplib message object.""" + # python2.7 does not expose a proper API for exporting multiheaders + # efficiently. This function re-reads raw lines from the message + # object and extracts the multiheaders properly. + obs_fold_continued_leaders = (" ", "\t") + headers = [] + + for line in message.headers: + if line.startswith(obs_fold_continued_leaders): + if not headers: + # We received a header line that starts with OWS as described + # in RFC-7230 S3.2.4. This indicates a multiline header, but + # there exists no previous header to which we can attach it. + raise InvalidHeader( + "Header continuation with no previous header: %s" % line + ) + else: + key, value = headers[-1] + headers[-1] = (key, value + " " + line.strip()) + continue + + key, value = line.split(":", 1) + headers.append((key, value.strip())) + + return cls(headers) diff --git a/openpype/hosts/fusion/vendor/urllib3/_version.py b/openpype/hosts/fusion/vendor/urllib3/_version.py new file mode 100644 index 0000000000..e8ebee957f --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/_version.py @@ -0,0 +1,2 @@ +# This file is protected via CODEOWNERS +__version__ = "1.26.6" diff --git a/openpype/hosts/fusion/vendor/urllib3/connection.py b/openpype/hosts/fusion/vendor/urllib3/connection.py new file mode 100644 index 0000000000..4c996659c8 --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/connection.py @@ -0,0 +1,539 @@ +from __future__ import absolute_import + +import datetime +import logging +import os +import re +import socket +import warnings +from socket import error as SocketError +from socket import timeout as SocketTimeout + +from .packages import six +from .packages.six.moves.http_client import HTTPConnection as _HTTPConnection +from .packages.six.moves.http_client import HTTPException # noqa: F401 +from .util.proxy import create_proxy_ssl_context + +try: # Compiled with SSL? + import ssl + + BaseSSLError = ssl.SSLError +except (ImportError, AttributeError): # Platform-specific: No SSL. + ssl = None + + class BaseSSLError(BaseException): + pass + + +try: + # Python 3: not a no-op, we're adding this to the namespace so it can be imported. + ConnectionError = ConnectionError +except NameError: + # Python 2 + class ConnectionError(Exception): + pass + + +try: # Python 3: + # Not a no-op, we're adding this to the namespace so it can be imported. + BrokenPipeError = BrokenPipeError +except NameError: # Python 2: + + class BrokenPipeError(Exception): + pass + + +from ._collections import HTTPHeaderDict # noqa (historical, removed in v2) +from ._version import __version__ +from .exceptions import ( + ConnectTimeoutError, + NewConnectionError, + SubjectAltNameWarning, + SystemTimeWarning, +) +from .packages.ssl_match_hostname import CertificateError, match_hostname +from .util import SKIP_HEADER, SKIPPABLE_HEADERS, connection +from .util.ssl_ import ( + assert_fingerprint, + create_urllib3_context, + resolve_cert_reqs, + resolve_ssl_version, + ssl_wrap_socket, +) + +log = logging.getLogger(__name__) + +port_by_scheme = {"http": 80, "https": 443} + +# When it comes time to update this value as a part of regular maintenance +# (ie test_recent_date is failing) update it to ~6 months before the current date. +RECENT_DATE = datetime.date(2020, 7, 1) + +_CONTAINS_CONTROL_CHAR_RE = re.compile(r"[^-!#$%&'*+.^_`|~0-9a-zA-Z]") + + +class HTTPConnection(_HTTPConnection, object): + """ + Based on :class:`http.client.HTTPConnection` but provides an extra constructor + backwards-compatibility layer between older and newer Pythons. + + Additional keyword parameters are used to configure attributes of the connection. + Accepted parameters include: + + - ``strict``: See the documentation on :class:`urllib3.connectionpool.HTTPConnectionPool` + - ``source_address``: Set the source address for the current connection. + - ``socket_options``: Set specific options on the underlying socket. If not specified, then + defaults are loaded from ``HTTPConnection.default_socket_options`` which includes disabling + Nagle's algorithm (sets TCP_NODELAY to 1) unless the connection is behind a proxy. + + For example, if you wish to enable TCP Keep Alive in addition to the defaults, + you might pass: + + .. code-block:: python + + HTTPConnection.default_socket_options + [ + (socket.SOL_SOCKET, socket.SO_KEEPALIVE, 1), + ] + + Or you may want to disable the defaults by passing an empty list (e.g., ``[]``). + """ + + default_port = port_by_scheme["http"] + + #: Disable Nagle's algorithm by default. + #: ``[(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)]`` + default_socket_options = [(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)] + + #: Whether this connection verifies the host's certificate. + is_verified = False + + def __init__(self, *args, **kw): + if not six.PY2: + kw.pop("strict", None) + + # Pre-set source_address. + self.source_address = kw.get("source_address") + + #: The socket options provided by the user. If no options are + #: provided, we use the default options. + self.socket_options = kw.pop("socket_options", self.default_socket_options) + + # Proxy options provided by the user. + self.proxy = kw.pop("proxy", None) + self.proxy_config = kw.pop("proxy_config", None) + + _HTTPConnection.__init__(self, *args, **kw) + + @property + def host(self): + """ + Getter method to remove any trailing dots that indicate the hostname is an FQDN. + + In general, SSL certificates don't include the trailing dot indicating a + fully-qualified domain name, and thus, they don't validate properly when + checked against a domain name that includes the dot. In addition, some + servers may not expect to receive the trailing dot when provided. + + However, the hostname with trailing dot is critical to DNS resolution; doing a + lookup with the trailing dot will properly only resolve the appropriate FQDN, + whereas a lookup without a trailing dot will search the system's search domain + list. Thus, it's important to keep the original host around for use only in + those cases where it's appropriate (i.e., when doing DNS lookup to establish the + actual TCP connection across which we're going to send HTTP requests). + """ + return self._dns_host.rstrip(".") + + @host.setter + def host(self, value): + """ + Setter for the `host` property. + + We assume that only urllib3 uses the _dns_host attribute; httplib itself + only uses `host`, and it seems reasonable that other libraries follow suit. + """ + self._dns_host = value + + def _new_conn(self): + """Establish a socket connection and set nodelay settings on it. + + :return: New socket connection. + """ + extra_kw = {} + if self.source_address: + extra_kw["source_address"] = self.source_address + + if self.socket_options: + extra_kw["socket_options"] = self.socket_options + + try: + conn = connection.create_connection( + (self._dns_host, self.port), self.timeout, **extra_kw + ) + + except SocketTimeout: + raise ConnectTimeoutError( + self, + "Connection to %s timed out. (connect timeout=%s)" + % (self.host, self.timeout), + ) + + except SocketError as e: + raise NewConnectionError( + self, "Failed to establish a new connection: %s" % e + ) + + return conn + + def _is_using_tunnel(self): + # Google App Engine's httplib does not define _tunnel_host + return getattr(self, "_tunnel_host", None) + + def _prepare_conn(self, conn): + self.sock = conn + if self._is_using_tunnel(): + # TODO: Fix tunnel so it doesn't depend on self.sock state. + self._tunnel() + # Mark this connection as not reusable + self.auto_open = 0 + + def connect(self): + conn = self._new_conn() + self._prepare_conn(conn) + + def putrequest(self, method, url, *args, **kwargs): + """ """ + # Empty docstring because the indentation of CPython's implementation + # is broken but we don't want this method in our documentation. + match = _CONTAINS_CONTROL_CHAR_RE.search(method) + if match: + raise ValueError( + "Method cannot contain non-token characters %r (found at least %r)" + % (method, match.group()) + ) + + return _HTTPConnection.putrequest(self, method, url, *args, **kwargs) + + def putheader(self, header, *values): + """ """ + if not any(isinstance(v, str) and v == SKIP_HEADER for v in values): + _HTTPConnection.putheader(self, header, *values) + elif six.ensure_str(header.lower()) not in SKIPPABLE_HEADERS: + raise ValueError( + "urllib3.util.SKIP_HEADER only supports '%s'" + % ("', '".join(map(str.title, sorted(SKIPPABLE_HEADERS))),) + ) + + def request(self, method, url, body=None, headers=None): + if headers is None: + headers = {} + else: + # Avoid modifying the headers passed into .request() + headers = headers.copy() + if "user-agent" not in (six.ensure_str(k.lower()) for k in headers): + headers["User-Agent"] = _get_default_user_agent() + super(HTTPConnection, self).request(method, url, body=body, headers=headers) + + def request_chunked(self, method, url, body=None, headers=None): + """ + Alternative to the common request method, which sends the + body with chunked encoding and not as one block + """ + headers = headers or {} + header_keys = set([six.ensure_str(k.lower()) for k in headers]) + skip_accept_encoding = "accept-encoding" in header_keys + skip_host = "host" in header_keys + self.putrequest( + method, url, skip_accept_encoding=skip_accept_encoding, skip_host=skip_host + ) + if "user-agent" not in header_keys: + self.putheader("User-Agent", _get_default_user_agent()) + for header, value in headers.items(): + self.putheader(header, value) + if "transfer-encoding" not in header_keys: + self.putheader("Transfer-Encoding", "chunked") + self.endheaders() + + if body is not None: + stringish_types = six.string_types + (bytes,) + if isinstance(body, stringish_types): + body = (body,) + for chunk in body: + if not chunk: + continue + if not isinstance(chunk, bytes): + chunk = chunk.encode("utf8") + len_str = hex(len(chunk))[2:] + to_send = bytearray(len_str.encode()) + to_send += b"\r\n" + to_send += chunk + to_send += b"\r\n" + self.send(to_send) + + # After the if clause, to always have a closed body + self.send(b"0\r\n\r\n") + + +class HTTPSConnection(HTTPConnection): + """ + Many of the parameters to this constructor are passed to the underlying SSL + socket by means of :py:func:`urllib3.util.ssl_wrap_socket`. + """ + + default_port = port_by_scheme["https"] + + cert_reqs = None + ca_certs = None + ca_cert_dir = None + ca_cert_data = None + ssl_version = None + assert_fingerprint = None + tls_in_tls_required = False + + def __init__( + self, + host, + port=None, + key_file=None, + cert_file=None, + key_password=None, + strict=None, + timeout=socket._GLOBAL_DEFAULT_TIMEOUT, + ssl_context=None, + server_hostname=None, + **kw + ): + + HTTPConnection.__init__(self, host, port, strict=strict, timeout=timeout, **kw) + + self.key_file = key_file + self.cert_file = cert_file + self.key_password = key_password + self.ssl_context = ssl_context + self.server_hostname = server_hostname + + # Required property for Google AppEngine 1.9.0 which otherwise causes + # HTTPS requests to go out as HTTP. (See Issue #356) + self._protocol = "https" + + def set_cert( + self, + key_file=None, + cert_file=None, + cert_reqs=None, + key_password=None, + ca_certs=None, + assert_hostname=None, + assert_fingerprint=None, + ca_cert_dir=None, + ca_cert_data=None, + ): + """ + This method should only be called once, before the connection is used. + """ + # If cert_reqs is not provided we'll assume CERT_REQUIRED unless we also + # have an SSLContext object in which case we'll use its verify_mode. + if cert_reqs is None: + if self.ssl_context is not None: + cert_reqs = self.ssl_context.verify_mode + else: + cert_reqs = resolve_cert_reqs(None) + + self.key_file = key_file + self.cert_file = cert_file + self.cert_reqs = cert_reqs + self.key_password = key_password + self.assert_hostname = assert_hostname + self.assert_fingerprint = assert_fingerprint + self.ca_certs = ca_certs and os.path.expanduser(ca_certs) + self.ca_cert_dir = ca_cert_dir and os.path.expanduser(ca_cert_dir) + self.ca_cert_data = ca_cert_data + + def connect(self): + # Add certificate verification + conn = self._new_conn() + hostname = self.host + tls_in_tls = False + + if self._is_using_tunnel(): + if self.tls_in_tls_required: + conn = self._connect_tls_proxy(hostname, conn) + tls_in_tls = True + + self.sock = conn + + # Calls self._set_hostport(), so self.host is + # self._tunnel_host below. + self._tunnel() + # Mark this connection as not reusable + self.auto_open = 0 + + # Override the host with the one we're requesting data from. + hostname = self._tunnel_host + + server_hostname = hostname + if self.server_hostname is not None: + server_hostname = self.server_hostname + + is_time_off = datetime.date.today() < RECENT_DATE + if is_time_off: + warnings.warn( + ( + "System time is way off (before {0}). This will probably " + "lead to SSL verification errors" + ).format(RECENT_DATE), + SystemTimeWarning, + ) + + # Wrap socket using verification with the root certs in + # trusted_root_certs + default_ssl_context = False + if self.ssl_context is None: + default_ssl_context = True + self.ssl_context = create_urllib3_context( + ssl_version=resolve_ssl_version(self.ssl_version), + cert_reqs=resolve_cert_reqs(self.cert_reqs), + ) + + context = self.ssl_context + context.verify_mode = resolve_cert_reqs(self.cert_reqs) + + # Try to load OS default certs if none are given. + # Works well on Windows (requires Python3.4+) + if ( + not self.ca_certs + and not self.ca_cert_dir + and not self.ca_cert_data + and default_ssl_context + and hasattr(context, "load_default_certs") + ): + context.load_default_certs() + + self.sock = ssl_wrap_socket( + sock=conn, + keyfile=self.key_file, + certfile=self.cert_file, + key_password=self.key_password, + ca_certs=self.ca_certs, + ca_cert_dir=self.ca_cert_dir, + ca_cert_data=self.ca_cert_data, + server_hostname=server_hostname, + ssl_context=context, + tls_in_tls=tls_in_tls, + ) + + # If we're using all defaults and the connection + # is TLSv1 or TLSv1.1 we throw a DeprecationWarning + # for the host. + if ( + default_ssl_context + and self.ssl_version is None + and hasattr(self.sock, "version") + and self.sock.version() in {"TLSv1", "TLSv1.1"} + ): + warnings.warn( + "Negotiating TLSv1/TLSv1.1 by default is deprecated " + "and will be disabled in urllib3 v2.0.0. Connecting to " + "'%s' with '%s' can be enabled by explicitly opting-in " + "with 'ssl_version'" % (self.host, self.sock.version()), + DeprecationWarning, + ) + + if self.assert_fingerprint: + assert_fingerprint( + self.sock.getpeercert(binary_form=True), self.assert_fingerprint + ) + elif ( + context.verify_mode != ssl.CERT_NONE + and not getattr(context, "check_hostname", False) + and self.assert_hostname is not False + ): + # While urllib3 attempts to always turn off hostname matching from + # the TLS library, this cannot always be done. So we check whether + # the TLS Library still thinks it's matching hostnames. + cert = self.sock.getpeercert() + if not cert.get("subjectAltName", ()): + warnings.warn( + ( + "Certificate for {0} has no `subjectAltName`, falling back to check for a " + "`commonName` for now. This feature is being removed by major browsers and " + "deprecated by RFC 2818. (See https://github.com/urllib3/urllib3/issues/497 " + "for details.)".format(hostname) + ), + SubjectAltNameWarning, + ) + _match_hostname(cert, self.assert_hostname or server_hostname) + + self.is_verified = ( + context.verify_mode == ssl.CERT_REQUIRED + or self.assert_fingerprint is not None + ) + + def _connect_tls_proxy(self, hostname, conn): + """ + Establish a TLS connection to the proxy using the provided SSL context. + """ + proxy_config = self.proxy_config + ssl_context = proxy_config.ssl_context + if ssl_context: + # If the user provided a proxy context, we assume CA and client + # certificates have already been set + return ssl_wrap_socket( + sock=conn, + server_hostname=hostname, + ssl_context=ssl_context, + ) + + ssl_context = create_proxy_ssl_context( + self.ssl_version, + self.cert_reqs, + self.ca_certs, + self.ca_cert_dir, + self.ca_cert_data, + ) + # By default urllib3's SSLContext disables `check_hostname` and uses + # a custom check. For proxies we're good with relying on the default + # verification. + ssl_context.check_hostname = True + + # If no cert was provided, use only the default options for server + # certificate validation + return ssl_wrap_socket( + sock=conn, + ca_certs=self.ca_certs, + ca_cert_dir=self.ca_cert_dir, + ca_cert_data=self.ca_cert_data, + server_hostname=hostname, + ssl_context=ssl_context, + ) + + +def _match_hostname(cert, asserted_hostname): + try: + match_hostname(cert, asserted_hostname) + except CertificateError as e: + log.warning( + "Certificate did not match expected hostname: %s. Certificate: %s", + asserted_hostname, + cert, + ) + # Add cert to exception and reraise so client code can inspect + # the cert when catching the exception, if they want to + e._peer_cert = cert + raise + + +def _get_default_user_agent(): + return "python-urllib3/%s" % __version__ + + +class DummyConnection(object): + """Used to detect a failed ConnectionCls import.""" + + pass + + +if not ssl: + HTTPSConnection = DummyConnection # noqa: F811 + + +VerifiedHTTPSConnection = HTTPSConnection diff --git a/openpype/hosts/fusion/vendor/urllib3/connectionpool.py b/openpype/hosts/fusion/vendor/urllib3/connectionpool.py new file mode 100644 index 0000000000..459bbe095b --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/connectionpool.py @@ -0,0 +1,1067 @@ +from __future__ import absolute_import + +import errno +import logging +import socket +import sys +import warnings +from socket import error as SocketError +from socket import timeout as SocketTimeout + +from .connection import ( + BaseSSLError, + BrokenPipeError, + DummyConnection, + HTTPConnection, + HTTPException, + HTTPSConnection, + VerifiedHTTPSConnection, + port_by_scheme, +) +from .exceptions import ( + ClosedPoolError, + EmptyPoolError, + HeaderParsingError, + HostChangedError, + InsecureRequestWarning, + LocationValueError, + MaxRetryError, + NewConnectionError, + ProtocolError, + ProxyError, + ReadTimeoutError, + SSLError, + TimeoutError, +) +from .packages import six +from .packages.six.moves import queue +from .packages.ssl_match_hostname import CertificateError +from .request import RequestMethods +from .response import HTTPResponse +from .util.connection import is_connection_dropped +from .util.proxy import connection_requires_http_tunnel +from .util.queue import LifoQueue +from .util.request import set_file_position +from .util.response import assert_header_parsing +from .util.retry import Retry +from .util.timeout import Timeout +from .util.url import Url, _encode_target +from .util.url import _normalize_host as normalize_host +from .util.url import get_host, parse_url + +xrange = six.moves.xrange + +log = logging.getLogger(__name__) + +_Default = object() + + +# Pool objects +class ConnectionPool(object): + """ + Base class for all connection pools, such as + :class:`.HTTPConnectionPool` and :class:`.HTTPSConnectionPool`. + + .. note:: + ConnectionPool.urlopen() does not normalize or percent-encode target URIs + which is useful if your target server doesn't support percent-encoded + target URIs. + """ + + scheme = None + QueueCls = LifoQueue + + def __init__(self, host, port=None): + if not host: + raise LocationValueError("No host specified.") + + self.host = _normalize_host(host, scheme=self.scheme) + self._proxy_host = host.lower() + self.port = port + + def __str__(self): + return "%s(host=%r, port=%r)" % (type(self).__name__, self.host, self.port) + + def __enter__(self): + return self + + def __exit__(self, exc_type, exc_val, exc_tb): + self.close() + # Return False to re-raise any potential exceptions + return False + + def close(self): + """ + Close all pooled connections and disable the pool. + """ + pass + + +# This is taken from http://hg.python.org/cpython/file/7aaba721ebc0/Lib/socket.py#l252 +_blocking_errnos = {errno.EAGAIN, errno.EWOULDBLOCK} + + +class HTTPConnectionPool(ConnectionPool, RequestMethods): + """ + Thread-safe connection pool for one host. + + :param host: + Host used for this HTTP Connection (e.g. "localhost"), passed into + :class:`http.client.HTTPConnection`. + + :param port: + Port used for this HTTP Connection (None is equivalent to 80), passed + into :class:`http.client.HTTPConnection`. + + :param strict: + Causes BadStatusLine to be raised if the status line can't be parsed + as a valid HTTP/1.0 or 1.1 status line, passed into + :class:`http.client.HTTPConnection`. + + .. note:: + Only works in Python 2. This parameter is ignored in Python 3. + + :param timeout: + Socket timeout in seconds for each individual connection. This can + be a float or integer, which sets the timeout for the HTTP request, + or an instance of :class:`urllib3.util.Timeout` which gives you more + fine-grained control over request timeouts. After the constructor has + been parsed, this is always a `urllib3.util.Timeout` object. + + :param maxsize: + Number of connections to save that can be reused. More than 1 is useful + in multithreaded situations. If ``block`` is set to False, more + connections will be created but they will not be saved once they've + been used. + + :param block: + If set to True, no more than ``maxsize`` connections will be used at + a time. When no free connections are available, the call will block + until a connection has been released. This is a useful side effect for + particular multithreaded situations where one does not want to use more + than maxsize connections per host to prevent flooding. + + :param headers: + Headers to include with all requests, unless other headers are given + explicitly. + + :param retries: + Retry configuration to use by default with requests in this pool. + + :param _proxy: + Parsed proxy URL, should not be used directly, instead, see + :class:`urllib3.ProxyManager` + + :param _proxy_headers: + A dictionary with proxy headers, should not be used directly, + instead, see :class:`urllib3.ProxyManager` + + :param \\**conn_kw: + Additional parameters are used to create fresh :class:`urllib3.connection.HTTPConnection`, + :class:`urllib3.connection.HTTPSConnection` instances. + """ + + scheme = "http" + ConnectionCls = HTTPConnection + ResponseCls = HTTPResponse + + def __init__( + self, + host, + port=None, + strict=False, + timeout=Timeout.DEFAULT_TIMEOUT, + maxsize=1, + block=False, + headers=None, + retries=None, + _proxy=None, + _proxy_headers=None, + _proxy_config=None, + **conn_kw + ): + ConnectionPool.__init__(self, host, port) + RequestMethods.__init__(self, headers) + + self.strict = strict + + if not isinstance(timeout, Timeout): + timeout = Timeout.from_float(timeout) + + if retries is None: + retries = Retry.DEFAULT + + self.timeout = timeout + self.retries = retries + + self.pool = self.QueueCls(maxsize) + self.block = block + + self.proxy = _proxy + self.proxy_headers = _proxy_headers or {} + self.proxy_config = _proxy_config + + # Fill the queue up so that doing get() on it will block properly + for _ in xrange(maxsize): + self.pool.put(None) + + # These are mostly for testing and debugging purposes. + self.num_connections = 0 + self.num_requests = 0 + self.conn_kw = conn_kw + + if self.proxy: + # Enable Nagle's algorithm for proxies, to avoid packet fragmentation. + # We cannot know if the user has added default socket options, so we cannot replace the + # list. + self.conn_kw.setdefault("socket_options", []) + + self.conn_kw["proxy"] = self.proxy + self.conn_kw["proxy_config"] = self.proxy_config + + def _new_conn(self): + """ + Return a fresh :class:`HTTPConnection`. + """ + self.num_connections += 1 + log.debug( + "Starting new HTTP connection (%d): %s:%s", + self.num_connections, + self.host, + self.port or "80", + ) + + conn = self.ConnectionCls( + host=self.host, + port=self.port, + timeout=self.timeout.connect_timeout, + strict=self.strict, + **self.conn_kw + ) + return conn + + def _get_conn(self, timeout=None): + """ + Get a connection. Will return a pooled connection if one is available. + + If no connections are available and :prop:`.block` is ``False``, then a + fresh connection is returned. + + :param timeout: + Seconds to wait before giving up and raising + :class:`urllib3.exceptions.EmptyPoolError` if the pool is empty and + :prop:`.block` is ``True``. + """ + conn = None + try: + conn = self.pool.get(block=self.block, timeout=timeout) + + except AttributeError: # self.pool is None + raise ClosedPoolError(self, "Pool is closed.") + + except queue.Empty: + if self.block: + raise EmptyPoolError( + self, + "Pool reached maximum size and no more connections are allowed.", + ) + pass # Oh well, we'll create a new connection then + + # If this is a persistent connection, check if it got disconnected + if conn and is_connection_dropped(conn): + log.debug("Resetting dropped connection: %s", self.host) + conn.close() + if getattr(conn, "auto_open", 1) == 0: + # This is a proxied connection that has been mutated by + # http.client._tunnel() and cannot be reused (since it would + # attempt to bypass the proxy) + conn = None + + return conn or self._new_conn() + + def _put_conn(self, conn): + """ + Put a connection back into the pool. + + :param conn: + Connection object for the current host and port as returned by + :meth:`._new_conn` or :meth:`._get_conn`. + + If the pool is already full, the connection is closed and discarded + because we exceeded maxsize. If connections are discarded frequently, + then maxsize should be increased. + + If the pool is closed, then the connection will be closed and discarded. + """ + try: + self.pool.put(conn, block=False) + return # Everything is dandy, done. + except AttributeError: + # self.pool is None. + pass + except queue.Full: + # This should never happen if self.block == True + log.warning("Connection pool is full, discarding connection: %s", self.host) + + # Connection never got put back into the pool, close it. + if conn: + conn.close() + + def _validate_conn(self, conn): + """ + Called right before a request is made, after the socket is created. + """ + pass + + def _prepare_proxy(self, conn): + # Nothing to do for HTTP connections. + pass + + def _get_timeout(self, timeout): + """Helper that always returns a :class:`urllib3.util.Timeout`""" + if timeout is _Default: + return self.timeout.clone() + + if isinstance(timeout, Timeout): + return timeout.clone() + else: + # User passed us an int/float. This is for backwards compatibility, + # can be removed later + return Timeout.from_float(timeout) + + def _raise_timeout(self, err, url, timeout_value): + """Is the error actually a timeout? Will raise a ReadTimeout or pass""" + + if isinstance(err, SocketTimeout): + raise ReadTimeoutError( + self, url, "Read timed out. (read timeout=%s)" % timeout_value + ) + + # See the above comment about EAGAIN in Python 3. In Python 2 we have + # to specifically catch it and throw the timeout error + if hasattr(err, "errno") and err.errno in _blocking_errnos: + raise ReadTimeoutError( + self, url, "Read timed out. (read timeout=%s)" % timeout_value + ) + + # Catch possible read timeouts thrown as SSL errors. If not the + # case, rethrow the original. We need to do this because of: + # http://bugs.python.org/issue10272 + if "timed out" in str(err) or "did not complete (read)" in str( + err + ): # Python < 2.7.4 + raise ReadTimeoutError( + self, url, "Read timed out. (read timeout=%s)" % timeout_value + ) + + def _make_request( + self, conn, method, url, timeout=_Default, chunked=False, **httplib_request_kw + ): + """ + Perform a request on a given urllib connection object taken from our + pool. + + :param conn: + a connection from one of our connection pools + + :param timeout: + Socket timeout in seconds for the request. This can be a + float or integer, which will set the same timeout value for + the socket connect and the socket read, or an instance of + :class:`urllib3.util.Timeout`, which gives you more fine-grained + control over your timeouts. + """ + self.num_requests += 1 + + timeout_obj = self._get_timeout(timeout) + timeout_obj.start_connect() + conn.timeout = timeout_obj.connect_timeout + + # Trigger any extra validation we need to do. + try: + self._validate_conn(conn) + except (SocketTimeout, BaseSSLError) as e: + # Py2 raises this as a BaseSSLError, Py3 raises it as socket timeout. + self._raise_timeout(err=e, url=url, timeout_value=conn.timeout) + raise + + # conn.request() calls http.client.*.request, not the method in + # urllib3.request. It also calls makefile (recv) on the socket. + try: + if chunked: + conn.request_chunked(method, url, **httplib_request_kw) + else: + conn.request(method, url, **httplib_request_kw) + + # We are swallowing BrokenPipeError (errno.EPIPE) since the server is + # legitimately able to close the connection after sending a valid response. + # With this behaviour, the received response is still readable. + except BrokenPipeError: + # Python 3 + pass + except IOError as e: + # Python 2 and macOS/Linux + # EPIPE and ESHUTDOWN are BrokenPipeError on Python 2, and EPROTOTYPE is needed on macOS + # https://erickt.github.io/blog/2014/11/19/adventures-in-debugging-a-potential-osx-kernel-bug/ + if e.errno not in { + errno.EPIPE, + errno.ESHUTDOWN, + errno.EPROTOTYPE, + }: + raise + + # Reset the timeout for the recv() on the socket + read_timeout = timeout_obj.read_timeout + + # App Engine doesn't have a sock attr + if getattr(conn, "sock", None): + # In Python 3 socket.py will catch EAGAIN and return None when you + # try and read into the file pointer created by http.client, which + # instead raises a BadStatusLine exception. Instead of catching + # the exception and assuming all BadStatusLine exceptions are read + # timeouts, check for a zero timeout before making the request. + if read_timeout == 0: + raise ReadTimeoutError( + self, url, "Read timed out. (read timeout=%s)" % read_timeout + ) + if read_timeout is Timeout.DEFAULT_TIMEOUT: + conn.sock.settimeout(socket.getdefaulttimeout()) + else: # None or a value + conn.sock.settimeout(read_timeout) + + # Receive the response from the server + try: + try: + # Python 2.7, use buffering of HTTP responses + httplib_response = conn.getresponse(buffering=True) + except TypeError: + # Python 3 + try: + httplib_response = conn.getresponse() + except BaseException as e: + # Remove the TypeError from the exception chain in + # Python 3 (including for exceptions like SystemExit). + # Otherwise it looks like a bug in the code. + six.raise_from(e, None) + except (SocketTimeout, BaseSSLError, SocketError) as e: + self._raise_timeout(err=e, url=url, timeout_value=read_timeout) + raise + + # AppEngine doesn't have a version attr. + http_version = getattr(conn, "_http_vsn_str", "HTTP/?") + log.debug( + '%s://%s:%s "%s %s %s" %s %s', + self.scheme, + self.host, + self.port, + method, + url, + http_version, + httplib_response.status, + httplib_response.length, + ) + + try: + assert_header_parsing(httplib_response.msg) + except (HeaderParsingError, TypeError) as hpe: # Platform-specific: Python 3 + log.warning( + "Failed to parse headers (url=%s): %s", + self._absolute_url(url), + hpe, + exc_info=True, + ) + + return httplib_response + + def _absolute_url(self, path): + return Url(scheme=self.scheme, host=self.host, port=self.port, path=path).url + + def close(self): + """ + Close all pooled connections and disable the pool. + """ + if self.pool is None: + return + # Disable access to the pool + old_pool, self.pool = self.pool, None + + try: + while True: + conn = old_pool.get(block=False) + if conn: + conn.close() + + except queue.Empty: + pass # Done. + + def is_same_host(self, url): + """ + Check if the given ``url`` is a member of the same host as this + connection pool. + """ + if url.startswith("/"): + return True + + # TODO: Add optional support for socket.gethostbyname checking. + scheme, host, port = get_host(url) + if host is not None: + host = _normalize_host(host, scheme=scheme) + + # Use explicit default port for comparison when none is given + if self.port and not port: + port = port_by_scheme.get(scheme) + elif not self.port and port == port_by_scheme.get(scheme): + port = None + + return (scheme, host, port) == (self.scheme, self.host, self.port) + + def urlopen( + self, + method, + url, + body=None, + headers=None, + retries=None, + redirect=True, + assert_same_host=True, + timeout=_Default, + pool_timeout=None, + release_conn=None, + chunked=False, + body_pos=None, + **response_kw + ): + """ + Get a connection from the pool and perform an HTTP request. This is the + lowest level call for making a request, so you'll need to specify all + the raw details. + + .. note:: + + More commonly, it's appropriate to use a convenience method provided + by :class:`.RequestMethods`, such as :meth:`request`. + + .. note:: + + `release_conn` will only behave as expected if + `preload_content=False` because we want to make + `preload_content=False` the default behaviour someday soon without + breaking backwards compatibility. + + :param method: + HTTP request method (such as GET, POST, PUT, etc.) + + :param url: + The URL to perform the request on. + + :param body: + Data to send in the request body, either :class:`str`, :class:`bytes`, + an iterable of :class:`str`/:class:`bytes`, or a file-like object. + + :param headers: + Dictionary of custom headers to send, such as User-Agent, + If-None-Match, etc. If None, pool headers are used. If provided, + these headers completely replace any pool-specific headers. + + :param retries: + Configure the number of retries to allow before raising a + :class:`~urllib3.exceptions.MaxRetryError` exception. + + Pass ``None`` to retry until you receive a response. Pass a + :class:`~urllib3.util.retry.Retry` object for fine-grained control + over different types of retries. + Pass an integer number to retry connection errors that many times, + but no other types of errors. Pass zero to never retry. + + If ``False``, then retries are disabled and any exception is raised + immediately. Also, instead of raising a MaxRetryError on redirects, + the redirect response will be returned. + + :type retries: :class:`~urllib3.util.retry.Retry`, False, or an int. + + :param redirect: + If True, automatically handle redirects (status codes 301, 302, + 303, 307, 308). Each redirect counts as a retry. Disabling retries + will disable redirect, too. + + :param assert_same_host: + If ``True``, will make sure that the host of the pool requests is + consistent else will raise HostChangedError. When ``False``, you can + use the pool on an HTTP proxy and request foreign hosts. + + :param timeout: + If specified, overrides the default timeout for this one + request. It may be a float (in seconds) or an instance of + :class:`urllib3.util.Timeout`. + + :param pool_timeout: + If set and the pool is set to block=True, then this method will + block for ``pool_timeout`` seconds and raise EmptyPoolError if no + connection is available within the time period. + + :param release_conn: + If False, then the urlopen call will not release the connection + back into the pool once a response is received (but will release if + you read the entire contents of the response such as when + `preload_content=True`). This is useful if you're not preloading + the response's content immediately. You will need to call + ``r.release_conn()`` on the response ``r`` to return the connection + back into the pool. If None, it takes the value of + ``response_kw.get('preload_content', True)``. + + :param chunked: + If True, urllib3 will send the body using chunked transfer + encoding. Otherwise, urllib3 will send the body using the standard + content-length form. Defaults to False. + + :param int body_pos: + Position to seek to in file-like body in the event of a retry or + redirect. Typically this won't need to be set because urllib3 will + auto-populate the value when needed. + + :param \\**response_kw: + Additional parameters are passed to + :meth:`urllib3.response.HTTPResponse.from_httplib` + """ + + parsed_url = parse_url(url) + destination_scheme = parsed_url.scheme + + if headers is None: + headers = self.headers + + if not isinstance(retries, Retry): + retries = Retry.from_int(retries, redirect=redirect, default=self.retries) + + if release_conn is None: + release_conn = response_kw.get("preload_content", True) + + # Check host + if assert_same_host and not self.is_same_host(url): + raise HostChangedError(self, url, retries) + + # Ensure that the URL we're connecting to is properly encoded + if url.startswith("/"): + url = six.ensure_str(_encode_target(url)) + else: + url = six.ensure_str(parsed_url.url) + + conn = None + + # Track whether `conn` needs to be released before + # returning/raising/recursing. Update this variable if necessary, and + # leave `release_conn` constant throughout the function. That way, if + # the function recurses, the original value of `release_conn` will be + # passed down into the recursive call, and its value will be respected. + # + # See issue #651 [1] for details. + # + # [1] + release_this_conn = release_conn + + http_tunnel_required = connection_requires_http_tunnel( + self.proxy, self.proxy_config, destination_scheme + ) + + # Merge the proxy headers. Only done when not using HTTP CONNECT. We + # have to copy the headers dict so we can safely change it without those + # changes being reflected in anyone else's copy. + if not http_tunnel_required: + headers = headers.copy() + headers.update(self.proxy_headers) + + # Must keep the exception bound to a separate variable or else Python 3 + # complains about UnboundLocalError. + err = None + + # Keep track of whether we cleanly exited the except block. This + # ensures we do proper cleanup in finally. + clean_exit = False + + # Rewind body position, if needed. Record current position + # for future rewinds in the event of a redirect/retry. + body_pos = set_file_position(body, body_pos) + + try: + # Request a connection from the queue. + timeout_obj = self._get_timeout(timeout) + conn = self._get_conn(timeout=pool_timeout) + + conn.timeout = timeout_obj.connect_timeout + + is_new_proxy_conn = self.proxy is not None and not getattr( + conn, "sock", None + ) + if is_new_proxy_conn and http_tunnel_required: + self._prepare_proxy(conn) + + # Make the request on the httplib connection object. + httplib_response = self._make_request( + conn, + method, + url, + timeout=timeout_obj, + body=body, + headers=headers, + chunked=chunked, + ) + + # If we're going to release the connection in ``finally:``, then + # the response doesn't need to know about the connection. Otherwise + # it will also try to release it and we'll have a double-release + # mess. + response_conn = conn if not release_conn else None + + # Pass method to Response for length checking + response_kw["request_method"] = method + + # Import httplib's response into our own wrapper object + response = self.ResponseCls.from_httplib( + httplib_response, + pool=self, + connection=response_conn, + retries=retries, + **response_kw + ) + + # Everything went great! + clean_exit = True + + except EmptyPoolError: + # Didn't get a connection from the pool, no need to clean up + clean_exit = True + release_this_conn = False + raise + + except ( + TimeoutError, + HTTPException, + SocketError, + ProtocolError, + BaseSSLError, + SSLError, + CertificateError, + ) as e: + # Discard the connection for these exceptions. It will be + # replaced during the next _get_conn() call. + clean_exit = False + if isinstance(e, (BaseSSLError, CertificateError)): + e = SSLError(e) + elif isinstance(e, (SocketError, NewConnectionError)) and self.proxy: + e = ProxyError("Cannot connect to proxy.", e) + elif isinstance(e, (SocketError, HTTPException)): + e = ProtocolError("Connection aborted.", e) + + retries = retries.increment( + method, url, error=e, _pool=self, _stacktrace=sys.exc_info()[2] + ) + retries.sleep() + + # Keep track of the error for the retry warning. + err = e + + finally: + if not clean_exit: + # We hit some kind of exception, handled or otherwise. We need + # to throw the connection away unless explicitly told not to. + # Close the connection, set the variable to None, and make sure + # we put the None back in the pool to avoid leaking it. + conn = conn and conn.close() + release_this_conn = True + + if release_this_conn: + # Put the connection back to be reused. If the connection is + # expired then it will be None, which will get replaced with a + # fresh connection during _get_conn. + self._put_conn(conn) + + if not conn: + # Try again + log.warning( + "Retrying (%r) after connection broken by '%r': %s", retries, err, url + ) + return self.urlopen( + method, + url, + body, + headers, + retries, + redirect, + assert_same_host, + timeout=timeout, + pool_timeout=pool_timeout, + release_conn=release_conn, + chunked=chunked, + body_pos=body_pos, + **response_kw + ) + + # Handle redirect? + redirect_location = redirect and response.get_redirect_location() + if redirect_location: + if response.status == 303: + method = "GET" + + try: + retries = retries.increment(method, url, response=response, _pool=self) + except MaxRetryError: + if retries.raise_on_redirect: + response.drain_conn() + raise + return response + + response.drain_conn() + retries.sleep_for_retry(response) + log.debug("Redirecting %s -> %s", url, redirect_location) + return self.urlopen( + method, + redirect_location, + body, + headers, + retries=retries, + redirect=redirect, + assert_same_host=assert_same_host, + timeout=timeout, + pool_timeout=pool_timeout, + release_conn=release_conn, + chunked=chunked, + body_pos=body_pos, + **response_kw + ) + + # Check if we should retry the HTTP response. + has_retry_after = bool(response.getheader("Retry-After")) + if retries.is_retry(method, response.status, has_retry_after): + try: + retries = retries.increment(method, url, response=response, _pool=self) + except MaxRetryError: + if retries.raise_on_status: + response.drain_conn() + raise + return response + + response.drain_conn() + retries.sleep(response) + log.debug("Retry: %s", url) + return self.urlopen( + method, + url, + body, + headers, + retries=retries, + redirect=redirect, + assert_same_host=assert_same_host, + timeout=timeout, + pool_timeout=pool_timeout, + release_conn=release_conn, + chunked=chunked, + body_pos=body_pos, + **response_kw + ) + + return response + + +class HTTPSConnectionPool(HTTPConnectionPool): + """ + Same as :class:`.HTTPConnectionPool`, but HTTPS. + + :class:`.HTTPSConnection` uses one of ``assert_fingerprint``, + ``assert_hostname`` and ``host`` in this order to verify connections. + If ``assert_hostname`` is False, no verification is done. + + The ``key_file``, ``cert_file``, ``cert_reqs``, ``ca_certs``, + ``ca_cert_dir``, ``ssl_version``, ``key_password`` are only used if :mod:`ssl` + is available and are fed into :meth:`urllib3.util.ssl_wrap_socket` to upgrade + the connection socket into an SSL socket. + """ + + scheme = "https" + ConnectionCls = HTTPSConnection + + def __init__( + self, + host, + port=None, + strict=False, + timeout=Timeout.DEFAULT_TIMEOUT, + maxsize=1, + block=False, + headers=None, + retries=None, + _proxy=None, + _proxy_headers=None, + key_file=None, + cert_file=None, + cert_reqs=None, + key_password=None, + ca_certs=None, + ssl_version=None, + assert_hostname=None, + assert_fingerprint=None, + ca_cert_dir=None, + **conn_kw + ): + + HTTPConnectionPool.__init__( + self, + host, + port, + strict, + timeout, + maxsize, + block, + headers, + retries, + _proxy, + _proxy_headers, + **conn_kw + ) + + self.key_file = key_file + self.cert_file = cert_file + self.cert_reqs = cert_reqs + self.key_password = key_password + self.ca_certs = ca_certs + self.ca_cert_dir = ca_cert_dir + self.ssl_version = ssl_version + self.assert_hostname = assert_hostname + self.assert_fingerprint = assert_fingerprint + + def _prepare_conn(self, conn): + """ + Prepare the ``connection`` for :meth:`urllib3.util.ssl_wrap_socket` + and establish the tunnel if proxy is used. + """ + + if isinstance(conn, VerifiedHTTPSConnection): + conn.set_cert( + key_file=self.key_file, + key_password=self.key_password, + cert_file=self.cert_file, + cert_reqs=self.cert_reqs, + ca_certs=self.ca_certs, + ca_cert_dir=self.ca_cert_dir, + assert_hostname=self.assert_hostname, + assert_fingerprint=self.assert_fingerprint, + ) + conn.ssl_version = self.ssl_version + return conn + + def _prepare_proxy(self, conn): + """ + Establishes a tunnel connection through HTTP CONNECT. + + Tunnel connection is established early because otherwise httplib would + improperly set Host: header to proxy's IP:port. + """ + + conn.set_tunnel(self._proxy_host, self.port, self.proxy_headers) + + if self.proxy.scheme == "https": + conn.tls_in_tls_required = True + + conn.connect() + + def _new_conn(self): + """ + Return a fresh :class:`http.client.HTTPSConnection`. + """ + self.num_connections += 1 + log.debug( + "Starting new HTTPS connection (%d): %s:%s", + self.num_connections, + self.host, + self.port or "443", + ) + + if not self.ConnectionCls or self.ConnectionCls is DummyConnection: + raise SSLError( + "Can't connect to HTTPS URL because the SSL module is not available." + ) + + actual_host = self.host + actual_port = self.port + if self.proxy is not None: + actual_host = self.proxy.host + actual_port = self.proxy.port + + conn = self.ConnectionCls( + host=actual_host, + port=actual_port, + timeout=self.timeout.connect_timeout, + strict=self.strict, + cert_file=self.cert_file, + key_file=self.key_file, + key_password=self.key_password, + **self.conn_kw + ) + + return self._prepare_conn(conn) + + def _validate_conn(self, conn): + """ + Called right before a request is made, after the socket is created. + """ + super(HTTPSConnectionPool, self)._validate_conn(conn) + + # Force connect early to allow us to validate the connection. + if not getattr(conn, "sock", None): # AppEngine might not have `.sock` + conn.connect() + + if not conn.is_verified: + warnings.warn( + ( + "Unverified HTTPS request is being made to host '%s'. " + "Adding certificate verification is strongly advised. See: " + "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html" + "#ssl-warnings" % conn.host + ), + InsecureRequestWarning, + ) + + +def connection_from_url(url, **kw): + """ + Given a url, return an :class:`.ConnectionPool` instance of its host. + + This is a shortcut for not having to parse out the scheme, host, and port + of the url before creating an :class:`.ConnectionPool` instance. + + :param url: + Absolute URL string that must include the scheme. Port is optional. + + :param \\**kw: + Passes additional parameters to the constructor of the appropriate + :class:`.ConnectionPool`. Useful for specifying things like + timeout, maxsize, headers, etc. + + Example:: + + >>> conn = connection_from_url('http://google.com/') + >>> r = conn.request('GET', '/') + """ + scheme, host, port = get_host(url) + port = port or port_by_scheme.get(scheme, 80) + if scheme == "https": + return HTTPSConnectionPool(host, port=port, **kw) + else: + return HTTPConnectionPool(host, port=port, **kw) + + +def _normalize_host(host, scheme): + """ + Normalize hosts for comparisons and use with sockets. + """ + + host = normalize_host(host, scheme) + + # httplib doesn't like it when we include brackets in IPv6 addresses + # Specifically, if we include brackets but also pass the port then + # httplib crazily doubles up the square brackets on the Host header. + # Instead, we need to make sure we never pass ``None`` as the port. + # However, for backward compatibility reasons we can't actually + # *assert* that. See http://bugs.python.org/issue28539 + if host.startswith("[") and host.endswith("]"): + host = host[1:-1] + return host diff --git a/openpype/hosts/fusion/vendor/urllib3/contrib/__init__.py b/openpype/hosts/fusion/vendor/urllib3/contrib/__init__.py new file mode 100644 index 0000000000..e69de29bb2 diff --git a/openpype/hosts/fusion/vendor/urllib3/contrib/_appengine_environ.py b/openpype/hosts/fusion/vendor/urllib3/contrib/_appengine_environ.py new file mode 100644 index 0000000000..8765b907d7 --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/contrib/_appengine_environ.py @@ -0,0 +1,36 @@ +""" +This module provides means to detect the App Engine environment. +""" + +import os + + +def is_appengine(): + return is_local_appengine() or is_prod_appengine() + + +def is_appengine_sandbox(): + """Reports if the app is running in the first generation sandbox. + + The second generation runtimes are technically still in a sandbox, but it + is much less restrictive, so generally you shouldn't need to check for it. + see https://cloud.google.com/appengine/docs/standard/runtimes + """ + return is_appengine() and os.environ["APPENGINE_RUNTIME"] == "python27" + + +def is_local_appengine(): + return "APPENGINE_RUNTIME" in os.environ and os.environ.get( + "SERVER_SOFTWARE", "" + ).startswith("Development/") + + +def is_prod_appengine(): + return "APPENGINE_RUNTIME" in os.environ and os.environ.get( + "SERVER_SOFTWARE", "" + ).startswith("Google App Engine/") + + +def is_prod_appengine_mvms(): + """Deprecated.""" + return False diff --git a/openpype/hosts/fusion/vendor/urllib3/contrib/_securetransport/__init__.py b/openpype/hosts/fusion/vendor/urllib3/contrib/_securetransport/__init__.py new file mode 100644 index 0000000000..e69de29bb2 diff --git a/openpype/hosts/fusion/vendor/urllib3/contrib/_securetransport/bindings.py b/openpype/hosts/fusion/vendor/urllib3/contrib/_securetransport/bindings.py new file mode 100644 index 0000000000..11524d400b --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/contrib/_securetransport/bindings.py @@ -0,0 +1,519 @@ +""" +This module uses ctypes to bind a whole bunch of functions and constants from +SecureTransport. The goal here is to provide the low-level API to +SecureTransport. These are essentially the C-level functions and constants, and +they're pretty gross to work with. + +This code is a bastardised version of the code found in Will Bond's oscrypto +library. An enormous debt is owed to him for blazing this trail for us. For +that reason, this code should be considered to be covered both by urllib3's +license and by oscrypto's: + + Copyright (c) 2015-2016 Will Bond + + Permission is hereby granted, free of charge, to any person obtaining a + copy of this software and associated documentation files (the "Software"), + to deal in the Software without restriction, including without limitation + the rights to use, copy, modify, merge, publish, distribute, sublicense, + and/or sell copies of the Software, and to permit persons to whom the + Software is furnished to do so, subject to the following conditions: + + The above copyright notice and this permission notice shall be included in + all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING + FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER + DEALINGS IN THE SOFTWARE. +""" +from __future__ import absolute_import + +import platform +from ctypes import ( + CDLL, + CFUNCTYPE, + POINTER, + c_bool, + c_byte, + c_char_p, + c_int32, + c_long, + c_size_t, + c_uint32, + c_ulong, + c_void_p, +) +from ctypes.util import find_library + +from urllib3.packages.six import raise_from + +if platform.system() != "Darwin": + raise ImportError("Only macOS is supported") + +version = platform.mac_ver()[0] +version_info = tuple(map(int, version.split("."))) +if version_info < (10, 8): + raise OSError( + "Only OS X 10.8 and newer are supported, not %s.%s" + % (version_info[0], version_info[1]) + ) + + +def load_cdll(name, macos10_16_path): + """Loads a CDLL by name, falling back to known path on 10.16+""" + try: + # Big Sur is technically 11 but we use 10.16 due to the Big Sur + # beta being labeled as 10.16. + if version_info >= (10, 16): + path = macos10_16_path + else: + path = find_library(name) + if not path: + raise OSError # Caught and reraised as 'ImportError' + return CDLL(path, use_errno=True) + except OSError: + raise_from(ImportError("The library %s failed to load" % name), None) + + +Security = load_cdll( + "Security", "/System/Library/Frameworks/Security.framework/Security" +) +CoreFoundation = load_cdll( + "CoreFoundation", + "/System/Library/Frameworks/CoreFoundation.framework/CoreFoundation", +) + + +Boolean = c_bool +CFIndex = c_long +CFStringEncoding = c_uint32 +CFData = c_void_p +CFString = c_void_p +CFArray = c_void_p +CFMutableArray = c_void_p +CFDictionary = c_void_p +CFError = c_void_p +CFType = c_void_p +CFTypeID = c_ulong + +CFTypeRef = POINTER(CFType) +CFAllocatorRef = c_void_p + +OSStatus = c_int32 + +CFDataRef = POINTER(CFData) +CFStringRef = POINTER(CFString) +CFArrayRef = POINTER(CFArray) +CFMutableArrayRef = POINTER(CFMutableArray) +CFDictionaryRef = POINTER(CFDictionary) +CFArrayCallBacks = c_void_p +CFDictionaryKeyCallBacks = c_void_p +CFDictionaryValueCallBacks = c_void_p + +SecCertificateRef = POINTER(c_void_p) +SecExternalFormat = c_uint32 +SecExternalItemType = c_uint32 +SecIdentityRef = POINTER(c_void_p) +SecItemImportExportFlags = c_uint32 +SecItemImportExportKeyParameters = c_void_p +SecKeychainRef = POINTER(c_void_p) +SSLProtocol = c_uint32 +SSLCipherSuite = c_uint32 +SSLContextRef = POINTER(c_void_p) +SecTrustRef = POINTER(c_void_p) +SSLConnectionRef = c_uint32 +SecTrustResultType = c_uint32 +SecTrustOptionFlags = c_uint32 +SSLProtocolSide = c_uint32 +SSLConnectionType = c_uint32 +SSLSessionOption = c_uint32 + + +try: + Security.SecItemImport.argtypes = [ + CFDataRef, + CFStringRef, + POINTER(SecExternalFormat), + POINTER(SecExternalItemType), + SecItemImportExportFlags, + POINTER(SecItemImportExportKeyParameters), + SecKeychainRef, + POINTER(CFArrayRef), + ] + Security.SecItemImport.restype = OSStatus + + Security.SecCertificateGetTypeID.argtypes = [] + Security.SecCertificateGetTypeID.restype = CFTypeID + + Security.SecIdentityGetTypeID.argtypes = [] + Security.SecIdentityGetTypeID.restype = CFTypeID + + Security.SecKeyGetTypeID.argtypes = [] + Security.SecKeyGetTypeID.restype = CFTypeID + + Security.SecCertificateCreateWithData.argtypes = [CFAllocatorRef, CFDataRef] + Security.SecCertificateCreateWithData.restype = SecCertificateRef + + Security.SecCertificateCopyData.argtypes = [SecCertificateRef] + Security.SecCertificateCopyData.restype = CFDataRef + + Security.SecCopyErrorMessageString.argtypes = [OSStatus, c_void_p] + Security.SecCopyErrorMessageString.restype = CFStringRef + + Security.SecIdentityCreateWithCertificate.argtypes = [ + CFTypeRef, + SecCertificateRef, + POINTER(SecIdentityRef), + ] + Security.SecIdentityCreateWithCertificate.restype = OSStatus + + Security.SecKeychainCreate.argtypes = [ + c_char_p, + c_uint32, + c_void_p, + Boolean, + c_void_p, + POINTER(SecKeychainRef), + ] + Security.SecKeychainCreate.restype = OSStatus + + Security.SecKeychainDelete.argtypes = [SecKeychainRef] + Security.SecKeychainDelete.restype = OSStatus + + Security.SecPKCS12Import.argtypes = [ + CFDataRef, + CFDictionaryRef, + POINTER(CFArrayRef), + ] + Security.SecPKCS12Import.restype = OSStatus + + SSLReadFunc = CFUNCTYPE(OSStatus, SSLConnectionRef, c_void_p, POINTER(c_size_t)) + SSLWriteFunc = CFUNCTYPE( + OSStatus, SSLConnectionRef, POINTER(c_byte), POINTER(c_size_t) + ) + + Security.SSLSetIOFuncs.argtypes = [SSLContextRef, SSLReadFunc, SSLWriteFunc] + Security.SSLSetIOFuncs.restype = OSStatus + + Security.SSLSetPeerID.argtypes = [SSLContextRef, c_char_p, c_size_t] + Security.SSLSetPeerID.restype = OSStatus + + Security.SSLSetCertificate.argtypes = [SSLContextRef, CFArrayRef] + Security.SSLSetCertificate.restype = OSStatus + + Security.SSLSetCertificateAuthorities.argtypes = [SSLContextRef, CFTypeRef, Boolean] + Security.SSLSetCertificateAuthorities.restype = OSStatus + + Security.SSLSetConnection.argtypes = [SSLContextRef, SSLConnectionRef] + Security.SSLSetConnection.restype = OSStatus + + Security.SSLSetPeerDomainName.argtypes = [SSLContextRef, c_char_p, c_size_t] + Security.SSLSetPeerDomainName.restype = OSStatus + + Security.SSLHandshake.argtypes = [SSLContextRef] + Security.SSLHandshake.restype = OSStatus + + Security.SSLRead.argtypes = [SSLContextRef, c_char_p, c_size_t, POINTER(c_size_t)] + Security.SSLRead.restype = OSStatus + + Security.SSLWrite.argtypes = [SSLContextRef, c_char_p, c_size_t, POINTER(c_size_t)] + Security.SSLWrite.restype = OSStatus + + Security.SSLClose.argtypes = [SSLContextRef] + Security.SSLClose.restype = OSStatus + + Security.SSLGetNumberSupportedCiphers.argtypes = [SSLContextRef, POINTER(c_size_t)] + Security.SSLGetNumberSupportedCiphers.restype = OSStatus + + Security.SSLGetSupportedCiphers.argtypes = [ + SSLContextRef, + POINTER(SSLCipherSuite), + POINTER(c_size_t), + ] + Security.SSLGetSupportedCiphers.restype = OSStatus + + Security.SSLSetEnabledCiphers.argtypes = [ + SSLContextRef, + POINTER(SSLCipherSuite), + c_size_t, + ] + Security.SSLSetEnabledCiphers.restype = OSStatus + + Security.SSLGetNumberEnabledCiphers.argtype = [SSLContextRef, POINTER(c_size_t)] + Security.SSLGetNumberEnabledCiphers.restype = OSStatus + + Security.SSLGetEnabledCiphers.argtypes = [ + SSLContextRef, + POINTER(SSLCipherSuite), + POINTER(c_size_t), + ] + Security.SSLGetEnabledCiphers.restype = OSStatus + + Security.SSLGetNegotiatedCipher.argtypes = [SSLContextRef, POINTER(SSLCipherSuite)] + Security.SSLGetNegotiatedCipher.restype = OSStatus + + Security.SSLGetNegotiatedProtocolVersion.argtypes = [ + SSLContextRef, + POINTER(SSLProtocol), + ] + Security.SSLGetNegotiatedProtocolVersion.restype = OSStatus + + Security.SSLCopyPeerTrust.argtypes = [SSLContextRef, POINTER(SecTrustRef)] + Security.SSLCopyPeerTrust.restype = OSStatus + + Security.SecTrustSetAnchorCertificates.argtypes = [SecTrustRef, CFArrayRef] + Security.SecTrustSetAnchorCertificates.restype = OSStatus + + Security.SecTrustSetAnchorCertificatesOnly.argstypes = [SecTrustRef, Boolean] + Security.SecTrustSetAnchorCertificatesOnly.restype = OSStatus + + Security.SecTrustEvaluate.argtypes = [SecTrustRef, POINTER(SecTrustResultType)] + Security.SecTrustEvaluate.restype = OSStatus + + Security.SecTrustGetCertificateCount.argtypes = [SecTrustRef] + Security.SecTrustGetCertificateCount.restype = CFIndex + + Security.SecTrustGetCertificateAtIndex.argtypes = [SecTrustRef, CFIndex] + Security.SecTrustGetCertificateAtIndex.restype = SecCertificateRef + + Security.SSLCreateContext.argtypes = [ + CFAllocatorRef, + SSLProtocolSide, + SSLConnectionType, + ] + Security.SSLCreateContext.restype = SSLContextRef + + Security.SSLSetSessionOption.argtypes = [SSLContextRef, SSLSessionOption, Boolean] + Security.SSLSetSessionOption.restype = OSStatus + + Security.SSLSetProtocolVersionMin.argtypes = [SSLContextRef, SSLProtocol] + Security.SSLSetProtocolVersionMin.restype = OSStatus + + Security.SSLSetProtocolVersionMax.argtypes = [SSLContextRef, SSLProtocol] + Security.SSLSetProtocolVersionMax.restype = OSStatus + + try: + Security.SSLSetALPNProtocols.argtypes = [SSLContextRef, CFArrayRef] + Security.SSLSetALPNProtocols.restype = OSStatus + except AttributeError: + # Supported only in 10.12+ + pass + + Security.SecCopyErrorMessageString.argtypes = [OSStatus, c_void_p] + Security.SecCopyErrorMessageString.restype = CFStringRef + + Security.SSLReadFunc = SSLReadFunc + Security.SSLWriteFunc = SSLWriteFunc + Security.SSLContextRef = SSLContextRef + Security.SSLProtocol = SSLProtocol + Security.SSLCipherSuite = SSLCipherSuite + Security.SecIdentityRef = SecIdentityRef + Security.SecKeychainRef = SecKeychainRef + Security.SecTrustRef = SecTrustRef + Security.SecTrustResultType = SecTrustResultType + Security.SecExternalFormat = SecExternalFormat + Security.OSStatus = OSStatus + + Security.kSecImportExportPassphrase = CFStringRef.in_dll( + Security, "kSecImportExportPassphrase" + ) + Security.kSecImportItemIdentity = CFStringRef.in_dll( + Security, "kSecImportItemIdentity" + ) + + # CoreFoundation time! + CoreFoundation.CFRetain.argtypes = [CFTypeRef] + CoreFoundation.CFRetain.restype = CFTypeRef + + CoreFoundation.CFRelease.argtypes = [CFTypeRef] + CoreFoundation.CFRelease.restype = None + + CoreFoundation.CFGetTypeID.argtypes = [CFTypeRef] + CoreFoundation.CFGetTypeID.restype = CFTypeID + + CoreFoundation.CFStringCreateWithCString.argtypes = [ + CFAllocatorRef, + c_char_p, + CFStringEncoding, + ] + CoreFoundation.CFStringCreateWithCString.restype = CFStringRef + + CoreFoundation.CFStringGetCStringPtr.argtypes = [CFStringRef, CFStringEncoding] + CoreFoundation.CFStringGetCStringPtr.restype = c_char_p + + CoreFoundation.CFStringGetCString.argtypes = [ + CFStringRef, + c_char_p, + CFIndex, + CFStringEncoding, + ] + CoreFoundation.CFStringGetCString.restype = c_bool + + CoreFoundation.CFDataCreate.argtypes = [CFAllocatorRef, c_char_p, CFIndex] + CoreFoundation.CFDataCreate.restype = CFDataRef + + CoreFoundation.CFDataGetLength.argtypes = [CFDataRef] + CoreFoundation.CFDataGetLength.restype = CFIndex + + CoreFoundation.CFDataGetBytePtr.argtypes = [CFDataRef] + CoreFoundation.CFDataGetBytePtr.restype = c_void_p + + CoreFoundation.CFDictionaryCreate.argtypes = [ + CFAllocatorRef, + POINTER(CFTypeRef), + POINTER(CFTypeRef), + CFIndex, + CFDictionaryKeyCallBacks, + CFDictionaryValueCallBacks, + ] + CoreFoundation.CFDictionaryCreate.restype = CFDictionaryRef + + CoreFoundation.CFDictionaryGetValue.argtypes = [CFDictionaryRef, CFTypeRef] + CoreFoundation.CFDictionaryGetValue.restype = CFTypeRef + + CoreFoundation.CFArrayCreate.argtypes = [ + CFAllocatorRef, + POINTER(CFTypeRef), + CFIndex, + CFArrayCallBacks, + ] + CoreFoundation.CFArrayCreate.restype = CFArrayRef + + CoreFoundation.CFArrayCreateMutable.argtypes = [ + CFAllocatorRef, + CFIndex, + CFArrayCallBacks, + ] + CoreFoundation.CFArrayCreateMutable.restype = CFMutableArrayRef + + CoreFoundation.CFArrayAppendValue.argtypes = [CFMutableArrayRef, c_void_p] + CoreFoundation.CFArrayAppendValue.restype = None + + CoreFoundation.CFArrayGetCount.argtypes = [CFArrayRef] + CoreFoundation.CFArrayGetCount.restype = CFIndex + + CoreFoundation.CFArrayGetValueAtIndex.argtypes = [CFArrayRef, CFIndex] + CoreFoundation.CFArrayGetValueAtIndex.restype = c_void_p + + CoreFoundation.kCFAllocatorDefault = CFAllocatorRef.in_dll( + CoreFoundation, "kCFAllocatorDefault" + ) + CoreFoundation.kCFTypeArrayCallBacks = c_void_p.in_dll( + CoreFoundation, "kCFTypeArrayCallBacks" + ) + CoreFoundation.kCFTypeDictionaryKeyCallBacks = c_void_p.in_dll( + CoreFoundation, "kCFTypeDictionaryKeyCallBacks" + ) + CoreFoundation.kCFTypeDictionaryValueCallBacks = c_void_p.in_dll( + CoreFoundation, "kCFTypeDictionaryValueCallBacks" + ) + + CoreFoundation.CFTypeRef = CFTypeRef + CoreFoundation.CFArrayRef = CFArrayRef + CoreFoundation.CFStringRef = CFStringRef + CoreFoundation.CFDictionaryRef = CFDictionaryRef + +except (AttributeError): + raise ImportError("Error initializing ctypes") + + +class CFConst(object): + """ + A class object that acts as essentially a namespace for CoreFoundation + constants. + """ + + kCFStringEncodingUTF8 = CFStringEncoding(0x08000100) + + +class SecurityConst(object): + """ + A class object that acts as essentially a namespace for Security constants. + """ + + kSSLSessionOptionBreakOnServerAuth = 0 + + kSSLProtocol2 = 1 + kSSLProtocol3 = 2 + kTLSProtocol1 = 4 + kTLSProtocol11 = 7 + kTLSProtocol12 = 8 + # SecureTransport does not support TLS 1.3 even if there's a constant for it + kTLSProtocol13 = 10 + kTLSProtocolMaxSupported = 999 + + kSSLClientSide = 1 + kSSLStreamType = 0 + + kSecFormatPEMSequence = 10 + + kSecTrustResultInvalid = 0 + kSecTrustResultProceed = 1 + # This gap is present on purpose: this was kSecTrustResultConfirm, which + # is deprecated. + kSecTrustResultDeny = 3 + kSecTrustResultUnspecified = 4 + kSecTrustResultRecoverableTrustFailure = 5 + kSecTrustResultFatalTrustFailure = 6 + kSecTrustResultOtherError = 7 + + errSSLProtocol = -9800 + errSSLWouldBlock = -9803 + errSSLClosedGraceful = -9805 + errSSLClosedNoNotify = -9816 + errSSLClosedAbort = -9806 + + errSSLXCertChainInvalid = -9807 + errSSLCrypto = -9809 + errSSLInternal = -9810 + errSSLCertExpired = -9814 + errSSLCertNotYetValid = -9815 + errSSLUnknownRootCert = -9812 + errSSLNoRootCert = -9813 + errSSLHostNameMismatch = -9843 + errSSLPeerHandshakeFail = -9824 + errSSLPeerUserCancelled = -9839 + errSSLWeakPeerEphemeralDHKey = -9850 + errSSLServerAuthCompleted = -9841 + errSSLRecordOverflow = -9847 + + errSecVerifyFailed = -67808 + errSecNoTrustSettings = -25263 + errSecItemNotFound = -25300 + errSecInvalidTrustSettings = -25262 + + # Cipher suites. We only pick the ones our default cipher string allows. + # Source: https://developer.apple.com/documentation/security/1550981-ssl_cipher_suite_values + TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 = 0xC02C + TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 = 0xC030 + TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 = 0xC02B + TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 = 0xC02F + TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256 = 0xCCA9 + TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256 = 0xCCA8 + TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 = 0x009F + TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 = 0x009E + TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 = 0xC024 + TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 = 0xC028 + TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA = 0xC00A + TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA = 0xC014 + TLS_DHE_RSA_WITH_AES_256_CBC_SHA256 = 0x006B + TLS_DHE_RSA_WITH_AES_256_CBC_SHA = 0x0039 + TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 = 0xC023 + TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 = 0xC027 + TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA = 0xC009 + TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA = 0xC013 + TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 = 0x0067 + TLS_DHE_RSA_WITH_AES_128_CBC_SHA = 0x0033 + TLS_RSA_WITH_AES_256_GCM_SHA384 = 0x009D + TLS_RSA_WITH_AES_128_GCM_SHA256 = 0x009C + TLS_RSA_WITH_AES_256_CBC_SHA256 = 0x003D + TLS_RSA_WITH_AES_128_CBC_SHA256 = 0x003C + TLS_RSA_WITH_AES_256_CBC_SHA = 0x0035 + TLS_RSA_WITH_AES_128_CBC_SHA = 0x002F + TLS_AES_128_GCM_SHA256 = 0x1301 + TLS_AES_256_GCM_SHA384 = 0x1302 + TLS_AES_128_CCM_8_SHA256 = 0x1305 + TLS_AES_128_CCM_SHA256 = 0x1304 diff --git a/openpype/hosts/fusion/vendor/urllib3/contrib/_securetransport/low_level.py b/openpype/hosts/fusion/vendor/urllib3/contrib/_securetransport/low_level.py new file mode 100644 index 0000000000..ed8120190c --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/contrib/_securetransport/low_level.py @@ -0,0 +1,396 @@ +""" +Low-level helpers for the SecureTransport bindings. + +These are Python functions that are not directly related to the high-level APIs +but are necessary to get them to work. They include a whole bunch of low-level +CoreFoundation messing about and memory management. The concerns in this module +are almost entirely about trying to avoid memory leaks and providing +appropriate and useful assistance to the higher-level code. +""" +import base64 +import ctypes +import itertools +import os +import re +import ssl +import struct +import tempfile + +from .bindings import CFConst, CoreFoundation, Security + +# This regular expression is used to grab PEM data out of a PEM bundle. +_PEM_CERTS_RE = re.compile( + b"-----BEGIN CERTIFICATE-----\n(.*?)\n-----END CERTIFICATE-----", re.DOTALL +) + + +def _cf_data_from_bytes(bytestring): + """ + Given a bytestring, create a CFData object from it. This CFData object must + be CFReleased by the caller. + """ + return CoreFoundation.CFDataCreate( + CoreFoundation.kCFAllocatorDefault, bytestring, len(bytestring) + ) + + +def _cf_dictionary_from_tuples(tuples): + """ + Given a list of Python tuples, create an associated CFDictionary. + """ + dictionary_size = len(tuples) + + # We need to get the dictionary keys and values out in the same order. + keys = (t[0] for t in tuples) + values = (t[1] for t in tuples) + cf_keys = (CoreFoundation.CFTypeRef * dictionary_size)(*keys) + cf_values = (CoreFoundation.CFTypeRef * dictionary_size)(*values) + + return CoreFoundation.CFDictionaryCreate( + CoreFoundation.kCFAllocatorDefault, + cf_keys, + cf_values, + dictionary_size, + CoreFoundation.kCFTypeDictionaryKeyCallBacks, + CoreFoundation.kCFTypeDictionaryValueCallBacks, + ) + + +def _cfstr(py_bstr): + """ + Given a Python binary data, create a CFString. + The string must be CFReleased by the caller. + """ + c_str = ctypes.c_char_p(py_bstr) + cf_str = CoreFoundation.CFStringCreateWithCString( + CoreFoundation.kCFAllocatorDefault, + c_str, + CFConst.kCFStringEncodingUTF8, + ) + return cf_str + + +def _create_cfstring_array(lst): + """ + Given a list of Python binary data, create an associated CFMutableArray. + The array must be CFReleased by the caller. + + Raises an ssl.SSLError on failure. + """ + cf_arr = None + try: + cf_arr = CoreFoundation.CFArrayCreateMutable( + CoreFoundation.kCFAllocatorDefault, + 0, + ctypes.byref(CoreFoundation.kCFTypeArrayCallBacks), + ) + if not cf_arr: + raise MemoryError("Unable to allocate memory!") + for item in lst: + cf_str = _cfstr(item) + if not cf_str: + raise MemoryError("Unable to allocate memory!") + try: + CoreFoundation.CFArrayAppendValue(cf_arr, cf_str) + finally: + CoreFoundation.CFRelease(cf_str) + except BaseException as e: + if cf_arr: + CoreFoundation.CFRelease(cf_arr) + raise ssl.SSLError("Unable to allocate array: %s" % (e,)) + return cf_arr + + +def _cf_string_to_unicode(value): + """ + Creates a Unicode string from a CFString object. Used entirely for error + reporting. + + Yes, it annoys me quite a lot that this function is this complex. + """ + value_as_void_p = ctypes.cast(value, ctypes.POINTER(ctypes.c_void_p)) + + string = CoreFoundation.CFStringGetCStringPtr( + value_as_void_p, CFConst.kCFStringEncodingUTF8 + ) + if string is None: + buffer = ctypes.create_string_buffer(1024) + result = CoreFoundation.CFStringGetCString( + value_as_void_p, buffer, 1024, CFConst.kCFStringEncodingUTF8 + ) + if not result: + raise OSError("Error copying C string from CFStringRef") + string = buffer.value + if string is not None: + string = string.decode("utf-8") + return string + + +def _assert_no_error(error, exception_class=None): + """ + Checks the return code and throws an exception if there is an error to + report + """ + if error == 0: + return + + cf_error_string = Security.SecCopyErrorMessageString(error, None) + output = _cf_string_to_unicode(cf_error_string) + CoreFoundation.CFRelease(cf_error_string) + + if output is None or output == u"": + output = u"OSStatus %s" % error + + if exception_class is None: + exception_class = ssl.SSLError + + raise exception_class(output) + + +def _cert_array_from_pem(pem_bundle): + """ + Given a bundle of certs in PEM format, turns them into a CFArray of certs + that can be used to validate a cert chain. + """ + # Normalize the PEM bundle's line endings. + pem_bundle = pem_bundle.replace(b"\r\n", b"\n") + + der_certs = [ + base64.b64decode(match.group(1)) for match in _PEM_CERTS_RE.finditer(pem_bundle) + ] + if not der_certs: + raise ssl.SSLError("No root certificates specified") + + cert_array = CoreFoundation.CFArrayCreateMutable( + CoreFoundation.kCFAllocatorDefault, + 0, + ctypes.byref(CoreFoundation.kCFTypeArrayCallBacks), + ) + if not cert_array: + raise ssl.SSLError("Unable to allocate memory!") + + try: + for der_bytes in der_certs: + certdata = _cf_data_from_bytes(der_bytes) + if not certdata: + raise ssl.SSLError("Unable to allocate memory!") + cert = Security.SecCertificateCreateWithData( + CoreFoundation.kCFAllocatorDefault, certdata + ) + CoreFoundation.CFRelease(certdata) + if not cert: + raise ssl.SSLError("Unable to build cert object!") + + CoreFoundation.CFArrayAppendValue(cert_array, cert) + CoreFoundation.CFRelease(cert) + except Exception: + # We need to free the array before the exception bubbles further. + # We only want to do that if an error occurs: otherwise, the caller + # should free. + CoreFoundation.CFRelease(cert_array) + + return cert_array + + +def _is_cert(item): + """ + Returns True if a given CFTypeRef is a certificate. + """ + expected = Security.SecCertificateGetTypeID() + return CoreFoundation.CFGetTypeID(item) == expected + + +def _is_identity(item): + """ + Returns True if a given CFTypeRef is an identity. + """ + expected = Security.SecIdentityGetTypeID() + return CoreFoundation.CFGetTypeID(item) == expected + + +def _temporary_keychain(): + """ + This function creates a temporary Mac keychain that we can use to work with + credentials. This keychain uses a one-time password and a temporary file to + store the data. We expect to have one keychain per socket. The returned + SecKeychainRef must be freed by the caller, including calling + SecKeychainDelete. + + Returns a tuple of the SecKeychainRef and the path to the temporary + directory that contains it. + """ + # Unfortunately, SecKeychainCreate requires a path to a keychain. This + # means we cannot use mkstemp to use a generic temporary file. Instead, + # we're going to create a temporary directory and a filename to use there. + # This filename will be 8 random bytes expanded into base64. We also need + # some random bytes to password-protect the keychain we're creating, so we + # ask for 40 random bytes. + random_bytes = os.urandom(40) + filename = base64.b16encode(random_bytes[:8]).decode("utf-8") + password = base64.b16encode(random_bytes[8:]) # Must be valid UTF-8 + tempdirectory = tempfile.mkdtemp() + + keychain_path = os.path.join(tempdirectory, filename).encode("utf-8") + + # We now want to create the keychain itself. + keychain = Security.SecKeychainRef() + status = Security.SecKeychainCreate( + keychain_path, len(password), password, False, None, ctypes.byref(keychain) + ) + _assert_no_error(status) + + # Having created the keychain, we want to pass it off to the caller. + return keychain, tempdirectory + + +def _load_items_from_file(keychain, path): + """ + Given a single file, loads all the trust objects from it into arrays and + the keychain. + Returns a tuple of lists: the first list is a list of identities, the + second a list of certs. + """ + certificates = [] + identities = [] + result_array = None + + with open(path, "rb") as f: + raw_filedata = f.read() + + try: + filedata = CoreFoundation.CFDataCreate( + CoreFoundation.kCFAllocatorDefault, raw_filedata, len(raw_filedata) + ) + result_array = CoreFoundation.CFArrayRef() + result = Security.SecItemImport( + filedata, # cert data + None, # Filename, leaving it out for now + None, # What the type of the file is, we don't care + None, # what's in the file, we don't care + 0, # import flags + None, # key params, can include passphrase in the future + keychain, # The keychain to insert into + ctypes.byref(result_array), # Results + ) + _assert_no_error(result) + + # A CFArray is not very useful to us as an intermediary + # representation, so we are going to extract the objects we want + # and then free the array. We don't need to keep hold of keys: the + # keychain already has them! + result_count = CoreFoundation.CFArrayGetCount(result_array) + for index in range(result_count): + item = CoreFoundation.CFArrayGetValueAtIndex(result_array, index) + item = ctypes.cast(item, CoreFoundation.CFTypeRef) + + if _is_cert(item): + CoreFoundation.CFRetain(item) + certificates.append(item) + elif _is_identity(item): + CoreFoundation.CFRetain(item) + identities.append(item) + finally: + if result_array: + CoreFoundation.CFRelease(result_array) + + CoreFoundation.CFRelease(filedata) + + return (identities, certificates) + + +def _load_client_cert_chain(keychain, *paths): + """ + Load certificates and maybe keys from a number of files. Has the end goal + of returning a CFArray containing one SecIdentityRef, and then zero or more + SecCertificateRef objects, suitable for use as a client certificate trust + chain. + """ + # Ok, the strategy. + # + # This relies on knowing that macOS will not give you a SecIdentityRef + # unless you have imported a key into a keychain. This is a somewhat + # artificial limitation of macOS (for example, it doesn't necessarily + # affect iOS), but there is nothing inside Security.framework that lets you + # get a SecIdentityRef without having a key in a keychain. + # + # So the policy here is we take all the files and iterate them in order. + # Each one will use SecItemImport to have one or more objects loaded from + # it. We will also point at a keychain that macOS can use to work with the + # private key. + # + # Once we have all the objects, we'll check what we actually have. If we + # already have a SecIdentityRef in hand, fab: we'll use that. Otherwise, + # we'll take the first certificate (which we assume to be our leaf) and + # ask the keychain to give us a SecIdentityRef with that cert's associated + # key. + # + # We'll then return a CFArray containing the trust chain: one + # SecIdentityRef and then zero-or-more SecCertificateRef objects. The + # responsibility for freeing this CFArray will be with the caller. This + # CFArray must remain alive for the entire connection, so in practice it + # will be stored with a single SSLSocket, along with the reference to the + # keychain. + certificates = [] + identities = [] + + # Filter out bad paths. + paths = (path for path in paths if path) + + try: + for file_path in paths: + new_identities, new_certs = _load_items_from_file(keychain, file_path) + identities.extend(new_identities) + certificates.extend(new_certs) + + # Ok, we have everything. The question is: do we have an identity? If + # not, we want to grab one from the first cert we have. + if not identities: + new_identity = Security.SecIdentityRef() + status = Security.SecIdentityCreateWithCertificate( + keychain, certificates[0], ctypes.byref(new_identity) + ) + _assert_no_error(status) + identities.append(new_identity) + + # We now want to release the original certificate, as we no longer + # need it. + CoreFoundation.CFRelease(certificates.pop(0)) + + # We now need to build a new CFArray that holds the trust chain. + trust_chain = CoreFoundation.CFArrayCreateMutable( + CoreFoundation.kCFAllocatorDefault, + 0, + ctypes.byref(CoreFoundation.kCFTypeArrayCallBacks), + ) + for item in itertools.chain(identities, certificates): + # ArrayAppendValue does a CFRetain on the item. That's fine, + # because the finally block will release our other refs to them. + CoreFoundation.CFArrayAppendValue(trust_chain, item) + + return trust_chain + finally: + for obj in itertools.chain(identities, certificates): + CoreFoundation.CFRelease(obj) + + +TLS_PROTOCOL_VERSIONS = { + "SSLv2": (0, 2), + "SSLv3": (3, 0), + "TLSv1": (3, 1), + "TLSv1.1": (3, 2), + "TLSv1.2": (3, 3), +} + + +def _build_tls_unknown_ca_alert(version): + """ + Builds a TLS alert record for an unknown CA. + """ + ver_maj, ver_min = TLS_PROTOCOL_VERSIONS[version] + severity_fatal = 0x02 + description_unknown_ca = 0x30 + msg = struct.pack(">BB", severity_fatal, description_unknown_ca) + msg_len = len(msg) + record_type_alert = 0x15 + record = struct.pack(">BBBH", record_type_alert, ver_maj, ver_min, msg_len) + msg + return record diff --git a/openpype/hosts/fusion/vendor/urllib3/contrib/appengine.py b/openpype/hosts/fusion/vendor/urllib3/contrib/appengine.py new file mode 100644 index 0000000000..f91bdd6e77 --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/contrib/appengine.py @@ -0,0 +1,314 @@ +""" +This module provides a pool manager that uses Google App Engine's +`URLFetch Service `_. + +Example usage:: + + from urllib3 import PoolManager + from urllib3.contrib.appengine import AppEngineManager, is_appengine_sandbox + + if is_appengine_sandbox(): + # AppEngineManager uses AppEngine's URLFetch API behind the scenes + http = AppEngineManager() + else: + # PoolManager uses a socket-level API behind the scenes + http = PoolManager() + + r = http.request('GET', 'https://google.com/') + +There are `limitations `_ to the URLFetch service and it may not be +the best choice for your application. There are three options for using +urllib3 on Google App Engine: + +1. You can use :class:`AppEngineManager` with URLFetch. URLFetch is + cost-effective in many circumstances as long as your usage is within the + limitations. +2. You can use a normal :class:`~urllib3.PoolManager` by enabling sockets. + Sockets also have `limitations and restrictions + `_ and have a lower free quota than URLFetch. + To use sockets, be sure to specify the following in your ``app.yaml``:: + + env_variables: + GAE_USE_SOCKETS_HTTPLIB : 'true' + +3. If you are using `App Engine Flexible +`_, you can use the standard +:class:`PoolManager` without any configuration or special environment variables. +""" + +from __future__ import absolute_import + +import io +import logging +import warnings + +from ..exceptions import ( + HTTPError, + HTTPWarning, + MaxRetryError, + ProtocolError, + SSLError, + TimeoutError, +) +from ..packages.six.moves.urllib.parse import urljoin +from ..request import RequestMethods +from ..response import HTTPResponse +from ..util.retry import Retry +from ..util.timeout import Timeout +from . import _appengine_environ + +try: + from google.appengine.api import urlfetch +except ImportError: + urlfetch = None + + +log = logging.getLogger(__name__) + + +class AppEnginePlatformWarning(HTTPWarning): + pass + + +class AppEnginePlatformError(HTTPError): + pass + + +class AppEngineManager(RequestMethods): + """ + Connection manager for Google App Engine sandbox applications. + + This manager uses the URLFetch service directly instead of using the + emulated httplib, and is subject to URLFetch limitations as described in + the App Engine documentation `here + `_. + + Notably it will raise an :class:`AppEnginePlatformError` if: + * URLFetch is not available. + * If you attempt to use this on App Engine Flexible, as full socket + support is available. + * If a request size is more than 10 megabytes. + * If a response size is more than 32 megabytes. + * If you use an unsupported request method such as OPTIONS. + + Beyond those cases, it will raise normal urllib3 errors. + """ + + def __init__( + self, + headers=None, + retries=None, + validate_certificate=True, + urlfetch_retries=True, + ): + if not urlfetch: + raise AppEnginePlatformError( + "URLFetch is not available in this environment." + ) + + warnings.warn( + "urllib3 is using URLFetch on Google App Engine sandbox instead " + "of sockets. To use sockets directly instead of URLFetch see " + "https://urllib3.readthedocs.io/en/1.26.x/reference/urllib3.contrib.html.", + AppEnginePlatformWarning, + ) + + RequestMethods.__init__(self, headers) + self.validate_certificate = validate_certificate + self.urlfetch_retries = urlfetch_retries + + self.retries = retries or Retry.DEFAULT + + def __enter__(self): + return self + + def __exit__(self, exc_type, exc_val, exc_tb): + # Return False to re-raise any potential exceptions + return False + + def urlopen( + self, + method, + url, + body=None, + headers=None, + retries=None, + redirect=True, + timeout=Timeout.DEFAULT_TIMEOUT, + **response_kw + ): + + retries = self._get_retries(retries, redirect) + + try: + follow_redirects = redirect and retries.redirect != 0 and retries.total + response = urlfetch.fetch( + url, + payload=body, + method=method, + headers=headers or {}, + allow_truncated=False, + follow_redirects=self.urlfetch_retries and follow_redirects, + deadline=self._get_absolute_timeout(timeout), + validate_certificate=self.validate_certificate, + ) + except urlfetch.DeadlineExceededError as e: + raise TimeoutError(self, e) + + except urlfetch.InvalidURLError as e: + if "too large" in str(e): + raise AppEnginePlatformError( + "URLFetch request too large, URLFetch only " + "supports requests up to 10mb in size.", + e, + ) + raise ProtocolError(e) + + except urlfetch.DownloadError as e: + if "Too many redirects" in str(e): + raise MaxRetryError(self, url, reason=e) + raise ProtocolError(e) + + except urlfetch.ResponseTooLargeError as e: + raise AppEnginePlatformError( + "URLFetch response too large, URLFetch only supports" + "responses up to 32mb in size.", + e, + ) + + except urlfetch.SSLCertificateError as e: + raise SSLError(e) + + except urlfetch.InvalidMethodError as e: + raise AppEnginePlatformError( + "URLFetch does not support method: %s" % method, e + ) + + http_response = self._urlfetch_response_to_http_response( + response, retries=retries, **response_kw + ) + + # Handle redirect? + redirect_location = redirect and http_response.get_redirect_location() + if redirect_location: + # Check for redirect response + if self.urlfetch_retries and retries.raise_on_redirect: + raise MaxRetryError(self, url, "too many redirects") + else: + if http_response.status == 303: + method = "GET" + + try: + retries = retries.increment( + method, url, response=http_response, _pool=self + ) + except MaxRetryError: + if retries.raise_on_redirect: + raise MaxRetryError(self, url, "too many redirects") + return http_response + + retries.sleep_for_retry(http_response) + log.debug("Redirecting %s -> %s", url, redirect_location) + redirect_url = urljoin(url, redirect_location) + return self.urlopen( + method, + redirect_url, + body, + headers, + retries=retries, + redirect=redirect, + timeout=timeout, + **response_kw + ) + + # Check if we should retry the HTTP response. + has_retry_after = bool(http_response.getheader("Retry-After")) + if retries.is_retry(method, http_response.status, has_retry_after): + retries = retries.increment(method, url, response=http_response, _pool=self) + log.debug("Retry: %s", url) + retries.sleep(http_response) + return self.urlopen( + method, + url, + body=body, + headers=headers, + retries=retries, + redirect=redirect, + timeout=timeout, + **response_kw + ) + + return http_response + + def _urlfetch_response_to_http_response(self, urlfetch_resp, **response_kw): + + if is_prod_appengine(): + # Production GAE handles deflate encoding automatically, but does + # not remove the encoding header. + content_encoding = urlfetch_resp.headers.get("content-encoding") + + if content_encoding == "deflate": + del urlfetch_resp.headers["content-encoding"] + + transfer_encoding = urlfetch_resp.headers.get("transfer-encoding") + # We have a full response's content, + # so let's make sure we don't report ourselves as chunked data. + if transfer_encoding == "chunked": + encodings = transfer_encoding.split(",") + encodings.remove("chunked") + urlfetch_resp.headers["transfer-encoding"] = ",".join(encodings) + + original_response = HTTPResponse( + # In order for decoding to work, we must present the content as + # a file-like object. + body=io.BytesIO(urlfetch_resp.content), + msg=urlfetch_resp.header_msg, + headers=urlfetch_resp.headers, + status=urlfetch_resp.status_code, + **response_kw + ) + + return HTTPResponse( + body=io.BytesIO(urlfetch_resp.content), + headers=urlfetch_resp.headers, + status=urlfetch_resp.status_code, + original_response=original_response, + **response_kw + ) + + def _get_absolute_timeout(self, timeout): + if timeout is Timeout.DEFAULT_TIMEOUT: + return None # Defer to URLFetch's default. + if isinstance(timeout, Timeout): + if timeout._read is not None or timeout._connect is not None: + warnings.warn( + "URLFetch does not support granular timeout settings, " + "reverting to total or default URLFetch timeout.", + AppEnginePlatformWarning, + ) + return timeout.total + return timeout + + def _get_retries(self, retries, redirect): + if not isinstance(retries, Retry): + retries = Retry.from_int(retries, redirect=redirect, default=self.retries) + + if retries.connect or retries.read or retries.redirect: + warnings.warn( + "URLFetch only supports total retries and does not " + "recognize connect, read, or redirect retry parameters.", + AppEnginePlatformWarning, + ) + + return retries + + +# Alias methods from _appengine_environ to maintain public API interface. + +is_appengine = _appengine_environ.is_appengine +is_appengine_sandbox = _appengine_environ.is_appengine_sandbox +is_local_appengine = _appengine_environ.is_local_appengine +is_prod_appengine = _appengine_environ.is_prod_appengine +is_prod_appengine_mvms = _appengine_environ.is_prod_appengine_mvms diff --git a/openpype/hosts/fusion/vendor/urllib3/contrib/ntlmpool.py b/openpype/hosts/fusion/vendor/urllib3/contrib/ntlmpool.py new file mode 100644 index 0000000000..41a8fd174c --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/contrib/ntlmpool.py @@ -0,0 +1,130 @@ +""" +NTLM authenticating pool, contributed by erikcederstran + +Issue #10, see: http://code.google.com/p/urllib3/issues/detail?id=10 +""" +from __future__ import absolute_import + +import warnings +from logging import getLogger + +from ntlm import ntlm + +from .. import HTTPSConnectionPool +from ..packages.six.moves.http_client import HTTPSConnection + +warnings.warn( + "The 'urllib3.contrib.ntlmpool' module is deprecated and will be removed " + "in urllib3 v2.0 release, urllib3 is not able to support it properly due " + "to reasons listed in issue: https://github.com/urllib3/urllib3/issues/2282. " + "If you are a user of this module please comment in the mentioned issue.", + DeprecationWarning, +) + +log = getLogger(__name__) + + +class NTLMConnectionPool(HTTPSConnectionPool): + """ + Implements an NTLM authentication version of an urllib3 connection pool + """ + + scheme = "https" + + def __init__(self, user, pw, authurl, *args, **kwargs): + """ + authurl is a random URL on the server that is protected by NTLM. + user is the Windows user, probably in the DOMAIN\\username format. + pw is the password for the user. + """ + super(NTLMConnectionPool, self).__init__(*args, **kwargs) + self.authurl = authurl + self.rawuser = user + user_parts = user.split("\\", 1) + self.domain = user_parts[0].upper() + self.user = user_parts[1] + self.pw = pw + + def _new_conn(self): + # Performs the NTLM handshake that secures the connection. The socket + # must be kept open while requests are performed. + self.num_connections += 1 + log.debug( + "Starting NTLM HTTPS connection no. %d: https://%s%s", + self.num_connections, + self.host, + self.authurl, + ) + + headers = {"Connection": "Keep-Alive"} + req_header = "Authorization" + resp_header = "www-authenticate" + + conn = HTTPSConnection(host=self.host, port=self.port) + + # Send negotiation message + headers[req_header] = "NTLM %s" % ntlm.create_NTLM_NEGOTIATE_MESSAGE( + self.rawuser + ) + log.debug("Request headers: %s", headers) + conn.request("GET", self.authurl, None, headers) + res = conn.getresponse() + reshdr = dict(res.getheaders()) + log.debug("Response status: %s %s", res.status, res.reason) + log.debug("Response headers: %s", reshdr) + log.debug("Response data: %s [...]", res.read(100)) + + # Remove the reference to the socket, so that it can not be closed by + # the response object (we want to keep the socket open) + res.fp = None + + # Server should respond with a challenge message + auth_header_values = reshdr[resp_header].split(", ") + auth_header_value = None + for s in auth_header_values: + if s[:5] == "NTLM ": + auth_header_value = s[5:] + if auth_header_value is None: + raise Exception( + "Unexpected %s response header: %s" % (resp_header, reshdr[resp_header]) + ) + + # Send authentication message + ServerChallenge, NegotiateFlags = ntlm.parse_NTLM_CHALLENGE_MESSAGE( + auth_header_value + ) + auth_msg = ntlm.create_NTLM_AUTHENTICATE_MESSAGE( + ServerChallenge, self.user, self.domain, self.pw, NegotiateFlags + ) + headers[req_header] = "NTLM %s" % auth_msg + log.debug("Request headers: %s", headers) + conn.request("GET", self.authurl, None, headers) + res = conn.getresponse() + log.debug("Response status: %s %s", res.status, res.reason) + log.debug("Response headers: %s", dict(res.getheaders())) + log.debug("Response data: %s [...]", res.read()[:100]) + if res.status != 200: + if res.status == 401: + raise Exception("Server rejected request: wrong username or password") + raise Exception("Wrong server response: %s %s" % (res.status, res.reason)) + + res.fp = None + log.debug("Connection established") + return conn + + def urlopen( + self, + method, + url, + body=None, + headers=None, + retries=3, + redirect=True, + assert_same_host=True, + ): + if headers is None: + headers = {} + headers["Connection"] = "Keep-Alive" + return super(NTLMConnectionPool, self).urlopen( + method, url, body, headers, retries, redirect, assert_same_host + ) diff --git a/openpype/hosts/fusion/vendor/urllib3/contrib/pyopenssl.py b/openpype/hosts/fusion/vendor/urllib3/contrib/pyopenssl.py new file mode 100644 index 0000000000..def83afdb2 --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/contrib/pyopenssl.py @@ -0,0 +1,511 @@ +""" +TLS with SNI_-support for Python 2. Follow these instructions if you would +like to verify TLS certificates in Python 2. Note, the default libraries do +*not* do certificate checking; you need to do additional work to validate +certificates yourself. + +This needs the following packages installed: + +* `pyOpenSSL`_ (tested with 16.0.0) +* `cryptography`_ (minimum 1.3.4, from pyopenssl) +* `idna`_ (minimum 2.0, from cryptography) + +However, pyopenssl depends on cryptography, which depends on idna, so while we +use all three directly here we end up having relatively few packages required. + +You can install them with the following command: + +.. code-block:: bash + + $ python -m pip install pyopenssl cryptography idna + +To activate certificate checking, call +:func:`~urllib3.contrib.pyopenssl.inject_into_urllib3` from your Python code +before you begin making HTTP requests. This can be done in a ``sitecustomize`` +module, or at any other time before your application begins using ``urllib3``, +like this: + +.. code-block:: python + + try: + import urllib3.contrib.pyopenssl + urllib3.contrib.pyopenssl.inject_into_urllib3() + except ImportError: + pass + +Now you can use :mod:`urllib3` as you normally would, and it will support SNI +when the required modules are installed. + +Activating this module also has the positive side effect of disabling SSL/TLS +compression in Python 2 (see `CRIME attack`_). + +.. _sni: https://en.wikipedia.org/wiki/Server_Name_Indication +.. _crime attack: https://en.wikipedia.org/wiki/CRIME_(security_exploit) +.. _pyopenssl: https://www.pyopenssl.org +.. _cryptography: https://cryptography.io +.. _idna: https://github.com/kjd/idna +""" +from __future__ import absolute_import + +import OpenSSL.SSL +from cryptography import x509 +from cryptography.hazmat.backends.openssl import backend as openssl_backend +from cryptography.hazmat.backends.openssl.x509 import _Certificate + +try: + from cryptography.x509 import UnsupportedExtension +except ImportError: + # UnsupportedExtension is gone in cryptography >= 2.1.0 + class UnsupportedExtension(Exception): + pass + + +from io import BytesIO +from socket import error as SocketError +from socket import timeout + +try: # Platform-specific: Python 2 + from socket import _fileobject +except ImportError: # Platform-specific: Python 3 + _fileobject = None + from ..packages.backports.makefile import backport_makefile + +import logging +import ssl +import sys + +from .. import util +from ..packages import six +from ..util.ssl_ import PROTOCOL_TLS_CLIENT + +__all__ = ["inject_into_urllib3", "extract_from_urllib3"] + +# SNI always works. +HAS_SNI = True + +# Map from urllib3 to PyOpenSSL compatible parameter-values. +_openssl_versions = { + util.PROTOCOL_TLS: OpenSSL.SSL.SSLv23_METHOD, + PROTOCOL_TLS_CLIENT: OpenSSL.SSL.SSLv23_METHOD, + ssl.PROTOCOL_TLSv1: OpenSSL.SSL.TLSv1_METHOD, +} + +if hasattr(ssl, "PROTOCOL_SSLv3") and hasattr(OpenSSL.SSL, "SSLv3_METHOD"): + _openssl_versions[ssl.PROTOCOL_SSLv3] = OpenSSL.SSL.SSLv3_METHOD + +if hasattr(ssl, "PROTOCOL_TLSv1_1") and hasattr(OpenSSL.SSL, "TLSv1_1_METHOD"): + _openssl_versions[ssl.PROTOCOL_TLSv1_1] = OpenSSL.SSL.TLSv1_1_METHOD + +if hasattr(ssl, "PROTOCOL_TLSv1_2") and hasattr(OpenSSL.SSL, "TLSv1_2_METHOD"): + _openssl_versions[ssl.PROTOCOL_TLSv1_2] = OpenSSL.SSL.TLSv1_2_METHOD + + +_stdlib_to_openssl_verify = { + ssl.CERT_NONE: OpenSSL.SSL.VERIFY_NONE, + ssl.CERT_OPTIONAL: OpenSSL.SSL.VERIFY_PEER, + ssl.CERT_REQUIRED: OpenSSL.SSL.VERIFY_PEER + + OpenSSL.SSL.VERIFY_FAIL_IF_NO_PEER_CERT, +} +_openssl_to_stdlib_verify = dict((v, k) for k, v in _stdlib_to_openssl_verify.items()) + +# OpenSSL will only write 16K at a time +SSL_WRITE_BLOCKSIZE = 16384 + +orig_util_HAS_SNI = util.HAS_SNI +orig_util_SSLContext = util.ssl_.SSLContext + + +log = logging.getLogger(__name__) + + +def inject_into_urllib3(): + "Monkey-patch urllib3 with PyOpenSSL-backed SSL-support." + + _validate_dependencies_met() + + util.SSLContext = PyOpenSSLContext + util.ssl_.SSLContext = PyOpenSSLContext + util.HAS_SNI = HAS_SNI + util.ssl_.HAS_SNI = HAS_SNI + util.IS_PYOPENSSL = True + util.ssl_.IS_PYOPENSSL = True + + +def extract_from_urllib3(): + "Undo monkey-patching by :func:`inject_into_urllib3`." + + util.SSLContext = orig_util_SSLContext + util.ssl_.SSLContext = orig_util_SSLContext + util.HAS_SNI = orig_util_HAS_SNI + util.ssl_.HAS_SNI = orig_util_HAS_SNI + util.IS_PYOPENSSL = False + util.ssl_.IS_PYOPENSSL = False + + +def _validate_dependencies_met(): + """ + Verifies that PyOpenSSL's package-level dependencies have been met. + Throws `ImportError` if they are not met. + """ + # Method added in `cryptography==1.1`; not available in older versions + from cryptography.x509.extensions import Extensions + + if getattr(Extensions, "get_extension_for_class", None) is None: + raise ImportError( + "'cryptography' module missing required functionality. " + "Try upgrading to v1.3.4 or newer." + ) + + # pyOpenSSL 0.14 and above use cryptography for OpenSSL bindings. The _x509 + # attribute is only present on those versions. + from OpenSSL.crypto import X509 + + x509 = X509() + if getattr(x509, "_x509", None) is None: + raise ImportError( + "'pyOpenSSL' module missing required functionality. " + "Try upgrading to v0.14 or newer." + ) + + +def _dnsname_to_stdlib(name): + """ + Converts a dNSName SubjectAlternativeName field to the form used by the + standard library on the given Python version. + + Cryptography produces a dNSName as a unicode string that was idna-decoded + from ASCII bytes. We need to idna-encode that string to get it back, and + then on Python 3 we also need to convert to unicode via UTF-8 (the stdlib + uses PyUnicode_FromStringAndSize on it, which decodes via UTF-8). + + If the name cannot be idna-encoded then we return None signalling that + the name given should be skipped. + """ + + def idna_encode(name): + """ + Borrowed wholesale from the Python Cryptography Project. It turns out + that we can't just safely call `idna.encode`: it can explode for + wildcard names. This avoids that problem. + """ + import idna + + try: + for prefix in [u"*.", u"."]: + if name.startswith(prefix): + name = name[len(prefix) :] + return prefix.encode("ascii") + idna.encode(name) + return idna.encode(name) + except idna.core.IDNAError: + return None + + # Don't send IPv6 addresses through the IDNA encoder. + if ":" in name: + return name + + name = idna_encode(name) + if name is None: + return None + elif sys.version_info >= (3, 0): + name = name.decode("utf-8") + return name + + +def get_subj_alt_name(peer_cert): + """ + Given an PyOpenSSL certificate, provides all the subject alternative names. + """ + # Pass the cert to cryptography, which has much better APIs for this. + if hasattr(peer_cert, "to_cryptography"): + cert = peer_cert.to_cryptography() + else: + # This is technically using private APIs, but should work across all + # relevant versions before PyOpenSSL got a proper API for this. + cert = _Certificate(openssl_backend, peer_cert._x509) + + # We want to find the SAN extension. Ask Cryptography to locate it (it's + # faster than looping in Python) + try: + ext = cert.extensions.get_extension_for_class(x509.SubjectAlternativeName).value + except x509.ExtensionNotFound: + # No such extension, return the empty list. + return [] + except ( + x509.DuplicateExtension, + UnsupportedExtension, + x509.UnsupportedGeneralNameType, + UnicodeError, + ) as e: + # A problem has been found with the quality of the certificate. Assume + # no SAN field is present. + log.warning( + "A problem was encountered with the certificate that prevented " + "urllib3 from finding the SubjectAlternativeName field. This can " + "affect certificate validation. The error was %s", + e, + ) + return [] + + # We want to return dNSName and iPAddress fields. We need to cast the IPs + # back to strings because the match_hostname function wants them as + # strings. + # Sadly the DNS names need to be idna encoded and then, on Python 3, UTF-8 + # decoded. This is pretty frustrating, but that's what the standard library + # does with certificates, and so we need to attempt to do the same. + # We also want to skip over names which cannot be idna encoded. + names = [ + ("DNS", name) + for name in map(_dnsname_to_stdlib, ext.get_values_for_type(x509.DNSName)) + if name is not None + ] + names.extend( + ("IP Address", str(name)) for name in ext.get_values_for_type(x509.IPAddress) + ) + + return names + + +class WrappedSocket(object): + """API-compatibility wrapper for Python OpenSSL's Connection-class. + + Note: _makefile_refs, _drop() and _reuse() are needed for the garbage + collector of pypy. + """ + + def __init__(self, connection, socket, suppress_ragged_eofs=True): + self.connection = connection + self.socket = socket + self.suppress_ragged_eofs = suppress_ragged_eofs + self._makefile_refs = 0 + self._closed = False + + def fileno(self): + return self.socket.fileno() + + # Copy-pasted from Python 3.5 source code + def _decref_socketios(self): + if self._makefile_refs > 0: + self._makefile_refs -= 1 + if self._closed: + self.close() + + def recv(self, *args, **kwargs): + try: + data = self.connection.recv(*args, **kwargs) + except OpenSSL.SSL.SysCallError as e: + if self.suppress_ragged_eofs and e.args == (-1, "Unexpected EOF"): + return b"" + else: + raise SocketError(str(e)) + except OpenSSL.SSL.ZeroReturnError: + if self.connection.get_shutdown() == OpenSSL.SSL.RECEIVED_SHUTDOWN: + return b"" + else: + raise + except OpenSSL.SSL.WantReadError: + if not util.wait_for_read(self.socket, self.socket.gettimeout()): + raise timeout("The read operation timed out") + else: + return self.recv(*args, **kwargs) + + # TLS 1.3 post-handshake authentication + except OpenSSL.SSL.Error as e: + raise ssl.SSLError("read error: %r" % e) + else: + return data + + def recv_into(self, *args, **kwargs): + try: + return self.connection.recv_into(*args, **kwargs) + except OpenSSL.SSL.SysCallError as e: + if self.suppress_ragged_eofs and e.args == (-1, "Unexpected EOF"): + return 0 + else: + raise SocketError(str(e)) + except OpenSSL.SSL.ZeroReturnError: + if self.connection.get_shutdown() == OpenSSL.SSL.RECEIVED_SHUTDOWN: + return 0 + else: + raise + except OpenSSL.SSL.WantReadError: + if not util.wait_for_read(self.socket, self.socket.gettimeout()): + raise timeout("The read operation timed out") + else: + return self.recv_into(*args, **kwargs) + + # TLS 1.3 post-handshake authentication + except OpenSSL.SSL.Error as e: + raise ssl.SSLError("read error: %r" % e) + + def settimeout(self, timeout): + return self.socket.settimeout(timeout) + + def _send_until_done(self, data): + while True: + try: + return self.connection.send(data) + except OpenSSL.SSL.WantWriteError: + if not util.wait_for_write(self.socket, self.socket.gettimeout()): + raise timeout() + continue + except OpenSSL.SSL.SysCallError as e: + raise SocketError(str(e)) + + def sendall(self, data): + total_sent = 0 + while total_sent < len(data): + sent = self._send_until_done( + data[total_sent : total_sent + SSL_WRITE_BLOCKSIZE] + ) + total_sent += sent + + def shutdown(self): + # FIXME rethrow compatible exceptions should we ever use this + self.connection.shutdown() + + def close(self): + if self._makefile_refs < 1: + try: + self._closed = True + return self.connection.close() + except OpenSSL.SSL.Error: + return + else: + self._makefile_refs -= 1 + + def getpeercert(self, binary_form=False): + x509 = self.connection.get_peer_certificate() + + if not x509: + return x509 + + if binary_form: + return OpenSSL.crypto.dump_certificate(OpenSSL.crypto.FILETYPE_ASN1, x509) + + return { + "subject": ((("commonName", x509.get_subject().CN),),), + "subjectAltName": get_subj_alt_name(x509), + } + + def version(self): + return self.connection.get_protocol_version_name() + + def _reuse(self): + self._makefile_refs += 1 + + def _drop(self): + if self._makefile_refs < 1: + self.close() + else: + self._makefile_refs -= 1 + + +if _fileobject: # Platform-specific: Python 2 + + def makefile(self, mode, bufsize=-1): + self._makefile_refs += 1 + return _fileobject(self, mode, bufsize, close=True) + + +else: # Platform-specific: Python 3 + makefile = backport_makefile + +WrappedSocket.makefile = makefile + + +class PyOpenSSLContext(object): + """ + I am a wrapper class for the PyOpenSSL ``Context`` object. I am responsible + for translating the interface of the standard library ``SSLContext`` object + to calls into PyOpenSSL. + """ + + def __init__(self, protocol): + self.protocol = _openssl_versions[protocol] + self._ctx = OpenSSL.SSL.Context(self.protocol) + self._options = 0 + self.check_hostname = False + + @property + def options(self): + return self._options + + @options.setter + def options(self, value): + self._options = value + self._ctx.set_options(value) + + @property + def verify_mode(self): + return _openssl_to_stdlib_verify[self._ctx.get_verify_mode()] + + @verify_mode.setter + def verify_mode(self, value): + self._ctx.set_verify(_stdlib_to_openssl_verify[value], _verify_callback) + + def set_default_verify_paths(self): + self._ctx.set_default_verify_paths() + + def set_ciphers(self, ciphers): + if isinstance(ciphers, six.text_type): + ciphers = ciphers.encode("utf-8") + self._ctx.set_cipher_list(ciphers) + + def load_verify_locations(self, cafile=None, capath=None, cadata=None): + if cafile is not None: + cafile = cafile.encode("utf-8") + if capath is not None: + capath = capath.encode("utf-8") + try: + self._ctx.load_verify_locations(cafile, capath) + if cadata is not None: + self._ctx.load_verify_locations(BytesIO(cadata)) + except OpenSSL.SSL.Error as e: + raise ssl.SSLError("unable to load trusted certificates: %r" % e) + + def load_cert_chain(self, certfile, keyfile=None, password=None): + self._ctx.use_certificate_chain_file(certfile) + if password is not None: + if not isinstance(password, six.binary_type): + password = password.encode("utf-8") + self._ctx.set_passwd_cb(lambda *_: password) + self._ctx.use_privatekey_file(keyfile or certfile) + + def set_alpn_protocols(self, protocols): + protocols = [six.ensure_binary(p) for p in protocols] + return self._ctx.set_alpn_protos(protocols) + + def wrap_socket( + self, + sock, + server_side=False, + do_handshake_on_connect=True, + suppress_ragged_eofs=True, + server_hostname=None, + ): + cnx = OpenSSL.SSL.Connection(self._ctx, sock) + + if isinstance(server_hostname, six.text_type): # Platform-specific: Python 3 + server_hostname = server_hostname.encode("utf-8") + + if server_hostname is not None: + cnx.set_tlsext_host_name(server_hostname) + + cnx.set_connect_state() + + while True: + try: + cnx.do_handshake() + except OpenSSL.SSL.WantReadError: + if not util.wait_for_read(sock, sock.gettimeout()): + raise timeout("select timed out") + continue + except OpenSSL.SSL.Error as e: + raise ssl.SSLError("bad handshake: %r" % e) + break + + return WrappedSocket(cnx, sock) + + +def _verify_callback(cnx, x509, err_no, err_depth, return_code): + return err_no == 0 diff --git a/openpype/hosts/fusion/vendor/urllib3/contrib/securetransport.py b/openpype/hosts/fusion/vendor/urllib3/contrib/securetransport.py new file mode 100644 index 0000000000..554c015fed --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/contrib/securetransport.py @@ -0,0 +1,922 @@ +""" +SecureTranport support for urllib3 via ctypes. + +This makes platform-native TLS available to urllib3 users on macOS without the +use of a compiler. This is an important feature because the Python Package +Index is moving to become a TLSv1.2-or-higher server, and the default OpenSSL +that ships with macOS is not capable of doing TLSv1.2. The only way to resolve +this is to give macOS users an alternative solution to the problem, and that +solution is to use SecureTransport. + +We use ctypes here because this solution must not require a compiler. That's +because pip is not allowed to require a compiler either. + +This is not intended to be a seriously long-term solution to this problem. +The hope is that PEP 543 will eventually solve this issue for us, at which +point we can retire this contrib module. But in the short term, we need to +solve the impending tire fire that is Python on Mac without this kind of +contrib module. So...here we are. + +To use this module, simply import and inject it:: + + import urllib3.contrib.securetransport + urllib3.contrib.securetransport.inject_into_urllib3() + +Happy TLSing! + +This code is a bastardised version of the code found in Will Bond's oscrypto +library. An enormous debt is owed to him for blazing this trail for us. For +that reason, this code should be considered to be covered both by urllib3's +license and by oscrypto's: + +.. code-block:: + + Copyright (c) 2015-2016 Will Bond + + Permission is hereby granted, free of charge, to any person obtaining a + copy of this software and associated documentation files (the "Software"), + to deal in the Software without restriction, including without limitation + the rights to use, copy, modify, merge, publish, distribute, sublicense, + and/or sell copies of the Software, and to permit persons to whom the + Software is furnished to do so, subject to the following conditions: + + The above copyright notice and this permission notice shall be included in + all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING + FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER + DEALINGS IN THE SOFTWARE. +""" +from __future__ import absolute_import + +import contextlib +import ctypes +import errno +import os.path +import shutil +import socket +import ssl +import struct +import threading +import weakref + +import six + +from .. import util +from ..util.ssl_ import PROTOCOL_TLS_CLIENT +from ._securetransport.bindings import CoreFoundation, Security, SecurityConst +from ._securetransport.low_level import ( + _assert_no_error, + _build_tls_unknown_ca_alert, + _cert_array_from_pem, + _create_cfstring_array, + _load_client_cert_chain, + _temporary_keychain, +) + +try: # Platform-specific: Python 2 + from socket import _fileobject +except ImportError: # Platform-specific: Python 3 + _fileobject = None + from ..packages.backports.makefile import backport_makefile + +__all__ = ["inject_into_urllib3", "extract_from_urllib3"] + +# SNI always works +HAS_SNI = True + +orig_util_HAS_SNI = util.HAS_SNI +orig_util_SSLContext = util.ssl_.SSLContext + +# This dictionary is used by the read callback to obtain a handle to the +# calling wrapped socket. This is a pretty silly approach, but for now it'll +# do. I feel like I should be able to smuggle a handle to the wrapped socket +# directly in the SSLConnectionRef, but for now this approach will work I +# guess. +# +# We need to lock around this structure for inserts, but we don't do it for +# reads/writes in the callbacks. The reasoning here goes as follows: +# +# 1. It is not possible to call into the callbacks before the dictionary is +# populated, so once in the callback the id must be in the dictionary. +# 2. The callbacks don't mutate the dictionary, they only read from it, and +# so cannot conflict with any of the insertions. +# +# This is good: if we had to lock in the callbacks we'd drastically slow down +# the performance of this code. +_connection_refs = weakref.WeakValueDictionary() +_connection_ref_lock = threading.Lock() + +# Limit writes to 16kB. This is OpenSSL's limit, but we'll cargo-cult it over +# for no better reason than we need *a* limit, and this one is right there. +SSL_WRITE_BLOCKSIZE = 16384 + +# This is our equivalent of util.ssl_.DEFAULT_CIPHERS, but expanded out to +# individual cipher suites. We need to do this because this is how +# SecureTransport wants them. +CIPHER_SUITES = [ + SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384, + SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256, + SecurityConst.TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384, + SecurityConst.TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256, + SecurityConst.TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256, + SecurityConst.TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256, + SecurityConst.TLS_DHE_RSA_WITH_AES_256_GCM_SHA384, + SecurityConst.TLS_DHE_RSA_WITH_AES_128_GCM_SHA256, + SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384, + SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA, + SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256, + SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA, + SecurityConst.TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384, + SecurityConst.TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA, + SecurityConst.TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256, + SecurityConst.TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA, + SecurityConst.TLS_DHE_RSA_WITH_AES_256_CBC_SHA256, + SecurityConst.TLS_DHE_RSA_WITH_AES_256_CBC_SHA, + SecurityConst.TLS_DHE_RSA_WITH_AES_128_CBC_SHA256, + SecurityConst.TLS_DHE_RSA_WITH_AES_128_CBC_SHA, + SecurityConst.TLS_AES_256_GCM_SHA384, + SecurityConst.TLS_AES_128_GCM_SHA256, + SecurityConst.TLS_RSA_WITH_AES_256_GCM_SHA384, + SecurityConst.TLS_RSA_WITH_AES_128_GCM_SHA256, + SecurityConst.TLS_AES_128_CCM_8_SHA256, + SecurityConst.TLS_AES_128_CCM_SHA256, + SecurityConst.TLS_RSA_WITH_AES_256_CBC_SHA256, + SecurityConst.TLS_RSA_WITH_AES_128_CBC_SHA256, + SecurityConst.TLS_RSA_WITH_AES_256_CBC_SHA, + SecurityConst.TLS_RSA_WITH_AES_128_CBC_SHA, +] + +# Basically this is simple: for PROTOCOL_SSLv23 we turn it into a low of +# TLSv1 and a high of TLSv1.2. For everything else, we pin to that version. +# TLSv1 to 1.2 are supported on macOS 10.8+ +_protocol_to_min_max = { + util.PROTOCOL_TLS: (SecurityConst.kTLSProtocol1, SecurityConst.kTLSProtocol12), + PROTOCOL_TLS_CLIENT: (SecurityConst.kTLSProtocol1, SecurityConst.kTLSProtocol12), +} + +if hasattr(ssl, "PROTOCOL_SSLv2"): + _protocol_to_min_max[ssl.PROTOCOL_SSLv2] = ( + SecurityConst.kSSLProtocol2, + SecurityConst.kSSLProtocol2, + ) +if hasattr(ssl, "PROTOCOL_SSLv3"): + _protocol_to_min_max[ssl.PROTOCOL_SSLv3] = ( + SecurityConst.kSSLProtocol3, + SecurityConst.kSSLProtocol3, + ) +if hasattr(ssl, "PROTOCOL_TLSv1"): + _protocol_to_min_max[ssl.PROTOCOL_TLSv1] = ( + SecurityConst.kTLSProtocol1, + SecurityConst.kTLSProtocol1, + ) +if hasattr(ssl, "PROTOCOL_TLSv1_1"): + _protocol_to_min_max[ssl.PROTOCOL_TLSv1_1] = ( + SecurityConst.kTLSProtocol11, + SecurityConst.kTLSProtocol11, + ) +if hasattr(ssl, "PROTOCOL_TLSv1_2"): + _protocol_to_min_max[ssl.PROTOCOL_TLSv1_2] = ( + SecurityConst.kTLSProtocol12, + SecurityConst.kTLSProtocol12, + ) + + +def inject_into_urllib3(): + """ + Monkey-patch urllib3 with SecureTransport-backed SSL-support. + """ + util.SSLContext = SecureTransportContext + util.ssl_.SSLContext = SecureTransportContext + util.HAS_SNI = HAS_SNI + util.ssl_.HAS_SNI = HAS_SNI + util.IS_SECURETRANSPORT = True + util.ssl_.IS_SECURETRANSPORT = True + + +def extract_from_urllib3(): + """ + Undo monkey-patching by :func:`inject_into_urllib3`. + """ + util.SSLContext = orig_util_SSLContext + util.ssl_.SSLContext = orig_util_SSLContext + util.HAS_SNI = orig_util_HAS_SNI + util.ssl_.HAS_SNI = orig_util_HAS_SNI + util.IS_SECURETRANSPORT = False + util.ssl_.IS_SECURETRANSPORT = False + + +def _read_callback(connection_id, data_buffer, data_length_pointer): + """ + SecureTransport read callback. This is called by ST to request that data + be returned from the socket. + """ + wrapped_socket = None + try: + wrapped_socket = _connection_refs.get(connection_id) + if wrapped_socket is None: + return SecurityConst.errSSLInternal + base_socket = wrapped_socket.socket + + requested_length = data_length_pointer[0] + + timeout = wrapped_socket.gettimeout() + error = None + read_count = 0 + + try: + while read_count < requested_length: + if timeout is None or timeout >= 0: + if not util.wait_for_read(base_socket, timeout): + raise socket.error(errno.EAGAIN, "timed out") + + remaining = requested_length - read_count + buffer = (ctypes.c_char * remaining).from_address( + data_buffer + read_count + ) + chunk_size = base_socket.recv_into(buffer, remaining) + read_count += chunk_size + if not chunk_size: + if not read_count: + return SecurityConst.errSSLClosedGraceful + break + except (socket.error) as e: + error = e.errno + + if error is not None and error != errno.EAGAIN: + data_length_pointer[0] = read_count + if error == errno.ECONNRESET or error == errno.EPIPE: + return SecurityConst.errSSLClosedAbort + raise + + data_length_pointer[0] = read_count + + if read_count != requested_length: + return SecurityConst.errSSLWouldBlock + + return 0 + except Exception as e: + if wrapped_socket is not None: + wrapped_socket._exception = e + return SecurityConst.errSSLInternal + + +def _write_callback(connection_id, data_buffer, data_length_pointer): + """ + SecureTransport write callback. This is called by ST to request that data + actually be sent on the network. + """ + wrapped_socket = None + try: + wrapped_socket = _connection_refs.get(connection_id) + if wrapped_socket is None: + return SecurityConst.errSSLInternal + base_socket = wrapped_socket.socket + + bytes_to_write = data_length_pointer[0] + data = ctypes.string_at(data_buffer, bytes_to_write) + + timeout = wrapped_socket.gettimeout() + error = None + sent = 0 + + try: + while sent < bytes_to_write: + if timeout is None or timeout >= 0: + if not util.wait_for_write(base_socket, timeout): + raise socket.error(errno.EAGAIN, "timed out") + chunk_sent = base_socket.send(data) + sent += chunk_sent + + # This has some needless copying here, but I'm not sure there's + # much value in optimising this data path. + data = data[chunk_sent:] + except (socket.error) as e: + error = e.errno + + if error is not None and error != errno.EAGAIN: + data_length_pointer[0] = sent + if error == errno.ECONNRESET or error == errno.EPIPE: + return SecurityConst.errSSLClosedAbort + raise + + data_length_pointer[0] = sent + + if sent != bytes_to_write: + return SecurityConst.errSSLWouldBlock + + return 0 + except Exception as e: + if wrapped_socket is not None: + wrapped_socket._exception = e + return SecurityConst.errSSLInternal + + +# We need to keep these two objects references alive: if they get GC'd while +# in use then SecureTransport could attempt to call a function that is in freed +# memory. That would be...uh...bad. Yeah, that's the word. Bad. +_read_callback_pointer = Security.SSLReadFunc(_read_callback) +_write_callback_pointer = Security.SSLWriteFunc(_write_callback) + + +class WrappedSocket(object): + """ + API-compatibility wrapper for Python's OpenSSL wrapped socket object. + + Note: _makefile_refs, _drop(), and _reuse() are needed for the garbage + collector of PyPy. + """ + + def __init__(self, socket): + self.socket = socket + self.context = None + self._makefile_refs = 0 + self._closed = False + self._exception = None + self._keychain = None + self._keychain_dir = None + self._client_cert_chain = None + + # We save off the previously-configured timeout and then set it to + # zero. This is done because we use select and friends to handle the + # timeouts, but if we leave the timeout set on the lower socket then + # Python will "kindly" call select on that socket again for us. Avoid + # that by forcing the timeout to zero. + self._timeout = self.socket.gettimeout() + self.socket.settimeout(0) + + @contextlib.contextmanager + def _raise_on_error(self): + """ + A context manager that can be used to wrap calls that do I/O from + SecureTransport. If any of the I/O callbacks hit an exception, this + context manager will correctly propagate the exception after the fact. + This avoids silently swallowing those exceptions. + + It also correctly forces the socket closed. + """ + self._exception = None + + # We explicitly don't catch around this yield because in the unlikely + # event that an exception was hit in the block we don't want to swallow + # it. + yield + if self._exception is not None: + exception, self._exception = self._exception, None + self.close() + raise exception + + def _set_ciphers(self): + """ + Sets up the allowed ciphers. By default this matches the set in + util.ssl_.DEFAULT_CIPHERS, at least as supported by macOS. This is done + custom and doesn't allow changing at this time, mostly because parsing + OpenSSL cipher strings is going to be a freaking nightmare. + """ + ciphers = (Security.SSLCipherSuite * len(CIPHER_SUITES))(*CIPHER_SUITES) + result = Security.SSLSetEnabledCiphers( + self.context, ciphers, len(CIPHER_SUITES) + ) + _assert_no_error(result) + + def _set_alpn_protocols(self, protocols): + """ + Sets up the ALPN protocols on the context. + """ + if not protocols: + return + protocols_arr = _create_cfstring_array(protocols) + try: + result = Security.SSLSetALPNProtocols(self.context, protocols_arr) + _assert_no_error(result) + finally: + CoreFoundation.CFRelease(protocols_arr) + + def _custom_validate(self, verify, trust_bundle): + """ + Called when we have set custom validation. We do this in two cases: + first, when cert validation is entirely disabled; and second, when + using a custom trust DB. + Raises an SSLError if the connection is not trusted. + """ + # If we disabled cert validation, just say: cool. + if not verify: + return + + successes = ( + SecurityConst.kSecTrustResultUnspecified, + SecurityConst.kSecTrustResultProceed, + ) + try: + trust_result = self._evaluate_trust(trust_bundle) + if trust_result in successes: + return + reason = "error code: %d" % (trust_result,) + except Exception as e: + # Do not trust on error + reason = "exception: %r" % (e,) + + # SecureTransport does not send an alert nor shuts down the connection. + rec = _build_tls_unknown_ca_alert(self.version()) + self.socket.sendall(rec) + # close the connection immediately + # l_onoff = 1, activate linger + # l_linger = 0, linger for 0 seoncds + opts = struct.pack("ii", 1, 0) + self.socket.setsockopt(socket.SOL_SOCKET, socket.SO_LINGER, opts) + self.close() + raise ssl.SSLError("certificate verify failed, %s" % reason) + + def _evaluate_trust(self, trust_bundle): + # We want data in memory, so load it up. + if os.path.isfile(trust_bundle): + with open(trust_bundle, "rb") as f: + trust_bundle = f.read() + + cert_array = None + trust = Security.SecTrustRef() + + try: + # Get a CFArray that contains the certs we want. + cert_array = _cert_array_from_pem(trust_bundle) + + # Ok, now the hard part. We want to get the SecTrustRef that ST has + # created for this connection, shove our CAs into it, tell ST to + # ignore everything else it knows, and then ask if it can build a + # chain. This is a buuuunch of code. + result = Security.SSLCopyPeerTrust(self.context, ctypes.byref(trust)) + _assert_no_error(result) + if not trust: + raise ssl.SSLError("Failed to copy trust reference") + + result = Security.SecTrustSetAnchorCertificates(trust, cert_array) + _assert_no_error(result) + + result = Security.SecTrustSetAnchorCertificatesOnly(trust, True) + _assert_no_error(result) + + trust_result = Security.SecTrustResultType() + result = Security.SecTrustEvaluate(trust, ctypes.byref(trust_result)) + _assert_no_error(result) + finally: + if trust: + CoreFoundation.CFRelease(trust) + + if cert_array is not None: + CoreFoundation.CFRelease(cert_array) + + return trust_result.value + + def handshake( + self, + server_hostname, + verify, + trust_bundle, + min_version, + max_version, + client_cert, + client_key, + client_key_passphrase, + alpn_protocols, + ): + """ + Actually performs the TLS handshake. This is run automatically by + wrapped socket, and shouldn't be needed in user code. + """ + # First, we do the initial bits of connection setup. We need to create + # a context, set its I/O funcs, and set the connection reference. + self.context = Security.SSLCreateContext( + None, SecurityConst.kSSLClientSide, SecurityConst.kSSLStreamType + ) + result = Security.SSLSetIOFuncs( + self.context, _read_callback_pointer, _write_callback_pointer + ) + _assert_no_error(result) + + # Here we need to compute the handle to use. We do this by taking the + # id of self modulo 2**31 - 1. If this is already in the dictionary, we + # just keep incrementing by one until we find a free space. + with _connection_ref_lock: + handle = id(self) % 2147483647 + while handle in _connection_refs: + handle = (handle + 1) % 2147483647 + _connection_refs[handle] = self + + result = Security.SSLSetConnection(self.context, handle) + _assert_no_error(result) + + # If we have a server hostname, we should set that too. + if server_hostname: + if not isinstance(server_hostname, bytes): + server_hostname = server_hostname.encode("utf-8") + + result = Security.SSLSetPeerDomainName( + self.context, server_hostname, len(server_hostname) + ) + _assert_no_error(result) + + # Setup the ciphers. + self._set_ciphers() + + # Setup the ALPN protocols. + self._set_alpn_protocols(alpn_protocols) + + # Set the minimum and maximum TLS versions. + result = Security.SSLSetProtocolVersionMin(self.context, min_version) + _assert_no_error(result) + + result = Security.SSLSetProtocolVersionMax(self.context, max_version) + _assert_no_error(result) + + # If there's a trust DB, we need to use it. We do that by telling + # SecureTransport to break on server auth. We also do that if we don't + # want to validate the certs at all: we just won't actually do any + # authing in that case. + if not verify or trust_bundle is not None: + result = Security.SSLSetSessionOption( + self.context, SecurityConst.kSSLSessionOptionBreakOnServerAuth, True + ) + _assert_no_error(result) + + # If there's a client cert, we need to use it. + if client_cert: + self._keychain, self._keychain_dir = _temporary_keychain() + self._client_cert_chain = _load_client_cert_chain( + self._keychain, client_cert, client_key + ) + result = Security.SSLSetCertificate(self.context, self._client_cert_chain) + _assert_no_error(result) + + while True: + with self._raise_on_error(): + result = Security.SSLHandshake(self.context) + + if result == SecurityConst.errSSLWouldBlock: + raise socket.timeout("handshake timed out") + elif result == SecurityConst.errSSLServerAuthCompleted: + self._custom_validate(verify, trust_bundle) + continue + else: + _assert_no_error(result) + break + + def fileno(self): + return self.socket.fileno() + + # Copy-pasted from Python 3.5 source code + def _decref_socketios(self): + if self._makefile_refs > 0: + self._makefile_refs -= 1 + if self._closed: + self.close() + + def recv(self, bufsiz): + buffer = ctypes.create_string_buffer(bufsiz) + bytes_read = self.recv_into(buffer, bufsiz) + data = buffer[:bytes_read] + return data + + def recv_into(self, buffer, nbytes=None): + # Read short on EOF. + if self._closed: + return 0 + + if nbytes is None: + nbytes = len(buffer) + + buffer = (ctypes.c_char * nbytes).from_buffer(buffer) + processed_bytes = ctypes.c_size_t(0) + + with self._raise_on_error(): + result = Security.SSLRead( + self.context, buffer, nbytes, ctypes.byref(processed_bytes) + ) + + # There are some result codes that we want to treat as "not always + # errors". Specifically, those are errSSLWouldBlock, + # errSSLClosedGraceful, and errSSLClosedNoNotify. + if result == SecurityConst.errSSLWouldBlock: + # If we didn't process any bytes, then this was just a time out. + # However, we can get errSSLWouldBlock in situations when we *did* + # read some data, and in those cases we should just read "short" + # and return. + if processed_bytes.value == 0: + # Timed out, no data read. + raise socket.timeout("recv timed out") + elif result in ( + SecurityConst.errSSLClosedGraceful, + SecurityConst.errSSLClosedNoNotify, + ): + # The remote peer has closed this connection. We should do so as + # well. Note that we don't actually return here because in + # principle this could actually be fired along with return data. + # It's unlikely though. + self.close() + else: + _assert_no_error(result) + + # Ok, we read and probably succeeded. We should return whatever data + # was actually read. + return processed_bytes.value + + def settimeout(self, timeout): + self._timeout = timeout + + def gettimeout(self): + return self._timeout + + def send(self, data): + processed_bytes = ctypes.c_size_t(0) + + with self._raise_on_error(): + result = Security.SSLWrite( + self.context, data, len(data), ctypes.byref(processed_bytes) + ) + + if result == SecurityConst.errSSLWouldBlock and processed_bytes.value == 0: + # Timed out + raise socket.timeout("send timed out") + else: + _assert_no_error(result) + + # We sent, and probably succeeded. Tell them how much we sent. + return processed_bytes.value + + def sendall(self, data): + total_sent = 0 + while total_sent < len(data): + sent = self.send(data[total_sent : total_sent + SSL_WRITE_BLOCKSIZE]) + total_sent += sent + + def shutdown(self): + with self._raise_on_error(): + Security.SSLClose(self.context) + + def close(self): + # TODO: should I do clean shutdown here? Do I have to? + if self._makefile_refs < 1: + self._closed = True + if self.context: + CoreFoundation.CFRelease(self.context) + self.context = None + if self._client_cert_chain: + CoreFoundation.CFRelease(self._client_cert_chain) + self._client_cert_chain = None + if self._keychain: + Security.SecKeychainDelete(self._keychain) + CoreFoundation.CFRelease(self._keychain) + shutil.rmtree(self._keychain_dir) + self._keychain = self._keychain_dir = None + return self.socket.close() + else: + self._makefile_refs -= 1 + + def getpeercert(self, binary_form=False): + # Urgh, annoying. + # + # Here's how we do this: + # + # 1. Call SSLCopyPeerTrust to get hold of the trust object for this + # connection. + # 2. Call SecTrustGetCertificateAtIndex for index 0 to get the leaf. + # 3. To get the CN, call SecCertificateCopyCommonName and process that + # string so that it's of the appropriate type. + # 4. To get the SAN, we need to do something a bit more complex: + # a. Call SecCertificateCopyValues to get the data, requesting + # kSecOIDSubjectAltName. + # b. Mess about with this dictionary to try to get the SANs out. + # + # This is gross. Really gross. It's going to be a few hundred LoC extra + # just to repeat something that SecureTransport can *already do*. So my + # operating assumption at this time is that what we want to do is + # instead to just flag to urllib3 that it shouldn't do its own hostname + # validation when using SecureTransport. + if not binary_form: + raise ValueError("SecureTransport only supports dumping binary certs") + trust = Security.SecTrustRef() + certdata = None + der_bytes = None + + try: + # Grab the trust store. + result = Security.SSLCopyPeerTrust(self.context, ctypes.byref(trust)) + _assert_no_error(result) + if not trust: + # Probably we haven't done the handshake yet. No biggie. + return None + + cert_count = Security.SecTrustGetCertificateCount(trust) + if not cert_count: + # Also a case that might happen if we haven't handshaked. + # Handshook? Handshaken? + return None + + leaf = Security.SecTrustGetCertificateAtIndex(trust, 0) + assert leaf + + # Ok, now we want the DER bytes. + certdata = Security.SecCertificateCopyData(leaf) + assert certdata + + data_length = CoreFoundation.CFDataGetLength(certdata) + data_buffer = CoreFoundation.CFDataGetBytePtr(certdata) + der_bytes = ctypes.string_at(data_buffer, data_length) + finally: + if certdata: + CoreFoundation.CFRelease(certdata) + if trust: + CoreFoundation.CFRelease(trust) + + return der_bytes + + def version(self): + protocol = Security.SSLProtocol() + result = Security.SSLGetNegotiatedProtocolVersion( + self.context, ctypes.byref(protocol) + ) + _assert_no_error(result) + if protocol.value == SecurityConst.kTLSProtocol13: + raise ssl.SSLError("SecureTransport does not support TLS 1.3") + elif protocol.value == SecurityConst.kTLSProtocol12: + return "TLSv1.2" + elif protocol.value == SecurityConst.kTLSProtocol11: + return "TLSv1.1" + elif protocol.value == SecurityConst.kTLSProtocol1: + return "TLSv1" + elif protocol.value == SecurityConst.kSSLProtocol3: + return "SSLv3" + elif protocol.value == SecurityConst.kSSLProtocol2: + return "SSLv2" + else: + raise ssl.SSLError("Unknown TLS version: %r" % protocol) + + def _reuse(self): + self._makefile_refs += 1 + + def _drop(self): + if self._makefile_refs < 1: + self.close() + else: + self._makefile_refs -= 1 + + +if _fileobject: # Platform-specific: Python 2 + + def makefile(self, mode, bufsize=-1): + self._makefile_refs += 1 + return _fileobject(self, mode, bufsize, close=True) + + +else: # Platform-specific: Python 3 + + def makefile(self, mode="r", buffering=None, *args, **kwargs): + # We disable buffering with SecureTransport because it conflicts with + # the buffering that ST does internally (see issue #1153 for more). + buffering = 0 + return backport_makefile(self, mode, buffering, *args, **kwargs) + + +WrappedSocket.makefile = makefile + + +class SecureTransportContext(object): + """ + I am a wrapper class for the SecureTransport library, to translate the + interface of the standard library ``SSLContext`` object to calls into + SecureTransport. + """ + + def __init__(self, protocol): + self._min_version, self._max_version = _protocol_to_min_max[protocol] + self._options = 0 + self._verify = False + self._trust_bundle = None + self._client_cert = None + self._client_key = None + self._client_key_passphrase = None + self._alpn_protocols = None + + @property + def check_hostname(self): + """ + SecureTransport cannot have its hostname checking disabled. For more, + see the comment on getpeercert() in this file. + """ + return True + + @check_hostname.setter + def check_hostname(self, value): + """ + SecureTransport cannot have its hostname checking disabled. For more, + see the comment on getpeercert() in this file. + """ + pass + + @property + def options(self): + # TODO: Well, crap. + # + # So this is the bit of the code that is the most likely to cause us + # trouble. Essentially we need to enumerate all of the SSL options that + # users might want to use and try to see if we can sensibly translate + # them, or whether we should just ignore them. + return self._options + + @options.setter + def options(self, value): + # TODO: Update in line with above. + self._options = value + + @property + def verify_mode(self): + return ssl.CERT_REQUIRED if self._verify else ssl.CERT_NONE + + @verify_mode.setter + def verify_mode(self, value): + self._verify = True if value == ssl.CERT_REQUIRED else False + + def set_default_verify_paths(self): + # So, this has to do something a bit weird. Specifically, what it does + # is nothing. + # + # This means that, if we had previously had load_verify_locations + # called, this does not undo that. We need to do that because it turns + # out that the rest of the urllib3 code will attempt to load the + # default verify paths if it hasn't been told about any paths, even if + # the context itself was sometime earlier. We resolve that by just + # ignoring it. + pass + + def load_default_certs(self): + return self.set_default_verify_paths() + + def set_ciphers(self, ciphers): + # For now, we just require the default cipher string. + if ciphers != util.ssl_.DEFAULT_CIPHERS: + raise ValueError("SecureTransport doesn't support custom cipher strings") + + def load_verify_locations(self, cafile=None, capath=None, cadata=None): + # OK, we only really support cadata and cafile. + if capath is not None: + raise ValueError("SecureTransport does not support cert directories") + + # Raise if cafile does not exist. + if cafile is not None: + with open(cafile): + pass + + self._trust_bundle = cafile or cadata + + def load_cert_chain(self, certfile, keyfile=None, password=None): + self._client_cert = certfile + self._client_key = keyfile + self._client_cert_passphrase = password + + def set_alpn_protocols(self, protocols): + """ + Sets the ALPN protocols that will later be set on the context. + + Raises a NotImplementedError if ALPN is not supported. + """ + if not hasattr(Security, "SSLSetALPNProtocols"): + raise NotImplementedError( + "SecureTransport supports ALPN only in macOS 10.12+" + ) + self._alpn_protocols = [six.ensure_binary(p) for p in protocols] + + def wrap_socket( + self, + sock, + server_side=False, + do_handshake_on_connect=True, + suppress_ragged_eofs=True, + server_hostname=None, + ): + # So, what do we do here? Firstly, we assert some properties. This is a + # stripped down shim, so there is some functionality we don't support. + # See PEP 543 for the real deal. + assert not server_side + assert do_handshake_on_connect + assert suppress_ragged_eofs + + # Ok, we're good to go. Now we want to create the wrapped socket object + # and store it in the appropriate place. + wrapped_socket = WrappedSocket(sock) + + # Now we can handshake + wrapped_socket.handshake( + server_hostname, + self._verify, + self._trust_bundle, + self._min_version, + self._max_version, + self._client_cert, + self._client_key, + self._client_key_passphrase, + self._alpn_protocols, + ) + return wrapped_socket diff --git a/openpype/hosts/fusion/vendor/urllib3/contrib/socks.py b/openpype/hosts/fusion/vendor/urllib3/contrib/socks.py new file mode 100644 index 0000000000..c326e80dd1 --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/contrib/socks.py @@ -0,0 +1,216 @@ +# -*- coding: utf-8 -*- +""" +This module contains provisional support for SOCKS proxies from within +urllib3. This module supports SOCKS4, SOCKS4A (an extension of SOCKS4), and +SOCKS5. To enable its functionality, either install PySocks or install this +module with the ``socks`` extra. + +The SOCKS implementation supports the full range of urllib3 features. It also +supports the following SOCKS features: + +- SOCKS4A (``proxy_url='socks4a://...``) +- SOCKS4 (``proxy_url='socks4://...``) +- SOCKS5 with remote DNS (``proxy_url='socks5h://...``) +- SOCKS5 with local DNS (``proxy_url='socks5://...``) +- Usernames and passwords for the SOCKS proxy + +.. note:: + It is recommended to use ``socks5h://`` or ``socks4a://`` schemes in + your ``proxy_url`` to ensure that DNS resolution is done from the remote + server instead of client-side when connecting to a domain name. + +SOCKS4 supports IPv4 and domain names with the SOCKS4A extension. SOCKS5 +supports IPv4, IPv6, and domain names. + +When connecting to a SOCKS4 proxy the ``username`` portion of the ``proxy_url`` +will be sent as the ``userid`` section of the SOCKS request: + +.. code-block:: python + + proxy_url="socks4a://@proxy-host" + +When connecting to a SOCKS5 proxy the ``username`` and ``password`` portion +of the ``proxy_url`` will be sent as the username/password to authenticate +with the proxy: + +.. code-block:: python + + proxy_url="socks5h://:@proxy-host" + +""" +from __future__ import absolute_import + +try: + import socks +except ImportError: + import warnings + + from ..exceptions import DependencyWarning + + warnings.warn( + ( + "SOCKS support in urllib3 requires the installation of optional " + "dependencies: specifically, PySocks. For more information, see " + "https://urllib3.readthedocs.io/en/1.26.x/contrib.html#socks-proxies" + ), + DependencyWarning, + ) + raise + +from socket import error as SocketError +from socket import timeout as SocketTimeout + +from ..connection import HTTPConnection, HTTPSConnection +from ..connectionpool import HTTPConnectionPool, HTTPSConnectionPool +from ..exceptions import ConnectTimeoutError, NewConnectionError +from ..poolmanager import PoolManager +from ..util.url import parse_url + +try: + import ssl +except ImportError: + ssl = None + + +class SOCKSConnection(HTTPConnection): + """ + A plain-text HTTP connection that connects via a SOCKS proxy. + """ + + def __init__(self, *args, **kwargs): + self._socks_options = kwargs.pop("_socks_options") + super(SOCKSConnection, self).__init__(*args, **kwargs) + + def _new_conn(self): + """ + Establish a new connection via the SOCKS proxy. + """ + extra_kw = {} + if self.source_address: + extra_kw["source_address"] = self.source_address + + if self.socket_options: + extra_kw["socket_options"] = self.socket_options + + try: + conn = socks.create_connection( + (self.host, self.port), + proxy_type=self._socks_options["socks_version"], + proxy_addr=self._socks_options["proxy_host"], + proxy_port=self._socks_options["proxy_port"], + proxy_username=self._socks_options["username"], + proxy_password=self._socks_options["password"], + proxy_rdns=self._socks_options["rdns"], + timeout=self.timeout, + **extra_kw + ) + + except SocketTimeout: + raise ConnectTimeoutError( + self, + "Connection to %s timed out. (connect timeout=%s)" + % (self.host, self.timeout), + ) + + except socks.ProxyError as e: + # This is fragile as hell, but it seems to be the only way to raise + # useful errors here. + if e.socket_err: + error = e.socket_err + if isinstance(error, SocketTimeout): + raise ConnectTimeoutError( + self, + "Connection to %s timed out. (connect timeout=%s)" + % (self.host, self.timeout), + ) + else: + raise NewConnectionError( + self, "Failed to establish a new connection: %s" % error + ) + else: + raise NewConnectionError( + self, "Failed to establish a new connection: %s" % e + ) + + except SocketError as e: # Defensive: PySocks should catch all these. + raise NewConnectionError( + self, "Failed to establish a new connection: %s" % e + ) + + return conn + + +# We don't need to duplicate the Verified/Unverified distinction from +# urllib3/connection.py here because the HTTPSConnection will already have been +# correctly set to either the Verified or Unverified form by that module. This +# means the SOCKSHTTPSConnection will automatically be the correct type. +class SOCKSHTTPSConnection(SOCKSConnection, HTTPSConnection): + pass + + +class SOCKSHTTPConnectionPool(HTTPConnectionPool): + ConnectionCls = SOCKSConnection + + +class SOCKSHTTPSConnectionPool(HTTPSConnectionPool): + ConnectionCls = SOCKSHTTPSConnection + + +class SOCKSProxyManager(PoolManager): + """ + A version of the urllib3 ProxyManager that routes connections via the + defined SOCKS proxy. + """ + + pool_classes_by_scheme = { + "http": SOCKSHTTPConnectionPool, + "https": SOCKSHTTPSConnectionPool, + } + + def __init__( + self, + proxy_url, + username=None, + password=None, + num_pools=10, + headers=None, + **connection_pool_kw + ): + parsed = parse_url(proxy_url) + + if username is None and password is None and parsed.auth is not None: + split = parsed.auth.split(":") + if len(split) == 2: + username, password = split + if parsed.scheme == "socks5": + socks_version = socks.PROXY_TYPE_SOCKS5 + rdns = False + elif parsed.scheme == "socks5h": + socks_version = socks.PROXY_TYPE_SOCKS5 + rdns = True + elif parsed.scheme == "socks4": + socks_version = socks.PROXY_TYPE_SOCKS4 + rdns = False + elif parsed.scheme == "socks4a": + socks_version = socks.PROXY_TYPE_SOCKS4 + rdns = True + else: + raise ValueError("Unable to determine SOCKS version from %s" % proxy_url) + + self.proxy_url = proxy_url + + socks_options = { + "socks_version": socks_version, + "proxy_host": parsed.host, + "proxy_port": parsed.port, + "username": username, + "password": password, + "rdns": rdns, + } + connection_pool_kw["_socks_options"] = socks_options + + super(SOCKSProxyManager, self).__init__( + num_pools, headers, **connection_pool_kw + ) + + self.pool_classes_by_scheme = SOCKSProxyManager.pool_classes_by_scheme diff --git a/openpype/hosts/fusion/vendor/urllib3/exceptions.py b/openpype/hosts/fusion/vendor/urllib3/exceptions.py new file mode 100644 index 0000000000..cba6f3f560 --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/exceptions.py @@ -0,0 +1,323 @@ +from __future__ import absolute_import + +from .packages.six.moves.http_client import IncompleteRead as httplib_IncompleteRead + +# Base Exceptions + + +class HTTPError(Exception): + """Base exception used by this module.""" + + pass + + +class HTTPWarning(Warning): + """Base warning used by this module.""" + + pass + + +class PoolError(HTTPError): + """Base exception for errors caused within a pool.""" + + def __init__(self, pool, message): + self.pool = pool + HTTPError.__init__(self, "%s: %s" % (pool, message)) + + def __reduce__(self): + # For pickling purposes. + return self.__class__, (None, None) + + +class RequestError(PoolError): + """Base exception for PoolErrors that have associated URLs.""" + + def __init__(self, pool, url, message): + self.url = url + PoolError.__init__(self, pool, message) + + def __reduce__(self): + # For pickling purposes. + return self.__class__, (None, self.url, None) + + +class SSLError(HTTPError): + """Raised when SSL certificate fails in an HTTPS connection.""" + + pass + + +class ProxyError(HTTPError): + """Raised when the connection to a proxy fails.""" + + def __init__(self, message, error, *args): + super(ProxyError, self).__init__(message, error, *args) + self.original_error = error + + +class DecodeError(HTTPError): + """Raised when automatic decoding based on Content-Type fails.""" + + pass + + +class ProtocolError(HTTPError): + """Raised when something unexpected happens mid-request/response.""" + + pass + + +#: Renamed to ProtocolError but aliased for backwards compatibility. +ConnectionError = ProtocolError + + +# Leaf Exceptions + + +class MaxRetryError(RequestError): + """Raised when the maximum number of retries is exceeded. + + :param pool: The connection pool + :type pool: :class:`~urllib3.connectionpool.HTTPConnectionPool` + :param string url: The requested Url + :param exceptions.Exception reason: The underlying error + + """ + + def __init__(self, pool, url, reason=None): + self.reason = reason + + message = "Max retries exceeded with url: %s (Caused by %r)" % (url, reason) + + RequestError.__init__(self, pool, url, message) + + +class HostChangedError(RequestError): + """Raised when an existing pool gets a request for a foreign host.""" + + def __init__(self, pool, url, retries=3): + message = "Tried to open a foreign host with url: %s" % url + RequestError.__init__(self, pool, url, message) + self.retries = retries + + +class TimeoutStateError(HTTPError): + """Raised when passing an invalid state to a timeout""" + + pass + + +class TimeoutError(HTTPError): + """Raised when a socket timeout error occurs. + + Catching this error will catch both :exc:`ReadTimeoutErrors + ` and :exc:`ConnectTimeoutErrors `. + """ + + pass + + +class ReadTimeoutError(TimeoutError, RequestError): + """Raised when a socket timeout occurs while receiving data from a server""" + + pass + + +# This timeout error does not have a URL attached and needs to inherit from the +# base HTTPError +class ConnectTimeoutError(TimeoutError): + """Raised when a socket timeout occurs while connecting to a server""" + + pass + + +class NewConnectionError(ConnectTimeoutError, PoolError): + """Raised when we fail to establish a new connection. Usually ECONNREFUSED.""" + + pass + + +class EmptyPoolError(PoolError): + """Raised when a pool runs out of connections and no more are allowed.""" + + pass + + +class ClosedPoolError(PoolError): + """Raised when a request enters a pool after the pool has been closed.""" + + pass + + +class LocationValueError(ValueError, HTTPError): + """Raised when there is something wrong with a given URL input.""" + + pass + + +class LocationParseError(LocationValueError): + """Raised when get_host or similar fails to parse the URL input.""" + + def __init__(self, location): + message = "Failed to parse: %s" % location + HTTPError.__init__(self, message) + + self.location = location + + +class URLSchemeUnknown(LocationValueError): + """Raised when a URL input has an unsupported scheme.""" + + def __init__(self, scheme): + message = "Not supported URL scheme %s" % scheme + super(URLSchemeUnknown, self).__init__(message) + + self.scheme = scheme + + +class ResponseError(HTTPError): + """Used as a container for an error reason supplied in a MaxRetryError.""" + + GENERIC_ERROR = "too many error responses" + SPECIFIC_ERROR = "too many {status_code} error responses" + + +class SecurityWarning(HTTPWarning): + """Warned when performing security reducing actions""" + + pass + + +class SubjectAltNameWarning(SecurityWarning): + """Warned when connecting to a host with a certificate missing a SAN.""" + + pass + + +class InsecureRequestWarning(SecurityWarning): + """Warned when making an unverified HTTPS request.""" + + pass + + +class SystemTimeWarning(SecurityWarning): + """Warned when system time is suspected to be wrong""" + + pass + + +class InsecurePlatformWarning(SecurityWarning): + """Warned when certain TLS/SSL configuration is not available on a platform.""" + + pass + + +class SNIMissingWarning(HTTPWarning): + """Warned when making a HTTPS request without SNI available.""" + + pass + + +class DependencyWarning(HTTPWarning): + """ + Warned when an attempt is made to import a module with missing optional + dependencies. + """ + + pass + + +class ResponseNotChunked(ProtocolError, ValueError): + """Response needs to be chunked in order to read it as chunks.""" + + pass + + +class BodyNotHttplibCompatible(HTTPError): + """ + Body should be :class:`http.client.HTTPResponse` like + (have an fp attribute which returns raw chunks) for read_chunked(). + """ + + pass + + +class IncompleteRead(HTTPError, httplib_IncompleteRead): + """ + Response length doesn't match expected Content-Length + + Subclass of :class:`http.client.IncompleteRead` to allow int value + for ``partial`` to avoid creating large objects on streamed reads. + """ + + def __init__(self, partial, expected): + super(IncompleteRead, self).__init__(partial, expected) + + def __repr__(self): + return "IncompleteRead(%i bytes read, %i more expected)" % ( + self.partial, + self.expected, + ) + + +class InvalidChunkLength(HTTPError, httplib_IncompleteRead): + """Invalid chunk length in a chunked response.""" + + def __init__(self, response, length): + super(InvalidChunkLength, self).__init__( + response.tell(), response.length_remaining + ) + self.response = response + self.length = length + + def __repr__(self): + return "InvalidChunkLength(got length %r, %i bytes read)" % ( + self.length, + self.partial, + ) + + +class InvalidHeader(HTTPError): + """The header provided was somehow invalid.""" + + pass + + +class ProxySchemeUnknown(AssertionError, URLSchemeUnknown): + """ProxyManager does not support the supplied scheme""" + + # TODO(t-8ch): Stop inheriting from AssertionError in v2.0. + + def __init__(self, scheme): + # 'localhost' is here because our URL parser parses + # localhost:8080 -> scheme=localhost, remove if we fix this. + if scheme == "localhost": + scheme = None + if scheme is None: + message = "Proxy URL had no scheme, should start with http:// or https://" + else: + message = ( + "Proxy URL had unsupported scheme %s, should use http:// or https://" + % scheme + ) + super(ProxySchemeUnknown, self).__init__(message) + + +class ProxySchemeUnsupported(ValueError): + """Fetching HTTPS resources through HTTPS proxies is unsupported""" + + pass + + +class HeaderParsingError(HTTPError): + """Raised by assert_header_parsing, but we convert it to a log.warning statement.""" + + def __init__(self, defects, unparsed_data): + message = "%s, unparsed data: %r" % (defects or "Unknown", unparsed_data) + super(HeaderParsingError, self).__init__(message) + + +class UnrewindableBodyError(HTTPError): + """urllib3 encountered an error when trying to rewind a body""" + + pass diff --git a/openpype/hosts/fusion/vendor/urllib3/fields.py b/openpype/hosts/fusion/vendor/urllib3/fields.py new file mode 100644 index 0000000000..9d630f491d --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/fields.py @@ -0,0 +1,274 @@ +from __future__ import absolute_import + +import email.utils +import mimetypes +import re + +from .packages import six + + +def guess_content_type(filename, default="application/octet-stream"): + """ + Guess the "Content-Type" of a file. + + :param filename: + The filename to guess the "Content-Type" of using :mod:`mimetypes`. + :param default: + If no "Content-Type" can be guessed, default to `default`. + """ + if filename: + return mimetypes.guess_type(filename)[0] or default + return default + + +def format_header_param_rfc2231(name, value): + """ + Helper function to format and quote a single header parameter using the + strategy defined in RFC 2231. + + Particularly useful for header parameters which might contain + non-ASCII values, like file names. This follows + `RFC 2388 Section 4.4 `_. + + :param name: + The name of the parameter, a string expected to be ASCII only. + :param value: + The value of the parameter, provided as ``bytes`` or `str``. + :ret: + An RFC-2231-formatted unicode string. + """ + if isinstance(value, six.binary_type): + value = value.decode("utf-8") + + if not any(ch in value for ch in '"\\\r\n'): + result = u'%s="%s"' % (name, value) + try: + result.encode("ascii") + except (UnicodeEncodeError, UnicodeDecodeError): + pass + else: + return result + + if six.PY2: # Python 2: + value = value.encode("utf-8") + + # encode_rfc2231 accepts an encoded string and returns an ascii-encoded + # string in Python 2 but accepts and returns unicode strings in Python 3 + value = email.utils.encode_rfc2231(value, "utf-8") + value = "%s*=%s" % (name, value) + + if six.PY2: # Python 2: + value = value.decode("utf-8") + + return value + + +_HTML5_REPLACEMENTS = { + u"\u0022": u"%22", + # Replace "\" with "\\". + u"\u005C": u"\u005C\u005C", +} + +# All control characters from 0x00 to 0x1F *except* 0x1B. +_HTML5_REPLACEMENTS.update( + { + six.unichr(cc): u"%{:02X}".format(cc) + for cc in range(0x00, 0x1F + 1) + if cc not in (0x1B,) + } +) + + +def _replace_multiple(value, needles_and_replacements): + def replacer(match): + return needles_and_replacements[match.group(0)] + + pattern = re.compile( + r"|".join([re.escape(needle) for needle in needles_and_replacements.keys()]) + ) + + result = pattern.sub(replacer, value) + + return result + + +def format_header_param_html5(name, value): + """ + Helper function to format and quote a single header parameter using the + HTML5 strategy. + + Particularly useful for header parameters which might contain + non-ASCII values, like file names. This follows the `HTML5 Working Draft + Section 4.10.22.7`_ and matches the behavior of curl and modern browsers. + + .. _HTML5 Working Draft Section 4.10.22.7: + https://w3c.github.io/html/sec-forms.html#multipart-form-data + + :param name: + The name of the parameter, a string expected to be ASCII only. + :param value: + The value of the parameter, provided as ``bytes`` or `str``. + :ret: + A unicode string, stripped of troublesome characters. + """ + if isinstance(value, six.binary_type): + value = value.decode("utf-8") + + value = _replace_multiple(value, _HTML5_REPLACEMENTS) + + return u'%s="%s"' % (name, value) + + +# For backwards-compatibility. +format_header_param = format_header_param_html5 + + +class RequestField(object): + """ + A data container for request body parameters. + + :param name: + The name of this request field. Must be unicode. + :param data: + The data/value body. + :param filename: + An optional filename of the request field. Must be unicode. + :param headers: + An optional dict-like object of headers to initially use for the field. + :param header_formatter: + An optional callable that is used to encode and format the headers. By + default, this is :func:`format_header_param_html5`. + """ + + def __init__( + self, + name, + data, + filename=None, + headers=None, + header_formatter=format_header_param_html5, + ): + self._name = name + self._filename = filename + self.data = data + self.headers = {} + if headers: + self.headers = dict(headers) + self.header_formatter = header_formatter + + @classmethod + def from_tuples(cls, fieldname, value, header_formatter=format_header_param_html5): + """ + A :class:`~urllib3.fields.RequestField` factory from old-style tuple parameters. + + Supports constructing :class:`~urllib3.fields.RequestField` from + parameter of key/value strings AND key/filetuple. A filetuple is a + (filename, data, MIME type) tuple where the MIME type is optional. + For example:: + + 'foo': 'bar', + 'fakefile': ('foofile.txt', 'contents of foofile'), + 'realfile': ('barfile.txt', open('realfile').read()), + 'typedfile': ('bazfile.bin', open('bazfile').read(), 'image/jpeg'), + 'nonamefile': 'contents of nonamefile field', + + Field names and filenames must be unicode. + """ + if isinstance(value, tuple): + if len(value) == 3: + filename, data, content_type = value + else: + filename, data = value + content_type = guess_content_type(filename) + else: + filename = None + content_type = None + data = value + + request_param = cls( + fieldname, data, filename=filename, header_formatter=header_formatter + ) + request_param.make_multipart(content_type=content_type) + + return request_param + + def _render_part(self, name, value): + """ + Overridable helper function to format a single header parameter. By + default, this calls ``self.header_formatter``. + + :param name: + The name of the parameter, a string expected to be ASCII only. + :param value: + The value of the parameter, provided as a unicode string. + """ + + return self.header_formatter(name, value) + + def _render_parts(self, header_parts): + """ + Helper function to format and quote a single header. + + Useful for single headers that are composed of multiple items. E.g., + 'Content-Disposition' fields. + + :param header_parts: + A sequence of (k, v) tuples or a :class:`dict` of (k, v) to format + as `k1="v1"; k2="v2"; ...`. + """ + parts = [] + iterable = header_parts + if isinstance(header_parts, dict): + iterable = header_parts.items() + + for name, value in iterable: + if value is not None: + parts.append(self._render_part(name, value)) + + return u"; ".join(parts) + + def render_headers(self): + """ + Renders the headers for this request field. + """ + lines = [] + + sort_keys = ["Content-Disposition", "Content-Type", "Content-Location"] + for sort_key in sort_keys: + if self.headers.get(sort_key, False): + lines.append(u"%s: %s" % (sort_key, self.headers[sort_key])) + + for header_name, header_value in self.headers.items(): + if header_name not in sort_keys: + if header_value: + lines.append(u"%s: %s" % (header_name, header_value)) + + lines.append(u"\r\n") + return u"\r\n".join(lines) + + def make_multipart( + self, content_disposition=None, content_type=None, content_location=None + ): + """ + Makes this request field into a multipart request field. + + This method overrides "Content-Disposition", "Content-Type" and + "Content-Location" headers to the request parameter. + + :param content_type: + The 'Content-Type' of the request body. + :param content_location: + The 'Content-Location' of the request body. + + """ + self.headers["Content-Disposition"] = content_disposition or u"form-data" + self.headers["Content-Disposition"] += u"; ".join( + [ + u"", + self._render_parts( + ((u"name", self._name), (u"filename", self._filename)) + ), + ] + ) + self.headers["Content-Type"] = content_type + self.headers["Content-Location"] = content_location diff --git a/openpype/hosts/fusion/vendor/urllib3/filepost.py b/openpype/hosts/fusion/vendor/urllib3/filepost.py new file mode 100644 index 0000000000..36c9252c64 --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/filepost.py @@ -0,0 +1,98 @@ +from __future__ import absolute_import + +import binascii +import codecs +import os +from io import BytesIO + +from .fields import RequestField +from .packages import six +from .packages.six import b + +writer = codecs.lookup("utf-8")[3] + + +def choose_boundary(): + """ + Our embarrassingly-simple replacement for mimetools.choose_boundary. + """ + boundary = binascii.hexlify(os.urandom(16)) + if not six.PY2: + boundary = boundary.decode("ascii") + return boundary + + +def iter_field_objects(fields): + """ + Iterate over fields. + + Supports list of (k, v) tuples and dicts, and lists of + :class:`~urllib3.fields.RequestField`. + + """ + if isinstance(fields, dict): + i = six.iteritems(fields) + else: + i = iter(fields) + + for field in i: + if isinstance(field, RequestField): + yield field + else: + yield RequestField.from_tuples(*field) + + +def iter_fields(fields): + """ + .. deprecated:: 1.6 + + Iterate over fields. + + The addition of :class:`~urllib3.fields.RequestField` makes this function + obsolete. Instead, use :func:`iter_field_objects`, which returns + :class:`~urllib3.fields.RequestField` objects. + + Supports list of (k, v) tuples and dicts. + """ + if isinstance(fields, dict): + return ((k, v) for k, v in six.iteritems(fields)) + + return ((k, v) for k, v in fields) + + +def encode_multipart_formdata(fields, boundary=None): + """ + Encode a dictionary of ``fields`` using the multipart/form-data MIME format. + + :param fields: + Dictionary of fields or list of (key, :class:`~urllib3.fields.RequestField`). + + :param boundary: + If not specified, then a random boundary will be generated using + :func:`urllib3.filepost.choose_boundary`. + """ + body = BytesIO() + if boundary is None: + boundary = choose_boundary() + + for field in iter_field_objects(fields): + body.write(b("--%s\r\n" % (boundary))) + + writer(body).write(field.render_headers()) + data = field.data + + if isinstance(data, int): + data = str(data) # Backwards compatibility + + if isinstance(data, six.text_type): + writer(body).write(data) + else: + body.write(data) + + body.write(b"\r\n") + + body.write(b("--%s--\r\n" % (boundary))) + + content_type = str("multipart/form-data; boundary=%s" % boundary) + + return body.getvalue(), content_type diff --git a/openpype/hosts/fusion/vendor/urllib3/packages/__init__.py b/openpype/hosts/fusion/vendor/urllib3/packages/__init__.py new file mode 100644 index 0000000000..fce4caa65d --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/packages/__init__.py @@ -0,0 +1,5 @@ +from __future__ import absolute_import + +from . import ssl_match_hostname + +__all__ = ("ssl_match_hostname",) diff --git a/openpype/hosts/fusion/vendor/urllib3/packages/backports/__init__.py b/openpype/hosts/fusion/vendor/urllib3/packages/backports/__init__.py new file mode 100644 index 0000000000..e69de29bb2 diff --git a/openpype/hosts/fusion/vendor/urllib3/packages/backports/makefile.py b/openpype/hosts/fusion/vendor/urllib3/packages/backports/makefile.py new file mode 100644 index 0000000000..b8fb2154b6 --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/packages/backports/makefile.py @@ -0,0 +1,51 @@ +# -*- coding: utf-8 -*- +""" +backports.makefile +~~~~~~~~~~~~~~~~~~ + +Backports the Python 3 ``socket.makefile`` method for use with anything that +wants to create a "fake" socket object. +""" +import io +from socket import SocketIO + + +def backport_makefile( + self, mode="r", buffering=None, encoding=None, errors=None, newline=None +): + """ + Backport of ``socket.makefile`` from Python 3.5. + """ + if not set(mode) <= {"r", "w", "b"}: + raise ValueError("invalid mode %r (only r, w, b allowed)" % (mode,)) + writing = "w" in mode + reading = "r" in mode or not writing + assert reading or writing + binary = "b" in mode + rawmode = "" + if reading: + rawmode += "r" + if writing: + rawmode += "w" + raw = SocketIO(self, rawmode) + self._makefile_refs += 1 + if buffering is None: + buffering = -1 + if buffering < 0: + buffering = io.DEFAULT_BUFFER_SIZE + if buffering == 0: + if not binary: + raise ValueError("unbuffered streams must be binary") + return raw + if reading and writing: + buffer = io.BufferedRWPair(raw, raw, buffering) + elif reading: + buffer = io.BufferedReader(raw, buffering) + else: + assert writing + buffer = io.BufferedWriter(raw, buffering) + if binary: + return buffer + text = io.TextIOWrapper(buffer, encoding, errors, newline) + text.mode = mode + return text diff --git a/openpype/hosts/fusion/vendor/urllib3/packages/six.py b/openpype/hosts/fusion/vendor/urllib3/packages/six.py new file mode 100644 index 0000000000..ba50acb062 --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/packages/six.py @@ -0,0 +1,1077 @@ +# Copyright (c) 2010-2020 Benjamin Peterson +# +# Permission is hereby granted, free of charge, to any person obtaining a copy +# of this software and associated documentation files (the "Software"), to deal +# in the Software without restriction, including without limitation the rights +# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +# copies of the Software, and to permit persons to whom the Software is +# furnished to do so, subject to the following conditions: +# +# The above copyright notice and this permission notice shall be included in all +# copies or substantial portions of the Software. +# +# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +# SOFTWARE. + +"""Utilities for writing code that runs on Python 2 and 3""" + +from __future__ import absolute_import + +import functools +import itertools +import operator +import sys +import types + +__author__ = "Benjamin Peterson " +__version__ = "1.16.0" + + +# Useful for very coarse version differentiation. +PY2 = sys.version_info[0] == 2 +PY3 = sys.version_info[0] == 3 +PY34 = sys.version_info[0:2] >= (3, 4) + +if PY3: + string_types = (str,) + integer_types = (int,) + class_types = (type,) + text_type = str + binary_type = bytes + + MAXSIZE = sys.maxsize +else: + string_types = (basestring,) + integer_types = (int, long) + class_types = (type, types.ClassType) + text_type = unicode + binary_type = str + + if sys.platform.startswith("java"): + # Jython always uses 32 bits. + MAXSIZE = int((1 << 31) - 1) + else: + # It's possible to have sizeof(long) != sizeof(Py_ssize_t). + class X(object): + def __len__(self): + return 1 << 31 + + try: + len(X()) + except OverflowError: + # 32-bit + MAXSIZE = int((1 << 31) - 1) + else: + # 64-bit + MAXSIZE = int((1 << 63) - 1) + del X + +if PY34: + from importlib.util import spec_from_loader +else: + spec_from_loader = None + + +def _add_doc(func, doc): + """Add documentation to a function.""" + func.__doc__ = doc + + +def _import_module(name): + """Import module, returning the module after the last dot.""" + __import__(name) + return sys.modules[name] + + +class _LazyDescr(object): + def __init__(self, name): + self.name = name + + def __get__(self, obj, tp): + result = self._resolve() + setattr(obj, self.name, result) # Invokes __set__. + try: + # This is a bit ugly, but it avoids running this again by + # removing this descriptor. + delattr(obj.__class__, self.name) + except AttributeError: + pass + return result + + +class MovedModule(_LazyDescr): + def __init__(self, name, old, new=None): + super(MovedModule, self).__init__(name) + if PY3: + if new is None: + new = name + self.mod = new + else: + self.mod = old + + def _resolve(self): + return _import_module(self.mod) + + def __getattr__(self, attr): + _module = self._resolve() + value = getattr(_module, attr) + setattr(self, attr, value) + return value + + +class _LazyModule(types.ModuleType): + def __init__(self, name): + super(_LazyModule, self).__init__(name) + self.__doc__ = self.__class__.__doc__ + + def __dir__(self): + attrs = ["__doc__", "__name__"] + attrs += [attr.name for attr in self._moved_attributes] + return attrs + + # Subclasses should override this + _moved_attributes = [] + + +class MovedAttribute(_LazyDescr): + def __init__(self, name, old_mod, new_mod, old_attr=None, new_attr=None): + super(MovedAttribute, self).__init__(name) + if PY3: + if new_mod is None: + new_mod = name + self.mod = new_mod + if new_attr is None: + if old_attr is None: + new_attr = name + else: + new_attr = old_attr + self.attr = new_attr + else: + self.mod = old_mod + if old_attr is None: + old_attr = name + self.attr = old_attr + + def _resolve(self): + module = _import_module(self.mod) + return getattr(module, self.attr) + + +class _SixMetaPathImporter(object): + + """ + A meta path importer to import six.moves and its submodules. + + This class implements a PEP302 finder and loader. It should be compatible + with Python 2.5 and all existing versions of Python3 + """ + + def __init__(self, six_module_name): + self.name = six_module_name + self.known_modules = {} + + def _add_module(self, mod, *fullnames): + for fullname in fullnames: + self.known_modules[self.name + "." + fullname] = mod + + def _get_module(self, fullname): + return self.known_modules[self.name + "." + fullname] + + def find_module(self, fullname, path=None): + if fullname in self.known_modules: + return self + return None + + def find_spec(self, fullname, path, target=None): + if fullname in self.known_modules: + return spec_from_loader(fullname, self) + return None + + def __get_module(self, fullname): + try: + return self.known_modules[fullname] + except KeyError: + raise ImportError("This loader does not know module " + fullname) + + def load_module(self, fullname): + try: + # in case of a reload + return sys.modules[fullname] + except KeyError: + pass + mod = self.__get_module(fullname) + if isinstance(mod, MovedModule): + mod = mod._resolve() + else: + mod.__loader__ = self + sys.modules[fullname] = mod + return mod + + def is_package(self, fullname): + """ + Return true, if the named module is a package. + + We need this method to get correct spec objects with + Python 3.4 (see PEP451) + """ + return hasattr(self.__get_module(fullname), "__path__") + + def get_code(self, fullname): + """Return None + + Required, if is_package is implemented""" + self.__get_module(fullname) # eventually raises ImportError + return None + + get_source = get_code # same as get_code + + def create_module(self, spec): + return self.load_module(spec.name) + + def exec_module(self, module): + pass + + +_importer = _SixMetaPathImporter(__name__) + + +class _MovedItems(_LazyModule): + + """Lazy loading of moved objects""" + + __path__ = [] # mark as package + + +_moved_attributes = [ + MovedAttribute("cStringIO", "cStringIO", "io", "StringIO"), + MovedAttribute("filter", "itertools", "builtins", "ifilter", "filter"), + MovedAttribute( + "filterfalse", "itertools", "itertools", "ifilterfalse", "filterfalse" + ), + MovedAttribute("input", "__builtin__", "builtins", "raw_input", "input"), + MovedAttribute("intern", "__builtin__", "sys"), + MovedAttribute("map", "itertools", "builtins", "imap", "map"), + MovedAttribute("getcwd", "os", "os", "getcwdu", "getcwd"), + MovedAttribute("getcwdb", "os", "os", "getcwd", "getcwdb"), + MovedAttribute("getoutput", "commands", "subprocess"), + MovedAttribute("range", "__builtin__", "builtins", "xrange", "range"), + MovedAttribute( + "reload_module", "__builtin__", "importlib" if PY34 else "imp", "reload" + ), + MovedAttribute("reduce", "__builtin__", "functools"), + MovedAttribute("shlex_quote", "pipes", "shlex", "quote"), + MovedAttribute("StringIO", "StringIO", "io"), + MovedAttribute("UserDict", "UserDict", "collections"), + MovedAttribute("UserList", "UserList", "collections"), + MovedAttribute("UserString", "UserString", "collections"), + MovedAttribute("xrange", "__builtin__", "builtins", "xrange", "range"), + MovedAttribute("zip", "itertools", "builtins", "izip", "zip"), + MovedAttribute( + "zip_longest", "itertools", "itertools", "izip_longest", "zip_longest" + ), + MovedModule("builtins", "__builtin__"), + MovedModule("configparser", "ConfigParser"), + MovedModule( + "collections_abc", + "collections", + "collections.abc" if sys.version_info >= (3, 3) else "collections", + ), + MovedModule("copyreg", "copy_reg"), + MovedModule("dbm_gnu", "gdbm", "dbm.gnu"), + MovedModule("dbm_ndbm", "dbm", "dbm.ndbm"), + MovedModule( + "_dummy_thread", + "dummy_thread", + "_dummy_thread" if sys.version_info < (3, 9) else "_thread", + ), + MovedModule("http_cookiejar", "cookielib", "http.cookiejar"), + MovedModule("http_cookies", "Cookie", "http.cookies"), + MovedModule("html_entities", "htmlentitydefs", "html.entities"), + MovedModule("html_parser", "HTMLParser", "html.parser"), + MovedModule("http_client", "httplib", "http.client"), + MovedModule("email_mime_base", "email.MIMEBase", "email.mime.base"), + MovedModule("email_mime_image", "email.MIMEImage", "email.mime.image"), + MovedModule("email_mime_multipart", "email.MIMEMultipart", "email.mime.multipart"), + MovedModule( + "email_mime_nonmultipart", "email.MIMENonMultipart", "email.mime.nonmultipart" + ), + MovedModule("email_mime_text", "email.MIMEText", "email.mime.text"), + MovedModule("BaseHTTPServer", "BaseHTTPServer", "http.server"), + MovedModule("CGIHTTPServer", "CGIHTTPServer", "http.server"), + MovedModule("SimpleHTTPServer", "SimpleHTTPServer", "http.server"), + MovedModule("cPickle", "cPickle", "pickle"), + MovedModule("queue", "Queue"), + MovedModule("reprlib", "repr"), + MovedModule("socketserver", "SocketServer"), + MovedModule("_thread", "thread", "_thread"), + MovedModule("tkinter", "Tkinter"), + MovedModule("tkinter_dialog", "Dialog", "tkinter.dialog"), + MovedModule("tkinter_filedialog", "FileDialog", "tkinter.filedialog"), + MovedModule("tkinter_scrolledtext", "ScrolledText", "tkinter.scrolledtext"), + MovedModule("tkinter_simpledialog", "SimpleDialog", "tkinter.simpledialog"), + MovedModule("tkinter_tix", "Tix", "tkinter.tix"), + MovedModule("tkinter_ttk", "ttk", "tkinter.ttk"), + MovedModule("tkinter_constants", "Tkconstants", "tkinter.constants"), + MovedModule("tkinter_dnd", "Tkdnd", "tkinter.dnd"), + MovedModule("tkinter_colorchooser", "tkColorChooser", "tkinter.colorchooser"), + MovedModule("tkinter_commondialog", "tkCommonDialog", "tkinter.commondialog"), + MovedModule("tkinter_tkfiledialog", "tkFileDialog", "tkinter.filedialog"), + MovedModule("tkinter_font", "tkFont", "tkinter.font"), + MovedModule("tkinter_messagebox", "tkMessageBox", "tkinter.messagebox"), + MovedModule("tkinter_tksimpledialog", "tkSimpleDialog", "tkinter.simpledialog"), + MovedModule("urllib_parse", __name__ + ".moves.urllib_parse", "urllib.parse"), + MovedModule("urllib_error", __name__ + ".moves.urllib_error", "urllib.error"), + MovedModule("urllib", __name__ + ".moves.urllib", __name__ + ".moves.urllib"), + MovedModule("urllib_robotparser", "robotparser", "urllib.robotparser"), + MovedModule("xmlrpc_client", "xmlrpclib", "xmlrpc.client"), + MovedModule("xmlrpc_server", "SimpleXMLRPCServer", "xmlrpc.server"), +] +# Add windows specific modules. +if sys.platform == "win32": + _moved_attributes += [ + MovedModule("winreg", "_winreg"), + ] + +for attr in _moved_attributes: + setattr(_MovedItems, attr.name, attr) + if isinstance(attr, MovedModule): + _importer._add_module(attr, "moves." + attr.name) +del attr + +_MovedItems._moved_attributes = _moved_attributes + +moves = _MovedItems(__name__ + ".moves") +_importer._add_module(moves, "moves") + + +class Module_six_moves_urllib_parse(_LazyModule): + + """Lazy loading of moved objects in six.moves.urllib_parse""" + + +_urllib_parse_moved_attributes = [ + MovedAttribute("ParseResult", "urlparse", "urllib.parse"), + MovedAttribute("SplitResult", "urlparse", "urllib.parse"), + MovedAttribute("parse_qs", "urlparse", "urllib.parse"), + MovedAttribute("parse_qsl", "urlparse", "urllib.parse"), + MovedAttribute("urldefrag", "urlparse", "urllib.parse"), + MovedAttribute("urljoin", "urlparse", "urllib.parse"), + MovedAttribute("urlparse", "urlparse", "urllib.parse"), + MovedAttribute("urlsplit", "urlparse", "urllib.parse"), + MovedAttribute("urlunparse", "urlparse", "urllib.parse"), + MovedAttribute("urlunsplit", "urlparse", "urllib.parse"), + MovedAttribute("quote", "urllib", "urllib.parse"), + MovedAttribute("quote_plus", "urllib", "urllib.parse"), + MovedAttribute("unquote", "urllib", "urllib.parse"), + MovedAttribute("unquote_plus", "urllib", "urllib.parse"), + MovedAttribute( + "unquote_to_bytes", "urllib", "urllib.parse", "unquote", "unquote_to_bytes" + ), + MovedAttribute("urlencode", "urllib", "urllib.parse"), + MovedAttribute("splitquery", "urllib", "urllib.parse"), + MovedAttribute("splittag", "urllib", "urllib.parse"), + MovedAttribute("splituser", "urllib", "urllib.parse"), + MovedAttribute("splitvalue", "urllib", "urllib.parse"), + MovedAttribute("uses_fragment", "urlparse", "urllib.parse"), + MovedAttribute("uses_netloc", "urlparse", "urllib.parse"), + MovedAttribute("uses_params", "urlparse", "urllib.parse"), + MovedAttribute("uses_query", "urlparse", "urllib.parse"), + MovedAttribute("uses_relative", "urlparse", "urllib.parse"), +] +for attr in _urllib_parse_moved_attributes: + setattr(Module_six_moves_urllib_parse, attr.name, attr) +del attr + +Module_six_moves_urllib_parse._moved_attributes = _urllib_parse_moved_attributes + +_importer._add_module( + Module_six_moves_urllib_parse(__name__ + ".moves.urllib_parse"), + "moves.urllib_parse", + "moves.urllib.parse", +) + + +class Module_six_moves_urllib_error(_LazyModule): + + """Lazy loading of moved objects in six.moves.urllib_error""" + + +_urllib_error_moved_attributes = [ + MovedAttribute("URLError", "urllib2", "urllib.error"), + MovedAttribute("HTTPError", "urllib2", "urllib.error"), + MovedAttribute("ContentTooShortError", "urllib", "urllib.error"), +] +for attr in _urllib_error_moved_attributes: + setattr(Module_six_moves_urllib_error, attr.name, attr) +del attr + +Module_six_moves_urllib_error._moved_attributes = _urllib_error_moved_attributes + +_importer._add_module( + Module_six_moves_urllib_error(__name__ + ".moves.urllib.error"), + "moves.urllib_error", + "moves.urllib.error", +) + + +class Module_six_moves_urllib_request(_LazyModule): + + """Lazy loading of moved objects in six.moves.urllib_request""" + + +_urllib_request_moved_attributes = [ + MovedAttribute("urlopen", "urllib2", "urllib.request"), + MovedAttribute("install_opener", "urllib2", "urllib.request"), + MovedAttribute("build_opener", "urllib2", "urllib.request"), + MovedAttribute("pathname2url", "urllib", "urllib.request"), + MovedAttribute("url2pathname", "urllib", "urllib.request"), + MovedAttribute("getproxies", "urllib", "urllib.request"), + MovedAttribute("Request", "urllib2", "urllib.request"), + MovedAttribute("OpenerDirector", "urllib2", "urllib.request"), + MovedAttribute("HTTPDefaultErrorHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPRedirectHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPCookieProcessor", "urllib2", "urllib.request"), + MovedAttribute("ProxyHandler", "urllib2", "urllib.request"), + MovedAttribute("BaseHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPPasswordMgr", "urllib2", "urllib.request"), + MovedAttribute("HTTPPasswordMgrWithDefaultRealm", "urllib2", "urllib.request"), + MovedAttribute("AbstractBasicAuthHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPBasicAuthHandler", "urllib2", "urllib.request"), + MovedAttribute("ProxyBasicAuthHandler", "urllib2", "urllib.request"), + MovedAttribute("AbstractDigestAuthHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPDigestAuthHandler", "urllib2", "urllib.request"), + MovedAttribute("ProxyDigestAuthHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPSHandler", "urllib2", "urllib.request"), + MovedAttribute("FileHandler", "urllib2", "urllib.request"), + MovedAttribute("FTPHandler", "urllib2", "urllib.request"), + MovedAttribute("CacheFTPHandler", "urllib2", "urllib.request"), + MovedAttribute("UnknownHandler", "urllib2", "urllib.request"), + MovedAttribute("HTTPErrorProcessor", "urllib2", "urllib.request"), + MovedAttribute("urlretrieve", "urllib", "urllib.request"), + MovedAttribute("urlcleanup", "urllib", "urllib.request"), + MovedAttribute("URLopener", "urllib", "urllib.request"), + MovedAttribute("FancyURLopener", "urllib", "urllib.request"), + MovedAttribute("proxy_bypass", "urllib", "urllib.request"), + MovedAttribute("parse_http_list", "urllib2", "urllib.request"), + MovedAttribute("parse_keqv_list", "urllib2", "urllib.request"), +] +for attr in _urllib_request_moved_attributes: + setattr(Module_six_moves_urllib_request, attr.name, attr) +del attr + +Module_six_moves_urllib_request._moved_attributes = _urllib_request_moved_attributes + +_importer._add_module( + Module_six_moves_urllib_request(__name__ + ".moves.urllib.request"), + "moves.urllib_request", + "moves.urllib.request", +) + + +class Module_six_moves_urllib_response(_LazyModule): + + """Lazy loading of moved objects in six.moves.urllib_response""" + + +_urllib_response_moved_attributes = [ + MovedAttribute("addbase", "urllib", "urllib.response"), + MovedAttribute("addclosehook", "urllib", "urllib.response"), + MovedAttribute("addinfo", "urllib", "urllib.response"), + MovedAttribute("addinfourl", "urllib", "urllib.response"), +] +for attr in _urllib_response_moved_attributes: + setattr(Module_six_moves_urllib_response, attr.name, attr) +del attr + +Module_six_moves_urllib_response._moved_attributes = _urllib_response_moved_attributes + +_importer._add_module( + Module_six_moves_urllib_response(__name__ + ".moves.urllib.response"), + "moves.urllib_response", + "moves.urllib.response", +) + + +class Module_six_moves_urllib_robotparser(_LazyModule): + + """Lazy loading of moved objects in six.moves.urllib_robotparser""" + + +_urllib_robotparser_moved_attributes = [ + MovedAttribute("RobotFileParser", "robotparser", "urllib.robotparser"), +] +for attr in _urllib_robotparser_moved_attributes: + setattr(Module_six_moves_urllib_robotparser, attr.name, attr) +del attr + +Module_six_moves_urllib_robotparser._moved_attributes = ( + _urllib_robotparser_moved_attributes +) + +_importer._add_module( + Module_six_moves_urllib_robotparser(__name__ + ".moves.urllib.robotparser"), + "moves.urllib_robotparser", + "moves.urllib.robotparser", +) + + +class Module_six_moves_urllib(types.ModuleType): + + """Create a six.moves.urllib namespace that resembles the Python 3 namespace""" + + __path__ = [] # mark as package + parse = _importer._get_module("moves.urllib_parse") + error = _importer._get_module("moves.urllib_error") + request = _importer._get_module("moves.urllib_request") + response = _importer._get_module("moves.urllib_response") + robotparser = _importer._get_module("moves.urllib_robotparser") + + def __dir__(self): + return ["parse", "error", "request", "response", "robotparser"] + + +_importer._add_module( + Module_six_moves_urllib(__name__ + ".moves.urllib"), "moves.urllib" +) + + +def add_move(move): + """Add an item to six.moves.""" + setattr(_MovedItems, move.name, move) + + +def remove_move(name): + """Remove item from six.moves.""" + try: + delattr(_MovedItems, name) + except AttributeError: + try: + del moves.__dict__[name] + except KeyError: + raise AttributeError("no such move, %r" % (name,)) + + +if PY3: + _meth_func = "__func__" + _meth_self = "__self__" + + _func_closure = "__closure__" + _func_code = "__code__" + _func_defaults = "__defaults__" + _func_globals = "__globals__" +else: + _meth_func = "im_func" + _meth_self = "im_self" + + _func_closure = "func_closure" + _func_code = "func_code" + _func_defaults = "func_defaults" + _func_globals = "func_globals" + + +try: + advance_iterator = next +except NameError: + + def advance_iterator(it): + return it.next() + + +next = advance_iterator + + +try: + callable = callable +except NameError: + + def callable(obj): + return any("__call__" in klass.__dict__ for klass in type(obj).__mro__) + + +if PY3: + + def get_unbound_function(unbound): + return unbound + + create_bound_method = types.MethodType + + def create_unbound_method(func, cls): + return func + + Iterator = object +else: + + def get_unbound_function(unbound): + return unbound.im_func + + def create_bound_method(func, obj): + return types.MethodType(func, obj, obj.__class__) + + def create_unbound_method(func, cls): + return types.MethodType(func, None, cls) + + class Iterator(object): + def next(self): + return type(self).__next__(self) + + callable = callable +_add_doc( + get_unbound_function, """Get the function out of a possibly unbound function""" +) + + +get_method_function = operator.attrgetter(_meth_func) +get_method_self = operator.attrgetter(_meth_self) +get_function_closure = operator.attrgetter(_func_closure) +get_function_code = operator.attrgetter(_func_code) +get_function_defaults = operator.attrgetter(_func_defaults) +get_function_globals = operator.attrgetter(_func_globals) + + +if PY3: + + def iterkeys(d, **kw): + return iter(d.keys(**kw)) + + def itervalues(d, **kw): + return iter(d.values(**kw)) + + def iteritems(d, **kw): + return iter(d.items(**kw)) + + def iterlists(d, **kw): + return iter(d.lists(**kw)) + + viewkeys = operator.methodcaller("keys") + + viewvalues = operator.methodcaller("values") + + viewitems = operator.methodcaller("items") +else: + + def iterkeys(d, **kw): + return d.iterkeys(**kw) + + def itervalues(d, **kw): + return d.itervalues(**kw) + + def iteritems(d, **kw): + return d.iteritems(**kw) + + def iterlists(d, **kw): + return d.iterlists(**kw) + + viewkeys = operator.methodcaller("viewkeys") + + viewvalues = operator.methodcaller("viewvalues") + + viewitems = operator.methodcaller("viewitems") + +_add_doc(iterkeys, "Return an iterator over the keys of a dictionary.") +_add_doc(itervalues, "Return an iterator over the values of a dictionary.") +_add_doc(iteritems, "Return an iterator over the (key, value) pairs of a dictionary.") +_add_doc( + iterlists, "Return an iterator over the (key, [values]) pairs of a dictionary." +) + + +if PY3: + + def b(s): + return s.encode("latin-1") + + def u(s): + return s + + unichr = chr + import struct + + int2byte = struct.Struct(">B").pack + del struct + byte2int = operator.itemgetter(0) + indexbytes = operator.getitem + iterbytes = iter + import io + + StringIO = io.StringIO + BytesIO = io.BytesIO + del io + _assertCountEqual = "assertCountEqual" + if sys.version_info[1] <= 1: + _assertRaisesRegex = "assertRaisesRegexp" + _assertRegex = "assertRegexpMatches" + _assertNotRegex = "assertNotRegexpMatches" + else: + _assertRaisesRegex = "assertRaisesRegex" + _assertRegex = "assertRegex" + _assertNotRegex = "assertNotRegex" +else: + + def b(s): + return s + + # Workaround for standalone backslash + + def u(s): + return unicode(s.replace(r"\\", r"\\\\"), "unicode_escape") + + unichr = unichr + int2byte = chr + + def byte2int(bs): + return ord(bs[0]) + + def indexbytes(buf, i): + return ord(buf[i]) + + iterbytes = functools.partial(itertools.imap, ord) + import StringIO + + StringIO = BytesIO = StringIO.StringIO + _assertCountEqual = "assertItemsEqual" + _assertRaisesRegex = "assertRaisesRegexp" + _assertRegex = "assertRegexpMatches" + _assertNotRegex = "assertNotRegexpMatches" +_add_doc(b, """Byte literal""") +_add_doc(u, """Text literal""") + + +def assertCountEqual(self, *args, **kwargs): + return getattr(self, _assertCountEqual)(*args, **kwargs) + + +def assertRaisesRegex(self, *args, **kwargs): + return getattr(self, _assertRaisesRegex)(*args, **kwargs) + + +def assertRegex(self, *args, **kwargs): + return getattr(self, _assertRegex)(*args, **kwargs) + + +def assertNotRegex(self, *args, **kwargs): + return getattr(self, _assertNotRegex)(*args, **kwargs) + + +if PY3: + exec_ = getattr(moves.builtins, "exec") + + def reraise(tp, value, tb=None): + try: + if value is None: + value = tp() + if value.__traceback__ is not tb: + raise value.with_traceback(tb) + raise value + finally: + value = None + tb = None + + +else: + + def exec_(_code_, _globs_=None, _locs_=None): + """Execute code in a namespace.""" + if _globs_ is None: + frame = sys._getframe(1) + _globs_ = frame.f_globals + if _locs_ is None: + _locs_ = frame.f_locals + del frame + elif _locs_ is None: + _locs_ = _globs_ + exec ("""exec _code_ in _globs_, _locs_""") + + exec_( + """def reraise(tp, value, tb=None): + try: + raise tp, value, tb + finally: + tb = None +""" + ) + + +if sys.version_info[:2] > (3,): + exec_( + """def raise_from(value, from_value): + try: + raise value from from_value + finally: + value = None +""" + ) +else: + + def raise_from(value, from_value): + raise value + + +print_ = getattr(moves.builtins, "print", None) +if print_ is None: + + def print_(*args, **kwargs): + """The new-style print function for Python 2.4 and 2.5.""" + fp = kwargs.pop("file", sys.stdout) + if fp is None: + return + + def write(data): + if not isinstance(data, basestring): + data = str(data) + # If the file has an encoding, encode unicode with it. + if ( + isinstance(fp, file) + and isinstance(data, unicode) + and fp.encoding is not None + ): + errors = getattr(fp, "errors", None) + if errors is None: + errors = "strict" + data = data.encode(fp.encoding, errors) + fp.write(data) + + want_unicode = False + sep = kwargs.pop("sep", None) + if sep is not None: + if isinstance(sep, unicode): + want_unicode = True + elif not isinstance(sep, str): + raise TypeError("sep must be None or a string") + end = kwargs.pop("end", None) + if end is not None: + if isinstance(end, unicode): + want_unicode = True + elif not isinstance(end, str): + raise TypeError("end must be None or a string") + if kwargs: + raise TypeError("invalid keyword arguments to print()") + if not want_unicode: + for arg in args: + if isinstance(arg, unicode): + want_unicode = True + break + if want_unicode: + newline = unicode("\n") + space = unicode(" ") + else: + newline = "\n" + space = " " + if sep is None: + sep = space + if end is None: + end = newline + for i, arg in enumerate(args): + if i: + write(sep) + write(arg) + write(end) + + +if sys.version_info[:2] < (3, 3): + _print = print_ + + def print_(*args, **kwargs): + fp = kwargs.get("file", sys.stdout) + flush = kwargs.pop("flush", False) + _print(*args, **kwargs) + if flush and fp is not None: + fp.flush() + + +_add_doc(reraise, """Reraise an exception.""") + +if sys.version_info[0:2] < (3, 4): + # This does exactly the same what the :func:`py3:functools.update_wrapper` + # function does on Python versions after 3.2. It sets the ``__wrapped__`` + # attribute on ``wrapper`` object and it doesn't raise an error if any of + # the attributes mentioned in ``assigned`` and ``updated`` are missing on + # ``wrapped`` object. + def _update_wrapper( + wrapper, + wrapped, + assigned=functools.WRAPPER_ASSIGNMENTS, + updated=functools.WRAPPER_UPDATES, + ): + for attr in assigned: + try: + value = getattr(wrapped, attr) + except AttributeError: + continue + else: + setattr(wrapper, attr, value) + for attr in updated: + getattr(wrapper, attr).update(getattr(wrapped, attr, {})) + wrapper.__wrapped__ = wrapped + return wrapper + + _update_wrapper.__doc__ = functools.update_wrapper.__doc__ + + def wraps( + wrapped, + assigned=functools.WRAPPER_ASSIGNMENTS, + updated=functools.WRAPPER_UPDATES, + ): + return functools.partial( + _update_wrapper, wrapped=wrapped, assigned=assigned, updated=updated + ) + + wraps.__doc__ = functools.wraps.__doc__ + +else: + wraps = functools.wraps + + +def with_metaclass(meta, *bases): + """Create a base class with a metaclass.""" + # This requires a bit of explanation: the basic idea is to make a dummy + # metaclass for one level of class instantiation that replaces itself with + # the actual metaclass. + class metaclass(type): + def __new__(cls, name, this_bases, d): + if sys.version_info[:2] >= (3, 7): + # This version introduced PEP 560 that requires a bit + # of extra care (we mimic what is done by __build_class__). + resolved_bases = types.resolve_bases(bases) + if resolved_bases is not bases: + d["__orig_bases__"] = bases + else: + resolved_bases = bases + return meta(name, resolved_bases, d) + + @classmethod + def __prepare__(cls, name, this_bases): + return meta.__prepare__(name, bases) + + return type.__new__(metaclass, "temporary_class", (), {}) + + +def add_metaclass(metaclass): + """Class decorator for creating a class with a metaclass.""" + + def wrapper(cls): + orig_vars = cls.__dict__.copy() + slots = orig_vars.get("__slots__") + if slots is not None: + if isinstance(slots, str): + slots = [slots] + for slots_var in slots: + orig_vars.pop(slots_var) + orig_vars.pop("__dict__", None) + orig_vars.pop("__weakref__", None) + if hasattr(cls, "__qualname__"): + orig_vars["__qualname__"] = cls.__qualname__ + return metaclass(cls.__name__, cls.__bases__, orig_vars) + + return wrapper + + +def ensure_binary(s, encoding="utf-8", errors="strict"): + """Coerce **s** to six.binary_type. + + For Python 2: + - `unicode` -> encoded to `str` + - `str` -> `str` + + For Python 3: + - `str` -> encoded to `bytes` + - `bytes` -> `bytes` + """ + if isinstance(s, binary_type): + return s + if isinstance(s, text_type): + return s.encode(encoding, errors) + raise TypeError("not expecting type '%s'" % type(s)) + + +def ensure_str(s, encoding="utf-8", errors="strict"): + """Coerce *s* to `str`. + + For Python 2: + - `unicode` -> encoded to `str` + - `str` -> `str` + + For Python 3: + - `str` -> `str` + - `bytes` -> decoded to `str` + """ + # Optimization: Fast return for the common case. + if type(s) is str: + return s + if PY2 and isinstance(s, text_type): + return s.encode(encoding, errors) + elif PY3 and isinstance(s, binary_type): + return s.decode(encoding, errors) + elif not isinstance(s, (text_type, binary_type)): + raise TypeError("not expecting type '%s'" % type(s)) + return s + + +def ensure_text(s, encoding="utf-8", errors="strict"): + """Coerce *s* to six.text_type. + + For Python 2: + - `unicode` -> `unicode` + - `str` -> `unicode` + + For Python 3: + - `str` -> `str` + - `bytes` -> decoded to `str` + """ + if isinstance(s, binary_type): + return s.decode(encoding, errors) + elif isinstance(s, text_type): + return s + else: + raise TypeError("not expecting type '%s'" % type(s)) + + +def python_2_unicode_compatible(klass): + """ + A class decorator that defines __unicode__ and __str__ methods under Python 2. + Under Python 3 it does nothing. + + To support Python 2 and 3 with a single code base, define a __str__ method + returning text and apply this decorator to the class. + """ + if PY2: + if "__str__" not in klass.__dict__: + raise ValueError( + "@python_2_unicode_compatible cannot be applied " + "to %s because it doesn't define __str__()." % klass.__name__ + ) + klass.__unicode__ = klass.__str__ + klass.__str__ = lambda self: self.__unicode__().encode("utf-8") + return klass + + +# Complete the moves implementation. +# This code is at the end of this module to speed up module loading. +# Turn this module into a package. +__path__ = [] # required for PEP 302 and PEP 451 +__package__ = __name__ # see PEP 366 @ReservedAssignment +if globals().get("__spec__") is not None: + __spec__.submodule_search_locations = [] # PEP 451 @UndefinedVariable +# Remove other six meta path importers, since they cause problems. This can +# happen if six is removed from sys.modules and then reloaded. (Setuptools does +# this for some reason.) +if sys.meta_path: + for i, importer in enumerate(sys.meta_path): + # Here's some real nastiness: Another "instance" of the six module might + # be floating around. Therefore, we can't use isinstance() to check for + # the six meta path importer, since the other six instance will have + # inserted an importer with different class. + if ( + type(importer).__name__ == "_SixMetaPathImporter" + and importer.name == __name__ + ): + del sys.meta_path[i] + break + del i, importer +# Finally, add the importer to the meta path import hook. +sys.meta_path.append(_importer) diff --git a/openpype/hosts/fusion/vendor/urllib3/packages/ssl_match_hostname/__init__.py b/openpype/hosts/fusion/vendor/urllib3/packages/ssl_match_hostname/__init__.py new file mode 100644 index 0000000000..ef3fde5206 --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/packages/ssl_match_hostname/__init__.py @@ -0,0 +1,24 @@ +import sys + +try: + # Our match_hostname function is the same as 3.10's, so we only want to + # import the match_hostname function if it's at least that good. + # We also fallback on Python 3.10+ because our code doesn't emit + # deprecation warnings and is the same as Python 3.10 otherwise. + if sys.version_info < (3, 5) or sys.version_info >= (3, 10): + raise ImportError("Fallback to vendored code") + + from ssl import CertificateError, match_hostname +except ImportError: + try: + # Backport of the function from a pypi module + from backports.ssl_match_hostname import ( # type: ignore + CertificateError, + match_hostname, + ) + except ImportError: + # Our vendored copy + from ._implementation import CertificateError, match_hostname # type: ignore + +# Not needed, but documenting what we provide. +__all__ = ("CertificateError", "match_hostname") diff --git a/openpype/hosts/fusion/vendor/urllib3/packages/ssl_match_hostname/_implementation.py b/openpype/hosts/fusion/vendor/urllib3/packages/ssl_match_hostname/_implementation.py new file mode 100644 index 0000000000..689208d3c6 --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/packages/ssl_match_hostname/_implementation.py @@ -0,0 +1,160 @@ +"""The match_hostname() function from Python 3.3.3, essential when using SSL.""" + +# Note: This file is under the PSF license as the code comes from the python +# stdlib. http://docs.python.org/3/license.html + +import re +import sys + +# ipaddress has been backported to 2.6+ in pypi. If it is installed on the +# system, use it to handle IPAddress ServerAltnames (this was added in +# python-3.5) otherwise only do DNS matching. This allows +# backports.ssl_match_hostname to continue to be used in Python 2.7. +try: + import ipaddress +except ImportError: + ipaddress = None + +__version__ = "3.5.0.1" + + +class CertificateError(ValueError): + pass + + +def _dnsname_match(dn, hostname, max_wildcards=1): + """Matching according to RFC 6125, section 6.4.3 + + http://tools.ietf.org/html/rfc6125#section-6.4.3 + """ + pats = [] + if not dn: + return False + + # Ported from python3-syntax: + # leftmost, *remainder = dn.split(r'.') + parts = dn.split(r".") + leftmost = parts[0] + remainder = parts[1:] + + wildcards = leftmost.count("*") + if wildcards > max_wildcards: + # Issue #17980: avoid denials of service by refusing more + # than one wildcard per fragment. A survey of established + # policy among SSL implementations showed it to be a + # reasonable choice. + raise CertificateError( + "too many wildcards in certificate DNS name: " + repr(dn) + ) + + # speed up common case w/o wildcards + if not wildcards: + return dn.lower() == hostname.lower() + + # RFC 6125, section 6.4.3, subitem 1. + # The client SHOULD NOT attempt to match a presented identifier in which + # the wildcard character comprises a label other than the left-most label. + if leftmost == "*": + # When '*' is a fragment by itself, it matches a non-empty dotless + # fragment. + pats.append("[^.]+") + elif leftmost.startswith("xn--") or hostname.startswith("xn--"): + # RFC 6125, section 6.4.3, subitem 3. + # The client SHOULD NOT attempt to match a presented identifier + # where the wildcard character is embedded within an A-label or + # U-label of an internationalized domain name. + pats.append(re.escape(leftmost)) + else: + # Otherwise, '*' matches any dotless string, e.g. www* + pats.append(re.escape(leftmost).replace(r"\*", "[^.]*")) + + # add the remaining fragments, ignore any wildcards + for frag in remainder: + pats.append(re.escape(frag)) + + pat = re.compile(r"\A" + r"\.".join(pats) + r"\Z", re.IGNORECASE) + return pat.match(hostname) + + +def _to_unicode(obj): + if isinstance(obj, str) and sys.version_info < (3,): + obj = unicode(obj, encoding="ascii", errors="strict") + return obj + + +def _ipaddress_match(ipname, host_ip): + """Exact matching of IP addresses. + + RFC 6125 explicitly doesn't define an algorithm for this + (section 1.7.2 - "Out of Scope"). + """ + # OpenSSL may add a trailing newline to a subjectAltName's IP address + # Divergence from upstream: ipaddress can't handle byte str + ip = ipaddress.ip_address(_to_unicode(ipname).rstrip()) + return ip == host_ip + + +def match_hostname(cert, hostname): + """Verify that *cert* (in decoded format as returned by + SSLSocket.getpeercert()) matches the *hostname*. RFC 2818 and RFC 6125 + rules are followed, but IP addresses are not accepted for *hostname*. + + CertificateError is raised on failure. On success, the function + returns nothing. + """ + if not cert: + raise ValueError( + "empty or no certificate, match_hostname needs a " + "SSL socket or SSL context with either " + "CERT_OPTIONAL or CERT_REQUIRED" + ) + try: + # Divergence from upstream: ipaddress can't handle byte str + host_ip = ipaddress.ip_address(_to_unicode(hostname)) + except ValueError: + # Not an IP address (common case) + host_ip = None + except UnicodeError: + # Divergence from upstream: Have to deal with ipaddress not taking + # byte strings. addresses should be all ascii, so we consider it not + # an ipaddress in this case + host_ip = None + except AttributeError: + # Divergence from upstream: Make ipaddress library optional + if ipaddress is None: + host_ip = None + else: + raise + dnsnames = [] + san = cert.get("subjectAltName", ()) + for key, value in san: + if key == "DNS": + if host_ip is None and _dnsname_match(value, hostname): + return + dnsnames.append(value) + elif key == "IP Address": + if host_ip is not None and _ipaddress_match(value, host_ip): + return + dnsnames.append(value) + if not dnsnames: + # The subject is only checked when there is no dNSName entry + # in subjectAltName + for sub in cert.get("subject", ()): + for key, value in sub: + # XXX according to RFC 2818, the most specific Common Name + # must be used. + if key == "commonName": + if _dnsname_match(value, hostname): + return + dnsnames.append(value) + if len(dnsnames) > 1: + raise CertificateError( + "hostname %r " + "doesn't match either of %s" % (hostname, ", ".join(map(repr, dnsnames))) + ) + elif len(dnsnames) == 1: + raise CertificateError("hostname %r doesn't match %r" % (hostname, dnsnames[0])) + else: + raise CertificateError( + "no appropriate commonName or subjectAltName fields were found" + ) diff --git a/openpype/hosts/fusion/vendor/urllib3/poolmanager.py b/openpype/hosts/fusion/vendor/urllib3/poolmanager.py new file mode 100644 index 0000000000..3a31a285bf --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/poolmanager.py @@ -0,0 +1,536 @@ +from __future__ import absolute_import + +import collections +import functools +import logging + +from ._collections import RecentlyUsedContainer +from .connectionpool import HTTPConnectionPool, HTTPSConnectionPool, port_by_scheme +from .exceptions import ( + LocationValueError, + MaxRetryError, + ProxySchemeUnknown, + ProxySchemeUnsupported, + URLSchemeUnknown, +) +from .packages import six +from .packages.six.moves.urllib.parse import urljoin +from .request import RequestMethods +from .util.proxy import connection_requires_http_tunnel +from .util.retry import Retry +from .util.url import parse_url + +__all__ = ["PoolManager", "ProxyManager", "proxy_from_url"] + + +log = logging.getLogger(__name__) + +SSL_KEYWORDS = ( + "key_file", + "cert_file", + "cert_reqs", + "ca_certs", + "ssl_version", + "ca_cert_dir", + "ssl_context", + "key_password", +) + +# All known keyword arguments that could be provided to the pool manager, its +# pools, or the underlying connections. This is used to construct a pool key. +_key_fields = ( + "key_scheme", # str + "key_host", # str + "key_port", # int + "key_timeout", # int or float or Timeout + "key_retries", # int or Retry + "key_strict", # bool + "key_block", # bool + "key_source_address", # str + "key_key_file", # str + "key_key_password", # str + "key_cert_file", # str + "key_cert_reqs", # str + "key_ca_certs", # str + "key_ssl_version", # str + "key_ca_cert_dir", # str + "key_ssl_context", # instance of ssl.SSLContext or urllib3.util.ssl_.SSLContext + "key_maxsize", # int + "key_headers", # dict + "key__proxy", # parsed proxy url + "key__proxy_headers", # dict + "key__proxy_config", # class + "key_socket_options", # list of (level (int), optname (int), value (int or str)) tuples + "key__socks_options", # dict + "key_assert_hostname", # bool or string + "key_assert_fingerprint", # str + "key_server_hostname", # str +) + +#: The namedtuple class used to construct keys for the connection pool. +#: All custom key schemes should include the fields in this key at a minimum. +PoolKey = collections.namedtuple("PoolKey", _key_fields) + +_proxy_config_fields = ("ssl_context", "use_forwarding_for_https") +ProxyConfig = collections.namedtuple("ProxyConfig", _proxy_config_fields) + + +def _default_key_normalizer(key_class, request_context): + """ + Create a pool key out of a request context dictionary. + + According to RFC 3986, both the scheme and host are case-insensitive. + Therefore, this function normalizes both before constructing the pool + key for an HTTPS request. If you wish to change this behaviour, provide + alternate callables to ``key_fn_by_scheme``. + + :param key_class: + The class to use when constructing the key. This should be a namedtuple + with the ``scheme`` and ``host`` keys at a minimum. + :type key_class: namedtuple + :param request_context: + A dictionary-like object that contain the context for a request. + :type request_context: dict + + :return: A namedtuple that can be used as a connection pool key. + :rtype: PoolKey + """ + # Since we mutate the dictionary, make a copy first + context = request_context.copy() + context["scheme"] = context["scheme"].lower() + context["host"] = context["host"].lower() + + # These are both dictionaries and need to be transformed into frozensets + for key in ("headers", "_proxy_headers", "_socks_options"): + if key in context and context[key] is not None: + context[key] = frozenset(context[key].items()) + + # The socket_options key may be a list and needs to be transformed into a + # tuple. + socket_opts = context.get("socket_options") + if socket_opts is not None: + context["socket_options"] = tuple(socket_opts) + + # Map the kwargs to the names in the namedtuple - this is necessary since + # namedtuples can't have fields starting with '_'. + for key in list(context.keys()): + context["key_" + key] = context.pop(key) + + # Default to ``None`` for keys missing from the context + for field in key_class._fields: + if field not in context: + context[field] = None + + return key_class(**context) + + +#: A dictionary that maps a scheme to a callable that creates a pool key. +#: This can be used to alter the way pool keys are constructed, if desired. +#: Each PoolManager makes a copy of this dictionary so they can be configured +#: globally here, or individually on the instance. +key_fn_by_scheme = { + "http": functools.partial(_default_key_normalizer, PoolKey), + "https": functools.partial(_default_key_normalizer, PoolKey), +} + +pool_classes_by_scheme = {"http": HTTPConnectionPool, "https": HTTPSConnectionPool} + + +class PoolManager(RequestMethods): + """ + Allows for arbitrary requests while transparently keeping track of + necessary connection pools for you. + + :param num_pools: + Number of connection pools to cache before discarding the least + recently used pool. + + :param headers: + Headers to include with all requests, unless other headers are given + explicitly. + + :param \\**connection_pool_kw: + Additional parameters are used to create fresh + :class:`urllib3.connectionpool.ConnectionPool` instances. + + Example:: + + >>> manager = PoolManager(num_pools=2) + >>> r = manager.request('GET', 'http://google.com/') + >>> r = manager.request('GET', 'http://google.com/mail') + >>> r = manager.request('GET', 'http://yahoo.com/') + >>> len(manager.pools) + 2 + + """ + + proxy = None + proxy_config = None + + def __init__(self, num_pools=10, headers=None, **connection_pool_kw): + RequestMethods.__init__(self, headers) + self.connection_pool_kw = connection_pool_kw + self.pools = RecentlyUsedContainer(num_pools, dispose_func=lambda p: p.close()) + + # Locally set the pool classes and keys so other PoolManagers can + # override them. + self.pool_classes_by_scheme = pool_classes_by_scheme + self.key_fn_by_scheme = key_fn_by_scheme.copy() + + def __enter__(self): + return self + + def __exit__(self, exc_type, exc_val, exc_tb): + self.clear() + # Return False to re-raise any potential exceptions + return False + + def _new_pool(self, scheme, host, port, request_context=None): + """ + Create a new :class:`urllib3.connectionpool.ConnectionPool` based on host, port, scheme, and + any additional pool keyword arguments. + + If ``request_context`` is provided, it is provided as keyword arguments + to the pool class used. This method is used to actually create the + connection pools handed out by :meth:`connection_from_url` and + companion methods. It is intended to be overridden for customization. + """ + pool_cls = self.pool_classes_by_scheme[scheme] + if request_context is None: + request_context = self.connection_pool_kw.copy() + + # Although the context has everything necessary to create the pool, + # this function has historically only used the scheme, host, and port + # in the positional args. When an API change is acceptable these can + # be removed. + for key in ("scheme", "host", "port"): + request_context.pop(key, None) + + if scheme == "http": + for kw in SSL_KEYWORDS: + request_context.pop(kw, None) + + return pool_cls(host, port, **request_context) + + def clear(self): + """ + Empty our store of pools and direct them all to close. + + This will not affect in-flight connections, but they will not be + re-used after completion. + """ + self.pools.clear() + + def connection_from_host(self, host, port=None, scheme="http", pool_kwargs=None): + """ + Get a :class:`urllib3.connectionpool.ConnectionPool` based on the host, port, and scheme. + + If ``port`` isn't given, it will be derived from the ``scheme`` using + ``urllib3.connectionpool.port_by_scheme``. If ``pool_kwargs`` is + provided, it is merged with the instance's ``connection_pool_kw`` + variable and used to create the new connection pool, if one is + needed. + """ + + if not host: + raise LocationValueError("No host specified.") + + request_context = self._merge_pool_kwargs(pool_kwargs) + request_context["scheme"] = scheme or "http" + if not port: + port = port_by_scheme.get(request_context["scheme"].lower(), 80) + request_context["port"] = port + request_context["host"] = host + + return self.connection_from_context(request_context) + + def connection_from_context(self, request_context): + """ + Get a :class:`urllib3.connectionpool.ConnectionPool` based on the request context. + + ``request_context`` must at least contain the ``scheme`` key and its + value must be a key in ``key_fn_by_scheme`` instance variable. + """ + scheme = request_context["scheme"].lower() + pool_key_constructor = self.key_fn_by_scheme.get(scheme) + if not pool_key_constructor: + raise URLSchemeUnknown(scheme) + pool_key = pool_key_constructor(request_context) + + return self.connection_from_pool_key(pool_key, request_context=request_context) + + def connection_from_pool_key(self, pool_key, request_context=None): + """ + Get a :class:`urllib3.connectionpool.ConnectionPool` based on the provided pool key. + + ``pool_key`` should be a namedtuple that only contains immutable + objects. At a minimum it must have the ``scheme``, ``host``, and + ``port`` fields. + """ + with self.pools.lock: + # If the scheme, host, or port doesn't match existing open + # connections, open a new ConnectionPool. + pool = self.pools.get(pool_key) + if pool: + return pool + + # Make a fresh ConnectionPool of the desired type + scheme = request_context["scheme"] + host = request_context["host"] + port = request_context["port"] + pool = self._new_pool(scheme, host, port, request_context=request_context) + self.pools[pool_key] = pool + + return pool + + def connection_from_url(self, url, pool_kwargs=None): + """ + Similar to :func:`urllib3.connectionpool.connection_from_url`. + + If ``pool_kwargs`` is not provided and a new pool needs to be + constructed, ``self.connection_pool_kw`` is used to initialize + the :class:`urllib3.connectionpool.ConnectionPool`. If ``pool_kwargs`` + is provided, it is used instead. Note that if a new pool does not + need to be created for the request, the provided ``pool_kwargs`` are + not used. + """ + u = parse_url(url) + return self.connection_from_host( + u.host, port=u.port, scheme=u.scheme, pool_kwargs=pool_kwargs + ) + + def _merge_pool_kwargs(self, override): + """ + Merge a dictionary of override values for self.connection_pool_kw. + + This does not modify self.connection_pool_kw and returns a new dict. + Any keys in the override dictionary with a value of ``None`` are + removed from the merged dictionary. + """ + base_pool_kwargs = self.connection_pool_kw.copy() + if override: + for key, value in override.items(): + if value is None: + try: + del base_pool_kwargs[key] + except KeyError: + pass + else: + base_pool_kwargs[key] = value + return base_pool_kwargs + + def _proxy_requires_url_absolute_form(self, parsed_url): + """ + Indicates if the proxy requires the complete destination URL in the + request. Normally this is only needed when not using an HTTP CONNECT + tunnel. + """ + if self.proxy is None: + return False + + return not connection_requires_http_tunnel( + self.proxy, self.proxy_config, parsed_url.scheme + ) + + def _validate_proxy_scheme_url_selection(self, url_scheme): + """ + Validates that were not attempting to do TLS in TLS connections on + Python2 or with unsupported SSL implementations. + """ + if self.proxy is None or url_scheme != "https": + return + + if self.proxy.scheme != "https": + return + + if six.PY2 and not self.proxy_config.use_forwarding_for_https: + raise ProxySchemeUnsupported( + "Contacting HTTPS destinations through HTTPS proxies " + "'via CONNECT tunnels' is not supported in Python 2" + ) + + def urlopen(self, method, url, redirect=True, **kw): + """ + Same as :meth:`urllib3.HTTPConnectionPool.urlopen` + with custom cross-host redirect logic and only sends the request-uri + portion of the ``url``. + + The given ``url`` parameter must be absolute, such that an appropriate + :class:`urllib3.connectionpool.ConnectionPool` can be chosen for it. + """ + u = parse_url(url) + self._validate_proxy_scheme_url_selection(u.scheme) + + conn = self.connection_from_host(u.host, port=u.port, scheme=u.scheme) + + kw["assert_same_host"] = False + kw["redirect"] = False + + if "headers" not in kw: + kw["headers"] = self.headers.copy() + + if self._proxy_requires_url_absolute_form(u): + response = conn.urlopen(method, url, **kw) + else: + response = conn.urlopen(method, u.request_uri, **kw) + + redirect_location = redirect and response.get_redirect_location() + if not redirect_location: + return response + + # Support relative URLs for redirecting. + redirect_location = urljoin(url, redirect_location) + + # RFC 7231, Section 6.4.4 + if response.status == 303: + method = "GET" + + retries = kw.get("retries") + if not isinstance(retries, Retry): + retries = Retry.from_int(retries, redirect=redirect) + + # Strip headers marked as unsafe to forward to the redirected location. + # Check remove_headers_on_redirect to avoid a potential network call within + # conn.is_same_host() which may use socket.gethostbyname() in the future. + if retries.remove_headers_on_redirect and not conn.is_same_host( + redirect_location + ): + headers = list(six.iterkeys(kw["headers"])) + for header in headers: + if header.lower() in retries.remove_headers_on_redirect: + kw["headers"].pop(header, None) + + try: + retries = retries.increment(method, url, response=response, _pool=conn) + except MaxRetryError: + if retries.raise_on_redirect: + response.drain_conn() + raise + return response + + kw["retries"] = retries + kw["redirect"] = redirect + + log.info("Redirecting %s -> %s", url, redirect_location) + + response.drain_conn() + return self.urlopen(method, redirect_location, **kw) + + +class ProxyManager(PoolManager): + """ + Behaves just like :class:`PoolManager`, but sends all requests through + the defined proxy, using the CONNECT method for HTTPS URLs. + + :param proxy_url: + The URL of the proxy to be used. + + :param proxy_headers: + A dictionary containing headers that will be sent to the proxy. In case + of HTTP they are being sent with each request, while in the + HTTPS/CONNECT case they are sent only once. Could be used for proxy + authentication. + + :param proxy_ssl_context: + The proxy SSL context is used to establish the TLS connection to the + proxy when using HTTPS proxies. + + :param use_forwarding_for_https: + (Defaults to False) If set to True will forward requests to the HTTPS + proxy to be made on behalf of the client instead of creating a TLS + tunnel via the CONNECT method. **Enabling this flag means that request + and response headers and content will be visible from the HTTPS proxy** + whereas tunneling keeps request and response headers and content + private. IP address, target hostname, SNI, and port are always visible + to an HTTPS proxy even when this flag is disabled. + + Example: + >>> proxy = urllib3.ProxyManager('http://localhost:3128/') + >>> r1 = proxy.request('GET', 'http://google.com/') + >>> r2 = proxy.request('GET', 'http://httpbin.org/') + >>> len(proxy.pools) + 1 + >>> r3 = proxy.request('GET', 'https://httpbin.org/') + >>> r4 = proxy.request('GET', 'https://twitter.com/') + >>> len(proxy.pools) + 3 + + """ + + def __init__( + self, + proxy_url, + num_pools=10, + headers=None, + proxy_headers=None, + proxy_ssl_context=None, + use_forwarding_for_https=False, + **connection_pool_kw + ): + + if isinstance(proxy_url, HTTPConnectionPool): + proxy_url = "%s://%s:%i" % ( + proxy_url.scheme, + proxy_url.host, + proxy_url.port, + ) + proxy = parse_url(proxy_url) + + if proxy.scheme not in ("http", "https"): + raise ProxySchemeUnknown(proxy.scheme) + + if not proxy.port: + port = port_by_scheme.get(proxy.scheme, 80) + proxy = proxy._replace(port=port) + + self.proxy = proxy + self.proxy_headers = proxy_headers or {} + self.proxy_ssl_context = proxy_ssl_context + self.proxy_config = ProxyConfig(proxy_ssl_context, use_forwarding_for_https) + + connection_pool_kw["_proxy"] = self.proxy + connection_pool_kw["_proxy_headers"] = self.proxy_headers + connection_pool_kw["_proxy_config"] = self.proxy_config + + super(ProxyManager, self).__init__(num_pools, headers, **connection_pool_kw) + + def connection_from_host(self, host, port=None, scheme="http", pool_kwargs=None): + if scheme == "https": + return super(ProxyManager, self).connection_from_host( + host, port, scheme, pool_kwargs=pool_kwargs + ) + + return super(ProxyManager, self).connection_from_host( + self.proxy.host, self.proxy.port, self.proxy.scheme, pool_kwargs=pool_kwargs + ) + + def _set_proxy_headers(self, url, headers=None): + """ + Sets headers needed by proxies: specifically, the Accept and Host + headers. Only sets headers not provided by the user. + """ + headers_ = {"Accept": "*/*"} + + netloc = parse_url(url).netloc + if netloc: + headers_["Host"] = netloc + + if headers: + headers_.update(headers) + return headers_ + + def urlopen(self, method, url, redirect=True, **kw): + "Same as HTTP(S)ConnectionPool.urlopen, ``url`` must be absolute." + u = parse_url(url) + if not connection_requires_http_tunnel(self.proxy, self.proxy_config, u.scheme): + # For connections using HTTP CONNECT, httplib sets the necessary + # headers on the CONNECT to the proxy. If we're not using CONNECT, + # we'll definitely need to set 'Host' at the very least. + headers = kw.get("headers", self.headers) + kw["headers"] = self._set_proxy_headers(url, headers) + + return super(ProxyManager, self).urlopen(method, url, redirect=redirect, **kw) + + +def proxy_from_url(url, **kw): + return ProxyManager(proxy_url=url, **kw) diff --git a/openpype/hosts/fusion/vendor/urllib3/request.py b/openpype/hosts/fusion/vendor/urllib3/request.py new file mode 100644 index 0000000000..398386a5b9 --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/request.py @@ -0,0 +1,170 @@ +from __future__ import absolute_import + +from .filepost import encode_multipart_formdata +from .packages.six.moves.urllib.parse import urlencode + +__all__ = ["RequestMethods"] + + +class RequestMethods(object): + """ + Convenience mixin for classes who implement a :meth:`urlopen` method, such + as :class:`urllib3.HTTPConnectionPool` and + :class:`urllib3.PoolManager`. + + Provides behavior for making common types of HTTP request methods and + decides which type of request field encoding to use. + + Specifically, + + :meth:`.request_encode_url` is for sending requests whose fields are + encoded in the URL (such as GET, HEAD, DELETE). + + :meth:`.request_encode_body` is for sending requests whose fields are + encoded in the *body* of the request using multipart or www-form-urlencoded + (such as for POST, PUT, PATCH). + + :meth:`.request` is for making any kind of request, it will look up the + appropriate encoding format and use one of the above two methods to make + the request. + + Initializer parameters: + + :param headers: + Headers to include with all requests, unless other headers are given + explicitly. + """ + + _encode_url_methods = {"DELETE", "GET", "HEAD", "OPTIONS"} + + def __init__(self, headers=None): + self.headers = headers or {} + + def urlopen( + self, + method, + url, + body=None, + headers=None, + encode_multipart=True, + multipart_boundary=None, + **kw + ): # Abstract + raise NotImplementedError( + "Classes extending RequestMethods must implement " + "their own ``urlopen`` method." + ) + + def request(self, method, url, fields=None, headers=None, **urlopen_kw): + """ + Make a request using :meth:`urlopen` with the appropriate encoding of + ``fields`` based on the ``method`` used. + + This is a convenience method that requires the least amount of manual + effort. It can be used in most situations, while still having the + option to drop down to more specific methods when necessary, such as + :meth:`request_encode_url`, :meth:`request_encode_body`, + or even the lowest level :meth:`urlopen`. + """ + method = method.upper() + + urlopen_kw["request_url"] = url + + if method in self._encode_url_methods: + return self.request_encode_url( + method, url, fields=fields, headers=headers, **urlopen_kw + ) + else: + return self.request_encode_body( + method, url, fields=fields, headers=headers, **urlopen_kw + ) + + def request_encode_url(self, method, url, fields=None, headers=None, **urlopen_kw): + """ + Make a request using :meth:`urlopen` with the ``fields`` encoded in + the url. This is useful for request methods like GET, HEAD, DELETE, etc. + """ + if headers is None: + headers = self.headers + + extra_kw = {"headers": headers} + extra_kw.update(urlopen_kw) + + if fields: + url += "?" + urlencode(fields) + + return self.urlopen(method, url, **extra_kw) + + def request_encode_body( + self, + method, + url, + fields=None, + headers=None, + encode_multipart=True, + multipart_boundary=None, + **urlopen_kw + ): + """ + Make a request using :meth:`urlopen` with the ``fields`` encoded in + the body. This is useful for request methods like POST, PUT, PATCH, etc. + + When ``encode_multipart=True`` (default), then + :func:`urllib3.encode_multipart_formdata` is used to encode + the payload with the appropriate content type. Otherwise + :func:`urllib.parse.urlencode` is used with the + 'application/x-www-form-urlencoded' content type. + + Multipart encoding must be used when posting files, and it's reasonably + safe to use it in other times too. However, it may break request + signing, such as with OAuth. + + Supports an optional ``fields`` parameter of key/value strings AND + key/filetuple. A filetuple is a (filename, data, MIME type) tuple where + the MIME type is optional. For example:: + + fields = { + 'foo': 'bar', + 'fakefile': ('foofile.txt', 'contents of foofile'), + 'realfile': ('barfile.txt', open('realfile').read()), + 'typedfile': ('bazfile.bin', open('bazfile').read(), + 'image/jpeg'), + 'nonamefile': 'contents of nonamefile field', + } + + When uploading a file, providing a filename (the first parameter of the + tuple) is optional but recommended to best mimic behavior of browsers. + + Note that if ``headers`` are supplied, the 'Content-Type' header will + be overwritten because it depends on the dynamic random boundary string + which is used to compose the body of the request. The random boundary + string can be explicitly set with the ``multipart_boundary`` parameter. + """ + if headers is None: + headers = self.headers + + extra_kw = {"headers": {}} + + if fields: + if "body" in urlopen_kw: + raise TypeError( + "request got values for both 'fields' and 'body', can only specify one." + ) + + if encode_multipart: + body, content_type = encode_multipart_formdata( + fields, boundary=multipart_boundary + ) + else: + body, content_type = ( + urlencode(fields), + "application/x-www-form-urlencoded", + ) + + extra_kw["body"] = body + extra_kw["headers"] = {"Content-Type": content_type} + + extra_kw["headers"].update(headers) + extra_kw.update(urlopen_kw) + + return self.urlopen(method, url, **extra_kw) diff --git a/openpype/hosts/fusion/vendor/urllib3/response.py b/openpype/hosts/fusion/vendor/urllib3/response.py new file mode 100644 index 0000000000..38693f4fc6 --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/response.py @@ -0,0 +1,821 @@ +from __future__ import absolute_import + +import io +import logging +import zlib +from contextlib import contextmanager +from socket import error as SocketError +from socket import timeout as SocketTimeout + +try: + import brotli +except ImportError: + brotli = None + +from ._collections import HTTPHeaderDict +from .connection import BaseSSLError, HTTPException +from .exceptions import ( + BodyNotHttplibCompatible, + DecodeError, + HTTPError, + IncompleteRead, + InvalidChunkLength, + InvalidHeader, + ProtocolError, + ReadTimeoutError, + ResponseNotChunked, + SSLError, +) +from .packages import six +from .util.response import is_fp_closed, is_response_to_head + +log = logging.getLogger(__name__) + + +class DeflateDecoder(object): + def __init__(self): + self._first_try = True + self._data = b"" + self._obj = zlib.decompressobj() + + def __getattr__(self, name): + return getattr(self._obj, name) + + def decompress(self, data): + if not data: + return data + + if not self._first_try: + return self._obj.decompress(data) + + self._data += data + try: + decompressed = self._obj.decompress(data) + if decompressed: + self._first_try = False + self._data = None + return decompressed + except zlib.error: + self._first_try = False + self._obj = zlib.decompressobj(-zlib.MAX_WBITS) + try: + return self.decompress(self._data) + finally: + self._data = None + + +class GzipDecoderState(object): + + FIRST_MEMBER = 0 + OTHER_MEMBERS = 1 + SWALLOW_DATA = 2 + + +class GzipDecoder(object): + def __init__(self): + self._obj = zlib.decompressobj(16 + zlib.MAX_WBITS) + self._state = GzipDecoderState.FIRST_MEMBER + + def __getattr__(self, name): + return getattr(self._obj, name) + + def decompress(self, data): + ret = bytearray() + if self._state == GzipDecoderState.SWALLOW_DATA or not data: + return bytes(ret) + while True: + try: + ret += self._obj.decompress(data) + except zlib.error: + previous_state = self._state + # Ignore data after the first error + self._state = GzipDecoderState.SWALLOW_DATA + if previous_state == GzipDecoderState.OTHER_MEMBERS: + # Allow trailing garbage acceptable in other gzip clients + return bytes(ret) + raise + data = self._obj.unused_data + if not data: + return bytes(ret) + self._state = GzipDecoderState.OTHER_MEMBERS + self._obj = zlib.decompressobj(16 + zlib.MAX_WBITS) + + +if brotli is not None: + + class BrotliDecoder(object): + # Supports both 'brotlipy' and 'Brotli' packages + # since they share an import name. The top branches + # are for 'brotlipy' and bottom branches for 'Brotli' + def __init__(self): + self._obj = brotli.Decompressor() + if hasattr(self._obj, "decompress"): + self.decompress = self._obj.decompress + else: + self.decompress = self._obj.process + + def flush(self): + if hasattr(self._obj, "flush"): + return self._obj.flush() + return b"" + + +class MultiDecoder(object): + """ + From RFC7231: + If one or more encodings have been applied to a representation, the + sender that applied the encodings MUST generate a Content-Encoding + header field that lists the content codings in the order in which + they were applied. + """ + + def __init__(self, modes): + self._decoders = [_get_decoder(m.strip()) for m in modes.split(",")] + + def flush(self): + return self._decoders[0].flush() + + def decompress(self, data): + for d in reversed(self._decoders): + data = d.decompress(data) + return data + + +def _get_decoder(mode): + if "," in mode: + return MultiDecoder(mode) + + if mode == "gzip": + return GzipDecoder() + + if brotli is not None and mode == "br": + return BrotliDecoder() + + return DeflateDecoder() + + +class HTTPResponse(io.IOBase): + """ + HTTP Response container. + + Backwards-compatible with :class:`http.client.HTTPResponse` but the response ``body`` is + loaded and decoded on-demand when the ``data`` property is accessed. This + class is also compatible with the Python standard library's :mod:`io` + module, and can hence be treated as a readable object in the context of that + framework. + + Extra parameters for behaviour not present in :class:`http.client.HTTPResponse`: + + :param preload_content: + If True, the response's body will be preloaded during construction. + + :param decode_content: + If True, will attempt to decode the body based on the + 'content-encoding' header. + + :param original_response: + When this HTTPResponse wrapper is generated from an :class:`http.client.HTTPResponse` + object, it's convenient to include the original for debug purposes. It's + otherwise unused. + + :param retries: + The retries contains the last :class:`~urllib3.util.retry.Retry` that + was used during the request. + + :param enforce_content_length: + Enforce content length checking. Body returned by server must match + value of Content-Length header, if present. Otherwise, raise error. + """ + + CONTENT_DECODERS = ["gzip", "deflate"] + if brotli is not None: + CONTENT_DECODERS += ["br"] + REDIRECT_STATUSES = [301, 302, 303, 307, 308] + + def __init__( + self, + body="", + headers=None, + status=0, + version=0, + reason=None, + strict=0, + preload_content=True, + decode_content=True, + original_response=None, + pool=None, + connection=None, + msg=None, + retries=None, + enforce_content_length=False, + request_method=None, + request_url=None, + auto_close=True, + ): + + if isinstance(headers, HTTPHeaderDict): + self.headers = headers + else: + self.headers = HTTPHeaderDict(headers) + self.status = status + self.version = version + self.reason = reason + self.strict = strict + self.decode_content = decode_content + self.retries = retries + self.enforce_content_length = enforce_content_length + self.auto_close = auto_close + + self._decoder = None + self._body = None + self._fp = None + self._original_response = original_response + self._fp_bytes_read = 0 + self.msg = msg + self._request_url = request_url + + if body and isinstance(body, (six.string_types, bytes)): + self._body = body + + self._pool = pool + self._connection = connection + + if hasattr(body, "read"): + self._fp = body + + # Are we using the chunked-style of transfer encoding? + self.chunked = False + self.chunk_left = None + tr_enc = self.headers.get("transfer-encoding", "").lower() + # Don't incur the penalty of creating a list and then discarding it + encodings = (enc.strip() for enc in tr_enc.split(",")) + if "chunked" in encodings: + self.chunked = True + + # Determine length of response + self.length_remaining = self._init_length(request_method) + + # If requested, preload the body. + if preload_content and not self._body: + self._body = self.read(decode_content=decode_content) + + def get_redirect_location(self): + """ + Should we redirect and where to? + + :returns: Truthy redirect location string if we got a redirect status + code and valid location. ``None`` if redirect status and no + location. ``False`` if not a redirect status code. + """ + if self.status in self.REDIRECT_STATUSES: + return self.headers.get("location") + + return False + + def release_conn(self): + if not self._pool or not self._connection: + return + + self._pool._put_conn(self._connection) + self._connection = None + + def drain_conn(self): + """ + Read and discard any remaining HTTP response data in the response connection. + + Unread data in the HTTPResponse connection blocks the connection from being released back to the pool. + """ + try: + self.read() + except (HTTPError, SocketError, BaseSSLError, HTTPException): + pass + + @property + def data(self): + # For backwards-compat with earlier urllib3 0.4 and earlier. + if self._body: + return self._body + + if self._fp: + return self.read(cache_content=True) + + @property + def connection(self): + return self._connection + + def isclosed(self): + return is_fp_closed(self._fp) + + def tell(self): + """ + Obtain the number of bytes pulled over the wire so far. May differ from + the amount of content returned by :meth:``urllib3.response.HTTPResponse.read`` + if bytes are encoded on the wire (e.g, compressed). + """ + return self._fp_bytes_read + + def _init_length(self, request_method): + """ + Set initial length value for Response content if available. + """ + length = self.headers.get("content-length") + + if length is not None: + if self.chunked: + # This Response will fail with an IncompleteRead if it can't be + # received as chunked. This method falls back to attempt reading + # the response before raising an exception. + log.warning( + "Received response with both Content-Length and " + "Transfer-Encoding set. This is expressly forbidden " + "by RFC 7230 sec 3.3.2. Ignoring Content-Length and " + "attempting to process response as Transfer-Encoding: " + "chunked." + ) + return None + + try: + # RFC 7230 section 3.3.2 specifies multiple content lengths can + # be sent in a single Content-Length header + # (e.g. Content-Length: 42, 42). This line ensures the values + # are all valid ints and that as long as the `set` length is 1, + # all values are the same. Otherwise, the header is invalid. + lengths = set([int(val) for val in length.split(",")]) + if len(lengths) > 1: + raise InvalidHeader( + "Content-Length contained multiple " + "unmatching values (%s)" % length + ) + length = lengths.pop() + except ValueError: + length = None + else: + if length < 0: + length = None + + # Convert status to int for comparison + # In some cases, httplib returns a status of "_UNKNOWN" + try: + status = int(self.status) + except ValueError: + status = 0 + + # Check for responses that shouldn't include a body + if status in (204, 304) or 100 <= status < 200 or request_method == "HEAD": + length = 0 + + return length + + def _init_decoder(self): + """ + Set-up the _decoder attribute if necessary. + """ + # Note: content-encoding value should be case-insensitive, per RFC 7230 + # Section 3.2 + content_encoding = self.headers.get("content-encoding", "").lower() + if self._decoder is None: + if content_encoding in self.CONTENT_DECODERS: + self._decoder = _get_decoder(content_encoding) + elif "," in content_encoding: + encodings = [ + e.strip() + for e in content_encoding.split(",") + if e.strip() in self.CONTENT_DECODERS + ] + if len(encodings): + self._decoder = _get_decoder(content_encoding) + + DECODER_ERROR_CLASSES = (IOError, zlib.error) + if brotli is not None: + DECODER_ERROR_CLASSES += (brotli.error,) + + def _decode(self, data, decode_content, flush_decoder): + """ + Decode the data passed in and potentially flush the decoder. + """ + if not decode_content: + return data + + try: + if self._decoder: + data = self._decoder.decompress(data) + except self.DECODER_ERROR_CLASSES as e: + content_encoding = self.headers.get("content-encoding", "").lower() + raise DecodeError( + "Received response with content-encoding: %s, but " + "failed to decode it." % content_encoding, + e, + ) + if flush_decoder: + data += self._flush_decoder() + + return data + + def _flush_decoder(self): + """ + Flushes the decoder. Should only be called if the decoder is actually + being used. + """ + if self._decoder: + buf = self._decoder.decompress(b"") + return buf + self._decoder.flush() + + return b"" + + @contextmanager + def _error_catcher(self): + """ + Catch low-level python exceptions, instead re-raising urllib3 + variants, so that low-level exceptions are not leaked in the + high-level api. + + On exit, release the connection back to the pool. + """ + clean_exit = False + + try: + try: + yield + + except SocketTimeout: + # FIXME: Ideally we'd like to include the url in the ReadTimeoutError but + # there is yet no clean way to get at it from this context. + raise ReadTimeoutError(self._pool, None, "Read timed out.") + + except BaseSSLError as e: + # FIXME: Is there a better way to differentiate between SSLErrors? + if "read operation timed out" not in str(e): + # SSL errors related to framing/MAC get wrapped and reraised here + raise SSLError(e) + + raise ReadTimeoutError(self._pool, None, "Read timed out.") + + except (HTTPException, SocketError) as e: + # This includes IncompleteRead. + raise ProtocolError("Connection broken: %r" % e, e) + + # If no exception is thrown, we should avoid cleaning up + # unnecessarily. + clean_exit = True + finally: + # If we didn't terminate cleanly, we need to throw away our + # connection. + if not clean_exit: + # The response may not be closed but we're not going to use it + # anymore so close it now to ensure that the connection is + # released back to the pool. + if self._original_response: + self._original_response.close() + + # Closing the response may not actually be sufficient to close + # everything, so if we have a hold of the connection close that + # too. + if self._connection: + self._connection.close() + + # If we hold the original response but it's closed now, we should + # return the connection back to the pool. + if self._original_response and self._original_response.isclosed(): + self.release_conn() + + def read(self, amt=None, decode_content=None, cache_content=False): + """ + Similar to :meth:`http.client.HTTPResponse.read`, but with two additional + parameters: ``decode_content`` and ``cache_content``. + + :param amt: + How much of the content to read. If specified, caching is skipped + because it doesn't make sense to cache partial content as the full + response. + + :param decode_content: + If True, will attempt to decode the body based on the + 'content-encoding' header. + + :param cache_content: + If True, will save the returned data such that the same result is + returned despite of the state of the underlying file object. This + is useful if you want the ``.data`` property to continue working + after having ``.read()`` the file object. (Overridden if ``amt`` is + set.) + """ + self._init_decoder() + if decode_content is None: + decode_content = self.decode_content + + if self._fp is None: + return + + flush_decoder = False + fp_closed = getattr(self._fp, "closed", False) + + with self._error_catcher(): + if amt is None: + # cStringIO doesn't like amt=None + data = self._fp.read() if not fp_closed else b"" + flush_decoder = True + else: + cache_content = False + data = self._fp.read(amt) if not fp_closed else b"" + if ( + amt != 0 and not data + ): # Platform-specific: Buggy versions of Python. + # Close the connection when no data is returned + # + # This is redundant to what httplib/http.client _should_ + # already do. However, versions of python released before + # December 15, 2012 (http://bugs.python.org/issue16298) do + # not properly close the connection in all cases. There is + # no harm in redundantly calling close. + self._fp.close() + flush_decoder = True + if self.enforce_content_length and self.length_remaining not in ( + 0, + None, + ): + # This is an edge case that httplib failed to cover due + # to concerns of backward compatibility. We're + # addressing it here to make sure IncompleteRead is + # raised during streaming, so all calls with incorrect + # Content-Length are caught. + raise IncompleteRead(self._fp_bytes_read, self.length_remaining) + + if data: + self._fp_bytes_read += len(data) + if self.length_remaining is not None: + self.length_remaining -= len(data) + + data = self._decode(data, decode_content, flush_decoder) + + if cache_content: + self._body = data + + return data + + def stream(self, amt=2 ** 16, decode_content=None): + """ + A generator wrapper for the read() method. A call will block until + ``amt`` bytes have been read from the connection or until the + connection is closed. + + :param amt: + How much of the content to read. The generator will return up to + much data per iteration, but may return less. This is particularly + likely when using compressed data. However, the empty string will + never be returned. + + :param decode_content: + If True, will attempt to decode the body based on the + 'content-encoding' header. + """ + if self.chunked and self.supports_chunked_reads(): + for line in self.read_chunked(amt, decode_content=decode_content): + yield line + else: + while not is_fp_closed(self._fp): + data = self.read(amt=amt, decode_content=decode_content) + + if data: + yield data + + @classmethod + def from_httplib(ResponseCls, r, **response_kw): + """ + Given an :class:`http.client.HTTPResponse` instance ``r``, return a + corresponding :class:`urllib3.response.HTTPResponse` object. + + Remaining parameters are passed to the HTTPResponse constructor, along + with ``original_response=r``. + """ + headers = r.msg + + if not isinstance(headers, HTTPHeaderDict): + if six.PY2: + # Python 2.7 + headers = HTTPHeaderDict.from_httplib(headers) + else: + headers = HTTPHeaderDict(headers.items()) + + # HTTPResponse objects in Python 3 don't have a .strict attribute + strict = getattr(r, "strict", 0) + resp = ResponseCls( + body=r, + headers=headers, + status=r.status, + version=r.version, + reason=r.reason, + strict=strict, + original_response=r, + **response_kw + ) + return resp + + # Backwards-compatibility methods for http.client.HTTPResponse + def getheaders(self): + return self.headers + + def getheader(self, name, default=None): + return self.headers.get(name, default) + + # Backwards compatibility for http.cookiejar + def info(self): + return self.headers + + # Overrides from io.IOBase + def close(self): + if not self.closed: + self._fp.close() + + if self._connection: + self._connection.close() + + if not self.auto_close: + io.IOBase.close(self) + + @property + def closed(self): + if not self.auto_close: + return io.IOBase.closed.__get__(self) + elif self._fp is None: + return True + elif hasattr(self._fp, "isclosed"): + return self._fp.isclosed() + elif hasattr(self._fp, "closed"): + return self._fp.closed + else: + return True + + def fileno(self): + if self._fp is None: + raise IOError("HTTPResponse has no file to get a fileno from") + elif hasattr(self._fp, "fileno"): + return self._fp.fileno() + else: + raise IOError( + "The file-like object this HTTPResponse is wrapped " + "around has no file descriptor" + ) + + def flush(self): + if ( + self._fp is not None + and hasattr(self._fp, "flush") + and not getattr(self._fp, "closed", False) + ): + return self._fp.flush() + + def readable(self): + # This method is required for `io` module compatibility. + return True + + def readinto(self, b): + # This method is required for `io` module compatibility. + temp = self.read(len(b)) + if len(temp) == 0: + return 0 + else: + b[: len(temp)] = temp + return len(temp) + + def supports_chunked_reads(self): + """ + Checks if the underlying file-like object looks like a + :class:`http.client.HTTPResponse` object. We do this by testing for + the fp attribute. If it is present we assume it returns raw chunks as + processed by read_chunked(). + """ + return hasattr(self._fp, "fp") + + def _update_chunk_length(self): + # First, we'll figure out length of a chunk and then + # we'll try to read it from socket. + if self.chunk_left is not None: + return + line = self._fp.fp.readline() + line = line.split(b";", 1)[0] + try: + self.chunk_left = int(line, 16) + except ValueError: + # Invalid chunked protocol response, abort. + self.close() + raise InvalidChunkLength(self, line) + + def _handle_chunk(self, amt): + returned_chunk = None + if amt is None: + chunk = self._fp._safe_read(self.chunk_left) + returned_chunk = chunk + self._fp._safe_read(2) # Toss the CRLF at the end of the chunk. + self.chunk_left = None + elif amt < self.chunk_left: + value = self._fp._safe_read(amt) + self.chunk_left = self.chunk_left - amt + returned_chunk = value + elif amt == self.chunk_left: + value = self._fp._safe_read(amt) + self._fp._safe_read(2) # Toss the CRLF at the end of the chunk. + self.chunk_left = None + returned_chunk = value + else: # amt > self.chunk_left + returned_chunk = self._fp._safe_read(self.chunk_left) + self._fp._safe_read(2) # Toss the CRLF at the end of the chunk. + self.chunk_left = None + return returned_chunk + + def read_chunked(self, amt=None, decode_content=None): + """ + Similar to :meth:`HTTPResponse.read`, but with an additional + parameter: ``decode_content``. + + :param amt: + How much of the content to read. If specified, caching is skipped + because it doesn't make sense to cache partial content as the full + response. + + :param decode_content: + If True, will attempt to decode the body based on the + 'content-encoding' header. + """ + self._init_decoder() + # FIXME: Rewrite this method and make it a class with a better structured logic. + if not self.chunked: + raise ResponseNotChunked( + "Response is not chunked. " + "Header 'transfer-encoding: chunked' is missing." + ) + if not self.supports_chunked_reads(): + raise BodyNotHttplibCompatible( + "Body should be http.client.HTTPResponse like. " + "It should have have an fp attribute which returns raw chunks." + ) + + with self._error_catcher(): + # Don't bother reading the body of a HEAD request. + if self._original_response and is_response_to_head(self._original_response): + self._original_response.close() + return + + # If a response is already read and closed + # then return immediately. + if self._fp.fp is None: + return + + while True: + self._update_chunk_length() + if self.chunk_left == 0: + break + chunk = self._handle_chunk(amt) + decoded = self._decode( + chunk, decode_content=decode_content, flush_decoder=False + ) + if decoded: + yield decoded + + if decode_content: + # On CPython and PyPy, we should never need to flush the + # decoder. However, on Jython we *might* need to, so + # lets defensively do it anyway. + decoded = self._flush_decoder() + if decoded: # Platform-specific: Jython. + yield decoded + + # Chunk content ends with \r\n: discard it. + while True: + line = self._fp.fp.readline() + if not line: + # Some sites may not end with '\r\n'. + break + if line == b"\r\n": + break + + # We read everything; close the "file". + if self._original_response: + self._original_response.close() + + def geturl(self): + """ + Returns the URL that was the source of this response. + If the request that generated this response redirected, this method + will return the final redirect location. + """ + if self.retries is not None and len(self.retries.history): + return self.retries.history[-1].redirect_location + else: + return self._request_url + + def __iter__(self): + buffer = [] + for chunk in self.stream(decode_content=True): + if b"\n" in chunk: + chunk = chunk.split(b"\n") + yield b"".join(buffer) + chunk[0] + b"\n" + for x in chunk[1:-1]: + yield x + b"\n" + if chunk[-1]: + buffer = [chunk[-1]] + else: + buffer = [] + else: + buffer.append(chunk) + if buffer: + yield b"".join(buffer) diff --git a/openpype/hosts/fusion/vendor/urllib3/util/__init__.py b/openpype/hosts/fusion/vendor/urllib3/util/__init__.py new file mode 100644 index 0000000000..4547fc522b --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/util/__init__.py @@ -0,0 +1,49 @@ +from __future__ import absolute_import + +# For backwards compatibility, provide imports that used to be here. +from .connection import is_connection_dropped +from .request import SKIP_HEADER, SKIPPABLE_HEADERS, make_headers +from .response import is_fp_closed +from .retry import Retry +from .ssl_ import ( + ALPN_PROTOCOLS, + HAS_SNI, + IS_PYOPENSSL, + IS_SECURETRANSPORT, + PROTOCOL_TLS, + SSLContext, + assert_fingerprint, + resolve_cert_reqs, + resolve_ssl_version, + ssl_wrap_socket, +) +from .timeout import Timeout, current_time +from .url import Url, get_host, parse_url, split_first +from .wait import wait_for_read, wait_for_write + +__all__ = ( + "HAS_SNI", + "IS_PYOPENSSL", + "IS_SECURETRANSPORT", + "SSLContext", + "PROTOCOL_TLS", + "ALPN_PROTOCOLS", + "Retry", + "Timeout", + "Url", + "assert_fingerprint", + "current_time", + "is_connection_dropped", + "is_fp_closed", + "get_host", + "parse_url", + "make_headers", + "resolve_cert_reqs", + "resolve_ssl_version", + "split_first", + "ssl_wrap_socket", + "wait_for_read", + "wait_for_write", + "SKIP_HEADER", + "SKIPPABLE_HEADERS", +) diff --git a/openpype/hosts/fusion/vendor/urllib3/util/connection.py b/openpype/hosts/fusion/vendor/urllib3/util/connection.py new file mode 100644 index 0000000000..bdc240c50c --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/util/connection.py @@ -0,0 +1,150 @@ +from __future__ import absolute_import + +import socket + +from urllib3.exceptions import LocationParseError + +from ..contrib import _appengine_environ +from ..packages import six +from .wait import NoWayToWaitForSocketError, wait_for_read + + +def is_connection_dropped(conn): # Platform-specific + """ + Returns True if the connection is dropped and should be closed. + + :param conn: + :class:`http.client.HTTPConnection` object. + + Note: For platforms like AppEngine, this will always return ``False`` to + let the platform handle connection recycling transparently for us. + """ + sock = getattr(conn, "sock", False) + if sock is False: # Platform-specific: AppEngine + return False + if sock is None: # Connection already closed (such as by httplib). + return True + try: + # Returns True if readable, which here means it's been dropped + return wait_for_read(sock, timeout=0.0) + except NoWayToWaitForSocketError: # Platform-specific: AppEngine + return False + + +# This function is copied from socket.py in the Python 2.7 standard +# library test suite. Added to its signature is only `socket_options`. +# One additional modification is that we avoid binding to IPv6 servers +# discovered in DNS if the system doesn't have IPv6 functionality. +def create_connection( + address, + timeout=socket._GLOBAL_DEFAULT_TIMEOUT, + source_address=None, + socket_options=None, +): + """Connect to *address* and return the socket object. + + Convenience function. Connect to *address* (a 2-tuple ``(host, + port)``) and return the socket object. Passing the optional + *timeout* parameter will set the timeout on the socket instance + before attempting to connect. If no *timeout* is supplied, the + global default timeout setting returned by :func:`socket.getdefaulttimeout` + is used. If *source_address* is set it must be a tuple of (host, port) + for the socket to bind as a source address before making the connection. + An host of '' or port 0 tells the OS to use the default. + """ + + host, port = address + if host.startswith("["): + host = host.strip("[]") + err = None + + # Using the value from allowed_gai_family() in the context of getaddrinfo lets + # us select whether to work with IPv4 DNS records, IPv6 records, or both. + # The original create_connection function always returns all records. + family = allowed_gai_family() + + try: + host.encode("idna") + except UnicodeError: + return six.raise_from( + LocationParseError(u"'%s', label empty or too long" % host), None + ) + + for res in socket.getaddrinfo(host, port, family, socket.SOCK_STREAM): + af, socktype, proto, canonname, sa = res + sock = None + try: + sock = socket.socket(af, socktype, proto) + + # If provided, set socket level options before connecting. + _set_socket_options(sock, socket_options) + + if timeout is not socket._GLOBAL_DEFAULT_TIMEOUT: + sock.settimeout(timeout) + if source_address: + sock.bind(source_address) + sock.connect(sa) + return sock + + except socket.error as e: + err = e + if sock is not None: + sock.close() + sock = None + + if err is not None: + raise err + + raise socket.error("getaddrinfo returns an empty list") + + +def _set_socket_options(sock, options): + if options is None: + return + + for opt in options: + sock.setsockopt(*opt) + + +def allowed_gai_family(): + """This function is designed to work in the context of + getaddrinfo, where family=socket.AF_UNSPEC is the default and + will perform a DNS search for both IPv6 and IPv4 records.""" + + family = socket.AF_INET + if HAS_IPV6: + family = socket.AF_UNSPEC + return family + + +def _has_ipv6(host): + """Returns True if the system can bind an IPv6 address.""" + sock = None + has_ipv6 = False + + # App Engine doesn't support IPV6 sockets and actually has a quota on the + # number of sockets that can be used, so just early out here instead of + # creating a socket needlessly. + # See https://github.com/urllib3/urllib3/issues/1446 + if _appengine_environ.is_appengine_sandbox(): + return False + + if socket.has_ipv6: + # has_ipv6 returns true if cPython was compiled with IPv6 support. + # It does not tell us if the system has IPv6 support enabled. To + # determine that we must bind to an IPv6 address. + # https://github.com/urllib3/urllib3/pull/611 + # https://bugs.python.org/issue658327 + try: + sock = socket.socket(socket.AF_INET6) + sock.bind((host, 0)) + has_ipv6 = True + except Exception: + pass + + if sock: + sock.close() + return has_ipv6 + + +HAS_IPV6 = _has_ipv6("::1") diff --git a/openpype/hosts/fusion/vendor/urllib3/util/proxy.py b/openpype/hosts/fusion/vendor/urllib3/util/proxy.py new file mode 100644 index 0000000000..34f884d5b3 --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/util/proxy.py @@ -0,0 +1,56 @@ +from .ssl_ import create_urllib3_context, resolve_cert_reqs, resolve_ssl_version + + +def connection_requires_http_tunnel( + proxy_url=None, proxy_config=None, destination_scheme=None +): + """ + Returns True if the connection requires an HTTP CONNECT through the proxy. + + :param URL proxy_url: + URL of the proxy. + :param ProxyConfig proxy_config: + Proxy configuration from poolmanager.py + :param str destination_scheme: + The scheme of the destination. (i.e https, http, etc) + """ + # If we're not using a proxy, no way to use a tunnel. + if proxy_url is None: + return False + + # HTTP destinations never require tunneling, we always forward. + if destination_scheme == "http": + return False + + # Support for forwarding with HTTPS proxies and HTTPS destinations. + if ( + proxy_url.scheme == "https" + and proxy_config + and proxy_config.use_forwarding_for_https + ): + return False + + # Otherwise always use a tunnel. + return True + + +def create_proxy_ssl_context( + ssl_version, cert_reqs, ca_certs=None, ca_cert_dir=None, ca_cert_data=None +): + """ + Generates a default proxy ssl context if one hasn't been provided by the + user. + """ + ssl_context = create_urllib3_context( + ssl_version=resolve_ssl_version(ssl_version), + cert_reqs=resolve_cert_reqs(cert_reqs), + ) + if ( + not ca_certs + and not ca_cert_dir + and not ca_cert_data + and hasattr(ssl_context, "load_default_certs") + ): + ssl_context.load_default_certs() + + return ssl_context diff --git a/openpype/hosts/fusion/vendor/urllib3/util/queue.py b/openpype/hosts/fusion/vendor/urllib3/util/queue.py new file mode 100644 index 0000000000..41784104ee --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/util/queue.py @@ -0,0 +1,22 @@ +import collections + +from ..packages import six +from ..packages.six.moves import queue + +if six.PY2: + # Queue is imported for side effects on MS Windows. See issue #229. + import Queue as _unused_module_Queue # noqa: F401 + + +class LifoQueue(queue.Queue): + def _init(self, _): + self.queue = collections.deque() + + def _qsize(self, len=len): + return len(self.queue) + + def _put(self, item): + self.queue.append(item) + + def _get(self): + return self.queue.pop() diff --git a/openpype/hosts/fusion/vendor/urllib3/util/request.py b/openpype/hosts/fusion/vendor/urllib3/util/request.py new file mode 100644 index 0000000000..25103383ec --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/util/request.py @@ -0,0 +1,143 @@ +from __future__ import absolute_import + +from base64 import b64encode + +from ..exceptions import UnrewindableBodyError +from ..packages.six import b, integer_types + +# Pass as a value within ``headers`` to skip +# emitting some HTTP headers that are added automatically. +# The only headers that are supported are ``Accept-Encoding``, +# ``Host``, and ``User-Agent``. +SKIP_HEADER = "@@@SKIP_HEADER@@@" +SKIPPABLE_HEADERS = frozenset(["accept-encoding", "host", "user-agent"]) + +ACCEPT_ENCODING = "gzip,deflate" +try: + import brotli as _unused_module_brotli # noqa: F401 +except ImportError: + pass +else: + ACCEPT_ENCODING += ",br" + +_FAILEDTELL = object() + + +def make_headers( + keep_alive=None, + accept_encoding=None, + user_agent=None, + basic_auth=None, + proxy_basic_auth=None, + disable_cache=None, +): + """ + Shortcuts for generating request headers. + + :param keep_alive: + If ``True``, adds 'connection: keep-alive' header. + + :param accept_encoding: + Can be a boolean, list, or string. + ``True`` translates to 'gzip,deflate'. + List will get joined by comma. + String will be used as provided. + + :param user_agent: + String representing the user-agent you want, such as + "python-urllib3/0.6" + + :param basic_auth: + Colon-separated username:password string for 'authorization: basic ...' + auth header. + + :param proxy_basic_auth: + Colon-separated username:password string for 'proxy-authorization: basic ...' + auth header. + + :param disable_cache: + If ``True``, adds 'cache-control: no-cache' header. + + Example:: + + >>> make_headers(keep_alive=True, user_agent="Batman/1.0") + {'connection': 'keep-alive', 'user-agent': 'Batman/1.0'} + >>> make_headers(accept_encoding=True) + {'accept-encoding': 'gzip,deflate'} + """ + headers = {} + if accept_encoding: + if isinstance(accept_encoding, str): + pass + elif isinstance(accept_encoding, list): + accept_encoding = ",".join(accept_encoding) + else: + accept_encoding = ACCEPT_ENCODING + headers["accept-encoding"] = accept_encoding + + if user_agent: + headers["user-agent"] = user_agent + + if keep_alive: + headers["connection"] = "keep-alive" + + if basic_auth: + headers["authorization"] = "Basic " + b64encode(b(basic_auth)).decode("utf-8") + + if proxy_basic_auth: + headers["proxy-authorization"] = "Basic " + b64encode( + b(proxy_basic_auth) + ).decode("utf-8") + + if disable_cache: + headers["cache-control"] = "no-cache" + + return headers + + +def set_file_position(body, pos): + """ + If a position is provided, move file to that point. + Otherwise, we'll attempt to record a position for future use. + """ + if pos is not None: + rewind_body(body, pos) + elif getattr(body, "tell", None) is not None: + try: + pos = body.tell() + except (IOError, OSError): + # This differentiates from None, allowing us to catch + # a failed `tell()` later when trying to rewind the body. + pos = _FAILEDTELL + + return pos + + +def rewind_body(body, body_pos): + """ + Attempt to rewind body to a certain position. + Primarily used for request redirects and retries. + + :param body: + File-like object that supports seek. + + :param int pos: + Position to seek to in file. + """ + body_seek = getattr(body, "seek", None) + if body_seek is not None and isinstance(body_pos, integer_types): + try: + body_seek(body_pos) + except (IOError, OSError): + raise UnrewindableBodyError( + "An error occurred when rewinding request body for redirect/retry." + ) + elif body_pos is _FAILEDTELL: + raise UnrewindableBodyError( + "Unable to record file position for rewinding " + "request body during a redirect/retry." + ) + else: + raise ValueError( + "body_pos must be of type integer, instead it was %s." % type(body_pos) + ) diff --git a/openpype/hosts/fusion/vendor/urllib3/util/response.py b/openpype/hosts/fusion/vendor/urllib3/util/response.py new file mode 100644 index 0000000000..5ea609cced --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/util/response.py @@ -0,0 +1,107 @@ +from __future__ import absolute_import + +from email.errors import MultipartInvariantViolationDefect, StartBoundaryNotFoundDefect + +from ..exceptions import HeaderParsingError +from ..packages.six.moves import http_client as httplib + + +def is_fp_closed(obj): + """ + Checks whether a given file-like object is closed. + + :param obj: + The file-like object to check. + """ + + try: + # Check `isclosed()` first, in case Python3 doesn't set `closed`. + # GH Issue #928 + return obj.isclosed() + except AttributeError: + pass + + try: + # Check via the official file-like-object way. + return obj.closed + except AttributeError: + pass + + try: + # Check if the object is a container for another file-like object that + # gets released on exhaustion (e.g. HTTPResponse). + return obj.fp is None + except AttributeError: + pass + + raise ValueError("Unable to determine whether fp is closed.") + + +def assert_header_parsing(headers): + """ + Asserts whether all headers have been successfully parsed. + Extracts encountered errors from the result of parsing headers. + + Only works on Python 3. + + :param http.client.HTTPMessage headers: Headers to verify. + + :raises urllib3.exceptions.HeaderParsingError: + If parsing errors are found. + """ + + # This will fail silently if we pass in the wrong kind of parameter. + # To make debugging easier add an explicit check. + if not isinstance(headers, httplib.HTTPMessage): + raise TypeError("expected httplib.Message, got {0}.".format(type(headers))) + + defects = getattr(headers, "defects", None) + get_payload = getattr(headers, "get_payload", None) + + unparsed_data = None + if get_payload: + # get_payload is actually email.message.Message.get_payload; + # we're only interested in the result if it's not a multipart message + if not headers.is_multipart(): + payload = get_payload() + + if isinstance(payload, (bytes, str)): + unparsed_data = payload + if defects: + # httplib is assuming a response body is available + # when parsing headers even when httplib only sends + # header data to parse_headers() This results in + # defects on multipart responses in particular. + # See: https://github.com/urllib3/urllib3/issues/800 + + # So we ignore the following defects: + # - StartBoundaryNotFoundDefect: + # The claimed start boundary was never found. + # - MultipartInvariantViolationDefect: + # A message claimed to be a multipart but no subparts were found. + defects = [ + defect + for defect in defects + if not isinstance( + defect, (StartBoundaryNotFoundDefect, MultipartInvariantViolationDefect) + ) + ] + + if defects or unparsed_data: + raise HeaderParsingError(defects=defects, unparsed_data=unparsed_data) + + +def is_response_to_head(response): + """ + Checks whether the request of a response has been a HEAD-request. + Handles the quirks of AppEngine. + + :param http.client.HTTPResponse response: + Response to check if the originating request + used 'HEAD' as a method. + """ + # FIXME: Can we do this somehow without accessing private httplib _method? + method = response._method + if isinstance(method, int): # Platform-specific: Appengine + return method == 3 + return method.upper() == "HEAD" diff --git a/openpype/hosts/fusion/vendor/urllib3/util/retry.py b/openpype/hosts/fusion/vendor/urllib3/util/retry.py new file mode 100644 index 0000000000..c7dc42f1d6 --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/util/retry.py @@ -0,0 +1,602 @@ +from __future__ import absolute_import + +import email +import logging +import re +import time +import warnings +from collections import namedtuple +from itertools import takewhile + +from ..exceptions import ( + ConnectTimeoutError, + InvalidHeader, + MaxRetryError, + ProtocolError, + ProxyError, + ReadTimeoutError, + ResponseError, +) +from ..packages import six + +log = logging.getLogger(__name__) + + +# Data structure for representing the metadata of requests that result in a retry. +RequestHistory = namedtuple( + "RequestHistory", ["method", "url", "error", "status", "redirect_location"] +) + + +# TODO: In v2 we can remove this sentinel and metaclass with deprecated options. +_Default = object() + + +class _RetryMeta(type): + @property + def DEFAULT_METHOD_WHITELIST(cls): + warnings.warn( + "Using 'Retry.DEFAULT_METHOD_WHITELIST' is deprecated and " + "will be removed in v2.0. Use 'Retry.DEFAULT_ALLOWED_METHODS' instead", + DeprecationWarning, + ) + return cls.DEFAULT_ALLOWED_METHODS + + @DEFAULT_METHOD_WHITELIST.setter + def DEFAULT_METHOD_WHITELIST(cls, value): + warnings.warn( + "Using 'Retry.DEFAULT_METHOD_WHITELIST' is deprecated and " + "will be removed in v2.0. Use 'Retry.DEFAULT_ALLOWED_METHODS' instead", + DeprecationWarning, + ) + cls.DEFAULT_ALLOWED_METHODS = value + + @property + def DEFAULT_REDIRECT_HEADERS_BLACKLIST(cls): + warnings.warn( + "Using 'Retry.DEFAULT_REDIRECT_HEADERS_BLACKLIST' is deprecated and " + "will be removed in v2.0. Use 'Retry.DEFAULT_REMOVE_HEADERS_ON_REDIRECT' instead", + DeprecationWarning, + ) + return cls.DEFAULT_REMOVE_HEADERS_ON_REDIRECT + + @DEFAULT_REDIRECT_HEADERS_BLACKLIST.setter + def DEFAULT_REDIRECT_HEADERS_BLACKLIST(cls, value): + warnings.warn( + "Using 'Retry.DEFAULT_REDIRECT_HEADERS_BLACKLIST' is deprecated and " + "will be removed in v2.0. Use 'Retry.DEFAULT_REMOVE_HEADERS_ON_REDIRECT' instead", + DeprecationWarning, + ) + cls.DEFAULT_REMOVE_HEADERS_ON_REDIRECT = value + + +@six.add_metaclass(_RetryMeta) +class Retry(object): + """Retry configuration. + + Each retry attempt will create a new Retry object with updated values, so + they can be safely reused. + + Retries can be defined as a default for a pool:: + + retries = Retry(connect=5, read=2, redirect=5) + http = PoolManager(retries=retries) + response = http.request('GET', 'http://example.com/') + + Or per-request (which overrides the default for the pool):: + + response = http.request('GET', 'http://example.com/', retries=Retry(10)) + + Retries can be disabled by passing ``False``:: + + response = http.request('GET', 'http://example.com/', retries=False) + + Errors will be wrapped in :class:`~urllib3.exceptions.MaxRetryError` unless + retries are disabled, in which case the causing exception will be raised. + + :param int total: + Total number of retries to allow. Takes precedence over other counts. + + Set to ``None`` to remove this constraint and fall back on other + counts. + + Set to ``0`` to fail on the first retry. + + Set to ``False`` to disable and imply ``raise_on_redirect=False``. + + :param int connect: + How many connection-related errors to retry on. + + These are errors raised before the request is sent to the remote server, + which we assume has not triggered the server to process the request. + + Set to ``0`` to fail on the first retry of this type. + + :param int read: + How many times to retry on read errors. + + These errors are raised after the request was sent to the server, so the + request may have side-effects. + + Set to ``0`` to fail on the first retry of this type. + + :param int redirect: + How many redirects to perform. Limit this to avoid infinite redirect + loops. + + A redirect is a HTTP response with a status code 301, 302, 303, 307 or + 308. + + Set to ``0`` to fail on the first retry of this type. + + Set to ``False`` to disable and imply ``raise_on_redirect=False``. + + :param int status: + How many times to retry on bad status codes. + + These are retries made on responses, where status code matches + ``status_forcelist``. + + Set to ``0`` to fail on the first retry of this type. + + :param int other: + How many times to retry on other errors. + + Other errors are errors that are not connect, read, redirect or status errors. + These errors might be raised after the request was sent to the server, so the + request might have side-effects. + + Set to ``0`` to fail on the first retry of this type. + + If ``total`` is not set, it's a good idea to set this to 0 to account + for unexpected edge cases and avoid infinite retry loops. + + :param iterable allowed_methods: + Set of uppercased HTTP method verbs that we should retry on. + + By default, we only retry on methods which are considered to be + idempotent (multiple requests with the same parameters end with the + same state). See :attr:`Retry.DEFAULT_ALLOWED_METHODS`. + + Set to a ``False`` value to retry on any verb. + + .. warning:: + + Previously this parameter was named ``method_whitelist``, that + usage is deprecated in v1.26.0 and will be removed in v2.0. + + :param iterable status_forcelist: + A set of integer HTTP status codes that we should force a retry on. + A retry is initiated if the request method is in ``allowed_methods`` + and the response status code is in ``status_forcelist``. + + By default, this is disabled with ``None``. + + :param float backoff_factor: + A backoff factor to apply between attempts after the second try + (most errors are resolved immediately by a second try without a + delay). urllib3 will sleep for:: + + {backoff factor} * (2 ** ({number of total retries} - 1)) + + seconds. If the backoff_factor is 0.1, then :func:`.sleep` will sleep + for [0.0s, 0.2s, 0.4s, ...] between retries. It will never be longer + than :attr:`Retry.BACKOFF_MAX`. + + By default, backoff is disabled (set to 0). + + :param bool raise_on_redirect: Whether, if the number of redirects is + exhausted, to raise a MaxRetryError, or to return a response with a + response code in the 3xx range. + + :param bool raise_on_status: Similar meaning to ``raise_on_redirect``: + whether we should raise an exception, or return a response, + if status falls in ``status_forcelist`` range and retries have + been exhausted. + + :param tuple history: The history of the request encountered during + each call to :meth:`~Retry.increment`. The list is in the order + the requests occurred. Each list item is of class :class:`RequestHistory`. + + :param bool respect_retry_after_header: + Whether to respect Retry-After header on status codes defined as + :attr:`Retry.RETRY_AFTER_STATUS_CODES` or not. + + :param iterable remove_headers_on_redirect: + Sequence of headers to remove from the request when a response + indicating a redirect is returned before firing off the redirected + request. + """ + + #: Default methods to be used for ``allowed_methods`` + DEFAULT_ALLOWED_METHODS = frozenset( + ["HEAD", "GET", "PUT", "DELETE", "OPTIONS", "TRACE"] + ) + + #: Default status codes to be used for ``status_forcelist`` + RETRY_AFTER_STATUS_CODES = frozenset([413, 429, 503]) + + #: Default headers to be used for ``remove_headers_on_redirect`` + DEFAULT_REMOVE_HEADERS_ON_REDIRECT = frozenset(["Authorization"]) + + #: Maximum backoff time. + BACKOFF_MAX = 120 + + def __init__( + self, + total=10, + connect=None, + read=None, + redirect=None, + status=None, + other=None, + allowed_methods=_Default, + status_forcelist=None, + backoff_factor=0, + raise_on_redirect=True, + raise_on_status=True, + history=None, + respect_retry_after_header=True, + remove_headers_on_redirect=_Default, + # TODO: Deprecated, remove in v2.0 + method_whitelist=_Default, + ): + + if method_whitelist is not _Default: + if allowed_methods is not _Default: + raise ValueError( + "Using both 'allowed_methods' and " + "'method_whitelist' together is not allowed. " + "Instead only use 'allowed_methods'" + ) + warnings.warn( + "Using 'method_whitelist' with Retry is deprecated and " + "will be removed in v2.0. Use 'allowed_methods' instead", + DeprecationWarning, + stacklevel=2, + ) + allowed_methods = method_whitelist + if allowed_methods is _Default: + allowed_methods = self.DEFAULT_ALLOWED_METHODS + if remove_headers_on_redirect is _Default: + remove_headers_on_redirect = self.DEFAULT_REMOVE_HEADERS_ON_REDIRECT + + self.total = total + self.connect = connect + self.read = read + self.status = status + self.other = other + + if redirect is False or total is False: + redirect = 0 + raise_on_redirect = False + + self.redirect = redirect + self.status_forcelist = status_forcelist or set() + self.allowed_methods = allowed_methods + self.backoff_factor = backoff_factor + self.raise_on_redirect = raise_on_redirect + self.raise_on_status = raise_on_status + self.history = history or tuple() + self.respect_retry_after_header = respect_retry_after_header + self.remove_headers_on_redirect = frozenset( + [h.lower() for h in remove_headers_on_redirect] + ) + + def new(self, **kw): + params = dict( + total=self.total, + connect=self.connect, + read=self.read, + redirect=self.redirect, + status=self.status, + other=self.other, + status_forcelist=self.status_forcelist, + backoff_factor=self.backoff_factor, + raise_on_redirect=self.raise_on_redirect, + raise_on_status=self.raise_on_status, + history=self.history, + remove_headers_on_redirect=self.remove_headers_on_redirect, + respect_retry_after_header=self.respect_retry_after_header, + ) + + # TODO: If already given in **kw we use what's given to us + # If not given we need to figure out what to pass. We decide + # based on whether our class has the 'method_whitelist' property + # and if so we pass the deprecated 'method_whitelist' otherwise + # we use 'allowed_methods'. Remove in v2.0 + if "method_whitelist" not in kw and "allowed_methods" not in kw: + if "method_whitelist" in self.__dict__: + warnings.warn( + "Using 'method_whitelist' with Retry is deprecated and " + "will be removed in v2.0. Use 'allowed_methods' instead", + DeprecationWarning, + ) + params["method_whitelist"] = self.allowed_methods + else: + params["allowed_methods"] = self.allowed_methods + + params.update(kw) + return type(self)(**params) + + @classmethod + def from_int(cls, retries, redirect=True, default=None): + """Backwards-compatibility for the old retries format.""" + if retries is None: + retries = default if default is not None else cls.DEFAULT + + if isinstance(retries, Retry): + return retries + + redirect = bool(redirect) and None + new_retries = cls(retries, redirect=redirect) + log.debug("Converted retries value: %r -> %r", retries, new_retries) + return new_retries + + def get_backoff_time(self): + """Formula for computing the current backoff + + :rtype: float + """ + # We want to consider only the last consecutive errors sequence (Ignore redirects). + consecutive_errors_len = len( + list( + takewhile(lambda x: x.redirect_location is None, reversed(self.history)) + ) + ) + if consecutive_errors_len <= 1: + return 0 + + backoff_value = self.backoff_factor * (2 ** (consecutive_errors_len - 1)) + return min(self.BACKOFF_MAX, backoff_value) + + def parse_retry_after(self, retry_after): + # Whitespace: https://tools.ietf.org/html/rfc7230#section-3.2.4 + if re.match(r"^\s*[0-9]+\s*$", retry_after): + seconds = int(retry_after) + else: + retry_date_tuple = email.utils.parsedate_tz(retry_after) + if retry_date_tuple is None: + raise InvalidHeader("Invalid Retry-After header: %s" % retry_after) + if retry_date_tuple[9] is None: # Python 2 + # Assume UTC if no timezone was specified + # On Python2.7, parsedate_tz returns None for a timezone offset + # instead of 0 if no timezone is given, where mktime_tz treats + # a None timezone offset as local time. + retry_date_tuple = retry_date_tuple[:9] + (0,) + retry_date_tuple[10:] + + retry_date = email.utils.mktime_tz(retry_date_tuple) + seconds = retry_date - time.time() + + if seconds < 0: + seconds = 0 + + return seconds + + def get_retry_after(self, response): + """Get the value of Retry-After in seconds.""" + + retry_after = response.getheader("Retry-After") + + if retry_after is None: + return None + + return self.parse_retry_after(retry_after) + + def sleep_for_retry(self, response=None): + retry_after = self.get_retry_after(response) + if retry_after: + time.sleep(retry_after) + return True + + return False + + def _sleep_backoff(self): + backoff = self.get_backoff_time() + if backoff <= 0: + return + time.sleep(backoff) + + def sleep(self, response=None): + """Sleep between retry attempts. + + This method will respect a server's ``Retry-After`` response header + and sleep the duration of the time requested. If that is not present, it + will use an exponential backoff. By default, the backoff factor is 0 and + this method will return immediately. + """ + + if self.respect_retry_after_header and response: + slept = self.sleep_for_retry(response) + if slept: + return + + self._sleep_backoff() + + def _is_connection_error(self, err): + """Errors when we're fairly sure that the server did not receive the + request, so it should be safe to retry. + """ + if isinstance(err, ProxyError): + err = err.original_error + return isinstance(err, ConnectTimeoutError) + + def _is_read_error(self, err): + """Errors that occur after the request has been started, so we should + assume that the server began processing it. + """ + return isinstance(err, (ReadTimeoutError, ProtocolError)) + + def _is_method_retryable(self, method): + """Checks if a given HTTP method should be retried upon, depending if + it is included in the allowed_methods + """ + # TODO: For now favor if the Retry implementation sets its own method_whitelist + # property outside of our constructor to avoid breaking custom implementations. + if "method_whitelist" in self.__dict__: + warnings.warn( + "Using 'method_whitelist' with Retry is deprecated and " + "will be removed in v2.0. Use 'allowed_methods' instead", + DeprecationWarning, + ) + allowed_methods = self.method_whitelist + else: + allowed_methods = self.allowed_methods + + if allowed_methods and method.upper() not in allowed_methods: + return False + return True + + def is_retry(self, method, status_code, has_retry_after=False): + """Is this method/status code retryable? (Based on allowlists and control + variables such as the number of total retries to allow, whether to + respect the Retry-After header, whether this header is present, and + whether the returned status code is on the list of status codes to + be retried upon on the presence of the aforementioned header) + """ + if not self._is_method_retryable(method): + return False + + if self.status_forcelist and status_code in self.status_forcelist: + return True + + return ( + self.total + and self.respect_retry_after_header + and has_retry_after + and (status_code in self.RETRY_AFTER_STATUS_CODES) + ) + + def is_exhausted(self): + """Are we out of retries?""" + retry_counts = ( + self.total, + self.connect, + self.read, + self.redirect, + self.status, + self.other, + ) + retry_counts = list(filter(None, retry_counts)) + if not retry_counts: + return False + + return min(retry_counts) < 0 + + def increment( + self, + method=None, + url=None, + response=None, + error=None, + _pool=None, + _stacktrace=None, + ): + """Return a new Retry object with incremented retry counters. + + :param response: A response object, or None, if the server did not + return a response. + :type response: :class:`~urllib3.response.HTTPResponse` + :param Exception error: An error encountered during the request, or + None if the response was received successfully. + + :return: A new ``Retry`` object. + """ + if self.total is False and error: + # Disabled, indicate to re-raise the error. + raise six.reraise(type(error), error, _stacktrace) + + total = self.total + if total is not None: + total -= 1 + + connect = self.connect + read = self.read + redirect = self.redirect + status_count = self.status + other = self.other + cause = "unknown" + status = None + redirect_location = None + + if error and self._is_connection_error(error): + # Connect retry? + if connect is False: + raise six.reraise(type(error), error, _stacktrace) + elif connect is not None: + connect -= 1 + + elif error and self._is_read_error(error): + # Read retry? + if read is False or not self._is_method_retryable(method): + raise six.reraise(type(error), error, _stacktrace) + elif read is not None: + read -= 1 + + elif error: + # Other retry? + if other is not None: + other -= 1 + + elif response and response.get_redirect_location(): + # Redirect retry? + if redirect is not None: + redirect -= 1 + cause = "too many redirects" + redirect_location = response.get_redirect_location() + status = response.status + + else: + # Incrementing because of a server error like a 500 in + # status_forcelist and the given method is in the allowed_methods + cause = ResponseError.GENERIC_ERROR + if response and response.status: + if status_count is not None: + status_count -= 1 + cause = ResponseError.SPECIFIC_ERROR.format(status_code=response.status) + status = response.status + + history = self.history + ( + RequestHistory(method, url, error, status, redirect_location), + ) + + new_retry = self.new( + total=total, + connect=connect, + read=read, + redirect=redirect, + status=status_count, + other=other, + history=history, + ) + + if new_retry.is_exhausted(): + raise MaxRetryError(_pool, url, error or ResponseError(cause)) + + log.debug("Incremented Retry for (url='%s'): %r", url, new_retry) + + return new_retry + + def __repr__(self): + return ( + "{cls.__name__}(total={self.total}, connect={self.connect}, " + "read={self.read}, redirect={self.redirect}, status={self.status})" + ).format(cls=type(self), self=self) + + def __getattr__(self, item): + if item == "method_whitelist": + # TODO: Remove this deprecated alias in v2.0 + warnings.warn( + "Using 'method_whitelist' with Retry is deprecated and " + "will be removed in v2.0. Use 'allowed_methods' instead", + DeprecationWarning, + ) + return self.allowed_methods + try: + return getattr(super(Retry, self), item) + except AttributeError: + return getattr(Retry, item) + + +# For backwards compatibility (equivalent to pre-v1.9): +Retry.DEFAULT = Retry(3) diff --git a/openpype/hosts/fusion/vendor/urllib3/util/ssl_.py b/openpype/hosts/fusion/vendor/urllib3/util/ssl_.py new file mode 100644 index 0000000000..8f867812a5 --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/util/ssl_.py @@ -0,0 +1,495 @@ +from __future__ import absolute_import + +import hmac +import os +import sys +import warnings +from binascii import hexlify, unhexlify +from hashlib import md5, sha1, sha256 + +from ..exceptions import ( + InsecurePlatformWarning, + ProxySchemeUnsupported, + SNIMissingWarning, + SSLError, +) +from ..packages import six +from .url import BRACELESS_IPV6_ADDRZ_RE, IPV4_RE + +SSLContext = None +SSLTransport = None +HAS_SNI = False +IS_PYOPENSSL = False +IS_SECURETRANSPORT = False +ALPN_PROTOCOLS = ["http/1.1"] + +# Maps the length of a digest to a possible hash function producing this digest +HASHFUNC_MAP = {32: md5, 40: sha1, 64: sha256} + + +def _const_compare_digest_backport(a, b): + """ + Compare two digests of equal length in constant time. + + The digests must be of type str/bytes. + Returns True if the digests match, and False otherwise. + """ + result = abs(len(a) - len(b)) + for left, right in zip(bytearray(a), bytearray(b)): + result |= left ^ right + return result == 0 + + +_const_compare_digest = getattr(hmac, "compare_digest", _const_compare_digest_backport) + +try: # Test for SSL features + import ssl + from ssl import CERT_REQUIRED, wrap_socket +except ImportError: + pass + +try: + from ssl import HAS_SNI # Has SNI? +except ImportError: + pass + +try: + from .ssltransport import SSLTransport +except ImportError: + pass + + +try: # Platform-specific: Python 3.6 + from ssl import PROTOCOL_TLS + + PROTOCOL_SSLv23 = PROTOCOL_TLS +except ImportError: + try: + from ssl import PROTOCOL_SSLv23 as PROTOCOL_TLS + + PROTOCOL_SSLv23 = PROTOCOL_TLS + except ImportError: + PROTOCOL_SSLv23 = PROTOCOL_TLS = 2 + +try: + from ssl import PROTOCOL_TLS_CLIENT +except ImportError: + PROTOCOL_TLS_CLIENT = PROTOCOL_TLS + + +try: + from ssl import OP_NO_COMPRESSION, OP_NO_SSLv2, OP_NO_SSLv3 +except ImportError: + OP_NO_SSLv2, OP_NO_SSLv3 = 0x1000000, 0x2000000 + OP_NO_COMPRESSION = 0x20000 + + +try: # OP_NO_TICKET was added in Python 3.6 + from ssl import OP_NO_TICKET +except ImportError: + OP_NO_TICKET = 0x4000 + + +# A secure default. +# Sources for more information on TLS ciphers: +# +# - https://wiki.mozilla.org/Security/Server_Side_TLS +# - https://www.ssllabs.com/projects/best-practices/index.html +# - https://hynek.me/articles/hardening-your-web-servers-ssl-ciphers/ +# +# The general intent is: +# - prefer cipher suites that offer perfect forward secrecy (DHE/ECDHE), +# - prefer ECDHE over DHE for better performance, +# - prefer any AES-GCM and ChaCha20 over any AES-CBC for better performance and +# security, +# - prefer AES-GCM over ChaCha20 because hardware-accelerated AES is common, +# - disable NULL authentication, MD5 MACs, DSS, and other +# insecure ciphers for security reasons. +# - NOTE: TLS 1.3 cipher suites are managed through a different interface +# not exposed by CPython (yet!) and are enabled by default if they're available. +DEFAULT_CIPHERS = ":".join( + [ + "ECDHE+AESGCM", + "ECDHE+CHACHA20", + "DHE+AESGCM", + "DHE+CHACHA20", + "ECDH+AESGCM", + "DH+AESGCM", + "ECDH+AES", + "DH+AES", + "RSA+AESGCM", + "RSA+AES", + "!aNULL", + "!eNULL", + "!MD5", + "!DSS", + ] +) + +try: + from ssl import SSLContext # Modern SSL? +except ImportError: + + class SSLContext(object): # Platform-specific: Python 2 + def __init__(self, protocol_version): + self.protocol = protocol_version + # Use default values from a real SSLContext + self.check_hostname = False + self.verify_mode = ssl.CERT_NONE + self.ca_certs = None + self.options = 0 + self.certfile = None + self.keyfile = None + self.ciphers = None + + def load_cert_chain(self, certfile, keyfile): + self.certfile = certfile + self.keyfile = keyfile + + def load_verify_locations(self, cafile=None, capath=None, cadata=None): + self.ca_certs = cafile + + if capath is not None: + raise SSLError("CA directories not supported in older Pythons") + + if cadata is not None: + raise SSLError("CA data not supported in older Pythons") + + def set_ciphers(self, cipher_suite): + self.ciphers = cipher_suite + + def wrap_socket(self, socket, server_hostname=None, server_side=False): + warnings.warn( + "A true SSLContext object is not available. This prevents " + "urllib3 from configuring SSL appropriately and may cause " + "certain SSL connections to fail. You can upgrade to a newer " + "version of Python to solve this. For more information, see " + "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html" + "#ssl-warnings", + InsecurePlatformWarning, + ) + kwargs = { + "keyfile": self.keyfile, + "certfile": self.certfile, + "ca_certs": self.ca_certs, + "cert_reqs": self.verify_mode, + "ssl_version": self.protocol, + "server_side": server_side, + } + return wrap_socket(socket, ciphers=self.ciphers, **kwargs) + + +def assert_fingerprint(cert, fingerprint): + """ + Checks if given fingerprint matches the supplied certificate. + + :param cert: + Certificate as bytes object. + :param fingerprint: + Fingerprint as string of hexdigits, can be interspersed by colons. + """ + + fingerprint = fingerprint.replace(":", "").lower() + digest_length = len(fingerprint) + hashfunc = HASHFUNC_MAP.get(digest_length) + if not hashfunc: + raise SSLError("Fingerprint of invalid length: {0}".format(fingerprint)) + + # We need encode() here for py32; works on py2 and p33. + fingerprint_bytes = unhexlify(fingerprint.encode()) + + cert_digest = hashfunc(cert).digest() + + if not _const_compare_digest(cert_digest, fingerprint_bytes): + raise SSLError( + 'Fingerprints did not match. Expected "{0}", got "{1}".'.format( + fingerprint, hexlify(cert_digest) + ) + ) + + +def resolve_cert_reqs(candidate): + """ + Resolves the argument to a numeric constant, which can be passed to + the wrap_socket function/method from the ssl module. + Defaults to :data:`ssl.CERT_REQUIRED`. + If given a string it is assumed to be the name of the constant in the + :mod:`ssl` module or its abbreviation. + (So you can specify `REQUIRED` instead of `CERT_REQUIRED`. + If it's neither `None` nor a string we assume it is already the numeric + constant which can directly be passed to wrap_socket. + """ + if candidate is None: + return CERT_REQUIRED + + if isinstance(candidate, str): + res = getattr(ssl, candidate, None) + if res is None: + res = getattr(ssl, "CERT_" + candidate) + return res + + return candidate + + +def resolve_ssl_version(candidate): + """ + like resolve_cert_reqs + """ + if candidate is None: + return PROTOCOL_TLS + + if isinstance(candidate, str): + res = getattr(ssl, candidate, None) + if res is None: + res = getattr(ssl, "PROTOCOL_" + candidate) + return res + + return candidate + + +def create_urllib3_context( + ssl_version=None, cert_reqs=None, options=None, ciphers=None +): + """All arguments have the same meaning as ``ssl_wrap_socket``. + + By default, this function does a lot of the same work that + ``ssl.create_default_context`` does on Python 3.4+. It: + + - Disables SSLv2, SSLv3, and compression + - Sets a restricted set of server ciphers + + If you wish to enable SSLv3, you can do:: + + from urllib3.util import ssl_ + context = ssl_.create_urllib3_context() + context.options &= ~ssl_.OP_NO_SSLv3 + + You can do the same to enable compression (substituting ``COMPRESSION`` + for ``SSLv3`` in the last line above). + + :param ssl_version: + The desired protocol version to use. This will default to + PROTOCOL_SSLv23 which will negotiate the highest protocol that both + the server and your installation of OpenSSL support. + :param cert_reqs: + Whether to require the certificate verification. This defaults to + ``ssl.CERT_REQUIRED``. + :param options: + Specific OpenSSL options. These default to ``ssl.OP_NO_SSLv2``, + ``ssl.OP_NO_SSLv3``, ``ssl.OP_NO_COMPRESSION``, and ``ssl.OP_NO_TICKET``. + :param ciphers: + Which cipher suites to allow the server to select. + :returns: + Constructed SSLContext object with specified options + :rtype: SSLContext + """ + # PROTOCOL_TLS is deprecated in Python 3.10 + if not ssl_version or ssl_version == PROTOCOL_TLS: + ssl_version = PROTOCOL_TLS_CLIENT + + context = SSLContext(ssl_version) + + context.set_ciphers(ciphers or DEFAULT_CIPHERS) + + # Setting the default here, as we may have no ssl module on import + cert_reqs = ssl.CERT_REQUIRED if cert_reqs is None else cert_reqs + + if options is None: + options = 0 + # SSLv2 is easily broken and is considered harmful and dangerous + options |= OP_NO_SSLv2 + # SSLv3 has several problems and is now dangerous + options |= OP_NO_SSLv3 + # Disable compression to prevent CRIME attacks for OpenSSL 1.0+ + # (issue #309) + options |= OP_NO_COMPRESSION + # TLSv1.2 only. Unless set explicitly, do not request tickets. + # This may save some bandwidth on wire, and although the ticket is encrypted, + # there is a risk associated with it being on wire, + # if the server is not rotating its ticketing keys properly. + options |= OP_NO_TICKET + + context.options |= options + + # Enable post-handshake authentication for TLS 1.3, see GH #1634. PHA is + # necessary for conditional client cert authentication with TLS 1.3. + # The attribute is None for OpenSSL <= 1.1.0 or does not exist in older + # versions of Python. We only enable on Python 3.7.4+ or if certificate + # verification is enabled to work around Python issue #37428 + # See: https://bugs.python.org/issue37428 + if (cert_reqs == ssl.CERT_REQUIRED or sys.version_info >= (3, 7, 4)) and getattr( + context, "post_handshake_auth", None + ) is not None: + context.post_handshake_auth = True + + def disable_check_hostname(): + if ( + getattr(context, "check_hostname", None) is not None + ): # Platform-specific: Python 3.2 + # We do our own verification, including fingerprints and alternative + # hostnames. So disable it here + context.check_hostname = False + + # The order of the below lines setting verify_mode and check_hostname + # matter due to safe-guards SSLContext has to prevent an SSLContext with + # check_hostname=True, verify_mode=NONE/OPTIONAL. This is made even more + # complex because we don't know whether PROTOCOL_TLS_CLIENT will be used + # or not so we don't know the initial state of the freshly created SSLContext. + if cert_reqs == ssl.CERT_REQUIRED: + context.verify_mode = cert_reqs + disable_check_hostname() + else: + disable_check_hostname() + context.verify_mode = cert_reqs + + # Enable logging of TLS session keys via defacto standard environment variable + # 'SSLKEYLOGFILE', if the feature is available (Python 3.8+). Skip empty values. + if hasattr(context, "keylog_filename"): + sslkeylogfile = os.environ.get("SSLKEYLOGFILE") + if sslkeylogfile: + context.keylog_filename = sslkeylogfile + + return context + + +def ssl_wrap_socket( + sock, + keyfile=None, + certfile=None, + cert_reqs=None, + ca_certs=None, + server_hostname=None, + ssl_version=None, + ciphers=None, + ssl_context=None, + ca_cert_dir=None, + key_password=None, + ca_cert_data=None, + tls_in_tls=False, +): + """ + All arguments except for server_hostname, ssl_context, and ca_cert_dir have + the same meaning as they do when using :func:`ssl.wrap_socket`. + + :param server_hostname: + When SNI is supported, the expected hostname of the certificate + :param ssl_context: + A pre-made :class:`SSLContext` object. If none is provided, one will + be created using :func:`create_urllib3_context`. + :param ciphers: + A string of ciphers we wish the client to support. + :param ca_cert_dir: + A directory containing CA certificates in multiple separate files, as + supported by OpenSSL's -CApath flag or the capath argument to + SSLContext.load_verify_locations(). + :param key_password: + Optional password if the keyfile is encrypted. + :param ca_cert_data: + Optional string containing CA certificates in PEM format suitable for + passing as the cadata parameter to SSLContext.load_verify_locations() + :param tls_in_tls: + Use SSLTransport to wrap the existing socket. + """ + context = ssl_context + if context is None: + # Note: This branch of code and all the variables in it are no longer + # used by urllib3 itself. We should consider deprecating and removing + # this code. + context = create_urllib3_context(ssl_version, cert_reqs, ciphers=ciphers) + + if ca_certs or ca_cert_dir or ca_cert_data: + try: + context.load_verify_locations(ca_certs, ca_cert_dir, ca_cert_data) + except (IOError, OSError) as e: + raise SSLError(e) + + elif ssl_context is None and hasattr(context, "load_default_certs"): + # try to load OS default certs; works well on Windows (require Python3.4+) + context.load_default_certs() + + # Attempt to detect if we get the goofy behavior of the + # keyfile being encrypted and OpenSSL asking for the + # passphrase via the terminal and instead error out. + if keyfile and key_password is None and _is_key_file_encrypted(keyfile): + raise SSLError("Client private key is encrypted, password is required") + + if certfile: + if key_password is None: + context.load_cert_chain(certfile, keyfile) + else: + context.load_cert_chain(certfile, keyfile, key_password) + + try: + if hasattr(context, "set_alpn_protocols"): + context.set_alpn_protocols(ALPN_PROTOCOLS) + except NotImplementedError: # Defensive: in CI, we always have set_alpn_protocols + pass + + # If we detect server_hostname is an IP address then the SNI + # extension should not be used according to RFC3546 Section 3.1 + use_sni_hostname = server_hostname and not is_ipaddress(server_hostname) + # SecureTransport uses server_hostname in certificate verification. + send_sni = (use_sni_hostname and HAS_SNI) or ( + IS_SECURETRANSPORT and server_hostname + ) + # Do not warn the user if server_hostname is an invalid SNI hostname. + if not HAS_SNI and use_sni_hostname: + warnings.warn( + "An HTTPS request has been made, but the SNI (Server Name " + "Indication) extension to TLS is not available on this platform. " + "This may cause the server to present an incorrect TLS " + "certificate, which can cause validation failures. You can upgrade to " + "a newer version of Python to solve this. For more information, see " + "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html" + "#ssl-warnings", + SNIMissingWarning, + ) + + if send_sni: + ssl_sock = _ssl_wrap_socket_impl( + sock, context, tls_in_tls, server_hostname=server_hostname + ) + else: + ssl_sock = _ssl_wrap_socket_impl(sock, context, tls_in_tls) + return ssl_sock + + +def is_ipaddress(hostname): + """Detects whether the hostname given is an IPv4 or IPv6 address. + Also detects IPv6 addresses with Zone IDs. + + :param str hostname: Hostname to examine. + :return: True if the hostname is an IP address, False otherwise. + """ + if not six.PY2 and isinstance(hostname, bytes): + # IDN A-label bytes are ASCII compatible. + hostname = hostname.decode("ascii") + return bool(IPV4_RE.match(hostname) or BRACELESS_IPV6_ADDRZ_RE.match(hostname)) + + +def _is_key_file_encrypted(key_file): + """Detects if a key file is encrypted or not.""" + with open(key_file, "r") as f: + for line in f: + # Look for Proc-Type: 4,ENCRYPTED + if "ENCRYPTED" in line: + return True + + return False + + +def _ssl_wrap_socket_impl(sock, ssl_context, tls_in_tls, server_hostname=None): + if tls_in_tls: + if not SSLTransport: + # Import error, ssl is not available. + raise ProxySchemeUnsupported( + "TLS in TLS requires support for the 'ssl' module" + ) + + SSLTransport._validate_ssl_context_for_tls_in_tls(ssl_context) + return SSLTransport(sock, ssl_context, server_hostname) + + if server_hostname: + return ssl_context.wrap_socket(sock, server_hostname=server_hostname) + else: + return ssl_context.wrap_socket(sock) diff --git a/openpype/hosts/fusion/vendor/urllib3/util/ssltransport.py b/openpype/hosts/fusion/vendor/urllib3/util/ssltransport.py new file mode 100644 index 0000000000..c2186bced9 --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/util/ssltransport.py @@ -0,0 +1,221 @@ +import io +import socket +import ssl + +from urllib3.exceptions import ProxySchemeUnsupported +from urllib3.packages import six + +SSL_BLOCKSIZE = 16384 + + +class SSLTransport: + """ + The SSLTransport wraps an existing socket and establishes an SSL connection. + + Contrary to Python's implementation of SSLSocket, it allows you to chain + multiple TLS connections together. It's particularly useful if you need to + implement TLS within TLS. + + The class supports most of the socket API operations. + """ + + @staticmethod + def _validate_ssl_context_for_tls_in_tls(ssl_context): + """ + Raises a ProxySchemeUnsupported if the provided ssl_context can't be used + for TLS in TLS. + + The only requirement is that the ssl_context provides the 'wrap_bio' + methods. + """ + + if not hasattr(ssl_context, "wrap_bio"): + if six.PY2: + raise ProxySchemeUnsupported( + "TLS in TLS requires SSLContext.wrap_bio() which isn't " + "supported on Python 2" + ) + else: + raise ProxySchemeUnsupported( + "TLS in TLS requires SSLContext.wrap_bio() which isn't " + "available on non-native SSLContext" + ) + + def __init__( + self, socket, ssl_context, server_hostname=None, suppress_ragged_eofs=True + ): + """ + Create an SSLTransport around socket using the provided ssl_context. + """ + self.incoming = ssl.MemoryBIO() + self.outgoing = ssl.MemoryBIO() + + self.suppress_ragged_eofs = suppress_ragged_eofs + self.socket = socket + + self.sslobj = ssl_context.wrap_bio( + self.incoming, self.outgoing, server_hostname=server_hostname + ) + + # Perform initial handshake. + self._ssl_io_loop(self.sslobj.do_handshake) + + def __enter__(self): + return self + + def __exit__(self, *_): + self.close() + + def fileno(self): + return self.socket.fileno() + + def read(self, len=1024, buffer=None): + return self._wrap_ssl_read(len, buffer) + + def recv(self, len=1024, flags=0): + if flags != 0: + raise ValueError("non-zero flags not allowed in calls to recv") + return self._wrap_ssl_read(len) + + def recv_into(self, buffer, nbytes=None, flags=0): + if flags != 0: + raise ValueError("non-zero flags not allowed in calls to recv_into") + if buffer and (nbytes is None): + nbytes = len(buffer) + elif nbytes is None: + nbytes = 1024 + return self.read(nbytes, buffer) + + def sendall(self, data, flags=0): + if flags != 0: + raise ValueError("non-zero flags not allowed in calls to sendall") + count = 0 + with memoryview(data) as view, view.cast("B") as byte_view: + amount = len(byte_view) + while count < amount: + v = self.send(byte_view[count:]) + count += v + + def send(self, data, flags=0): + if flags != 0: + raise ValueError("non-zero flags not allowed in calls to send") + response = self._ssl_io_loop(self.sslobj.write, data) + return response + + def makefile( + self, mode="r", buffering=None, encoding=None, errors=None, newline=None + ): + """ + Python's httpclient uses makefile and buffered io when reading HTTP + messages and we need to support it. + + This is unfortunately a copy and paste of socket.py makefile with small + changes to point to the socket directly. + """ + if not set(mode) <= {"r", "w", "b"}: + raise ValueError("invalid mode %r (only r, w, b allowed)" % (mode,)) + + writing = "w" in mode + reading = "r" in mode or not writing + assert reading or writing + binary = "b" in mode + rawmode = "" + if reading: + rawmode += "r" + if writing: + rawmode += "w" + raw = socket.SocketIO(self, rawmode) + self.socket._io_refs += 1 + if buffering is None: + buffering = -1 + if buffering < 0: + buffering = io.DEFAULT_BUFFER_SIZE + if buffering == 0: + if not binary: + raise ValueError("unbuffered streams must be binary") + return raw + if reading and writing: + buffer = io.BufferedRWPair(raw, raw, buffering) + elif reading: + buffer = io.BufferedReader(raw, buffering) + else: + assert writing + buffer = io.BufferedWriter(raw, buffering) + if binary: + return buffer + text = io.TextIOWrapper(buffer, encoding, errors, newline) + text.mode = mode + return text + + def unwrap(self): + self._ssl_io_loop(self.sslobj.unwrap) + + def close(self): + self.socket.close() + + def getpeercert(self, binary_form=False): + return self.sslobj.getpeercert(binary_form) + + def version(self): + return self.sslobj.version() + + def cipher(self): + return self.sslobj.cipher() + + def selected_alpn_protocol(self): + return self.sslobj.selected_alpn_protocol() + + def selected_npn_protocol(self): + return self.sslobj.selected_npn_protocol() + + def shared_ciphers(self): + return self.sslobj.shared_ciphers() + + def compression(self): + return self.sslobj.compression() + + def settimeout(self, value): + self.socket.settimeout(value) + + def gettimeout(self): + return self.socket.gettimeout() + + def _decref_socketios(self): + self.socket._decref_socketios() + + def _wrap_ssl_read(self, len, buffer=None): + try: + return self._ssl_io_loop(self.sslobj.read, len, buffer) + except ssl.SSLError as e: + if e.errno == ssl.SSL_ERROR_EOF and self.suppress_ragged_eofs: + return 0 # eof, return 0. + else: + raise + + def _ssl_io_loop(self, func, *args): + """Performs an I/O loop between incoming/outgoing and the socket.""" + should_loop = True + ret = None + + while should_loop: + errno = None + try: + ret = func(*args) + except ssl.SSLError as e: + if e.errno not in (ssl.SSL_ERROR_WANT_READ, ssl.SSL_ERROR_WANT_WRITE): + # WANT_READ, and WANT_WRITE are expected, others are not. + raise e + errno = e.errno + + buf = self.outgoing.read() + self.socket.sendall(buf) + + if errno is None: + should_loop = False + elif errno == ssl.SSL_ERROR_WANT_READ: + buf = self.socket.recv(SSL_BLOCKSIZE) + if buf: + self.incoming.write(buf) + else: + self.incoming.write_eof() + return ret diff --git a/openpype/hosts/fusion/vendor/urllib3/util/timeout.py b/openpype/hosts/fusion/vendor/urllib3/util/timeout.py new file mode 100644 index 0000000000..ff69593b05 --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/util/timeout.py @@ -0,0 +1,268 @@ +from __future__ import absolute_import + +import time + +# The default socket timeout, used by httplib to indicate that no timeout was +# specified by the user +from socket import _GLOBAL_DEFAULT_TIMEOUT + +from ..exceptions import TimeoutStateError + +# A sentinel value to indicate that no timeout was specified by the user in +# urllib3 +_Default = object() + + +# Use time.monotonic if available. +current_time = getattr(time, "monotonic", time.time) + + +class Timeout(object): + """Timeout configuration. + + Timeouts can be defined as a default for a pool: + + .. code-block:: python + + timeout = Timeout(connect=2.0, read=7.0) + http = PoolManager(timeout=timeout) + response = http.request('GET', 'http://example.com/') + + Or per-request (which overrides the default for the pool): + + .. code-block:: python + + response = http.request('GET', 'http://example.com/', timeout=Timeout(10)) + + Timeouts can be disabled by setting all the parameters to ``None``: + + .. code-block:: python + + no_timeout = Timeout(connect=None, read=None) + response = http.request('GET', 'http://example.com/, timeout=no_timeout) + + + :param total: + This combines the connect and read timeouts into one; the read timeout + will be set to the time leftover from the connect attempt. In the + event that both a connect timeout and a total are specified, or a read + timeout and a total are specified, the shorter timeout will be applied. + + Defaults to None. + + :type total: int, float, or None + + :param connect: + The maximum amount of time (in seconds) to wait for a connection + attempt to a server to succeed. Omitting the parameter will default the + connect timeout to the system default, probably `the global default + timeout in socket.py + `_. + None will set an infinite timeout for connection attempts. + + :type connect: int, float, or None + + :param read: + The maximum amount of time (in seconds) to wait between consecutive + read operations for a response from the server. Omitting the parameter + will default the read timeout to the system default, probably `the + global default timeout in socket.py + `_. + None will set an infinite timeout. + + :type read: int, float, or None + + .. note:: + + Many factors can affect the total amount of time for urllib3 to return + an HTTP response. + + For example, Python's DNS resolver does not obey the timeout specified + on the socket. Other factors that can affect total request time include + high CPU load, high swap, the program running at a low priority level, + or other behaviors. + + In addition, the read and total timeouts only measure the time between + read operations on the socket connecting the client and the server, + not the total amount of time for the request to return a complete + response. For most requests, the timeout is raised because the server + has not sent the first byte in the specified time. This is not always + the case; if a server streams one byte every fifteen seconds, a timeout + of 20 seconds will not trigger, even though the request will take + several minutes to complete. + + If your goal is to cut off any request after a set amount of wall clock + time, consider having a second "watcher" thread to cut off a slow + request. + """ + + #: A sentinel object representing the default timeout value + DEFAULT_TIMEOUT = _GLOBAL_DEFAULT_TIMEOUT + + def __init__(self, total=None, connect=_Default, read=_Default): + self._connect = self._validate_timeout(connect, "connect") + self._read = self._validate_timeout(read, "read") + self.total = self._validate_timeout(total, "total") + self._start_connect = None + + def __repr__(self): + return "%s(connect=%r, read=%r, total=%r)" % ( + type(self).__name__, + self._connect, + self._read, + self.total, + ) + + # __str__ provided for backwards compatibility + __str__ = __repr__ + + @classmethod + def _validate_timeout(cls, value, name): + """Check that a timeout attribute is valid. + + :param value: The timeout value to validate + :param name: The name of the timeout attribute to validate. This is + used to specify in error messages. + :return: The validated and casted version of the given value. + :raises ValueError: If it is a numeric value less than or equal to + zero, or the type is not an integer, float, or None. + """ + if value is _Default: + return cls.DEFAULT_TIMEOUT + + if value is None or value is cls.DEFAULT_TIMEOUT: + return value + + if isinstance(value, bool): + raise ValueError( + "Timeout cannot be a boolean value. It must " + "be an int, float or None." + ) + try: + float(value) + except (TypeError, ValueError): + raise ValueError( + "Timeout value %s was %s, but it must be an " + "int, float or None." % (name, value) + ) + + try: + if value <= 0: + raise ValueError( + "Attempted to set %s timeout to %s, but the " + "timeout cannot be set to a value less " + "than or equal to 0." % (name, value) + ) + except TypeError: + # Python 3 + raise ValueError( + "Timeout value %s was %s, but it must be an " + "int, float or None." % (name, value) + ) + + return value + + @classmethod + def from_float(cls, timeout): + """Create a new Timeout from a legacy timeout value. + + The timeout value used by httplib.py sets the same timeout on the + connect(), and recv() socket requests. This creates a :class:`Timeout` + object that sets the individual timeouts to the ``timeout`` value + passed to this function. + + :param timeout: The legacy timeout value. + :type timeout: integer, float, sentinel default object, or None + :return: Timeout object + :rtype: :class:`Timeout` + """ + return Timeout(read=timeout, connect=timeout) + + def clone(self): + """Create a copy of the timeout object + + Timeout properties are stored per-pool but each request needs a fresh + Timeout object to ensure each one has its own start/stop configured. + + :return: a copy of the timeout object + :rtype: :class:`Timeout` + """ + # We can't use copy.deepcopy because that will also create a new object + # for _GLOBAL_DEFAULT_TIMEOUT, which socket.py uses as a sentinel to + # detect the user default. + return Timeout(connect=self._connect, read=self._read, total=self.total) + + def start_connect(self): + """Start the timeout clock, used during a connect() attempt + + :raises urllib3.exceptions.TimeoutStateError: if you attempt + to start a timer that has been started already. + """ + if self._start_connect is not None: + raise TimeoutStateError("Timeout timer has already been started.") + self._start_connect = current_time() + return self._start_connect + + def get_connect_duration(self): + """Gets the time elapsed since the call to :meth:`start_connect`. + + :return: Elapsed time in seconds. + :rtype: float + :raises urllib3.exceptions.TimeoutStateError: if you attempt + to get duration for a timer that hasn't been started. + """ + if self._start_connect is None: + raise TimeoutStateError( + "Can't get connect duration for timer that has not started." + ) + return current_time() - self._start_connect + + @property + def connect_timeout(self): + """Get the value to use when setting a connection timeout. + + This will be a positive float or integer, the value None + (never timeout), or the default system timeout. + + :return: Connect timeout. + :rtype: int, float, :attr:`Timeout.DEFAULT_TIMEOUT` or None + """ + if self.total is None: + return self._connect + + if self._connect is None or self._connect is self.DEFAULT_TIMEOUT: + return self.total + + return min(self._connect, self.total) + + @property + def read_timeout(self): + """Get the value for the read timeout. + + This assumes some time has elapsed in the connection timeout and + computes the read timeout appropriately. + + If self.total is set, the read timeout is dependent on the amount of + time taken by the connect timeout. If the connection time has not been + established, a :exc:`~urllib3.exceptions.TimeoutStateError` will be + raised. + + :return: Value to use for the read timeout. + :rtype: int, float, :attr:`Timeout.DEFAULT_TIMEOUT` or None + :raises urllib3.exceptions.TimeoutStateError: If :meth:`start_connect` + has not yet been called on this object. + """ + if ( + self.total is not None + and self.total is not self.DEFAULT_TIMEOUT + and self._read is not None + and self._read is not self.DEFAULT_TIMEOUT + ): + # In case the connect timeout has not yet been established. + if self._start_connect is None: + return self._read + return max(0, min(self.total - self.get_connect_duration(), self._read)) + elif self.total is not None and self.total is not self.DEFAULT_TIMEOUT: + return max(0, self.total - self.get_connect_duration()) + else: + return self._read diff --git a/openpype/hosts/fusion/vendor/urllib3/util/url.py b/openpype/hosts/fusion/vendor/urllib3/util/url.py new file mode 100644 index 0000000000..81a03da9e3 --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/util/url.py @@ -0,0 +1,432 @@ +from __future__ import absolute_import + +import re +from collections import namedtuple + +from ..exceptions import LocationParseError +from ..packages import six + +url_attrs = ["scheme", "auth", "host", "port", "path", "query", "fragment"] + +# We only want to normalize urls with an HTTP(S) scheme. +# urllib3 infers URLs without a scheme (None) to be http. +NORMALIZABLE_SCHEMES = ("http", "https", None) + +# Almost all of these patterns were derived from the +# 'rfc3986' module: https://github.com/python-hyper/rfc3986 +PERCENT_RE = re.compile(r"%[a-fA-F0-9]{2}") +SCHEME_RE = re.compile(r"^(?:[a-zA-Z][a-zA-Z0-9+-]*:|/)") +URI_RE = re.compile( + r"^(?:([a-zA-Z][a-zA-Z0-9+.-]*):)?" + r"(?://([^\\/?#]*))?" + r"([^?#]*)" + r"(?:\?([^#]*))?" + r"(?:#(.*))?$", + re.UNICODE | re.DOTALL, +) + +IPV4_PAT = r"(?:[0-9]{1,3}\.){3}[0-9]{1,3}" +HEX_PAT = "[0-9A-Fa-f]{1,4}" +LS32_PAT = "(?:{hex}:{hex}|{ipv4})".format(hex=HEX_PAT, ipv4=IPV4_PAT) +_subs = {"hex": HEX_PAT, "ls32": LS32_PAT} +_variations = [ + # 6( h16 ":" ) ls32 + "(?:%(hex)s:){6}%(ls32)s", + # "::" 5( h16 ":" ) ls32 + "::(?:%(hex)s:){5}%(ls32)s", + # [ h16 ] "::" 4( h16 ":" ) ls32 + "(?:%(hex)s)?::(?:%(hex)s:){4}%(ls32)s", + # [ *1( h16 ":" ) h16 ] "::" 3( h16 ":" ) ls32 + "(?:(?:%(hex)s:)?%(hex)s)?::(?:%(hex)s:){3}%(ls32)s", + # [ *2( h16 ":" ) h16 ] "::" 2( h16 ":" ) ls32 + "(?:(?:%(hex)s:){0,2}%(hex)s)?::(?:%(hex)s:){2}%(ls32)s", + # [ *3( h16 ":" ) h16 ] "::" h16 ":" ls32 + "(?:(?:%(hex)s:){0,3}%(hex)s)?::%(hex)s:%(ls32)s", + # [ *4( h16 ":" ) h16 ] "::" ls32 + "(?:(?:%(hex)s:){0,4}%(hex)s)?::%(ls32)s", + # [ *5( h16 ":" ) h16 ] "::" h16 + "(?:(?:%(hex)s:){0,5}%(hex)s)?::%(hex)s", + # [ *6( h16 ":" ) h16 ] "::" + "(?:(?:%(hex)s:){0,6}%(hex)s)?::", +] + +UNRESERVED_PAT = r"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._!\-~" +IPV6_PAT = "(?:" + "|".join([x % _subs for x in _variations]) + ")" +ZONE_ID_PAT = "(?:%25|%)(?:[" + UNRESERVED_PAT + "]|%[a-fA-F0-9]{2})+" +IPV6_ADDRZ_PAT = r"\[" + IPV6_PAT + r"(?:" + ZONE_ID_PAT + r")?\]" +REG_NAME_PAT = r"(?:[^\[\]%:/?#]|%[a-fA-F0-9]{2})*" +TARGET_RE = re.compile(r"^(/[^?#]*)(?:\?([^#]*))?(?:#.*)?$") + +IPV4_RE = re.compile("^" + IPV4_PAT + "$") +IPV6_RE = re.compile("^" + IPV6_PAT + "$") +IPV6_ADDRZ_RE = re.compile("^" + IPV6_ADDRZ_PAT + "$") +BRACELESS_IPV6_ADDRZ_RE = re.compile("^" + IPV6_ADDRZ_PAT[2:-2] + "$") +ZONE_ID_RE = re.compile("(" + ZONE_ID_PAT + r")\]$") + +_HOST_PORT_PAT = ("^(%s|%s|%s)(?::([0-9]{0,5}))?$") % ( + REG_NAME_PAT, + IPV4_PAT, + IPV6_ADDRZ_PAT, +) +_HOST_PORT_RE = re.compile(_HOST_PORT_PAT, re.UNICODE | re.DOTALL) + +UNRESERVED_CHARS = set( + "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._-~" +) +SUB_DELIM_CHARS = set("!$&'()*+,;=") +USERINFO_CHARS = UNRESERVED_CHARS | SUB_DELIM_CHARS | {":"} +PATH_CHARS = USERINFO_CHARS | {"@", "/"} +QUERY_CHARS = FRAGMENT_CHARS = PATH_CHARS | {"?"} + + +class Url(namedtuple("Url", url_attrs)): + """ + Data structure for representing an HTTP URL. Used as a return value for + :func:`parse_url`. Both the scheme and host are normalized as they are + both case-insensitive according to RFC 3986. + """ + + __slots__ = () + + def __new__( + cls, + scheme=None, + auth=None, + host=None, + port=None, + path=None, + query=None, + fragment=None, + ): + if path and not path.startswith("/"): + path = "/" + path + if scheme is not None: + scheme = scheme.lower() + return super(Url, cls).__new__( + cls, scheme, auth, host, port, path, query, fragment + ) + + @property + def hostname(self): + """For backwards-compatibility with urlparse. We're nice like that.""" + return self.host + + @property + def request_uri(self): + """Absolute path including the query string.""" + uri = self.path or "/" + + if self.query is not None: + uri += "?" + self.query + + return uri + + @property + def netloc(self): + """Network location including host and port""" + if self.port: + return "%s:%d" % (self.host, self.port) + return self.host + + @property + def url(self): + """ + Convert self into a url + + This function should more or less round-trip with :func:`.parse_url`. The + returned url may not be exactly the same as the url inputted to + :func:`.parse_url`, but it should be equivalent by the RFC (e.g., urls + with a blank port will have : removed). + + Example: :: + + >>> U = parse_url('http://google.com/mail/') + >>> U.url + 'http://google.com/mail/' + >>> Url('http', 'username:password', 'host.com', 80, + ... '/path', 'query', 'fragment').url + 'http://username:password@host.com:80/path?query#fragment' + """ + scheme, auth, host, port, path, query, fragment = self + url = u"" + + # We use "is not None" we want things to happen with empty strings (or 0 port) + if scheme is not None: + url += scheme + u"://" + if auth is not None: + url += auth + u"@" + if host is not None: + url += host + if port is not None: + url += u":" + str(port) + if path is not None: + url += path + if query is not None: + url += u"?" + query + if fragment is not None: + url += u"#" + fragment + + return url + + def __str__(self): + return self.url + + +def split_first(s, delims): + """ + .. deprecated:: 1.25 + + Given a string and an iterable of delimiters, split on the first found + delimiter. Return two split parts and the matched delimiter. + + If not found, then the first part is the full input string. + + Example:: + + >>> split_first('foo/bar?baz', '?/=') + ('foo', 'bar?baz', '/') + >>> split_first('foo/bar?baz', '123') + ('foo/bar?baz', '', None) + + Scales linearly with number of delims. Not ideal for large number of delims. + """ + min_idx = None + min_delim = None + for d in delims: + idx = s.find(d) + if idx < 0: + continue + + if min_idx is None or idx < min_idx: + min_idx = idx + min_delim = d + + if min_idx is None or min_idx < 0: + return s, "", None + + return s[:min_idx], s[min_idx + 1 :], min_delim + + +def _encode_invalid_chars(component, allowed_chars, encoding="utf-8"): + """Percent-encodes a URI component without reapplying + onto an already percent-encoded component. + """ + if component is None: + return component + + component = six.ensure_text(component) + + # Normalize existing percent-encoded bytes. + # Try to see if the component we're encoding is already percent-encoded + # so we can skip all '%' characters but still encode all others. + component, percent_encodings = PERCENT_RE.subn( + lambda match: match.group(0).upper(), component + ) + + uri_bytes = component.encode("utf-8", "surrogatepass") + is_percent_encoded = percent_encodings == uri_bytes.count(b"%") + encoded_component = bytearray() + + for i in range(0, len(uri_bytes)): + # Will return a single character bytestring on both Python 2 & 3 + byte = uri_bytes[i : i + 1] + byte_ord = ord(byte) + if (is_percent_encoded and byte == b"%") or ( + byte_ord < 128 and byte.decode() in allowed_chars + ): + encoded_component += byte + continue + encoded_component.extend(b"%" + (hex(byte_ord)[2:].encode().zfill(2).upper())) + + return encoded_component.decode(encoding) + + +def _remove_path_dot_segments(path): + # See http://tools.ietf.org/html/rfc3986#section-5.2.4 for pseudo-code + segments = path.split("/") # Turn the path into a list of segments + output = [] # Initialize the variable to use to store output + + for segment in segments: + # '.' is the current directory, so ignore it, it is superfluous + if segment == ".": + continue + # Anything other than '..', should be appended to the output + elif segment != "..": + output.append(segment) + # In this case segment == '..', if we can, we should pop the last + # element + elif output: + output.pop() + + # If the path starts with '/' and the output is empty or the first string + # is non-empty + if path.startswith("/") and (not output or output[0]): + output.insert(0, "") + + # If the path starts with '/.' or '/..' ensure we add one more empty + # string to add a trailing '/' + if path.endswith(("/.", "/..")): + output.append("") + + return "/".join(output) + + +def _normalize_host(host, scheme): + if host: + if isinstance(host, six.binary_type): + host = six.ensure_str(host) + + if scheme in NORMALIZABLE_SCHEMES: + is_ipv6 = IPV6_ADDRZ_RE.match(host) + if is_ipv6: + match = ZONE_ID_RE.search(host) + if match: + start, end = match.span(1) + zone_id = host[start:end] + + if zone_id.startswith("%25") and zone_id != "%25": + zone_id = zone_id[3:] + else: + zone_id = zone_id[1:] + zone_id = "%" + _encode_invalid_chars(zone_id, UNRESERVED_CHARS) + return host[:start].lower() + zone_id + host[end:] + else: + return host.lower() + elif not IPV4_RE.match(host): + return six.ensure_str( + b".".join([_idna_encode(label) for label in host.split(".")]) + ) + return host + + +def _idna_encode(name): + if name and any([ord(x) > 128 for x in name]): + try: + import idna + except ImportError: + six.raise_from( + LocationParseError("Unable to parse URL without the 'idna' module"), + None, + ) + try: + return idna.encode(name.lower(), strict=True, std3_rules=True) + except idna.IDNAError: + six.raise_from( + LocationParseError(u"Name '%s' is not a valid IDNA label" % name), None + ) + return name.lower().encode("ascii") + + +def _encode_target(target): + """Percent-encodes a request target so that there are no invalid characters""" + path, query = TARGET_RE.match(target).groups() + target = _encode_invalid_chars(path, PATH_CHARS) + query = _encode_invalid_chars(query, QUERY_CHARS) + if query is not None: + target += "?" + query + return target + + +def parse_url(url): + """ + Given a url, return a parsed :class:`.Url` namedtuple. Best-effort is + performed to parse incomplete urls. Fields not provided will be None. + This parser is RFC 3986 compliant. + + The parser logic and helper functions are based heavily on + work done in the ``rfc3986`` module. + + :param str url: URL to parse into a :class:`.Url` namedtuple. + + Partly backwards-compatible with :mod:`urlparse`. + + Example:: + + >>> parse_url('http://google.com/mail/') + Url(scheme='http', host='google.com', port=None, path='/mail/', ...) + >>> parse_url('google.com:80') + Url(scheme=None, host='google.com', port=80, path=None, ...) + >>> parse_url('/foo?bar') + Url(scheme=None, host=None, port=None, path='/foo', query='bar', ...) + """ + if not url: + # Empty + return Url() + + source_url = url + if not SCHEME_RE.search(url): + url = "//" + url + + try: + scheme, authority, path, query, fragment = URI_RE.match(url).groups() + normalize_uri = scheme is None or scheme.lower() in NORMALIZABLE_SCHEMES + + if scheme: + scheme = scheme.lower() + + if authority: + auth, _, host_port = authority.rpartition("@") + auth = auth or None + host, port = _HOST_PORT_RE.match(host_port).groups() + if auth and normalize_uri: + auth = _encode_invalid_chars(auth, USERINFO_CHARS) + if port == "": + port = None + else: + auth, host, port = None, None, None + + if port is not None: + port = int(port) + if not (0 <= port <= 65535): + raise LocationParseError(url) + + host = _normalize_host(host, scheme) + + if normalize_uri and path: + path = _remove_path_dot_segments(path) + path = _encode_invalid_chars(path, PATH_CHARS) + if normalize_uri and query: + query = _encode_invalid_chars(query, QUERY_CHARS) + if normalize_uri and fragment: + fragment = _encode_invalid_chars(fragment, FRAGMENT_CHARS) + + except (ValueError, AttributeError): + return six.raise_from(LocationParseError(source_url), None) + + # For the sake of backwards compatibility we put empty + # string values for path if there are any defined values + # beyond the path in the URL. + # TODO: Remove this when we break backwards compatibility. + if not path: + if query is not None or fragment is not None: + path = "" + else: + path = None + + # Ensure that each part of the URL is a `str` for + # backwards compatibility. + if isinstance(url, six.text_type): + ensure_func = six.ensure_text + else: + ensure_func = six.ensure_str + + def ensure_type(x): + return x if x is None else ensure_func(x) + + return Url( + scheme=ensure_type(scheme), + auth=ensure_type(auth), + host=ensure_type(host), + port=port, + path=ensure_type(path), + query=ensure_type(query), + fragment=ensure_type(fragment), + ) + + +def get_host(url): + """ + Deprecated. Use :func:`parse_url` instead. + """ + p = parse_url(url) + return p.scheme or "http", p.hostname, p.port diff --git a/openpype/hosts/fusion/vendor/urllib3/util/wait.py b/openpype/hosts/fusion/vendor/urllib3/util/wait.py new file mode 100644 index 0000000000..c280646c7b --- /dev/null +++ b/openpype/hosts/fusion/vendor/urllib3/util/wait.py @@ -0,0 +1,153 @@ +import errno +import select +import sys +from functools import partial + +try: + from time import monotonic +except ImportError: + from time import time as monotonic + +__all__ = ["NoWayToWaitForSocketError", "wait_for_read", "wait_for_write"] + + +class NoWayToWaitForSocketError(Exception): + pass + + +# How should we wait on sockets? +# +# There are two types of APIs you can use for waiting on sockets: the fancy +# modern stateful APIs like epoll/kqueue, and the older stateless APIs like +# select/poll. The stateful APIs are more efficient when you have a lots of +# sockets to keep track of, because you can set them up once and then use them +# lots of times. But we only ever want to wait on a single socket at a time +# and don't want to keep track of state, so the stateless APIs are actually +# more efficient. So we want to use select() or poll(). +# +# Now, how do we choose between select() and poll()? On traditional Unixes, +# select() has a strange calling convention that makes it slow, or fail +# altogether, for high-numbered file descriptors. The point of poll() is to fix +# that, so on Unixes, we prefer poll(). +# +# On Windows, there is no poll() (or at least Python doesn't provide a wrapper +# for it), but that's OK, because on Windows, select() doesn't have this +# strange calling convention; plain select() works fine. +# +# So: on Windows we use select(), and everywhere else we use poll(). We also +# fall back to select() in case poll() is somehow broken or missing. + +if sys.version_info >= (3, 5): + # Modern Python, that retries syscalls by default + def _retry_on_intr(fn, timeout): + return fn(timeout) + + +else: + # Old and broken Pythons. + def _retry_on_intr(fn, timeout): + if timeout is None: + deadline = float("inf") + else: + deadline = monotonic() + timeout + + while True: + try: + return fn(timeout) + # OSError for 3 <= pyver < 3.5, select.error for pyver <= 2.7 + except (OSError, select.error) as e: + # 'e.args[0]' incantation works for both OSError and select.error + if e.args[0] != errno.EINTR: + raise + else: + timeout = deadline - monotonic() + if timeout < 0: + timeout = 0 + if timeout == float("inf"): + timeout = None + continue + + +def select_wait_for_socket(sock, read=False, write=False, timeout=None): + if not read and not write: + raise RuntimeError("must specify at least one of read=True, write=True") + rcheck = [] + wcheck = [] + if read: + rcheck.append(sock) + if write: + wcheck.append(sock) + # When doing a non-blocking connect, most systems signal success by + # marking the socket writable. Windows, though, signals success by marked + # it as "exceptional". We paper over the difference by checking the write + # sockets for both conditions. (The stdlib selectors module does the same + # thing.) + fn = partial(select.select, rcheck, wcheck, wcheck) + rready, wready, xready = _retry_on_intr(fn, timeout) + return bool(rready or wready or xready) + + +def poll_wait_for_socket(sock, read=False, write=False, timeout=None): + if not read and not write: + raise RuntimeError("must specify at least one of read=True, write=True") + mask = 0 + if read: + mask |= select.POLLIN + if write: + mask |= select.POLLOUT + poll_obj = select.poll() + poll_obj.register(sock, mask) + + # For some reason, poll() takes timeout in milliseconds + def do_poll(t): + if t is not None: + t *= 1000 + return poll_obj.poll(t) + + return bool(_retry_on_intr(do_poll, timeout)) + + +def null_wait_for_socket(*args, **kwargs): + raise NoWayToWaitForSocketError("no select-equivalent available") + + +def _have_working_poll(): + # Apparently some systems have a select.poll that fails as soon as you try + # to use it, either due to strange configuration or broken monkeypatching + # from libraries like eventlet/greenlet. + try: + poll_obj = select.poll() + _retry_on_intr(poll_obj.poll, 0) + except (AttributeError, OSError): + return False + else: + return True + + +def wait_for_socket(*args, **kwargs): + # We delay choosing which implementation to use until the first time we're + # called. We could do it at import time, but then we might make the wrong + # decision if someone goes wild with monkeypatching select.poll after + # we're imported. + global wait_for_socket + if _have_working_poll(): + wait_for_socket = poll_wait_for_socket + elif hasattr(select, "select"): + wait_for_socket = select_wait_for_socket + else: # Platform-specific: Appengine. + wait_for_socket = null_wait_for_socket + return wait_for_socket(*args, **kwargs) + + +def wait_for_read(sock, timeout=None): + """Waits for reading to be available on a given socket. + Returns True if the socket is readable, or False if the timeout expired. + """ + return wait_for_socket(sock, read=True, timeout=timeout) + + +def wait_for_write(sock, timeout=None): + """Waits for writing to be available on a given socket. + Returns True if the socket is readable, or False if the timeout expired. + """ + return wait_for_socket(sock, write=True, timeout=timeout) From 851f234237d69dd8ccdea76304a2f1ab7d7a564a Mon Sep 17 00:00:00 2001 From: Ynbot Date: Sat, 16 Sep 2023 03:24:27 +0000 Subject: [PATCH 35/36] [Automated] Bump version --- openpype/version.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/openpype/version.py b/openpype/version.py index c4a87e7843..bbed1b0ef3 100644 --- a/openpype/version.py +++ b/openpype/version.py @@ -1,3 +1,3 @@ # -*- coding: utf-8 -*- """Package declaring Pype version.""" -__version__ = "3.16.7-nightly.1" +__version__ = "3.16.7-nightly.2" From 10ed783907dbd3df9c511c71cf144b75ccd810f3 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Sat, 16 Sep 2023 03:25:05 +0000 Subject: [PATCH 36/36] chore(): update bug report / version --- .github/ISSUE_TEMPLATE/bug_report.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml index 35564c2bf0..cf3cb8ba1a 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yml +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -35,6 +35,7 @@ body: label: Version description: What version are you running? Look to OpenPype Tray options: + - 3.16.7-nightly.2 - 3.16.7-nightly.1 - 3.16.6 - 3.16.6-nightly.1 @@ -134,7 +135,6 @@ body: - 3.14.10-nightly.1 - 3.14.9 - 3.14.9-nightly.5 - - 3.14.9-nightly.4 validations: required: true - type: dropdown