OS Manuals

/opt/chainguard/gftools/bin/gftools-qa

Google Fonts Tools: build, fix, check and package fonts for the Google Fonts library

From gftools 0.10.8-r0 (os), captured 2026-11-05 by running gftools-qa --help (exit 0). permalink

usage: gftools-qa [-h] (-f FONTS [FONTS ...] | -pr PULL_REQUEST | -gh GITHUB_DIR |
                  -gf GOOGLEFONTS | -ar ARCHIVE) [-fb FONTS_BEFORE [FONTS_BEFORE ...] |
                  -prb PULL_REQUEST_BEFORE | -ghb GITHUB_DIR_BEFORE | -arb ARCHIVE_BEFORE | -gfb]
                  [-a] [--diffenator] [--proof] [--render] [--fontspector] [--diffbrowsers]
                  [--interpolations] [-re FILTER_FONTS] [-o OUT] [-ogh] [--out-url OUT_URL]
                  [--rust] [--extra-fontspector-args EXTRA_FONTSPECTOR_ARGS] [--imgs] [--version]

Check a font family using Google Fonts QA tools.

Examples:
Check a local family against the same family hosted on Google Fonts:
`gftools qa -f [fonts.ttf] -gfb -a -o qa`

Check a local family against another local family and generate reports
for Font Diffenator only:
`gftools qa -f [fonts_a.ttf] -fb [fonts_b.ttf] --diffenator -o qa`

Compare a pull request against the same family hosted on Google Fonts:
`gftools qa -pr www.github.com/user/repo/pull/1 -gfb -a -o qa`

Compare a github folder of fonts against the same family hosted on Google
Fonts:
`gftools qa -gh www.github.com/user/repo/tree/fonts/ttf -gfb -a -o qa`

options:
  -h, --help            show this help message and exit
  -re, --filter-fonts FILTER_FONTS
                        Filter fonts by regex
  -o, --out OUT         Output path for check results
  -ogh, --out-github    Post report data to either the pull request as a comment open a new issue.
                        This can only be used if fonts have been fetched from either a pull
                        request or github dir.
  --out-url OUT_URL     Post report data to a github pr. This can be used with any font fetching
                        method.
  --rust                Use Rust tooling
  --imgs                Gen images using Selenium
  --version             show program's version number and exit

Fonts to qa:
  -f, --fonts FONTS [FONTS ...]
                        Paths to fonts
  -pr, --pull-request PULL_REQUEST
                        Get fonts from a Github pull request
  -gh, --github-dir GITHUB_DIR
                        Get fonts from a Github directory
  -gf, --googlefonts GOOGLEFONTS
                        Get fonts from Google Fonts
  -ar, --archive ARCHIVE
                        Get fonts from a zip file URL

Fonts before input:
  -fb, --fonts-before FONTS_BEFORE [FONTS_BEFORE ...]
                        Paths to previous fonts
  -prb, --pull-request-before PULL_REQUEST_BEFORE
                        Get previous fonts from a Github pull request
  -ghb, --github-dir-before GITHUB_DIR_BEFORE
                        Get previous fonts from a Github dir
  -arb, --archive-before ARCHIVE_BEFORE
                        Get previous fonts from a zip file URL
  -gfb, --googlefonts-before
                        Get previous fonts from Google Fonts

QA checks:
  -a, --auto-qa         Check fonts against against the same fonts hosted on Google Fonts
  --diffenator          Run Fontdiffenator
  --proof               Run HTML proofs
  --render              Run diffbrowsers if fonts_before exist, otherwise run proof
  --fontspector         Run FontBakery
  --diffbrowsers        Run Diffbrowsers
  --interpolations      Run interpolation checker
  --extra-fontspector-args EXTRA_FONTSPECTOR_ARGS
                        Additional arguments to Fontspector
Options (24)
OptionDescriptionSource
-h, --helpshow this help message and exithelp
-re, --filter-fonts FILTER_FONTSFilter fonts by regexhelp
-o, --out OUTOutput path for check resultshelp
-ogh, --out-githubPost report data to either the pull request as a comment open a new issue.help
--out-url OUT_URLPost report data to a github pr.help
--rustUse Rust toolinghelp
--imgsGen images using Seleniumhelp
--versionshow program's version number and exithelp
-pr, --pull-request PULL_REQUESTGet fonts from a Github pull requesthelp
-gh, --github-dir GITHUB_DIRGet fonts from a Github directoryhelp
-gf, --googlefonts GOOGLEFONTSGet fonts from Google Fontshelp
-ar, --archive ARCHIVEGet fonts from a zip file URLhelp
-prb, --pull-request-before PULL_REQUEST_BEFOREGet previous fonts from a Github pull requesthelp
-ghb, --github-dir-before GITHUB_DIR_BEFOREGet previous fonts from a Github dirhelp
-arb, --archive-before ARCHIVE_BEFOREGet previous fonts from a zip file URLhelp
-gfb, --googlefonts-beforeGet previous fonts from Google Fontshelp
-a, --auto-qaCheck fonts against against the same fonts hosted on Google Fontshelp
--diffenatorRun Fontdiffenatorhelp
--proofRun HTML proofshelp
--renderRun diffbrowsers if fonts_before exist, otherwise run proofhelp
--fontspectorRun FontBakeryhelp
--diffbrowsersRun Diffbrowsershelp
--interpolationsRun interpolation checkerhelp
--extra-fontspector-args EXTRA_FONTSPECTOR_ARGSAdditional arguments to Fontspectorhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.