# gst-validate-launcher

`gst-validate-launcher` is an application to run unit or integration testsuites providing a set of options and features to help debugging them.

## Run the GStreamer unit tests

Running GStreamer unit tests is as simple as doing:

    gst-validate-launcher check.gst*

If you only want to run GStreamer core tests:

    gst-validate-launcher check.gstreamer

Or to run unit tests from gst-plugins-base:

    gst-validate-launcher check.gst-plugins-base

## Run the GstValidate default testsuite

GstValidate comes with a default testsuite to be executed on a default set of media samples. Those media samples are stored with `git-lfs` so you will need it to be able to launch the default testsuite.

Then you can run:

    gst-validate-launcher validate

This will only launch the GstValidate tests and not other applications that might be supported (currently `ges-launch` is also supported and has its own default testsuite).

Run specific integration testsuites:

    gst-validate-launcher validate.file
    gst-validate-launcher validate.dash

GStreamer Editing Services has its own dedicated testsuite:

    gst-validate-launcher ges

Python binding tests:

    gst-validate-launcher check.gst-python

## Listing tests

    gst-validate-launcher validate.dash -L
    gst-validate-launcher ges -L

## Debugging options

Run with verbose output:

    gst-validate-launcher -v check.gstreamer

Run under gdb:

    gst-validate-launcher --gdb check.gstreamer

Run under valgrind:

    gst-validate-launcher -vg check.gstreamer

## Writing custom testsuites

See Writing testsuites for how to create your own testsuite with custom media samples and scenarios.

# Invocation

You can find detailed information about the launcher by launching it:

    gst-validate-launcher --help

Subpages:

Writing custom testsuites – How to write custom gst-validate-launcher testsuites

The results of the search are