"""``shell.*`` — auto-generated ISPConfig remote-API wrappers.

This module is produced by ``tools/gen_methods.py`` from the
``tools/method_inventory.json`` catalog. Hand-edits go below the
``---- HAND-EDIT ONLY BELOW ----`` marker — they survive regeneration.
"""

from __future__ import annotations

from typing import TYPE_CHECKING, Any

if TYPE_CHECKING:
    from .client import ISPConfigClient


class ShellModule:
    """Auto-generated module: Shell.

    All methods below the ``AUTO-GENERATED START`` marker are produced
    by ``tools/gen_methods.py``. Do not hand-edit that block — changes
    will be overwritten on the next regeneration. Add helpers and
    overrides below the ``HAND-EDIT ONLY BELOW`` marker instead.
    """

    def __init__(self, client: ISPConfigClient) -> None:
        self._c = client

    # ---- AUTO-GENERATED START (do not hand-edit above this line) ----
    # Regenerate with: python3 tools/gen_methods.py

    def sites_shell_user_add(self, client_id: Any, params: Any) -> Any:
        """
        Auto-generated wrapper for ``sites_shell_user_add``.

        Source: ``sites.inc.php`` line 368.
        PHP signature: ``sites_shell_user_add($session_id, $client_id, $params)``.

        AUTO-GENERATED - param shapes may need verification against your
        ISPConfig version. File issues at Sulkta-Coop/ispconfig-py.
        """
        return self._c._call("sites_shell_user_add", ("client_id", client_id), ("params", params))

    def sites_shell_user_delete(self, primary_id: Any) -> Any:
        """
        Auto-generated wrapper for ``sites_shell_user_delete``.

        Source: ``sites.inc.php`` line 389.
        PHP signature: ``sites_shell_user_delete($session_id, $primary_id)``.

        AUTO-GENERATED - param shapes may need verification against your
        ISPConfig version. File issues at Sulkta-Coop/ispconfig-py.
        """
        return self._c._call("sites_shell_user_delete", ("primary_id", primary_id))

    def sites_shell_user_get(self, primary_id: Any) -> Any:
        """
        Auto-generated wrapper for ``sites_shell_user_get``.

        Source: ``sites.inc.php`` line 354.
        PHP signature: ``sites_shell_user_get($session_id, $primary_id)``.

        AUTO-GENERATED - param shapes may need verification against your
        ISPConfig version. File issues at Sulkta-Coop/ispconfig-py.
        """
        return self._c._call("sites_shell_user_get", ("primary_id", primary_id))

    def sites_shell_user_update(self, client_id: Any, primary_id: Any, params: Any) -> Any:
        """
        Auto-generated wrapper for ``sites_shell_user_update``.

        Source: ``sites.inc.php`` line 378.
        PHP signature: ``sites_shell_user_update($session_id, $client_id, $primary_id, $params)``.

        AUTO-GENERATED - param shapes may need verification against your
        ISPConfig version. File issues at Sulkta-Coop/ispconfig-py.
        """
        return self._c._call(
            "sites_shell_user_update",
            ("client_id", client_id),
            ("primary_id", primary_id),
            ("params", params),
        )

    # ---- AUTO-GENERATED END ----

    # ---- HAND-EDIT ONLY BELOW ----