.. _task-merge-uploads:

MergeUploads task
-----------------

This worker task combines multiple ``debian:upload`` artifacts into a
single one, in preparation for uploading them together.  This involves
running ``mergechanges`` (from devscripts) on them, or equivalent.

The ``task_data`` for this task may contain the following keys:

* ``input`` (required): a dictionary describing the input data:

  * ``uploads`` (:ref:`lookup-multiple`, required): a list of
    ``debian:upload`` artifacts

* ``environment`` (:ref:`lookup-single` with default category
  ``debian:environments``, required): ``debian:system-tarball``
  artifact that will be used to run ``mergechanges`` using the
  ``unshare`` backend.

The task computes dynamic metadata as:

.. dynamic_data::
  :method: debusine.tasks.mergeuploads::MergeUploads.build_dynamic_data

The output is a ``debian:upload`` artifact with ``extends`` relationships to
each of the input upload artifacts.

Used by the :ref:`package_upload workflow <workflow-package-upload>`.