mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-11-10 11:29:55 +00:00
e4d490fd45
Fix some trivial spelling mistakes in documentation and document about --update-media-info. https://bugzilla.gnome.org/show_bug.cgi?id=752748
537 lines
23 KiB
Python
537 lines
23 KiB
Python
#!/usr/bin/env python2
|
|
#
|
|
# Copyright (c) 2014,Thibault Saunier <thibault.saunier@collabora.com>
|
|
#
|
|
# This program is free software; you can redistribute it and/or
|
|
# modify it under the terms of the GNU Lesser General Public
|
|
# License as published by the Free Software Foundation; either
|
|
# version 2.1 of the License, or (at your option) any later version.
|
|
#
|
|
# This program is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
# Lesser General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU Lesser General Public
|
|
# License along with this program; if not, write to the
|
|
# Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
|
|
# Boston, MA 02110-1301, USA.
|
|
import os
|
|
import sys
|
|
import utils
|
|
import urlparse
|
|
import loggable
|
|
import argparse
|
|
import tempfile
|
|
import reporters
|
|
import subprocess
|
|
|
|
|
|
from loggable import Loggable
|
|
from httpserver import HTTPServer
|
|
from vfb_server import get_virual_frame_buffer_server
|
|
from baseclasses import _TestsLauncher, ScenarioManager
|
|
from utils import printc, path2url, DEFAULT_MAIN_DIR, launch_command, Colors, Protocols, which
|
|
|
|
|
|
LESS = "less"
|
|
HELP = '''
|
|
|
|
===============================================================================
|
|
gst-validate-launcher
|
|
===============================================================================
|
|
|
|
1. Introduction
|
|
----------------
|
|
|
|
gst-validate-launcher is a test launcher tool. It has been designed to
|
|
launch the various tools included in GstValidate, running tests on real
|
|
media files. This means that with gst-validate-launcher, you can launch
|
|
many tests automatically in one simple command. It then permits to
|
|
aggregate results and print them in a human readable way on stdout
|
|
and serializing them in the following implemented formats:
|
|
|
|
* %s
|
|
|
|
We support all the tools provided in GstValidate in the launcher, but
|
|
we also support ges-launch when the GStreamer Editing Services have
|
|
been compiled against GstValidate.
|
|
|
|
2. Default test suite
|
|
---------------------
|
|
|
|
A default suite of tests is provided and is available at: http://cgit.freedesktop.org/gstreamer/gst-integration-testsuites/
|
|
You can run it pretty simply doing:
|
|
|
|
. $gst-validate-launcher --sync
|
|
|
|
That will download Gstreamer upstream default assets into the
|
|
default folder (%s) and run all currently
|
|
activated tests. Note that we use git-annex https://git-annex.branchable.com/ so
|
|
you will need that tool to get started.
|
|
|
|
3. Implement your own tests
|
|
---------------------------
|
|
|
|
To implement new tests, you will just need to set the media path using the
|
|
--medias-paths argument. If you want to run all avalaible scenarios on all the
|
|
file present in that folder, you should run the first time:
|
|
|
|
. $gst-validate-launcher --medias-paths /path/to/media/files --generate-media-info
|
|
|
|
That will generate the .media_info files that contains information about the media
|
|
files present in that folder. Those media_info files are simple XML file describing
|
|
the topology of the media files. You need not reuse --generate-media-info from
|
|
next time. The generated media files will be used as a reference for following
|
|
runs. You might want to check that they contain the right information yourself
|
|
the first time.
|
|
|
|
Once .media-info is generated, you can update it using --update-media-info.
|
|
|
|
Those .media_info are the files that are used by gst-validate-launcher to know
|
|
what media files can be used for the different scenarios. For example if a
|
|
file is not seekable, seeking scenarios will not be run on it etc...
|
|
|
|
3.1 Scenarios specific to a media file/stream:
|
|
----------------------------------------------
|
|
|
|
It is possible that some scenarios are very specific to one media file. In that case,
|
|
the .scenario file should be present in the same folder as the .media_info file and
|
|
be called similarly. For example for a file called /some/media/file.mp4, the media_info
|
|
file will be called /some/media/file.media_info and a scenario that will seek to a position that
|
|
is known to fail would be called: /some/media/file.mp4.seek_to_failing_pos.scenario and
|
|
gst-validate-launcher will run that scenario only on that media file.
|
|
|
|
3.2 Test media accessible through other protocols:
|
|
--------------------------------------------------
|
|
|
|
Currently gst-validate-launcher supports the following protocols:
|
|
|
|
* %s
|
|
|
|
It does not mean you can not test other protocols but it means that it has not been
|
|
properly tested.
|
|
|
|
To test medias that use those protocols, you should simply make sure that there
|
|
is a media descriptor file with .stream_info as an extension in your --media-paths.
|
|
You can generate such a file doing:
|
|
|
|
. $gst-validate-media-check-1.0 http://devimages.apple.com/iphone/samples/bipbop/bipbopall.m3u8 --output-file /somewhere/in/you/media/path/bipbop.stream_info
|
|
|
|
Once this is done, gst-validate-launcher will run the scenarios on those media files the
|
|
same way as if they were local files.
|
|
|
|
|
|
4. Debug gst-validate-launcher execution
|
|
----------------------------------------
|
|
|
|
You can activate debug logs setting the environment variable GST_VALIDATE_LAUNCHER_DEBUG.
|
|
It uses the same syntax as PITIVI_DEBUG (more information at:
|
|
http://wiki.pitivi.org/wiki/Bug_reporting#Debug_logs).
|
|
''' % ("\n * ".join([reporter.name for reporter in
|
|
utils.get_subclasses(reporters.Reporter, reporters.__dict__)]
|
|
),
|
|
DEFAULT_MAIN_DIR,
|
|
"\n * ".join([getattr(Protocols, att) for att in
|
|
dir(Protocols) if isinstance(getattr(Protocols, att), str) and not
|
|
att.startswith("_")]))
|
|
|
|
QA_ASSETS = "gst-integration-testsuites"
|
|
MEDIAS_FOLDER = "medias"
|
|
DEFAULT_GST_QA_ASSETS_REPO = "git://anongit.freedesktop.org/gstreamer/gst-integration-testsuites"
|
|
OLD_DEFAULT_GST_QA_ASSETS_REPO = "https://gitlab.com/thiblahute/gst-integration-testsuites.git"
|
|
DEFAULT_TESTSUITES_DIR = os.path.join(DEFAULT_MAIN_DIR, QA_ASSETS, "testsuites")
|
|
|
|
|
|
def download_assets(options):
|
|
try:
|
|
launch_command("%s %s %s" % (options.get_assets_command,
|
|
options.remote_assets_url,
|
|
options.clone_dir),
|
|
fails=True)
|
|
except subprocess.CalledProcessError as e:
|
|
if "git" in options.get_assets_command:
|
|
m = "\n\nMAKE SURE YOU HAVE git INSTALLED!"
|
|
else:
|
|
m = ""
|
|
|
|
printc("Could not download assets\n\nError: %s%s" % (e, m),
|
|
Colors.FAIL, True)
|
|
|
|
return False
|
|
|
|
return True
|
|
|
|
|
|
class PrintUsage(argparse.Action):
|
|
|
|
def __init__(self, option_strings, dest=argparse.SUPPRESS, default=argparse.SUPPRESS, help=None):
|
|
super(
|
|
PrintUsage, self).__init__(option_strings=option_strings, dest=dest,
|
|
default=default, nargs=0, help=help)
|
|
|
|
def __call__(self, parser, namespace, values, option_string=None):
|
|
print(HELP)
|
|
parser.exit()
|
|
|
|
|
|
class LauncherConfig(Loggable):
|
|
def __init__(self):
|
|
self.testsuites = []
|
|
self.debug = False
|
|
self.forever = False
|
|
self.fatal_error = False
|
|
self.wanted_tests = []
|
|
self.blacklisted_tests = []
|
|
self.list_tests = False
|
|
self.mute = False
|
|
self.no_color = False
|
|
self.generate_info = False
|
|
self.update_media_info = False
|
|
self.generate_info_full = False
|
|
self.long_limit = utils.LONG_TEST
|
|
self.config = None
|
|
self.valgrind = False
|
|
self.no_display = False
|
|
self.xunit_file = None
|
|
self.main_dir = utils.DEFAULT_MAIN_DIR
|
|
self.output_dir = None
|
|
self.logsdir = None
|
|
self.redirect_logs = False
|
|
self.num_jobs = 1
|
|
self.dest = None
|
|
self._using_default_paths = False
|
|
self.paths = []
|
|
self.testsuites_dir = DEFAULT_TESTSUITES_DIR
|
|
|
|
self.clone_dir = None
|
|
|
|
self.http_server_port = 8079
|
|
self.http_bandwith = 1024 * 1024
|
|
self.http_server_dir = None
|
|
self.httponly = False
|
|
self.get_assets_command = "git clone"
|
|
self.remote_assets_url = DEFAULT_GST_QA_ASSETS_REPO
|
|
self.sync = False
|
|
self.force_sync = False
|
|
self.sync_all = False
|
|
|
|
def cleanup(self):
|
|
"""
|
|
Cleanup the options looking after user options have been parsed
|
|
"""
|
|
|
|
# Get absolute path for main_dir and base everything on that
|
|
self.main_dir = os.path.abspath(self.main_dir)
|
|
|
|
# default for output_dir is MAINDIR
|
|
if not self.output_dir:
|
|
self.output_dir = self.main_dir
|
|
else:
|
|
self.output_dir = os.path.abspath(self.output_dir)
|
|
|
|
# other output directories
|
|
if self.logsdir in ['stdout', 'stderr']:
|
|
# Allow -l stdout/stderr to work like -rl stdout/stderr
|
|
self.redirect_logs = self.logsdir
|
|
self.logsdir = None
|
|
if self.logsdir is None:
|
|
self.logsdir = os.path.join(self.output_dir, "logs")
|
|
if self.xunit_file is None:
|
|
self.xunit_file = os.path.join(self.logsdir, "xunit.xml")
|
|
if self.dest is None:
|
|
self.dest = os.path.join(self.output_dir, "rendered")
|
|
|
|
if not os.path.exists(self.dest):
|
|
os.makedirs(self.dest)
|
|
if not os.path.exists(self.logsdir):
|
|
os.makedirs(self.logsdir)
|
|
|
|
if self.redirect_logs not in ['stdout', 'stderr', False]:
|
|
printc("Log redirection (%s) must be either 'stdout' or 'stderr'."
|
|
% self.redirect_logs, Colors.FAIL, True)
|
|
return False
|
|
|
|
if urlparse.urlparse(self.dest).scheme == "":
|
|
self.dest = path2url(self.dest)
|
|
|
|
if self.no_color:
|
|
utils.desactivate_colors()
|
|
if self.clone_dir is None:
|
|
self.clone_dir = os.path.join(self.main_dir, QA_ASSETS)
|
|
|
|
if not isinstance(self.paths, list):
|
|
self.paths = [self.paths]
|
|
|
|
if self.generate_info_full is True:
|
|
self.generate_info = True
|
|
|
|
if self.sync_all is True or self.force_sync is True:
|
|
self.sync = True
|
|
|
|
if not self.sync and not os.path.exists(self.clone_dir) and \
|
|
self.clone_dir == os.path.join(self.clone_dir, MEDIAS_FOLDER):
|
|
printc("Media path (%s) does not exists. Forgot to run --sync ?"
|
|
% self.clone_dir, Colors.FAIL, True)
|
|
return False
|
|
|
|
if (self.main_dir != DEFAULT_MAIN_DIR or
|
|
self.clone_dir != QA_ASSETS) and \
|
|
self.testsuites_dir == DEFAULT_TESTSUITES_DIR:
|
|
self.testsuites_dir = os.path.join(self.main_dir, self.clone_dir,
|
|
"testsuites")
|
|
if self.valgrind:
|
|
try:
|
|
subprocess.check_output("valgrind --help", shell=True)
|
|
except subprocess.CalledProcessError:
|
|
printc("Want to use valgrind, but not avalaible on the system",
|
|
Colors.FAIL)
|
|
return False
|
|
|
|
return True
|
|
|
|
def set_http_server_dir(self, path):
|
|
if self.http_server_dir is not None:
|
|
printc("Server directory already set to %s" % self.http_server_dir)
|
|
return
|
|
|
|
self.http_server_dir = path
|
|
|
|
def add_paths(self, paths, force=False):
|
|
if force is False:
|
|
if self.paths:
|
|
return
|
|
if not isinstance(paths, list):
|
|
paths = [paths]
|
|
|
|
if self._using_default_paths:
|
|
self.paths = paths
|
|
self._using_default_paths = False
|
|
else:
|
|
for path in paths:
|
|
if path not in self.paths:
|
|
self.paths.append(path)
|
|
|
|
|
|
def main(libsdir):
|
|
if "--help" in sys.argv:
|
|
_help_message = HELP
|
|
else:
|
|
_help_message = "Use --help for the full help"
|
|
|
|
parser = argparse.ArgumentParser(
|
|
formatter_class=argparse.RawTextHelpFormatter,
|
|
prog='gst-validate-launcher', description=_help_message)
|
|
|
|
parser.add_argument('testsuites', metavar='N', nargs='*',
|
|
help="""Lets you specify a file where the testsuite to execute is defined.
|
|
|
|
In the module if you want to work with a specific test manager(s) (for example,
|
|
'ges' or 'validate'), you should define the TEST_MANAGER variable in the
|
|
testsuite file (it can be a list of test manager names)
|
|
|
|
In this file you should implement a setup_tests function. That function takes
|
|
a TestManager and the GstValidateLauncher option as parameters and return True
|
|
if it succeeded loading the tests, False otherwise.
|
|
You will be able to configure the TestManager with its various methods. This
|
|
function will be called with each TestManager usable, for example you will be
|
|
passed the 'validate' TestManager in case the GstValidateManager launcher is
|
|
avalaible. You should configure it using:
|
|
|
|
* test_manager.add_scenarios: which allows you to register a list of scenario names to be run
|
|
* test_manager.set_default_blacklist: Lets you set a list of tuple of the form:
|
|
(@regex_defining_blacklister_test_names, @reason_for_the_blacklisting)
|
|
* test_manager.add_generators: which allows you to register a list of #GstValidateTestsGenerator
|
|
to be used to generate tests
|
|
* test_manager.add_encoding_formats:: which allows you to register a list #MediaFormatCombination to be used for transcoding tests
|
|
|
|
You can also set default values with:
|
|
* test_manager.register_defaults: Sets default values for all parametters
|
|
* test_manager.register_default_test_generators: Sets default values for the TestsGenerators to be used
|
|
* test_manager.register_default_scenarios: Sets default values for the scenarios to be executed
|
|
* test_manager.register_default_encoding_formats: Sets default values for the encoding formats to be tested
|
|
|
|
Note that all testsuite should be inside python modules, so the directory should contain a __init__.py file
|
|
""",
|
|
default=["validate"])
|
|
parser.add_argument("-d", "--debug", dest="debug",
|
|
action="store_true",
|
|
help="Let user debug the process on timeout")
|
|
parser.add_argument("-f", "--forever", dest="forever",
|
|
action="store_true",
|
|
help="Keep running tests until one fails")
|
|
parser.add_argument("-F", "--fatal-error", dest="fatal_error",
|
|
action="store_true",
|
|
help="Stop on first fail")
|
|
parser.add_argument("-t", "--wanted-tests", dest="wanted_tests",
|
|
action="append",
|
|
help="Define the tests to execute, it can be a regex."
|
|
" If it contains defaults_only, only default scenarios"
|
|
" will be executed")
|
|
parser.add_argument("-b", "--blacklisted-tests", dest="blacklisted_tests",
|
|
action="append",
|
|
help="Define the tests not to execute, it can be a regex.")
|
|
parser.add_argument("-L", "--list-tests",
|
|
dest="list_tests",
|
|
action="store_true",
|
|
help="List tests and exit")
|
|
parser.add_argument("-m", "--mute", dest="mute",
|
|
action="store_true",
|
|
help="Mute playback output, which means that we use "
|
|
"a fakesink")
|
|
parser.add_argument("-n", "--no-color", dest="no_color",
|
|
action="store_true",
|
|
help="Set it to output no colored text in the terminal")
|
|
parser.add_argument("-g", "--generate-media-info", dest="generate_info",
|
|
action="store_true",
|
|
help="Set it in order to generate the missing .media_infos files")
|
|
parser.add_argument("--update-media-info", dest="update_media_info",
|
|
action="store_true",
|
|
help="Set it in order to update exising .media_infos files")
|
|
parser.add_argument(
|
|
"-G", "--generate-media-info-with-frame-detection", dest="generate_info_full",
|
|
action="store_true",
|
|
help="Set it in order to generate the missing .media_infos files. "
|
|
"It implies --generate-media-info but enabling frame detection")
|
|
parser.add_argument("-lt", "--long-test-limit", dest="long_limit",
|
|
action='store',
|
|
help="Defines the limit for which a test is considered as long (in seconds)."
|
|
" Note that 0 will enable all tests", type=int),
|
|
parser.add_argument("-c", "--config", dest="config",
|
|
help="This is DEPRECATED, prefer using the testsuite format"
|
|
" to configure testsuites")
|
|
parser.add_argument("-vg", "--valgrind", dest="valgrind",
|
|
action="store_true",
|
|
help="Run the tests inside Valgrind")
|
|
parser.add_argument("-nd", "--no-display", dest="no_display",
|
|
action="store_true",
|
|
help="Run the tests without outputting graphics"
|
|
" on any display. It tries to run all graphical operation"
|
|
" in a virtual framebuffer."
|
|
" Note that it is currently implemented only"
|
|
" for the X server thanks to Xvfb (which is requeried in that case)")
|
|
dir_group = parser.add_argument_group(
|
|
"Directories and files to be used by the launcher")
|
|
parser.add_argument('--xunit-file', action='store',
|
|
dest='xunit_file', metavar="FILE",
|
|
help=("Path to xml file to store the xunit report in. "
|
|
"Default is LOGSDIR/xunit.xml"))
|
|
dir_group.add_argument("-M", "--main-dir", dest="main_dir",
|
|
help="Main directory where to put files. Default is %s" % DEFAULT_MAIN_DIR)
|
|
dir_group.add_argument("--testsuites-dir", dest="testsuites_dir",
|
|
help="Directory where to look for testsuites. Default is %s"
|
|
" Note that GstValidate expect testsuite file to have .testsuite"
|
|
" as an extension in this folder." % DEFAULT_TESTSUITES_DIR)
|
|
dir_group.add_argument("-o", "--output-dir", dest="output_dir",
|
|
help="Directory where to store logs and rendered files. Default is MAIN_DIR")
|
|
dir_group.add_argument("-l", "--logs-dir", dest="logsdir",
|
|
help="Directory where to store logs, default is OUTPUT_DIR/logs.")
|
|
dir_group.add_argument("-R", "--render-path", dest="dest",
|
|
help="Set the path to which projects should be rendered, default is OUTPUT_DIR/rendered")
|
|
dir_group.add_argument("-p", "--medias-paths", dest="paths", action="append",
|
|
help="Paths in which to look for media files")
|
|
dir_group.add_argument("-a", "--clone-dir", dest="clone_dir",
|
|
help="Paths where to clone the testuite to run "
|
|
" default is MAIN_DIR/gst-integration-testsuites")
|
|
dir_group.add_argument("-rl", "--redirect-logs", dest="redirect_logs",
|
|
help="Redirect logs to 'stdout' or 'sdterr'.")
|
|
dir_group.add_argument("-j", "--jobs", dest="num_jobs",
|
|
help="Number of tests to execute simultaneously",
|
|
type=int)
|
|
|
|
http_server_group = parser.add_argument_group(
|
|
"Handle the HTTP server to be created")
|
|
http_server_group.add_argument(
|
|
"--http-server-port", dest="http_server_port",
|
|
help="Port on which to run the http server on localhost")
|
|
http_server_group.add_argument(
|
|
"--http-bandwith-limitation", dest="http_bandwith",
|
|
help="The artificial bandwith limitation to introduce to the local server (in Bytes/sec) (default: 1 MBps)")
|
|
http_server_group.add_argument(
|
|
"-s", "--folder-for-http-server", dest="http_server_dir",
|
|
help="Folder in which to create an http server on localhost. Default is PATHS")
|
|
http_server_group.add_argument("--http-only", dest="httponly",
|
|
action='store_true',
|
|
help="Start the http server and quit")
|
|
|
|
assets_group = parser.add_argument_group("Handle remote assets")
|
|
assets_group.add_argument(
|
|
"--get-assets-command", dest="get_assets_command",
|
|
help="Command to get assets")
|
|
assets_group.add_argument("--remote-assets-url", dest="remote_assets_url",
|
|
help="Url to the remote assets (default:%s)" % DEFAULT_GST_QA_ASSETS_REPO)
|
|
assets_group.add_argument("-S", "--sync", dest="sync", action="store_true",
|
|
help="Synchronize asset repository")
|
|
assets_group.add_argument("-fs", "--force-sync", dest="force_sync", action="store_true",
|
|
help="Synchronize asset repository reseting any change that might have"
|
|
" happened in the testsuite")
|
|
assets_group.add_argument("--sync-all", dest="sync_all", action="store_true",
|
|
help="Synchronize asset repository,"
|
|
" including big media files")
|
|
assets_group.add_argument("--usage", action=PrintUsage,
|
|
help="Print usage documentation")
|
|
|
|
loggable.init("GST_VALIDATE_LAUNCHER_DEBUG", True, False)
|
|
|
|
tests_launcher = _TestsLauncher(libsdir)
|
|
tests_launcher.add_options(parser)
|
|
|
|
if _help_message == HELP and which(LESS):
|
|
tmpf = tempfile.NamedTemporaryFile()
|
|
|
|
parser.print_help(file=tmpf)
|
|
exit(os.system("%s %s" % (LESS, tmpf.name)))
|
|
|
|
options = LauncherConfig()
|
|
parser.parse_args(namespace=options)
|
|
if not options.cleanup():
|
|
exit(1)
|
|
|
|
if options.remote_assets_url and options.sync and not os.path.exists(options.clone_dir):
|
|
if not download_assets(options):
|
|
exit(1)
|
|
|
|
tests_launcher.set_settings(options, [])
|
|
|
|
# Ensure that the scenario manager singleton is ready to be used
|
|
ScenarioManager().config = options
|
|
tests_launcher.list_tests()
|
|
|
|
if options.list_tests:
|
|
l = tests_launcher.tests
|
|
for test in l:
|
|
printc(test)
|
|
|
|
printc("\nNumber of tests: %d" % len(l), Colors.OKGREEN)
|
|
return 0
|
|
|
|
httpsrv = HTTPServer(options)
|
|
if tests_launcher.needs_http_server() or options.httponly is True:
|
|
httpsrv.start()
|
|
|
|
vfb_server = get_virual_frame_buffer_server(options)
|
|
if options.no_display:
|
|
res = vfb_server.start()
|
|
if res[0] is False:
|
|
printc("Could not start virtual frame server: %s" % res[1],
|
|
Colors.FAIL)
|
|
exit(1)
|
|
os.environ["DISPLAY"] = vfb_server.display_id
|
|
|
|
if options.httponly is True:
|
|
print("Running HTTP server only")
|
|
return
|
|
|
|
e = None
|
|
try:
|
|
tests_launcher.run_tests()
|
|
except Exception as e:
|
|
pass
|
|
finally:
|
|
tests_launcher.final_report()
|
|
httpsrv.stop()
|
|
vfb_server.stop()
|
|
if e is not None:
|
|
raise
|
|
|
|
return 0
|