Writes the translations file of every active language, in the order of the source file, so diffs stay small. Only approved translations are written, unless you pass --drafts. A file that does not exist yet is created, and an existing file is replaced.
ct pullnl: wrote locales/nl.json (120/128 translated)
de: up to date (128/128 translated)| Option | Effect |
|---|---|
--drafts | Include translations that are not approved yet |
--fallback | Fill gaps with the source text |
--language de | Limit the pull to one language. Repeat the option for more |
--require-complete 100 | Fail before writing when a language is behind |
--check | Write nothing and exit 1 if a file is out of date |
--tag v1.4.0 | Write the snapshot of a tag instead of a branch |
Require complete translations #
--require-complete takes a percentage from 0 to 100. When a language is less complete, pull fails before it writes anything and names the languages that are behind. Use it in a release job, see Use the CLI in CI.
Check without writing #
--check compares what pull would write with the files on disk. It lists the files that are out of date and exits 1 if there are any. See also ct check, which adds the completeness of each language.
Pull a tag #
With --tag, pull writes the snapshot of a tag instead of a branch. The languages are those of the project, and --require-complete is checked against what the tag holds. A tag never changes, so pulling it again gives the same result. See ct tag.
Needs #
An API key with the projects:read and translations:read scopes, which a Pull only key has. See Pull translations for the route behind it.