Changes

Jump to: navigation, search

GEPS 029: GTK3-GObject introspection Conversion

5,224 bytes added, 18:24, 6 November 2017
m
OsmGpsMap for Geography
{{GEPS-Finished}}
{{man menu|Implemented for the release of Gramps 4.0}}
 
Gramps was written with GTK 2 toolkit. This has been replaced upstream with GTK 3, so Gramps should convert to GTK 3.
sudo apt-get install gir1.2-freedesktop python-gi python-gobject python-gi-cairo
sudo apt-get install gir1.2-pango-1.0 libgtkspell-3-0 python-gtkspell
sudo apt-get install python-pyicu
Old note ''The removal of python-gnome2 (and anything that relies on it) is necessary apparently because some "selectors" have not yet been converted. The right thing to do here is to fix the selectors rather than removing the package.'''
You can also run Gramps 4.0+ in [[GEPS_031:_Python_3_support#Ubuntu_12.10|Python 3]] first Install the Python BSDDB interface and check that it [[Install_latest_BSDDB#Python_BSDDB_interface|works]]
As of 25 July 2012, the Debian repositories does not contain sufficiently up-to-date python GObject introspection packages and so need to be installed from the experimental repository, which currently contains version 3.4.2-2. Perhaps the simplest way to install is just to download the latest packages from the Debian packages web site. The files required can be found for different architectures at:
* <del>[http://packages.debian.org/experimental/python-gi python-gi]</del> Error: Package not available in this suite.
* [http://packages.debian.org/experimental/python-gi-cairo python-gi-cairo]
=== Spell Check Install ===
For working spell check, you need [http://gtkspell.sourceforge.net/ gtkspell 3.gtkspell3 3.0].
(In Ubuntu 12.10, this is available in your distribution as the libgtkspell-3-0 packageis not suitable [https://bugs.launchpad.net/ubuntu/+source/gtkspell3/+bug/1114403] as it is API incompatible with the official release 3. 0.0, released on 2012-11-12 )
If the package is not in your distributions packages, you need to compile the spell check. For this, obtain the GtkSpell 3.GtkSpell3 3.0 or later source code, and extract the code to a directory, eg gtkspell3, and go into this directory using the terminal.
Before continuing, remove any old version of gtkspell v3 you might have installed before!
Now obtain the packages needed to compile this code. In my case I had most  Install the program 'hg' to get the code. sudo apt-get install mercurial Download the Gtkspell code (see above installation introspection for other packages that might be needed)with: hg clone <nowiki>http://hg. I still needed code.sf.net/p/gtkspell/code</nowiki> gtkspell-code You may need to install the following: sudo apt-get install gtk-doc-tools libenchant-devvalac
You may also need gtk3 devel packages:
sudo apt-get install gtk+-3.0-dev
Now compile and install the code
./configureautogen.sh
make
sudo make install
Gramps now needs to find the gtkspell typelib and introspection lib. The first I achieve by By copying the typelib to the correct location:
sudo cp /usr/local/lib/girepository-1.0/GtkSpell-3.0.typelib /usr/lib/girepository-1.0/
The lib can be found by path by setting the LD_LIBRARY_PATH environment variable. Hence, start Gramps as follows:
LD_LIBRARY_PATH=/usr/local/lib python src/grampsGramps.py
If you followed the guide above and compiled your own pygobject module, you need to start Gramps with the command
PYTHONPATH=/usr/local/lib/python2.7/site-packages/ LD_LIBRARY_PATH=/usr/local/lib python src/grampsGramps.py [[File:Gtkspell working on gramps40.png|thumb|300px|Gtkspell working on gramps40 - You can tell because it does not recognise the word Gramps in the welcome Gramplet]]{{-}} ==== Install your Dictionary ====
Note, dictionnaries provided by hunspell work fine and have unicode support.
 
If your language is missing from the list of dictionaries to spellcheck against you can install them.
 
eg: For Australian English:
sudo apt-get install myspell-en-au hunspell-en-au
 
You can check that the language installed correctly by running
enchant-lsmod -list-dicts
 
The result should list all the language dictionaries installed and include the one you installed
eg:
en_AU (myspell)
en_AU (hunspell)
==== Old install method ====
we need a patched gtkspell version that supports gobject introspection. A working version is the '''changes''' branch at [https://github.com/manisandro/gtkspell3/tree/changes https://github.com/manisandro/gtkspell3/tree/changes]. So one needs to install this version of gtkspell. The python-gtkspell code is then no longer needed, and can be removed. Source of this code is a sourceforge bug entry [https://sourceforge.net/tracker/index.php?func=detail&aid=3298132&group_id=7896&atid=107896] and a redhat bug entry: [https://bugzilla.redhat.com/show_bug.cgi?id=675504]
Gramps supports this version since revision 20130: [http://gramps.svn.sourceforge.net/viewvcp/gramps/code/20130/tree/trunk/src/gui/spell.py?r1=20057&r2=20130].
First we install the git package to obtain the code:
=== OsmGpsMap for Geography ===
The [[Gramps_4.0_Wiki_Manual_-_Categories#Geography_Category|Geography]] requires osmgpsmap. Introspection bindings for this is not currently available, so you need to compile it.from the repository listed below:
As it doesn't work correctly for the moment and some patches are not in git, I forked osmgpsmapOr simply install from package (Linux Mint 18.2):
Libosmgpsmap-1.0-dev  ==== Download from the home site ====  http://nzjrs.github.io/osm-gps-map/ Download the tar source and do : tar zxvf osm-gps-map-1.0.1.tar.gz cd osm-gps-map-1.0.1 ==== Download from github ==== You can also continue to use git to get the last development version :  git clone git://github.com/SNoiraudnzjrs/osm-gps-map.git
cd osm-gps-map
# switch to branch gtk3
git checkout -b gtk3 origin/gtk3
git branch -a
As I'm currently modifying osm-gps-mapwe can have some new patches, If you already have osm-gps-map and you want to get the last version, do :
git pull
You might have all your dependencies as you already compiled pygobject. For Ubuntu you still need packages libsoup2.4==== How to compile osm-dev and libsoup2.4 You may also need gtk3 devel packages: sudo aptgps-get install gtk+-3.0-devmap ====
You might have all your dependencies if you already compiled pygobject as explained above. For Ubuntu you still need to install gnomepackages libsoup2.4-common from the GNOME SVN sudo apt-get install gnome-commondev and libsoup2.4
You may also need gtk3 andgobject-introspection devel packages: sudo apt-get install gtk+-3.0-dev libgirepository1.0-dev checkinstall
and some other stuff like: sudo apt-get install gnome-common gtk-doc-tools
Now compile osmgpsmap:
./gnome-autogen.sh
make
sudo make install
sudo cp /usr/local/lib/girepository-1.0/OsmGpsMap-1.0.8.typelib /usr/lib/girepository-1.0/
To use this now, you have to, or remove the installed version of osmgpsmap on your computer, or set the LD_LIBRARY_PATH to point at the installed version. EgUsing the latter, I you can start Gramps in trunk with:
LD_LIBRARY_PATH=/usr/local/lib PYTHONPATH=/usr/local/lib/python2.7/site-packages/ python src/grampsGramps.py
or
First sets library to ''/usr/local/lib'' so as to find osmgpsmap and gtkspell, second ''/usr/local/lib/python2.7/site-packages/'' to find the local install of pygobject
An easier way is to do it with checkinstall: gnome-autogen.sh ./configure --prefix=/usr make sudo checkinstall make installthen you don't need all the path wizardry, and can later manage the package via the package management system ==== Linux Mint Ubuntu 14.1 04 - Trusty Tahr ====
The Patches mentioned above packages contained in the repository are too old (as of 2013/0.7.3) so use (1.0.2-1~ubuntu14.04.1/27) in from the backports (universe) made available 2014-07-03. Or (Not recommended) You could download 1.0.x packages manually from the main Utopic (14.10) proposed repository. https://launchpad.net/ubuntu/+source/osm-gps-map git repository so you can use:
git clone git://github.com/nzjrs/osm-gps-map.git
For Linux Mint sudo dpkg -i libosmgpsmap-1.0-0_1.0.2-1_amd64.deb sudo dpkg -i gir1.2-osmgpsmap-1.0_1.0.2-1_amd64.deb === GExiv2 for Image metadata === As at 9 Mar 2013 Fedora 18 only has a libgexiv2-0.4.1-3.fc18.i686.rpm. andversion 0.5 (released October 2012) is needed in order to have the Pythonbindings for GExiv2. The GExiv2 maintainer's homepage is: redmine.yorba.org/projects/gexiv2/wikiwhich points to the latest sources, and tells you how to compile it. But to compile a Fedora 18 GExiv2 library, you need to have installed bothexiv2-devel-0.23-3.fc18.i686.rpm and exiv2-libs-0.23-3.fc18.i686.rpm also.And you also need (unless you already have the gtk3 /usr/bin/g-ir-scanner program)gobject-introspection-devel -1.34.2-1.fc18.i686.rpm too -- but that requirespkgconfig (which I already had) and also libffi-devel-3.0.10-3.fc18.i686.rpmfor it to be happy. The 0.5 GExiv2 sources are in www.yorba.org/download/gexiv2/0.5. There youcan download "libgexiv2-0.5.0.tar.xz" (not .bz2 or .gz) -- which will againonly be necessary if Fedora has not yet updated its official RPM (to 0.5). Then, make a temporary directory and copy libgexiv2-0.5.0.tar.xz into it.Then "cd" into that directory and say "tar xpfJ libgexiv2-0.5.0.tar.xz".Then "cd" into the "libgexiv2-0.5.0" it made, and type: ./configure --enable-introspection --prefix=/usr make(with the "/usr" being needed to override the "/usr/local" default) Then say (as root): make install Since I already had Python3 installed on that F18, along with the Python2which came with the F18, the "make install" put GExiv2.py into both thepython2.7 and python3.3 site-packages/gi/overrides directories, thus enablingit on both. If you only have one Python it will put it only there. As a test, in both (for me) "python" and "python3" say: from gi.repository import GExiv2  Let's not tell users that they should install self-built software into /usr. They shouldn't, and neither should you.Either /usr/local or /opt are better choices and more-or-less standard practice. To make the library findable oneshould either add the directory of choice to /etc/ld.so.conf and run ldconfig(8) or add it to $LD_LIBRARY_PATH in one's profile.  FWIW it seems a bit simpler with Linux Mint Debian Update 6(Cinnamon) libexiv, etc, etc............. are already installed or canbe installed via synaptic. Then git clone git://git.yorba.org/gexiv2" to get gexiv2 0.5;going into gexiv2/ and running sudo apt./configure --enable-get introspection make (as root) make install gtk+-3"installs in usr/localAnd python3 from gi.repository import GExiv2"tests OK. ==== Ubuntu 14.004 -devTrusty Tahr ====
Now compile osmgpsmapOn Ubuntu 14.04 it is a lot easier. According to the Gramps-devel mailing list you can simply install:
./autogen.sh make sudo make apt-get install sudo cp /usr/local/lib/girepositorygir1.2-1.0/OsmGpsMapgexiv2-0.8.typelib /usr/lib/girepository-1.0/10
Start up Gramps withYou can verify that everything is correct by executing the following command: LD_LIBRARY_PATH=/usr/local/lib PYTHONPATH=/usr/local/lib/python2.7/site-packages/ python Gramps.py
or python -c "from gi.repository import GExiv2"
LD_LIBRARY_PATH=/usr/local/lib PYTHONPATH=/usr/local/lib/python2No errors should be displayed.7/site-packages/ python -c 'from gramps.grampsapp import main; main()'
== Problems ==
=== Open ===
* We cannot set strings in struct, see GTK bug [https://bugzilla.gnome.org/show_bug.cgi?id=678401] It seems we can do without this, so not an issue at the moment* pyexiv2 module causes a segmentation fault when exiting Gramps - see bug [http://www.gramps-project.org/bugs/view.php?id=6042 #6042]* python-gnome2 package causes a segmentation fault when Gramps starts - see bug [http://www.gramps-project.org/bugs/view.php?id=5972 #5972]<pre> TypeError: Error when calling the metaclass bases metaclass conflict: the metaclass of a derived class must be a (non-strict) subclass of the metaclasses of all its bases</pre>* Geography : missing tiles : osm-gps-map problem. issue:{{bug|??}}
(Gramps.py:4515): OsmGpsMap-WARNING **: Error getting missing tile
[http://gramps.1791082.n4.nabble.com/osm-gps-map-Error-getting-missing-tile-td4669643.html discussion on mailinglist]* Geography : for all other problems, use last version with git pull. Be careful, osm-gps-map is now 0.8. You must remove all 1.0 versions (OsmGpsMap*.gir and OsmGpsMap*.typelib)* No rows_reordered function on treemodels in python, see GTK bug [https://bugzilla.gnome.org/show_bug.cgi?id=684558]. Current fix: disconnect and reconnect the model so sort need not emit rows-reordered signal. However, this means the history of expand collapse of nodes in a treeview is lost after rows have been reordered (this happens in gramps on click file issues on the column that is already sorted.* Geography : We cannot mix osmgpsmap between trunk and gramps34 and others.bugtracker)
===Solved or workaround===
* Geography : We cannot mix osmgpsmap between trunk and gramps34 and others. '''Solved''' : git pull the latest version. You must remove all libosmgps* from /usr/local/lib before make install
* osmgpsmap is GTK2. There is a GTK3 branch in git, we should try it, and contribute to the conversion. '''In Progress''': Geography really minimalist : no menu, no markers, ... '''Solved''' GTK3 available
* pyexiv2 module causes a segmentation fault when exiting Gramps - see bug #{{bug|6042}} - resolved
* python-gnome2 package causes a segmentation fault when Gramps starts - see bug #{{bug|5972}} - resolved
<pre> TypeError: Error when calling the metaclass bases
metaclass conflict: the metaclass of a derived class must be a (non-strict) subclass of the metaclasses of all its bases</pre>
* Gtk.ColorSelectionDialog has no more colorsel attribute : it's replaced by get_color_selection() - see bug #{{bug|6917}} - resolved
* We cannot set strings in struct, see GTK bug [https://bugzilla.gnome.org/show_bug.cgi?id=678401] It seems we can do without this, so not an issue at the moment (upstream bug shows: RESOLVED FIXED 2013-01-11)
* No rows_reordered function on treemodels in python, see GTK bug [https://bugzilla.gnome.org/show_bug.cgi?id=684558]. Current fix: disconnect and reconnect the model so sort need not emit rows-reordered signal. However, this means the history of expand collapse of nodes in a treeview is lost after rows have been reordered (this happens in gramps on click on the column that is already sorted. (upstream bug shows: RESOLVED FIXED 2013-07-22)
* GraphView : GooCanvas and dash lines : https://bugzilla.gnome.org/show_bug.cgi?id=703592 (upstream bug shows: RESOLVED FIXED 2013-11-02)
== Related Gramps Bugs ==
(gdb) bt
This works best if you have the debug symbols installed for everything relevant, or are running from a self-built treebuilt with debugging CFLAGS (-g -O0). At a minimum, in addition to Python itself, you'll need symbols for Gtk+ (libgtk-3.0.so and libgdk-3.0.so), PyGObject, and GLib. To see the python stack: (gdb) pystack This works with gdb7 as-is; for earlier versions, you need to install [http://svn.python.org/view/*checkout*/python/trunk/Misc/gdbinit?revision=77484 gdbinit] as .gdbinit in your home directory before starting gdb.On some systems (MacOS X in particular), the structure PyStringObject isn't exported in the debug symbols, so if you get the error No symbol "PyStringObject" in current context.then you need to tell gdb add-symbol-file /path/to/Python-build-dir/Objects/stringobject.owhich will be possible only if you've built Python from source. 
[[Category:GEPS|G]]
18
edits

Navigation menu