Currently there are no binary packages available for installing GeanyPy so it must be installed from source. The following instructions will describe how to do this.
Getting the Source¶
The best way currently to get GeanyPy is to check it out from it’s repository on GitHub.com. You can clone GeanyPy’s master branch by issuing the following command in a directory where you want to store its source code:
$ git clone git://github.com/codebrainz/geanypy.git $ cd geanypy
$ cd ~/src $ wget -O geanypy.tar.gz https://github.com/codebrainz/geanypy/tarball/master $ tar xf geanypy.tar.gz $ cd codebrainz-geanypy-*
The first method using Git is the best, since it allows you to update your copy of GeanyPy quite easily and also makes it easier to contribute back to the GeanyPy project if you want to.
Dependencies and where to get them¶
Of course depending on what operating system and distribution you’re using, getting setup for this process may vary wildly. At present, the following dependencies are required to compile GeanyPy:
GCC, Autotools, and all the usual build tools¶
For example on Debian (Ubuntu, Mint, etc.) do:
$ apt-get install build-essential
Or on Fedora, something like this should do:
$ yum groupinstall "Development Tools" "Legacy Software Development"
The latest development version of Geany (0.21+)¶
Since GeanyPy is wrapping the current development version of Geany, to use it you are required to use that version of Geany. Until the next Geany release, you must either checkout the source code from Geany’s Subversion repository or Git mirror or you can get one of the Nightly builds if you’d rather not compile it yourself.
For more information on installing Geany, please refer to Geany’s excellent manual
Grabbing the dependencies for Geany on a Debian-based disto could be similar to this:
$ apt-get install libgtk2.0-0 libgtk2.0-0-dev
Or you might even have better luck with:
$ apt-get build-dep geany
A quick session for installing Geany on a Debian-based distro might look something like this:
$ cd ~/src $ git clone http://git.geany.org/git/geany $ cd geany $ ./autogen.sh $ ./configure $ make $ make install # possibly as root
By default, Geany will install into /usr/local so if you want to install it somewhere else, for example /opt/geany, then you would run the configure command above with the prefix argument, like:
$ ./configure --prefix=/opt/geany
It’s important when installing GeanyPy later that you configure it with the same prefix where Geany is installed, otherwise Geany won’t find the GeanyPy plugin.
Python 2.X and development files¶
As GeanPy makes use of Python’s C API to gain access to Geany’s C plugin API, both Python and the development files are required to compile GeanyPy. In theory, any Python version >= 2.6 and < 3.0 should be compatible with GeanyPy. You can download Python from its website or you can install the required packages using your distro’s package manager, for example with Debian-based distros, run this:
$ apt-get install python python-dev
Note: Python 3.0+ is not supported yet, although at some point in the future, there are plans support it.
PyGTK and development files¶
Since Geany uses GTK+ as it’s UI toolkit, GeanyPy uses PyGTK to interact with Geany’s UI. You can either download PyGTK from it’s website or you can install it with your system’s pacakge manager, for example in Debian distros:
$ apt-get install python-gtk2 python-gtk2-dev
Note: Although PyGTK is all but deprecated (or is completely deprecated?) in favour of the newer and shinier PyGobject/GObject-introspection, it is still used in new code in GeanyPy due to lack of documentation and pacakge support for the newer stuff.
One fell swoop¶
If you’re running a Debian-based distro, you should be able to install all the required dependencies, not including Geany itself, with the following command (as root):
$ apt-get install build-essential libgtk2.0-0 libgtk2.0-dev \ python python-dev python-gtk2 python-gtk2-dev