σ jˆϊ\c@@sσdZddlmZddlZddlZddlmZddlmZddl m Z ddl m Z ddl Z ddlZd „Zd efd „ƒYZe jd ejefd „ƒYƒZe jdejefd„ƒYƒZdS(s Create links in the HDF5 file. This module implements containers for soft and external links. Hard links doesn't need a container as such as they are the same as regular nodes (groups or leaves). Classes: SoftLink ExternalLink Functions: Misc variables: i(tabsolute_importNi(t linkextension(tNode(tlazyattr(t AttributeSetcC@stj||ƒS(sGuess the link class.(Rt_get_link_class(t parent_idtname((s*lib/python2.7/site-packages/tables/link.pyt_g_get_link_class)stLinkcB@steZdZed„ƒZded„Zddeed„Zdded„Z d„Z ded„Z d„Z RS( s„Abstract base class for all PyTables links. A link is a node that refers to another node. The Link class inherits from Node class and the links that inherits from Link are SoftLink and ExternalLink. There is not a HardLink subclass because hard links behave like a regular Group or Leaf. Contrarily to other nodes, links cannot have HDF5 attributes. This is an HDF5 library limitation that might be solved in future releases. See :ref:`LinksTutorial` for a small tutorial on how to work with links. .. rubric:: Link attributes .. attribute:: target The path string to the pointed node. cC@s dtfd„ƒY}||ƒS(sά A *NoAttrs* instance replacing the typical *AttributeSet* instance of other node objects. The purpose of *NoAttrs* is to make clear that HDF5 attributes are not supported in link nodes. tNoAttrscB@s#eZd„Zd„Zd„ZRS(cS@std|jjƒ‚dS(Ns1you cannot get attributes from this `%s` instance(tKeyErrort __class__t__name__(tselfR((s*lib/python2.7/site-packages/tables/link.pyt __getattr__MscS@std|jjƒ‚dS(Ns/you cannot set attributes to this `%s` instance(R R R (RRtvalue((s*lib/python2.7/site-packages/tables/link.pyt __setattr__QscS@sdS(N((R((s*lib/python2.7/site-packages/tables/link.pyt_g_closeUs(R t __module__RRR(((s*lib/python2.7/site-packages/tables/link.pyR Ls  (R(RR ((s*lib/python2.7/site-packages/tables/link.pyt_v_attrsEs cC@s8|dk |_||_tt|ƒj|||ƒdS(N(tNonet_v_newttargettsuperR t__init__(Rt parentnodeRRt_log((s*lib/python2.7/site-packages/tables/link.pyRYs c C@s>|jd|d|d|d|ƒ}|jj||tƒ|S(sΰCopy this link and return the new one. See :meth:`Node._f_copy` for a complete explanation of the arguments. Please note that there is no recursive flag since links do not have child nodes. t newparenttnewnamet overwritet createparents(t_f_copyt _v_parentt _g_refnodetTrue(RRRRRtnewnode((s*lib/python2.7/site-packages/tables/link.pytcopyas  cC@s|jd|d|d|ƒS(srMove or rename this link. See :meth:`Node._f_move` for a complete explanation of the arguments. RRR(t_f_move(RRRR((s*lib/python2.7/site-packages/tables/link.pytmoverscC@s |jƒS(s$Remove this link from the hierarchy.(t _f_remove(R((s*lib/python2.7/site-packages/tables/link.pytremove|scC@s|jd|d|ƒS(suRename this link in place. See :meth:`Node._f_rename` for a complete explanation of the arguments. RR(t _f_rename(RRR((s*lib/python2.7/site-packages/tables/link.pytrenamescC@s t|ƒS(N(tstr(R((s*lib/python2.7/site-packages/tables/link.pyt__repr__ŠsN( R Rt__doc__RRRtFalseRR%R'R)R+R-(((s*lib/python2.7/site-packages/tables/link.pyR 0s  tSoftLinkc B@sheZdZdZdZdZd„Zd„Zd„Zd„Z d„Z d„Z d„Z d„Z RS(s,Represents a soft link (aka symbolic link). A soft link is a reference to another node in the *same* file hierarchy. Provided that the target node exists, its attributes and methods can be accessed directly from the softlink using the normal `.` syntax. Softlinks also have the following public methods/attributes: * `target` * `dereference()` * `copy()` * `move()` * `remove()` * `rename()` * `is_dangling()` Note that these will override any correspondingly named methods/attributes of the target node. For backwards compatibility, it is also possible to obtain the target node via the `__call__()` special method (this action is called *dereferencing*; see below) Examples -------- :: >>> f = tables.open_file('/tmp/test_softlink.h5', 'w') >>> a = f.create_array('/', 'A', np.arange(10)) >>> link_a = f.create_soft_link('/', 'link_A', target='/A') # transparent read/write access to a softlinked node >>> link_a[0] = -1 >>> print(link_a[:], link_a.dtype) (array([-1, 1, 2, 3, 4, 5, 6, 7, 8, 9]), dtype('int64')) # dereferencing a softlink using the __call__() method >>> print(link_a() is a) True # SoftLink.remove() overrides Array.remove() >>> link_a.remove() >>> print(link_a) >>> print(a[:], a.dtype) (array([-1, 1, 2, 3, 4, 5, 6, 7, 8, 9]), dtype('int64')) tSOFTLINKRt dereferencet is_danglingR%R'R)R+Rt__str__R-t __unicode__R t__dict__t_f_t_c_t_g_t_v_cC@s |jƒS(s;Dereference `self.target` and return the object. Examples -------- :: >>> f=tables.open_file('data/test.h5') >>> print(f.root.link0) /link0 (SoftLink) -> /another/path >>> print(f.root.link0()) /another/path (Group) '' (R2(R((s*lib/python2.7/site-packages/tables/link.pyt__call__ΟscC@sT|jrL|j}|jjdƒs<|jj|jƒ}n|jj|ƒSdSdS(Nt/(t _v_isopenRt startswithR!t_g_joint_v_filet _get_nodeR(RR((s*lib/python2.7/site-packages/tables/link.pyR2ΰs   cC@sœ|tjks"|d tjkr2tj||ƒS|jsMtjdƒ‚nK|jƒr]dS|j ƒ}y|j|ƒSWnt k r—|j |ƒSXdS(Nisthe node object is closed( R0t_link_attrnamest_link_attrprefixestobjectt__getattribute__R=ttablestClosedNodeErrorR3RR2tAttributeErrorR(Rtattrnamet target_node((s*lib/python2.7/site-packages/tables/link.pyREλs    cC@sˆ|tjks"|d tjkr8tj|||ƒnL|jsStjdƒ‚n1|jƒrnt dƒ‚n|j ƒj||ƒdS(Nisthe node object is closedssoftlink target does not exist( R0RBRCRDRR=RFRGR3t ValueErrorR2(RRIR((s*lib/python2.7/site-packages/tables/link.pyRs  cC@sM|jstjdƒ‚n.|jƒr6tdƒ‚n|jƒj|ƒSdS(sd__getitem__ must be defined in the SoftLink class in order for array indexing syntax to worksthe node object is closedssoftlink target does not existN(R=RFRGR3RKR2t __getitem__(Rtkey((s*lib/python2.7/site-packages/tables/link.pyRLs   cC@sP|jstjdƒ‚n1|jƒr6tdƒ‚n|jƒj||ƒdS(sd__setitem__ must be defined in the SoftLink class in order for array indexing syntax to worksthe node object is closedssoftlink target does not existN(R=RFRGR3RKR2t __setitem__(RRMR((s*lib/python2.7/site-packages/tables/link.pyRNs   cC@s|jƒ|jkS(N(R2R@(R((s*lib/python2.7/site-packages/tables/link.pyR3%scC@s˜|jj}t|jƒ}|jjdƒsE|jj|jƒ}n|jrWd}nd}||jkrud}nd}d||j ||j|fS(sρReturn a short string representation of the link. Examples -------- :: >>> f=tables.open_file('data/test.h5') >>> print(f.root.link0) /link0 (SoftLink) -> /path/to/node R<tsclosed s (dangling)s%s%s (%s) -> %s%s( R R R,RR>R!R?R=R@t _v_pathname(Rt classnameRtclosedtdangling((s*lib/python2.7/site-packages/tables/link.pyR4)s    ( RR2R3R%R'R)R+RR4R-R5R R6(R7R8R9R:(R RR.t _c_classidRBRCR;R2RERRLRNR3R4(((s*lib/python2.7/site-packages/tables/link.pyR0Žs3    t ExternalLinkcB@sPeZdZdZded„Zd„Zd„Zd„Z d„Z d„Z RS( sΧRepresents an external link. An external link is a reference to a node in *another* file. Getting access to the pointed node (this action is called *dereferencing*) is done via the :meth:`__call__` special method (see below). .. rubric:: ExternalLink attributes .. attribute:: extfile The external file handler, if the link has been dereferenced. In case the link has not been dereferenced yet, its value is None. t EXTERNALLINKcC@s,d|_tt|ƒj||||ƒdS(N(RtextfileRRUR(RRRRR((s*lib/python2.7/site-packages/tables/link.pyR_s cC@s&|jjdƒ\}}|d|fS(s=Return the external filename and nodepath from `self.target`.s:/R<(Rtsplit(RtfilenameR((s*lib/python2.7/site-packages/tables/link.pyt_get_filename_nodefscK@sΤ|jƒ\}}tjj|ƒsTtjj|jjƒ}tjj||ƒ}n|jdksp|jj rˆt j |||_n<|jj|ks t ‚|jj|jddƒksΔt ‚|jj|ƒS(s’Dereference self.target and return the object. You can pass all the arguments supported by the :func:`open_file` function (except filename, of course) so as to open the referenced external file. Examples -------- :: >>> f=tables.open_file('data1/test1.h5') >>> print(f.root.link2) /link2 (ExternalLink) -> data2/test2.h5:/path/to/node >>> plink2 = f.root.link2('a') # open in 'a'ppend mode >>> print(plink2) /path/to/node (Group) '' >>> print(plink2._v_filename) 'data2/test2.h5' # belongs to referenced file tmodetrN(RZtostpathtisabstdirnameR@RYtjoinRWRtisopenRFt open_filetAssertionErrorR[tgetRA(RtkwargsRYRtbase_directory((s*lib/python2.7/site-packages/tables/link.pyR;ms$cC@s8|j}|dk r4|jr4|jƒd|_ndS(s'Safely unmount self.extfile, if opened.N(RWRRbtclose(RRW((s*lib/python2.7/site-packages/tables/link.pytumount•s  cC@s!|jƒtt|ƒjƒdS(s#Especific close for external links.N(RiRRUt_f_close(R((s*lib/python2.7/site-packages/tables/link.pyRjžs cC@s#|jj}d|j||jfS(sReturn a short string representation of the link. Examples -------- :: >>> f=tables.open_file('data1/test1.h5') >>> print(f.root.link2) /link2 (ExternalLink) -> data2/test2.h5:/path/to/node s %s (%s) -> %s(R R RPR(RRQ((s*lib/python2.7/site-packages/tables/link.pyR4€s N( R RR.RTRR/RRZR;RiRjR4(((s*lib/python2.7/site-packages/tables/link.pyRUHs  ( (R.t __future__RR]RFRORtnodeRtutilsRt attributesetRtsixt tables.fileRR tpython_2_unicode_compatibleR0RU(((s*lib/python2.7/site-packages/tables/link.pyts     ^ Ή