file-checker: replace encoding profile comparison

Use our own custom comparison to allow to add more fine grained error
reporting. Also the encoding profile is_equal function is too strict as
it also compares profiles names, that doesn't matter to us.

This commit implementation is still initial and needs improvements as it
isn't using the restriction caps, which includes information that might not be
on the profile format caps.

qa-reporter: fix crash by avoiding unref an integer

makefile: fix build of gst-qa- tools

file-checker: add error report and new report types

Add a list of new report types and use them in the file-checker.
The errors are mostly related to testing file attributes against
expected values

qa-file-checker: add a file checker object/runner

It is an object that is capable to run a few file checks. The
implemented tests are: file size, duration, if the file is seekable and
comparing the file stream types with a encoding profile

qa-scenario: adding eos scenario action

Allows sending EOS to the pipeline

qa-scenario: add new scenario action - Pause

The pause action instructs the pipeline to go to paused state and then
return to playing. It has the argument 'duration', that indicates the
duration for which the pipeline will remain in paused

qa-scenario: refactor to accomodate more actions

Refactor to be able to reuse to add more actions to scenarios.
Planned are pauses and encoding changes

qa-scenario: avoid assertion on dispose

After an error, the pipeline might still be null, check before unreffing

qa-scenario: fix typo on define variable

qa-report: fix typo on assertion comparison

gst-qa-element-monitor: do not bypass monitor factory

A pad monitor was created directly. Prefer going through the
factory.

gst-qa-reporter: fix use of uninitialized repeat field

gst-qa-reporter: fix report leak when discarding repeated report

gst-qa: fix build in po

Using a lot of grep and some cargo culting.

gst-qa: make tools depend on libraries

This fixes parallel build randomly breaking.

qa-report: expose API for adding custom issues

expose gst_qa_issue_register and gst_qa_issue_new to allow applications
to register their own custom issues.

Issues IDs should use Areas higher than GST_QA_AREA_OTHER for custom
areas. And to add more issues to existing areas, the IDs should be
higher than GST_QA_ISSUE_ID_CUSTOM_FIRST.

Custom issues registering should be done at startup and from the same
thread as there is no locking around the issues hashtable

Fix typos

qa-runner: Remove printing API from qa-runner

Replace it with functions to list the reports

pad-monitor: fix NULL format string

An empty message should be an empty string.

qa-runner: removing _setup call

Do setup on the _new function directly instead of having a separate
call for that

qa-override: add more pad overrides for buffer probe and caps

Add override functions for custom checking of buffer probe and
getcaps/setcaps functions.

pad-monitor: call the event/query/buffer overrides

Use the new event/buffer/query overrides to allow custom checks
on those scenarios

qa-override: add callbacks for query/buffer/event functions

Add callbacks for pad event/buffer/query functions in case the
override wants to do additional checks

gst-qa-override-registry: load overrides dynamically

Shared objects listed in GST_QA_OVERRIDE are loaded on startup,
and the symbol gst_qa_create_overrides is run. It should create
any override needed. While it can do anything it wants, this
is discouraged.

GST_QA_OVERRIDE should be a comma separated list of shared objects,
any relative paths should be from the current working directory
at the time they are loaded (ie, if the process to be traced
changes cwd, use absolute paths).

No attempt whatsoever is made at not running what was not meant.

Includes a sample shared object for illustration purposes.

qa-override-registry: register overrides by gtype and klass

Overrides can now be registerd by gtype, meaning that they will
be attached to monitors that the target is of the requested type.

Also by element klass, that will check that the element has the
selected class in its details

qa-monitor: implement intercept_report

It is used to iterate over overrides and modify the report level if
the overrides wants to do so.

Also adds a new mutex only for the overrides to avoid deadlocks when
reporting if we used the same lock for iterating the overrides

qa-reporter: fix copy n paste left over

qa-reporter: add function for intercepting reports

after report creation, this function is called and implementers can
modify the report to their liking before it is posted to the runner

qa-monitor: chain gst_qa_monitor_finalize to parent's finalize

It was chaining to the parent's dispose.

gst-qa-report: put the correct format to avoid compiler warnings

i18n: copy necessary files in-tree

GstIssueId: make this uintptr_t

As it's used a a placeholder pointer for g_hash_table use,
it needs to be converted back and forth to a pointer.

gst-qa-override-registry: adding the override-registry

This registry should contain the list of GstQaOverride to
be used on the pipelines being monitored

qa-override: adds qa-override that can change the report level of issues

Useful for customizing the level of issues for particular elements/tests
when they are more relevant or have to be disabled

qa-report: splitting a GstQaReport into a GstQaIssue and GstQaReport

Reports now point to Issues, that are uniquely identified and have
translatable descriptions. This way we are going to be able to uniquely
identify the issues and applications can enable/disable checks for
specific elements.

qa: Make it possible to set a scenario from the command line in test apps

qa: Properly set reporter's runner reference

That was never set, but it is needed for the reporter to properly add
reports to the runner.
We still keep a reference on the monitor to make things simpler

reporter: Use Gst debugging log in the _report method directly

Using __VALIST__ was not properly working
+ Add a gstqareporter debug category

scenario: Implement the GstQaReporter interface and make use of it

This way we can report issues from a scenario
Also add a Seek aread to the known areas list

We now need to pass the runner to the scenario instead of the
pipeline as the GstQaReporter interface needs it.

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