* [apiclient] reorganize stub files

apiclient/harvester_api/api.pyi

@@ -1,13 +1,11 @@
-from typing import Type, TypeVar, TypeAlias, Optional, NoReturn, Iterable, ClassVar
+from typing import Type, TypeVar, TypeAlias, Optional, NoReturn, Iterable, ClassVar, Tuple
 
 from packaging import version
 from requests import Session
 
-from .managers import (
-    HostManager, KeypairManager, ImageManager, SettingManager,
-    NetworkManager, VolumeManager, TemplateManager, SupportBundlemanager,
-    ClusterNetworkManager, VirtualMachineManager, BackupManager
-)
+from . import managers
+from .managers.base import DEFAULT_NAMESPACE
+
 
 API_T = TypeVar('API_T', bound='HarvesterAPI')
 Version: TypeAlias = version._BaseVersion
@@ -21,17 +19,25 @@ class HarvesterAPI:
 
     session: Session
     endpoint: Url
-    hosts: Type[HostManager]
-    keypairs: Type[KeypairManager]
-    images: Type[ImageManager]
-    networks: Type[NetworkManager]
-    volumes: Type[VolumeManager]
-    templates: Type[TemplateManager]
-    supportbundle: Type[SupportBundlemanager]
-    settings: Type[SettingManager]
-    clusternetworks: Type[ClusterNetworkManager]
-    vms: Type[VirtualMachineManager]
-    backups: Type[BackupManager]
+    hosts: managers.HostManager
+    keypairs: managers.KeypairManager
+    images: managers.ImageManager
+    networks: managers.NetworkManager
+    volumes: managers.VolumeManager
+    templates: managers.TemplateManager
+    supportbundle: managers.SupportBundleManager
+    settings: managers.SettingManager
+    clusternetworks: managers.ClusterNetworkManager
+    vms: managers.VirtualMachineManager
+    backups: managers.BackupManager
+    vm_snapshots: managers.VirtualMachineSnapshotManager
+    scs: managers.StorageClassManager
+
+    versions: managers.VersionManager
+    upgrades: managers.UpgradeManager
+    lhreplicas: managers.LonghornReplicaManager
+    lhvolumes: managers.LonghornVolumeManager
+    lhbackupvolumes: managers.LonghornBackupVolumeManager
 
     @classmethod
     def login(
@@ -56,6 +62,9 @@ class HarvesterAPI:
     def cluster_version(self) -> Version:
         """
         """
+    def load_managers(self, target_version: str = "") -> NoReturn:
+        """
+        """
     def get_url(self,
                 path: str) -> Url:
         """
@@ -74,3 +83,14 @@ class HarvesterAPI:
     def generate_kubeconfig(self) -> str:
         """
         """
+    def get_pods(self, name: str = "", namespace: str = DEFAULT_NAMESPACE) -> Tuple[int, dict]:
+        """
+        """
+    def get_apps_catalog(
+        self, name: str = "", namespace: str = DEFAULT_NAMESPACE
+    ) -> Tuple[int, dict]:
+        """
+        """
+    def get_crds(self, name: str = "") -> Tuple[int, dict]:
+        """
+        """

apiclient/harvester_api/managers/__init__.py

@@ -1,3 +1,4 @@
+from .base import DEFAULT_NAMESPACE
 from .hosts import HostManager
 from .images import ImageManager
 from .volumes import VolumeManager
@@ -12,8 +13,11 @@
 from .volumesnapshots import VolumeSnapshotManager
 from .virtualmachines import VirtualMachineManager
 # Not available in dashboard
-from .internals import VersionManager, UpgradeManager
-from .longhorns import LonghornReplicaManager, LonghornVolumeManager, LonghornBackupVolumeManager
+from .internals import VersionManager, UpgradeManager, DEFAULT_HARVESTER_NAMESPACE
+from .longhorns import (
+    LonghornReplicaManager, LonghornVolumeManager, LonghornBackupVolumeManager,
+    DEFAULT_LONGHORN_NAMESPACE
+)
 
 __all__ = [
  "HostManager",
@@ -31,4 +35,7 @@
  "BackupManager", "VirtualMachineSnapshotManager",
  "VersionManager", "UpgradeManager",
  "LonghornReplicaManager", "LonghornVolumeManager", "LonghornBackupVolumeManager",
+ "DEFAULT_HARVESTER_NAMESPACE",
+ "DEFAULT_NAMESPACE",
+ "DEFAULT_LONGHORN_NAMESPACE"
 ]

apiclient/harvester_api/managers/backups.pyi

@@ -0,0 +1,45 @@
+from typing import ClassVar, Optional, Callable, Type
+
+from requests.models import Response
+
+from harvester_api.models.backups import RestoreSpec
+from .base import BaseManager
+
+
+class BackupManager(BaseManager):
+    BACKUP_fmt: ClassVar[str]
+    RESTORE_fmt: ClassVar[str]
+    RestoreSpec: Type[RestoreSpec]
+
+    def get(
+        self,
+        name: str = ...,
+        namespace: str = ...,
+        *,
+        raw: Optional[bool] = ...,
+        **kwargs
+    ) -> dict | Response:
+        """
+        """
+    def create(
+        self,
+        name: str,
+        restore_spec: Type[RestoreSpec],
+        namespace: str = ...,
+        *,
+        raw: Optional[bool] = ...,
+        **kwargs
+    ) -> dict | Response:
+        """
+        """
+    def delete(
+        self,
+        name: str,
+        namespace: str = ...,
+        *,
+        raw: Optional[bool] = ...,
+        **kwargs
+    ) -> dict | Response:
+        """
+        """
+    restore: Callable

apiclient/harvester_api/managers/base.pyi

@@ -0,0 +1,31 @@
+from __future__ import annotations
+from typing import Final, NoReturn, ClassVar, Type
+
+from .api import HarvesterAPI
+
+DEFAULT_NAMESPACE: Final[str]
+
+
+def merge_dict(src: dict, dest: dict) -> dict:
+    """
+    """
+
+
+class BaseManager:
+    support_to: ClassVar[str]
+
+    @classmethod
+    def is_support(cls, target_version: str) -> bool:
+        """
+        """
+    @classmethod
+    def for_version(cls, version: str) -> Type[BaseManager]:
+        """
+        """
+    def __init__(self, api: HarvesterAPI) -> NoReturn:
+        """
+        """
+    @property
+    def api(self) -> HarvesterAPI:
+        """
+        """

apiclient/harvester_api/managers/clusternetworks.pyi

@@ -0,0 +1,110 @@
+from typing import ClassVar, Optional
+from collections.abc import Mapping
+
+from requests.models import Response
+
+from .base import BaseManager
+
+
+class ClusterNetworkManager(BaseManager):
+    PATH_fmt: ClassVar[str]
+    CONFIG_fmt: ClassVar[str]
+
+    def create_data(
+        self,
+        name: str,
+        description: str = ...,
+        labels: Optional[dict] = ...,
+        annotations: Optional[dict] = ...
+    ) -> dict:
+        """
+        """
+    def create_config_data(
+        self,
+        name: str,
+        clusternetwork: str,
+        *nics: str,
+        bond_mode: Optional[str] = ...,
+        hostname: Optional[str] = ...,
+        miimon: Optional[int] = ...,
+        mtu: Optional[int] = ...
+    ) -> dict:
+        """
+        """
+    def get(
+        self,
+        name: str = ...,
+        raw: Optional[bool] = ...
+    ) -> dict | Response:
+        """
+        """
+    def create(
+        self,
+        name: str,
+        description: str = ...,
+        labels: Optional[dict] = ...,
+        annotations: Optional[dict] = ...,
+        *,
+        raw: Optional[bool] = ...
+    ) -> dict | Response:
+        """
+        """
+    def update(
+        self,
+        name: str,
+        data: Mapping,
+        *,
+        raw: Optional[bool] = ...,
+        as_json: Optional[bool] = ...,
+        **kwargs
+    ) -> dict | Response:
+        """
+        """
+    def delete(
+        self,
+        name: str,
+        *,
+        raw: Optional[bool] = ...
+    ) -> dict | Response:
+        """
+        """
+    def get_config(
+        self,
+        name: str = ...,
+        *,
+        raw: Optional[bool] = ...
+    ) -> dict | Response:
+        """
+        """
+    def create_config(
+        self,
+        name: str,
+        clusternetwork: str,
+        *nics: str,
+        bond_mode: Optional[str] = ...,
+        hostname: Optional[str] = ...,
+        miimon: Optional[int] = ...,
+        mtu: Optional[int] = ...,
+        raw: Optional[bool] = ...
+    ) -> dict | Response:
+        """
+        """
+    def update_config(
+        self,
+        name: str,
+        data: Mapping,
+        *,
+        raw: Optional[bool] = ...,
+        as_json: Optional[bool] = ...,
+        **kwargs
+    ) -> dict | Response:
+        """
+        """
+    def delete_config(
+        self,
+        name: str,
+        *,
+        raw: Optional[bool] = ...
+    ) -> dict | Response:
+        """
+        """

apiclient/harvester_api/managers/hosts.pyi

@@ -0,0 +1,57 @@
+from typing import ClassVar, Optional, NoReturn
+from collections.abc import Mapping
+
+from requests.models import Response
+
+from .base import BaseManager
+
+
+class HostManager(BaseManager):
+    PATH_fmt: ClassVar[str]
+    METRIC_fmt: ClassVar[str]
+
+    def get(
+        self,
+        name: str = ...,
+        *,
+        raw: Optional[bool] = ...
+    ) -> dict | Response:
+        """
+        """
+    def create(self, *args, **kwargs) -> NoReturn:
+        """
+        """
+    def update(
+        self,
+        name: str,
+        data: Mapping,
+        *,
+        raw: Optional[bool] = ...,
+        as_json: Optional[bool] = ...,
+        **kwargs
+    ) -> dict | Response:
+        """
+        """
+    def delete(
+        self,
+        name: str,
+        *,
+        raw: Optional[bool] = ...
+    ) -> dict | Response:
+        """
+        """
+    def get_metrics(
+        self,
+        name: str = ...,
+        *,
+        raw: Optional[bool] = ...
+    ) -> dict | Response:
+        """
+        """
+    def maintenance_mode(
+        self,
+        name: str,
+        enable: Optional[bool] = ...
+    ) -> dict:
+        """
+        """