lupdate-zig

LUPDATE FOR ZIG

The lupdate-zig program reads from a .zig source file written with libqt6zig and generates a Qt translation source file (.ts) for use with either Qt Linguist and/or Qt's lrelease tools.

Example

For a usage example, see the lupdate example folder.

Building

This can be built from source by running go build while in this directory. The resulting binary will be static by default and named lupdate-zig. There are no external dependencies.

Installation

This can also be fetched and installed by running:

go install github.com/rcalixte/libqt6zig/cmd/lupdate-zig@latest

If successful, this will place the lupdate-zig binary at $GOPATH/bin.

Usage

Valid and supported syntax from the code file(s) containing libqt6zig methods are processed into Qt translation files for use with Qt's internationalization tools.

Comments are supported with similar syntax natively supported by Qt:

// an ignored/private comment

//: a comment for translators

To see the full options that are available, run ./lupdate-zig -h.

Execution design

1. Tokenize and parse valid source file(s).

2. Generate translation contexts based on the Zig code structure.

   i. Example of valid and supported syntax structure¹:

   const txt = qapplication.Translate("Context", "Translated string", allocator);
   const label = qlabel.New3(txt);
   
   const text = qpushbutton.Tr("Translated string", allocator);
   const button = qpushbutton.New3(text);
   

3. Write out the translation file.

[!NOTE] As a workaround, all tr methods use QObject as the translation context.

¹Only raw string and integer parameter types used in valid syntax are supported.