summaryrefslogtreecommitdiff
path: root/chromium/tools/metrics/structured/model.py
blob: 2d90bf20c6773c13770348f6114221b65f4ad020 (plain)
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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
# Copyright 2019 The Chromium Authors. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.

import os
import sys

sys.path.append(os.path.join(os.path.dirname(__file__), '..', 'common'))
import models

# Helpers

# A key for sorting XML nodes by the value of |attribute|.
_LOWERCASE_FN = lambda attribute: (lambda node: node.get(attribute).lower())
# A constant function as the sorting key for nodes whose orderings should be
# kept as given in the XML file within their parent node.
_KEEP_ORDER = lambda node: 1

# Model definitions

_OBSOLETE_TYPE = models.TextNodeType('obsolete')
_OWNER_TYPE = models.TextNodeType('owner', single_line=True)
_SUMMARY_TYPE = models.TextNodeType('summary')

_METRIC_TYPE =  models.ObjectNodeType(
    'metric',
    attributes=[
      ('name', unicode, r'^[A-Za-z0-9_.]+$'),
      ('kind', unicode, r'^(?i)(|hashed-string|int)$'),
    ],
    alphabetization=[
        (_OBSOLETE_TYPE.tag, lambda _: 1),
        (_SUMMARY_TYPE.tag, lambda _: 2),
    ],
    children=[
        models.ChildType(_OBSOLETE_TYPE.tag, _OBSOLETE_TYPE, multiple=False),
        models.ChildType(_OWNER_TYPE.tag, _OWNER_TYPE, multiple=True),
        models.ChildType(_SUMMARY_TYPE.tag, _SUMMARY_TYPE, multiple=False),
    ])

_EVENT_TYPE = models.ObjectNodeType(
    'event',
    attributes=[
        ('name', unicode, r'^[A-Z][A-Za-z0-9.]*$'),
        ('project', unicode, r'^([A-Z][A-Za-z0-9.]*)?$'),
    ],
    alphabetization=[
        (_OBSOLETE_TYPE.tag, lambda _: 1),
        (_OWNER_TYPE.tag, lambda _: 2),
        (_SUMMARY_TYPE.tag, lambda _: 3),
        (_METRIC_TYPE.tag, _LOWERCASE_FN('name')),
    ],
    extra_newlines=(1, 1, 1),
    children=[
        models.ChildType(_OBSOLETE_TYPE.tag, _OBSOLETE_TYPE, multiple=False),
        models.ChildType(_OWNER_TYPE.tag, _OWNER_TYPE, multiple=True),
        models.ChildType(_SUMMARY_TYPE.tag, _SUMMARY_TYPE, multiple=False),
        models.ChildType(_METRIC_TYPE.tag, _METRIC_TYPE, multiple=True),
    ])

_EVENTS_TYPE = models.ObjectNodeType(
    'events',
    alphabetization=[(_EVENT_TYPE.tag, _LOWERCASE_FN('name'))],
    extra_newlines=(2, 1, 1),
    indent=False,
    children=[
        models.ChildType(_EVENT_TYPE.tag, _EVENT_TYPE, multiple=True),
    ])

_PROJECT_TYPE = models.ObjectNodeType(
    'project',
    attributes=[
        ('name', unicode, r'^[A-Z][A-Za-z0-9.]*$'),
    ],
    alphabetization=[
        (_OBSOLETE_TYPE.tag, lambda _: 1),
        (_OWNER_TYPE.tag, lambda _: 2),
        (_SUMMARY_TYPE.tag, lambda _: 3),
    ],
    extra_newlines=(1, 1, 1),
    children=[
        models.ChildType(_OBSOLETE_TYPE.tag, _OBSOLETE_TYPE, multiple=False),
        models.ChildType(_OWNER_TYPE.tag, _OWNER_TYPE, multiple=True),
        models.ChildType(_SUMMARY_TYPE.tag, _SUMMARY_TYPE, multiple=False),
    ])

_PROJECTS_TYPE = models.ObjectNodeType(
    'projects',
    alphabetization=[(_PROJECT_TYPE.tag, _LOWERCASE_FN('name'))],
    extra_newlines=(2, 1, 1),
    indent=False,
    children=[
        models.ChildType(_PROJECT_TYPE.tag, _PROJECT_TYPE, multiple=True),
    ])

CONFIGURATION_TYPE = models.ObjectNodeType(
    'structured-metrics',
    alphabetization=[
        (_EVENTS_TYPE.tag, lambda _: 1),
        (_PROJECTS_TYPE.tag, lambda _: 2),
    ],
    extra_newlines=(2, 1, 1),
    indent=False,
    children=[
        models.ChildType(_EVENTS_TYPE.tag, _EVENTS_TYPE, multiple=False),
        models.ChildType(_PROJECTS_TYPE.tag, _PROJECTS_TYPE, multiple=False),
    ])

XML_TYPE = models.DocumentType(CONFIGURATION_TYPE)

def PrettifyXML(original_xml):
  """Parses the original xml and return a pretty printed version.

  Args:
    original_xml: A string containing the original xml file contents.

  Returns:
    A pretty-printed xml string, or None if the config contains errors.
  """
  config = XML_TYPE.Parse(original_xml)
  return XML_TYPE.PrettyPrint(config)