Skip to content

aiverify-foundation/moonshot-smoke-testing

 
 

Repository files navigation

Moonshot Smoke Automation Test

Overview

This repository contains smoke tests for Project Moonshot, a toolkit designed to evaluate and red-team Large Language Model (LLM) applications. The integration tests ensure that various components of Moonshot work seamlessly together, maintaining the toolkit's reliability and performance.

Prerequisites

Before running the integration tests, ensure you have the following installed:

  • Python: Version 3.11 or later
  • Node.js: Version 20.11.1 LTS or later (if testing the Web UI)
  • Git: For version control
  • Moonshot: Moonshot Setup consist of Moonshot , Moonshot-Data & Moonshot UI

Installation

Clone the Repository:

git clone https://github.com/aiverify-foundation/moonshot-smoke-testing.git
cd moonshot-smoke-testing

Running the CLI Smoke Test

To execute the smoke tests:

*Make sure Moonshot is already Setup

  1. Set Up the Virtual Environment:

    It's recommended to use a virtual environment to manage dependencies:

    python -m venv venv
    source venv/bin/activate  # On Windows, use `venv\Scripts\activate`
  2. Install Dependencies:

    Install the required Python packages:

    pip install -r requirements.txt

    Install the required Node packages:

    npm install
  3. Setup Env File:

    Create a .env file:

    touch .env

    Open the .env file in a text editor and define your environment variables:

    # .env
    AZURE_OPENAI_URI = 
    AZURE_OPENAI_TOKEN = 
    ADDITIONAL_PARAMETERS = '{      "timeout": 300, "max_attempts": 3,   "temperature": 0.5 }'
    MOONSHOT_URL = localhost
    MOONSHOT_PORT_NUMBER = 3000
    CLI_DIR = ''# Path of Moonshot Library
  4. Navigate to the Test Directory:

    cd tests
  5. Run Tests:

    Use the following command to run Cli smoke tests:

    pytest

Running the UI Smoke Test

To execute the integration tests:

  1. Navigate to the Test Directory:

    cd tests
  2. Set Up the Virtual Environment:

    It's recommended to use a virtual environment to manage dependencies:

    python -m venv venv
    source venv/bin/activate  # On Windows, use `venv\Scripts\activate`
  3. Install Node Dependencies:

    Install the required Node packages:

    npm install
  4. Setup Env File:

    Create a .env file:

    touch .env

    Open the .env file in a text editor and define your environment variables:

    # .env
    AZURE_OPENAI_URI = 
    AZURE_OPENAI_TOKEN = 
    ADDITIONAL_PARAMETERS = '{      "timeout": 300, "max_attempts": 3,   "temperature": 0.5 }'
    MOONSHOT_URL = localhost
    MOONSHOT_PORT_NUMBER = 3000
    CLI_DIR = ''# Path of Moonshot Library
  5. Run Tests:

    Use the following command to run all tests:

    npx playwright test

Running Moonshot V1 CLI Smoke Tests

*Make sure Moonshot v1 is already Setup

To execute the integration tests:

  1. Navigate to the Test Directory:

    cd test-moonshot-v1
  2. Set Up the Virtual Environment:

    It's recommended to use a virtual environment to manage dependencies:

    python -m venv venv
    source venv/bin/activate  # On Windows, use `venv\Scripts\activate`
  3. Install Python Dependencies:

    Install the required Python packages:

    pip install -r requirements.txt
  4. Setup Env File:

    Create a .env file:

    touch .env

    Open the .env file in a text editor and define your environment variables:

    # .env
    AWS_ACCESS_KEY_ID = ''
    AWS_SECRET_ACCESS_KEY=''
    OPENAI_TOKEN = ''
    MOON_V1_CLI_DIR = ''# Path of Moonshot v1 repo
  5. Run Tests:

    Use the following command to run all tests:

    pytest

    For more detailed output:

    pytest -v

Running Moonshot V1 Process Check Smoke Tests

To execute the integration tests:

  1. Navigate to the Test Directory:

    cd test-moonshot-v1
  2. Set Up the Virtual Environment:

    It's recommended to use a virtual environment to manage dependencies:

    python -m venv venv
    source venv/bin/activate  # On Windows, use `venv\Scripts\activate`
  3. Install Node Dependencies:

    Install the required Node packages:

    npm install
  4. Run Tests:

    Use the following command to run all tests:

    npx playwright test

Directory Structure

A brief overview of the repository structure:

moonshot-integration-testing/         # Integration test cases
├── tests/                   
│   ├── test_cli.py                   # Smoke Test for the Moonshot v0 CLI
│   ├── smoke-test.spec.ts            # Smoke Test for the Moonshot v0 UI
│   └──
├── test-moonshot-v1/                   
│   ├── test_cli.py                   # Smoke Test for the Moonshot v1 CLI
│   ├── test_process_check.spec.ts    # Smoke Test for the Moonshot v1 Process Check
│   ├── util.py                       # Common Utils Functions to support automation on Data Preparation and Assertion
│   └── 
├── .gitignore
├── README.md                # Project documentation
└── LICENSE                  # License information

Contributing

We welcome contributions to enhance the integration tests for Moonshot. To contribute:

  1. Fork the Repository: Click the "Fork" button at the top right of this page.
  2. Create a New Branch: Use a descriptive name for your branch.
  3. Make Your Changes: Implement your improvements or fixes.
  4. Submit a Pull Request: Provide a clear description of your changes.

Please ensure that your contributions align with the project's coding standards and pass all existing tests.

License

This project is licensed under the Apache-2.0 License. See the LICENSE file for details.

About

Moonshot Smoke Testing

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • HTML 88.0%
  • TypeScript 9.7%
  • Python 2.3%