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
|
# Clang Templated Container Rewriter Tool
This tool generates cross-translation unit rewrites converting containers of pointer fields CTN<T*> to CTN<raw_ptr<T>> fields.
Example:
```
std::vector<Pointee*> field_;
```
becomes:
```
std::vector<raw_ptr<Pointee>> field_;
```
More details about the tool design can be found here:
https://docs.google.com/document/d/1P8wLVS3xueI4p3EAPO4JJP6d1_zVp5SapQB0EW9iHQI/
## Build
Clang is built using CMake. To run cmake, this script can be used:
```bash
./tools/clang/scripts/build.py \
--without-android \
--without-fuchsia \
--extra-tools rewrite_templated_container_fields
```
The build directory is created into: `third_party/llvm-build/Release+Asserts/`
and you can build it again incrementally using:
```bash
ninja -C third_party/llvm-build/Release+Asserts/ rewrite_templated_container_fields
```
## Run the tests
```bash
./tools/clang/rewrite_templated_container_fields/tests/run_all_tests.py
```
### Troubleshooting
You will need to have the `python` binary reachable from your path to run the
tests. You can route `python3` to just `python` with the following install.
```bash
sudo apt install python-is-python3
```
Finally you need to have a version of libstdc++ installed. If you see errors
like:
```bash
Failed to process deref-expr-actual.cc
tools/clang/rewrite_templated_container_fields/tests/assignment-tests-original.cc:5:10: fatal error: 'vector' file not found
4 | #include <vector>
| ^~~~~~~~
1 error generated.
```
You can install libstdc++ as follows:
```bash
sudo apt install libstdc++-14-dev
```
## Using the tool
The `rewrite-multiple-platforms.sh` scripts first builds the tool, runs tests
and then runs the tool over every configuration in the list of platforms.
```bash
./tools/clang/rewrite_templated_container_fields/rewrite-multiple-platforms.sh
```
|
