pogrep/README.md

2.8 KiB
Raw Permalink Blame History

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, cest-à-dire │
│ a previously unopened FIFO.          │ lors de lappel B<pipe>(2) et lors   │
│                                      │ de louverture dune nouvelle FIFO   │
│                                      │ précédemment non ouverte.            │
╘══════════════════════════════════════╧══════════════════════════════════════╛

Contributing

Please test your contribution using tox -p auto.