ó jˆú\c@@s÷dZddlmZddlZddlZddlZddlmZddlZdZ ej dƒZ ej dƒZ ej d ƒZ ej d ƒZd Zd „Zd „Zd„Zd„Zd„Zd„Zd„ZedkróeƒndS(s™Functionality related with node paths in a PyTables file. Variables ========= `__docformat`__ The format of documentation strings in this module. i(tabsolute_importNi(tNaturalNameWarningtreStructuredTexts^[a-zA-Z_][a-zA-Z0-9_]*$s ^_[cfgv]_s^_[pi]_s/_[pi]_smyou will not be able to use natural naming to access this object; using ``getattr()`` will still work, thoughcC@sùt|tjƒs(td|fƒ‚n|dkrCtdƒ‚ntj|ƒs|tjd|tj t ft ddƒdSt j |ƒr¯tjd|t ft ddƒdStj|ƒrÚtd |tj fƒ‚n|d krõtd ƒ‚ndS( siCheck 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 sobject name is not a string: %rts1the empty string is not allowed as an object namesZobject name is not a valid Python identifier: %r; it does not match the pattern ``%s``; %st stackleveliNs'object name is a Python keyword: %r; %ssLobject name starts with a reserved prefix: %r; it matches the pattern ``%s``t __members__s0``__members__`` is not allowed as an object name(t isinstancetsixt string_typest TypeErrort ValueErrort _python_id_retmatchtwarningstwarntpatternt _warnInfoRtkeywordt iskeywordt_reserved_id_re(tname((s*lib/python2.7/site-packages/tables/path.pytcheck_attribute_nameKs$     cC@sHt|ƒ|dkr%tdƒ‚nd|krDtd|ƒ‚ndS(s'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 t.s&``.`` is not allowed as an object namet/s6the ``/`` character is not allowed in object names: %rN(RR (R((s*lib/python2.7/site-packages/tables/path.pytcheck_name_validity„s    cC@s¢|jdƒr|d}n|dkrD|jdƒrDd|}n>|dks_|jdƒrrd||f}nd||f}|jdƒrž|d }n|S(sbJoin 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' s./iRs%ss%s%ss%s/%siÿÿÿÿ(t startswithtendswith(t parentpathRtpstr((s*lib/python2.7/site-packages/tables/path.pyt join_path¬s   cC@sF|jdƒ}|| }||d}|dkr<d}n||fS(sþSplit 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') RiR(trfind(tpatht lastslashtppathR((s*lib/python2.7/site-packages/tables/path.pyt split_pathËs    cC@stj|ƒdkS(s3Does this `name` make the named node a visible one?N(t_hidden_name_reR tNone(R((s*lib/python2.7/site-packages/tables/path.pyt isvisiblenameãscC@stj|ƒdkS(s3Does this `path` make the named node a visible one?N(t_hidden_path_retsearchR$(R((s*lib/python2.7/site-packages/tables/path.pyt isvisiblepathêscC@sddl}|jƒdS(sRun ``doctest`` on this module.iN(tdoctestttestmod(R)((s*lib/python2.7/site-packages/tables/path.pyt_testós t__main__(t__doc__t __future__RtreR Rt exceptionsRRt __docformat__tcompileR RR#R&RRRRR"R%R(R+t__name__(((s*lib/python2.7/site-packages/tables/path.pyts*       9 (