Qinusty pushed to branch Qinusty/531-fetch-retries-on-terminate at BuildStream / buildstream
Commits:
-
4f6881d6
by Jürg Billeter at 2018-08-14T08:14:32Z
-
0c8d0b0b
by Jonathan Maw at 2018-08-14T08:54:31Z
-
95798475
by Jonathan Maw at 2018-08-14T08:54:31Z
-
476fcfa6
by Jonathan Maw at 2018-08-14T08:54:31Z
-
c51bbff3
by Jonathan Maw at 2018-08-14T08:54:31Z
-
45117239
by Jonathan Maw at 2018-08-14T08:58:03Z
-
9d074d7f
by Jonathan Maw at 2018-08-14T11:52:59Z
-
a4a38461
by Josh Smith at 2018-08-14T15:49:22Z
14 changed files:
- NEWS
- buildstream/_loader/loadelement.py
- buildstream/_loader/types.py
- buildstream/_scheduler/jobs/job.py
- buildstream/_versions.py
- doc/source/format_declaring.rst
- tests/loader/dependencies.py
- + tests/loader/dependencies/elements/builddep-list.bst
- tests/loader/dependencies/elements/firstdep.bst
- + tests/loader/dependencies/elements/list-combine.bst
- + tests/loader/dependencies/elements/list-overlap.bst
- + tests/loader/dependencies/elements/runtimedep-list.bst
- + tests/loader/dependencies/elements/seconddep.bst
- + tests/loader/dependencies/elements/thirddep.bst
Changes:
| 1 |
+=================
|
|
| 2 |
+buildstream 1.3.1
|
|
| 3 |
+=================
|
|
| 4 |
+ |
|
| 5 |
+ o Failed builds are included in the cache as well.
|
|
| 6 |
+ `bst checkout` will provide anything in `%{install-root}`.
|
|
| 7 |
+ A build including cached fails will cause any dependant elements
|
|
| 8 |
+ to not be scheduled and fail during artifact assembly,
|
|
| 9 |
+ and display the retry prompt during an interactive session.
|
|
| 10 |
+ |
|
| 11 |
+ o Due to enabling the use of relative workspaces, "Legacy" workspaces
|
|
| 12 |
+ may need to be closed and remade before the changes will affect them.
|
|
| 13 |
+ Downgrading after using this feature may result in workspaces
|
|
| 14 |
+ not functioning correctly
|
|
| 15 |
+ |
|
| 16 |
+ o Elements may now specify 'build-depends' and 'runtime-depends' fields
|
|
| 17 |
+ to avoid having to specify the dependency type for every entry in
|
|
| 18 |
+ 'depends'.
|
|
| 19 |
+ |
|
| 20 |
+ |
|
| 1 | 21 |
=================
|
| 2 | 22 |
buildstream 1.1.5
|
| 3 | 23 |
=================
|
| ... | ... | @@ -11,16 +31,8 @@ buildstream 1.1.5 |
| 11 | 31 |
|
| 12 | 32 |
o Added new `remote` source plugin for downloading file blobs
|
| 13 | 33 |
|
| 14 |
- o Failed builds are included in the cache as well.
|
|
| 15 |
- `bst checkout` will provide anything in `%{install-root}`.
|
|
| 16 |
- A build including cached fails will cause any dependant elements
|
|
| 17 |
- to not be scheduled and fail during artifact assembly,
|
|
| 18 |
- and display the retry prompt during an interactive session.
|
|
| 34 |
+ o Add support for the new include '(@)' directive in project.conf and .bst files
|
|
| 19 | 35 |
|
| 20 |
- o Due to enabling the use of relative workspaces, "Legacy" workspaces
|
|
| 21 |
- may need to be closed and remade before the changes will affect them.
|
|
| 22 |
- Downgrading after using this feature may result in workspaces
|
|
| 23 |
- not functioning correctly
|
|
| 24 | 36 |
|
| 25 | 37 |
=================
|
| 26 | 38 |
buildstream 1.1.4
|
| ... | ... | @@ -71,6 +71,7 @@ class LoadElement(): |
| 71 | 71 |
'kind', 'depends', 'sources', 'sandbox',
|
| 72 | 72 |
'variables', 'environment', 'environment-nocache',
|
| 73 | 73 |
'config', 'public', 'description',
|
| 74 |
+ 'build-depends', 'runtime-depends',
|
|
| 74 | 75 |
])
|
| 75 | 76 |
|
| 76 | 77 |
# Extract the Dependencies
|
| ... | ... | @@ -127,28 +128,46 @@ class LoadElement(): |
| 127 | 128 |
# Returns:
|
| 128 | 129 |
# (list): a list of Dependency objects
|
| 129 | 130 |
#
|
| 130 |
-def _extract_depends_from_node(node):
|
|
| 131 |
- depends = _yaml.node_get(node, list, Symbol.DEPENDS, default_value=[])
|
|
| 131 |
+def _extract_depends_from_node(node, *, key=None):
|
|
| 132 |
+ if key is None:
|
|
| 133 |
+ build_depends = _extract_depends_from_node(node, key=Symbol.BUILD_DEPENDS)
|
|
| 134 |
+ runtime_depends = _extract_depends_from_node(node, key=Symbol.RUNTIME_DEPENDS)
|
|
| 135 |
+ depends = _extract_depends_from_node(node, key=Symbol.DEPENDS)
|
|
| 136 |
+ return build_depends + runtime_depends + depends
|
|
| 137 |
+ elif key == Symbol.BUILD_DEPENDS:
|
|
| 138 |
+ default_dep_type = Symbol.BUILD
|
|
| 139 |
+ elif key == Symbol.RUNTIME_DEPENDS:
|
|
| 140 |
+ default_dep_type = Symbol.RUNTIME
|
|
| 141 |
+ elif key == Symbol.DEPENDS:
|
|
| 142 |
+ default_dep_type = None
|
|
| 143 |
+ else:
|
|
| 144 |
+ assert False, "Unexpected value of key '{}'".format(key)
|
|
| 145 |
+ |
|
| 146 |
+ depends = _yaml.node_get(node, list, key, default_value=[])
|
|
| 132 | 147 |
output_deps = []
|
| 133 | 148 |
|
| 134 | 149 |
for dep in depends:
|
| 135 |
- dep_provenance = _yaml.node_get_provenance(node, key=Symbol.DEPENDS, indices=[depends.index(dep)])
|
|
| 150 |
+ dep_provenance = _yaml.node_get_provenance(node, key=key, indices=[depends.index(dep)])
|
|
| 136 | 151 |
|
| 137 | 152 |
if isinstance(dep, str):
|
| 138 |
- dependency = Dependency(dep, provenance=dep_provenance)
|
|
| 153 |
+ dependency = Dependency(dep, provenance=dep_provenance, dep_type=default_dep_type)
|
|
| 139 | 154 |
|
| 140 | 155 |
elif isinstance(dep, Mapping):
|
| 141 |
- _yaml.node_validate(dep, ['filename', 'type', 'junction'])
|
|
| 142 |
- |
|
| 143 |
- # Make type optional, for this we set it to None
|
|
| 144 |
- dep_type = _yaml.node_get(dep, str, Symbol.TYPE, default_value=None)
|
|
| 145 |
- if dep_type is None or dep_type == Symbol.ALL:
|
|
| 146 |
- dep_type = None
|
|
| 147 |
- elif dep_type not in [Symbol.BUILD, Symbol.RUNTIME]:
|
|
| 148 |
- provenance = _yaml.node_get_provenance(dep, key=Symbol.TYPE)
|
|
| 149 |
- raise LoadError(LoadErrorReason.INVALID_DATA,
|
|
| 150 |
- "{}: Dependency type '{}' is not 'build', 'runtime' or 'all'"
|
|
| 151 |
- .format(provenance, dep_type))
|
|
| 156 |
+ if default_dep_type:
|
|
| 157 |
+ _yaml.node_validate(dep, ['filename', 'junction'])
|
|
| 158 |
+ dep_type = default_dep_type
|
|
| 159 |
+ else:
|
|
| 160 |
+ _yaml.node_validate(dep, ['filename', 'type', 'junction'])
|
|
| 161 |
+ |
|
| 162 |
+ # Make type optional, for this we set it to None
|
|
| 163 |
+ dep_type = _yaml.node_get(dep, str, Symbol.TYPE, default_value=None)
|
|
| 164 |
+ if dep_type is None or dep_type == Symbol.ALL:
|
|
| 165 |
+ dep_type = None
|
|
| 166 |
+ elif dep_type not in [Symbol.BUILD, Symbol.RUNTIME]:
|
|
| 167 |
+ provenance = _yaml.node_get_provenance(dep, key=Symbol.TYPE)
|
|
| 168 |
+ raise LoadError(LoadErrorReason.INVALID_DATA,
|
|
| 169 |
+ "{}: Dependency type '{}' is not 'build', 'runtime' or 'all'"
|
|
| 170 |
+ .format(provenance, dep_type))
|
|
| 152 | 171 |
|
| 153 | 172 |
filename = _yaml.node_get(dep, str, Symbol.FILENAME)
|
| 154 | 173 |
junction = _yaml.node_get(dep, str, Symbol.JUNCTION, default_value=None)
|
| ... | ... | @@ -159,13 +178,13 @@ def _extract_depends_from_node(node): |
| 159 | 178 |
|
| 160 | 179 |
else:
|
| 161 | 180 |
index = depends.index(dep)
|
| 162 |
- p = _yaml.node_get_provenance(node, key=Symbol.DEPENDS, indices=[index])
|
|
| 181 |
+ p = _yaml.node_get_provenance(node, key=key, indices=[index])
|
|
| 163 | 182 |
raise LoadError(LoadErrorReason.INVALID_DATA,
|
| 164 | 183 |
"{}: Dependency is not specified as a string or a dictionary".format(p))
|
| 165 | 184 |
|
| 166 | 185 |
output_deps.append(dependency)
|
| 167 | 186 |
|
| 168 |
- # Now delete "depends", we dont want it anymore
|
|
| 169 |
- del node[Symbol.DEPENDS]
|
|
| 187 |
+ # Now delete the field, we dont want it anymore
|
|
| 188 |
+ del node[key]
|
|
| 170 | 189 |
|
| 171 | 190 |
return output_deps
|
| ... | ... | @@ -26,6 +26,8 @@ class Symbol(): |
| 26 | 26 |
FILENAME = "filename"
|
| 27 | 27 |
KIND = "kind"
|
| 28 | 28 |
DEPENDS = "depends"
|
| 29 |
+ BUILD_DEPENDS = "build-depends"
|
|
| 30 |
+ RUNTIME_DEPENDS = "runtime-depends"
|
|
| 29 | 31 |
SOURCES = "sources"
|
| 30 | 32 |
CONFIG = "config"
|
| 31 | 33 |
VARIABLES = "variables"
|
| ... | ... | @@ -250,7 +250,7 @@ class Job(): |
| 250 | 250 |
#
|
| 251 | 251 |
def resume(self, silent=False):
|
| 252 | 252 |
if self._suspended:
|
| 253 |
- if not silent:
|
|
| 253 |
+ if not silent and not self._scheduler.terminated:
|
|
| 254 | 254 |
self.message(MessageType.STATUS,
|
| 255 | 255 |
"{} resuming".format(self.action_name))
|
| 256 | 256 |
|
| ... | ... | @@ -549,7 +549,7 @@ class Job(): |
| 549 | 549 |
#
|
| 550 | 550 |
self._retry_flag = returncode not in (RC_OK, RC_PERM_FAIL)
|
| 551 | 551 |
|
| 552 |
- if self._retry_flag and (self._tries <= self._max_retries):
|
|
| 552 |
+ if self._retry_flag and (self._tries <= self._max_retries) and not self._scheduler.terminated:
|
|
| 553 | 553 |
self.spawn()
|
| 554 | 554 |
return
|
| 555 | 555 |
|
| ... | ... | @@ -23,7 +23,7 @@ |
| 23 | 23 |
# This version is bumped whenever enhancements are made
|
| 24 | 24 |
# to the `project.conf` format or the core element format.
|
| 25 | 25 |
#
|
| 26 |
-BST_FORMAT_VERSION = 13
|
|
| 26 |
+BST_FORMAT_VERSION = 14
|
|
| 27 | 27 |
|
| 28 | 28 |
|
| 29 | 29 |
# The base BuildStream artifact version
|
| ... | ... | @@ -98,6 +98,68 @@ relative filename to the elements they depend on here. |
| 98 | 98 |
See :ref:`format_dependencies` for more information on the dependency model.
|
| 99 | 99 |
|
| 100 | 100 |
|
| 101 |
+.. _format_build_depends:
|
|
| 102 |
+ |
|
| 103 |
+Build-Depends
|
|
| 104 |
+~~~~~~~~~~~~~
|
|
| 105 |
+ |
|
| 106 |
+.. code:: yaml
|
|
| 107 |
+ |
|
| 108 |
+ # Specify some build-dependencies
|
|
| 109 |
+ build-depends:
|
|
| 110 |
+ - element1.bst
|
|
| 111 |
+ - element2.bst
|
|
| 112 |
+ |
|
| 113 |
+Build dependencies between elements can be specified with the ``build-depends`` attribute.
|
|
| 114 |
+The above code snippet is equivalent to:
|
|
| 115 |
+ |
|
| 116 |
+.. code:: yaml
|
|
| 117 |
+ |
|
| 118 |
+ # Specify some build-dependencies
|
|
| 119 |
+ depends:
|
|
| 120 |
+ - filename: element1.bst
|
|
| 121 |
+ type: build
|
|
| 122 |
+ - filename: element2.bst
|
|
| 123 |
+ type: build
|
|
| 124 |
+ |
|
| 125 |
+See :ref:`format_dependencies` for more information on the dependency model.
|
|
| 126 |
+ |
|
| 127 |
+.. note::
|
|
| 128 |
+ |
|
| 129 |
+ The ``build-depends`` configuration is available since :ref:`format version 14 <project_format_version>`
|
|
| 130 |
+ |
|
| 131 |
+ |
|
| 132 |
+.. _format_runtime_depends:
|
|
| 133 |
+ |
|
| 134 |
+Runtime-Depends
|
|
| 135 |
+~~~~~~~~~~~~~~~
|
|
| 136 |
+ |
|
| 137 |
+.. code:: yaml
|
|
| 138 |
+ |
|
| 139 |
+ # Specify some runtime-dependencies
|
|
| 140 |
+ runtime-depends:
|
|
| 141 |
+ - element1.bst
|
|
| 142 |
+ - element2.bst
|
|
| 143 |
+ |
|
| 144 |
+Runtime dependencies between elements can be specified with the ``runtime-depends`` attribute.
|
|
| 145 |
+The above code snippet is equivalent to:
|
|
| 146 |
+ |
|
| 147 |
+.. code:: yaml
|
|
| 148 |
+ |
|
| 149 |
+ # Specify some runtime-dependencies
|
|
| 150 |
+ depends:
|
|
| 151 |
+ - filename: element1.bst
|
|
| 152 |
+ type: runtime
|
|
| 153 |
+ - filename: element2.bst
|
|
| 154 |
+ type: runtime
|
|
| 155 |
+ |
|
| 156 |
+See :ref:`format_dependencies` for more information on the dependency model.
|
|
| 157 |
+ |
|
| 158 |
+.. note::
|
|
| 159 |
+ |
|
| 160 |
+ The ``runtime-depends`` configuration is available since :ref:`format version 14 <project_format_version>`
|
|
| 161 |
+ |
|
| 162 |
+ |
|
| 101 | 163 |
.. _format_sources:
|
| 102 | 164 |
|
| 103 | 165 |
Sources
|
| ... | ... | @@ -276,8 +338,8 @@ attributes are suitable. |
| 276 | 338 |
|
| 277 | 339 |
.. note::
|
| 278 | 340 |
|
| 279 |
- Note the order in which element dependencies are declared in the ``depends``
|
|
| 280 |
- list is not meaningful.
|
|
| 341 |
+ Note the order in which element dependencies are declared in the ``depends``,
|
|
| 342 |
+ ``build-depends`` and ``runtime-depends`` lists are not meaningful.
|
|
| 281 | 343 |
|
| 282 | 344 |
Dependency dictionary:
|
| 283 | 345 |
|
| ... | ... | @@ -299,6 +361,8 @@ Attributes: |
| 299 | 361 |
* ``type``
|
| 300 | 362 |
|
| 301 | 363 |
This attribute is used to express the :ref:`dependency type <format_dependencies_types>`.
|
| 364 |
+ This field is not permitted in :ref:`Build-Depends <format_build_depends>` or
|
|
| 365 |
+ :ref:`Runtime-Depends <format_runtime_depends>`.
|
|
| 302 | 366 |
|
| 303 | 367 |
* ``junction``
|
| 304 | 368 |
|
| ... | ... | @@ -3,6 +3,7 @@ import pytest |
| 3 | 3 |
|
| 4 | 4 |
from buildstream._exceptions import LoadError, LoadErrorReason
|
| 5 | 5 |
from buildstream._loader import Loader, MetaElement
|
| 6 |
+from tests.testutils import cli
|
|
| 6 | 7 |
from . import make_loader
|
| 7 | 8 |
|
| 8 | 9 |
DATA_DIR = os.path.join(
|
| ... | ... | @@ -27,7 +28,7 @@ def test_two_files(datafiles): |
| 27 | 28 |
assert(len(element.dependencies) == 1)
|
| 28 | 29 |
firstdep = element.dependencies[0]
|
| 29 | 30 |
assert(isinstance(firstdep, MetaElement))
|
| 30 |
- assert(firstdep.kind == 'thefirstdep')
|
|
| 31 |
+ assert(firstdep.kind == 'manual')
|
|
| 31 | 32 |
|
| 32 | 33 |
|
| 33 | 34 |
@pytest.mark.datafiles(DATA_DIR)
|
| ... | ... | @@ -47,7 +48,7 @@ def test_shared_dependency(datafiles): |
| 47 | 48 |
#
|
| 48 | 49 |
firstdep = element.dependencies[0]
|
| 49 | 50 |
assert(isinstance(firstdep, MetaElement))
|
| 50 |
- assert(firstdep.kind == 'thefirstdep')
|
|
| 51 |
+ assert(firstdep.kind == 'manual')
|
|
| 51 | 52 |
assert(len(firstdep.dependencies) == 0)
|
| 52 | 53 |
|
| 53 | 54 |
# The second specified dependency is 'shareddep'
|
| ... | ... | @@ -86,7 +87,7 @@ def test_dependency_dict(datafiles): |
| 86 | 87 |
assert(len(element.dependencies) == 1)
|
| 87 | 88 |
firstdep = element.dependencies[0]
|
| 88 | 89 |
assert(isinstance(firstdep, MetaElement))
|
| 89 |
- assert(firstdep.kind == 'thefirstdep')
|
|
| 90 |
+ assert(firstdep.kind == 'manual')
|
|
| 90 | 91 |
|
| 91 | 92 |
|
| 92 | 93 |
@pytest.mark.datafiles(DATA_DIR)
|
| ... | ... | @@ -186,3 +187,49 @@ def test_all_dependency(datafiles): |
| 186 | 187 |
assert(isinstance(firstdep, MetaElement))
|
| 187 | 188 |
firstbuilddep = element.build_dependencies[0]
|
| 188 | 189 |
assert(firstdep == firstbuilddep)
|
| 190 |
+ |
|
| 191 |
+ |
|
| 192 |
+@pytest.mark.datafiles(DATA_DIR)
|
|
| 193 |
+def test_list_build_dependency(cli, datafiles):
|
|
| 194 |
+ project = str(datafiles)
|
|
| 195 |
+ |
|
| 196 |
+ # Check that the pipeline includes the build dependency
|
|
| 197 |
+ deps = cli.get_pipeline(project, ['elements/builddep-list.bst'], scope="build")
|
|
| 198 |
+ assert "elements/firstdep.bst" in deps
|
|
| 199 |
+ |
|
| 200 |
+ |
|
| 201 |
+@pytest.mark.datafiles(DATA_DIR)
|
|
| 202 |
+def test_list_runtime_dependency(cli, datafiles):
|
|
| 203 |
+ project = str(datafiles)
|
|
| 204 |
+ |
|
| 205 |
+ # Check that the pipeline includes the runtime dependency
|
|
| 206 |
+ deps = cli.get_pipeline(project, ['elements/runtimedep-list.bst'], scope="run")
|
|
| 207 |
+ assert "elements/firstdep.bst" in deps
|
|
| 208 |
+ |
|
| 209 |
+ |
|
| 210 |
+@pytest.mark.datafiles(DATA_DIR)
|
|
| 211 |
+def test_list_dependencies_combined(cli, datafiles):
|
|
| 212 |
+ project = str(datafiles)
|
|
| 213 |
+ |
|
| 214 |
+ # Check that runtime deps get combined
|
|
| 215 |
+ rundeps = cli.get_pipeline(project, ['elements/list-combine.bst'], scope="run")
|
|
| 216 |
+ assert "elements/firstdep.bst" not in rundeps
|
|
| 217 |
+ assert "elements/seconddep.bst" in rundeps
|
|
| 218 |
+ assert "elements/thirddep.bst" in rundeps
|
|
| 219 |
+ |
|
| 220 |
+ # Check that build deps get combined
|
|
| 221 |
+ builddeps = cli.get_pipeline(project, ['elements/list-combine.bst'], scope="build")
|
|
| 222 |
+ assert "elements/firstdep.bst" in builddeps
|
|
| 223 |
+ assert "elements/seconddep.bst" not in builddeps
|
|
| 224 |
+ assert "elements/thirddep.bst" in builddeps
|
|
| 225 |
+ |
|
| 226 |
+ |
|
| 227 |
+@pytest.mark.datafiles(DATA_DIR)
|
|
| 228 |
+def test_list_overlap(cli, datafiles):
|
|
| 229 |
+ project = str(datafiles)
|
|
| 230 |
+ |
|
| 231 |
+ # Check that dependencies get merged
|
|
| 232 |
+ rundeps = cli.get_pipeline(project, ['elements/list-overlap.bst'], scope="run")
|
|
| 233 |
+ assert "elements/firstdep.bst" in rundeps
|
|
| 234 |
+ builddeps = cli.get_pipeline(project, ['elements/list-overlap.bst'], scope="build")
|
|
| 235 |
+ assert "elements/firstdep.bst" in builddeps
|
| 1 |
+kind: stack
|
|
| 2 |
+description: This element has a build-only dependency specified via build-depends
|
|
| 3 |
+build-depends:
|
|
| 4 |
+ - elements/firstdep.bst
|
| 1 |
-kind: thefirstdep
|
|
| 1 |
+kind: manual
|
|
| 2 | 2 |
description: This is the first dependency
|
| 1 |
+kind: stack
|
|
| 2 |
+description: This element depends on three elements in different ways
|
|
| 3 |
+build-depends:
|
|
| 4 |
+- elements/firstdep.bst
|
|
| 5 |
+runtime-depends:
|
|
| 6 |
+- elements/seconddep.bst
|
|
| 7 |
+depends:
|
|
| 8 |
+- elements/thirddep.bst
|
| 1 |
+kind: stack
|
|
| 2 |
+description: This element depends on two elements in different ways
|
|
| 3 |
+build-depends:
|
|
| 4 |
+- elements/firstdep.bst
|
|
| 5 |
+depends:
|
|
| 6 |
+- filename: elements/firstdep.bst
|
|
| 7 |
+ type: runtime
|
| 1 |
+kind: stack
|
|
| 2 |
+description: This element has a runtime-only dependency
|
|
| 3 |
+runtime-depends:
|
|
| 4 |
+ - elements/firstdep.bst
|
| 1 |
+kind: manual
|
|
| 2 |
+description: This is the second dependency
|
| 1 |
+kind: manual
|
|
| 2 |
+description: This is the third dependency
|
