greenbone / python-gvm

        return self._send_xml_command(cmd)

    def modify_user(

        self,

        user_id: str = None,

        name: str = None,

        *,

        new_name: Optional[str] = None,

        comment: Optional[str] = None,

        password: Optional[str] = None,

        auth_source: Optional[UserAuthType] = None,

        role_ids: Optional[List[str]] = None,

        hosts: Optional[List[str]] = None,

        hosts_allow: Optional[bool] = False,

        ifaces: Optional[List[str]] = None,

        ifaces_allow: Optional[bool] = False,

        group_ids: Optional[List[str]] = None,

    ) -> Any:

        """Modifies an existing user. Most of the fields need to be supplied

        for changing a single field even if no change is wanted for those.

        Else empty values are inserted for the missing fields instead.

        Arguments:

            user_id: UUID of the user to be modified. Overrides name element

                argument.

            name: The name of the user to be modified. Either user_id or name

                must be passed.

            new_name: The new name for the user.

            comment: Comment on the user.

            password: The password for the user.

            auth_source: Source allowed for authentication for this user.

            roles_id: List of roles UUIDs for the user.

            hosts: User access rules: List of hosts.

            hosts_allow: Defines how the hosts list is to be interpreted.

                If False (default) the list is treated as a deny list.

                All hosts are allowed by default except those provided by

                the hosts parameter. If True the list is treated as a

                allow list. All hosts are denied by default except those

                provided by the hosts parameter.

            ifaces: User access rules: List of ifaces.

            ifaces_allow: Defines how the ifaces list is to be interpreted.

                If False (default) the list is treated as a deny list.

                All ifaces are allowed by default except those provided by

                the ifaces parameter. If True the list is treated as a

                allow list. All ifaces are denied by default except those

                provided by the ifaces parameter.

            group_ids: List of group UUIDs for the user.

        Returns:

            The response. See :py:meth:`send_command` for details.

        """

        if not user_id and not name:

            raise RequiredArgument(

                function=self.modify_user.__name__, argument='user_id or name'

            )

        cmd = XmlCommand("modify_user")

        if user_id:

            cmd.set_attribute("user_id", user_id)

        else:

            cmd.add_element("name", name)

        if new_name:

            cmd.add_element("new_name", new_name)

        if role_ids:

            for role in role_ids:

                cmd.add_element("role", attrs={"id": role})

        if hosts:

            cmd.add_element(

                "hosts",

                to_comma_list(hosts),

                attrs={"allow": to_bool(hosts_allow)},

            )

        if ifaces:

            cmd.add_element(

                "ifaces",

                to_comma_list(ifaces),

                attrs={"allow": to_bool(ifaces_allow)},

            )

        if comment:

            cmd.add_element("comment", comment)

        if password:

            cmd.add_element("password", password)

        if auth_source:

            _xmlauthsrc = cmd.add_element("sources")

            _xmlauthsrc.add_element("source", auth_source.value)

        if group_ids:

            _xmlgroups = cmd.add_element("groups")

            for group_id in group_ids:

                _xmlgroups.add_element("group", attrs={"id": group_id})

        return self._send_xml_command(cmd)

    def move_task(self, task_id: str, *, slave_id: Optional[str] = None) -> Any:

        """Move an existing task to another GMP slave scanner or the master

        return self._send_xml_command(cmd)

    def modify_user(

        self,

        user_id: str = None,

        *,

        name: Optional[str] = None,

        comment: Optional[str] = None,

        password: Optional[str] = None,

        auth_source: Optional[UserAuthType] = None,

        role_ids: Optional[List[str]] = None,

        hosts: Optional[List[str]] = None,

        hosts_allow: Optional[bool] = False,

        ifaces: Optional[List[str]] = None,

        ifaces_allow: Optional[bool] = False,

        group_ids: Optional[List[str]] = None,

    ) -> Any:

        """Modifies an existing user. Most of the fields need to be supplied

        for changing a single field even if no change is wanted for those.

        Else empty values are inserted for the missing fields instead.

        Arguments:

            user_id: UUID of the user to be modified.

            name: The new name for the user.

            comment: Comment on the user.

            password: The password for the user.

            auth_source: Source allowed for authentication for this user.

            roles_id: List of roles UUIDs for the user.

            hosts: User access rules: List of hosts.

            hosts_allow: Defines how the hosts list is to be interpreted.

                If False (default) the list is treated as a deny list.

                All hosts are allowed by default except those provided by

                the hosts parameter. If True the list is treated as a

                allow list. All hosts are denied by default except those

                provided by the hosts parameter.

            ifaces: User access rules: List of ifaces.

            ifaces_allow: Defines how the ifaces list is to be interpreted.

                If False (default) the list is treated as a deny list.

                All ifaces are allowed by default except those provided by

                the ifaces parameter. If True the list is treated as a

                allow list. All ifaces are denied by default except those

                provided by the ifaces parameter.

            group_ids: List of group UUIDs for the user.

        Returns:

            The response. See :py:meth:`send_command` for details.

        """

        if not user_id:

            raise RequiredArgument(

                function=self.modify_user.__name__, argument='user_id'

            )

        cmd = XmlCommand("modify_user")

        if user_id:

            cmd.set_attribute("user_id", user_id)

        if name:

            cmd.add_element("new_name", name)

        if role_ids:

            for role in role_ids:

                cmd.add_element("role", attrs={"id": role})

        if hosts:

            cmd.add_element(

                "hosts",

                to_comma_list(hosts),

                attrs={"allow": to_bool(hosts_allow)},

            )

        if ifaces:

            cmd.add_element(

                "ifaces",

                to_comma_list(ifaces),

                attrs={"allow": to_bool(ifaces_allow)},

            )

        if comment:

            cmd.add_element("comment", comment)

        if password:

            cmd.add_element("password", password)

        if auth_source:

            _xmlauthsrc = cmd.add_element("sources")

            _xmlauthsrc.add_element("source", auth_source.value)

        if group_ids:

            _xmlgroups = cmd.add_element("groups")

            for group_id in group_ids:

                _xmlgroups.add_element("group", attrs={"id": group_id})

        return self._send_xml_command(cmd)