argobeast 2.2.4b2

A Python-based test automation framework for Behave with a clean Page Object architecture and CLI scaffolding.

ArgoBEAST 🚀

Stop Building Frameworks. Start Writing Tests.

ArgoBEAST is a structural engine for Selenium and Behave. It eliminates the "scramble" of test automation by providing a pre-structured, collaborative ecosystem that forces consistency across your entire team.

Scaffold a professional Page Object Model (POM) architecture in minutes.

---

Why ArgoBEAST?

Most automation projects fail because of inconsistent structure and complex driver logic. ArgoBEAST "crushes" that grunt work by providing the guardrails necessary for collaborative success.

• ⚡ Zero-Config Scaffolding: Generate a full, professional POM stack—Pages, Actions, Steps, and Features—in seconds via the CLI.
• 🤝 Enforced Collaboration: Every engineer follows the same pattern: Pages → Actions → Steps → Features. No more "lone wolf" code styles.
• 🏗️ Architecture Built-In: Inherit from BasePage and CommonActions to get enterprise-grade form handling and element synchronization out of the box.
• 📉 Regression Creep Killer: Standardized logic makes high-frequency smoke testing easy to implement, maintain, and scale.

---

Get Started

1. Install

pip install argobeast
# OR (Recommended)
uv add argobeast

2. Initialize Your Project

argobeast init

This scaffolds a complete, framework-agnostic environment. You can opt-in to generate example template files (based on a login scenario) to see the ArgoBEAST pattern in action.

3. Build Your First Test

Use the CLI to generate the blueprint for your specific application:

argobeast create page checkout
argobeast create actions checkout
argobeast create steps checkout

Simply add your locators to the Page and your business logic to the Actions—ArgoBEAST handles the driver injection and configuration merging behind the scenes.

---

The Workflow: Scalability by Design

ArgoBEAST enforces a clean separation of concerns, ensuring your tests remain readable and maintainable:

Component	Responsibility	Parent Class
Pages	Store element locators and IDs	BasePage
Actions	High-level business logic & form filling	CommonActions
Steps	Thin Behave "glue" code	N/A
Features	Human-readable Gherkin scenarios	N/A

---

The "No-Logic" Driver Engine

Stop wrestling with webdriver initializations and messy environment.py hooks. ArgoBEAST abstracts the heavy lifting into a simple configuration layer.

• ⚙️ Logic-Free Configuration: Control browser types, headless modes, and timeouts via config/driver.yml. Change browsers or toggle headless mode without touching a single line of Python code.
• 🪄 Zero-Bloat environment.py: Framework-level setup/teardown is handled by ArgoBEAST's engine, keeping your project files focused solely on your project logic.
• 📸 Automatic Recovery: Built-in screenshot capture on every failure, handled internally by framework hooks.
• 📑 Advanced Form Logic: Use built-in dictionary mapping to complete massive web forms in a single action call.

---

Roadmap

ArgoBEAST is built for the future of professional QA:

• V2: Dockerized Execution: Standardized containers for Selenium Grid and headless execution.
• V2: Reporting Enhancements: Native, deep integration for Allure reports.
• V3: Mobile Support: Expanding the DriverFactory to support native Appium integration.

---

Resources

• Documentation: Full Guide & API Reference
• License: Apache 2.0

ArgoBEAST: INSTANT VERIFICATION. STRUCTURED, SCALABLE TESTING.