ddZddlZddlZddlZddlmZdZ ejdZ ejdZ ejdZ ejd Z d Z d Z d Zd ZdZdZdZdZedkr edSdS)zFunctionality related with node paths in a PyTables file. Variables ========= `__docformat`__ The format of documentation strings in this module. N)NaturalNameWarningreStructuredTextz^[a-zA-Z_][a-zA-Z0-9_]*$z ^_[cfgv]_z^_[pi]_z/_[pi]_zmyou will not be able to use natural naming to access this object; using ``getattr()`` will still work, thoughc6t|tstd||dkrtdt|s6t jd|dtjdttdd Stj |r)t jd |d ttdd St|r td |d tjd|dkrtdd S)aCheck the validity of the `name` of an attribute in AttributeSet. If the name is not valid, a ``ValueError`` is raised. If it is valid but it can not be used with natural naming, a `NaturalNameWarning` is issued. >>> warnings.simplefilter("ignore") >>> check_attribute_name('a') >>> check_attribute_name('a_b') >>> check_attribute_name('a:b') # NaturalNameWarning >>> check_attribute_name('/a/b') # NaturalNameWarning >>> check_attribute_name('/') # NaturalNameWarning >>> check_attribute_name('.') # NaturalNameWarning >>> check_attribute_name('__members__') Traceback (most recent call last): ... ValueError: ``__members__`` is not allowed as an object name >>> check_attribute_name(1) Traceback (most recent call last): ... TypeError: object name is not a string: 1 >>> check_attribute_name('') Traceback (most recent call last): ... ValueError: the empty string is not allowed as an object name zobject name is not a string: z1the empty string is not allowed as an object namez.object name is not a valid Python identifier: z"; it does not match the pattern ``z``; ) stacklevelNz!object name is a Python keyword: z; z+object name starts with a reserved prefix: z; it matches the pattern ``z`` __members__z0``__members__`` is not allowed as an object name) isinstancestr TypeError ValueError _python_id_rematchwarningswarnpattern _warnInforkeyword iskeyword_reserved_id_renames +lib/python3.11/site-packages/tables/path.pycheck_attribute_namer5sX6 dC B@@@AAA rzzLMMM   t $ $ }444iiA)Q 8 8 8 8  yy*+=! M M M MT""<j DD/"9"9"9;<< <  }KLLLczt||dkrtdd|vrtd|zdS)amCheck the validity of the `name` of a Node object, which more limited than attribute names. If the name is not valid, a ``ValueError`` is raised. If it is valid but it can not be used with natural naming, a `NaturalNameWarning` is issued. >>> warnings.simplefilter("ignore") >>> check_name_validity('a') >>> check_name_validity('a_b') >>> check_name_validity('a:b') # NaturalNameWarning >>> check_name_validity('/a/b') Traceback (most recent call last): ... ValueError: the ``/`` character is not allowed in object names: '/a/b' >>> check_name_validity('.') Traceback (most recent call last): ... ValueError: ``.`` is not allowed as an object name >>> check_name_validity('') Traceback (most recent call last): ... ValueError: the empty string is not allowed as an object name .z&``.`` is not allowed as an object name/z6the ``/`` character is not allowed in object names: %rN)rrrs rcheck_name_validityr os[4 s{{ABBB /15677 7 rc|dr |dd}|dkr|drd|z}n)|dks|dr||}n|d|}|dr |dd}|S)abJoin a *canonical* `parentpath` with a *non-empty* `name`. .. versionchanged:: 3.0 The *parentPath* parameter has been renamed into *parentpath*. >>> join_path('/', 'foo') '/foo' >>> join_path('/foo', 'bar') '/foo/bar' >>> join_path('/foo', '/foo2/bar') '/foo/foo2/bar' >>> join_path('/foo', '/') '/foo' z./rNrz%s) startswithendswith) parentpathrpstrs r join_pathr's" tABBxST__S11d{ s  dooc22 $d$$%%t%% }}SCRCy Krcr|d}|d|}||dzd}|dkrd}||fS)zSplit a *canonical* `path` into a parent path and a node name. The result is returned as a tuple. The parent path does not include a trailing slash. >>> split_path('/') ('/', '') >>> split_path('/foo/bar') ('/foo', 'bar') rNrr)rfind)path lastslashppathrs r split_pathr-sK 3I ) E  A  D {{ 4=rc:t|duS)z3Does this `name` make the named node a visible one?N)_hidden_name_rerrs r isvisiblenamer0s   & &$ ..rc:t|duS)z3Does this `path` make the named node a visible one?N)_hidden_path_research)r*s r isvisiblepathr4s  ! !$ ' '4 //rc6ddl}|dS)zRun ``doctest`` on this module.rN)doctesttestmod)r6s r_testr8s#NNN OOr__main__)__doc__rerr exceptionsr __docformat__compilerrr/r2rrr r'r-r0r4r8__name__rrrAsE ******" 9 566 +"*[))"*Y'' "*Y'' 6 O7M7M7Mt"7"7"7J<./// 000  z EGGGGGr