Python 和 Sencha WebTestIt 入门

Sencha WebTestIt 是一个著名的测试自动化工具集，用于使用 Protractor 和 Selenium 进行测试，支持 Java、TypeScript 和 Python 编程语言。

Sencha WebTestIt 利用 unittest 框架进行 Python 测试。

它是 Python 标准库中的一个模块，其中包含大量工具来支持使用 Python 进行测试自动化。虽然主要用于单元测试，但 unittest 框架也可以用于 Web GUI 测试。最重要的是，您不必担心整个测试和框架设置，因为 Sencha WebTestIt 会为您完成，就像为 Java 和 TypeScript 项目生成 TestNg 和 Protractor 环境一样。

安装 Python

Windows

1. 导航到 https://pythonlang.cn/ 并下载最新的 Python 版本。

2. 安装 Python 并确保将 Python 添加到 PATH。
   

   

3. 在命令行窗口中输入 python 以检查安装。
   

   

4. 重启 Webtestit。

macOS

1. 导航到 https://pythonlang.cn/ 并下载最新的 macOS 版 Python 版本

2. 安装 Python 并确保 将 Python 添加到 PATH。
   

   

3. 在终端中输入 python 以检查安装。
   

   

4. 重启 Webtestit。

Linux

1. 打开终端。

2. 输入以下命令

   sudo apt update

   sudo apt install software-properties-common

   sudo add-apt-repository ppa:deadsnakes/ppa

   sudo apt update

   sudo apt install python3.7

3. 在终端窗口中输入 Python 3.7 以检查安装。

   

4. 确保通过在终端中输入以下命令来安装 Pip 包管理系统
   

   sudo apt install python3-pip

5. 安装以下内容以获得正确的虚拟环境支持
   

   sudo apt install python3-venv

6. 重启 Webtestit。

打开新项目

打开 Sencha WebTestIt 后，按照以下步骤创建一个新项目

1. 输入项目名称。
2. 选择 Python 和 unittest 作为语言选项和框架。

3. 单击 保存。Sencha WebTestIt 为您准备工作环境。

   

创建页面对象

要使用 Python 测试 Web GUI，您需要使用选择器查找网页元素。Sencha WebTestIt 使用推荐的 页面对象模式 来组织选择器。通过为网页上的重要组件（例如，标题、菜单或内容区域）创建页面对象，您可以更轻松地处理每个组件的 Web 元素，从而使您的测试更易于维护。

在 Sencha WebTestIt 中创建 Python 项目后，下一步是创建页面对象。

使用 demoshop 页面 来演示如何识别和获取页面对象。

在这里，您可以看到我们可以从此页面创建至少三个页面对象，包括标题、项目概览和购物车。查看下图。

现在，为标题组件创建一个页面对象。单击创建 新建页面对象文件 或右键单击 pageobjects 文件夹，然后选择 新建 > 页面对象文件。

创建以“Po”为后缀的页面对象类是一个好习惯。由于我们使用 Python，我们建议您使用蛇形命名法，即在命名页面对象时，在字符之间放置下划线，且不留空格。

标题组件的页面对象应命名为 header_po.py。

在为 demoshop 页面的其他组件创建页面对象时使用相同的策略，这意味着它们将被命名为 items_overview_po.py、shopping_cart_po.py 等。

但是，对于此演示，我们不会创建这些。我们需要另一个用于 “Super Cool Goo”详细信息页面 的页面对象。让我们创建它并将其命名为 detail_page_po.py。

创建页面对象操作

现在我们已经将所有元素添加到我们的页面对象中，我们将对它们启动一些操作。

将元素从 元素 选项卡拖放到页面对象代码中。Sencha WebTestIt 创建一个反映该操作的方法。

首先将 _search_input 拖动到 header_po 代码中。释放鼠标后，将出现下拉菜单，允许您选择要使方法基于的操作。对于此元素，从弹出菜单中选择 执行 > 在元素中键入 以发送文本。

将函数命名为 insert_search_text，您的代码如下所示

def insert_search_text(self, text):
    self.wait.until(EC.visibility_of_element_located(self.search_input)).send_keys(text)

    return self

对 header_po 中的其余元素重复拖放方法，但这次从弹出菜单中选择 获取 > 元素的文本。您的代码应如下所示

def get_cart_amount(self):
    cart_count_count = self.wait.until(EC.visibility_of_element_located(self._cart_count)).text

    return cart_count_count

def get_cart_count(self):
    cart_count_text = self.wait.until(EC.visibility_of_element_located(self._cart_count)).text

    return cart_count_text

以相同的方式，将所有元素添加到 detail_page_po 代码，并为每个元素选择适当的操作，例如，按钮选择 执行 > 单击元素，文本元素选择 获取 > 元素的文本，等等。

您可以在 Sencha WebTestIt 此处 查看元素上所有可用操作的列表。

最终，您的 detail_page_po 中的方法应如下所示

def get_product_name(self):
    product_name_text = self.wait.until(EC.visibility_of_element_located(self._product_name)).text

    return product_name_text

def get_product_price(self):
    product_price_text = self.wait.until(EC.visibility_of_element_located(self._product_price)).text

    return product_price_text

def add_product_to_cart(self):
    self.wait.until(EC.visibility_of_element_located(self._add_to_cart_button)).click()

    return self

def get_confirmation_message(self):
    cart_confirmation_message_text = self.wait.until(EC.visibility_of_element_located(self._cart_confirmation_message)).text

    return cart_confirmation_message_text

请记住，您可以继续自由编辑所有操作，或将更多元素拖动到新生成的方法中。

编写测试

在添加所有元素并对其启动操作后，就该创建我们的测试了。

1. 右键单击项目树中的 Tests 文件夹，然后选择 新建 > 测试文件。
2. 将文件命名为 tc1.py。如您所见，您没有对测试文件名使用蛇形命名法，因为测试文件需要不带下划线或空格的驼峰命名法。

3. 新的测试文件生成一个空存根，指导您如何使用 AAA（Arrange, Act, Assert，安排、执行、断言）模式编写测试，以帮助您保持测试结构良好、清晰且可读。

   

Sencha WebTestIt 还负责 unittest 框架对编写和执行测试的一些重要要求，例如将测试放入类中作为方法，并在 unittest.TestCase 类中使用特殊的断言方法而不是内置的 assert 语句。

最后，您的测试应如下所示

def test_search_for_item(self):

    driver = self.get_driver()
    """
    1. Arrange
    Create a new Page Object instance by right-clicking into
    the code editor and selecting "Instantiate Page Object"
    at the bottom of the context menu
    """
    header = header_po(driver)
    detail = detail_page_po(driver)

    header.open("https://demoshop.webtestit.com")
    """
    2. Act
    Call an existing action from your Page Object instance
    """
    header.insert_search_text("Super")
    """
    3. Assert
    Use unittest assertions to verify results.
    e.g.:
    self.assertEqual(title, "Test Automation for GUI Testing | Sencha")
    """
    self.assertEqual(detail.get_product_name(), "Super Cool Goo")
    self.assertEqual(detail.get_product_price(), "€1,500.00")

def test_add_item_to_cart(self):

    driver = self.get_driver()

    header = header_po(driver)
    detail = detail_page_po(driver)
    detail.open("https://demoshop.webtestit.com/product/super-cool-goo/")

    detail.add_product_to_cart()

    self.assertTrue(detail.get_confirmation_message in ""Super Cool Goo" has been added to your cart")
    self.assertEqual(header.get_cart_count(), "1 item")
    self.assertEqual(header.get_cart_ammount(), "€1,500.00")

执行测试

要执行我们的测试，您需要创建一个端点。端点是一组关于我们测试的运行时环境的配置，例如要使用的浏览器、操作系统和设备等等。在 Sencha WebTestIt 中，您可以定义本地、远程或自定义端点来运行您的测试。

创建端点

1. 单击 执行 选项卡中的 添加端点。
2. 在添加所有必需的参数后，单击 保存端点。

3. 单击 运行当前测试文件 或 运行所有测试文件 以执行您的测试。

   

测试执行完成后，Sencha WebTestIt 会在您的项目中创建一个新文件夹 Reports。您的测试报告将自动在 报告 选项卡中打开，向您显示测试运行的结果。您还可以通过单击 Reports 文件夹中的 XML 文件来打开报告。如果您按照本文中的所有步骤操作，您的测试用例应该可以无错误地执行。但是，您的测试可能会失败。在这种情况下，Sencha WebTestIt 为您提供了创建错误工单并直接从您的测试报告中解决问题的能力，这要归功于与 Jira 的集成。