hooks: add hook for cloudpickle

Add hook for `cloudpickle` to ensure that `cloudpickle.cloudpickle_fast`
is collected when using `cloudpickle° v3.0.0 or later.

news/716.new.rst

@@ -0,0 +1,2 @@
+Add hook for ``cloudpickle`` to ensure that ``cloudpickle.cloudpickle_fast``
+is collected when using ``cloudpickle`` v3.0.0 or later.

requirements-test-libraries.txt

@@ -19,6 +19,7 @@ cassandra-driver==3.29.0
 cf-units==3.2.0; sys_platform != 'win32'
 cftime==1.6.3
 charset_normalizer==3.3.2
+cloudpickle==3.0.0
 cloudscraper==1.2.71
 # compliance-checker requires cf-units, so same constraints apply.
 compliance-checker==5.1.0; sys_platform != 'win32'

src/_pyinstaller_hooks_contrib/hooks/stdhooks/hook-cloudpickle.py

@@ -0,0 +1,18 @@
+# ------------------------------------------------------------------
+# Copyright (c) 2024 PyInstaller Development Team.
+#
+# This file is distributed under the terms of the GNU General Public
+# License (version 2.0 or later).
+#
+# The full license is available in LICENSE.GPL.txt, distributed with
+# this software.
+#
+# SPDX-License-Identifier: GPL-2.0-or-later
+# ------------------------------------------------------------------
+
+from PyInstaller.utils.hooks import is_module_satisfies
+
+# cloudpickle to 3.0.0 keeps `cloudpickle_fast` module around for backward compatibility with existing pickled data,
+# but does not import it directly anymore. Ensure it is collected nevertheless.
+if is_module_satisfies("cloudpickle >= 3.0.0"):
+    hiddenimports = ["cloudpickle.cloudpickle_fast"]

src/_pyinstaller_hooks_contrib/tests/test_libraries.py

@@ -1934,3 +1934,17 @@ def test_numba_cloudpickle_fast(pyi_builder):
         modname = "numba.cloudpickle.cloudpickle_fast"
         mod = importlib.import_module(modname)
     """)
+
+
+# Check that `cloudpickle.cloudpickle_fast` is collected even if it is not directly imported anywhere.
+@importorskip('cloudpickle')
+def test_cloudpickle_fast(pyi_builder):
+    pyi_builder.test_source("""
+        # Assume the application or its dependencies import cloudpickle somewhere.
+        import cloudpickle
+
+        # Simulate indirect import of `cloudpickle.cloudpickle_fast`that would happen during data unpickling.
+        import importlib
+        modname = "cloudpickle.cloudpickle_fast"
+        mod = importlib.import_module(modname)
+    """)