Factory method to constructs :class:~.executionresult.Result objects.
:param sources: XML source(s) containing execution results.
Can be specified as paths, opened file objects, or strings/bytes
containing XML directly. Support for bytes is new in RF 3.2.
:param options: Configuration options.
Using ``merge=True`` causes multiple results to be combined so that
tests in the latter results replace the ones in the original.
Setting ``rpa`` either to ``True`` (RPA mode) or ``False`` (test
automation) sets execution mode explicitly. By default it is got
from processed output files and conflicting modes cause an error.
Other options are passed directly to the
:class:`ExecutionResultBuilder` object used internally.
:returns: :class:`~.executionresult.Result` instance.
Should be imported by external code via the :mod:`robot.api` package.
See the :mod:`robot.result` package for a usage example.
Definition at line 45 of file resultbuilder.py.