SG-36372 Switch distutil.version to packaging.version (#105)

* Switch `distutil.version` to `packaging.version`

* Implement a sorting function

* Remove log

* Fix style issue

* Refactor import

* Update import preference

* Improve type safety

* Use import names

* Format

* Move imports to get logs

Author: carlos-villavicencio-adsk

python/tk_multi_launchapp/base_launcher.py

@@ -8,23 +8,22 @@
 # agreement to the Shotgun Pipeline Toolkit Source Code License. All rights
 # not expressly granted therein are reserved by Shotgun Software Inc.
 
+import contextlib
 import os
 import sys
-import contextlib
-
-if sys.version_info[0:2] >= (3, 10):
-    from setuptools._distutils.version import LooseVersion
-else:
-    from distutils.version import LooseVersion
 
 import sgtk
 import sgtk.util
 from sgtk import TankError
 from sgtk.platform.qt import QtCore, QtGui
 
-from .util import apply_version_to_setting, get_clean_version_string
-from .util import clear_dll_directory, restore_dll_directory
 from .prepare_apps import prepare_launch_for_engine
+from .util import (
+    apply_version_to_setting,
+    clear_dll_directory,
+    get_clean_version_string,
+    restore_dll_directory,
+)
 
 
 class BaseLauncher(object):
@@ -50,6 +49,28 @@ def __init__(self):
             else "mac" if sgtk.util.is_macos() else "windows"
         )
 
+        try:
+            from packaging import version
+
+            self.version_parse = version.parse
+        except ModuleNotFoundError:
+            try:
+                from distutils.version import LooseVersion
+
+                self.version_parse = LooseVersion
+            except ModuleNotFoundError:
+                try:
+                    from setuptools._distutils.version import LooseVersion
+
+                    self.version_parse = LooseVersion
+                except ModuleNotFoundError:
+                    # Fall back to string comparison
+                    self.version_parse = str
+                    self._tk_app.log_debug(
+                        "Modules packaging or distutils not found in the Python environment, "
+                        "falling back to string comparison."
+                    )
+
     def _register_launch_command(
         self,
         app_menu_name,
@@ -504,10 +525,13 @@ def _sort_versions(self, versions):
         except AttributeError:
             ctx_mgr = contextlib.nullcontext
         with ctx_mgr():
-            # Cast the incoming version strings as LooseVersion instances to sort using
-            # the LooseVersion.__cmp__ method.
-            sort_versions = [LooseVersion(version) for version in versions]
+            # Cast the incoming version strings to sort them
+            try:
+                sort_versions = [self.version_parse(v) for v in versions]
+            except Exception as e:
+                sort_versions = [get_clean_version_string(v) for v in versions]
+
             sort_versions.sort(reverse=True)
 
-        # Convert the LooseVersions back to strings on return.
-        return [str(version) for version in sort_versions]
+        # Convert the parsed versions back to strings on return.
+        return [str(v) for v in sort_versions]