a ߙfb @sJdZddlZddlmZddgZGdddZdad d dZd d dZdS) zG This file contains routines to verify the correctness of UCD strings. N)data parse_ucd check_ucdc@s8eZdZdZddZddZddZdd Zd d Zd S) UCDWordsz Manages a list of acceptable UCD words. Works by reading in a data file exactly as provided by IVOA. This file resides in data/ucd1p-words.txt. cCst|_t|_i|_i|_tjddd|}|D]b}dd|dD\}}}| }|dvrn|j ||dvr|j |||j|<||j|<q4Wdn1s0YdS) Nzdata/ucd1p-words.txtascii)encodingcSsg|] }|qS)strip).0xrr5lib/python3.9/site-packages/astropy/io/votable/ucd.py !sz%UCDWords.__init__..|ZQPEVCZQSEVC) set_primary _secondary _descriptions_capitalizationrZget_pkg_data_fileobj readlinessplitloweradd)selffdlinetypenameZdescrZ name_lowerrrr __init__s&     zUCDWords.__init__cCs||jvS)zA Returns True if *name* is a valid primary name. )rrrrrrr is_primary+szUCDWords.is_primarycCs||jvS)zC Returns True if *name* is a valid secondary name. )rrrrrr is_secondary1szUCDWords.is_secondarycCs|j|S)z[ Returns the official English description of the given UCD *name*. )rrrrrr get_description7szUCDWords.get_descriptioncCs|j|S)zM Returns the standard capitalization form of the given name. )rrrrrr normalize_capitalization>sz!UCDWords.normalize_capitalizationN) __name__ __module__ __qualname____doc__rrr r!r"rrrr rs rFc Cstdurta|r td|}n td|}|durPtd|dd|dd}|d |d }|d }g}t|D]R\}} | d } | d kr| d d \} } t || std| d| } n| d krtd| dnd} t || std| d| dkr|r|dkr^t | st | rLtd| dntd| dn:t | st | rtd| dntd| dzt | } Wnty| } Yn0|| | fqz|S)a6 Parse the UCD into its component parts. Parameters ---------- ucd : str The UCD string check_controlled_vocabulary : bool, optional If `True`, then each word in the UCD will be verified against the UCD1+ controlled vocabulary, (as required by the VOTable specification version 1.2), otherwise not. has_colon : bool, optional If `True`, the UCD may contain a colon (as defined in earlier versions of the standard). Returns ------- parts : list The result is a list of tuples of the form: (*namespace*, *word*) If no namespace was explicitly specified, *namespace* will be returned as ``'ivoa'`` (i.e., the default namespace). Raises ------ ValueError if *ucd* is invalid Nz[^A-Za-z0-9_.:;\-]z[^A-Za-z0-9_.;\-]zUCD has invalid character 'rz' in ''z[A-Za-z0-9][A-Za-z0-9\-_]*z(\.z)*;:zInvalid namespace 'zToo many colons in 'ZivoazInvalid word 'zSecondary word 'z ' is not valid as a primary wordzUnknown word 'zPrimary word 'z"' is not valid as a secondary word)_ucd_singletonrresearch ValueErrorgroupr enumeratecountmatchrrr r"KeyErrorappend) ucdcheck_controlled_vocabulary has_colonmZword_component_reZword_repartsZwordsiZwordZ colon_countnsZnormalized_wordrrr rHsV"             cCs8|dur dSzt|||dWnty2YdS0dS)a5 Returns False if *ucd* is not a valid `unified content descriptor`_. Parameters ---------- ucd : str The UCD string check_controlled_vocabulary : bool, optional If `True`, then each word in the UCD will be verified against the UCD1+ controlled vocabulary, (as required by the VOTable specification version 1.2), otherwise not. has_colon : bool, optional If `True`, the UCD may contain a colon (as defined in earlier versions of the standard). Returns ------- valid : bool NT)r6r7F)rr.)r5r6r7rrr rs  )FF)FF) r&r,Z astropy.utilsr__all__rr+rrrrrr s 5 Y