ó 'nD^c@sôddlZddlmZddlmZddlmZmZddl m Z ddl m Z m Z ddlmZddlmZddlZd ZejjZejjZd ZejjZd efd „ƒYZd efd„ƒYZ dS(iÿÿÿÿN(t version_info(tElement(t FamilyElementtNotAnActualFamilyError(t FileElement(tIndividualElementtNotAnActualIndividualError(t ObjectElement(t RootElementtALLtPARENTStGedcomFormatViolationErrorcBseZRS((t__name__t __module__(((sT/var/www/genealogy.alanbeam.net/app/env/lib/python3.5/site-packages/gedcom/parser.pyR -stParsercBsãeZdZd„Zd„Zd„Zd„Zd„Zd„Ze d„Z e e d„ƒZ d „Z d „Zd „Zd „Zd „Zejjd„Zdd„Zdd„Zdd„Zed„Zd„Zd„ZRS(s„Parses and manipulates GEDCOM 5.5 format data For documentation of the GEDCOM 5.5 format, see: http://homepages.rootsweb.ancestry.com/~pmcbride/gedcom/55gctoc.htm This parser reads and parses a GEDCOM file. Elements may be accessed via: - a list (all elements, default order is same as in file) - a dict (only elements with pointers, which are the keys) cCs"g|_i|_tƒ|_dS(s Initialize a GEDCOM data object.N(t_Parser__element_listt_Parser__element_dictionaryRt_Parser__root_element(tself((sT/var/www/genealogy.alanbeam.net/app/env/lib/python3.5/site-packages/gedcom/parser.pyt__init__=s  cCsg|_i|_dS(sÞEmpties the element list and dictionary to cause `get_element_list()` and `get_element_dictionary()` to return updated data The update gets deferred until each of the methods actually gets called. N(RR(R((sT/var/www/genealogy.alanbeam.net/app/env/lib/python3.5/site-packages/gedcom/parser.pytinvalidate_cacheCs cCs=|js6x*|jƒD]}|j||jƒqWn|jS(sReturns a list containing all elements from within the GEDCOM file By default elements are in the same order as they appeared in the file. This list gets generated on-the-fly, but gets cached. If the database was modified, you should call `invalidate_cache()` once to let this method return updated data. Consider using `get_root_element()` or `get_root_child_elements()` to access the hierarchical GEDCOM tree, unless you rarely modify the database. :rtype: list of Element (Rtget_root_child_elementst_Parser__build_list(Rtelement((sT/var/www/genealogy.alanbeam.net/app/env/lib/python3.5/site-packages/gedcom/parser.pytget_element_listLs cCs,|js%d„|jƒDƒ|_n|jS(sÔReturns a dictionary containing all elements, identified by a pointer, from within the GEDCOM file Only elements identified by a pointer are listed in the dictionary. The keys for the dictionary are the pointers. This dictionary gets generated on-the-fly, but gets cached. If the database was modified, you should call `invalidate_cache()` once to let this method return updated data. :rtype: dict of Element cSs+i|]!}|jƒr||jƒ“qS((t get_pointer(t.0R((sT/var/www/genealogy.alanbeam.net/app/env/lib/python3.5/site-packages/gedcom/parser.pys ms (RR(R((sT/var/www/genealogy.alanbeam.net/app/env/lib/python3.5/site-packages/gedcom/parser.pytget_element_dictionary_s cCs|jS(s°Returns a virtual root element containing all logical records as children When printed, this element converts to an empty string. :rtype: RootElement (R(R((sT/var/www/genealogy.alanbeam.net/app/env/lib/python3.5/site-packages/gedcom/parser.pytget_root_elementrscCs|jƒjƒS(s°Returns a list of logical records in the GEDCOM file By default, elements are in the same order as they appeared in the file. :rtype: list of Element (Rtget_child_elements(R((sT/var/www/genealogy.alanbeam.net/app/env/lib/python3.5/site-packages/gedcom/parser.pyR{scCsw|jƒtƒ|_t|dƒ}d}|jƒ}x9|D]1}|j||jdƒ||ƒ}|d7}q>WdS(sOpens and parses a file, from the given file path, as GEDCOM 5.5 formatted data :type file_path: str :type strict: bool trbis utf-8-sigN(RRRtopenRt_Parser__parse_linetdecode(Rt file_pathtstrictt gedcom_filet line_numbert last_elementtline((sT/var/www/genealogy.alanbeam.net/app/env/lib/python3.5/site-packages/gedcom/parser.pyt parse_file„s    !cCsKd}d}d}d}d}|||||} tj| |ƒ} | dkr™|rud|d} t| ƒ‚qê||||} tj| |ƒ} | dk rõ| jƒ} t| dƒ}| d jd ƒ}| d }| d d }d }qêd}||}tj||ƒ} | jƒ} |jƒ}|jƒ}d}| dd }| d }|t j j krê|t j j krê|d 7}t j j }qênQ| jƒ} t| dƒ}| d jd ƒ}| d }| d d }| d}||jƒd kr!d|dd} t| ƒ‚n|t j j krTt|||||dtƒ}n·|t j jkr‡t|||||dtƒ}n„|t j jkrºt|||||dtƒ}nQ|t j jkrít|||||dtƒ}nt|||||dtƒ}|}x&|jƒ|d kr9|jƒ}qW|j|ƒ|S(sTParse a line from a GEDCOM 5.5 formatted document Each line should have the following (bracketed items optional): level + ' ' + [pointer + ' ' +] tag + [' ' + line_value] :type line_number: int :type line: str :type last_element: Element :type strict: bool :rtype: Element s^(0|[1-9]+[0-9]*) s (@[^@]+@ |)s([A-Za-z0-9_]+)s ( [^ ]*|)s ([ ]{1,2})s.Line %d of document violates GEDCOM format 5.5sJ See: https://chronoplexsoftware.com/gedcomvalidator/gedcom/gedcom-5.5.pdfiit iis s ([^ ]*|)is@ Lines must be no more than one level higher than previous line.t multi_lineN(tregextmatchtNoneR tgroupstinttrstript get_leveltget_tagtgedcomttagstGEDCOM_TAG_CONTINUEDtGEDCOM_TAG_CONCATENATIONtGEDCOM_TAG_INDIVIDUALRtFalsetGEDCOM_TAG_FAMILYRtGEDCOM_TAG_FILERtGEDCOM_TAG_OBJECTRRtget_parent_elementtadd_child_element(R%R'R&R#t level_regext pointer_regext tag_regext value_regextend_of_line_regextgedcom_line_regext regex_matcht error_messagetlast_line_regext line_partstleveltpointerttagtvaluetcrlft line_regextcont_line_regexRtparent_element((sT/var/www/genealogy.alanbeam.net/app/env/lib/python3.5/site-packages/gedcom/parser.pyt __parse_line–sp          $    !!!! cCs8|j|ƒx$|jƒD]}|j||ƒqWdS(sŠRecursively add elements to a list containing elements :type element: Element :type element_list: list of Element N(tappendRR(RRt element_listtchild((sT/var/www/genealogy.alanbeam.net/app/env/lib/python3.5/site-packages/gedcom/parser.pyt __build_lists c Csg}t|tƒs.tdtjjƒ‚n|j|tjjƒ}xÄ|D]¼}x³|jƒD]¥}|j ƒtjj kr`d}d}xb|jƒD]T}|j ƒtjj krÄ|j ƒ}n|j ƒtjj kr—|j ƒ}q—q—W|j||fƒq`q`WqMW|S(s¦Returns a list of marriages of an individual formatted as a tuple (`str` date, `str` place) :type individual: IndividualElement :rtype: tuple s-Operation only valid for elements with %s tagt(t isinstanceRRR3R4R7t get_familiestGEDCOM_TAG_FAMILY_SPOUSERR2tGEDCOM_TAG_MARRIAGEtGEDCOM_TAG_DATEt get_valuetGEDCOM_TAG_PLACERQ( Rt individualt marriagestfamiliestfamilyt family_datatdatetplacet marriage_data((sT/var/www/genealogy.alanbeam.net/app/env/lib/python3.5/site-packages/gedcom/parser.pyt get_marriages s" cCsg}t|tƒs.tdtjjƒ‚n|j|tjjƒ}x³|D]«}x¢|jƒD]”}|j ƒtjj kr`xs|jƒD]b}|j ƒtjj kr‹|j ƒj ƒd}y|jt|ƒƒWqítk réqíXq‹q‹Wq`q`WqMW|S(s‘Returns a list of marriage years (as integers) for an individual :type individual: IndividualElement :rtype: list of int s-Operation only valid for elements with %s tagiÿÿÿÿ(RVRRR3R4R7RWRXRR2RYRZR[tsplitRQR/t ValueError(RR]tdatesR_R`RSt childOfChildRb((sT/var/www/genealogy.alanbeam.net/app/env/lib/python3.5/site-packages/gedcom/parser.pytget_marriage_years%s   cCsAt|tƒs(tdtjjƒ‚n|j|ƒ}||kS(sÅChecks if one of the marriage years of an individual matches the supplied year. Year is an integer. :type individual: IndividualElement :type year: int :rtype: bool s-Operation only valid for elements with %s tag(RVRRR3R4R7Rj(RR]tyeartyears((sT/var/www/genealogy.alanbeam.net/app/env/lib/python3.5/site-packages/gedcom/parser.pytmarriage_year_match?s cCslt|tƒs(tdtjjƒ‚n|j|ƒ}x.|D]&}||ko[|knr>tSq>WtS(sÞCheck if one of the marriage years of an individual is in a given range. Years are integers. :type individual: IndividualElement :type from_year: int :type to_year: int :rtype: bool s-Operation only valid for elements with %s tag( RVRRR3R4R7RjtTrueR8(RR]t from_yeartto_yearRlRk((sT/var/www/genealogy.alanbeam.net/app/env/lib/python3.5/site-packages/gedcom/parser.pytmarriage_range_matchMs cCs¯t|tƒs(tdtjjƒ‚ng}|jƒ}xn|jƒD]`}|jƒ|ko„|j ƒ|ko„||j ƒj ƒ}|rG|j ||j ƒƒqGqGW|S(sÓReturn family elements listed for an individual family_type can be `gedcom.tags.GEDCOM_TAG_FAMILY_SPOUSE` (families where the individual is a spouse) or `gedcom.tags.GEDCOM_TAG_FAMILY_CHILD` (families where the individual is a child). If a value is not provided, `gedcom.tags.GEDCOM_TAG_FAMILY_SPOUSE` is default value. :type individual: IndividualElement :type family_type: str :rtype: list of FamilyElement s-Operation only valid for elements with %s tag( RVRRR3R4R7RRR2R[t is_familyRQ(RR]t family_typeR_telement_dictionaryt child_elementRr((sT/var/www/genealogy.alanbeam.net/app/env/lib/python3.5/site-packages/gedcom/parser.pyRW_s  R cCsxt|tƒs(tdtjjƒ‚n|j||ƒ}g}|j|ƒx$|D]}|j|j|ƒƒqTW|S(sAReturn elements corresponding to ancestors of an individual Optional `ancestor_type`. Default "ALL" returns all ancestors, "NAT" can be used to specify only natural (genetic) ancestors. :type individual: IndividualElement :type ancestor_type: str :rtype: list of Element s-Operation only valid for elements with %s tag( RVRRR3R4R7t get_parentstextendt get_ancestors(RR]t ancestor_typetparentst ancestorstparent((sT/var/www/genealogy.alanbeam.net/app/env/lib/python3.5/site-packages/gedcom/parser.pyRx{s   cCsdt|tƒs(tdtjjƒ‚ng}|j|tjjƒ}x|D]}|dkrFxú|jƒD]Ó}|j ƒtjj krl|j ƒ|j ƒkrlxš|jƒD]‰}|j ƒdkr¯|j ƒtjj krþ||j|tjjƒ7}q8|j ƒtjjkr8||j|tjjƒ7}q8q¯q¯WqlqlWqM||j|dƒ7}qMW|S(s?Return elements corresponding to parents of an individual Optional parent_type. Default "ALL" returns all parents. "NAT" can be used to specify only natural (genetic) parents. :type individual: IndividualElement :type parent_type: str :rtype: list of IndividualElement s-Operation only valid for elements with %s tagtNATtNaturalR (RVRRR3R4R7RWtGEDCOM_TAG_FAMILY_CHILDRR2tGEDCOM_TAG_CHILDR[RtGEDCOM_PROGRAM_DEFINED_TAG_MRELtget_family_memberstGEDCOM_TAG_WIFEtGEDCOM_PROGRAM_DEFINED_TAG_FRELtGEDCOM_TAG_HUSBAND(RR]t parent_typeRzR_R`t family_memberRS((sT/var/www/genealogy.alanbeam.net/app/env/lib/python3.5/site-packages/gedcom/parser.pyRv“s$   0cCs½t|tƒ r8t|tƒr8tdtjjƒ‚n|sJ|g}n|djƒ|jƒkrj|S|j|dƒ}x:|D]2}|j||||gƒ}|dk rƒ|SqƒWdS(sGReturn path from descendant to ancestor :rtype: object s.Operation only valid for elements with %s tag.iÿÿÿÿR}N( RVRRR3R4R7RRvtfind_path_to_ancestorR-(Rt descendanttancestortpathRzR|tpotential_path((sT/var/www/genealogy.alanbeam.net/app/env/lib/python3.5/site-packages/gedcom/parser.pyRˆ·s   cCsƒt|tƒs(tdtjjƒ‚ng}|jƒ}xB|jƒD]4}|jƒtjj kp’|jƒtjj kp’|jƒtjj k}|t krÔ|jƒtjj kpÎ|jƒtjj k}nu|t krû|jƒtjj k}nN|tkr"|jƒtjj k}n'|tkrI|jƒtjj k}n|rG|jƒ|krG|j||jƒƒqGqGW|S(s´Return array of family members: individual, spouse, and children Optional argument `members_type` can be used to return specific subsets: "FAMILY_MEMBERS_TYPE_ALL": Default, return all members of the family "FAMILY_MEMBERS_TYPE_PARENTS": Return individuals with "HUSB" and "WIFE" tags (parents) "FAMILY_MEMBERS_TYPE_HUSBAND": Return individuals with "HUSB" tags (father) "FAMILY_MEMBERS_TYPE_WIFE": Return individuals with "WIFE" tags (mother) "FAMILY_MEMBERS_TYPE_CHILDREN": Return individuals with "CHIL" tags (children) :type family: FamilyElement :type members_type: str :rtype: list of IndividualElement s-Operation only valid for element with %s tag.(RVRRR3R4R9RRR2R…RƒR€tFAMILY_MEMBERS_TYPE_PARENTStFAMILY_MEMBERS_TYPE_HUSBANDtFAMILY_MEMBERS_TYPE_WIFEtFAMILY_MEMBERS_TYPE_CHILDRENR[RQ(RR`t members_typetfamily_membersRtRuRr((sT/var/www/genealogy.alanbeam.net/app/env/lib/python3.5/site-packages/gedcom/parser.pyR‚Îs*     cCs!ddlm}|j|ƒdS(sWrite GEDCOM data to stdoutiÿÿÿÿ(tstdoutN(tsysR“t save_gedcom(RR“((sT/var/www/genealogy.alanbeam.net/app/env/lib/python3.5/site-packages/gedcom/parser.pyt print_gedcomüscCsXtddkr/|j|jƒjtƒƒn%|j|jƒjtƒjdƒƒdS(sASave GEDCOM data to a file :type open_file: file iis utf-8-sigN(RtwriteRtto_gedcom_stringRntencode(Rt open_file((sT/var/www/genealogy.alanbeam.net/app/env/lib/python3.5/site-packages/gedcom/parser.pyR•sN(R R t__doc__RRRRRRRnR(t staticmethodR RReRjRmRqR3R4RXRWRxRvR-RˆtFAMILY_MEMBERS_TYPE_ALLR‚R–R•(((sT/var/www/genealogy.alanbeam.net/app/env/lib/python3.5/site-packages/gedcom/parser.pyR1s,     j      $  . (!treR+R”Rtgedcom.element.elementRtgedcom.element.familyRRtgedcom.element.fileRtgedcom.element.individualRRtgedcom.element.objectRtgedcom.element.rootRt gedcom.tagsR3RR4R€RR…RŽRRƒRt ExceptionR tobjectR(((sT/var/www/genealogy.alanbeam.net/app/env/lib/python3.5/site-packages/gedcom/parser.pyts