Overview
Atlassian Sourcetree is a free Git and Mercurial client for Windows.
Atlassian Sourcetree is a free Git and Mercurial client for Mac.
polib
Introduction
polib is a library to manipulate, create, modify gettext files (pot, po and mo files). You can load existing files, iterate through it's entries, add, modify entries, comments or metadata, etc... or create new po files from scratch.
polib is pretty stable now and is used by many opensource projects.
Installation
Note: chances are that polib is already packaged for your linux/bsd system, if so, we recommend you use your OS package system, if not then choose a method below:
Installing latest polib version with setuptools
$ easy_install polib
Installing latest polib version with pip
$ pip install polib
Installing latest polib version from source tarball
$ tar xzfv polib-x.y.z.tar.gz $ cd polib-x.y.z $ python setup build $ sudo python setup.py install
Installing the polib development version
Note: this is not recommended in a production environment.
$ hg clone http://bitbucket.org/izi/polib/ $ cd polib $ python setup build $ sudo python setup.py install
Basic usage example
>>> import polib >>> # load an existing po file >>> po = polib.pofile('tests/test_utf8.po') >>> for entry in po: print entry.msgid, entry.msgstr >>> # add an entry >>> entry = polib.POEntry(msgid='Welcome', msgstr='Bienvenue') >>> entry.occurrences = [('welcome.py', '12'), ('anotherfile.py', '34')] >>> po.append(entry) >>> # save our modified po file >>> po.save() >>> # compile mo file >>> po.save_as_mofile('tests/test_utf8.mo')
Documentation
A tutorial is available and you can also browse the complete api documentation.
Development
Bugtracker, wiki and mercurial repository can be found at the project's page. New releases are also published at the cheeseshop.
Credits
Author: David Jean Louis.