Addon:GeneanetForGramps

From Gramps
Revision as of 15:41, 16 November 2022 by Bamaustin (talk | contribs) (See also)
Jump to: navigation, search
Gramps-notes.png

Please use carefully on data that is backed up, and help make it better by reporting any comments or problems to the author, or issues to the bug tracker
Unless otherwise stated on this page, you can download this addon by following these instructions.
Please note that some Addons have prerequisites that need to be installed before they can be used.
This Addon/Plugin system is controlled by the Plugin Manager.
An Addons Offline Manual is available for review.

Gnome-important.png
Unreleased addon

The GeneanetForGramps addon allows you to import ancestors and descendants for a selected person from the Geneanet website.

Usage

Once this addon and its Prerequisite has been installed:

  • Select Menu Tools > Family Tree Processing -> Import Geneanet data for Gramps...
Gnome-important.png
Undo history warning

Proceeding with this tool will erase the undo history for this session. In particular, you will not be able to revert the changes made by this tool or any changes made prior to it. If you think you may want to revert running this tool, please stop here and backup your database.

  • From the Undo history warning dialogue you can choose Stop or Proceed with the tool.
Import from Geneanet into Gramps
  • The Geneanet Import Options tab is displayed with the following:
    • Center Person: - Person to process in Geneanet (by default the active one)
    • Genanet URL: - The URL on the Geneanet' site corresponding to the person selected in Gramps and from who you want to import ancestors and descendants. Note that in Gramps the person should have the same birth and death date so it works.
    • [ ] Import ascendants: - Check that box if you want to import ancestors of the person (False by default).
    • [ ] Import descendants: - Check that box if you want to import descendants of the person (False by default).
    • [ ] Import spouses: - Check that box if you want to import spouses of the person (False by default).
    • Level of import: Number of upper or lower parsing you'll do in the Geneanet tree. If you choose 2 (default), you'll get parents and grandparents, children and grandchildren. Be careful by using large numbers as the parsing can then take a long time.
    • [ ] Force import: Force overwrite of existing Gramps fields in a person replaced by the Geneanet Filed (False by default).
    • Verbosity: Increase the versbiosity in the text window where Gramps has been launched (from 0 to 4, 1 by default)

Once you have made your choices, you can either choose Close or Execute to launch the import.

Note that for the parsing to work, you need to have the same firstname/lastname and birth date/death date for the person in both Gramps and Geneanet. Using force mmay overwrite this security.

Tips

Make a try by just importing ancestors to check it's working correctly for you, and the you can add more persons. Limit the level of import when starting at 2 before increasing once you verified it's working for you. Note that the plugin can also be called from the CLI:

usage: GeneanetForGramps.py [-h] [-v] [-a] [-d] [-s] [-l LEVEL]
                            [-g GRAMPSFILE] [-i ID] [-f]
                            [searchedperson]

Import Geneanet subtrees into Gramps

positional arguments:
  searchedperson        Url of the person to search in Geneanet

optional arguments:
  -h, --help            show this help message and exit
  -v, --verbosity       Increase verbosity
  -a, --ascendants      Includes ascendants (off by default)
  -d, --descendants     Includes descendants (off by default)
  -s, --spouses         Includes all spouses (off by default)
  -l LEVEL, --level LEVEL
                        Number of level to explore (2 by default)
  -g GRAMPSFILE, --grampsfile GRAMPSFILE
                        Full path of the Gramps database (under
                        $HOME/.gramps/grampsdb)
  -i ID, --id ID        ID of the person to start from in Gramps
  -f, --force           Force processing

Prerequisites

For the addon to work you will need to install both the Request and lxml Python modules.

Requests

Install the python module Requests otherwise you will get the following error:

2020-12-06 10:29:40.191: WARNING: _manager.py: line 308: Plugin error (from 'GeneanetForGramps'): No module named 'requests'

lxml

Install the python module lxml otherwise you will get the following error:

2020-12-07 00:22:41.100: WARNING: _manager.py: line 308: Plugin error (from 'GeneanetForGramps'): No module named 'lxml'

SQLite only supported

Also note that you need to use a SQLite DB (based on API-DB) and NOT a BSDDB for the plugin to work. When using a BSDDB base you'll get the following error:

File "/users/gnucash/.gramps/gramps51/plugins/GeneanetForGramps/GeneanetForGramps.py",
line 1339, in find_grampsp
    ids = db.get_person_gramps_ids()
AttributeError: 'DbBsddb' object has no attribute 'get_person_gramps_ids'

You can Convert a BSDDB Family Tree to SQLite and then export from the previous and import into the new.

See also

Discourse discussion forum threads

Gramps-User maillist threads

Gramps-Devel maillist threads