webkit-content-filter-validator

Compile JSON rules into a WebKit content filter store to check for syntax errors.

To use, input a file in Apple's JSON content blocker format, either as the first argument or through stdin.

webkit-content-filter-validator will silently return a zero exit code if the file is well-formatted. Otherwise, it will print WebKit's error to stdout and return a nonzero exit code.

Dependencies

webkit-content-filter-validator depends on WebKit WPE.

WebKit WPE is packaged as:

• libwpewebkit-1.0-dev under Ubuntu
• wpewebkit under Arch Linux

Building

Ubuntu 22.04

Run make webkit-content-filter-validator.

Arch Linux

Replace wpe-webkit-1.0 with wpe-webkit-1.1 in the Makefile, then proceed as above.

Docker

docker build -t webkit-content-filter-validator .

Running

Check the usage:

webkit-content-filter-validator --help

Running under Docker

Making input files accessible to the container's filesystem is complicated. The easiest way to pass inputs to the command in the Docker image is through stdin, i.e.:

docker run --rm -i webkit-content-filter-validator < test.json

or,

echo "[{...}]" | docker run --rm -i webkit-content-filter-validator

Developing

Run make compile_flags.txt to setup clangd IDE integration.