summaryrefslogtreecommitdiffstats
path: root/toolkit/components/telemetry/build_scripts/gen_histogram_enum.py
blob: 8d83e760c5266496dbebffaa666a3c12b4076e16 (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
# This Source Code Form is subject to the terms of the Mozilla Public
# License, v. 2.0. If a copy of the MPL was not distributed with this
# file, You can obtain one at http://mozilla.org/MPL/2.0/.

# Write out a C++ enum definition whose members are the names of
# histograms as well as the following other members:
#
#   - HistogramCount
#
# The histograms are defined in files provided as command-line arguments.

import sys

import buildconfig
from mozparsers import parse_histograms
from mozparsers.shared_telemetry_utils import ParserError

banner = """/* This file is auto-generated, see gen_histogram_enum.py.  */
"""

header = """
#ifndef mozilla_TelemetryHistogramEnums_h
#define mozilla_TelemetryHistogramEnums_h

#include <cstdint>
#include <type_traits>

namespace mozilla {
namespace Telemetry {
"""

footer = """
} // namespace mozilla
} // namespace Telemetry
#endif // mozilla_TelemetryHistogramEnums_h"""


def main(output, *filenames):
    # Print header.
    print(banner, file=output)
    print(header, file=output)

    # Load the histograms.
    try:
        all_histograms = list(parse_histograms.from_files(filenames))
    except ParserError as ex:
        print("\nError processing histograms:\n" + str(ex) + "\n")
        sys.exit(1)

    # Print the histogram enums.
    print("enum HistogramID : uint32_t {", file=output)
    for histogram in all_histograms:
        if histogram.record_on_os(buildconfig.substs["OS_TARGET"]):
            print("  %s," % histogram.name(), file=output)

    print("  HistogramCount,", file=output)

    print("};", file=output)

    # Write categorical label enums.
    categorical = filter(lambda h: h.kind() == "categorical", all_histograms)
    categorical = filter(
        lambda h: h.record_on_os(buildconfig.substs["OS_TARGET"]), categorical
    )
    enums = [("LABELS_" + h.name(), h.labels(), h.name()) for h in categorical]
    for name, labels, _ in enums:
        print("\nenum class %s : uint32_t {" % name, file=output)
        print("  %s" % ",\n  ".join(labels), file=output)
        print("};", file=output)

    print(
        "\ntemplate<class T> struct IsCategoricalLabelEnum : std::false_type {};",
        file=output,
    )
    for name, _, _ in enums:
        print(
            "template<> struct IsCategoricalLabelEnum<%s> : std::true_type {};" % name,
            file=output,
        )

    print("\ntemplate<class T> struct CategoricalLabelId {};", file=output)
    for name, _, id in enums:
        print(
            "template<> struct CategoricalLabelId<%s> : "
            "std::integral_constant<uint32_t, %s> {};" % (name, id),
            file=output,
        )

    # Footer.
    print(footer, file=output)


if __name__ == "__main__":
    main(sys.stdout, *sys.argv[1:])