KggZdZddlZddlZddlZddlmZdZ ejdZ ejdZ ejdZ ejd Z d Z d e d dfd Zd e d dfdZde d e d e fdZde d e e ffdZd e d efdZde d efdZddZedk(reyy)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, thoughnamereturnct|tstd||dk(r tdtj |s8t jd|dtjdttdy tj|r't jd |d ttdy tj |r td |d tjd|dk(r tdy )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 _warn_inforkeyword iskeyword_reserved_id_rers +lib/python3.12/site-packages/tables/path.pycheck_attribute_namer6s6 dC 7x@AA rzLMM   t $ ]**J 8     /xr* F  T"/3_5L5L N   }KLLc^t||dk(r tdd|vrtd|zy)aCheck the validity of the `name` of a Node object. Validity of Node names is 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!wsB6 s{ABB  G$ N   r parentpathc|jdr|dd}|dk(r|jdrd|z}n$|dk(s|jdr||}n|d|}|jdr|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./r Nr z%s) startswithendswith)r"rpstrs r join_pathr(s  tABxST__S1d{ s dooc2dV$Qtf% }}SCRy KrpathcT|jd}|d|}||dzd}|dk(rd}||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') r Nrr )rfind)r) lastslashppathrs r split_pathr.sC 3I ) E  A  D { 4=rc0tj|duS)z6Return `True` if `name` makes the named node visible.N)_hidden_name_rerrs r isvisiblenamer1s   &$ ..rc0tj|duS)z5Return `True` if `path` makes the named node visible.N)_hidden_path_research)r)s r isvisiblepathr5s  ! !$ '4 //rc,ddl}|jy)zRun ``doctest`` on this module.rN)doctesttestmod)r7s r_testr9s OOr__main__)rN)__doc__rerr exceptionsr __docformat__compilerrr0r3rrrr!r(r.boolr1r5r9__name__rrrCs$ *" 9 56 +"**[)"**Y' "**Y'2 O>Ms>Mt>MB$ c$ d$ N#SS:Sc3Z,/// 000  z Gr