nrobo 2025.5.7

A Pytest-powered Smart Test Runner CLI tool.

🤖 nRobo — Next-Gen Test Automation for Selenium (with Playwright Superpowers)

nRobo brings the modern selector engine, autowait magic, and fluent APIs of Playwright, while staying fully compatible with Selenium WebDriver.

It’s built for QA teams who want stability, readability, and zero flakiness — without migrating away from the Selenium ecosystem.

---

Modern selectors + AutoWait + Collections + Allure reporting + CI-ready packaging. nRobo = Playwright-level power with Selenium-level compatibility.

⭐️ Why nRobo?

Because Selenium is powerful — but outdated.

Because Playwright is modern — but incompatible with Selenium ecosystems.

Because flaky UI tests cost time, money, and reputation.

nRobo solves all three*.

🚀 30-Second Quick Demo

def test_login(page):
    page.selector("text=Login").click()
    page.selector("#email").fill("admin")
    page.selector("#password").fill("secret")
    page.selector("button:has-text('Login')").click()
    page.selector("text=Welcome").should_be_visible()

This works on Selenium, but feels like Playwright.

🔥 nRobo vs Selenium vs Playwright

Capability	Selenium	Playwright	nRobo
AutoWait on all actions	❌	✅	✅
text= selectors	❌	✅	✅
has-text(), has()	❌	✅	✅
Shadow DOM >>>	⚠️	✅	✅
Locator Collections	❌	✅	✅
Chaining: click().fill().should()	❌	❌	✅ (Exclusive)
Selenium WebDriver support	✅	❌	✅

nRobo = Playwright’s power + Selenium’s reach + its own exclusive features

✨ Exclusive Features (Only in nRobo)

1. Locator Action Chaining (Exclusive)

A fluent API inspired by Playwright but designed for Selenium:

page.selector("input").click().locator("#email").fill("admin").should_be_visible()

Mix CSS, XPath, Text, Regex, Pseudo, and Shadow selectors seamlessly.

🔧 Enable/Disable:

settings.ENABLE_LOCATOR_ACTION_CHAINING = True

📄 Full documentation:

➡️ docs/locator_action_chaining.md

2. Advanced Selector Engine (Playwright-level)

Supported:

• text=Login

• "Login"

• regex: /login/i

• :visible, :enabled, :checked

• :has() + :has-text()

• shadow:: pierce selectors

page.selector("form:has(input[name=email]) >> button:visible").click()

3. Autowait Engine (Eliminates 95% Flakiness)

• Retries

• Scroll into view

• Visibility checks

• Stale element handling

• WebDriverWait on every action

page.selector("#login").click()  # auto-waits

4. Locator Collections API

rows = page.selector("tr").all()
rows.filter(has_text="Active").first().click()

Supports:

• .all()

• .first(), .last(), .nth(i)

• .filter()

• .map()

• set-like operations

6. 🔌 API Testing Support

5. Modern Reporting (HTML + Allure)

• Automatic screenshots

• Logs with timestamps

• Optional built-in Nginx Allure server

📦 Installation

pip install nrobo
nrobo init --app my_project
nrobo

📘 Documentation

• Architecture Overview

• Selector Engine

• Locator Chaining

• Locator Collections API

• Autowait engine

• Selenium Compatibility Layer

• Extending nRobo

  • Extending selector engine
  • Creating domain specific locators

All inside the docs/ directory.

🧱 Project Structure

nrobo/
  src/nrobo/
  docs/
  suites/
  tests/

🛠 Developer Guide

black src/ tests/
flake8 src/ tests/
pytest --cov=src/

Pull requests welcome!

MIT License

© 2025 pancht