Automation Script Generator
🚀 Project Mission: Hybrid AI Automation Framework (Notion -> Playwright)
This project creates an autonomous end-to-end testing framework that bridges the gap between manual test case management and automated execution. It leverages Generative AI to automatically generate robust Playwright test scripts from Notion test tickets.
🎯 Objectives
- Read: Fetch test scenarios directly from a Notion Database.
- Generate: Create executable Playwright (TypeScript) scripts automatically using Google Gemini.
- Execute: Run tests with a "Self-Healing" mechanism for resilient locators.
- Report: Generate detailed reports via Allure and reflect status updates back to Notion.
🛠️ Tech Stack
- Language: TypeScript, Node.js (v20+)
- Framework: Playwright
- AI Model: Google Gemini (
gemini-2.0-flashvia@google/genaiSDK) - Integration: Notion API (
@notionhq/client) - Reporting: Allure Report
📂 Directory Structure
/
├── .agent/rules/ # Antigravity context rules
├── config/ # Configuration files
│ └── notion.config.ts # Notion API keys and DB IDs
├── src/
│ ├── generator/ # THE BUILDER
│ │ ├── fetcher.ts # Pulls from Notion
│ │ ├── translator.ts # Gemini Agent (Notion -> TS Code)
│ │ └── writer.ts # Saves .spec.ts files
│ ├── framework/ # THE RUNNER
│ │ ├── pages/ # Page Objects (POM)
│ │ └── actions/ # Self-healing wrappers
│ └── tests/ # Generated Spec files live here
├── playwright.config.ts
├── .env # Contains API Keys
└── package.json
⚙️ Setup & Installation
-
Clone the repository:
git clone <repository-url> cd automation-script-generator -
Install dependencies:
npm install -
Environment Configuration: Create a
.envfile in the root directory and add your keys:GEMINI_API_KEY=your_google_gemini_api_key NOTION_TOKEN=your_notion_integration_token NOTION_DATABASE_ID=your_notion_database_id
🏃 Usage
1. Generate Tests
To fetch "Ready for Automation" tickets from Notion and generate Playwright test files with strict Page Object Model separation:
npx ts-node src/generator/main.ts
- Artifacts:
src/framework/pages/*.page.ts: Page Objects (private selectors, public methods).src/tests/[module]/[module].data.ts: Shared test data per module.src/tests/[module]/[id]...spec.ts: Clean test specs.
2. Run Tests
To execute the generated Playwright tests:
npm test
- Video: Recorded for ALL runs (available in Allure report).
- Screenshots: Captured only on failure.
3. View Reports
To generate and view the Allure test report:
npm run test:report # Generates report (cleans old results)
npm run test:open # Opens report in browser
🧠 Smart Actions (Self-Healing)
The framework includes a SmartPage wrapper that handles flaky selectors. If a primary selector fails, it attempts to "heal" by using fallback strategies (like text hints) and logs the event, preventing brittle test failures.