chore: add note about private modules

plugins/module_utils/_base.py

@@ -1,7 +1,7 @@
 # Copyright: (c) 2019, Hetzner Cloud GmbH <info@hetzner-cloud.de>
 
-# Simplified BSD License (see licenses/simplified_bsd.txt or https://opensource.org/licenses/BSD-2-Clause)
-
+# Note that this module util is **PRIVATE** to the collection. It can have breaking changes at any time.
+# Do not use this from other collections or standalone plugins/modules!
 
 from __future__ import annotations
 

plugins/module_utils/_client.py

@@ -1,5 +1,8 @@
 # Copyright: (c) 2023, Hetzner Cloud GmbH <info@hetzner-cloud.de>
 
+# Note that this module util is **PRIVATE** to the collection. It can have breaking changes at any time.
+# Do not use this from other collections or standalone plugins/modules!
+
 from __future__ import annotations
 
 from contextlib import contextmanager

plugins/module_utils/_deprecation.py

@@ -1,3 +1,6 @@
+# Note that this module util is **PRIVATE** to the collection. It can have breaking changes at any time.
+# Do not use this from other collections or standalone plugins/modules!
+
 from __future__ import annotations
 
 import warnings

plugins/module_utils/_experimental.py

@@ -1,5 +1,8 @@
 # Copyright: (c) 2025, Hetzner Cloud GmbH <info@hetzner-cloud.de>
 
+# Note that this module util is **PRIVATE** to the collection. It can have breaking changes at any time.
+# Do not use this from other collections or standalone plugins/modules!
+
 from __future__ import annotations
 
 from ._base import AnsibleModule

plugins/module_utils/_floating_ip.py

@@ -1,3 +1,6 @@
+# Note that this module util is **PRIVATE** to the collection. It can have breaking changes at any time.
+# Do not use this from other collections or standalone plugins/modules!
+
 from __future__ import annotations
 
 from ._vendor.hcloud.floating_ips import (

plugins/module_utils/_ipaddress.py

@@ -1,3 +1,6 @@
+# Note that this module util is **PRIVATE** to the collection. It can have breaking changes at any time.
+# Do not use this from other collections or standalone plugins/modules!
+
 from __future__ import annotations
 
 from ipaddress import ip_interface

plugins/module_utils/_primary_ip.py

@@ -1,3 +1,6 @@
+# Note that this module util is **PRIVATE** to the collection. It can have breaking changes at any time.
+# Do not use this from other collections or standalone plugins/modules!
+
 from __future__ import annotations
 
 from ._vendor.hcloud.primary_ips import (

plugins/module_utils/_ssh.py

@@ -1,3 +1,6 @@
+# Note that this module util is **PRIVATE** to the collection. It can have breaking changes at any time.
+# Do not use this from other collections or standalone plugins/modules!
+
 from __future__ import annotations
 
 from base64 import b64decode

plugins/module_utils/_storage_box.py

@@ -1,3 +1,6 @@
+# Note that this module util is **PRIVATE** to the collection. It can have breaking changes at any time.
+# Do not use this from other collections or standalone plugins/modules!
+
 from __future__ import annotations
 
 from ._client import client_resource_not_found

plugins/module_utils/_storage_box_snapshot.py

@@ -1,3 +1,6 @@
+# Note that this module util is **PRIVATE** to the collection. It can have breaking changes at any time.
+# Do not use this from other collections or standalone plugins/modules!
+
 from __future__ import annotations
 
 from ._vendor.hcloud.storage_boxes import (

plugins/module_utils/_storage_box_subaccount.py

@@ -1,3 +1,6 @@
+# Note that this module util is **PRIVATE** to the collection. It can have breaking changes at any time.
+# Do not use this from other collections or standalone plugins/modules!
+
 from __future__ import annotations
 
 from ._vendor.hcloud.storage_boxes import (

plugins/module_utils/_vendor/__init__.py

@@ -0,0 +1,2 @@
+# Note that this module util is **PRIVATE** to the collection. It can have breaking changes at any time.
+# Do not use this from other collections or standalone plugins/modules!

plugins/module_utils/_version.py

@@ -1,3 +1,6 @@
+# Note that this module util is **PRIVATE** to the collection. It can have breaking changes at any time.
+# Do not use this from other collections or standalone plugins/modules!
+
 from __future__ import annotations
 
 version = "6.4.0"  # x-release-please-version