qa: Add a GstQaReporter interface that objects needing reporting can implement

Various type of object should be able to do some reporting, so we have
to make sure all the code to do that is in one place. Creating an interface
makes it simple to share information and it avoid to have a baseclass for
something that is not actually important enough to create a baseclass.

Conflicts:
gst/qa/gst-qa-pad-monitor.c

qa: Add a GstQaScenario class making it possible to execute scenarios

A scenario correspond to a suite of action to execute on a pipeline,
for the time being, we only support seeking the pipeline, but in the
future we can imagine doing some queries, setting pipeline state, etc...

The scenario can be loaded thanks to the GST_QA_SCENARIO environment
variable, making it usable with any existant application, in case, the
application can be used interactively, the user should either, not load
any scenario or let the application run without interacting with it.

pad-monitor: add lots of locking

When handling elements that spawn multiple threads (hardware
enc/decoders), the pad monitor has to protect its variables specially
because some checks involve iterating over internally linked pads to
add/get some data for comparison (expected events, timestamp ranges,
caps).

Aside from locking its own mutex, the pad monitor can also lock the
parent's mutex when it needs to use data from its internally linked
pads. The locking order should always be parent and then individual
pad-monitor mutexes. This should prevent deadlocks when multiple
pad-monitors from the same element start doing checks at the same time
from different threads.

pad-monitor: remove already solved TODOs

pad-monitor: accept unexpected flow return if pad is eos

Track eos event and mark that pad as eos so that checking for the
flow return knows when 'unexpected' is acceptable

pad-monitor: improve caps proxying check on getcaps

Only check if fields are proxied for sink getcaps as it is when
downstream restrictions should be proxied. Also improve the
fields comparison to handle single value x multi value
(list/array/range) contain relations.

pad-monitor: improve type conformance checking for caps

Replace the macro with a more powerful variadic function that can
check for more acceptable types for the same caps.

This removes a few more false positives

pad-monitor: only expect a new segment if pad is running on push mode

For pull mode, it should just provide the buffers, regardless of getting
a new segment or not

gst-qa: show help and exit when no arguments are provided

Instead of attempting to create empty pipelines and weird things
happening :)

pad-monitor: fix flushes checking

flush events shouldn't fail, so we don't need to rollback when it
returns false from downstream (this is common when downstream is still
not-linked) and it would cause gst-qa to spit false positives.

Also refactor the common event handling for both sink and src event
functions into a common place. Currently we handle flushes the same
for both pad's directions

pad-monitor: only merge caps if they exist

Downtream can not be linked, so we shouldn't try to merge
NULL caps

configure: add nano version to enable Werror

pad-monitor: fix expected setcaps fields comparison

Use the correct structure when getting the GValues and print different
messages for missing and different fields on the setcaps caps

pad-monitor: improve timestamp ranges comparison message a little

Show the buffer range that is being compared.

pad-monitor: add check for serialized events order

Store expected serialized events and their 'timestamps' to check if
they are pushed in the same order/time as they were received

pad-monitor: add check for setcaps passing audio/video fields

Checks that the common audio/video fields are correctly passed
downstream after a setcaps

pad-monitor: add check for getcaps proxying audio/video fields

Checks that the common audio/video fields are correctly proxied by
the elements after a getcaps

element-monitor: add is_encoder flag

Easy access to knowing if the monitored element is an encoder

qa-transcoding: Add a binary program to easily test transcoding

monitor(s): Avoid trying to disconnect handlers on instances that do not exist anymore

qa-report: Avoid reporting tons of times the exact same issue to users

Some of the issue can be reported once and for all. We are here avoiding to flood the
user with the same information repeated infinitely.

qa-pad-monitor: Do not use gst_private.h

docs: add design and usage docs

pad-monitor: improve timestamp ranges check

Keep the full range stored by the element in the monitor and check
if outgoing timestamps are within that range. It is simple and
should generally work.

pad-monitor: fix combined flow checks

We can only check if we found a downstream monitor

pad-monitor: fix caps field type checks

The type is GstValueList and not GArray

pad-monitor: improve report messages with arguments

qa-report: Pass the whole monitor when creating a report

So we have the proper source name already avalaible and in the future
we might need some more informations about the monitor itself.

qa-pad-monitor: Properly set target_name with as much info as possible

qa-monitor: Add a target name field that can be used even when the target is freed

qa-monitor: Make the reference to the target a weak reference

qa-report: add debug flags for criticals

Allows the user to enable program abort if a report
is created with a certain level.

Use:
GST_QA=fatal_criticals,fatal_warnings,fatal_issues

qa-report: Do not keep a ref to the source but keep its name instead

We currently do not need to access the object source after its creation
but we need to be able to have a usefull for debugging name.

qa-runner: Add a 'report-added' signal

So it is possible to plug into the runner to get information about
what is going from outside of it.

qa-report: Make it a boxed type

And make it refcounted, in 1.0 it should become a GstMiniObject, for
now, it is enough that way.

The goal is to be able to use it in signals

qa-monitor: Allow detaill message to be in printf format

So we can give proper informations about what is wrong to users

qa-monitor-preload: fix preload to work with pipeline creation

Wrap around the main gstreamer pipeline creation functions as wrapping
g_object_new requires rebuilding glib.

pad-monitor: fix copy n paste mistake

Do not use GstFlowReturn where a boolean is expected

pad-monitor: fix initialization of timestamp ranges

pad-monitor: check that returns are combined properly

When getting a return from a sink pad, check that it combines properly
the current returns from downstream source pads

pad-monitor: verify that pushed segment matches what was received

Check that src pads push segments that are compatible with what
was received on the sink pads

pad-monitor: output timestamps should be in range of received ones

Checks if the timestamps of pushed buffers are in the range of the
received buffer timestamps;

pad-monitor: add check for out of segment buffers

pad-monitor: track current buffer timestamp and duration

This can be used to make sure outgoing buffers match the input
timestamps

pad-monitor: check for when a flush start isn't expected

Complain when an unexpected flush-start is received

pad-monitor: add checks for raw caps completeness

Check audio and video raw caps returned from getcaps for expected
fields and types

qa-monitor: Fix typo in printf format for report debug messages

Stringify the arguments correctly for printing

pad-monitor: first buffer checks

Check that a newsegment is received before the first buffer and that
the first buffer running time is 0

qa-report: rework qa-report API

Remove error from GstQaErrorReport, making it only GstQaReport. Add
 a level and use area and subarea code, with an extra string for message
 adding details.

Provide macros on qa-monitor to make it easy to create reports.

pad-monitor: add stubs for getcaps/setcaps function wrapping

pad-monitor: add check for out of segment buffer data

qa-report: use gst_util_get_timestamp for report times

Makes it more aligned with GST_DEBUG output

pad-monitor: split event checks for src and sink pads

Keeping those handlers separate should keep the code smaller and
easier to understand

qa-monitor: add parent relation for monitors

This is useful because Pad monitors will have to ask the
parent element monitors for some element details for
doing checks

qa-element-monitor: check if the element is a decoder

This can be used on checks for timestamps being inside segment

pad-monitor: add probes for src pads

To be used for further monitoring events and buffers for
src pads

qa-report: add a timestamp to error reports

qa-report: adds qa-report for reporting errors to GstQaRunner

The errors are printed directly to stdout and are accumulated at
GstQaRunner for being printed at the end if requested

qa-monitor-preload: add functions to allow ld-preload to wrap pipelines

The preload functions wrap functions that can create pipelines and
attaches a runner to them for monitoring

qa-monitor: add runner property

runner stores the GstQaRunner that will receive the error reports
from the monitors

pad-monitor: make it able to initialize a segment

Do not take the initial format set to TIME too seriously when we
haven't got any newsegment event yet. If it is the first segment
received, switch our internal segment tracker to the event format

gst-qa: add seek-tests option

The seek-tests does a simple seeking after the pipeline has started
so that seeking checks can be performed by the monitors

pad-monitor: track some events

Segments, upstream seeks and flushes. Adding the following checks:

* A flush stop is expected after a flush start
* After a seek, the flushes/segment seqnum should be the same as the seek

pad-monitor: only set pad functions if they exist on the pad

Some functions should only be set on pads if they were originally
set, like the GetRange, Chain and BufferAlloc

qa-bin-monitor/element-monitor: implement pad/element wrapping

Add code that creates new monitors when elements/pads are found
in bin and element monitors

qa-monitor: fix various start up issues

Fix reference count for monitored object, passing of constructor
parameter and base monitor property flag

pad-monitor: instrument to monitor buffer/event/query/alloc flows

Replace pad functions with monitor functions that can do pre/post
checks and call the original functions

qa-monitor: add base class for monitors

The base class adds a 'object' property to hold the monitored object,
it can only be set on construction. Also the constructor now
automatically calls the element set up

qa-bin-monitor: adds a bin monitor

Extends element-monitor to also wrap child elements

qa: renaming Wrapper -> Monitor

qa-pad-wrapper: adds stub class for pad QA wrapper

Also fixes _new functions to ref the elements intead of
ownership transfers

qa-element-wrapper: add code for iterating and monitoring pads creation

This will be used to create the wrappers for pads

gitignore: ignore gst-qa binary

qa: adds gst-qa binary and basic classes to run the QA tests

The classes are mostly a stub for now, but the gst-qa already
has a minimum to start them;

qa: add common submodule

qa: initial empty repository