This script runs extractor.py to extract Network Traffic Annotations from chromium source code, collects and summarizes its outputs, and performs tests and maintenance.
docs/network_traffic_annotations.md for an introduction to network traffic annotations.
vpython3 ./tools/traffic_annotation/scripts/auditor/auditor.py [OPTIONS]... [path_filter]...
Extracts network traffic annotations from source files, tests them, and updates
tools/traffic_annotation/summary/annotations.xml. If path filter(s) are specified, only those directories of the source will be analyzed. Run
./tools/traffic_annotation/scripts/auditor/auditor.py --help for options.
vpython3 ./tools/traffic_annotation/scripts/auditor/auditor.py --build-path=out/Debug
Before running, you need to build the
chrome target, and pass the build path to the executable.
If there are files, paths, or specific functions that need to be exempted from all or some tests, they can be added to the
safe_list.txt. The file is comma separated, specifying the safe lists based on
Use * as wildcard for zero or more characters when specifying file paths.
Here are the exception types:
all: Files and paths in this category are exempted from all tests.
missing: Files and paths in this category can use the MISSING_TRAFFIC_ANNOTATION tag.
mutable_tag: Files and paths in this category can use the CreateMutableNetworkTrafficAnnotationTag() function.
test_annotation: Files and paths in this category can use the TRAFFIC_ANNOTATION_FOR_TESTS tag.