Simple Access API/he

הSimple Access API הוצג לראשונה בגרסת גרמפס ‎3.0.x זהו ממשק API למסד נתונים ([1]) שמיועד בעקרון למפתחי תוספים עבור גרמפס

ה־Simple Access API, בליווי ממשק ה־API של מסמך פשוט להנגשת נתונים קלה, נבנו במטרה להסיר מורכבויות ככל שניתן.

מבוא

שגרות מסד הנתונים הרגילות מותאמות לשימוש נמוך בזיכרון, ואם נעשה בהן שימוש נכון, כמעט ולא יתפסו זיכרון. זה המפתח בעת שימוש במסדי נתונים גדולים. בדרך כלל, במקום לשמור על מילונים או רשימות של אובייקטים, אנו יכולים להשתמש במסד הנתונים "handles", ולגשת לנתונים רק כאשר יש צורך במפורש. יעילות הזיכרון הזו באה במחיר של היותה מסובכת למדי לשימוש.

ה-API הפשוט מסתיר את רוב המורכבות. אובייקטים מלאים מוחזרים, כך שאתה יכול בקלות לצרוך הרבה זיכרון עם מסדי נתונים גדולים. השגרות עצמן אינן צורכות כמות משמעותית של זיכרון, אך אם החלטתם לשמור רשימות או מילוני נתונים משלכם, תצרכו זיכרון במהירות.

מחלקות פשוטות אלו בנויות במיוחד לשימוש בתוספים/תוספות, או כדי ליצור צפיות מהירות (זמינות בתפריט ההקשר).

מה זמין?

ניתן להציג את ה־API ב־_simpleaccess.py.

תוכן מאמר זה לא שלם או שהוא 'בדל' שמשמש כמציין מיקום. נא לעדכן או להרחיב את הקטע הזה.

Example use:

from __future__ import print_function

from simple import simpleaccess

sdb = simpleaccess(database)

# grab our current id, so we can filter the active person out
# of the data
person = database.active_person()
gid = sdb.gid(database.active_person())

# loop through each family in which the person is a child
for family in sdb.child_in(person):

    # loop through each child in the family
    for child in sdb.children(family):

        #print something to terminal
        print(sdb.name(child),sdb.gender(child), sdb.birth_date(child)))

See also

• The Simple Classes - Gramps API documentation
• Simple Document API interface for easy presentation of the data.
• Quick Views
• Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Making_your_own_Quick_view
• Writing a plugin
• Report-writing tutorial