pre-commit hooks for PO files
Project description
pre-commit-po-hooks
Hooks for pre-commit useful working with PO files.
Example configuration
- repo: https://github.com/mondeja/pre-commit-po-hooks
rev: v1.5.0
hooks:
- id: obsolete-messages
- id: untranslated-messages
- id: remove-django-translators
- id: standard-metadata
Hooks
obsolete-messages
Checks for obsolete messages printing their line numbers if found.
untranslated-messages
Checks for untranslated messages printing their line numbers if found.
Parameters
-m/--min
: Minimum number of messages that must be translated in each file to pass this check. Can be defined as a percentage of the messages translated appending a character%
at the end of the value.
lreplace-extracted-comments
Replaces a matching string at the beginning of extracted comments.
Parameters
-m/--match "STRING"
: Matching string to be replaced.-r/--replacement "STRING"
: Replacement for the match at the beginning of the extracted comment. If you want to remove the matching beginning you can pass an empty string""
.-d/--dry-run
: Don't do the replacements, only writes to stderr the locations of the extracted comments to be replaced.
remove-django-translators
Same as lreplace-extracted-comments
passing --match "Translators: " --replacement ""
. Useful to remove the string
prepended by Django extracting messages with xgettext (see more about this
problem in django-rosetta#245).
check-metadata
Check that metadata fields matches a set of regular expressions.
Parameters
-h/--header HEADER
: Header name to match in metadata. This argument can be passed multiple times, but after each-h/--header
argument must be a-v/--value
that indicates the regular expression for that header.-v/--value REGEX
: Can be passed multiple times. Indicates the regular expression that the last header passed in the argument-h/--header
must match in the checked PO files.-n/--no-metadata
: When this option is passed, the hook instead checks that there is no metadata in the files, so it will exit with code 1 if some metadata is found in a file or 0 if there is no metadata in any files.-r/--remove/--remove-metadata
: When this option is passed the metadata will be removed from the files instead of being trated as a lint error.
standard-metadata
Check that the metadata of your PO files fits some standard requirements based on the next regular expressions:
Project-Id-Version
:\d+\.\d+\.\d
Report-Msgid-Bugs-To
:.+\s<.+@.+\..+>
Last-Translator
:.+\s<.+@.+\..+>
Language-Team
:.+\s<.+@.+\..+>
Language
:\w\w_?\w?\w?(@\w+)?
Content-Type
:text/plain; charset=[0-9a-zA-Z\-]+
Content-Transfer-Encoding
:\d+bits?
If you need to replace some fields with other regular expressions, you can do
it passing the -h
and -v
arguments of the
check-metadata
hook.
For example, if your version includes the character v
at the beginning:
-h "Project-Id-Version" -v "v\d+\.\d+\.\d"
no-metadata
It will check if PO files has metadata. If has metadata, it will fail the check returning exit code 1.
Parameters
-r/--remove/--remove-metadata
: When this option is passed the metadata will be removed from the files instead of being treated as a lint error.
max-messages
Define a maximum number of entries for each PO file. Pass an interger in the first argument:
- id: max-messages
args:
- "5000"
Parameters
- Maximum number of messages allowed for each PO file.
min-translated
Define a minimum number of files that must be translated in order to pass.
Pass a float or a value ending with %
character if you wan to compare
against the percentage of translated files:
- id: min-translated
args:
- "95%"
Parameters
- Minimum number or percentage of messages which must be translated in each PO file.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pre_commit_po_hooks-1.5.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3ae45814f6b86d7ee0aca347b629122c3a4ef18c01e29eb9d94d312a6e84ae8a |
|
MD5 | 1fecde91c5e962f8f5368a4f15d633e5 |
|
BLAKE2b-256 | 949b4563813bbd17fb3c7433d7efe04a61769f3faff165dd0da4afe4e32a9cc9 |
Hashes for pre_commit_po_hooks-1.5.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c8137990ac49decf2ec1cd745a1dfb47a469d623907ddb23d2227d43c6aea11e |
|
MD5 | 48be1acf29b3f0412c86e364535c8a77 |
|
BLAKE2b-256 | 7a31fafb940764046848b86ed73b7e9444840dd8dd3732c598f70468de58df41 |