Simple 7993 deprecated module names

virl2_client/models/group.py

@@ -20,8 +20,8 @@
 
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Any
 import warnings
+from typing import TYPE_CHECKING, Any
 
 from ..utils import _deprecated_argument, get_url_from_template
 
@@ -165,9 +165,7 @@ def group_labs(self, group_id: str) -> list[str]:
         :returns: A list of labs associated with this group.
         """
         warnings.warn(
-            "'GroupManagement.group_labs()' is deprecated."
-            "Use '.associations' instead.",
-            DeprecationWarning,
+            "'GroupManagement.group_labs()' is deprecated.Use '.associations' instead.",
         )
         return [lab["id"] for lab in self.get_group(group_id)["labs"]]
 

virl2_client/models/groups.py

@@ -0,0 +1,27 @@
+#
+# This file is part of VIRL 2
+# Copyright (c) 2019-2025, Cisco Systems, Inc.
+# All rights reserved.
+#
+# Python bindings for the Cisco VIRL 2 Network Simulation Platform
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+import warnings
+
+from .group import *  # noqa
+
+warnings.warn(
+    "The module name 'virl2_client.models.groups' is deprecated."
+    "Use 'virl2_client.models.group' instead.",
+)

virl2_client/models/interface.py

@@ -268,7 +268,6 @@ def is_physical(self) -> bool:
         """
         warnings.warn(
             "'Interface.is_physical' is deprecated. Use '.physical' instead.",
-            DeprecationWarning,
         )
         return self.physical
 
@@ -324,7 +323,6 @@ def remove_on_server(self) -> None:
         """
         warnings.warn(
             "'Interface.remove_on_server()' is deprecated. Use '.remove()' instead.",
-            DeprecationWarning,
         )
         self._remove_on_server()
 
@@ -350,7 +348,6 @@ def peer_interfaces(self):
         warnings.warn(
             "'Interface.peer_interfaces()' is deprecated, "
             "use '.peer_interface' instead.",
-            DeprecationWarning,
         )
         return {self.peer_interface}
 
@@ -363,7 +360,6 @@ def peer_nodes(self):
         """
         warnings.warn(
             "'Interface.peer_nodes() is deprecated. Use '.peer_node' instead.",
-            DeprecationWarning,
         )
         return {self.peer_node}
 
@@ -376,7 +372,6 @@ def links(self):
         """
         warnings.warn(
             "'Interface.links()' is deprecated. Use '.link' instead.",
-            DeprecationWarning,
         )
         link = self.link
         if link is None:
@@ -392,7 +387,6 @@ def degree(self):
         """
         warnings.warn(
             "'Interface.degree()' is deprecated. Use '.connected' instead.",
-            DeprecationWarning,
         )
         return int(self.connected)
 
@@ -405,7 +399,6 @@ def is_connected(self):
         """
         warnings.warn(
             "'Interface.is_connected()' is deprecated. Use '.connected' instead.",
-            DeprecationWarning,
         )
         return self.connected
 

virl2_client/models/lab.py

@@ -498,7 +498,6 @@ def get_link_by_nodes(node1: Node, node2: Node) -> Link:
         warnings.warn(
             "'Lab.get_link_by_nodes()' is deprecated. "
             "Use 'Node.get_link_to()' or 'Node.get_links_to()' instead.",
-            DeprecationWarning,
         )
         if not (links := node1.get_links_to(node2)):
             raise LinkNotFound
@@ -520,7 +519,6 @@ def get_link_by_interfaces(iface1: Interface, iface2: Interface) -> Link | None:
         warnings.warn(
             "'Lab.get_link_by_interfaces()' is deprecated. "
             "Use 'Interface.get_link_to()' instead.",
-            DeprecationWarning,
         )
         if (link := iface1.link) is not None and iface2 in link.interfaces:
             return link
@@ -653,7 +651,6 @@ def add_node_local(self, *args, **kwargs):
             "'Lab.add_node_local()' is deprecated. You probably want Lab.create_node() "
             "instead. (If you really want to create a node locally only, "
             "use '._create_node_local()'.)",
-            DeprecationWarning,
         )
         return self._create_node_local(*args, **kwargs)
 
@@ -1353,7 +1350,6 @@ def sync(
                 "Lab.sync(): The argument 'with_node_configurations' is deprecated, "
                 "as it does the opposite of what is expected. "
                 "Use exclude_configurations instead.",
-                DeprecationWarning,
             )
             exclude_configurations = with_node_configurations
 
@@ -1433,7 +1429,6 @@ def _import_lab(self, topology: dict, created: bool = False) -> None:
                 warnings.warn(
                     "Labs created in older CML releases (schema version 0.0.5 or lower)"
                     " are deprecated. Use labs with schema version 0.1.0 or higher.",
-                    DeprecationWarning,
                 )
             self._title = topology["lab_title"]
             self._description = topology["lab_description"]
@@ -2116,7 +2111,6 @@ def groups(self) -> list[dict[str, str]]:
         """
         warnings.warn(
             "'Lab.groups' is deprecated. Use '.associations' instead.",
-            DeprecationWarning,
         )
         url = self._url_for("lab")
         return self._session.get(url).json()["groups"]
@@ -2137,7 +2131,6 @@ def update_lab_groups(
         warnings.warn(
             "'Lab.update_lab_groups()' is deprecated. Use '.update_associations()'"
             " instead.",
-            DeprecationWarning,
         )
         url = self._url_for("lab")
         data = {"groups": group_list}

virl2_client/models/licensing.py

@@ -128,7 +128,7 @@ def get_certificate(self) -> str | None:
         """
         if self._is_cert_deprecated:
             warnings.warn(
-                "'Licensing.get_certificate()' is deprecated.", DeprecationWarning
+                "'Licensing.get_certificate()' is deprecated.",
             )
             return None
         url = self._url_for("certificate")
@@ -148,7 +148,7 @@ def install_certificate(self, cert: str) -> bool:
         """
         if self._is_cert_deprecated:
             warnings.warn(
-                "'Licensing.install_certificate()' is deprecated.", DeprecationWarning
+                "'Licensing.install_certificate()' is deprecated.",
             )
             return False
         url = self._url_for("certificate")
@@ -166,7 +166,7 @@ def remove_certificate(self) -> bool:
         """
         if self._is_cert_deprecated:
             warnings.warn(
-                "'Licensing.remove_certificate()' is deprecated.", DeprecationWarning
+                "'Licensing.remove_certificate()' is deprecated.",
             )
             return False
         url = self._url_for("certificate")

virl2_client/models/link.py

@@ -227,7 +227,6 @@ def remove_on_server(self) -> None:
         """
         warnings.warn(
             "'Link.remove_on_server()' is deprecated. Use '.remove()' instead.",
-            DeprecationWarning,
         )
         self._remove_on_server()
 

virl2_client/models/node.py

@@ -462,7 +462,6 @@ def config(self) -> str | None:
         """
         warnings.warn(
             "'Node.config' is deprecated. Use '.configuration' instead.",
-            DeprecationWarning,
         )
         return self.configuration
 
@@ -477,7 +476,6 @@ def config(self, value: str) -> None:
         """
         warnings.warn(
             "'Node.config' is deprecated. Use '.configuration' instead.",
-            DeprecationWarning,
         )
         self.configuration = value
 
@@ -771,7 +769,6 @@ def remove_on_server(self) -> None:
         """
         warnings.warn(
             "'Node.remove_on_server()' is deprecated. Use '.remove()' instead.",
-            DeprecationWarning,
         )
         # To not change behavior of scripts, this will still remove on server only.
         self._remove_on_server()

virl2_client/models/node_image_definition.py

@@ -142,7 +142,6 @@ def upload_node_definition(
                 "'NodeImageDefinitions.upload_node_definition()': "
                 "The argument 'json' is deprecated as the content type "
                 "is determined from the provided 'body'.",
-                DeprecationWarning,
             )
             is_json = True
         url = self._url_for("node_defs")
@@ -170,7 +169,6 @@ def upload_image_definition(
                 "'NodeImageDefinitions.upload_image_definition()': "
                 "The argument 'json' is deprecated as the content type "
                 "is determined from the provided 'body'.",
-                DeprecationWarning,
             )
             is_json = True
         url = self._url_for("image_defs")

virl2_client/models/node_image_definitions.py

@@ -0,0 +1,27 @@
+#
+# This file is part of VIRL 2
+# Copyright (c) 2019-2025, Cisco Systems, Inc.
+# All rights reserved.
+#
+# Python bindings for the Cisco VIRL 2 Network Simulation Platform
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+import warnings
+
+from .node_image_definition import *  # noqa
+
+warnings.warn(
+    "The module name 'virl2_client.models.node_image_definitions' is deprecated."
+    "Use 'virl2_client.models.node_image_definition' instead.",
+)

virl2_client/models/resource_pools.py

@@ -0,0 +1,27 @@
+#
+# This file is part of VIRL 2
+# Copyright (c) 2019-2025, Cisco Systems, Inc.
+# All rights reserved.
+#
+# Python bindings for the Cisco VIRL 2 Network Simulation Platform
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+import warnings
+
+from .resource_pool import *  # noqa
+
+warnings.warn(
+    "The module name 'virl2_client.models.resource_pools' is deprecated."
+    "Use 'virl2_client.models.resource_pool' instead.",
+)

virl2_client/models/system.py

@@ -22,8 +22,8 @@
 
 import logging
 import time
-from typing import TYPE_CHECKING, Any
 import warnings
+from typing import TYPE_CHECKING, Any
 
 from virl2_client.exceptions import ControllerNotFound
 
@@ -482,7 +482,6 @@ def nodes(self) -> list[str]:
         warnings.warn(
             "'ComputeHost.nodes' is deprecated. Use 'ComputeHost.node_counts' or "
             "'ClientLibrary.get_diagnostics(DiagnosticsCategory.COMPUTES)' instead.",
-            DeprecationWarning,
         )
         self._system.sync_compute_hosts_if_outdated()
         return self._nodes

virl2_client/models/users.py

@@ -0,0 +1,27 @@
+#
+# This file is part of VIRL 2
+# Copyright (c) 2019-2025, Cisco Systems, Inc.
+# All rights reserved.
+#
+# Python bindings for the Cisco VIRL 2 Network Simulation Platform
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+import warnings
+
+from .user import *  # noqa
+
+warnings.warn(
+    "The module name 'virl2_client.models.users' is deprecated."
+    "Use 'virl2_client.models.user' instead.",
+)