Installation guide¶
Requirements¶
polib requires python 2.7 or higher.
Installing polib¶
There are several ways to install polib:
Automatically, via a package manager.
Manually, by downloading a copy of the release package and installing it yourself.
Manually, by performing a Mercurial checkout of the latest code.
Automatic installation via a package manager¶
Several automatic package-installation tools are available for Python; the most popular are pip and easy_install . Either can be used to install polib.
Using pip, type:
pip install polib
Using easy_install, type:
easy_install polib
It is also possible that your operating system distributor provides a packaged version of polib. Consult your operating system’s package list for details, but be aware that third-party distributions may be providing older versions of polib, and so you should consult the documentation which comes with your operating system’s package.
Manual installation from a downloaded package¶
If you prefer not to use an automated package installer, you can download a copy of polib and install it manually. The latest release package can be downloaded from polib’s page on the Python Package Index.
Once you’ve downloaded the package, unpack it, this will create the directory
polib-X-Y-Z, which contains the setup.py installation script.
From a command line in that directory, type:
python setup.py install
Note
On some systems you may need to execute this with administrative
privileges (e.g., sudo python setup.py install).
Manual installation from a Git checkout¶
If you’d like to try out the latest in-development code, you can obtain it from the polib repository, which is hosted at Github and uses Git for version control.
To obtain the latest code and documentation, you’ll need to have Git installed, at which point you can type:
git clone https://github.com/izimobil/polib/
This will create a copy of the polib Git repository on your computer;
you can then add the polib.py file to your Python import path, or use the
setup.py script to install as a package.