Define Beaker pool HW requirement (teemtee#3058)

Related to teemtee#2346

spec/hardware/beaker.fmf

@@ -0,0 +1,24 @@
+summary: |
+ Select or provision a guest with Beaker-specific parameters.
+
+description: |
+ .. code-block::
+
+ beaker:
+ # String, name of the Beaker pool to use for provisioning.
+ pool: "some-pool"
+
+
+ .. note::
+
+ The requirements are consumed by Beaker-aware ``provision``
+ plugins only, and cannot be enforced in any other
+ infrastructure.
+
+ .. versionadded:: 1.35
+
+example:
+ - |
+ # Select any system, as long as it is not from the given Beaker pool
+ beaker:
+ pool: "!= very-rare-machines"

tests/unit/provision/mrack/test_hw.py

@@ -53,6 +53,7 @@ def test_maximal_constraint(root_logger: Logger) -> None:
 
  assert result.to_mrack() == {
  'and': [
+ {'or': []},
  {'or': []},
  {
  'and': [

tests/unit/test_hardware.py

@@ -165,6 +165,8 @@ def test_normalize_invalid_hardware(
 
 
 FULL_HARDWARE_REQUIREMENTS = """
+ beaker:
+ pool: "!= foo.*"
  boot:
  method: bios
  compatible:
@@ -242,6 +244,7 @@ def test_normalize_invalid_hardware(
 def test_parse_maximal_constraint() -> None:
  hw_spec_out = """
  and:
+ - beaker.pool: '!= foo.*'
  - boot.method: contains bios
  - and:
  - compatible.distro: contains rhel-7

tmt/hardware.py

@@ -1349,6 +1349,22 @@ def _parse_location(spec: Spec) -> BaseConstraint:
  return group
 
 
+@ungroupify
+def _parse_beaker(spec: Spec) -> BaseConstraint:
+ """
+ Parse constraints related to the ``beaker`` HW requirement.
+
+ :param spec: raw constraint block specification.
+ :returns: block representation as :py:class:`BaseConstraint` or one of its subclasses.
+ """
+
+ group = And()
+
+ group.constraints += _parse_text_constraints(spec, 'beaker', ('pool',))
+
+ return group
+
+
 @ungroupify
 def _parse_generic_spec(spec: Spec) -> BaseConstraint:
  """
@@ -1367,6 +1383,9 @@ def _parse_generic_spec(spec: Spec) -> BaseConstraint:
  spec['arch'])
  ]
 
+ if 'beaker' in spec:
+ group.constraints += [_parse_beaker(spec['beaker'])]
+
  if 'boot' in spec:
  group.constraints += [_parse_boot(spec['boot'])]
 

tmt/schemas/provision/hardware.yaml

@@ -15,6 +15,19 @@ definitions:
  # arch:
  # type: string
 
+ # HW requirements: single `beaker` item
+ beaker:
+ type: object
+
+ properties:
+ pool:
+ type: string
+
+ additionalProperties: false
+
+ # enforce at least one property
+ minProperties: 1
+
  # HW requirements: `boot` block
  boot:
  type: object