File: gen_tp_table_headers.py

package info (click to toggle)
perfetto 54.0-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 133,812 kB
  • sloc: cpp: 338,350; python: 74,464; sql: 46,895; ansic: 18,340; javascript: 2,557; java: 2,160; sh: 1,444; yacc: 776; xml: 563; makefile: 226
file content (196 lines) | stat: -rwxr-xr-x 7,156 bytes parent folder | download | duplicates (2)
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
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
#!/usr/bin/env python3
# Copyright (C) 2022 The Android Open Source Project
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#      http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

import argparse
from dataclasses import dataclass
import os
import re
import sys
from typing import Dict
from typing import List
from typing import Set

# Allow importing of root-relative modules.
ROOT_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
sys.path.insert(0, os.path.join(ROOT_DIR))

#pylint: disable=wrong-import-position
from python.generators.trace_processor_table.serialize import serialize_header
from python.generators.trace_processor_table.serialize import serialize_fwd_header
from python.generators.trace_processor_table.util import find_table_deps
from python.generators.trace_processor_table.util import ParsedTable
from python.generators.trace_processor_table.util import parse_tables_from_modules
#pylint: enable=wrong-import-position

# Suffix which replaces the .py extension for all input modules.
OUT_HEADER_SUFFIX = '_py.h'
OUT_FWD_HEADER_SUFFIX = '_fwd.h'


@dataclass
class Header:
  """Represents a Python module which will be converted to a header."""
  tables: List[ParsedTable]


def main():
  """Main function."""
  parser = argparse.ArgumentParser()
  parser.add_argument('--inputs', required=True, nargs='*')
  parser.add_argument('--gen-dir', required=True)
  parser.add_argument('--relative-input-dir')
  parser.add_argument('--import-prefix', default='')
  args = parser.parse_args()

  def get_relin_path(in_path: str):
    if not args.relative_input_dir:
      return in_path
    return os.path.relpath(in_path, args.relative_input_dir)

  def get_relout_path(in_path: str):
    return os.path.splitext(in_path)[0] + OUT_HEADER_SUFFIX

  def get_out_path(in_path: str):
    return os.path.join(args.gen_dir, get_relout_path(in_path))

  def get_header_path(in_path: str):
    return os.path.join(args.import_prefix, get_relout_path(in_path))

  def get_relin_path_from_module_path(module_path: str):
    return module_path[module_path.rfind(os.sep + 'src') + 1:]

  def to_module_name(module_input: str):
    module = get_relin_path(module_input)
    if module.endswith('.py'):
      module = module[:-3]
    # On Windows the path can contain '/' or os.sep, depending on how this
    # script is executed. So we need to replace both.
    return module.replace('/', '.').replace(os.sep, '.')

  modules = [to_module_name(i) for i in args.inputs]
  headers: Dict[str, Header] = {}
  for table in parse_tables_from_modules(modules):
    input_path = get_relin_path_from_module_path(table.table.python_module)
    header = headers.get(input_path, Header([]))
    header.tables.append(table)
    headers[input_path] = header

  # Collect all tables and fwd header paths for generating all_tables_fwd.h
  all_tables: List[ParsedTable] = []
  all_fwd_header_paths: List[str] = []
  all_fwd_relout_paths: List[str] = []

  for in_path, header in headers.items():
    out_path = get_out_path(in_path)
    relout_path = get_relout_path(in_path)

    # Find all headers depended on by this table. These will be #include-ed when
    # generating the header file below so ensure we remove ourself.
    header_relout_deps: Set[str] = set()
    for table in header.tables:
      header_relout_deps = header_relout_deps.union([
          get_header_path(get_relin_path_from_module_path(c.python_module))
          for c in find_table_deps(table.table)
      ])
    header_relout_deps.discard(relout_path)

    ifdef_guard = re.sub(r'[^a-zA-Z0-9_-]', '_', relout_path).upper() + '_'

    # Compute forward header path
    fwd_out_path = out_path.replace(OUT_HEADER_SUFFIX, OUT_FWD_HEADER_SUFFIX)
    fwd_relout_path = relout_path.replace(OUT_HEADER_SUFFIX,
                                          OUT_FWD_HEADER_SUFFIX)
    fwd_header_path = get_header_path(in_path).replace(OUT_HEADER_SUFFIX,
                                                       OUT_FWD_HEADER_SUFFIX)
    fwd_ifdef_guard = re.sub(r'[^a-zA-Z0-9_-]', '_',
                             fwd_relout_path).upper() + '_'

    # Collect for all_tables header
    all_tables.extend(header.tables)
    all_fwd_header_paths.append(fwd_header_path)
    all_fwd_relout_paths.append(fwd_relout_path)

    # For fwd header, only need includes of other fwd headers
    fwd_deps = [
        p.replace(OUT_HEADER_SUFFIX, OUT_FWD_HEADER_SUFFIX)
        for p in sorted(header_relout_deps)
    ]

    # Generate the forward declaration header first
    with open(fwd_out_path, 'w', encoding='utf8') as out:
      out.write(serialize_fwd_header(fwd_ifdef_guard, header.tables, fwd_deps))
      out.write('\n')

    # Generate the full header (includes the fwd header)
    with open(out_path, 'w', encoding='utf8') as out:
      out.write(
          serialize_header(ifdef_guard, header.tables,
                           sorted(header_relout_deps), fwd_header_path))
      out.write('\n')

  # Generate the combined all_tables_fwd.h header
  if all_fwd_header_paths:
    # Use relout path (without import_prefix) for output directory, consistent
    # with how other headers compute their output paths.
    first_fwd_relout = all_fwd_relout_paths[0]
    out_dir = os.path.dirname(first_fwd_relout)
    generate_all_tables_header(args, all_tables, all_fwd_header_paths, out_dir)


def generate_all_tables_header(args, all_tables: List[ParsedTable],
                               fwd_header_paths: List[str], out_dir: str):
  """Generates an all_tables_fwd.h header with variant and count only."""
  rel_path = os.path.join(out_dir, 'all_tables_fwd.h')
  out_path = os.path.join(args.gen_dir, rel_path)
  ifdef_guard = re.sub(r'[^a-zA-Z0-9_-]', '_', rel_path).upper() + '_'

  # Replace the backslash with forward slash when building on Windows.
  # Caused b/327985369 without the replace.
  includes = '\n'.join([
      f'#include "{p}"  // IWYU pragma: export'
      for p in sorted(fwd_header_paths)
  ]).replace("\\", "/")
  variant_entries = ', '.join([t.table.class_name for t in all_tables])

  content = f'''\
#ifndef {ifdef_guard}
#define {ifdef_guard}

#include <cstddef>
#include <variant>

#include "perfetto/ext/base/variant.h"

{includes}

namespace perfetto::trace_processor::tables {{

// Variant of all table types (use base::variant_index<AllTables, T>() to get index)
using AllTables = std::variant<{variant_entries}>;

// Count of all tables
inline constexpr size_t kTableCount = std::variant_size_v<AllTables>;

}}  // namespace perfetto::trace_processor::tables

#endif  // {ifdef_guard}
'''

  with open(out_path, 'w', encoding='utf8') as out:
    out.write(content)


if __name__ == '__main__':
  sys.exit(main())