File: debdiff.rst

package info (click to toggle)
debusine 0.14.1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 15,056 kB
  • sloc: python: 193,072; sh: 848; javascript: 335; makefile: 116
file content (61 lines) | stat: -rw-r--r-- 2,731 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
.. workflow:: debdiff

Workflow ``debdiff``
====================

This workflow schedules :task:`DebDiff` tasks to compare packages from the
``original`` collection against those provided in ``source_artifact`` and
``binary_artifacts``. A single :task:`DebDiff` task is scheduled for the
``source_artifact``, and one :task:`DebDiff` task is scheduled per
architecture present in the ``binary_artifacts``, provided a corresponding
package exists in the ``original`` collection with a compatible
architecture.

.. note::
    Architectures are considered compatible when they are equal, or when one is
    ``all`` and the other is ``any`` (to account for changes in a binary
    package's declared architecture across versions).

* ``task_data``:

  * ``source_artifact`` (:ref:`lookup-single`, required): the
    :artifact:`debian:source-package` artifact to use as the `new` version
    in the comparison; it will be compared to the `original` source package
    found in ``original`` collection. ``source_artifact`` is also used to
    identify binary packages built by the original source, allowing the
    workflow to detect removed binaries.

  * ``binary_artifacts`` (:ref:`lookup-multiple`, optional): the
    :artifact:`debian:upload` or :artifact:`debian:binary-package` artifacts
    to use as the `new` versions in the comparisons; each will be compared
    to the corresponding `original` package (with a compatible architecture)
    found in ``original`` collection.

  * ``original`` (:ref:`lookup-single`, required):
    :collection:`debian:suite` collection in which to look up the original
    packages

  * ``extra_flags`` (optional): a list of command-line flags to be passed
    to each scheduled :task:`DebDiff` task

  * ``arch_all_build_architecture`` (string, defaults to ``amd64``): concrete
    architecture on which to run tasks for source packages or binary
    packages with ``Architecture: all``.

  * ``backend`` (string, optional): see :task:`DebDiff`
  * ``vendor`` (string, required): the distribution vendor, used to build
    ``environment`` for :task:`DebDiff`
  * ``codename`` (string, required): the distribution codename, used to build
    ``environment`` for part of :task:`DebDiff`

The workflow computes dynamic metadata as:

.. dynamic_data::
  :method: debusine.server.workflows.debdiff::DebDiffWorkflow.build_dynamic_data

The workflow status will be:
  * ``Success`` or ``Failure``: ``Failure`` if any of the :task:`DebDiff`
    scheduled tasks returned ``Failure``, otherwise ``Success``. Note that
    the workflow will not schedule any :task:`DebDiff` task if ``original``
    does not contain a matching package for either ``source_artifact`` or
    any of the ``binary_artifact``.