Seitentransaktionen als neue Möglichkeit, Ihre Testautomatisierung zu organisieren

Foto von Mateus Campos Felipe

Der leuchtende Scharlachrote Ibis ( Eudocimus ruber ), auch als Roter Ibis bekannt, ist ein auffälliges Mitglied der Vogelfamilie Threskiornithidae. Diese tropische Vogelart ziert die Landschaften Südamerikas und Teile der Karibik. Während seine Form der anderer Ibis-Arten ähnelt, zeichnet ihn sein leuchtend scharlachrotes Gefieder aus. Als Symbol des Nationalstolzes ist er einer der beiden Nationalvögel von Trinidad und Tobago, und sein Tupi-Guarani-Name „guará“ ist sogar in den Namen mehrerer brasilianischer Küstengemeinden enthalten.

Guará: Eine Python-Implementierung des Seitentransaktionsmusters

Guará, eine Python-Bibliothek, verkörpert das Designmuster von Page Transactions. Es handelt sich weniger um ein Tool als vielmehr um ein flexibles Programmierparadigma, das auf verschiedene Automatisierungstreiber über Selenium hinaus anwendbar ist und Linux, Windows und mobile Automatisierung umfasst.

Das Hauptziel dieses Musters besteht darin, die Testautomatisierung zu rationalisieren. Guará lässt sich von Seitenobjekten, App-Aktionen und Drehbuch inspirieren und konzentriert sich auf Benutzeraktionen (Transaktionen) innerhalb einer Anwendung – Aktionen wie Anmelden, Abmelden oder Senden von Formularen.

Dieser Ansatz verbessert die Lesbarkeit, Wartbarkeit und Anpassungsfähigkeit von Automatisierungstestcode, ohne dass neue Tools oder komplexe Abstraktionen erforderlich sind. Ein wesentlicher Vorteil ist seine fahrerunabhängige Natur; Tester sind nicht an die Verwendung von Selen gebunden. Guará lässt sich nahtlos in Helium, Dogtail, PRA Python, Playwright oder jeden bevorzugten Treiber integrieren. Es sind keine zusätzlichen Plugins oder Spezialkenntnisse erforderlich.

Um es noch einmal zu wiederholen: Guará ist eine Python-Implementierung des Page Transactions-Entwurfsmusters, wobei das Muster Vorrang vor einem eigenständigen Tool hat.

Guará nutzt das Command Pattern (GoF), um Benutzerinteraktionen (Tastendrücke, Texteingabe) in Transaktionen zu bündeln. Obwohl es sich um ein Framework handelt, handelt es sich nicht um ein neues Tool.

Anstatt sich auf einzelne UI-Elemente zu konzentrieren, legt Guará den Schwerpunkt auf die Reise des Benutzers. Die Komplexität wird in Transaktionen gekapselt, was zu Testanweisungen führt, die sich wie natürliche Sprache lesen. Tester können auch benutzerdefinierte Behauptungen erstellen und integrieren.

Guará in Aktion: Ein Beispiel für einen Sprachwechsel

Dieses Beispiel zeigt einen Benutzer, der auf einer Webseite die Sprache wechselt:

from selenium import webdriver
from guara.transaction import Application
from guara import it, setup
import home

def test_language_switch():
    app = Application(webdriver.Chrome())

    # Open the application
    app.at(setup.OpenApp, url="https://example.com/")

    # Change language and assert
    app.at(home.ChangeToPortuguese).asserts(it.IsEqualTo, "Conteúdo em Português")
    app.at(home.ChangeToEnglish).asserts(it.IsEqualTo, "Content in English")

    # Close the application
    app.at(setup.CloseApp)

Jede Transaktion befindet sich in einer eigenen Klasse (z. B. ChangeToPortuguese) und erweitert AbstractTransaction. Tester überschreiben einfach die Methode do; Den Rest erledigt Guará.

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

Post-Test-Protokolle zeigen Transaktionen und Behauptungen an:

<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>

Vorrichtungen (Einrichtung/Abbau) verwalten die Testinitialisierung und -durchführung. Standard-Testtools wie Pytest oder Unittesting sind vollständig kompatibel.

Vorteile der Verwendung von Guará

• Verbesserte Wiederverwendbarkeit des Codes: Jede Klasse stellt eine vollständige Benutzertransaktion dar.
• Verbesserte Lesbarkeit: Der Code ähnelt einfachem Englisch und erleichtert so die Zusammenarbeit.
• Anpassbare Behauptungen: Erstellen und teilen Sie benutzerdefinierte Behauptungen.
• Treiberagnostizismus:Funktioniert mit verschiedenen Automatisierungstools über Selenium hinaus.
• Vielseitige Anwendung: Automatisiert REST-APIs, Unit-Tests, Desktop- und Mobiltests.

Erste Schritte mit Guará

1. Installieren: pip install guara
2. Erstellen Sie Transaktionen mit AbstractTransaction.
3. Verwenden Sie Application, at und asserts, um Transaktionen aufzurufen.
4. Führen Sie Tests mit detaillierter Protokollierung mit Pytest durch: python -m pytest -o log_cli=1 --log-cli-level=INFO

Fazit

Guará bietet einen neuen Ansatz für die Organisation von Testcode, bei dem Lesbarkeit, Wartbarkeit und Treiberunabhängigkeit im Vordergrund stehen. Es fördert die Zusammenarbeit und ermöglicht die Erstellung und gemeinsame Nutzung benutzerdefinierter Aussagen. Probieren Sie Guará aus!

Das obige ist der detaillierte Inhalt vonSeitentransaktionen als neue Möglichkeit, Ihre Testautomatisierung zu organisieren. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!