Frabot

What is FraBot?

FraBot (Frappe + Robot Framework) is an automation framework built to test and interact with Frappe applications using the Robot Framework.

Key Features

• Custom Keyword Library
  FraBot provides a collection of reusable Robot Framework keywords specifically designed for Frappe. These keywords simplify tasks like:

  • Navigating doctypes

  • Creating and editing documents

  • Validating UI elements and behaviors

    
    

• Based on SeleniumLibrary
  FraBot uses SeleniumLibrary under the hood to automate browser-based interactions with the Frappe web UI, enabling robust end-to-end testing.

Use Cases

• Automate regression testing for Frappe apps

• Create reusable test flows across multiple modules

FraBot Installation Guide

Follow these steps to set up FraBot in your Frappe environment:

✅ Step 1: Clone the Repository

Navigate to the apps directory of your Frappe bench and clone the FraBot repository:

cd ~/frappe-bench/apps
git clone https://github.com/techfinite-org/frabot.git

✅ Step 2: Activate Environment and Install Dependencies

Make sure your virtual environment is activated, then install the required Python packages:

source ~/frappe-bench/env/bin/activate
pip install -r frabot/requirements.txt

✅ Step 3: Install Browsers and WebDrivers

Run the setup script to install Google Chrome, Firefox, and their respective drivers:

cd frabot
bash setup_browser.sh

✅ Step 4: Run a Sample Test

Navigate to the tests folder and run a test script using Robot Framework:

cd tests
robot test_script.robot

.