From 5b18acadc0c76e7bd51f5fe8a6b1b93486a0e79e Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Thu, 26 Oct 2023 21:33:31 +0800
Subject: [PATCH 01/15] Implement ValidateAttributes in 3dsMax

---
 .../plugins/publish/validate_attributes.py    | 62 +++++++++++++++++++
 openpype/settings/ayon_settings.py            |  9 +++
 .../defaults/project_settings/max.json        |  4 ++
 .../schemas/schema_max_publish.json           | 19 ++++++
 .../max/server/settings/publishers.py         | 36 ++++++++++-
 5 files changed, 128 insertions(+), 2 deletions(-)
 create mode 100644 openpype/hosts/max/plugins/publish/validate_attributes.py

diff --git a/openpype/hosts/max/plugins/publish/validate_attributes.py b/openpype/hosts/max/plugins/publish/validate_attributes.py
new file mode 100644
index 0000000000..e98e73de06
--- /dev/null
+++ b/openpype/hosts/max/plugins/publish/validate_attributes.py
@@ -0,0 +1,62 @@
+# -*- coding: utf-8 -*-
+"""Validator for Attributes."""
+from pyblish.api import ContextPlugin, ValidatorOrder
+from pymxs import runtime as rt
+
+from openpype.pipeline.publish import (
+    OptionalPyblishPluginMixin,
+    PublishValidationError,
+    RepairContextAction
+)
+
+
+class ValidateAttributes(OptionalPyblishPluginMixin,
+                         ContextPlugin):
+    """Validates attributes are consistent in 3ds max."""
+
+    order = ValidatorOrder
+    hosts = ["max"]
+    label = "Attributes"
+    actions = [RepairContextAction]
+    optional = True
+
+    @classmethod
+    def get_invalid(cls, context):
+        attributes = (
+            context.data["project_settings"]["max"]["publish"]
+                        ["ValidateAttributes"]["attributes"]
+        )
+        if not attributes:
+            return
+
+        invalid_attributes = [key for key, value in attributes.items()
+                              if rt.Execute(attributes[key]) != value]
+
+        return invalid_attributes
+
+    def process(self, context):
+        if not self.is_active(context.data):
+            self.log.debug("Skipping Validate Attributes...")
+            return
+        invalid_attributes = self.get_invalid(context)
+        if invalid_attributes:
+            bullet_point_invalid_statement = "\n".join(
+                "- {}".format(invalid) for invalid in invalid_attributes
+            )
+            report = (
+                "Required Attribute(s) have invalid value(s).\n\n"
+                f"{bullet_point_invalid_statement}\n\n"
+                "You can use repair action to fix it."
+            )
+            raise PublishValidationError(
+                report, title="Invalid Value(s) for Required Attribute(s)")
+
+    @classmethod
+    def repair(cls, context):
+        attributes = (
+            context.data["project_settings"]["max"]["publish"]
+                        ["ValidateAttributes"]["attributes"]
+        )
+        invalid_attribute_keys = cls.get_invalid(context)
+        for key in invalid_attribute_keys:
+            attributes[key] = rt.Execute(attributes[key])
diff --git a/openpype/settings/ayon_settings.py b/openpype/settings/ayon_settings.py
index 8d4683490b..a31c8a04e0 100644
--- a/openpype/settings/ayon_settings.py
+++ b/openpype/settings/ayon_settings.py
@@ -639,6 +639,15 @@ def _convert_3dsmax_project_settings(ayon_settings, output):
             for item in point_cloud_attribute
         }
         ayon_max["PointCloud"]["attribute"] = new_point_cloud_attribute
+    # --- Publish (START) ---
+    ayon_publish = ayon_max["publish"]
+    try:
+        attributes = json.loads(
+            ayon_publish["ValidateAttributes"]["attributes"]
+        )
+    except ValueError:
+        attributes = {}
+    ayon_publish["ValidateAttributes"]["attributes"] = attributes
 
     output["max"] = ayon_max
 
diff --git a/openpype/settings/defaults/project_settings/max.json b/openpype/settings/defaults/project_settings/max.json
index bfb1aa4aeb..24a87020bb 100644
--- a/openpype/settings/defaults/project_settings/max.json
+++ b/openpype/settings/defaults/project_settings/max.json
@@ -36,6 +36,10 @@
             "enabled": true,
             "optional": true,
             "active": true
+        },
+        "ValidateAttributes": {
+            "enabled": false,
+            "attributes": {}
         }
     }
 }
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_max_publish.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_max_publish.json
index ea08c735a6..c3b56bae5e 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_max_publish.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_max_publish.json
@@ -28,6 +28,25 @@
                 "label": "Active"
             }
         ]
+      },
+      {
+        "type": "dict",
+        "collapsible": true,
+        "key": "ValidateAttributes",
+        "label": "ValidateAttributes",
+        "checkbox_key": "enabled",
+        "children": [
+            {
+                "type": "boolean",
+                "key": "enabled",
+                "label": "Enabled"
+            },
+            {
+                "type": "raw-json",
+                "key": "attributes",
+                "label": "Attributes"
+            }
+        ]
       }
     ]
   }
diff --git a/server_addon/max/server/settings/publishers.py b/server_addon/max/server/settings/publishers.py
index a695b85e89..df8412391a 100644
--- a/server_addon/max/server/settings/publishers.py
+++ b/server_addon/max/server/settings/publishers.py
@@ -1,6 +1,30 @@
-from pydantic import Field
+import json
+from pydantic import Field, validator
 
 from ayon_server.settings import BaseSettingsModel
+from ayon_server.exceptions import BadRequestException
+
+
+class ValidateAttributesModel(BaseSettingsModel):
+    enabled: bool = Field(title="ValidateAttributes")
+    attributes: str = Field(
+        "{}", title="Attributes", widget="textarea")
+
+    @validator("attributes")
+    def validate_json(cls, value):
+        if not value.strip():
+            return "{}"
+        try:
+            converted_value = json.loads(value)
+            success = isinstance(converted_value, dict)
+        except json.JSONDecodeError:
+            success = False
+
+        if not success:
+            raise BadRequestException(
+                "The attibutes can't be parsed as json object"
+            )
+        return value
 
 
 class BasicValidateModel(BaseSettingsModel):
@@ -15,6 +39,10 @@ class PublishersModel(BaseSettingsModel):
         title="Validate Frame Range",
         section="Validators"
     )
+    ValidateAttributes: ValidateAttributesModel = Field(
+        default_factory=ValidateAttributesModel,
+        title="Validate Attributes"
+    )
 
 
 DEFAULT_PUBLISH_SETTINGS = {
@@ -22,5 +50,9 @@ DEFAULT_PUBLISH_SETTINGS = {
         "enabled": True,
         "optional": True,
         "active": True
-    }
+    },
+    "ValidateAttributes": {
+        "enabled": False,
+        "attributes": "{}"
+    },
 }

From 6a0decab459db0b83b777289521584f2eaca02a2 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Fri, 27 Oct 2023 21:09:29 +0800
Subject: [PATCH 02/15] make sure to check invalid properties

---
 .../plugins/publish/validate_attributes.py    | 26 ++++++++++++++-----
 1 file changed, 20 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/max/plugins/publish/validate_attributes.py b/openpype/hosts/max/plugins/publish/validate_attributes.py
index e98e73de06..2d3f09f972 100644
--- a/openpype/hosts/max/plugins/publish/validate_attributes.py
+++ b/openpype/hosts/max/plugins/publish/validate_attributes.py
@@ -29,10 +29,20 @@ class ValidateAttributes(OptionalPyblishPluginMixin,
         if not attributes:
             return
 
-        invalid_attributes = [key for key, value in attributes.items()
-                              if rt.Execute(attributes[key]) != value]
+        for wrap_object, property_name in attributes.items():
+            invalid_properties = [key for key in property_name.keys()
+                                  if not rt.Execute(
+                                      f'isProperty {wrap_object} "{key}"')]
+            if invalid_properties:
+                cls.log.error(
+                    "Unknown Property Values:{}".format(invalid_properties))
+                return invalid_properties
+            # TODO: support multiple varaible types in maxscript
+            invalid_attributes = [key for key, value in property_name.items()
+                                  if rt.Execute("{}.{}".format(
+                                      wrap_object, property_name[key]))!=value]
 
-        return invalid_attributes
+            return invalid_attributes
 
     def process(self, context):
         if not self.is_active(context.data):
@@ -57,6 +67,10 @@ class ValidateAttributes(OptionalPyblishPluginMixin,
             context.data["project_settings"]["max"]["publish"]
                         ["ValidateAttributes"]["attributes"]
         )
-        invalid_attribute_keys = cls.get_invalid(context)
-        for key in invalid_attribute_keys:
-            attributes[key] = rt.Execute(attributes[key])
+        for wrap_object, property_name in attributes.items():
+            invalid_attributes = [key for key, value in property_name.items()
+                                  if rt.Execute("{}.{}".format(
+                                      wrap_object, property_name[key]))!=value]
+            for attrs in invalid_attributes:
+                rt.Execute("{}.{}={}".format(
+                    wrap_object, attrs, attributes[wrap_object][attrs]))

From c029fa632489529e36dbdaec5b74d2e938f46847 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Mon, 30 Oct 2023 17:21:29 +0800
Subject: [PATCH 03/15] support invalid checks on different variable types of
 attributes in Maxscript

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

diff --git a/openpype/hosts/max/plugins/publish/validate_attributes.py b/openpype/hosts/max/plugins/publish/validate_attributes.py
index 2d3f09f972..fa9912de07 100644
--- a/openpype/hosts/max/plugins/publish/validate_attributes.py
+++ b/openpype/hosts/max/plugins/publish/validate_attributes.py
@@ -38,9 +38,20 @@ class ValidateAttributes(OptionalPyblishPluginMixin,
                     "Unknown Property Values:{}".format(invalid_properties))
                 return invalid_properties
             # TODO: support multiple varaible types in maxscript
-            invalid_attributes = [key for key, value in property_name.items()
-                                  if rt.Execute("{}.{}".format(
-                                      wrap_object, property_name[key]))!=value]
+            invalid_attributes = []
+            for key, value in property_name.items():
+                property_key = rt.Execute("{}.{}".format(
+                    wrap_object, key))
+                if isinstance(value, str) and "#" not in value:
+                    if property_key != '"{}"'.format(value):
+                        invalid_attributes.append(key)
+
+                elif isinstance(value, bool):
+                    if property_key != value:
+                        invalid_attributes.append(key)
+                else:
+                    if property_key != '{}'.format(value):
+                        invalid_attributes.append(key)
 
             return invalid_attributes
 
@@ -71,6 +82,7 @@ class ValidateAttributes(OptionalPyblishPluginMixin,
             invalid_attributes = [key for key, value in property_name.items()
                                   if rt.Execute("{}.{}".format(
                                       wrap_object, property_name[key]))!=value]
+
             for attrs in invalid_attributes:
                 rt.Execute("{}.{}={}".format(
                     wrap_object, attrs, attributes[wrap_object][attrs]))

From 6c7e5c66a6b85e2ee8e42c2c9b38ea6639d9dd42 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Mon, 30 Oct 2023 21:13:42 +0800
Subject: [PATCH 04/15] support invalid checks on different variable types of
 attributes in Maxscript & repair actions

---
 .../plugins/publish/validate_attributes.py    | 45 +++++++++++--------
 1 file changed, 26 insertions(+), 19 deletions(-)

diff --git a/openpype/hosts/max/plugins/publish/validate_attributes.py b/openpype/hosts/max/plugins/publish/validate_attributes.py
index fa9912de07..f266b2bca1 100644
--- a/openpype/hosts/max/plugins/publish/validate_attributes.py
+++ b/openpype/hosts/max/plugins/publish/validate_attributes.py
@@ -42,16 +42,16 @@ class ValidateAttributes(OptionalPyblishPluginMixin,
             for key, value in property_name.items():
                 property_key = rt.Execute("{}.{}".format(
                     wrap_object, key))
-                if isinstance(value, str) and "#" not in value:
-                    if property_key != '"{}"'.format(value):
-                        invalid_attributes.append(key)
-
-                elif isinstance(value, bool):
-                    if property_key != value:
-                        invalid_attributes.append(key)
+                if isinstance(value, str) and (
+                    value.startswith("#") and not value.endswith(")")
+                ):
+                    # not applicable for #() array value type
+                    # and only applicable for enum i.e. #bob, #sally
+                    if "#{}".format(property_key) != value:
+                        invalid_attributes.append((wrap_object, key))
                 else:
-                    if property_key != '{}'.format(value):
-                        invalid_attributes.append(key)
+                    if property_key != value:
+                        invalid_attributes.append((wrap_object, key))
 
             return invalid_attributes
 
@@ -62,12 +62,14 @@ class ValidateAttributes(OptionalPyblishPluginMixin,
         invalid_attributes = self.get_invalid(context)
         if invalid_attributes:
             bullet_point_invalid_statement = "\n".join(
-                "- {}".format(invalid) for invalid in invalid_attributes
+                "- {}".format(invalid) for invalid
+                in invalid_attributes
             )
             report = (
                 "Required Attribute(s) have invalid value(s).\n\n"
                 f"{bullet_point_invalid_statement}\n\n"
-                "You can use repair action to fix it."
+                "You can use repair action to fix them if they are not\n"
+                "unknown property value(s)"
             )
             raise PublishValidationError(
                 report, title="Invalid Value(s) for Required Attribute(s)")
@@ -78,11 +80,16 @@ class ValidateAttributes(OptionalPyblishPluginMixin,
             context.data["project_settings"]["max"]["publish"]
                         ["ValidateAttributes"]["attributes"]
         )
-        for wrap_object, property_name in attributes.items():
-            invalid_attributes = [key for key, value in property_name.items()
-                                  if rt.Execute("{}.{}".format(
-                                      wrap_object, property_name[key]))!=value]
-
-            for attrs in invalid_attributes:
-                rt.Execute("{}.{}={}".format(
-                    wrap_object, attrs, attributes[wrap_object][attrs]))
+        invalid_attributes = cls.get_invalid(context)
+        for attrs in invalid_attributes:
+            prop, attr = attrs
+            value = attributes[prop][attr]
+            if isinstance(value, str) and not value.startswith("#"):
+                attribute_fix = '{}.{}="{}"'.format(
+                    prop, attr, value
+                )
+            else:
+                attribute_fix = "{}.{}={}".format(
+                    prop, attr, value
+                )
+            rt.Execute(attribute_fix)

From f0b8d8d79826df7c27650dfbe68046e2d2d63d9d Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Tue, 31 Oct 2023 14:19:37 +0800
Subject: [PATCH 05/15] add docstrings and clean up the codes on the validator

---
 .../plugins/publish/validate_attributes.py    | 80 +++++++++++++------
 1 file changed, 55 insertions(+), 25 deletions(-)

diff --git a/openpype/hosts/max/plugins/publish/validate_attributes.py b/openpype/hosts/max/plugins/publish/validate_attributes.py
index f266b2bca1..f603934eed 100644
--- a/openpype/hosts/max/plugins/publish/validate_attributes.py
+++ b/openpype/hosts/max/plugins/publish/validate_attributes.py
@@ -10,9 +10,47 @@ from openpype.pipeline.publish import (
 )
 
 
+def has_property(object_name, property_name):
+    """Return whether an object has a property with given name"""
+    return rt.Execute(f'isProperty {object_name} "{property_name}"')
+
+def is_matching_value(object_name, property_name, value):
+    """Return whether an existing property matches value `value"""
+    property_value = rt.Execute(f"{object_name}.{property_name}")
+
+    # Wrap property value if value is a string valued attributes
+    # starting with a `#`
+    if (
+        isinstance(value, str) and
+        value.startswith("#") and
+        not value.endswith(")")
+    ):
+        # prefix value with `#`
+        # not applicable for #() array value type
+        # and only applicable for enum i.e. #bob, #sally
+        property_value = f"#{property_value}"
+
+    return property_value == value
+
+
 class ValidateAttributes(OptionalPyblishPluginMixin,
                          ContextPlugin):
-    """Validates attributes are consistent in 3ds max."""
+    """Validates attributes in the project setting are consistent
+    with the nodes from MaxWrapper Class in 3ds max.
+    E.g. "renderers.current.separateAovFiles",
+         "renderers.production.PrimaryGIEngine"
+    Admin(s) need to put json below and enable this validator for a check:
+    {
+       "renderers.current":{
+            "separateAovFiles" : True
+        }
+        "renderers.production":{
+            "PrimaryGIEngine": "#RS_GIENGINE_BRUTE_FORCE",
+        }
+        ....
+    }
+
+    """
 
     order = ValidatorOrder
     hosts = ["max"]
@@ -28,32 +66,24 @@ class ValidateAttributes(OptionalPyblishPluginMixin,
         )
         if not attributes:
             return
+        invalid = []
+        for object_name, required_properties in attributes.items():
+            if not rt.Execute(f"isValidValue {object_name}"):
+                # Skip checking if the node does not
+                # exist in MaxWrapper Class
+                continue
 
-        for wrap_object, property_name in attributes.items():
-            invalid_properties = [key for key in property_name.keys()
-                                  if not rt.Execute(
-                                      f'isProperty {wrap_object} "{key}"')]
-            if invalid_properties:
-                cls.log.error(
-                    "Unknown Property Values:{}".format(invalid_properties))
-                return invalid_properties
-            # TODO: support multiple varaible types in maxscript
-            invalid_attributes = []
-            for key, value in property_name.items():
-                property_key = rt.Execute("{}.{}".format(
-                    wrap_object, key))
-                if isinstance(value, str) and (
-                    value.startswith("#") and not value.endswith(")")
-                ):
-                    # not applicable for #() array value type
-                    # and only applicable for enum i.e. #bob, #sally
-                    if "#{}".format(property_key) != value:
-                        invalid_attributes.append((wrap_object, key))
-                else:
-                    if property_key != value:
-                        invalid_attributes.append((wrap_object, key))
+            for property_name, value in required_properties.items():
+                if not has_property(object_name, property_name):
+                    cls.log.error(f"Non-existing property: {object_name}.{property_name}")
+                    invalid.append((object_name, property_name))
 
-            return invalid_attributes
+                if not is_matching_value(object_name, property_name, value):
+                    cls.log.error(
+                        f"Invalid value for: {object_name}.{property_name}. Should be: {value}")
+                    invalid.append((object_name, property_name))
+
+        return invalid
 
     def process(self, context):
         if not self.is_active(context.data):

From 4c204a87a917ef05bf5b23e3f180d4f95650a3fb Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Tue, 31 Oct 2023 14:20:25 +0800
Subject: [PATCH 06/15] hound

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

diff --git a/openpype/hosts/max/plugins/publish/validate_attributes.py b/openpype/hosts/max/plugins/publish/validate_attributes.py
index f603934eed..44d6c64139 100644
--- a/openpype/hosts/max/plugins/publish/validate_attributes.py
+++ b/openpype/hosts/max/plugins/publish/validate_attributes.py
@@ -14,6 +14,7 @@ def has_property(object_name, property_name):
     """Return whether an object has a property with given name"""
     return rt.Execute(f'isProperty {object_name} "{property_name}"')
 
+
 def is_matching_value(object_name, property_name, value):
     """Return whether an existing property matches value `value"""
     property_value = rt.Execute(f"{object_name}.{property_name}")

From 33a21674c5e752c19be8636ab6587f38f91f8f59 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Tue, 31 Oct 2023 14:21:37 +0800
Subject: [PATCH 07/15] hound

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

diff --git a/openpype/hosts/max/plugins/publish/validate_attributes.py b/openpype/hosts/max/plugins/publish/validate_attributes.py
index 44d6c64139..5697237c95 100644
--- a/openpype/hosts/max/plugins/publish/validate_attributes.py
+++ b/openpype/hosts/max/plugins/publish/validate_attributes.py
@@ -76,12 +76,14 @@ class ValidateAttributes(OptionalPyblishPluginMixin,
 
             for property_name, value in required_properties.items():
                 if not has_property(object_name, property_name):
-                    cls.log.error(f"Non-existing property: {object_name}.{property_name}")
+                    cls.log.error(
+                        f"Non-existing property: {object_name}.{property_name}")
                     invalid.append((object_name, property_name))
 
                 if not is_matching_value(object_name, property_name, value):
                     cls.log.error(
-                        f"Invalid value for: {object_name}.{property_name}. Should be: {value}")
+                        f"Invalid value for: {object_name}.{property_name}"
+                        f". Should be: {value}")
                     invalid.append((object_name, property_name))
 
         return invalid

From ce80ca2397c7ed9b609f0358a9c0595289a8e260 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Tue, 31 Oct 2023 16:10:22 +0800
Subject: [PATCH 08/15] debug message

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

diff --git a/openpype/hosts/max/plugins/publish/validate_attributes.py b/openpype/hosts/max/plugins/publish/validate_attributes.py
index 5697237c95..00b9d34c06 100644
--- a/openpype/hosts/max/plugins/publish/validate_attributes.py
+++ b/openpype/hosts/max/plugins/publish/validate_attributes.py
@@ -72,6 +72,8 @@ class ValidateAttributes(OptionalPyblishPluginMixin,
             if not rt.Execute(f"isValidValue {object_name}"):
                 # Skip checking if the node does not
                 # exist in MaxWrapper Class
+                cls.log.debug(f"Unable to find '{object_name}'."
+                              f" Skipping validation of attributes")
                 continue
 
             for property_name, value in required_properties.items():

From 3218b8064cdd00f7efab87bab935e1c8cb130c16 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Tue, 31 Oct 2023 16:11:57 +0800
Subject: [PATCH 09/15] hound & docstring tweak

---
 openpype/hosts/max/plugins/publish/validate_attributes.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/max/plugins/publish/validate_attributes.py b/openpype/hosts/max/plugins/publish/validate_attributes.py
index 00b9d34c06..75d3f05d07 100644
--- a/openpype/hosts/max/plugins/publish/validate_attributes.py
+++ b/openpype/hosts/max/plugins/publish/validate_attributes.py
@@ -46,7 +46,7 @@ class ValidateAttributes(OptionalPyblishPluginMixin,
             "separateAovFiles" : True
         }
         "renderers.production":{
-            "PrimaryGIEngine": "#RS_GIENGINE_BRUTE_FORCE",
+            "PrimaryGIEngine": "#RS_GIENGINE_BRUTE_FORCE"
         }
         ....
     }
@@ -79,7 +79,8 @@ class ValidateAttributes(OptionalPyblishPluginMixin,
             for property_name, value in required_properties.items():
                 if not has_property(object_name, property_name):
                     cls.log.error(
-                        f"Non-existing property: {object_name}.{property_name}")
+                        "Non-existing property: "
+                        f"{object_name}.{property_name}")
                     invalid.append((object_name, property_name))
 
                 if not is_matching_value(object_name, property_name, value):

From 009cda005227158561d898aa59c28ca16ae4166c Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Tue, 31 Oct 2023 17:18:06 +0800
Subject: [PATCH 10/15] update the debug message with dots

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

diff --git a/openpype/hosts/max/plugins/publish/validate_attributes.py b/openpype/hosts/max/plugins/publish/validate_attributes.py
index 75d3f05d07..172b65e955 100644
--- a/openpype/hosts/max/plugins/publish/validate_attributes.py
+++ b/openpype/hosts/max/plugins/publish/validate_attributes.py
@@ -73,7 +73,7 @@ class ValidateAttributes(OptionalPyblishPluginMixin,
                 # Skip checking if the node does not
                 # exist in MaxWrapper Class
                 cls.log.debug(f"Unable to find '{object_name}'."
-                              f" Skipping validation of attributes")
+                              " Skipping validation of attributes.")
                 continue
 
             for property_name, value in required_properties.items():
@@ -86,7 +86,7 @@ class ValidateAttributes(OptionalPyblishPluginMixin,
                 if not is_matching_value(object_name, property_name, value):
                     cls.log.error(
                         f"Invalid value for: {object_name}.{property_name}"
-                        f". Should be: {value}")
+                        f" Should be: {value}")
                     invalid.append((object_name, property_name))
 
         return invalid
@@ -105,7 +105,7 @@ class ValidateAttributes(OptionalPyblishPluginMixin,
                 "Required Attribute(s) have invalid value(s).\n\n"
                 f"{bullet_point_invalid_statement}\n\n"
                 "You can use repair action to fix them if they are not\n"
-                "unknown property value(s)"
+                "unknown property value(s)."
             )
             raise PublishValidationError(
                 report, title="Invalid Value(s) for Required Attribute(s)")

From ad0b941475c67196ad7e09beada2bd81b2d51a63 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Tue, 31 Oct 2023 17:28:42 +0800
Subject: [PATCH 11/15] lowercase invalid msg for the condition of not
 is_maching_value function

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

diff --git a/openpype/hosts/max/plugins/publish/validate_attributes.py b/openpype/hosts/max/plugins/publish/validate_attributes.py
index 172b65e955..0cd405aebd 100644
--- a/openpype/hosts/max/plugins/publish/validate_attributes.py
+++ b/openpype/hosts/max/plugins/publish/validate_attributes.py
@@ -86,7 +86,7 @@ class ValidateAttributes(OptionalPyblishPluginMixin,
                 if not is_matching_value(object_name, property_name, value):
                     cls.log.error(
                         f"Invalid value for: {object_name}.{property_name}"
-                        f" Should be: {value}")
+                        f" should be: {value}")
                     invalid.append((object_name, property_name))
 
         return invalid

From e39689ba8e1a7a9de754ecf5becb487d5fda7665 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Tue, 31 Oct 2023 20:28:15 +0800
Subject: [PATCH 12/15] add docs

---
 website/docs/artist_hosts_3dsmax.md           |  24 ++++++++++++++++++
 .../assets/3dsmax_validate_attributes.png     | Bin 0 -> 35154 bytes
 2 files changed, 24 insertions(+)
 create mode 100644 website/docs/assets/3dsmax_validate_attributes.png

diff --git a/website/docs/artist_hosts_3dsmax.md b/website/docs/artist_hosts_3dsmax.md
index fffab8ca5d..bc79094746 100644
--- a/website/docs/artist_hosts_3dsmax.md
+++ b/website/docs/artist_hosts_3dsmax.md
@@ -118,4 +118,28 @@ Current OpenPype integration (ver 3.15.0) supports only ```PointCache```,  ```Ca
 This part of documentation is still work in progress.
 :::
 
+## Validators
+
+Current Openpype integration supports different validators such as Frame Range and Attributes.
+Some validators are mandatory while some are optional and user can choose to enable them in the setting.
+
+**Validate Frame Range**: Optional Validator for checking Frame Range
+
+**Validate Attributes**: Optional Validator for checking if object properties' attributes are valid
+    in MaxWrapper Class.
+:::note
+    Users can write the properties' attributes they want to check in dict format in the setting
+    before validation.
+    E.g. ```renderers.current.separateAovFiles``` and ```renderers.current.PrimaryGIEngine```
+    User can put the attributes in the dict format below
+    ```
+    {
+        "renderer.current":{
+            "separateAovFiles" : True
+            "PrimaryGIEngine": "#RS_GIENGINE_BRUTE_FORCE"
+        }
+    }
+    ```
+    ![Validate Attribute Setting](assets/3dsmax_validate_attributes.png)
+:::
 ## ...to be added
diff --git a/website/docs/assets/3dsmax_validate_attributes.png b/website/docs/assets/3dsmax_validate_attributes.png
new file mode 100644
index 0000000000000000000000000000000000000000..5af82361887f47fda96607886ec10e15eb355df1
GIT binary patch
literal 35154
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

literal 0
HcmV?d00001


From 1795d501d995f037af9ad81d8731f14b67a7f19e Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Tue, 31 Oct 2023 20:29:34 +0800
Subject: [PATCH 13/15] add docs

---
 website/docs/artist_hosts_3dsmax.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/docs/artist_hosts_3dsmax.md b/website/docs/artist_hosts_3dsmax.md
index bc79094746..6f23a19103 100644
--- a/website/docs/artist_hosts_3dsmax.md
+++ b/website/docs/artist_hosts_3dsmax.md
@@ -129,7 +129,7 @@ Some validators are mandatory while some are optional and user can choose to ena
     in MaxWrapper Class.
 :::note
     Users can write the properties' attributes they want to check in dict format in the setting
-    before validation.
+    before validation. The attributes are then to be converted into Maxscript and do a check.
     E.g. ```renderers.current.separateAovFiles``` and ```renderers.current.PrimaryGIEngine```
     User can put the attributes in the dict format below
     ```

From cfd9f0f06c26c0d47340f9baf42239674e2cebc8 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Tue, 31 Oct 2023 20:32:28 +0800
Subject: [PATCH 14/15] edit docstring

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

diff --git a/openpype/hosts/max/plugins/publish/validate_attributes.py b/openpype/hosts/max/plugins/publish/validate_attributes.py
index 0cd405aebd..0632ee38f0 100644
--- a/openpype/hosts/max/plugins/publish/validate_attributes.py
+++ b/openpype/hosts/max/plugins/publish/validate_attributes.py
@@ -40,11 +40,11 @@ class ValidateAttributes(OptionalPyblishPluginMixin,
     with the nodes from MaxWrapper Class in 3ds max.
     E.g. "renderers.current.separateAovFiles",
          "renderers.production.PrimaryGIEngine"
-    Admin(s) need to put json below and enable this validator for a check:
+    Admin(s) need to put the dict below and enable this validator for a check:
     {
        "renderers.current":{
             "separateAovFiles" : True
-        }
+        },
         "renderers.production":{
             "PrimaryGIEngine": "#RS_GIENGINE_BRUTE_FORCE"
         }

From 8bf570ceef7823a2bf8615a30ac15dfc59c8eaf7 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Thu, 2 Nov 2023 12:24:25 +0800
Subject: [PATCH 15/15] up version for the max bundle

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

diff --git a/server_addon/max/server/version.py b/server_addon/max/server/version.py
index 3dc1f76bc6..485f44ac21 100644
--- a/server_addon/max/server/version.py
+++ b/server_addon/max/server/version.py
@@ -1 +1 @@
-__version__ = "0.1.0"
+__version__ = "0.1.1"