照片提供：mateus campos felipe
猩红鹮（Guará）
猩红鹮，学名 Eudocimus ruber，属于鹮科鸟类，栖息于热带南美洲和加勒比海地区。其外形与其他27种鹮类相似，但鲜艳的猩红色羽毛使其独具特色。它是特立尼达和多巴哥的国鸟之一，其图皮-瓜拉尼语名称“Guará”也是巴西沿海一些城市名称的一部分。
Guará：一种简化测试自动化的Python设计模式
Guará是页面交易模式的Python实现，旨在简化测试自动化过程。它并非一个自动化工具，而是一种编程模式，可与Selenium及其他自动化驱动程序（包括Linux、Windows和移动端）兼容。其核心思想是将用户在应用程序中的交互（例如登录、注销或提交表单）定义为“交易”，从而提高测试代码的可读性、可维护性和灵活性。Guará避免与特定自动化工具绑定，赋予测试人员更大的选择自由。无需安装新的插件或学习新的知识，即可与Appium、Playwright、Robot Framework、Puppeteer等工具配合使用。
Guará利用命令模式（GoF）将用户交互分组到交易中。它关注用户旅程，而非UI元素本身，通过抽象复杂性使测试语句更易于理解，类似于自然语言。测试人员可以灵活地扩展自定义断言，弥补框架本身的不足。
Guará框架示例：网页语言切换
以下代码片段模拟了网页中的语言切换：
<code class="python">from selenium import webdriver
from guara.transaction import application
from guara import it, setup
import home
def test_language_switch():
app = application(webdriver.chrome())
# 打开应用程序
app.at(setup.openapp, url="https://example.com/")
# 切换语言并断言
app.at(home.changetoportuguese).asserts(it.isequalto, "conteúdo em português")
app.at(home.changetoenglish).asserts(it.isequalto, "content in english")
# 关闭应用程序
app.at(setup.closeapp)</code>
每个用户交易都定义为一个单独的类（例如，changetoportuguese），继承自abstracttransaction。测试人员只需重写do方法，框架即可完成其余工作。
<code class="python">from guara.transaction import abstracttransaction
class changetoportuguese(abstracttransaction):
def do(self, **kwargs):
self._driver.find_element(by.css_selector, ".btn-pt").click()
return self._driver.find_element(by.css_selector, ".content").text</code>
测试运行后，日志中会显示交易和断言信息：
<code>test_demo.py::test_language_switch 2025-01-24 21:07:10 INFO Transaction: setup.OpenApp 2025-01-24 21:07:10 INFO url: https://example.com/ 2025-01-24 21:07:14 INFO Transaction: home.ChangeToPortuguese 2025-01-24 21:07:14 INFO Assertion: IsEqualTo 2025-01-24 21:07:14 INFO Actual Data: Conteúdo em Português 2025-01-24 21:07:14 INFO Expected: Conteúdo em Português 2025-01-24 21:07:14 INFO Transaction: home.ChangeToEnglish 2025-01-24 21:07:14 INFO Assertion: IsEqualTo 2025-01-24 21:07:14 INFO Actual Data: Content in English 2025-01-24 21:07:14 INFO Expected: Content in English 2025-01-24 21:07:14 INFO Transaction: setup.CloseApp</code>
测试人员可以使用pytest等工具进行测试，并利用其fixture功能进行设置和拆卸。
Guará的优势
- 每个类代表一个完整的用户交易，提高了代码的可重用性。
- 代码使用类似自然语言的表达方式，方便非技术人员理解和参与。
- 测试人员可以创建和共享自定义断言。
- Guará可以与各种自动化工具集成，支持REST API、单元测试、桌面和移动端测试自动化。
- 由于采用了命令模式，Guará甚至可以应用于产品开发。
Guará的使用
Guará的安装非常简单：
<code class="bash">pip install guara</code>
使用abstracttransaction类，以及runner的at和asserts方法。 使用pytest和详细日志进行测试执行：
<code class="bash">python -m pytest -o log_cli=1 -log-cli -level=info</code>
更多示例请参考教程。
总结
Guará为测试人员提供了一种新的代码组织方式，使其易于阅读、维护和与各种自动化驱动程序集成。它促进了测试人员与非技术人员之间的协作，并允许测试人员扩展和共享自定义断言。 现在就尝试Guará吧！
