Add LogDog / annotation protobuf support.

recipe_engine/recipe_api.py

 # Copyright 2016 The LUCI Authors. All rights reserved.
 # Use of this source code is governed under the Apache License, Version 2.0
 # that can be found in the LICENSE file.
 
 from __future__ import absolute_import
 import contextlib
 import collections
 import keyword
 import re
 import types
 
 from functools import wraps
 
 from .recipe_test_api import DisabledTestData, ModuleTestData
 from .config import Single
 
 from .util import ModuleInjectionSite
 
 from . import field_composer
 
 
 _StepConfig = collections.namedtuple('StepConfig',
-    ('name', 'cmd', 'cwd', 'env', 'allow_subannotations', 'trigger_specs',
-      'timeout', 'infra_step', 'stdout', 'stderr', 'stdin', 'ok_ret',
-      'step_test_data', 'nest_level'))
+    ('name', 'base_name', 'cmd', 'cwd', 'env', 'allow_subannotations',
+      'trigger_specs', 'timeout', 'infra_step', 'stdout', 'stderr', 'stdin',
+      'ok_ret', 'step_test_data', 'nest_level'))
 
 class StepConfig(_StepConfig):
   """
   StepConfig parameters:
     name: name of the step, will appear in buildbots waterfall
+    base_name: the base step name, not including any parent/nesting composition.
     cmd: command to run, list of one or more strings
     cwd: absolute path to working directory for the command
     env: dict with overrides for environment variables
     allow_subannotations: if True, lets the step emit its own annotations
     trigger_specs: a list of trigger specifications, see also _trigger_builds.
     timeout: if not None, a datetime.timedelta for the step timeout.
     infra_step: if True, this is an infrastructure step.
     stdout: Path to a file to put step stdout into. If used, stdout won't
         appear in annotator's stdout (and |allow_subannotations| is
         ignored).
     stderr: Path to a file to put step stderr into. If used, stderr won't
         appear in annotator's stderr.
     stdin: Path to a file to read step stdin from.
     ok_ret: Allowed return code list.
     step_test_data: Possible associated step test data.
     nest_level: the step's nesting level.
   """
 
 
 def _make_step_config(**step):
   """Galvanize a step dictionary into a formal StepConfig."""
+  name = step.pop('name')
   step_config = StepConfig(
-      name=step.pop('name'),
+      name=name,
+      base_name=step.pop('base_name', name),
       cmd=step.pop('cmd', None),
       cwd=step.pop('cwd', None),
       env=step.pop('env', None),
       allow_subannotations=step.pop('allow_subannotations', False),
       trigger_specs=step.pop('trigger_specs', ()),
       timeout=step.pop('timeout', None),
       infra_step=step.pop('infra_step', False),
       stdout=step.pop('stdout', None),
       stderr=step.pop('stderr', None),
       stdin=step.pop('stdin', None),
@@ skipping 654 matching lines @@
     """
     Gets the BoundProperty version of this Property. Requires a name.
     """
     return BoundProperty(
         self._default, self.help, self.kind, name, property_type, module,
         self.param_name)
 
 class UndefinedPropertyException(TypeError):
   pass