# components_derived package

## Submodules

## components_derived.container_system_log_events module

Модуль контейнера для отображения событий системного журнала.

Содержит класс для работы с контейнером для отображения событий системного журнала через Playwright.

class SystemLogEventsContainer(page, locator)

  Базовые классы: `EventsContainerComponent`

  Компонент контейнера для отображения событий системного журнала.

  Предоставляет методы для взаимодействия с элементами контейнера для отображения событий системного журнала.

  Параметры:

    - page (Page)

    - locator (str | Locator)

  __init__(page, locator)

    Инициализирует компонент контейнера для отображения событий системного журнала.

    Параметры:

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

      - locator (str | Locator)

  check_content()

    Проверяет содержимое контейнера для отображения событий системного журнала.

    Тип результата:

      None

## components_derived.date_input_component module

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

Содержит класс для работы с компонентом задания даты и времени через Playwright.

class DateInput(page, locator)

  Базовые классы: `BaseComponent`

  Компонент задания даты и времени.

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

  Параметры:

    - page (Page)

    - locator (str | Locator)

  __init__(page, locator)

    Инициализирует компонент задания даты и времени.

    Параметры:

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

      - locator (str | Locator) – Локатор формы ввода даты и времени (строка или объект Locator)

  click_switch_mode_button()

    Нажатие на кнопку переключения режимов ввода (текстовый или календарь).

    Тип результата:

      None

  get_date_picker()

    Возвращает экземпляр компонента средства выбора даты.

    Тип результата:

      DatePickerComponent

  get_date_field_value()

    Возвращает текущее значение поля ввода даты.

    Тип результата:

      str

  get_time_field_value()

    Возвращает текущее значение поля ввода времени.

    Тип результата:

      str

  input_date(date)

    Ввод даты в формате дд.мм.гггг

    Параметры:

      date (str)

    Тип результата:

      None

  input_time(time)

    Ввод даты в формате чч:мм

    Параметры:

      time (str)

    Тип результата:

      None

  check_content(label)

    Проверка состава компонента ввода даты.

    Параметры:

      label (str)

    Тип результата:

      None

  check_switch_mode_button_visibility()

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

    Тип результата:

      None

  is_text_input_mode()

    Проверка текстового режима ввода.

    Тип результата:

      bool

## components_derived.interactive_dropdown_list module

Модуль interactive_dropdown_list_component содержит класс для работы с интерактивными выпадающими списками, позволяющими сделать выбор нескольких элементов.

Класс InteractiveDropdownList наследует базовый функционал BaseComponent и добавляет методы для взаимодействия с интерактивными выпадающими списками на странице.

class InteractiveDropdownList(page)

  Базовые классы: `BaseComponent`

  Класс для работы с выпадающими списками.

  Наследует функциональность BaseElement и добавляет специфичные методы для выбора и проверки элементов списка.

  Параметры:

    page (Page)

  __init__(page)

    Инициализирует компонент интерактивного выпадающего списка.

    Параметры:

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

    Тип результата:

      None

  get_checkbox_locator(text)

    Возвращает локатор чек-бокса для элемента списка с указанным текстом.

    Параметры:

      text (str) – Текст элемента для выбора.

    Тип результата:

      Locator

  deselect_item_with_text(text)

    Выбирает элемент списка по указанному тексту.

    Параметры:

      text (str) – Текст элемента для выбора.

    Тип результата:

      None

  select_item_with_text(text)

    Выбирает элемент списка по указанному тексту.

    Параметры:

      text (str) – Текст элемента для выбора.

    Тип результата:

      None

  get_selected_items(locator)

    Возвращает список отмеченных элементов.

    Параметры:

      locator (str | Locator)

    Тип результата:

      list[str]

## components_derived.modal_add_AD_user module

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

Класс AddUserModalWindow наследует базовый функционал ModalWindowComponent и реализует специфичные методы для работы с формами добавления пользователей.

class AddADUserModalWindow(page)

  Базовые классы: `ModalWindowComponent`

  Модальное окно добавления нового пользователя.

  Наследует ModalWindowComponent и добавляет элементы формы: - Поля ввода (имя, пароль, email и др.) - Чекбоксы (Active Directory, Push-уведомления) - Выпадающие списки групп, пользователей AD, ролей - Кнопки действий

  Параметры:

    page (Page)

  __init__(page)

    Инициализирует элементы формы добавления пользователя.

    Параметры:

      page (Page)

  check_active_directory_checkbox()

    Включает чек-бокс Active Directory.

  uncheck_active_directory_checkbox()

    Выключает чек-бокс Active Directory.

  check_blocking_checkbox()

    Включает чек-бокс Блокировка.

  uncheck_blocking_checkbox()

    Выключает чек-бокс Блокировка.

  check_push_notification_checkbox()

    Включает чек-бокс Push-уведомления.

  uncheck_push_notification_checkbox()

    Выключает чек-бокс Push-уведомления.

  update_input_form_fields(expand)

    Персчитывает локаторы полей формы ввода при добавлении/удалении дополнительного поля.

  new_user(user_data)

    Заполняет форму и добавляет нового пользователя.

    Параметры:

      user_data (dict) – Данные пользователя (имя, роль, пароль и др.)

  close_window()

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

  close_window_by_toolbar_button()

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

  check_content()

    Проверяет наличие и корректность всех элементов формы.

## components_derived.modal_add_local_user module

Модуль modal_add_local_user содержит класс для работы с модальным окном добавления локального пользователя.

Класс AddLocalUserModalWindow наследует базовый функционал ModalWindowComponent и реализует специфичные методы для работы с формами добавления пользователей.

class AddLocalUserModalWindow(page)

  Базовые классы: `ModalWindowComponent`

  Модальное окно добавления нового пользователя.

  Наследует ModalWindowComponent и добавляет элементы формы: - Поля ввода (имя, пароль, email и др.) - Чекбоксы (Active Directory, Блокировка, Push-уведомления) - Выпадающий список ролей - Кнопки действий

  Параметры:

    page (Page)

  __init__(page)

    Инициализирует элементы формы добавления пользователя.

    Параметры:

      page (Page)

  check_active_directory_checkbox()

    Включает чек-бокс Active Directory.

  uncheck_active_directory_checkbox()

    Выключает чек-бокс Active Directory.

  check_blocking_checkbox()

    Включает чек-бокс Блокировка.

  uncheck_blocking_checkbox()

    Выключает чек-бокс Блокировка.

  check_push_notification_checkbox()

    Включает чек-бокс Push-уведомления.

  uncheck_push_notification_checkbox()

    Выключает чек-бокс Push-уведомления.

  new_user(user_data)

    Заполняет форму и добавляет нового пользователя.

    Параметры:

      user_data (dict) – Данные пользователя (имя, роль, пароль и др.)

  close_window()

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

  close_window_by_toolbar_button()

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

  check_content()

    Проверяет наличие и корректность всех элементов формы.

## components_derived.modal_change_password module

Модуль modal_change_password содержит класс для работы с окном изменения пароля текущего пользователя.

Класс ChangePasswordModalWindow наследует базовый функционал ModalWindowComponent и реализует методы для изменения пароля пользователя.

class ChangePasswordModalWindow(page)

  Базовые классы: `ModalWindowComponent`

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

  Наследует ModalWindowComponent и добавляет: - Поля задания пароля - Кнопки действий (Сохранить, Отменить)

  Параметры:

    page (Page)

  __init__(page)

    Инициализирует элементы формы редактирования пользователя.

    Параметры:

      page (Page)

  click_cancel_button()

    Нажимает кнопку „Отменить“

    Тип результата:

      None

  click_old_password_hidden_icon()

    Нажатие на иконку скрытия старого пароля.

    Тип результата:

      None

  click_new_password_hidden_icon()

    Нажатие на иконку скрытия нового пароля.

    Тип результата:

      None

  click_confirm_password_hidden_icon()

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

    Тип результата:

      None

  change_password(old_password, new_password)

    Заполняет элементы формы, нажимает кнопку „Сохранить“

    Параметры:

      - old_password (str)

      - new_password (str)

  get_password_inputs()

    Возвращает список полей ввода пароля (для тестовых целей).

    Тип результата:

      []

  check_content()

    Проверяет наличие и корректность всех элементов формы.

  check_error_message(text)

    Проверяет сообщение об ошибке, возникшее при заполнении полей формы.

    Параметры:

      text (str)

    Тип результата:

      None

## components_derived.modal_edit_user module

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

Класс EditUserModalWindow наследует базовый функционал ModalWindowComponent и реализует методы для редактирования данных пользователя.

class EditUserModalWindow(page, user_name)

  Базовые классы: `ModalWindowComponent`

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

  Наследует ModalWindowComponent и добавляет: - Поля редактирования данных - Чекбоксы настроек - Выпадающий список ролей - Кнопки действий (Сохранить, Удалить и др.)

  Параметры:

    - page (Page)

    - user_name (str)

  __init__(page, user_name)

    Инициализирует элементы формы редактирования пользователя.

    Параметры:

      - page (Page)

      - user_name (str)

  check_blocking_checkbox()

    Включает чек-бокс Блокировка.

  uncheck_blocking_checkbox()

    Выключает чек-бокс Блокировка.

  check_push_notification_checkbox()

    Включает чек-бокс Push-уведомления.

  uncheck_push_notification_checkbox()

    Выключает чек-бокс Push-уведомления.

  close_window()

    Закрывает окно через кнопку „Закрыть“.

  close_window_by_toolbar_button()

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

  delete_user()

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

  edit_user(user_data)

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

    Параметры:

      user_data (dict) – Данные для обновления (имя, роль и др.)

  reset_password()

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

  check_content(user_name, role)

    Проверяет наличие и корректность элементов окна.

    Параметры:

      - user_name (str) – Ожидаемое имя пользователя

      - role (str) – Ожидаемая роль пользователя

## components_derived.modal_view_template module

Модуль modal_view_template содержит класс для работы с модальным окном шаблона.

Класс ViewTemplateModalWindow наследует базовый функционал ModalWindowComponent и реализует методы просмотра модального окна шаблона.

class ViewTemplateModalWindow(page, title)

  Базовые классы: `ModalWindowComponent`

  Модальное окно шаблона.

  Наследует ModalWindowComponent и добавляет функционал для: 1. Инициализации модального окна с конкретным шаблоном 2. Закрытия модального окна через тулбар 3. Проверки содержимого модального окна 4. Проверки содержимого JSON контейнера

  Параметры:

    - page (Page)

    - title (str)

  __init__(page, title)

    Инициализирует элементы формы модального окна шаблона.

    Параметры:

      - page (Page)

      - title (str)

  close_window_by_toolbar_button()

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

  check_content()

    Проверяет наличие и корректность элементов окна.

    Проверяет: 1. Наличие заголовка окна с именем шаблона 2. Видимость кнопки закрытия 3. Подсказку кнопки закрытия

    Тип результата:

      None

  verify_json_container_content(template_data)

    Проверяет соответствие данных контейнера данным из API.

    Параметры:

      template_data (dict) – Данные шаблона из API.

    Тип результата:

      None

## components_derived.modal_view_ztp_template module

Модуль modal_view_ztp_template содержит класс для работы с модальным окном шаблона ZTP.

Класс ViewZTPTemplateModalWindow наследует базовый функционал ModalWindowComponent и реализует методы просмотра модального окна шаблона Zero Touch Provisioning.

class ViewZTPTemplateModalWindow(page, title)

  Базовые классы: `ModalWindowComponent`

  Модальное окно шаблона Zero Touch Provisioning.

  Наследует ModalWindowComponent и добавляет функционал для: 1. Инициализации модального окна с конкретным шаблоном ZTP 2. Закрытия модального окна 3. Получения конфигурационных данных шаблона ZTP 4. Проверки содержимого модального окна 5. Сравнения данных с API специфичными для ZTP

  Параметры:

    - page (Page)

    - title (str)

  __init__(page, title)

    Инициализирует элементы формы модального окна шаблона ZTP.

    Параметры:

      - page (Page)

      - title (str)

  close_window()

    Закрывает окно через кнопку „Закрыть“.

    Тип результата:

      None

  close_window_by_toolbar_button()

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

  check_content()

    Проверяет наличие и корректность элементов окна ZTP шаблона.

    Проверяет: 1. Наличие заголовка окна с именем шаблона 2. Видимость кнопки закрытия 3. Подсказку кнопки закрытия 4. Наличие специфичных полей для ZTP

    Тип результата:

      None

  get_modal_window_data()

    Извлекает данные из модального окна шаблона ZTP и структурирует по кодам и значениям.

    Результат:

      Данные в формате {„код“: „значение“} как в API ZTP

    Тип результата:

      dict

  _is_ztp_field_code(value)

    Проверяет, является ли значение кодом поля ZTP.

    Параметры:

      value (str) – Проверяемое значение

    Результат:

      True если значение похоже на код поля ZTP

    Тип результата:

      bool

  compare_modal_with_api_data(modal_data, api_data, title)

    Сравнивает данные из модального окна ZTP с данными из API.

    Параметры:

      - modal_data (dict) – Данные из модального окна

      - api_data (dict) – Данные из API ответа

      - title (str) – Имя шаблона для проверки

    Тип результата:

      None

## components_derived.selection_bar_component module

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

Содержит класс для работы с компонентом панели выбора значения через Playwright.

class SelectionBarComponent(page, locator_or_text)

  Базовые классы: `BaseComponent`

  Компонент панели выбора значения.

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

  Параметры:

    - page (Page)

    - locator_or_text (str | Locator)

  __init__(page, locator_or_text)

    Инициализирует компонент панели выбора значения.

    Параметры:

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

      - locator_or_text (str | Locator) – Локатор панели выбора значения (строка или объект Locator) или текст для поиска

    Тип результата:

      None

  clear_selections()

    Удаление ранее выбранных значений

    Тип результата:

      None

  get_available_options()

    Возвращает список всех доступных опций из выпадающего списка.

    Результат:

      Список доступных опций

    Тип результата:

      list[str]

  get_selection_bar_title()

    Возвращает название панели выбора значения

    Тип результата:

      str

  get_selected_values()

    Возвращает список выбранных значений

    Тип результата:

      list[str]

  clear_combobox_field(field_name, field_locator)

    Очищает значение в combobox поле с помощью кнопки закрытия (крестика).

    Параметры:

      - field_name (str) – Название поля для очистки

      - field_locator (str) – Локатор поля combobox

    Тип результата:

      None

  open_values_list()

    Открытие выпадающего списка путем нажатия на панель выбора значения

    Тип результата:

      None

  select_value(name)

    Выбор значения из списка

    Параметры:

      name (str)

    Тип результата:

      None

  wait_for_timeout(timeout)

    Ожидает указанное количество миллисекунд.

    Параметры:

      timeout (int) – Время ожидания в миллисекундах

    Тип результата:

      None

  check_field_highlighted_error(field_name, field_locator)

    Проверяет, что поле подсвечено цветом ошибки (валидация не пройдена).

    Параметры:

      - field_name (str) – Название поля для проверки

      - field_locator (str) – Локатор поля для проверки

    Тип результата:

      None

  check_field_not_highlighted_error(field_name, field_locator)

    Проверяет, что поле НЕ подсвечено цветом ошибки (валидация успешна).

    Параметры:

      - field_name (str) – Название поля для проверки

      - field_locator (str) – Локатор поля для проверки

    Тип результата:

      None

## components_derived.settings_form_component module

Модуль компонента формы ввода и отображения полей настроек. Содержит класс для работы с формами ввода и отображения полей настроек,их элементами и проверками.

class SettingsFormComponent(page)

  Базовые классы: `BaseComponent`

  Компонент формы ввода и отображения полей настроек. Предоставляет методы для взаимодействия с формой, ее содержимым и проверок.

  Параметры:

    page (Page)

  __init__(page)

    Инициализация базового компонента.

    Параметры:

      page (Page) – экземпляр страницы Playwright.

  add_content_item(name, item)

    Добавляет элемент содержимого в форму по заданному имени.

    Параметры:

      - name (str)

      - item (object)

    Тип результата:

      None

  get_content_item(name)

    Возвращает элемент содержимого по имени или None, если не найден.

    Параметры:

      name (str)

    Тип результата:

      object | None

  add_toolbar_title(title)

    Добавляет заголовок в панель инструментов модального окна.

    Параметры:

      title (str)

    Тип результата:

      None

  add_button(locator, name)

    Добавляет кнопку в форму.

    Параметры:

      - locator (str)

      - name (str)

    Тип результата:

      None

  add_tooltip_button(locator, name)

    Добавляет кнопку в форму.

    Параметры:

      - locator (str)

      - name (str)

    Тип результата:

      None

  get_button_by_name(name)

    Ищет и возвращает кнопку по имени или None, если не найдена.

    Параметры:

      name (str)

    Тип результата:

      Button | TooltipButton | None

  click_button(name)

    Кликает по кнопке с заданным именем. Вызывает ошибку, если не найдена.

    Параметры:

      name (str)

    Тип результата:

      None

  check_vertical_scrolling(locator)

    Проверяет возможность вертикальной прокрутки формы.

    Параметры:

      locator (str | Locator)

    Тип результата:

      bool

  check_button_tooltip(name, tooltip)

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

    Параметры:

      - name (str)

      - tooltip (str)

    Тип результата:

      None

  check_button_visibility(name)

    Проверяет наличие кнопки по имени. Вызывает ошибку, если не найдена.

    Параметры:

      name (str)

    Тип результата:

      None

  should_be_toolbar()

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

    Исключение:

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

    Тип результата:

      None

## components_derived.sidebar_filter_component module

Модуль компонента боковой панели формы ввода полей фильтрации отображения данных в панели событий. Содержит класс для работы с формами ввода, их элементами и проверками.

class SidebarFilterComponent(page, locator)

  Базовые классы: `BaseComponent`

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

  Параметры:

    - page (Page)

    - locator (str | Locator)

  __init__(page, locator)

    Инициализирует компонент боковой панели формы ввода параметров фильтрации.

    Параметры:

      - page (Page) – Экземпляр страницы Playwright

      - locator (str | Locator) – Локатор контейнера (строка или объект Locator) для которого вызывается панель

  add_filtering_parameter(name, title)

    Добавляет поле задания параметров фильтрации по заданному имени.

    Параметры:

      - name (str)

      - title (str)

    Тип результата:

      None

  get_filtering_parameter(name)

    Возвращает поле задания параметров фильтрации по заданному или None, если не найдено.

    Параметры:

      name (str)

    Тип результата:

      SelectionBarComponent | None

  get_start_time_filter()

    Возвращает поле задания параметров фильтрации даты начала.

    Тип результата:

      DateInput

  get_finish_time_filter()

    Возвращает поле задания параметров фильтрации даты окончания.

    Тип результата:

      DateInput

  click_apply_button()

    Клик по кнопке применения фильтра.

    Тип результата:

      None

  click_reset_button()

    Клик по кнопке сброса фильтра.

    Тип результата:

      None

  check_content()

    Проверяет наличие постоянных полей панели параметров фильтрации.

    Тип результата:

      None

  check_vertical_scrolling(locator)

    Проверяет возможность вертикальной прокрутки формы.

    Параметры:

      locator (str | Locator)

    Тип результата:

      bool

  check_apply_button_visibility()

    Проверяет наличие кнопки применения фильтра.

    Тип результата:

      None

  check_reset_button_visibility()

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

    Тип результата:

      None

  should_be_toolbar()

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

    Исключение:

      AssertionError – Если тулбар отсутствует.

    Тип результата:

      None

## components_derived.user_card module

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

Содержит класс для работы с карточкой пользователя через Playwright.

class UserCard(page)

  Базовые классы: `BaseComponent`

  Компонент карточка.

  Предоставляет методы для взаимодействия с элементами карточки.

  Параметры:

    page (Page)

  __init__(page)

    Инициализирует компонент карточки.

    Параметры:

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

  click_change_password_button()

    Нажимает кнопку открытия окна изменения пароля.

    Выполняет клик по кнопке „Изменить пароль“ в карточке пользователя.

    Тип результата:

      ChangePasswordModalWindow

  click_logout_button()

    Нажимает кнопку выхода из системы.

    Выполняет клик по кнопке „Выйти“ в карточке пользователя.

    Тип результата:

      None

  click_close_button()

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

    Выполняет клик по кнопке „Закрыть“ в карточке пользователя.

    Тип результата:

      None

  check_content()

    Проверяет наличие и корректность элементов карточки пользователя в зависимости от его роли в системе.

    Тип результата:

      None

  check_card_is_closed()

    Проверяет, что карточка пользователя отсутствует.

    Исключение:

      AssertionError – Если карточка пользователя все еще открыта.

    Тип результата:

      None

## Module contents

Package initialization.