57 lines
2.8 KiB
Markdown
57 lines
2.8 KiB
Markdown
# pogrep
|
||
|
||
Searches for string in po files. *popgrep* supports various *GNU grep* options
|
||
to ease its use.
|
||
|
||
|
||
## Pogrep is part of poutils!
|
||
|
||
[Poutils](https://pypi.org/project/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](https://pypi.org/project/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:
|
||
|
||
```text
|
||
$ 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`.
|