a =_@sdZddlZddlZddlZddlmZdZedZedZ edZ ed Z d Z d d Z d dZddZddZddZddZddZedkredS)zFunctionality related with node paths in a PyTables file. Variables ========= `__docformat`__ The format of documentation strings in this module. N)NaturalNameWarningZreStructuredTextz^[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, thoughcCst|tstd|f|dkr(tdt|sRtjd|tjt ft dddSt |rxtjd|t ft dddSt |rtd |t jf|d krtd dS) aiCheck 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. >>> check_attribute_name('a') >>> check_attribute_name('a_b') >>> check_attribute_name('a:b') >>> check_attribute_name('/a/b') >>> check_attribute_name('/') >>> check_attribute_name('.') >>> 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: %rz1the empty string is not allowed as an object namezZobject name is not a valid Python identifier: %r; it does not match the pattern ``%s``; %s) stacklevelNz'object name is a Python keyword: %r; %szLobject name starts with a reserved prefix: %r; it matches the pattern ``%s`` __members__z0``__members__`` is not allowed as an object name) isinstancestr TypeError ValueError _python_id_rematchwarningswarnpattern _warnInforkeyword iskeyword_reserved_id_renamer*lib/python3.9/site-packages/tables/path.pycheck_attribute_nameIs0     rcCs2t||dkrtdnd|vr.td|dS)a'Check 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. >>> check_name_validity('a') >>> check_name_validity('a_b') >>> check_name_validity('a:b') >>> 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)rr rrrrcheck_name_validitys rcCsx|dr|dd}|dkr2|dr2d|}n,|dksD|drRd||f}n d||f}|drt|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%sz%s%sz%s/%s) startswithendswith)Z parentpathrZpstrrrr join_paths      r cCs:|d}|d|}||dd}|dkr2d}||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)pathZ lastslashZppathrrrr split_paths  r#cCst|duS)z3Does this `name` make the named node a visible one?N)_hidden_name_rer rrrr isvisiblenamesr%cCst|duS)z3Does this `path` make the named node a visible one?N)_hidden_path_research)r"rrr isvisiblepathsr(cCsddl}|dS)zRun ``doctest`` on this module.rN)doctestZtestmod)r)rrr_testsr*__main__)__doc__rerr exceptionsrZ __docformat__compiler rr$r&rrrr r#r%r(r*__name__rrrr s(     9(