README

A Qase TMS reporter for Pest PHP testing framework.

Installation

composer require --dev qase/pest-reporter

Configuration

1. Add PHPUnit Extension

Add the Qase extension to your phpunit.xml:

<?xml version="1.0" encoding="UTF-8"?>
<phpunit>
    <extensions>
        <bootstrap class="Qase\PestReporter\QaseExtension"/>
    </extensions>
    <!-- ... -->
</phpunit>

2. Create Configuration File

Create qase.config.json in your project root:

{
  "mode": "testops",
  "fallback": "report",
  "testops": {
    "api": {
      "token": "YOUR_QASE_API_TOKEN",
      "host": "qase.io"
    },
    "project": "YOUR_PROJECT_CODE",
    "run": {
      "title": "Pest Test Run",
      "complete": true
    }
  },
  "report": {
    "driver": "local",
    "connection": {
      "path": "./build/qase-report"
    }
  }
}

Or use environment variables:

QASE_MODE=testops
QASE_TESTOPS_API_TOKEN=your_token
QASE_TESTOPS_PROJECT=PROJECT_CODE

Usage

Fluent API (Recommended)

use function Qase\PestReporter\qase;

it('logs in successfully', function () {
    qase()
        ->caseId(123)
        ->title('Login Test')
        ->suite('Auth', 'Login')
        ->field('priority', 'high')
        ->parameter('browser', 'chrome')
        ->step('Open login page')
        ->step('Submit credentials', function () {
            expect(true)->toBeTrue();
        })
        ->comment('Testing login functionality')
        ->attach('/path/to/screenshot.png');
});

Static Facade

use Qase\PestReporter\Qase;

it('logs in successfully', function () {
    Qase::caseId(123);
    Qase::title('Login Test');
    Qase::comment('Testing login');

    expect(true)->toBeTrue();
});

API Reference

Fluent API Methods

Static Facade Methods

Attachments

File Attachment

qase()->attach('/path/to/file.png');

Multiple Files

qase()->attach(['/path/to/file1.png', '/path/to/file2.log']);

Content Attachment

qase()->attach((object)[
    'title' => 'response.json',
    'content' => json_encode($response),
    'mime' => 'application/json'
]);

Steps

Add test steps to structure your test execution in Qase TMS.

Simple Step Markers

qase()->step('Open login page');
qase()->step('Enter credentials');
qase()->step('Click submit');

Steps with Callbacks

Callbacks provide automatic timing and status tracking (passed/failed):

qase()->step('Fill login form', function () {
    // step body — auto-timed, status set to passed/failed
    expect(true)->toBeTrue();
});

Nested Steps

qase()->step('Login flow', function () {
    qase()->step('Enter credentials', function () {
        // nested step
    });
    qase()->step('Click submit');
});

Steps with Expected Result

qase()->step('Click login', expectedResult: 'Dashboard page loads');

Static Facade Steps

use Qase\PestReporter\Qase;

Qase::step('Open page', function () { /* ... */ });
Qase::step('Verify footer', expectedResult: 'Footer is visible');

Steps in Fluent Chain

qase()
    ->caseId(123)
    ->step('Open page')
    ->step('Fill form', function () { /* ... */ })
    ->step('Submit', expectedResult: 'Success message shown')
    ->comment('All steps passed');

Data Providers

The reporter automatically extracts parameters from Pest's data providers:

it('adds numbers', function (int $a, int $b, int $expected) {
    qase()->caseId(100);
    expect($a + $b)->toBe($expected);
})->with([
    'one plus one' => [1, 1, 2],
    'two plus two' => [2, 2, 4],
]);

Suite Hierarchy

Use describe() blocks for automatic suite hierarchy, or set manually:

describe('Authentication', function () {
    describe('Login', function () {
        it('logs in with valid credentials', function () {
            qase()->caseId(1)->comment('Testing login');
            expect(true)->toBeTrue();
        });
    });
});

// Or set manually:
it('test with custom suite', function () {
    qase()->suite('API', 'Users', 'Create');
    expect(true)->toBeTrue();
});

Running Tests

# With local report
./vendor/bin/pest

# With Qase TMS integration
QASE_MODE=testops ./vendor/bin/pest

Requirements

• PHP 8.2+
• Pest 2.0+ or 3.0+
• PHPUnit 10, 11, or 12

License

Apache License 2.0

Links

• Qase TMS
• Pest PHP
• Documentation