First, be sure to use a verion of Python 3 where GTK and GObjects works in your system.
For instance, under Ubuntu 17.04, PyGtk and
python3-gi does not work well if the default
python 3 interpreter is forced to Python 3.6.
|Operating System||Recommended Python version||Notes|
|Ubuntu 14.04 LTS||Python 3.4 (UNTESTED)|
|Ubuntu 16.04 LTS||Python 3.5 (TESTED)|
|Ubuntu 17.04||Python 3.5 (TESTED)|
|Ubuntu 17.10||Python 3.6 (TESTED)||Quick Open disabled (#1230)|
Validate your code¶
We are strict on code styling, with pep8 and pylint running automatically in travis in order to reject badly shaped patches. Please use the following command to validate all python files:
$ make style # fix the style of python files $ make check # static code analysis $ make test # unit test campaign $ make dists # make distribution packages
Update all translation files:
$ make update-po
Install the translations files:
$ sudo make install-locale
Then use your favorite po editor, such as
Start Guake with a different locale (locales should be installed):
$ LC_ALL=fr_FR.UTF8 make run
Update the NEWS file using the followng command:
ChangeLog files is not maintained but instead automatically generated by PBR when
building the distribution packages.
Same goes for the ChangeLog file.
Versioning is automatically done using git tags. When a semver tag is pushed, a new version is automatically created by PBR.
PBR also has some magic to generate the version automatically from
sem-ver tag found in the
commit message. See the
Travis automatically check pull requests are compiling and check for code style.
Status of the master branch: https://travis-ci.org/Guake/guake.png?branch=master
The Travis job also pushes new release of Guake to Pypi.