douglasdcm/guara
57.4
Adequate · 10 November 2026
7.2k
lines of production code
Python
primary language
10
measurements over time
What this system is
Guara is a Python testing and automation framework designed to structure interactions with various interfaces through a 'Page Transactions' pattern. It provides a unified abstraction for executing automated browser, desktop, and mobile UI tests, integrating with libraries such as Selenium, Playwright, Appium, and Dogtail. The system enforces reliability and business logic via transaction contracts, retry policies, and undo capabilities, while supporting both synchronous and asynchronous execution modes.
Features
Add Appium integration example for mobile UI automation
Added a new example in \examples/mobile/appium\ demonstrating how to integrate the Guara framework with Appium for automating mobile application tests. The example includes a pytest-based test suite (\\_test\_appium\_integration.py\) that uses the Page Transactions pattern, along with transaction classes (\OpenAppiumApp\, \CloseAppiumApp\, \SubmitTextAppium\) to handle app lifecycle and UI interactions, and a README explaining the setup and usage.
examples/mobile · high confidence
Add Caqui and Arsenic web UI automation examples
New example projects have been added to demonstrate web UI automation using the Caqui and Arsenic libraries. The Caqui examples provide both synchronous and asynchronous implementations for automating browser interactions, such as opening pages, retrieving link text, and validating content, while the Arsenic example showcases asynchronous browser control using the WebDriver protocol.
_examples/web\ui/caqui · high confidence
Add Helium integration example for web UI testing
Added a new example in \examples/web\_ui/helium\ demonstrating how to integrate the Helium browser automation library with Guará's Page Transactions pattern. The example includes setup and teardown transactions to manage the Chrome browser lifecycle (launching in headless mode and capturing screenshots) and a home page transaction to submit text inputs and validate results against a local HTML sample page.
_examples/web\ui/helium · high confidence
Add Linux desktop automation example using PyAutoGUI and Dogtail
A new example has been added to the \examples/linux\_desktop/pyautogui\ directory that demonstrates how to automate the GNOME Calculator on Linux. The example integrates PyAutoGUI for image-based UI interaction (clicking buttons) with Dogtail for application lifecycle management (opening and closing the app) and assertion support. It includes a test script, screen definition transactions, and a README explaining the setup and execution flow.
_examples/linux\desktop/pyautogui · high confidence
Add Playwright integration example for Guara
This change introduces a new example demonstrating how to integrate the Guara testing framework with Playwright for web UI automation. It includes both synchronous and asynchronous implementations, featuring Page Object Model (Page Transactions) patterns to navigate the Playwright documentation site and validate page content. The example provides a README explaining the setup and usage, along with test scripts and page object classes that show how to configure the Playwright driver within Guara's Application context.
_examples/web\ui/playwright · high confidence
Add PyAutoWin integration example for Windows GUI automation
Added a new example in the \examples/windows\_desktop/pyautowin\ directory that demonstrates how to integrate the Guará framework with PyAutoWin to automate interactions with local Windows applications. The example includes a \setup.py\ module for opening and closing applications, a \home.py\ transaction for submitting text via keyboard simulation, and a corresponding integration test (\\_test\_pyautowin\_integration.py\) that validates this workflow using Guará's Page Transaction pattern.
_examples/windows\desktop/pyautowin · high confidence
Add PyScript-based To-Do prototype example
Introduces a new prototyping example in \examples/prototyping/todo\ that demonstrates a browser-based To-Do list application using PyScript. The example includes a Python backend (\transactions.py\) implementing task management logic (add, remove, list, print as dictionary, get by index) via the \guara\ framework, a frontend (\main.py\, \index.html\, \style.css\) that binds these transactions to HTML buttons and inputs, and a corresponding test suite (\\_test\_todo\_prototype.py\) to verify the transaction behavior.
examples/prototyping/todo · high confidence
Add RPA integration examples for Linux desktop automation
New example files have been added to the \examples/linux\_desktop/rpa\_python\ directory to demonstrate integrating RPA for Python with the Guara framework. This includes transaction modules (\setup.py\, \home.py\) for opening/closing applications and submitting text, a test script (\\_test\_rpa\_integration.py\) that uses pytest and the Page Transactions pattern, and a \README.md\ explaining the project structure and usage.
_examples/linux\_desktop/rpa\python · high confidence
Add Selenium Stealth integration example for Guará
This location introduces a new example demonstrating how to integrate the Selenium Stealth library with Guará's Page Transactions pattern to automate web interactions while evading bot detection. The example includes a test class (\TestSeleniumStealthIntegration\) that configures a headless Chrome driver with stealth settings (such as spoofing vendor and platform details) and uses Guará transactions (\OpenStealthBrowser\, \SubmitSeleniumStealth\, \CloseStealthBrowser\) to interact with a local web page. Note that the integration test is currently skipped in the pipeline due to failures.
_examples/web\_ui/selenium\stealth · high confidence
Add Selenium-based end-to-end tests for the Vagas pra mim example app
The \examples/web\_ui/selenium/advanced\ directory now includes a complete set of Python test files (\\_test\_real\_world.py\, \home.py\, \contact.py\, \info.py\, \setup.py\) and static HTML fixtures (\index.html\, \pt.html\, \narrow-search.html\, \wide-search.html\, \about.html\, \contact.html\) that demonstrate how to use the Guara framework to automate a job-search web application. These tests verify user flows such as navigating between pages, switching the interface language between English and Portuguese, and performing both restricted (AND) and expanded (OR) resume similarity searches.
_examples/web\ui/selenium/advanced · high confidence
Add Splinter-based web UI integration example
A new example demonstrating how to integrate the Splinter browser automation library with Guará's Page Transactions pattern has been added to the examples directory. This includes transaction definitions for opening and closing a headless Chrome browser, a test case that submits text to a local HTML page and verifies the output, and documentation explaining the setup and assertions.
_examples/web\ui/splinter · high confidence
Add Windows Calculator integration example using WinAppDriver
This change introduces a new example demonstrating how to integrate Guará's Page Transactions pattern with WinAppDriver to automate the Windows Calculator application. The addition includes a setup transaction to launch and close the app, a calculator transaction to perform addition operations, and a test suite that validates these interactions using Appium under the hood. This provides a concrete reference for users looking to implement desktop UI automation on Windows.
_examples/windows\desktop/winappdriver · high confidence
Add bakery system example project with Guará-based intent-driven design
Introduces a new example project in \examples/idd\_project\ demonstrating a bakery management system built with the Guará framework. The project includes a PySide6 desktop UI, a SQLAlchemy backend with Alembic migrations, and a CLI interface. It implements core business scenarios such as product registration, stock control, cash register management, and sales processing, using Guará's transaction and precondition patterns to enforce business rules like preventing expired product sales and validating stock levels.
_examples/idd\_project, examples/intent\_driven\design · high confidence
Add college student grade control modeling example
Introduces a new example application in \examples/modeling\ that simulates university grade control, demonstrating the use of ubiquitous language and the Guara framework. The example includes domain entities (Student, Course, Subject), application transactions (enrollment, grade addition), and a runner for behavior-driven scenarios, along with tests verifying GPA calculation, approval status, and student locking logic.
examples/modeling · high confidence
Add dogtail Linux desktop automation example
Added a new example in the \examples/linux\_desktop/dogtail\ directory demonstrating GUI automation on Linux using the Dogtail framework. This includes a README with setup instructions and context regarding Python version compatibility, along with test code that automates the GNOME Calculator to perform addition operations.
_examples/linux\desktop/dogtail · high confidence
Add dogtail-based calculator automation examples
New example files have been added to the linux\_desktop/dogtail/screens directory to demonstrate desktop UI automation using the dogtail library. These include a transaction to open and close the calculator application, a transaction to perform a sum operation by clicking buttons and pressing enter, and an assertion to verify that a calculated value is displayed on the screen.
_examples/linux\desktop/dogtail/screens · high confidence
Add sample HTML page for UI testing
A new sample HTML page has been added to the examples/web\_ui directory to serve as a sanity-check for the design. This page includes various interactive elements such as input fields, buttons, forms, links, an iframe, and a shadow DOM component, along with JavaScript functions for handling user interactions like alerts and prompts.
_examples/web\ui · high confidence
Add undetected-chromedriver integration example
Added an example demonstrating how to integrate the undetected-chromedriver library with Guará's Page Transactions pattern. This includes setup and action transactions for opening and closing the browser, as well as a test case that performs a Google search using the undetected driver to evade bot detection mechanisms.
_examples/web\_ui/undetected\chromedriver · high confidence
Added REST API testing example using Guara framework
A new example demonstrating how to test a REST API using the Guara framework has been added to the \examples/rest\_api\ directory. This includes an \echo\_api.py\ module defining GET and POST transactions against the Postman Echo service, a \test\_rest\_api.py\ script (referenced as \\_test\_api.py\ in the diff) implementing pytest-based test cases for these transactions, and a \README.md\ explaining the project structure and usage.
_examples/rest\api · high confidence
Added prototyping example demonstrating Page Transactions with PyScript
Added a new \examples/prototyping\ module containing a README and \\_\init\\_.py\ that introduces a To-Do list prototype. This example demonstrates the 'Page Transactions' pattern (based on the Command Pattern) using PyScript for the front-end and Guara for back-end logic, allowing users to experiment with transaction-based architecture and front-end integration.
examples/prototyping · high confidence
Initial release of Guara transaction automation framework
Guara version 0.0.26rc3 introduces a new framework for defining and executing automated browser transactions with support for undo/revert actions, retry policies, dry-run mode, and execution history replay. Users can define transaction contracts (pre/post-conditions), configure retry and pacing behavior via environment variables or policy dataclasses, and replay past executions from JSON logs using the new CLI 'replay' command.
guara · high confidence
Initial repository scaffolding and development tooling
The repository is initialized with the Guará Python framework, including the core source code under the guara/ directory and a comprehensive set of development and testing configurations. This includes a Makefile for standard workflows (install, test, lint), tox and pytest configurations for multi-version testing (Python 3.8–3.12) and linting, pre-commit hooks, and a mutation testing setup using cosmic-ray. Documentation is configured for Read the Docs, and the project includes a README, security policy, and steering instructions for maintainers.
(repo-wide) · high confidence
New AENA flight data crawler example added
Added a new Python example in the \examples/crawler\ directory that scrapes flight arrival data from the AENA (Spanish airport authority) website. The script uses Selenium for browser automation and BeautifulSoup for HTML parsing to collect flight details for a predefined list of Spanish airports, storing the results in a JSON file with a 5-day history retention policy.
examples/crawler · high confidence
New examples index and copyright header
Added a new README.md file that serves as an index for the examples directory, categorizing them into Development usage (modeling, prototyping, rest\_api) and Test Automation usage (crawler, linux\_desktop, mobile/appium, unit\_test, web\_ui, windows\desktop). Also added an \\init\\_.py file containing the MIT license copyright notice for the Guara project.
examples · high confidence
Test coverage
2 commits adding/updating tests in tests/performance; Added integration tests for application retry logic and natural language DSL; Added performance benchmarking tests for async and sync modes; Added unit tests for Guara transaction policies and application behavior.
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 60 → 57 (-2.7)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 77 → 77 (+0.0)
- Architecture 96 → 96 (-0.4)
- Maturity 53 → 75 (+22.8)
- Readiness 55 → 45 (-10.1)
- Security 67 → 54 (-13.3)
- Performance 100 → 100 (+0.0)
Resolved (1)
- Disclosure policy has no reporting contact
New (1)
- Disclosure policy has no reporting contact (SECURITY.md)
Architecture
- Unchanged — 0 containers · 1 contexts · 0 edges
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
douglasdcm/guara was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 10 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit dc6c42904ddd0ab9ef26d5cc71a43f3115d0d02c — the exact code this score is about.
- Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.4+preprod-464a0040a931.