builder_name_schema.builder_name_schema Namespace Reference

Functions
def	MakeBuilderName (**parts)
def	DictForBuilderName (builder_name)

Variables
	BUILDER_NAME_SCHEMA = None
	BUILDER_NAME_SEP = None
string	BUILDER_ROLE_BAZELBUILD = 'BazelBuild'
string	BUILDER_ROLE_BAZELTEST = 'BazelTest'
string	BUILDER_ROLE_BUILD = 'Build'
string	BUILDER_ROLE_BUILDSTATS = 'BuildStats'
string	BUILDER_ROLE_CANARY = 'Canary'
string	BUILDER_ROLE_CODESIZE = 'CodeSize'
string	BUILDER_ROLE_HOUSEKEEPER = 'Housekeeper'
string	BUILDER_ROLE_INFRA = 'Infra'
string	BUILDER_ROLE_PERF = 'Perf'
string	BUILDER_ROLE_TEST = 'Test'
string	BUILDER_ROLE_UPLOAD = 'Upload'
tuple	BUILDER_ROLES

Function Documentation

DictForBuilderName()

def builder_name_schema.builder_name_schema.DictForBuilderName

(

builder_name

)

Makes a dictionary containing details about the builder from its name.

Definition at line 143 of file builder_name_schema.py.

def DictForBuilderName(builder_name):
  """Makes a dictionary containing details about the builder from its name."""
  split = builder_name.split(BUILDER_NAME_SEP)
 
  def pop_front(items):
    try:
      return items.pop(0), items
    except:
      raise ValueError(
          'Invalid builder name: %s (not enough parts)' % builder_name)
 
  result = {}
 
  def _parse(depth, role, parts):
    schema = BUILDER_NAME_SCHEMA.get(role)
    if not schema:
      raise ValueError('Invalid builder name: %s' % builder_name)
    if depth == 0:
      result['role'] = str(role)
    else:
      result['sub-role-%d' % depth] = str(role)
    for key in schema.get('keys', []):
      value, parts = pop_front(parts)
      result[key] = str(value)
    for sub_role in schema.get('recurse_roles', []):
      if len(parts) > 0 and sub_role == parts[0]:
        parts = _parse(depth+1, parts[0], parts[1:])
    for key in schema.get('optional_keys', []):
      if parts:
        value, parts = pop_front(parts)
        result[key] = str(value)
    if parts:
      raise ValueError('Invalid builder name: %s' % builder_name)
    return parts
 
  _parse(0, split[0], split[1:])
 
  return result

MakeBuilderName()

def builder_name_schema.builder_name_schema.MakeBuilderName

(

**

parts

)

Definition at line 85 of file builder_name_schema.py.

def MakeBuilderName(**parts):
  for v in parts.values():
    if BUILDER_NAME_SEP in v:
      raise ValueError('Parts cannot contain "%s"' % BUILDER_NAME_SEP)
 
  rv_parts = []
 
  def process(depth, parts):
    role_key = 'role'
    if depth != 0:
      role_key = 'sub-role-%d' % depth
    role = parts.get(role_key)
    if not role:
      raise ValueError('Invalid parts; missing key %s' % role_key)
    s = BUILDER_NAME_SCHEMA.get(role)
    if not s:
      raise ValueError('Invalid parts; unknown role %s' % role)
    rv_parts.append(role)
    del parts[role_key]
 
    for key in s.get('keys', []):
      value = parts.get(key)
      if not value:
        raise ValueError('Invalid parts; missing %s' % key)
      rv_parts.append(value)
      del parts[key]
 
    recurse_roles = s.get('recurse_roles', [])
    if len(recurse_roles) > 0:
      sub_role_key = 'sub-role-%d' % (depth+1)
      sub_role = parts.get(sub_role_key)
      if not sub_role:
        raise ValueError('Invalid parts; missing %s' % sub_role_key)
 
      found = False
      for recurse_role in recurse_roles:
        if recurse_role == sub_role:
          found = True
          parts = process(depth+1, parts)
          break
      if not found:
        raise ValueError('Invalid parts; unknown sub-role %s' % sub_role)
 
    for key in s.get('optional_keys', []):
      if parts.get(key):
        rv_parts.append(parts[key])
        del parts[key]
 
    if len(parts) > 0:
      raise ValueError('Invalid parts; too many parts: %s' % parts)
 
    return parts
 
  process(0, parts)
 
  return BUILDER_NAME_SEP.join(rv_parts)
 
 

Variable Documentation

BUILDER_NAME_SCHEMA

builder_name_schema.builder_name_schema.BUILDER_NAME_SCHEMA = None

Definition at line 17 of file builder_name_schema.py.

BUILDER_NAME_SEP

builder_name_schema.builder_name_schema.BUILDER_NAME_SEP = None

Definition at line 20 of file builder_name_schema.py.

BUILDER_ROLE_BAZELBUILD

string builder_name_schema.builder_name_schema.BUILDER_ROLE_BAZELBUILD = 'BazelBuild'

Definition at line 23 of file builder_name_schema.py.

BUILDER_ROLE_BAZELTEST

string builder_name_schema.builder_name_schema.BUILDER_ROLE_BAZELTEST = 'BazelTest'

Definition at line 24 of file builder_name_schema.py.

BUILDER_ROLE_BUILD

string builder_name_schema.builder_name_schema.BUILDER_ROLE_BUILD = 'Build'

Definition at line 25 of file builder_name_schema.py.

BUILDER_ROLE_BUILDSTATS

string builder_name_schema.builder_name_schema.BUILDER_ROLE_BUILDSTATS = 'BuildStats'

Definition at line 26 of file builder_name_schema.py.

BUILDER_ROLE_CANARY

string builder_name_schema.builder_name_schema.BUILDER_ROLE_CANARY = 'Canary'

Definition at line 27 of file builder_name_schema.py.

BUILDER_ROLE_CODESIZE

string builder_name_schema.builder_name_schema.BUILDER_ROLE_CODESIZE = 'CodeSize'

Definition at line 28 of file builder_name_schema.py.

BUILDER_ROLE_HOUSEKEEPER

string builder_name_schema.builder_name_schema.BUILDER_ROLE_HOUSEKEEPER = 'Housekeeper'

Definition at line 29 of file builder_name_schema.py.

BUILDER_ROLE_INFRA

string builder_name_schema.builder_name_schema.BUILDER_ROLE_INFRA = 'Infra'

Definition at line 30 of file builder_name_schema.py.

BUILDER_ROLE_PERF

string builder_name_schema.builder_name_schema.BUILDER_ROLE_PERF = 'Perf'

Definition at line 31 of file builder_name_schema.py.

BUILDER_ROLE_TEST

string builder_name_schema.builder_name_schema.BUILDER_ROLE_TEST = 'Test'

Definition at line 32 of file builder_name_schema.py.

BUILDER_ROLE_UPLOAD

string builder_name_schema.builder_name_schema.BUILDER_ROLE_UPLOAD = 'Upload'

Definition at line 33 of file builder_name_schema.py.

BUILDER_ROLES

tuple builder_name_schema.builder_name_schema.BUILDER_ROLES

Initial value:

=  (BUILDER_ROLE_BAZELBUILD,
                 BUILDER_ROLE_BAZELTEST,
                 BUILDER_ROLE_BUILD,
                 BUILDER_ROLE_BUILDSTATS,
                 BUILDER_ROLE_CANARY,
                 BUILDER_ROLE_CODESIZE,
                 BUILDER_ROLE_HOUSEKEEPER,
                 BUILDER_ROLE_INFRA,
                 BUILDER_ROLE_PERF,
                 BUILDER_ROLE_TEST,
                 BUILDER_ROLE_UPLOAD)

Definition at line 34 of file builder_name_schema.py.