#
# Gramps - a GTK+/GNOME based genealogy program
#
# Copyright (C) 2000-2007 Donald N. Allingham
# Copyright (C) 2013 Doug 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.
#
"""
Researcher information for Gramps.
"""
#-------------------------------------------------------------------------
#
# GRAMPS modules
#
#-------------------------------------------------------------------------
from .locationbase import LocationBase
#-------------------------------------------------------------------------
#
#
#
#-------------------------------------------------------------------------
[docs]class Researcher(LocationBase):
"""Contains the information about the owner of the database."""
def __init__(self, source=None):
"""
Initialize the Researcher object, copying from the source if provided.
"""
LocationBase.__init__(self, source)
if source:
self.name = source.name
self.addr = source.addr
self.email = source.email
else:
self.name = ""
self.addr = ""
self.email = ""
[docs] def serialize(self):
"""
Convert the object to a serialized tuple of data.
"""
return (LocationBase.serialize(self),
self.name, self.addr, self.email)
[docs] def to_struct(self):
"""
Convert the data held in this object to a structure (eg,
struct) that represents all the data elements.
This method is used to recursively convert the object into a
self-documenting form that can easily be used for various
purposes, including diffs and queries.
These structures may be primitive Python types (string,
integer, boolean, etc.) or complex Python types (lists,
tuples, or dicts). If the return type is a dict, then the keys
of the dict match the fieldname of the object. If the return
struct (or value of a dict key) is a list, then it is a list
of structs. Otherwise, the struct is just the value of the
attribute.
:returns: Returns a struct containing the data of the object.
:rtype: dict
"""
return {"_class": "Researcher",
"street": self.street,
"locality": self.locality,
"city": self.city,
"country": self.county,
"state": self.state,
"country": self.country,
"postal": self.postal,
"phone": self.phone,
"name": self.name,
"address": self.addr,
"email": self.email}
@classmethod
[docs] def from_struct(cls, struct):
"""
Given a struct data representation, return a serialized object.
:returns: Returns a serialized object
"""
default = Researcher()
return (struct.get("street", default.street),
struct.get("locality", default.locality),
struct.get("city", default.city),
struct.get("country", default.country),
struct.get("state", default.state),
struct.get("country", default.country),
struct.get("postal", default.postal),
struct.get("phone", default.phone),
struct.get("name", default.name),
struct.get("address", default.address),
struct.get("email", default.email))
[docs] def unserialize(self, data):
"""
Convert a serialized tuple of data to an object.
"""
(location, self.name, self.addr, self.email) = data
LocationBase.unserialize(self, location)
return self
[docs] def set_name(self, data):
"""Set the database owner's name."""
self.name = data
[docs] def get_name(self):
"""Return the database owner's name."""
return self.name
[docs] def set_address(self, data):
"""Set the database owner's address."""
self.addr = data
[docs] def get_address(self):
"""Return the database owner's address."""
return self.addr
[docs] def set_email(self, data):
""" Set the database owner's email."""
self.email = data
[docs] def get_email(self):
"""Return the database owner's email."""
return self.email
[docs] def set_from(self, other_researcher):
"""Set all attributes from another instance."""
self.street = other_researcher.street
self.locality = other_researcher.locality
self.city = other_researcher.city
self.county = other_researcher.county
self.state = other_researcher.state
self.country = other_researcher.country
self.postal = other_researcher.postal
self.phone = other_researcher.phone
self.name = other_researcher.name
self.addr = other_researcher.addr
self.email = other_researcher.email
[docs] def get(self):
return [getattr(self, value) for value in
['name', 'addr', 'locality', 'city', 'state',
'country', 'postal', 'phone', 'email']
]