Pofile to JSON conversion without pain.
Project description
📦 potojson
Pofile to JSON conversion without pain.
Installation
pip install potojson
Documentation
API
# pofile_to_json(content, fallback_to_msgid=False, fuzzy=False, pretty=False, indent=2, language=None, plural_forms=None, as_dict=False) ⇒ str
Converts a pofile passed as string or filepath and returns a JSON formatted output. Given this pofile:
#
#, fuzzy
msgid ""
msgstr ""
"Language: es\n"
"Plural-Forms: nplurals=2; plural=n != 1;\n"
msgid "msgid"
msgstr "msgstr"
msgctxt "msgctxt"
msgid "msgid"
msgstr "msgstr"
msgid "msgid"
msgid_plural "msgid_plural"
msgstr[0] "msgstr[0]"
msgstr[1] "msgstr[1]"
msgctxt "msgctxt"
msgid "msgid"
msgid_plural "msgid_plural"
msgstr[0] "msgstr[0]"
msgstr[1] "msgstr[1]"
... the output will be:
{
"": {
"language": "es",
"plural-forms": "nplurals=2; plural=n != 1;",
},
"msgid": "msgstr",
"msgctxt": {
"msgid": "msgstr",
},
"msgid": ["msgstr[0]", "msgstr[1]"],
"msgctxt": {
"msgid": ["msgstr[0]", "msgstr[1]"],
}
}
This output can be customized tuning the parameters of the function:
- content (str) Content or filepath of the pofile to convert.
- fallback_to_msgid (bool) Use msgid if translation is missing.
- fuzzy (bool) Include fuzzy messages.
- pretty (bool) Pretty-print JSON output.
- indent (int) Number of spaces for indentation used pretty-printing JSON
output. Only takes effect if
pretty is True
. - language (str) Language for the translations. Will be inserted in the empty key of the JSON output. If not provided and the passed pofile includes the "Language" header, will be extracted from it.
- plural_forms (str) Plural forms for the language of the translations. Will be inserted in the empty key of the JSON output. If not provided and the passed pofile includes the "Plural-Forms" header, will be extracted from it.
- as_dict (bool) Returns the output as a Python dictionary.
- sort_keys (bool) Sort dictionary by key. Combined with
as_dict
parameter, returns an instance of :py:class:collections.OrderedDict
.
CLI
usage: potojson [-h] [-v] [-m] [-f] [-p] [-i N] [-l LANGUAGE] [-s PLURAL_FORMS] PO_FILEPATH_OR_CONTENT
Pofile to JSON conversion without pain.
positional arguments:
PO_FILEPATH_OR_CONTENT
Path to pofile or pofile content as a string. If not provided, will be read from STDIN.
optional arguments:
-h, --help show this help message and exit
-v, --version Show program version number and exit.
-m, --fallback-to-msgid
Use msgid if translation is missing.
-f, --fuzzy Include fuzzy messages.
-p, --pretty Pretty-print JSON output.
-i N, --indent N Number of spaces for indentation used pretty-printing JSON output. Only takes effect passing '--fuzzy' option.
-l LANGUAGE, --language LANGUAGE
Language for the translations. Will be inserted in the empty key of the JSON output. If not provided and the passed pofile includes the "Language" header, will be extracted from it.
-s PLURAL_FORMS, --plural-forms PLURAL_FORMS
Plural forms for the language of the translations. Will be inserted in the empty key of the JSON output. If not provided and the passed pofile includes the "Plural-Forms" header, will be extracted from it.
-k, --sort-keys Sort JSON output by key.
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
potojson-0.0.9.tar.gz
(8.6 kB
view hashes)
Built Distribution
Close
Hashes for potojson-0.0.9-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3d7128ae44362078f0428c0bd3dd22425faa9631224660c0cf497de867e40fcd |
|
MD5 | 525ef9324f7fcea6c065c663c086242a |
|
BLAKE2b-256 | eac056edbb66cc7a05a2e2597207011045ebebfea68422c89b9af8ffa5dbec46 |