o Rŀg@sddZddlZdddZddZdd Zdd d Zdd dZdddZdddZdddZ ddZ dS)z"Common SearchIO utility functions.N?cCs>zt||}Wn ty|YSw|durt|S||S)zzReturn string of the given object's attribute. Defaults to the given fallback value if attribute is not present. N)getattrAttributeErrorstr)objattrfmtfallbackvaluer G/var/www/html/myenv/lib/python3.10/site-packages/Bio/SearchIO/_utils.py getattr_str s r cCs |}|r |r|r|Sq)z?Read through whitespaces, return the first non-whitespace line.)readlinestrip)handleliner r r read_forwards rc Csz||}Wn3ty9|durtddt|ts tdd||kr-td|dtd|d|fdw|\}}td|dgd }t||S) aReturn the object to process the given format according to the mapping. :param format: format name :type format: string, lower case :param mapping: mapping of format name and its processor object :type mapping: dictionary {string: object} Nz#Format required (lower case string)z.Need a string for the file format (lower case)z%Format string %r should be lower casez+Unknown format %r. Supported formats are %rz', 'zBio.SearchIO.%s)fromlist) KeyError ValueError isinstancer TypeErrorlowerjoin __import__r)formatmappingobj_infomod_nameobj_namemodr r r get_processor#s(        r"rcfdd}t||dS)zProperty for fetching attribute from first entry of container. Returns a property that fetches the given attribute from the first item in a SearchIO container object. cs8t|jdkr tddur|jdSt|jdS)Nz.More than one HSPFragment objects found in HSPr)len_itemsrrselfrr r getterJs  zsingleitem..getterfgetdocpropertyrr-r*r r)r singleitemCs  r1cr#)zProperty for fetching attribute from all entries of container. Returns a property that fetches the given attributes from all items in a SearchIO container object. cs"dur|jSfdd|jDS)Ncsg|]}t|qSr r).0fragr)r r ^sz,allitems..getter..)r&r'r)r r r*[szallitems..getterr+r.r0r r)r allitemsTs  r6cs&fdd}fdd}t|||dS)aReturn a getter property with a cascading setter. This is similar to ``optionalcascade``, but for SearchIO containers that have at least one item (HSP). The getter always retrieves the attribute value from the first item. If the items have more than one attribute values, an error will be raised. The setter behaves like ``partialcascade``, except that it only sets attributes to items in the object, not the object itself. cst|jdSNr)rr&r'r)r r r*nszfullcascade..gettercs|D]}t||qdSNsetattrr(r itemr)r r setterqszfullcascade..setterr,fsetr-r.)rr-r*r=r r)r fullcascadecs r@cs*fdd}fdd}t|||dS)aAReturn a getter property with a cascading setter. This is used for the ``id`` and ``description`` properties of the container objects with zero or more items. These items have their own private attributes that stores query and/or hit ID and description. When the container has zero items, attribute values are always retrieved from the container's attribute. Otherwise, the first item's attribute is used. To keep the container items' query and/or hit ID and description in-sync, the setter cascades any new value given to the items' values. cs|jr t|dSt|Sr7)r&rr' cont_attr item_attrr r r*s zoptionalcascade..gettercs&t|||D]}t||qdSr8r9r;rAr r r=s zoptionalcascade..setterr>r.)rBrCr-r*r=r rAr optionalcascadexsrDcsFdvsJddfdd}fdd}t|||dS)zReturn a getter property with cascading setter, for HSPFragment objects. Similar to ``partialcascade``, but for HSPFragment objects and acts on ``query`` or ``hit`` properties of the object if they are not None. )hitquery_cs t|Sr8r2r') attr_namer r r*s zfragcascade..gettercs2t||t|}|durt||dSdSr8)r:r)r(r seqrrHseq_typer r r=s  zfragcascade..setterr>r.)rrKr-r*r=r rJr fragcascades  rLcCsJtj^}}}|dkr |dkr |r||r|dt| S|S||S)z0Remove the suffix from the string, if it exists.N)sys version_infoendswithr% removesuffix)stringsuffixmajorminorrGr r r rRs  rR)Nr)Nr)r) __doc__rOr rr"r1r6r@rDrLrRr r r r s