1615 lines
54 KiB
Python
1615 lines
54 KiB
Python
# Gramps - a GTK+/GNOME based genealogy program
|
|
#
|
|
# Copyright (C) 2012 Douglas S. Blank <doug.blank@gmail.com>
|
|
#
|
|
# This program is free software; you can redistribute it and/or modify
|
|
# it under the terms of the GNU General Public License as published by
|
|
# the Free Software Foundation; either version 2 of the License, or
|
|
# (at your option) any later version.
|
|
#
|
|
# This program is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License
|
|
# along with this program; if not, write to the Free Software
|
|
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
#
|
|
|
|
""" Implements a Db interface as a Dictionary """
|
|
|
|
#------------------------------------------------------------------------
|
|
#
|
|
# Gramps Modules
|
|
#
|
|
#------------------------------------------------------------------------
|
|
import pickle
|
|
import base64
|
|
import time
|
|
import re
|
|
import os
|
|
from gramps.gen.db import DbReadBase, DbWriteBase, DbTxn, KEY_TO_NAME_MAP
|
|
from gramps.gen.utils.callback import Callback
|
|
from gramps.gen.updatecallback import UpdateCallback
|
|
from gramps.gen.db import (PERSON_KEY,
|
|
FAMILY_KEY,
|
|
CITATION_KEY,
|
|
SOURCE_KEY,
|
|
EVENT_KEY,
|
|
MEDIA_KEY,
|
|
PLACE_KEY,
|
|
REPOSITORY_KEY,
|
|
NOTE_KEY,
|
|
TAG_KEY)
|
|
|
|
from gramps.gen.utils.id import create_id
|
|
from gramps.gen.lib.researcher import Researcher
|
|
from gramps.gen.lib.mediaobj import MediaObject
|
|
from gramps.gen.lib.person import Person
|
|
from gramps.gen.lib.family import Family
|
|
from gramps.gen.lib.src import Source
|
|
from gramps.gen.lib.citation import Citation
|
|
from gramps.gen.lib.event import Event
|
|
from gramps.gen.lib.place import Place
|
|
from gramps.gen.lib.repo import Repository
|
|
from gramps.gen.lib.note import Note
|
|
from gramps.gen.lib.tag import Tag
|
|
|
|
class Environment(object):
|
|
"""
|
|
Implements the Environment API.
|
|
"""
|
|
def __init__(self, db):
|
|
self.db = db
|
|
|
|
def txn_begin(self):
|
|
return DictionaryTxn("DictionaryDb Transaction", self.db)
|
|
|
|
class Table(object):
|
|
"""
|
|
Implements Table interface.
|
|
"""
|
|
def __init__(self, funcs):
|
|
self.funcs = funcs
|
|
|
|
def cursor(self):
|
|
"""
|
|
Returns a Cursor for this Table.
|
|
"""
|
|
return self.funcs["cursor_func"]()
|
|
|
|
def put(key, data, txn=None):
|
|
self[key] = data
|
|
|
|
class Map(dict):
|
|
"""
|
|
Implements the map API for person_map, etc.
|
|
|
|
Takes a Table() as argument.
|
|
"""
|
|
def __init__(self, tbl, *args, **kwargs):
|
|
super().__init__(*args, **kwargs)
|
|
self.db = tbl
|
|
|
|
class MetaCursor(object):
|
|
def __init__(self):
|
|
pass
|
|
def __enter__(self):
|
|
return self
|
|
def __iter__(self):
|
|
return self.__next__()
|
|
def __next__(self):
|
|
yield None
|
|
def __exit__(self, *args, **kwargs):
|
|
pass
|
|
def iter(self):
|
|
yield None
|
|
def first(self):
|
|
self._iter = self.__iter__()
|
|
return self.next()
|
|
def next(self):
|
|
try:
|
|
return next(self._iter)
|
|
except:
|
|
return None
|
|
def close(self):
|
|
pass
|
|
|
|
class Cursor(object):
|
|
def __init__(self, map, func):
|
|
self.map = map
|
|
self.func = func
|
|
def __enter__(self):
|
|
return self
|
|
def __iter__(self):
|
|
return self.__next__()
|
|
def __next__(self):
|
|
for item in self.map.keys():
|
|
yield (bytes(item, "utf-8"), self.func(item))
|
|
def __exit__(self, *args, **kwargs):
|
|
pass
|
|
def iter(self):
|
|
for item in self.map.keys():
|
|
yield (bytes(item, "utf-8"), self.func(item))
|
|
yield None
|
|
def first(self):
|
|
self._iter = self.__iter__()
|
|
return self.next()
|
|
def next(self):
|
|
try:
|
|
return next(self._iter)
|
|
except:
|
|
return None
|
|
def close(self):
|
|
pass
|
|
|
|
class Bookmarks(object):
|
|
def __init__(self):
|
|
self.handles = []
|
|
def get(self):
|
|
return self.handles
|
|
def append(self, handle):
|
|
self.handles.append(handle)
|
|
|
|
class DictionaryTxn(DbTxn):
|
|
def __init__(self, message, db, batch=False):
|
|
DbTxn.__init__(self, message, db, batch)
|
|
|
|
def get(self, key, default=None, txn=None, **kwargs):
|
|
"""
|
|
Returns the data object associated with key
|
|
"""
|
|
if txn and key in txn:
|
|
return txn[key]
|
|
else:
|
|
return None
|
|
|
|
def put(self, handle, new_data, txn):
|
|
"""
|
|
"""
|
|
txn[handle] = new_data
|
|
|
|
class DictionaryDb(DbWriteBase, DbReadBase, UpdateCallback, Callback):
|
|
"""
|
|
A Gramps Database Backend. This replicates the grampsdb functions.
|
|
"""
|
|
__signals__ = dict((obj+'-'+op, signal)
|
|
for obj in
|
|
['person', 'family', 'event', 'place',
|
|
'source', 'citation', 'media', 'note', 'repository', 'tag']
|
|
for op, signal in zip(
|
|
['add', 'update', 'delete', 'rebuild'],
|
|
[(list,), (list,), (list,), None]
|
|
)
|
|
)
|
|
|
|
# 2. Signals for long operations
|
|
__signals__.update(('long-op-'+op, signal) for op, signal in zip(
|
|
['start', 'heartbeat', 'end'],
|
|
[(object,), None, None]
|
|
))
|
|
|
|
# 3. Special signal for change in home person
|
|
__signals__['home-person-changed'] = None
|
|
|
|
# 4. Signal for change in person group name, parameters are
|
|
__signals__['person-groupname-rebuild'] = (str, str)
|
|
|
|
__callback_map = {}
|
|
|
|
def __init__(self, directory=None):
|
|
DbReadBase.__init__(self)
|
|
DbWriteBase.__init__(self)
|
|
Callback.__init__(self)
|
|
self._tables['Person'].update(
|
|
{
|
|
"handle_func": self.get_person_from_handle,
|
|
"gramps_id_func": self.get_person_from_gramps_id,
|
|
"class_func": Person,
|
|
"cursor_func": self.get_person_cursor,
|
|
"handles_func": self.get_person_handles,
|
|
"add_func": self.add_person,
|
|
"commit_func": self.commit_person,
|
|
"iter_func": self.iter_people,
|
|
})
|
|
self._tables['Family'].update(
|
|
{
|
|
"handle_func": self.get_family_from_handle,
|
|
"gramps_id_func": self.get_family_from_gramps_id,
|
|
"class_func": Family,
|
|
"cursor_func": self.get_family_cursor,
|
|
"handles_func": self.get_family_handles,
|
|
"add_func": self.add_family,
|
|
"commit_func": self.commit_family,
|
|
"iter_func": self.iter_families,
|
|
})
|
|
self._tables['Source'].update(
|
|
{
|
|
"handle_func": self.get_source_from_handle,
|
|
"gramps_id_func": self.get_source_from_gramps_id,
|
|
"class_func": Source,
|
|
"cursor_func": self.get_source_cursor,
|
|
"handles_func": self.get_source_handles,
|
|
"add_func": self.add_source,
|
|
"commit_func": self.commit_source,
|
|
"iter_func": self.iter_sources,
|
|
})
|
|
self._tables['Citation'].update(
|
|
{
|
|
"handle_func": self.get_citation_from_handle,
|
|
"gramps_id_func": self.get_citation_from_gramps_id,
|
|
"class_func": Citation,
|
|
"cursor_func": self.get_citation_cursor,
|
|
"handles_func": self.get_citation_handles,
|
|
"add_func": self.add_citation,
|
|
"commit_func": self.commit_citation,
|
|
"iter_func": self.iter_citations,
|
|
})
|
|
self._tables['Event'].update(
|
|
{
|
|
"handle_func": self.get_event_from_handle,
|
|
"gramps_id_func": self.get_event_from_gramps_id,
|
|
"class_func": Event,
|
|
"cursor_func": self.get_event_cursor,
|
|
"handles_func": self.get_event_handles,
|
|
"add_func": self.add_event,
|
|
"commit_func": self.commit_event,
|
|
"iter_func": self.iter_events,
|
|
})
|
|
self._tables['Media'].update(
|
|
{
|
|
"handle_func": self.get_object_from_handle,
|
|
"gramps_id_func": self.get_object_from_gramps_id,
|
|
"class_func": MediaObject,
|
|
"cursor_func": self.get_media_cursor,
|
|
"handles_func": self.get_media_object_handles,
|
|
"add_func": self.add_object,
|
|
"commit_func": self.commit_media_object,
|
|
"iter_func": self.iter_media_objects,
|
|
})
|
|
self._tables['Place'].update(
|
|
{
|
|
"handle_func": self.get_place_from_handle,
|
|
"gramps_id_func": self.get_place_from_gramps_id,
|
|
"class_func": Place,
|
|
"cursor_func": self.get_place_cursor,
|
|
"handles_func": self.get_place_handles,
|
|
"add_func": self.add_place,
|
|
"commit_func": self.commit_place,
|
|
"iter_func": self.iter_places,
|
|
})
|
|
self._tables['Repository'].update(
|
|
{
|
|
"handle_func": self.get_repository_from_handle,
|
|
"gramps_id_func": self.get_repository_from_gramps_id,
|
|
"class_func": Repository,
|
|
"cursor_func": self.get_repository_cursor,
|
|
"handles_func": self.get_repository_handles,
|
|
"add_func": self.add_repository,
|
|
"commit_func": self.commit_repository,
|
|
"iter_func": self.iter_repositories,
|
|
})
|
|
self._tables['Note'].update(
|
|
{
|
|
"handle_func": self.get_note_from_handle,
|
|
"gramps_id_func": self.get_note_from_gramps_id,
|
|
"class_func": Note,
|
|
"cursor_func": self.get_note_cursor,
|
|
"handles_func": self.get_note_handles,
|
|
"add_func": self.add_note,
|
|
"commit_func": self.commit_note,
|
|
"iter_func": self.iter_notes,
|
|
})
|
|
self._tables['Tag'].update(
|
|
{
|
|
"handle_func": self.get_tag_from_handle,
|
|
"gramps_id_func": None,
|
|
"class_func": Tag,
|
|
"cursor_func": self.get_tag_cursor,
|
|
"handles_func": self.get_tag_handles,
|
|
"add_func": self.add_tag,
|
|
"commit_func": self.commit_tag,
|
|
"iter_func": self.iter_tags,
|
|
})
|
|
# skip GEDCOM cross-ref check for now:
|
|
self.set_feature("skip-check-xref", True)
|
|
self.set_feature("skip-import-additions", True)
|
|
self.readonly = False
|
|
self.db_is_open = True
|
|
self.name_formats = []
|
|
self.bookmarks = Bookmarks()
|
|
self.family_bookmarks = Bookmarks()
|
|
self.event_bookmarks = Bookmarks()
|
|
self.place_bookmarks = Bookmarks()
|
|
self.citation_bookmarks = Bookmarks()
|
|
self.source_bookmarks = Bookmarks()
|
|
self.repo_bookmarks = Bookmarks()
|
|
self.media_bookmarks = Bookmarks()
|
|
self.note_bookmarks = Bookmarks()
|
|
self.set_person_id_prefix('I%04d')
|
|
self.set_object_id_prefix('O%04d')
|
|
self.set_family_id_prefix('F%04d')
|
|
self.set_citation_id_prefix('C%04d')
|
|
self.set_source_id_prefix('S%04d')
|
|
self.set_place_id_prefix('P%04d')
|
|
self.set_event_id_prefix('E%04d')
|
|
self.set_repository_id_prefix('R%04d')
|
|
self.set_note_id_prefix('N%04d')
|
|
# ----------------------------------
|
|
self.id_trans = DictionaryTxn("ID Transaction", self)
|
|
self.fid_trans = DictionaryTxn("FID Transaction", self)
|
|
self.pid_trans = DictionaryTxn("PID Transaction", self)
|
|
self.cid_trans = DictionaryTxn("CID Transaction", self)
|
|
self.sid_trans = DictionaryTxn("SID Transaction", self)
|
|
self.oid_trans = DictionaryTxn("OID Transaction", self)
|
|
self.rid_trans = DictionaryTxn("RID Transaction", self)
|
|
self.nid_trans = DictionaryTxn("NID Transaction", self)
|
|
self.eid_trans = DictionaryTxn("EID Transaction", self)
|
|
self.cmap_index = 0
|
|
self.smap_index = 0
|
|
self.emap_index = 0
|
|
self.pmap_index = 0
|
|
self.fmap_index = 0
|
|
self.lmap_index = 0
|
|
self.omap_index = 0
|
|
self.rmap_index = 0
|
|
self.nmap_index = 0
|
|
self.env = Environment(self)
|
|
self.person_map = Map(Table(self._tables["Person"]))
|
|
self.family_map = Map(Table(self._tables["Family"]))
|
|
self.place_map = Map(Table(self._tables["Place"]))
|
|
self.citation_map = Map(Table(self._tables["Citation"]))
|
|
self.source_map = Map(Table(self._tables["Source"]))
|
|
self.repository_map = Map(Table(self._tables["Repository"]))
|
|
self.note_map = Map(Table(self._tables["Note"]))
|
|
self.media_map = Map(Table(self._tables["Media"]))
|
|
self.event_map = Map(Table(self._tables["Event"]))
|
|
self.tag_map = Map(Table(self._tables["Tag"]))
|
|
self.metadata = Map(Table({"cursor_func": lambda: MetaCursor()}))
|
|
self.name_group = {}
|
|
self.undo_callback = None
|
|
self.redo_callback = None
|
|
self.undo_history_callback = None
|
|
self.modified = 0
|
|
self.txn = DictionaryTxn("DbDictionary Transaction", self)
|
|
self.transaction = None
|
|
self._directory = directory
|
|
if directory:
|
|
self.load(directory)
|
|
|
|
def version_supported(self):
|
|
"""Return True when the file has a supported version."""
|
|
return True
|
|
|
|
def get_table_names(self):
|
|
"""Return a list of valid table names."""
|
|
return list(self._tables.keys())
|
|
|
|
def get_table_metadata(self, table_name):
|
|
"""Return the metadata for a valid table name."""
|
|
if table_name in self._tables:
|
|
return self._tables[table_name]
|
|
return None
|
|
|
|
def transaction_commit(self, txn):
|
|
pass
|
|
|
|
def get_undodb(self):
|
|
return None
|
|
|
|
def transaction_abort(self, txn):
|
|
pass
|
|
|
|
@staticmethod
|
|
def _validated_id_prefix(val, default):
|
|
if isinstance(val, str) and val:
|
|
try:
|
|
str_ = val % 1
|
|
except TypeError: # missing conversion specifier
|
|
prefix_var = val + "%d"
|
|
except ValueError: # incomplete format
|
|
prefix_var = default+"%04d"
|
|
else:
|
|
prefix_var = val # OK as given
|
|
else:
|
|
prefix_var = default+"%04d" # not a string or empty string
|
|
return prefix_var
|
|
|
|
@staticmethod
|
|
def __id2user_format(id_pattern):
|
|
"""
|
|
Return a method that accepts a Gramps ID and adjusts it to the users
|
|
format.
|
|
"""
|
|
pattern_match = re.match(r"(.*)%[0 ](\d+)[diu]$", id_pattern)
|
|
if pattern_match:
|
|
str_prefix = pattern_match.group(1)
|
|
nr_width = int(pattern_match.group(2))
|
|
def closure_func(gramps_id):
|
|
if gramps_id and gramps_id.startswith(str_prefix):
|
|
id_number = gramps_id[len(str_prefix):]
|
|
if id_number.isdigit():
|
|
id_value = int(id_number, 10)
|
|
#if len(str(id_value)) > nr_width:
|
|
# # The ID to be imported is too large to fit in the
|
|
# # users format. For now just create a new ID,
|
|
# # because that is also what happens with IDs that
|
|
# # are identical to IDs already in the database. If
|
|
# # the problem of colliding import and already
|
|
# # present IDs is solved the code here also needs
|
|
# # some solution.
|
|
# gramps_id = id_pattern % 1
|
|
#else:
|
|
gramps_id = id_pattern % id_value
|
|
return gramps_id
|
|
else:
|
|
def closure_func(gramps_id):
|
|
return gramps_id
|
|
return closure_func
|
|
|
|
def set_person_id_prefix(self, val):
|
|
"""
|
|
Set the naming template for GRAMPS Person ID values.
|
|
|
|
The string is expected to be in the form of a simple text string, or
|
|
in a format that contains a C/Python style format string using %d,
|
|
such as I%d or I%04d.
|
|
"""
|
|
self.person_prefix = self._validated_id_prefix(val, "I")
|
|
self.id2user_format = self.__id2user_format(self.person_prefix)
|
|
|
|
def set_citation_id_prefix(self, val):
|
|
"""
|
|
Set the naming template for GRAMPS Citation ID values.
|
|
|
|
The string is expected to be in the form of a simple text string, or
|
|
in a format that contains a C/Python style format string using %d,
|
|
such as C%d or C%04d.
|
|
"""
|
|
self.citation_prefix = self._validated_id_prefix(val, "C")
|
|
self.cid2user_format = self.__id2user_format(self.citation_prefix)
|
|
|
|
def set_source_id_prefix(self, val):
|
|
"""
|
|
Set the naming template for GRAMPS Source ID values.
|
|
|
|
The string is expected to be in the form of a simple text string, or
|
|
in a format that contains a C/Python style format string using %d,
|
|
such as S%d or S%04d.
|
|
"""
|
|
self.source_prefix = self._validated_id_prefix(val, "S")
|
|
self.sid2user_format = self.__id2user_format(self.source_prefix)
|
|
|
|
def set_object_id_prefix(self, val):
|
|
"""
|
|
Set the naming template for GRAMPS MediaObject ID values.
|
|
|
|
The string is expected to be in the form of a simple text string, or
|
|
in a format that contains a C/Python style format string using %d,
|
|
such as O%d or O%04d.
|
|
"""
|
|
self.mediaobject_prefix = self._validated_id_prefix(val, "O")
|
|
self.oid2user_format = self.__id2user_format(self.mediaobject_prefix)
|
|
|
|
def set_place_id_prefix(self, val):
|
|
"""
|
|
Set the naming template for GRAMPS Place ID values.
|
|
|
|
The string is expected to be in the form of a simple text string, or
|
|
in a format that contains a C/Python style format string using %d,
|
|
such as P%d or P%04d.
|
|
"""
|
|
self.place_prefix = self._validated_id_prefix(val, "P")
|
|
self.pid2user_format = self.__id2user_format(self.place_prefix)
|
|
|
|
def set_family_id_prefix(self, val):
|
|
"""
|
|
Set the naming template for GRAMPS Family ID values. The string is
|
|
expected to be in the form of a simple text string, or in a format
|
|
that contains a C/Python style format string using %d, such as F%d
|
|
or F%04d.
|
|
"""
|
|
self.family_prefix = self._validated_id_prefix(val, "F")
|
|
self.fid2user_format = self.__id2user_format(self.family_prefix)
|
|
|
|
def set_event_id_prefix(self, val):
|
|
"""
|
|
Set the naming template for GRAMPS Event ID values.
|
|
|
|
The string is expected to be in the form of a simple text string, or
|
|
in a format that contains a C/Python style format string using %d,
|
|
such as E%d or E%04d.
|
|
"""
|
|
self.event_prefix = self._validated_id_prefix(val, "E")
|
|
self.eid2user_format = self.__id2user_format(self.event_prefix)
|
|
|
|
def set_repository_id_prefix(self, val):
|
|
"""
|
|
Set the naming template for GRAMPS Repository ID values.
|
|
|
|
The string is expected to be in the form of a simple text string, or
|
|
in a format that contains a C/Python style format string using %d,
|
|
such as R%d or R%04d.
|
|
"""
|
|
self.repository_prefix = self._validated_id_prefix(val, "R")
|
|
self.rid2user_format = self.__id2user_format(self.repository_prefix)
|
|
|
|
def set_note_id_prefix(self, val):
|
|
"""
|
|
Set the naming template for GRAMPS Note ID values.
|
|
|
|
The string is expected to be in the form of a simple text string, or
|
|
in a format that contains a C/Python style format string using %d,
|
|
such as N%d or N%04d.
|
|
"""
|
|
self.note_prefix = self._validated_id_prefix(val, "N")
|
|
self.nid2user_format = self.__id2user_format(self.note_prefix)
|
|
|
|
def __find_next_gramps_id(self, prefix, map_index, trans):
|
|
"""
|
|
Helper function for find_next_<object>_gramps_id methods
|
|
"""
|
|
index = prefix % map_index
|
|
while trans.get(str(index), txn=self.txn) is not None:
|
|
map_index += 1
|
|
index = prefix % map_index
|
|
map_index += 1
|
|
return (map_index, index)
|
|
|
|
def find_next_person_gramps_id(self):
|
|
"""
|
|
Return the next available GRAMPS' ID for a Person object based off the
|
|
person ID prefix.
|
|
"""
|
|
self.pmap_index, gid = self.__find_next_gramps_id(self.person_prefix,
|
|
self.pmap_index, self.id_trans)
|
|
return gid
|
|
|
|
def find_next_place_gramps_id(self):
|
|
"""
|
|
Return the next available GRAMPS' ID for a Place object based off the
|
|
place ID prefix.
|
|
"""
|
|
self.lmap_index, gid = self.__find_next_gramps_id(self.place_prefix,
|
|
self.lmap_index, self.pid_trans)
|
|
return gid
|
|
|
|
def find_next_event_gramps_id(self):
|
|
"""
|
|
Return the next available GRAMPS' ID for a Event object based off the
|
|
event ID prefix.
|
|
"""
|
|
self.emap_index, gid = self.__find_next_gramps_id(self.event_prefix,
|
|
self.emap_index, self.eid_trans)
|
|
return gid
|
|
|
|
def find_next_object_gramps_id(self):
|
|
"""
|
|
Return the next available GRAMPS' ID for a MediaObject object based
|
|
off the media object ID prefix.
|
|
"""
|
|
self.omap_index, gid = self.__find_next_gramps_id(self.mediaobject_prefix,
|
|
self.omap_index, self.oid_trans)
|
|
return gid
|
|
|
|
def find_next_citation_gramps_id(self):
|
|
"""
|
|
Return the next available GRAMPS' ID for a Citation object based off the
|
|
citation ID prefix.
|
|
"""
|
|
self.cmap_index, gid = self.__find_next_gramps_id(self.citation_prefix,
|
|
self.cmap_index, self.cid_trans)
|
|
return gid
|
|
|
|
def find_next_source_gramps_id(self):
|
|
"""
|
|
Return the next available GRAMPS' ID for a Source object based off the
|
|
source ID prefix.
|
|
"""
|
|
self.smap_index, gid = self.__find_next_gramps_id(self.source_prefix,
|
|
self.smap_index, self.sid_trans)
|
|
return gid
|
|
|
|
def find_next_family_gramps_id(self):
|
|
"""
|
|
Return the next available GRAMPS' ID for a Family object based off the
|
|
family ID prefix.
|
|
"""
|
|
self.fmap_index, gid = self.__find_next_gramps_id(self.family_prefix,
|
|
self.fmap_index, self.fid_trans)
|
|
return gid
|
|
|
|
def find_next_repository_gramps_id(self):
|
|
"""
|
|
Return the next available GRAMPS' ID for a Respository object based
|
|
off the repository ID prefix.
|
|
"""
|
|
self.rmap_index, gid = self.__find_next_gramps_id(self.repository_prefix,
|
|
self.rmap_index, self.rid_trans)
|
|
return gid
|
|
|
|
def find_next_note_gramps_id(self):
|
|
"""
|
|
Return the next available GRAMPS' ID for a Note object based off the
|
|
note ID prefix.
|
|
"""
|
|
self.nmap_index, gid = self.__find_next_gramps_id(self.note_prefix,
|
|
self.nmap_index, self.nid_trans)
|
|
return gid
|
|
|
|
def get_mediapath(self):
|
|
return None
|
|
|
|
def get_name_group_keys(self):
|
|
return []
|
|
|
|
def get_name_group_mapping(self, key):
|
|
return None
|
|
|
|
def get_researcher(self):
|
|
obj = Researcher()
|
|
return obj
|
|
|
|
def get_person_handles(self, sort_handles=False):
|
|
## Fixme: implement sort
|
|
return self.person_map.keys()
|
|
|
|
def get_family_handles(self):
|
|
return self.family_map.keys()
|
|
|
|
def get_event_handles(self, sort_handles=False):
|
|
return self.event_map.keys()
|
|
|
|
def get_citation_handles(self, sort_handles=False):
|
|
## Fixme: implement sort
|
|
return self.citation_map.keys()
|
|
|
|
def get_source_handles(self, sort_handles=False):
|
|
## Fixme: implement sort
|
|
return self.source_map.keys()
|
|
|
|
def get_place_handles(self, sort_handles=False):
|
|
## Fixme: implement sort
|
|
return self.place_map.keys()
|
|
|
|
def get_repository_handles(self):
|
|
return self.repository_map.keys()
|
|
|
|
def get_media_object_handles(self, sort_handles=False):
|
|
## Fixme: implement sort
|
|
return self.media_map.keys()
|
|
|
|
def get_note_handles(self):
|
|
return self.note_map.keys()
|
|
|
|
def get_tag_handles(self, sort_handles=False):
|
|
# FIXME: sort
|
|
return self.tag_map.keys()
|
|
|
|
def get_event_from_handle(self, handle):
|
|
event = None
|
|
if handle in self.event_map:
|
|
event = self.event_map[handle]
|
|
return event
|
|
|
|
def get_family_from_handle(self, handle):
|
|
family = None
|
|
if handle in self.family_map:
|
|
family = self.family_map[handle]
|
|
return family
|
|
|
|
def get_repository_from_handle(self, handle):
|
|
repository = None
|
|
if handle in self.repository_map:
|
|
repository = self.repository_map[handle]
|
|
return repository
|
|
|
|
def get_person_from_handle(self, handle):
|
|
person = None
|
|
if handle in self.person_map:
|
|
person = self.person_map[handle]
|
|
return person
|
|
|
|
def get_place_from_handle(self, handle):
|
|
place = None
|
|
if handle in self.place_map:
|
|
place = self.place_map[handle]
|
|
return place
|
|
|
|
def get_citation_from_handle(self, handle):
|
|
citation = None
|
|
if handle in self.citation_map:
|
|
citation = self.citation_map[handle]
|
|
return citation
|
|
|
|
def get_source_from_handle(self, handle):
|
|
source = None
|
|
if handle in self.source_map:
|
|
source = self.source_map[handle]
|
|
return source
|
|
|
|
def get_note_from_handle(self, handle):
|
|
note = None
|
|
if handle in self.note_map:
|
|
note = self.note_map[handle]
|
|
return note
|
|
|
|
def get_object_from_handle(self, handle):
|
|
media = None
|
|
if handle in self.media_map:
|
|
media = self.media_map[handle]
|
|
return media
|
|
|
|
def get_tag_from_handle(self, handle):
|
|
tag = None
|
|
if handle in self.tag_map:
|
|
tag = self.tag_map[handle]
|
|
return tag
|
|
|
|
def get_default_person(self):
|
|
handle = self.get_default_handle()
|
|
if handle:
|
|
return self.get_person_from_handle(handle)
|
|
else:
|
|
return None
|
|
|
|
def iter_people(self):
|
|
return (person for person in self.person_map.values())
|
|
|
|
def iter_person_handles(self):
|
|
return (handle for handle in self.person_map.keys())
|
|
|
|
def iter_families(self):
|
|
return (family for family in self.family_map.values())
|
|
|
|
def iter_family_handles(self):
|
|
return (handle for handle in self.family_map.keys())
|
|
|
|
def get_tag_from_name(self, name):
|
|
for tag in self.tag_map.values():
|
|
if tag.name == name:
|
|
return tag
|
|
return None
|
|
|
|
def get_person_from_gramps_id(self, gramps_id):
|
|
for person in self.person_map.values():
|
|
if person.gramps_id == gramps_id:
|
|
return person
|
|
return None
|
|
|
|
def get_family_from_gramps_id(self, gramps_id):
|
|
for family in self.family_map.values():
|
|
if family.gramps_id == gramps_id:
|
|
return family
|
|
return None
|
|
|
|
def get_citation_from_gramps_id(self, gramps_id):
|
|
for citation in self.citation_map.values():
|
|
if citation.gramps_id == gramps_id:
|
|
return citation
|
|
return None
|
|
|
|
def get_source_from_gramps_id(self, gramps_id):
|
|
for source in self.source_map.values():
|
|
if source.gramps_id == gramps_id:
|
|
return source
|
|
return None
|
|
|
|
def get_event_from_gramps_id(self, gramps_id):
|
|
for event in self.event_map.values():
|
|
if event.gramps_id == gramps_id:
|
|
return event
|
|
return None
|
|
|
|
def get_media_from_gramps_id(self, gramps_id):
|
|
for media in self.media_map.values():
|
|
if media.gramps_id == gramps_id:
|
|
return media
|
|
return None
|
|
|
|
def get_place_from_gramps_id(self, gramps_id):
|
|
for place in self.place_map.values():
|
|
if place.gramps_id == gramps_id:
|
|
return place
|
|
return None
|
|
|
|
def get_repository_from_gramps_id(self, gramps_id):
|
|
for repository in self.repository_map.values():
|
|
if repository.gramps_id == gramps_id:
|
|
return repository
|
|
return None
|
|
|
|
def get_note_from_gramps_id(self, gramps_id):
|
|
for note in self.note_map.values():
|
|
if note.gramps_id == gramps_id:
|
|
return note
|
|
return None
|
|
|
|
def get_tag_from_gramps_id(self, gramps_id):
|
|
for tag in self.tag_map.values():
|
|
if tag.gramps_id == gramps_id:
|
|
return tag
|
|
return None
|
|
|
|
def get_number_of_people(self):
|
|
return len(self.person_map)
|
|
|
|
def get_number_of_events(self):
|
|
return len(self.event_map)
|
|
|
|
def get_number_of_places(self):
|
|
return len(self.place_map)
|
|
|
|
def get_number_of_tags(self):
|
|
return 0 # FIXME
|
|
|
|
def get_number_of_families(self):
|
|
return len(self.family_map)
|
|
|
|
def get_number_of_notes(self):
|
|
return len(self.note_map)
|
|
|
|
def get_number_of_citations(self):
|
|
return len(self.citation_map)
|
|
|
|
def get_number_of_sources(self):
|
|
return len(self.source_map)
|
|
|
|
def get_number_of_media_objects(self):
|
|
return len(self.media_map)
|
|
|
|
def get_number_of_repositories(self):
|
|
return len(self.repository_map)
|
|
|
|
def get_place_cursor(self):
|
|
return Cursor(self.place_map, self.get_raw_place_data)
|
|
|
|
def get_person_cursor(self):
|
|
return Cursor(self.person_map, self.get_raw_person_data)
|
|
|
|
def get_family_cursor(self):
|
|
return Cursor(self.family_map, self.get_raw_family_data)
|
|
|
|
def get_event_cursor(self):
|
|
return Cursor(self.event_map, self.get_raw_event_data)
|
|
|
|
def get_note_cursor(self):
|
|
return Cursor(self.note_map, self.get_raw_note_data)
|
|
|
|
def get_tag_cursor(self):
|
|
return Cursor(self.tag_map, self.get_raw_tag_data)
|
|
|
|
def get_repository_cursor(self):
|
|
return Cursor(self.repository_map, self.get_raw_repository_data)
|
|
|
|
def get_media_cursor(self):
|
|
return Cursor(self.media_map, self.get_raw_object_data)
|
|
|
|
def get_citation_cursor(self):
|
|
return Cursor(self.citation_map, self.get_raw_citation_data)
|
|
|
|
def get_source_cursor(self):
|
|
return Cursor(self.source_map, self.get_raw_source_data)
|
|
|
|
def has_gramps_id(self, obj_key, gramps_id):
|
|
key2table = {
|
|
PERSON_KEY: self.person_map,
|
|
FAMILY_KEY: self.family_map,
|
|
SOURCE_KEY: self.source_map,
|
|
CITATION_KEY: self.citation_map,
|
|
EVENT_KEY: self.event_map,
|
|
MEDIA_KEY: self.media_map,
|
|
PLACE_KEY: self.place_map,
|
|
REPOSITORY_KEY: self.repository_map,
|
|
NOTE_KEY: self.note_map,
|
|
}
|
|
map = key2table[obj_key]
|
|
for item in map.values():
|
|
if item.gramps_id == gramps_id:
|
|
return True
|
|
return False
|
|
|
|
def has_person_handle(self, handle):
|
|
return handle in self.person_map
|
|
|
|
def has_family_handle(self, handle):
|
|
return handle in self.family_map
|
|
|
|
def has_citation_handle(self, handle):
|
|
return handle in self.citation_map
|
|
|
|
def has_source_handle(self, handle):
|
|
return handle in self.source_map
|
|
|
|
def has_repository_handle(self, handle):
|
|
return handle in self.repository_map
|
|
|
|
def has_note_handle(self, handle):
|
|
return handle in self.note_map
|
|
|
|
def has_place_handle(self, handle):
|
|
return handle in self.place_map
|
|
|
|
def has_event_handle(self, handle):
|
|
return handle in self.event_map
|
|
|
|
def has_tag_handle(self, handle):
|
|
return handle in self.tag_map
|
|
|
|
def has_object_handle(self, handle):
|
|
return handle in self.media_map
|
|
|
|
def has_name_group_key(self, key):
|
|
# FIXME:
|
|
return False
|
|
|
|
def set_name_group_mapping(self, key, value):
|
|
# FIXME:
|
|
pass
|
|
|
|
def set_default_person_handle(self, handle):
|
|
pass
|
|
|
|
def set_mediapath(self, mediapath):
|
|
pass
|
|
|
|
def get_raw_person_data(self, handle):
|
|
if handle in self.person_map:
|
|
return self.person_map[handle].serialize()
|
|
return None
|
|
|
|
def get_raw_family_data(self, handle):
|
|
if handle in self.family_map:
|
|
return self.family_map[handle].serialize()
|
|
return None
|
|
|
|
def get_raw_citation_data(self, handle):
|
|
if handle in self.citation_map:
|
|
return self.citation_map[handle].serialize()
|
|
return None
|
|
|
|
def get_raw_source_data(self, handle):
|
|
if handle in self.source_map:
|
|
return self.source_map[handle].serialize()
|
|
return None
|
|
|
|
def get_raw_repository_data(self, handle):
|
|
if handle in self.repository_map:
|
|
return self.repository_map[handle].serialize()
|
|
return None
|
|
|
|
def get_raw_note_data(self, handle):
|
|
if handle in self.note_map:
|
|
return self.note_map[handle].serialize()
|
|
return None
|
|
|
|
def get_raw_place_data(self, handle):
|
|
if handle in self.place_map:
|
|
return self.place_map[handle].serialize()
|
|
return None
|
|
|
|
def get_raw_object_data(self, handle):
|
|
if handle in self.media_map:
|
|
return self.media_map[handle].serialize()
|
|
return None
|
|
|
|
def get_raw_tag_data(self, handle):
|
|
if handle in self.tag_map:
|
|
return self.tag_map[handle].serialize()
|
|
return None
|
|
|
|
def get_raw_event_data(self, handle):
|
|
if handle in self.event_map:
|
|
return self.event_map[handle].serialize()
|
|
return None
|
|
|
|
def add_person(self, person, trans, set_gid=True):
|
|
if not person.handle:
|
|
person.handle = create_id()
|
|
if not person.gramps_id and set_gid:
|
|
person.gramps_id = self.find_next_person_gramps_id()
|
|
self.commit_person(person, trans)
|
|
return person.handle
|
|
|
|
def add_family(self, family, trans, set_gid=True):
|
|
if not family.handle:
|
|
family.handle = create_id()
|
|
if not family.gramps_id and set_gid:
|
|
family.gramps_id = self.find_next_family_gramps_id()
|
|
self.commit_family(family, trans)
|
|
return family.handle
|
|
|
|
def add_citation(self, citation, trans, set_gid=True):
|
|
if not citation.handle:
|
|
citation.handle = create_id()
|
|
if not citation.gramps_id and set_gid:
|
|
citation.gramps_id = self.find_next_citation_gramps_id()
|
|
self.commit_citation(citation, trans)
|
|
return citation.handle
|
|
|
|
def add_source(self, source, trans, set_gid=True):
|
|
if not source.handle:
|
|
source.handle = create_id()
|
|
if not source.gramps_id and set_gid:
|
|
source.gramps_id = self.find_next_source_gramps_id()
|
|
self.commit_source(source, trans)
|
|
return source.handle
|
|
|
|
def add_repository(self, repository, trans, set_gid=True):
|
|
if not repository.handle:
|
|
repository.handle = create_id()
|
|
if not repository.gramps_id and set_gid:
|
|
repository.gramps_id = self.find_next_repository_gramps_id()
|
|
self.commit_repository(repository, trans)
|
|
return repository.handle
|
|
|
|
def add_note(self, note, trans, set_gid=True):
|
|
if not note.handle:
|
|
note.handle = create_id()
|
|
if not note.gramps_id and set_gid:
|
|
note.gramps_id = self.find_next_note_gramps_id()
|
|
self.commit_note(note, trans)
|
|
return note.handle
|
|
|
|
def add_place(self, place, trans, set_gid=True):
|
|
if not place.handle:
|
|
place.handle = create_id()
|
|
if not place.gramps_id and set_gid:
|
|
place.gramps_id = self.find_next_place_gramps_id()
|
|
self.commit_place(place, trans)
|
|
return place.handle
|
|
|
|
def add_event(self, event, trans, set_gid=True):
|
|
if not event.handle:
|
|
event.handle = create_id()
|
|
if not event.gramps_id and set_gid:
|
|
event.gramps_id = self.find_next_event_gramps_id()
|
|
self.commit_event(event, trans)
|
|
return event.handle
|
|
|
|
def add_tag(self, tag, trans):
|
|
if not tag.handle:
|
|
tag.handle = create_id()
|
|
self.commit_tag(tag, trans)
|
|
return tag.handle
|
|
|
|
def add_object(self, obj, transaction, set_gid=True):
|
|
"""
|
|
Add a MediaObject to the database, assigning internal IDs if they have
|
|
not already been defined.
|
|
|
|
If not set_gid, then gramps_id is not set.
|
|
"""
|
|
if not obj.handle:
|
|
obj.handle = create_id()
|
|
if not obj.gramps_id and set_gid:
|
|
obj.gramps_id = self.find_next_object_gramps_id()
|
|
self.commit_media_object(obj, transaction)
|
|
return obj.handle
|
|
|
|
def commit_person(self, person, trans, change_time=None):
|
|
if person.handle in self.person_map:
|
|
self.emit("person-update", ([person.handle],))
|
|
else:
|
|
self.emit("person-add", ([person.handle],))
|
|
self.person_map[person.handle] = person
|
|
|
|
def commit_family(self, family, trans, change_time=None):
|
|
if family.handle in self.family_map:
|
|
self.emit("family-update", ([family.handle],))
|
|
else:
|
|
self.emit("family-add", ([family.handle],))
|
|
self.family_map[family.handle] = family
|
|
|
|
def commit_citation(self, citation, trans, change_time=None):
|
|
if citation.handle in self.citation_map:
|
|
self.emit("citation-update", ([citation.handle],))
|
|
else:
|
|
self.emit("citation-add", ([citation.handle],))
|
|
self.citation_map[citation.handle] = citation
|
|
|
|
def commit_source(self, source, trans, change_time=None):
|
|
if source.handle in self.source_map:
|
|
self.emit("source-update", ([source.handle],))
|
|
else:
|
|
self.emit("source-add", ([source.handle],))
|
|
self.source_map[source.handle] = source
|
|
|
|
def commit_repository(self, repository, trans, change_time=None):
|
|
if repository.handle in self.repository_map:
|
|
self.emit("repository-update", ([repository.handle],))
|
|
else:
|
|
self.emit("repository-add", ([repository.handle],))
|
|
self.repository_map[repository.handle] = repository
|
|
|
|
def commit_note(self, note, trans, change_time=None):
|
|
if note.handle in self.note_map:
|
|
self.emit("note-update", ([note.handle],))
|
|
else:
|
|
self.emit("note-add", ([note.handle],))
|
|
self.note_map[note.handle] = note
|
|
|
|
def commit_place(self, place, trans, change_time=None):
|
|
if place.handle in self.place_map:
|
|
self.emit("place-update", ([place.handle],))
|
|
else:
|
|
self.emit("place-add", ([place.handle],))
|
|
self.place_map[place.handle] = place
|
|
|
|
def commit_event(self, event, trans, change_time=None):
|
|
if event.handle in self.event_map:
|
|
self.emit("event-update", ([event.handle],))
|
|
else:
|
|
self.emit("event-add", ([event.handle],))
|
|
self.event_map[event.handle] = event
|
|
|
|
def commit_tag(self, tag, trans, change_time=None):
|
|
if tag.handle in self.tag_map:
|
|
self.emit("tag-update", ([tag.handle],))
|
|
else:
|
|
self.emit("tag-add", ([tag.handle],))
|
|
self.tag_map[tag.handle] = tag
|
|
|
|
def commit_media_object(self, media, transaction, change_time=None):
|
|
if media.handle in self.media_map:
|
|
self.emit("media-update", ([media.handle],))
|
|
else:
|
|
self.emit("media-add", ([media.handle],))
|
|
self.media_map[media.handle] = media
|
|
|
|
def get_gramps_ids(self, obj_key):
|
|
key2table = {
|
|
PERSON_KEY: self.person_map,
|
|
FAMILY_KEY: self.family_map,
|
|
CITATION_KEY: self.citation_map,
|
|
SOURCE_KEY: self.source_map,
|
|
EVENT_KEY: self.event_map,
|
|
MEDIA_KEY: self.media_map,
|
|
PLACE_KEY: self.place_map,
|
|
REPOSITORY_KEY: self.repository_map,
|
|
NOTE_KEY: self.note_map,
|
|
}
|
|
table = key2table[obj_key]
|
|
return [item.gramps_id for item in table.values()]
|
|
|
|
def transaction_begin(self, transaction):
|
|
return
|
|
|
|
def disable_signals(self):
|
|
pass
|
|
|
|
def set_researcher(self, owner):
|
|
pass
|
|
|
|
def request_rebuild(self):
|
|
self.emit('person-rebuild')
|
|
self.emit('family-rebuild')
|
|
self.emit('place-rebuild')
|
|
self.emit('source-rebuild')
|
|
self.emit('citation-rebuild')
|
|
self.emit('media-rebuild')
|
|
self.emit('event-rebuild')
|
|
self.emit('repository-rebuild')
|
|
self.emit('note-rebuild')
|
|
self.emit('tag-rebuild')
|
|
|
|
def copy_from_db(self, db):
|
|
"""
|
|
A (possibily) implementation-specific method to get data from
|
|
db into this database.
|
|
"""
|
|
for key in db._tables.keys():
|
|
cursor = db._tables[key]["cursor_func"]
|
|
class_ = db._tables[key]["class_func"]
|
|
for (handle, data) in cursor():
|
|
map = getattr(self, "%s_map" % key.lower())
|
|
map[handle] = class_.create(data)
|
|
|
|
def get_transaction_class(self):
|
|
"""
|
|
Get the transaction class associated with this database backend.
|
|
"""
|
|
return DictionaryTxn
|
|
|
|
def get_from_name_and_handle(self, table_name, handle):
|
|
"""
|
|
Returns a gen.lib object (or None) given table_name and
|
|
handle.
|
|
|
|
Examples:
|
|
|
|
>>> self.get_from_name_and_handle("Person", "a7ad62365bc652387008")
|
|
>>> self.get_from_name_and_handle("Media", "c3434653675bcd736f23")
|
|
"""
|
|
if table_name in self._tables:
|
|
return self._tables[table_name]["handle_func"](handle)
|
|
return None
|
|
|
|
def get_from_name_and_gramps_id(self, table_name, gramps_id):
|
|
"""
|
|
Returns a gen.lib object (or None) given table_name and
|
|
Gramps ID.
|
|
|
|
Examples:
|
|
|
|
>>> self.get_from_name_and_gramps_id("Person", "I00002")
|
|
>>> self.get_from_name_and_gramps_id("Family", "F056")
|
|
>>> self.get_from_name_and_gramps_id("Media", "M00012")
|
|
"""
|
|
if table_name in self._tables:
|
|
return self._tables[table_name]["gramps_id_func"](gramps_id)
|
|
return None
|
|
|
|
def remove_person(self, handle, transaction):
|
|
"""
|
|
Remove the Person specified by the database handle from the database,
|
|
preserving the change in the passed transaction.
|
|
"""
|
|
|
|
if self.readonly or not handle:
|
|
return
|
|
if handle in self.person_map:
|
|
del self.person_map[handle]
|
|
self.emit("person-delete", ([handle],))
|
|
|
|
def remove_source(self, handle, transaction):
|
|
"""
|
|
Remove the Source specified by the database handle from the
|
|
database, preserving the change in the passed transaction.
|
|
"""
|
|
self.__do_remove(handle, transaction, self.source_map,
|
|
SOURCE_KEY)
|
|
|
|
def remove_citation(self, handle, transaction):
|
|
"""
|
|
Remove the Citation specified by the database handle from the
|
|
database, preserving the change in the passed transaction.
|
|
"""
|
|
self.__do_remove(handle, transaction, self.citation_map,
|
|
CITATION_KEY)
|
|
|
|
def remove_event(self, handle, transaction):
|
|
"""
|
|
Remove the Event specified by the database handle from the
|
|
database, preserving the change in the passed transaction.
|
|
"""
|
|
self.__do_remove(handle, transaction, self.event_map,
|
|
EVENT_KEY)
|
|
|
|
def remove_object(self, handle, transaction):
|
|
"""
|
|
Remove the MediaObjectPerson specified by the database handle from the
|
|
database, preserving the change in the passed transaction.
|
|
"""
|
|
self.__do_remove(handle, transaction, self.media_map,
|
|
MEDIA_KEY)
|
|
|
|
def remove_place(self, handle, transaction):
|
|
"""
|
|
Remove the Place specified by the database handle from the
|
|
database, preserving the change in the passed transaction.
|
|
"""
|
|
self.__do_remove(handle, transaction, self.place_map,
|
|
PLACE_KEY)
|
|
|
|
def remove_family(self, handle, transaction):
|
|
"""
|
|
Remove the Family specified by the database handle from the
|
|
database, preserving the change in the passed transaction.
|
|
"""
|
|
self.__do_remove(handle, transaction, self.family_map,
|
|
FAMILY_KEY)
|
|
|
|
def remove_repository(self, handle, transaction):
|
|
"""
|
|
Remove the Repository specified by the database handle from the
|
|
database, preserving the change in the passed transaction.
|
|
"""
|
|
self.__do_remove(handle, transaction, self.repository_map,
|
|
REPOSITORY_KEY)
|
|
|
|
def remove_note(self, handle, transaction):
|
|
"""
|
|
Remove the Note specified by the database handle from the
|
|
database, preserving the change in the passed transaction.
|
|
"""
|
|
self.__do_remove(handle, transaction, self.note_map,
|
|
NOTE_KEY)
|
|
|
|
def remove_tag(self, handle, transaction):
|
|
"""
|
|
Remove the Tag specified by the database handle from the
|
|
database, preserving the change in the passed transaction.
|
|
"""
|
|
self.__do_remove(handle, transaction, self.tag_map,
|
|
TAG_KEY)
|
|
|
|
def is_empty(self):
|
|
"""
|
|
Return true if there are no [primary] records in the database
|
|
"""
|
|
for table in self._tables:
|
|
if len(self._tables[table]["handles_func"]()) > 0:
|
|
return False
|
|
return True
|
|
|
|
def __do_remove(self, handle, transaction, data_map, key):
|
|
if self.readonly or not handle:
|
|
return
|
|
if isinstance(handle, str):
|
|
handle = handle.encode('utf-8')
|
|
if handle in data_map:
|
|
del data_map[handle]
|
|
self.emit(KEY_TO_NAME_MAP[key] + "-delete", ([handle],))
|
|
|
|
def delete_primary_from_reference_map(self, handle, transaction, txn=None):
|
|
"""
|
|
Remove all references to the primary object from the reference_map.
|
|
handle should be utf-8
|
|
"""
|
|
primary_cur = self.get_reference_map_primary_cursor()
|
|
|
|
try:
|
|
ret = primary_cur.set(handle)
|
|
except:
|
|
ret = None
|
|
|
|
remove_list = set()
|
|
while (ret is not None):
|
|
(key, data) = ret
|
|
|
|
# data values are of the form:
|
|
# ((primary_object_class_name, primary_object_handle),
|
|
# (referenced_object_class_name, referenced_object_handle))
|
|
|
|
# so we need the second tuple give us a reference that we can
|
|
# combine with the primary_handle to get the main key.
|
|
main_key = (handle.decode('utf-8'), pickle.loads(data)[1][1])
|
|
|
|
# The trick is not to remove while inside the cursor,
|
|
# but collect them all and remove after the cursor is closed
|
|
remove_list.add(main_key)
|
|
|
|
ret = primary_cur.next_dup()
|
|
|
|
primary_cur.close()
|
|
|
|
# Now that the cursor is closed, we can remove things
|
|
for main_key in remove_list:
|
|
self.__remove_reference(main_key, transaction, txn)
|
|
|
|
def __remove_reference(self, key, transaction, txn):
|
|
"""
|
|
Remove the reference specified by the key, preserving the change in
|
|
the passed transaction.
|
|
"""
|
|
if isinstance(key, tuple):
|
|
#create a byte string key, first validity check in python 3!
|
|
for val in key:
|
|
if isinstance(val, bytes):
|
|
raise DbError(_('An attempt is made to save a reference key '
|
|
'which is partly bytecode, this is not allowed.\n'
|
|
'Key is %s') % str(key))
|
|
key = str(key)
|
|
if isinstance(key, str):
|
|
key = key.encode('utf-8')
|
|
if not self.readonly:
|
|
if not transaction.batch:
|
|
old_data = self.reference_map.get(key, txn=txn)
|
|
transaction.add(REFERENCE_KEY, TXNDEL, key, old_data, None)
|
|
#transaction.reference_del.append(str(key))
|
|
self.reference_map.delete(key, txn=txn)
|
|
|
|
## Missing:
|
|
|
|
def backup(self):
|
|
pass
|
|
|
|
def close(self):
|
|
if self._directory:
|
|
from gramps.plugins.export.exportxml import XmlWriter
|
|
from gramps.cli.user import User
|
|
writer = XmlWriter(self, User(), strip_photos=0, compress=1)
|
|
filename = os.path.join(self._directory, "data.gramps")
|
|
writer.write(filename)
|
|
|
|
def find_backlink_handles(self, handle, include_classes=None):
|
|
return []
|
|
|
|
def find_initial_person(self):
|
|
items = self.person_map.keys()
|
|
if len(items) > 0:
|
|
return self.get_person_from_handle(list(items)[0])
|
|
return None
|
|
|
|
def find_place_child_handles(self, handle):
|
|
return []
|
|
|
|
def get_bookmarks(self):
|
|
return self.bookmarks
|
|
|
|
def get_child_reference_types(self):
|
|
return []
|
|
|
|
def get_citation_bookmarks(self):
|
|
return self.citation_bookmarks
|
|
|
|
def get_cursor(self, table, txn=None, update=False, commit=False):
|
|
pass
|
|
|
|
def get_dbname(self):
|
|
return "DictionaryDb"
|
|
|
|
def get_default_handle(self):
|
|
items = self.person_map.keys()
|
|
if len(items) > 0:
|
|
return list(items)[0]
|
|
return None
|
|
|
|
def get_event_attribute_types(self):
|
|
return []
|
|
|
|
def get_event_bookmarks(self):
|
|
return self.event_bookmarks
|
|
|
|
def get_event_roles(self):
|
|
return []
|
|
|
|
def get_event_types(self):
|
|
return []
|
|
|
|
def get_family_attribute_types(self):
|
|
return []
|
|
|
|
def get_family_bookmarks(self):
|
|
return self.family_bookmarks
|
|
|
|
def get_family_event_types(self):
|
|
return []
|
|
|
|
def get_family_relation_types(self):
|
|
return []
|
|
|
|
def get_media_attribute_types(self):
|
|
return []
|
|
|
|
def get_media_bookmarks(self):
|
|
return self.media_bookmarks
|
|
|
|
def get_name_types(self):
|
|
return []
|
|
|
|
def get_note_bookmarks(self):
|
|
return self.note_bookmarks
|
|
|
|
def get_note_types(self):
|
|
return []
|
|
|
|
def get_number_of_records(self, table):
|
|
return 0
|
|
|
|
def get_origin_types(self):
|
|
return []
|
|
|
|
def get_person_attribute_types(self):
|
|
return []
|
|
|
|
def get_person_event_types(self):
|
|
return []
|
|
|
|
def get_place_bookmarks(self):
|
|
return self.place_bookmarks
|
|
|
|
def get_place_tree_cursor(self):
|
|
return []
|
|
|
|
def get_place_types(self):
|
|
return []
|
|
|
|
def get_repo_bookmarks(self):
|
|
return self.repo_bookmarks
|
|
|
|
def get_repository_types(self):
|
|
return []
|
|
|
|
def get_save_path(self):
|
|
return self._directory
|
|
|
|
def get_source_attribute_types(self):
|
|
return []
|
|
|
|
def get_source_bookmarks(self):
|
|
return self.source_bookmarks
|
|
|
|
def get_source_media_types(self):
|
|
return []
|
|
|
|
def get_surname_list(self):
|
|
return []
|
|
|
|
def get_url_types(self):
|
|
return []
|
|
|
|
def has_changed(self):
|
|
return True
|
|
|
|
def is_open(self):
|
|
return True
|
|
|
|
def iter_citation_handles(self):
|
|
return (key for key in self.citation_map.keys())
|
|
|
|
def iter_citations(self):
|
|
return (key for key in self.citation_map.values())
|
|
|
|
def iter_event_handles(self):
|
|
return (key for key in self.event_map.keys())
|
|
|
|
def iter_events(self):
|
|
return (key for key in self.event_map.values())
|
|
|
|
def iter_media_objects(self):
|
|
return (key for key in self.media_map.values())
|
|
|
|
def iter_note_handles(self):
|
|
return (key for key in self.note_map.keys())
|
|
|
|
def iter_notes(self):
|
|
return (key for key in self.note_map.values())
|
|
|
|
def iter_place_handles(self):
|
|
return (key for key in self.place_map.keys())
|
|
|
|
def iter_places(self):
|
|
return (key for key in self.place_map.values())
|
|
|
|
def iter_repositories(self):
|
|
return (key for key in self.repositories_map.values())
|
|
|
|
def iter_repository_handles(self):
|
|
return (key for key in self.repositories_map.keys())
|
|
|
|
def iter_source_handles(self):
|
|
return (key for key in self.source_map.keys())
|
|
|
|
def iter_sources(self):
|
|
return (key for key in self.source_map.values())
|
|
|
|
def iter_tag_handles(self):
|
|
return (key for key in self.tag_map.keys())
|
|
|
|
def iter_tags(self):
|
|
return (key for key in self.tag_map.values())
|
|
|
|
def load(self, directory, pulse_progress=None, mode=None,
|
|
force_schema_upgrade=False,
|
|
force_bsddb_upgrade=False,
|
|
force_bsddb_downgrade=False,
|
|
force_python_upgrade=False):
|
|
from gramps.plugins.importer.importxml import importData
|
|
from gramps.cli.user import User
|
|
self._directory = directory
|
|
filename = os.path.join(directory, "data.gramps")
|
|
if os.path.isfile(filename):
|
|
importData(self, filename, User())
|
|
|
|
def prepare_import(self):
|
|
pass
|
|
|
|
def redo(self, update_history=True):
|
|
pass
|
|
|
|
def restore(self):
|
|
pass
|
|
|
|
def set_prefixes(self, person, media, family, source, citation,
|
|
place, event, repository, note):
|
|
pass
|
|
|
|
def set_save_path(self, directory):
|
|
self._directory = directory
|
|
|
|
def undo(self, update_history=True):
|
|
pass
|