# UI-Test

**Repository Path**: YunAbove/ui-test

## Basic Information

- **Project Name**: UI-Test
- **Description**: UI-AUTO：专注于UI自动化测试的开源项目，提供高效的测试框架和工具，支持多种平台和语言，助力开发者提升测试效率与质量。
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-20
- **Last Updated**: 2026-09-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Nexus-Console

**UI automation engine for the Nexus Testing Platform.**

> Nexus-Console is the browser-automation core of the Nexus platform — a Playwright-based,
> config-driven UI testing engine evolved from the ui-test project.

## Features

| Feature | Description |
|---|---|
| Page Object Architecture | Locator/behavior encapsulation (`pages/`) |
| Browser Automation | Playwright (chromium), login/session management |
| Config Driven Execution | env → config.yaml → example (`UI_TEST_*`) |
| Dynamic Test Data | UserFactory / TestContext / DataFactory (`fixtures/`) |
| Agent Assisted Testing | AI-driven docs2tests / fixer / explorer (`agent/`, `ai_agent/`) |
| One-click Init | `python scripts/init.py` |

## Architecture

```
Scenario / pytest entry
    ↓
Config Layer (env → yaml → example)
    ↓
Browser Layer (Playwright) + Fixture/Data Layer (fixtures/)
    ↓
Page Object Layer (pages/*)
    ↓
Tests → Assertion → Report
```

See [Nexus-Console Architecture](docs/architecture/NEXUS_CONSOLE_ARCHITECTURE.md).

## Quick Start

```bash
# 1. Clone & install
git clone <repository-url> Nexus-Console
cd Nexus-Console
pip install -r requirements.txt
playwright install chromium

# 2. Init (generates config/config.yaml from example)
python scripts/init.py

# 3. Configure environment (edit config.yaml or set UI_TEST_* env vars)

# 4. Run tests
pytest -m smoke -v
```

See [Quick Start](docs/guides/QUICK_START.md) and [Configuration](docs/guides/CONFIGURATION.md).

## Project Structure

```
Nexus-Console/
├── pages/                 # Page Objects (locator + behavior)
├── tests/                 # pytest UI tests
├── fixtures/              # UserFactory / TestContext / DataFactory
├── config/                # config.yaml(example) + env_loader + settings
├── utils/                 # browser/db/log/flow utilities
├── agent/                 # AI agent loop
├── ai_agent/              # docs2tests / fixer / explorer
├── auto_test_suite/       # framework test assets
├── scripts/init.py        # initializer
├── docs/                  # architecture / guides
└── LICENSE                # AGPL-3.0
```

## Docs

- [Architecture](docs/architecture/NEXUS_CONSOLE_ARCHITECTURE.md)
- [UI Framework](docs/architecture/UI_FRAMEWORK.md)
- [Quick Start](docs/guides/QUICK_START.md)
- [Configuration](docs/guides/CONFIGURATION.md)

## License

AGPL-3.0