pogrep

Searches for string in po files. popgrep supports various GNU grep options to ease its use.

Pogrep is part of poutils!

Poutils (.po utils) is a metapackage to easily install useful Python tools to use with po files and pogrep is a part of it! Go check out Poutils to discover the other tools!

Examples

Print usage: pogrep --help

Find how 'flavors' has already been translated: search recursively in the current directory, show the names of the matching files, excluding the venv and the locales directories which are not relevant:

pogrep --recursive --line-number --exclude-dir venv --exclude-dir locales flavor

Search the word 'typo' in traductions, but not in sources:

pogrep --recursive --translation --no-source --word-regexp typo

Blame usage of 'allogène' in traductions:

pogrep --recursive --ignore-case --blame allogène

Searching in Debian manpages

To search for a translation in the Debian manpages translations:

$ git clone https://salsa.debian.org/manpages-l10n-team/manpages-l10n
$ pogrep -r 'new pipe buffer' manpages-l10n-team/po/fr/
╒══════════════════════════════════════╤══════════════════════════════════════╕
│ Make the new pipe buffer allocation. │ Allocation du tampon pour le nouveau │
│                                      │ tube.                                │
├──────────────────────────────────────┼──────────────────────────────────────┤
│ Before Linux 4.9, bugs similar to    │ Avant Linux 4.9, des bogues          │
│ points (1) and (3) could also occur  │ similaires aux points (1) et (3)     │
│ when the kernel allocated memory for │ pourraient se produire quand le      │
│ a new pipe buffer; that is, when     │ noyau alloue de la mémoire pour le   │
│ calling B<pipe>(2)  and when opening │ nouveau tampon de tube, c’est-à-dire │
│ a previously unopened FIFO.          │ lors de l’appel B<pipe>(2) et lors   │
│                                      │ de l’ouverture d’une nouvelle FIFO   │
│                                      │ précédemment non ouverte.            │
╘══════════════════════════════════════╧══════════════════════════════════════╛

Contributing

Please test your contribution using tox -p auto.