Addon:Generic DB Access lib - Revision history

Gioto: meaningless image

2025-10-31T23:13:48Z

meaningless image

2024-12-28T00:45:05Z

2022-02-22T21:39:05Z

‎See also: fix broken link

2022-02-22T21:33:17Z

Patsyblefebre moved page Libaccess to Addon:Generic DB Access lib: Change name to match listing in addon manager

2022-02-22T21:25:13Z

‎See also: add link to SuperTool

2020-05-13T07:29:04Z

pretty much an abandoned prototype

2020-05-13T07:26:19Z

place holder

2020-05-13T07:22:24Z

‎See also

2020-05-13T07:19:34Z

‎See also

2020-05-13T07:14:31Z

‎Example

@@ Line 1: / Line 1: @@
 {{Third-party addon}}
 {{man warn|Experimental library|Please only use on a copy of your Family Tree}}
 The {{man label|Generic DB Access lib}} (AKA libaccess) is an experimental library that provides generic access to the database and the [https://gramps-project.org/docs/gen/gen_lib.html#module-gramps.gen.lib gen.lib interface](AKA The core library of Gramps objects ). It was designed to simplify the manner in which developers interact with Gramps.

@@ Line 1: / Line 1: @@
-{{Third-party plugin}}
+{{Third-party addon}}
 {{man warn|Experimental library|Please only use on a copy of your Family Tree}}
 [[File:Libaccess.jpg|right|thumb]]

@@ Line 36: / Line 36: @@
 * [https://gramps-project.org/blog/2010/01/alternative-interfaces/ Alternative Interfaces], Date: January 23rd, 2010, by Doug Blank, who introduced {{man label|libaccess}} in Gramps 3.2.
 * Source code for Gramps master: https://github.com/gramps-project/addons-source/tree/master/libaccess
-* [http://gramps.1791082.n4.nabble.com/GEPS-single-line-sql-like-filter-field-libaccess-based-td4657599.html GEPS : single-line sql-like filter field (libaccess based ?)], Dec 11, 2012, ''...I don't plan on developing that particular prototype[libaccess] any further,...''' Doug Blank
+* [https://sourceforge.net/p/gramps/mailman/message/30213240/ GEPS : single-line sql-like filter field (libaccess based ?)], Dec 11, 2012, ''...I don't plan on developing that particular prototype[libaccess] any further,...''' Doug Blank
 * [[GEPS 017: Flexible gen.lib Interface]] - Proposal was withdrawn as after building a prototype, it was found to be too slow for general use.
 * [[Addon:Isotammi_addons#SuperTool]] - general purpose scripting tool that can be used to do "ad-hoc" queries against a Gramps family tree/database.

@@ Line 38: / Line 38: @@
 * [http://gramps.1791082.n4.nabble.com/GEPS-single-line-sql-like-filter-field-libaccess-based-td4657599.html GEPS : single-line sql-like filter field (libaccess based ?)], Dec 11, 2012, ''...I don't plan on developing that particular prototype[libaccess] any further,...''' Doug Blank
 * [[GEPS 017: Flexible gen.lib Interface]] - Proposal was withdrawn as after building a prototype, it was found to be too slow for general use.
 [[Category:Plugins]]
 [[Category:Developers/General]]
 [[Category:Reports]]

@@ Line 3: / Line 3: @@
 [[File:Libaccess.jpg|right|thumb]]
 The {{man label|Generic DB Access lib}} (AKA libaccess) is an experimental library that provides generic access to the database and the [https://gramps-project.org/docs/gen/gen_lib.html#module-gramps.gen.lib gen.lib interface](AKA The core library of Gramps objects ). It was designed to simplify the manner in which developers interact with Gramps.
-{{stub}}
 == Usage ==

← Older revision	Revision as of 21:33, 22 February 2022
(No difference)

← Older revision		Revision as of 07:14, 13 May 2020
Line 6:		Line 6:

	=== Example ===		=== Example ===
		+	Consider the problem of finding out how many people were born in March. Basically, we need to go through the database, get the reference (if one) to the birth event, look up the birth event, if found, get the date from it, get the month and compare it. That might look like this:
		+
		+	<pre>
		+	count = 0
		+	for p in db.iter_people():
		+	birth_ref = p.get_birth_ref()
		+	if birth_ref:
		+	event = db.get_event_from_handle(birth_ref.ref)
		+	if event:
		+	date = event.get_date_object()
		+	if date.get_month() == 3:
		+	count += 1
		+	</pre>
		+
		+	This example is not unusual; you’d have to do something like this whatever it is that you are doing. And this is a simple example. It can get much more complicated. But even in this “simple” example, you have to know a lot about the gen.lib objects that make up Gramps (things like Person, Event, and Date) but you also need to know the interface to the database (things like iter_people, get_event_from_handle) and how things are linked together (handles and refs).
		+
	Here is how you would solve the above using this experimental Gramps addon:		Here is how you would solve the above using this experimental Gramps addon: