UsersTab

UsersTab

Bases: BasePage

Класс для работы с вкладкой 'Пользователи'.

Предоставляет методы для взаимодействия с таблицей пользователей, модальными окнами добавления/редактирования и проверки состояния элементов.

Parameters:

Name	Type	Description	Default
page	Page	Экземпляр страницы Playwright.	required

Source code in pages\users_tab.py

class UsersTab(BasePage):
    """Класс для работы с вкладкой 'Пользователи'.

    Предоставляет методы для взаимодействия с таблицей пользователей,
    модальными окнами добавления/редактирования и проверки состояния элементов.

    Args:
        page (Page): Экземпляр страницы Playwright.
    """

    def __init__(self, page: Page) -> None:
        """Инициализация компонентов вкладки 'Пользователи'."""
        super().__init__(page)

        locator_button_1 = self.page.get_by_role("navigation").filter(
            has_text=re.compile("Пользователи")
        ).get_by_role("button").nth(0)
        locator_button_2 = self.page.get_by_role("navigation").filter(
            has_text=re.compile("Пользователи")
        ).get_by_role("button").nth(1)

        self.toolbar = ToolbarComponent(page, "Пользователи")
        self.toolbar.add_button(locator_button_1, "edit")
        self.toolbar.add_button(locator_button_1, "add_user")
        self.toolbar.add_button(locator_button_2, "close")

        self.users_table = TableComponent(page)
        self.modal_windows = {}
        self.success_alert = AlertComponent(page, "success")

    def add_modal_window(self, window_type: str, title: str) -> None:
        """Добавляет модальное окно в коллекцию окон.

        Args:
            window_type (str): Тип окна ('add_user' или 'edit_user')
            title (str): Заголовок окна (имя пользователя для редактирования)

        Raises:
            AssertionError: Если указан неподдерживаемый тип окна.
        """
        if window_type == "add_user":
            self.modal_windows["add_user"] = AddUserModalWindow(self.page) 
        elif window_type == "edit_user":
            self.modal_windows[title] = EditUserModalWindow(self.page, title) 
        else:
            assert False, "Unsupported modal window type"

    def get_modal_window(self, title: str) -> None:
        """Возвращает модальное окно по заголовку.

        Args:
            title (str): Заголовок окна

        Returns:
            ModalWindowComponent: Экземпляр модального окна

        Raises:
            AssertionError: Если окно не найдено.
        """
        modal_window = self.modal_windows.get(title)
        if modal_window is None:
            assert False, f"Modal window with title '{title}' not found"
        return modal_window

    def delete_modal_window(self, title: str) -> None:
        """Удаляет модальное окно из коллекции.

        Args:
            title (str): Заголовок окна

        Raises:
            AssertionError: Если окно не найдено.
        """
        if self.modal_windows.get(title) is None:
            assert False, f"Modal window with title '{title}' not found"
        self.modal_windows[title] = None

    def close_modal_window_by_toolbar_button(self, title: str) -> None:
        """Закрывает модальное окно через кнопку в тулбаре.

        Args:
            title (str): Заголовок окна
        """
        modal_window = self.get_modal_window(title)
        modal_window.close_window_by_toolbar_button()
        self.delete_modal_window(title)

    def close_modal_window(self, title: str) -> None:
        """Закрывает модальное окно через кнопку закрытия.

        Args:
            title (str): Заголовок окна
        """
        modal_window = self.get_modal_window(title)
        modal_window.close_window()
        self.delete_modal_window(title)

    def close_add_user_window_by_toolbar_button(self) -> None:
        """Закрывает окно добавления пользователя через кнопку в тулбаре."""
        self.close_modal_window_by_toolbar_button("add_user")

    def close_add_user_window(self) -> None:
        """Закрывает окно добавления пользователя."""
        self.close_modal_window("add_user")

    def close_edit_user_window_by_toolbar_button(self, title: str) -> None:
        """Закрывает окно редактирования пользователя через кнопку в тулбаре.

        Args:
            title (str): Имя пользователя (заголовок окна)
        """
        self.close_modal_window_by_toolbar_button(title)

    def close_edit_user_window(self, title: str) -> None:
        """Закрывает окно редактирования пользователя.

        Args:
            title (str): Имя пользователя (заголовок окна)
        """
        self.close_modal_window(title)

    def add_new_user(self, user_data: dict) -> None:
        """Добавляет нового пользователя.

        Args:
            user_data (dict): Данные пользователя

        Raises:
            AssertionError: Если не отображается сообщение об успешном добавлении.
        """
        self.get_modal_window("add_user").new_user(user_data)
        self.success_alert.check_presence(' Новый пользователь \n успешно добавлен! ')
        self.success_alert.check_absence(' Новый пользователь \n успешно добавлен! ')

    def delete_user(self, user_name: str) -> None:
        """Удаляет пользователя.

        Args:
            user_name (str): Имя пользователя

        Raises:
            AssertionError: Если не отображается сообщение об успешном удалении.
        """
        self.get_modal_window(user_name).delete_user()
        self.success_alert.check_presence('\nПользователь удалён\n')
        self.success_alert.check_absence('\nПользователь удалён\n')

    def edit_user(self, user_name: str, user_data: dict) -> None:
        """Редактирует данные пользователя.

        Args:
            user_name (str): Имя пользователя
            user_data (dict): Новые данные пользователя

        Raises:
            AssertionError: Если не отображается сообщение об успешном обновлении.
        """
        self.get_modal_window(user_name).edit_user(user_data)
        self.success_alert.check_presence('\nОбновление успешно\n')
        self.success_alert.check_absence('\nОбновление успешно\n')

    def reset_password(self, user_name: str) -> str:
        """Сбрасывает пароль пользователя.

        Args:
            user_name (str): Имя пользователя

        Returns:
            str: Новый пароль (если получен)
        """
        new_password = ""
        self.get_modal_window(user_name).reset_password()

        self.success_alert.check_presence("")
        alert_message = self.success_alert.get_text()
        if len(alert_message) > 0:
            new_password = re.findall(r'[\d]+', alert_message)[0]

        return new_password

    def find_user_in_table(self, name: str, role: str) -> int:
        """Ищет пользователя в таблице.

        Args:
            name (str): Имя пользователя
            role (str): Роль пользователя

        Returns:
            int: Индекс строки или -1 если не найден

        Raises:
            AssertionError: Если таблица пуста.
        """
        table_content = self.users_table.read(TableLocators.TABLE_WORK_AREA)
        if len(table_content) == 0:
            assert False, "The contents of the table are missing"

        del table_content[0]  # Удаляем заголовок

        for row_index, user_info in enumerate(table_content):
            if name in user_info and role in user_info:
                return row_index
        return -1

    def open_add_user_window(self) -> None:
        """Открывает окно добавления пользователя.

        Raises:
            AssertionError: Если кнопки недоступны или окно не открылось.
        """
        if self.toolbar.is_button_not_present("close"):
            self.toolbar.check_button_presence("edit")
            self.toolbar.click_button("edit")

        self.toolbar.check_button_presence("add_user")
        self.toolbar.click_button("add_user")
        self.add_modal_window("add_user", "")
        self.get_modal_window("add_user").check_by_window_title()

    def open_edit_user_page_by_index(self, row_index: int) -> tuple:
        """Открывает окно редактирования по индексу строки.

        Args:
            row_index (int): Индекс строки в таблице

        Returns:
            tuple: (имя пользователя, роль)

        Raises:
            AssertionError: Если таблица пуста или индекс вне диапазона.
        """
        tmp_dict = {"admin": "Администратор", "manager": "Контактное лицо", "operator": "Оператор"}
        table_content = self.users_table.read(TableLocators.TABLE_WORK_AREA)

        if len(table_content) == 0:
            assert False, "The contents of the table are missing" 

        del table_content[0]  # Удаляем заголовок

        if row_index >= len(table_content):
            assert False, "Row_index is out of range"

        user_name = table_content[row_index][0]
        for key, val in tmp_dict.items():
            if user_name == val:
                user_name = key  

        role = table_content[row_index][1]

        self.page.locator(TableLocators.TABLE_WORK_AREA).locator("//tbody/tr").nth(row_index).click()
        self.add_modal_window("edit_user", user_name)
        self.get_modal_window(user_name).check_by_window_title()

        return user_name, role

    def open_edit_user_page_by_user(self, user_name: str, role: str) -> None:
        """Открывает окно редактирования по имени пользователя и роли.

        Args:
            user_name (str): Имя пользователя
            role (str): Роль пользователя

        Raises:
            AssertionError: Если пользователь не найден.
        """
        row_index = self.find_user_in_table(user_name, role)  
        if row_index == -1:
            assert False, f"User with name {user_name} and role {role} has not been found"

        self.page.locator(TableLocators.TABLE_WORK_AREA).locator("//tbody/tr").nth(row_index).click()
        self.add_modal_window("edit_user", user_name)
        self.get_modal_window(user_name).check_by_window_title()

    def check_users_table_content(self, verify: bool = False) -> None:
        """Проверяет содержимое таблицы пользователей.

        Args:
            verify (bool, optional): Проверять соответствие данных из БД. По умолчанию False.

        Raises:
            AssertionError: Если таблица пуста или заголовки не соответствуют.
        """
        expected_headers = ['Имя пользователя', 'Роль', 'E-mail', 'Номер для СМС']
        table_content = self.users_table.read(TableLocators.TABLE_WORK_AREA)

        if len(table_content) == 0:
            assert False, "The contents of the table are missing"

        actual_headers = table_content[0]
        self.check_equals(
            actual_headers, 
            expected_headers,
            f"Expected table headers {expected_headers} are not equal {actual_headers}"
        )

        if len(table_content) == 1:
            assert False, "Table body is missing"

        if verify:
            self.verify_users_table_content(table_content)

    def check_add_user_window_content(self) -> None:
        """Проверяет содержимое окна добавления пользователя."""
        self.get_modal_window("add_user").check_content()

    def check_edit_user_window_content(self, user_name: str, role: str) -> None:
        """Проверяет содержимое окна редактирования пользователя.

        Args:
            user_name (str): Имя пользователя
            role (str): Роль пользователя
        """
        edit_user_window = self.get_modal_window(user_name) 
        edit_user_window.check_content(user_name, role)

    def should_be_toolbar(self) -> None:
        """Проверяет наличие тулбара.

        Raises:
            AssertionError: Если тулбар или кнопка редактирования отсутствуют.
        """
        self.toolbar.check_presence("Toolbar is missing")
        self.toolbar.check_button_presence("edit")

    def should_be_toolbar_buttons(self) -> None:
        """Проверяет наличие и функциональность кнопок тулбара.

        Raises:
            AssertionError: Если кнопки недоступны или имеют некорректные подсказки.
        """
        self.toolbar.check_button_presence("edit")       
        self.toolbar.check_button_tooltip("edit", "Редактировать")

        self.toolbar.get_button_by_name("edit").click()
        self.toolbar.check_button_presence("add_user")
        self.toolbar.check_button_presence("close")        
        self.toolbar.check_button_tooltip("add_user", "Добавить")
        self.toolbar.check_button_tooltip("close", "Закрыть")

        self.toolbar.get_button_by_name("close").click()
        self.toolbar.check_button_presence("edit")

    def should_be_users_table(self) -> None:
        """Проверяет наличие таблицы пользователей.

        Raises:
            AssertionError: Если таблица отсутствует.
        """
        self.users_table.check_presence(
            TableLocators.TABLE_WORK_AREA, 
            "Users table is missing"
        )

    def should_be_user_in_table(self, name: str, role: str) -> None:
        """Проверяет наличие пользователя в таблице.

        Args:
            name (str): Имя пользователя
            role (str): Роль пользователя

        Raises:
            AssertionError: Если пользователь не найден.
        """
        found = self.find_user_in_table(name, role)    
        if found == -1:
            assert False, f"User with name {name} and role {role} has not been found"

    def should_not_be_user_in_table(self, name: str, role: str) -> None:
        """Проверяет отсутствие пользователя в таблице.

        Args:
            name (str): Имя пользователя
            role (str): Роль пользователя

        Raises:
            AssertionError: Если пользователь найден.
        """
        found = self.find_user_in_table(name, role)    
        if found != -1:
            assert False, f"User with name {name} and role {role} has been found"

    def verify_users_table_content(self, users_table: list) -> None:
        """Сверяет данные таблицы с данными из БД.

        Args:
            users_table (list): Данные из таблицы на странице

        Raises:
            AssertionError: Если данные не соответствуют.
        """
        expected_users_list = []
        tmp_dict = {"admin": "Администратор", "manager": "Контактное лицо", "operator": "Оператор"}

        query = {
            "id": ["/catalogs/user"], 
            "data": {
                "namePath": True, 
                "children": {"flatten": True}
            }
        }

        response = self.send_post_api_request("e-cmdb/api/query", query)
        response_body = self.get_response_body(response)

        for item in response_body[0]["children"]:
            user_info = []
            user_name = item["name"]

            if user_name in tmp_dict.keys():
                item["name"] = tmp_dict[user_name]
            user_info.append(item["name"])

            if item["role"] is not None:
                role = item["role"]
                if role in roles_dict.keys():
                    item["role"] = roles_dict[role]
                user_info.append(item["role"])
            else:
                user_info.append("")

            if item["email"] is not None:
                user_info.append(item["email"])
            else:
                user_info.append("")

            if item["sms_phone"] is not None:
                user_info.append(item["sms_phone"])
            else:
                user_info.append("")

            expected_users_list.append(user_info)

        del users_table[0]  # Удаляем заголовок

        self.check_lists_equals(
            users_table, 
            expected_users_list,
            "Actual users list is not equal expected users list on base db"
        )

__init__(page)

Инициализация компонентов вкладки 'Пользователи'.

Source code in pages\users_tab.py

def __init__(self, page: Page) -> None:
    """Инициализация компонентов вкладки 'Пользователи'."""
    super().__init__(page)

    locator_button_1 = self.page.get_by_role("navigation").filter(
        has_text=re.compile("Пользователи")
    ).get_by_role("button").nth(0)
    locator_button_2 = self.page.get_by_role("navigation").filter(
        has_text=re.compile("Пользователи")
    ).get_by_role("button").nth(1)

    self.toolbar = ToolbarComponent(page, "Пользователи")
    self.toolbar.add_button(locator_button_1, "edit")
    self.toolbar.add_button(locator_button_1, "add_user")
    self.toolbar.add_button(locator_button_2, "close")

    self.users_table = TableComponent(page)
    self.modal_windows = {}
    self.success_alert = AlertComponent(page, "success")

add_modal_window(window_type, title)

Добавляет модальное окно в коллекцию окон.

Parameters:

Name	Type	Description	Default
window_type	str	Тип окна ('add_user' или 'edit_user')	required
title	str	Заголовок окна (имя пользователя для редактирования)	required

Raises:

Type	Description
AssertionError	Если указан неподдерживаемый тип окна.

Source code in pages\users_tab.py

def add_modal_window(self, window_type: str, title: str) -> None:
    """Добавляет модальное окно в коллекцию окон.

    Args:
        window_type (str): Тип окна ('add_user' или 'edit_user')
        title (str): Заголовок окна (имя пользователя для редактирования)

    Raises:
        AssertionError: Если указан неподдерживаемый тип окна.
    """
    if window_type == "add_user":
        self.modal_windows["add_user"] = AddUserModalWindow(self.page) 
    elif window_type == "edit_user":
        self.modal_windows[title] = EditUserModalWindow(self.page, title) 
    else:
        assert False, "Unsupported modal window type"

add_new_user(user_data)

Добавляет нового пользователя.

Parameters:

Name	Type	Description	Default
user_data	dict	Данные пользователя	required

Raises:

Type	Description
AssertionError	Если не отображается сообщение об успешном добавлении.

Source code in pages\users_tab.py

def add_new_user(self, user_data: dict) -> None:
    """Добавляет нового пользователя.

    Args:
        user_data (dict): Данные пользователя

    Raises:
        AssertionError: Если не отображается сообщение об успешном добавлении.
    """
    self.get_modal_window("add_user").new_user(user_data)
    self.success_alert.check_presence(' Новый пользователь \n успешно добавлен! ')
    self.success_alert.check_absence(' Новый пользователь \n успешно добавлен! ')

check_add_user_window_content()

Проверяет содержимое окна добавления пользователя.

Source code in pages\users_tab.py

def check_add_user_window_content(self) -> None:
    """Проверяет содержимое окна добавления пользователя."""
    self.get_modal_window("add_user").check_content()

check_edit_user_window_content(user_name, role)

Проверяет содержимое окна редактирования пользователя.

Parameters:

Name	Type	Description	Default
user_name	str	Имя пользователя	required
role	str	Роль пользователя	required

Source code in pages\users_tab.py

def check_edit_user_window_content(self, user_name: str, role: str) -> None:
    """Проверяет содержимое окна редактирования пользователя.

    Args:
        user_name (str): Имя пользователя
        role (str): Роль пользователя
    """
    edit_user_window = self.get_modal_window(user_name) 
    edit_user_window.check_content(user_name, role)

check_users_table_content(verify=False)

Проверяет содержимое таблицы пользователей.

Parameters:

Name	Type	Description	Default
verify	bool	Проверять соответствие данных из БД. По умолчанию False.	False

Raises:

Type	Description
AssertionError	Если таблица пуста или заголовки не соответствуют.

Source code in pages\users_tab.py

def check_users_table_content(self, verify: bool = False) -> None:
    """Проверяет содержимое таблицы пользователей.

    Args:
        verify (bool, optional): Проверять соответствие данных из БД. По умолчанию False.

    Raises:
        AssertionError: Если таблица пуста или заголовки не соответствуют.
    """
    expected_headers = ['Имя пользователя', 'Роль', 'E-mail', 'Номер для СМС']
    table_content = self.users_table.read(TableLocators.TABLE_WORK_AREA)

    if len(table_content) == 0:
        assert False, "The contents of the table are missing"

    actual_headers = table_content[0]
    self.check_equals(
        actual_headers, 
        expected_headers,
        f"Expected table headers {expected_headers} are not equal {actual_headers}"
    )

    if len(table_content) == 1:
        assert False, "Table body is missing"

    if verify:
        self.verify_users_table_content(table_content)

close_add_user_window()

Закрывает окно добавления пользователя.

Source code in pages\users_tab.py

def close_add_user_window(self) -> None:
    """Закрывает окно добавления пользователя."""
    self.close_modal_window("add_user")

close_add_user_window_by_toolbar_button()

Закрывает окно добавления пользователя через кнопку в тулбаре.

Source code in pages\users_tab.py

def close_add_user_window_by_toolbar_button(self) -> None:
    """Закрывает окно добавления пользователя через кнопку в тулбаре."""
    self.close_modal_window_by_toolbar_button("add_user")

close_edit_user_window(title)

Закрывает окно редактирования пользователя.

Parameters:

Name	Type	Description	Default
title	str	Имя пользователя (заголовок окна)	required

Source code in pages\users_tab.py

def close_edit_user_window(self, title: str) -> None:
    """Закрывает окно редактирования пользователя.

    Args:
        title (str): Имя пользователя (заголовок окна)
    """
    self.close_modal_window(title)

close_edit_user_window_by_toolbar_button(title)

Закрывает окно редактирования пользователя через кнопку в тулбаре.

Parameters:

Name	Type	Description	Default
title	str	Имя пользователя (заголовок окна)	required

Source code in pages\users_tab.py

def close_edit_user_window_by_toolbar_button(self, title: str) -> None:
    """Закрывает окно редактирования пользователя через кнопку в тулбаре.

    Args:
        title (str): Имя пользователя (заголовок окна)
    """
    self.close_modal_window_by_toolbar_button(title)

close_modal_window(title)

Закрывает модальное окно через кнопку закрытия.

Parameters:

Name	Type	Description	Default
title	str	Заголовок окна	required

Source code in pages\users_tab.py

def close_modal_window(self, title: str) -> None:
    """Закрывает модальное окно через кнопку закрытия.

    Args:
        title (str): Заголовок окна
    """
    modal_window = self.get_modal_window(title)
    modal_window.close_window()
    self.delete_modal_window(title)

close_modal_window_by_toolbar_button(title)

Закрывает модальное окно через кнопку в тулбаре.

Parameters:

Name	Type	Description	Default
title	str	Заголовок окна	required

Source code in pages\users_tab.py

def close_modal_window_by_toolbar_button(self, title: str) -> None:
    """Закрывает модальное окно через кнопку в тулбаре.

    Args:
        title (str): Заголовок окна
    """
    modal_window = self.get_modal_window(title)
    modal_window.close_window_by_toolbar_button()
    self.delete_modal_window(title)

delete_modal_window(title)

Удаляет модальное окно из коллекции.

Parameters:

Name	Type	Description	Default
title	str	Заголовок окна	required

Raises:

Type	Description
AssertionError	Если окно не найдено.

Source code in pages\users_tab.py

def delete_modal_window(self, title: str) -> None:
    """Удаляет модальное окно из коллекции.

    Args:
        title (str): Заголовок окна

    Raises:
        AssertionError: Если окно не найдено.
    """
    if self.modal_windows.get(title) is None:
        assert False, f"Modal window with title '{title}' not found"
    self.modal_windows[title] = None

delete_user(user_name)

Удаляет пользователя.

Parameters:

Name	Type	Description	Default
user_name	str	Имя пользователя	required

Raises:

Type	Description
AssertionError	Если не отображается сообщение об успешном удалении.

Source code in pages\users_tab.py

def delete_user(self, user_name: str) -> None:
    """Удаляет пользователя.

    Args:
        user_name (str): Имя пользователя

    Raises:
        AssertionError: Если не отображается сообщение об успешном удалении.
    """
    self.get_modal_window(user_name).delete_user()
    self.success_alert.check_presence('\nПользователь удалён\n')
    self.success_alert.check_absence('\nПользователь удалён\n')

edit_user(user_name, user_data)

Редактирует данные пользователя.

Parameters:

Name	Type	Description	Default
user_name	str	Имя пользователя	required
user_data	dict	Новые данные пользователя	required

Raises:

Type	Description
AssertionError	Если не отображается сообщение об успешном обновлении.

Source code in pages\users_tab.py

def edit_user(self, user_name: str, user_data: dict) -> None:
    """Редактирует данные пользователя.

    Args:
        user_name (str): Имя пользователя
        user_data (dict): Новые данные пользователя

    Raises:
        AssertionError: Если не отображается сообщение об успешном обновлении.
    """
    self.get_modal_window(user_name).edit_user(user_data)
    self.success_alert.check_presence('\nОбновление успешно\n')
    self.success_alert.check_absence('\nОбновление успешно\n')

find_user_in_table(name, role)

Ищет пользователя в таблице.

Parameters:

Name	Type	Description	Default
name	str	Имя пользователя	required
role	str	Роль пользователя	required

Returns:

Name	Type	Description
int	int	Индекс строки или -1 если не найден

Raises:

Type	Description
AssertionError	Если таблица пуста.

Source code in pages\users_tab.py

def find_user_in_table(self, name: str, role: str) -> int:
    """Ищет пользователя в таблице.

    Args:
        name (str): Имя пользователя
        role (str): Роль пользователя

    Returns:
        int: Индекс строки или -1 если не найден

    Raises:
        AssertionError: Если таблица пуста.
    """
    table_content = self.users_table.read(TableLocators.TABLE_WORK_AREA)
    if len(table_content) == 0:
        assert False, "The contents of the table are missing"

    del table_content[0]  # Удаляем заголовок

    for row_index, user_info in enumerate(table_content):
        if name in user_info and role in user_info:
            return row_index
    return -1

get_modal_window(title)

Возвращает модальное окно по заголовку.

Parameters:

Name	Type	Description	Default
title	str	Заголовок окна	required

Returns:

Name	Type	Description
ModalWindowComponent	None	Экземпляр модального окна

Raises:

Type	Description
AssertionError	Если окно не найдено.

Source code in pages\users_tab.py

def get_modal_window(self, title: str) -> None:
    """Возвращает модальное окно по заголовку.

    Args:
        title (str): Заголовок окна

    Returns:
        ModalWindowComponent: Экземпляр модального окна

    Raises:
        AssertionError: Если окно не найдено.
    """
    modal_window = self.modal_windows.get(title)
    if modal_window is None:
        assert False, f"Modal window with title '{title}' not found"
    return modal_window

open_add_user_window()

Открывает окно добавления пользователя.

Raises:

Type	Description
AssertionError	Если кнопки недоступны или окно не открылось.

Source code in pages\users_tab.py

def open_add_user_window(self) -> None:
    """Открывает окно добавления пользователя.

    Raises:
        AssertionError: Если кнопки недоступны или окно не открылось.
    """
    if self.toolbar.is_button_not_present("close"):
        self.toolbar.check_button_presence("edit")
        self.toolbar.click_button("edit")

    self.toolbar.check_button_presence("add_user")
    self.toolbar.click_button("add_user")
    self.add_modal_window("add_user", "")
    self.get_modal_window("add_user").check_by_window_title()

open_edit_user_page_by_index(row_index)

Открывает окно редактирования по индексу строки.

Parameters:

Name	Type	Description	Default
row_index	int	Индекс строки в таблице	required

Returns:

Name	Type	Description
tuple	tuple	(имя пользователя, роль)

Raises:

Type	Description
AssertionError	Если таблица пуста или индекс вне диапазона.

Source code in pages\users_tab.py

def open_edit_user_page_by_index(self, row_index: int) -> tuple:
    """Открывает окно редактирования по индексу строки.

    Args:
        row_index (int): Индекс строки в таблице

    Returns:
        tuple: (имя пользователя, роль)

    Raises:
        AssertionError: Если таблица пуста или индекс вне диапазона.
    """
    tmp_dict = {"admin": "Администратор", "manager": "Контактное лицо", "operator": "Оператор"}
    table_content = self.users_table.read(TableLocators.TABLE_WORK_AREA)

    if len(table_content) == 0:
        assert False, "The contents of the table are missing" 

    del table_content[0]  # Удаляем заголовок

    if row_index >= len(table_content):
        assert False, "Row_index is out of range"

    user_name = table_content[row_index][0]
    for key, val in tmp_dict.items():
        if user_name == val:
            user_name = key  

    role = table_content[row_index][1]

    self.page.locator(TableLocators.TABLE_WORK_AREA).locator("//tbody/tr").nth(row_index).click()
    self.add_modal_window("edit_user", user_name)
    self.get_modal_window(user_name).check_by_window_title()

    return user_name, role

open_edit_user_page_by_user(user_name, role)

Открывает окно редактирования по имени пользователя и роли.

Parameters:

Name	Type	Description	Default
user_name	str	Имя пользователя	required
role	str	Роль пользователя	required

Raises:

Type	Description
AssertionError	Если пользователь не найден.

Source code in pages\users_tab.py

def open_edit_user_page_by_user(self, user_name: str, role: str) -> None:
    """Открывает окно редактирования по имени пользователя и роли.

    Args:
        user_name (str): Имя пользователя
        role (str): Роль пользователя

    Raises:
        AssertionError: Если пользователь не найден.
    """
    row_index = self.find_user_in_table(user_name, role)  
    if row_index == -1:
        assert False, f"User with name {user_name} and role {role} has not been found"

    self.page.locator(TableLocators.TABLE_WORK_AREA).locator("//tbody/tr").nth(row_index).click()
    self.add_modal_window("edit_user", user_name)
    self.get_modal_window(user_name).check_by_window_title()

reset_password(user_name)

Сбрасывает пароль пользователя.

Parameters:

Name	Type	Description	Default
user_name	str	Имя пользователя	required

Returns:

Name	Type	Description
str	str	Новый пароль (если получен)

Source code in pages\users_tab.py

def reset_password(self, user_name: str) -> str:
    """Сбрасывает пароль пользователя.

    Args:
        user_name (str): Имя пользователя

    Returns:
        str: Новый пароль (если получен)
    """
    new_password = ""
    self.get_modal_window(user_name).reset_password()

    self.success_alert.check_presence("")
    alert_message = self.success_alert.get_text()
    if len(alert_message) > 0:
        new_password = re.findall(r'[\d]+', alert_message)[0]

    return new_password

should_be_toolbar()

Проверяет наличие тулбара.

Raises:

Type	Description
AssertionError	Если тулбар или кнопка редактирования отсутствуют.

Source code in pages\users_tab.py

def should_be_toolbar(self) -> None:
    """Проверяет наличие тулбара.

    Raises:
        AssertionError: Если тулбар или кнопка редактирования отсутствуют.
    """
    self.toolbar.check_presence("Toolbar is missing")
    self.toolbar.check_button_presence("edit")

should_be_toolbar_buttons()

Проверяет наличие и функциональность кнопок тулбара.

Raises:

Type	Description
AssertionError	Если кнопки недоступны или имеют некорректные подсказки.

Source code in pages\users_tab.py

def should_be_toolbar_buttons(self) -> None:
    """Проверяет наличие и функциональность кнопок тулбара.

    Raises:
        AssertionError: Если кнопки недоступны или имеют некорректные подсказки.
    """
    self.toolbar.check_button_presence("edit")       
    self.toolbar.check_button_tooltip("edit", "Редактировать")

    self.toolbar.get_button_by_name("edit").click()
    self.toolbar.check_button_presence("add_user")
    self.toolbar.check_button_presence("close")        
    self.toolbar.check_button_tooltip("add_user", "Добавить")
    self.toolbar.check_button_tooltip("close", "Закрыть")

    self.toolbar.get_button_by_name("close").click()
    self.toolbar.check_button_presence("edit")

should_be_user_in_table(name, role)

Проверяет наличие пользователя в таблице.

Parameters:

Name	Type	Description	Default
name	str	Имя пользователя	required
role	str	Роль пользователя	required

Raises:

Type	Description
AssertionError	Если пользователь не найден.

Source code in pages\users_tab.py

def should_be_user_in_table(self, name: str, role: str) -> None:
    """Проверяет наличие пользователя в таблице.

    Args:
        name (str): Имя пользователя
        role (str): Роль пользователя

    Raises:
        AssertionError: Если пользователь не найден.
    """
    found = self.find_user_in_table(name, role)    
    if found == -1:
        assert False, f"User with name {name} and role {role} has not been found"

should_be_users_table()

Проверяет наличие таблицы пользователей.

Raises:

Type	Description
AssertionError	Если таблица отсутствует.

Source code in pages\users_tab.py

def should_be_users_table(self) -> None:
    """Проверяет наличие таблицы пользователей.

    Raises:
        AssertionError: Если таблица отсутствует.
    """
    self.users_table.check_presence(
        TableLocators.TABLE_WORK_AREA, 
        "Users table is missing"
    )

should_not_be_user_in_table(name, role)

Проверяет отсутствие пользователя в таблице.

Parameters:

Name	Type	Description	Default
name	str	Имя пользователя	required
role	str	Роль пользователя	required

Raises:

Type	Description
AssertionError	Если пользователь найден.

Source code in pages\users_tab.py

def should_not_be_user_in_table(self, name: str, role: str) -> None:
    """Проверяет отсутствие пользователя в таблице.

    Args:
        name (str): Имя пользователя
        role (str): Роль пользователя

    Raises:
        AssertionError: Если пользователь найден.
    """
    found = self.find_user_in_table(name, role)    
    if found != -1:
        assert False, f"User with name {name} and role {role} has been found"

verify_users_table_content(users_table)

Сверяет данные таблицы с данными из БД.

Parameters:

Name	Type	Description	Default
users_table	list	Данные из таблицы на странице	required

Raises:

Type	Description
AssertionError	Если данные не соответствуют.

Source code in pages\users_tab.py

def verify_users_table_content(self, users_table: list) -> None:
    """Сверяет данные таблицы с данными из БД.

    Args:
        users_table (list): Данные из таблицы на странице

    Raises:
        AssertionError: Если данные не соответствуют.
    """
    expected_users_list = []
    tmp_dict = {"admin": "Администратор", "manager": "Контактное лицо", "operator": "Оператор"}

    query = {
        "id": ["/catalogs/user"], 
        "data": {
            "namePath": True, 
            "children": {"flatten": True}
        }
    }

    response = self.send_post_api_request("e-cmdb/api/query", query)
    response_body = self.get_response_body(response)

    for item in response_body[0]["children"]:
        user_info = []
        user_name = item["name"]

        if user_name in tmp_dict.keys():
            item["name"] = tmp_dict[user_name]
        user_info.append(item["name"])

        if item["role"] is not None:
            role = item["role"]
            if role in roles_dict.keys():
                item["role"] = roles_dict[role]
            user_info.append(item["role"])
        else:
            user_info.append("")

        if item["email"] is not None:
            user_info.append(item["email"])
        else:
            user_info.append("")

        if item["sms_phone"] is not None:
            user_info.append(item["sms_phone"])
        else:
            user_info.append("")

        expected_users_list.append(user_info)

    del users_table[0]  # Удаляем заголовок

    self.check_lists_equals(
        users_table, 
        expected_users_list,
        "Actual users list is not equal expected users list on base db"
    )