d}dZddlZddlZddlmZmZddlmZmZm Z m Z ddl m Z m Z mZddlmZddlmZdd lmZmZd Z d ZGd d eZGddeZGddZdS)zPyTables nodes.N)class_name_dict class_id_dict)ClosedNodeError NodeErrorUndoRedoWarningPerformanceWarning) join_path split_path isvisiblepath)lazyattr)move_to_shadow) AttributeSetNotLoggedAttributeSetreStructuredTextcFtjfd}|S)zDecorate string representation method to handle closed nodes. If the node is closed, a string like this is returned:: instead of calling `oldmethod` and returning its result. c|js.d|jjd|jjdt |ddS|S)Nz) _v_isopen __class__ __module____name__id)self oldmethods +lib/python3.11/site-packages/tables/node.py newmethodz_closedrepr..newmethodsm~ EDt~8DD~.DD68hhCDDD Ey) functoolswraps)rrs` r _closedreprr#s;_Y  r c(eZdZdZdZfdZxZS)MetaNodeaNode metaclass. This metaclass ensures that their instance classes get registered into several dictionaries (namely the `tables.utils.class_name_dict` class name dictionary and the `tables.utils.class_id_dict` class identifier dictionary). It also adds sanity checks to some methods: * Check that the node is open when calling string representation and provide a default string if so. c~dD]}||vrt||||<t||||S)N)__str____repr__)r#type__new__)mcsnamebasesdict_mnames rr*zMetaNode.__new__7sH, 9 9E~~*5<88e ||Cue444r ct||||t|j<t |dd}|+|D]}t |dd}||krdS|t |<dSdS)N _c_classid)super__init__rrgetattrr)clsr,r-r.cidbasepcidrs rr3zMetaNode.__init__?s ue,,,), %c<.. ? ) )t\4883;;EE&) c""" ?r )rr __qualname____doc__r*r3 __classcell__)rs@rr%r%(sQ  555)))))))))r r%c@eZdZdZeZdZeeZe dZ dZ dZ ee e Z dZ d(dZd Zd Zd Zd Zd ZdZdZdZdZdZdZdZdZd)dZdZdZd*dZ d+dZ!dZ"d(dZ#dZ$ d,dZ%d Z&d!Z'd"Z(d#Z)d$Z*d%Z+d&Z,d'Z-dS)-NodeaAbstract base class for all PyTables nodes. This is the base class for *all* nodes in a PyTables hierarchy. It is an abstract class, i.e. it may not be directly instantiated; however, every node in the hierarchy is an instance of this class. A PyTables node is always hosted in a PyTables *file*, under a *parent group*, at a certain *depth* in the node hierarchy. A node knows its own *name* in the parent group and its own *path name* in the file. All the previous information is location-dependent, i.e. it may change when moving or renaming a node in the hierarchy. A node also has location-independent information, such as its *HDF5 object identifier* and its *attribute set*. This class gathers the operations and attributes (both location-dependent and independent) which are common to all PyTables nodes, whatever their type is. Nonetheless, due to natural naming restrictions, the names of all of these members start with a reserved prefix (see the Group class in :ref:`GroupClassDescr`). Sub-classes with no children (e.g. *leaf nodes*) may define new methods, attributes and properties to avoid natural naming restrictions. For instance, _v_attrs may be shortened to attrs and _f_rename to rename. However, the original methods and attributes should still be available. .. rubric:: Node attributes .. attribute:: _v_depth The depth of this node in the tree (an non-negative integer value). .. attribute:: _v_file The hosting File instance (see :ref:`FileClassDescr`). .. attribute:: _v_name The name of this node in its parent group (a string). .. attribute:: _v_pathname The path of this node in the tree (a string). .. attribute:: _v_objectid A node identifier (may change from run to run). .. versionchanged:: 3.0 The *_v_objectID* attribute has been renamed into *_v_object_id*. cdt|j\}}|j|S)z"The parent :class:`Group` instance)r _v_pathname_v_file _get_node)r parentpathnodenames r _g_getparentzNode._g_getparents-!+D, > 2#//11J D/; C   *189IJ "( $3 J'''  """"  $  ! ! # # #  8  ! !$h 7 7 7 Z...  KK DtK 4 4 4 2#'>>#3#3  #'<<>>  %t % 5 5 7 7 %""$$$  " " $ $ $ $ $    MMOOO   s ?B F F.cF|jd|jdS)NCREATEr@rnr?rGs rrizNode._g_log_create s# (D$455555r c|jsdSd|_ |jj}||d|jrd|_|dSdS#|jrd|_|wwxYw)NTF)check_unregistered)rr]r@ _node_manager drop_noderl)r node_managers r__del__z Node.__del__s$~  F  <5L  " "4E " B B B ~ $(!   t~ $(!  s #A%BcdS)z*Code to be called before killing the node.NrGs r_g_pre_kill_hookzNode._g_pre_kill_hook1 r ct)z8Create a new HDF5 node and return its object identifier.NotImplementedErrorrGs rrfzNode._g_create5!!r ct)z> >|"II$IIIIIIr c|j}|j}||_d|_|j}||r}|dksJ|dkr||_n|t |d|_t|\}|_| d| dz dz|_n+||_t|j||_|dz|_||j kr)tj d|j|j fzt|jdkr"|j||jdSdS)aSet location-dependent attributes. Sets the location-dependent attributes of this node to reflect that it is placed under the specified `parentnode`, with the specified `name`. This also triggers the insertion of file references to this node. If the maximum recommended tree depth is exceeded, a `PerformanceWarning` is issued. Tr/Nrznode ``%s`` is exceeding the recommended maximum depth (%d);be ready to see PyTables asking for *lots* of memory and possibly slow I/O)r@rZrroot_uep startswithr?lenr rYcountr r\warningswarnr rw cache_node)rrmr,rq parentdepthr_s rrdzNode._g_set_locationHs]" )  > ??8 $ $ ,!####3#'  #'H #7 (..OAt| JJsOOhnnS.A.AAAEDMM DL()?FFD '!ODM $. . . MN"-t/CDE-  . . .  s " "   * *41A B B B B B # "r cL|j}t||j}|d}||_||_||jkr#t jd|jfzt|j j }| ||| dS)aUpdate location-dependent attributes. Updates location data when an ancestor node has changed its location in the hierarchy to `newparentpath`. In fact, this method is expected to be called by an ancestor of this node. This also triggers the update of file references to this node. If the maximum recommended node depth is exceeded, a `PerformanceWarning` is issued. This warning is assured to be unique. rzmoved descendent node is exceeding the recommended maximum depth (%d);be ready to see PyTables asking for *lots* of memory and possibly slow I/ON) r?r rYrrZr\rrr r@rw rename_node_g_update_dependent)r newparentpatholdpathnewpathnewdepthrys r_g_update_locationzNode._g_update_locationvs"M4<88==%%"   d* * * MN"1346H I I I |1   '222   """""r c|jj}|j}|js0|||j|dd|_d|_d|_d|_d|_ dS)zwClear location-dependent attributes. This also triggers the removal of file references to this node. NF) r@rwr?r]drop_from_cacheregistrypoprrYrZ)rrypathnames r_g_del_locationzNode._g_del_locationsx|1 #  6  ( ( 2 2 2  ! % %h 5 5 5   r cdS)z?Code to be run after node creation and before creation logging.Nr|rGs rrjzNode._g_post_init_hookr~r cPd|jvr|j|dSdS)zUpdate dependent objects after a location change. All dependent objects (but not nodes!) referencing this node must be updated here. rHN)__dict__rH_g_update_node_locationrGs rrzNode._g_update_dependents5  & & M 1 1$ 7 7 7 7 7 ' &r c|jsdS|j}d|vr|j||d|_dS)acClose this node in the tree. This releases all resources held by the node, so it should not be used again. On nodes with data, it may be flushed to disk. You should not need to close nodes manually because they are automatically opened/closed when they are loaded/evicted from the integrated LRU cache. NrHF)rrrH_g_closerclear)rmyDicts rrlz Node._f_closesk(~  F    M " " $ $ $   r c|j}||j|||dS)a|Remove this node from the hierarchy. If the node has children, recursive removal must be stated by giving `recursive` a true value; otherwise, a `NodeError` will be raised. If `force` is set to true, the node will be removed no matter it has children or not (useful for deleting hard links). It does not log the change. N) _v_parent _g_unrefnoderYrl _g_delete)r recursiveforceparents r _g_removezNode._g_removesHDL)))  vr c||j}||r|||dS|||dS)a]Remove this node from the hierarchy. If the node has children, recursive removal must be stated by giving recursive a true value; otherwise, a NodeError will be raised. If the node is a link to a Group object, and you are sure that you want to delete it, you can do this by setting the force flag to true. N)rar@rbrh_g_remove_and_logr)rrrrqs r _f_removezNode._f_removesy     " " -  " "9e 4 4 4 4 4 NN9e , , , , ,r cn|j}|j}|d|t||dS)NREMOVE)r@r?rnr)rrrrq oldpathnames rrzNode._g_remove_and_logs; &  8[)))uk*****r c|j}|j}|j}||||||||||||jd|j|j ||j |||j| dS)zMove this node in the hierarchy. Moves the node into the given `newparent`, with the given `newname`. It does not log the change. FrUN) rrYr?rcrrrdre _g_move_noder^r)r newparentnewname oldparentoldnamers r_g_movez Node._g_movesN ,&  T7+++w'''  Y000 It|% 888 ##I$97$-$97$/1A C C C   """""r c4|||dS)zRename this node in place. Changes the name of a node to *newname* (a string). If a node with the same newname already exists and overwrite is true, recursively remove it before renaming. )r overwriteN)_f_move)rrrs r _f_renamezNode._f_rename:s  W :::::r Nc||j}|j}|j}||t d||}||}t |dr|j}|j} n't |dr|}|} ntd|||urt d||j} | | kr||krdS| | | ||}| || ||||j} | |||r|| dSdS)aMove or rename this node. Moves a node into a new parent group, or changes the name of the node. newparent can be a Group object (see :ref:`GroupClassDescr`) or a pathname in string form. If it is not specified or None, the current parent group is chosen as the new parent. newname must be a string with a new name. If it is not specified or None, the current name is chosen as the new name. If createparents is true, the needed groups for the given new parent group path to exist will be created. Moving a node across databases is not allowed, nor it is moving a node *into* itself. These result in a NodeError. However, moving a node *over* itself is allowed and simply does nothing. Moving over another existing node is similarly not allowed, unless the optional overwrite argument is true, in which case that node is recursively removed before moving. Usually, only the first argument will be used, effectively moving the node to a new location without changing its name. Using only the second argument is equivalent to renaming the node in place. NFyou should specify at least a ``newparent`` or a ``newname`` parameterr@r%new parent is not a node nor a path: zGnodes can not be moved across databases; please make a copy of the node)rar@rrYrrLr? TypeErrorrb_g_check_not_contains_get_or_create_pathr`_g_maybe_removerrh _g_log_move) rrrr createparentsrqrrnewfilerrrs rrz Node._f_moveEs2  N ,  IJJ J  !I ?G 9i ( ( ,'G+GG Y - - ,GGG)(y+,, , %  =>> > ' g  'W"4"4 F ""7+++ --iGG  I&&& Y;;;&  Y(((  " " *   [ ) ) ) ) ) * *r cH|jd||jdS)NMOVErtrrs rrzNode._g_log_moves% &+t/?@@@@@r c t)aCopy this node and return the new one. Creates and returns a copy of the node in the given `newparent`, with the given `newname`. If `recursive` copy is stated, all descendents are copied as well. Additional keyword argumens may affect the way that the copy is made. Unknown arguments must be ignored. On recursive copies, all keyword arguments must be passed on to the children invocation of this method. If `_log` is false, the change is not logged. This is *only* intended to be used by ``_g_copy_as_child()`` as a means of optimising sub-tree copies. r)rrrrrnkwargss r_g_copyz Node._g_copys "!r c 0|j||jfddd|S)zCopy this node as a child of another group. Copies just this node into `newparent`, not recursing children nor overwriting nodes nor logging the copy. This is intended to be used when copying whole sub-trees. F)rrn)rrY)rrrs r_g_copy_as_childzNode._g_copy_as_childs=t|It|C&+%CC;ACC Cr c ||j}|j}|j} |} |} | | t d| |} | | } t | dr| j} | j} n't | dr|} | } ntd| | |urA|j}| |kr| | krt d|jz|r|| | | |} | | | |ur.| rtj dt|| | ||j| | |fi|S)a]Copy this node and return the new node. Creates and returns a copy of the node, maybe in a different place in the hierarchy. newparent can be a Group object (see :ref:`GroupClassDescr`) or a pathname in string form. If it is not specified or None, the current parent group is chosen as the new parent. newname must be a string with a new name. If it is not specified or None, the current name is chosen as the new name. If recursive copy is stated, all descendants are copied as well. If createparents is true, the needed groups for the given new parent group path to exist will be created. Copying a node across databases is supported but can not be undone. Copying a node over itself is not allowed, nor it is recursively copying a node into itself. These result in a NodeError. Copying over another existing node is similarly not allowed, unless the optional overwrite argument is true, in which case that node is recursively removed before copying. Additional keyword arguments may be passed to customize the copying process. For instance, title and filters may be changed, user attributes may be or may not be copied, data may be sub-sampled, stats may be collected, etc. See the documentation for the particular node type. Using only the first argument is equivalent to copying the node to a new location without changing its name. Using only the second argument is equivalent to making a copy of the node in the same group. Nrr@rrz6source and destination nodes are the same node: ``%s``zHcopying across databases can not be undone nor redone from this database)rar@rrYrrLr?rrrr`rhrrrrr)rrrrrrrsrcfile srcparentsrcname dstparentdstnamedstfiledstpathsrcpaths r_f_copyz Node._f_copysD ,N ,   IJJ J  !I ?G 9i ( ( ,'G+GG Y - - ,GGG)(y+,, , g  +G'!!g&8&8L&'(((  4**7333// =II  I&&& ' ! !g&=&=&?&? ! M:) + + + Y;;;t|Iw DDVDDDr cR|t|jS)zIs this node visible?)rar r?rGs r _f_isvisiblezNode._f_isvisibles' T-...r ct|tdstd|jzt|tdstd|jzdS)Nr=z'new parent is not a registered node: %sGroupz%new parent node ``%s`` is not a group)rWrrr?)rnodes rr`zNode._g_check_group$s|$ 788 0E"./00 0$ 899 0C"./00 0 0 0r c|j}|dks||ks||dzrtd|zdS)Nrz8can not move or recursively copy node ``%s`` into itself)r?rr)rr mypathnames rrzNode._g_check_not_contains/sb% #  *$$!!*s"233%*,6788 8%$r c||vrG|std|jd|d||ddSdS)Nzdestination group ``z`` already has a node named ``z2``; you may want to use the ``overwrite`` argumentT)rr? _f_get_childr)rrr,rs rrzNode._g_maybe_remove8s| 6>> /.6+=..*....///    % % / / 5 5 5 5 5 >r cT|drtd|zdS)zCheck validity of name for this particular kind of node. This is invoked once the standard HDF5 and natural naming checks have successfully passed. _i_z1node name starts with reserved prefix ``_i_``: %sN)r ValueErrorrr,s r _g_check_namezNode._g_check_nameAsB ??5 ! ! LCdJLL L L Lr c,t|j|S)zGet a PyTables attribute from this node. If the named attribute does not exist, an AttributeError is raised. )r4rHrs r _f_getattrzNode._f_getattrNst}d+++r c2t|j||dS)zSet a PyTables attribute for this node. If the node already has a large number of attributes, a PerformanceWarning is issued. N)setattrrH)rr,values r _f_setattrzNode._f_setattrXs  tU+++++r c0t|j|dS)zDelete a PyTables attribute from this node. If the named attribute does not exist, an AttributeError is raised. N)delattrrHrs r _f_delattrzNode._f_delattrbs  t$$$$$r )T)FF)F)NNFF)NNFFF).rrr9r:rrFrDpropertyrr rHrMrQ_v_titlerr3rirzr}rfrgrardrrrjrrlrrrrrrrrrrrr`rrrrrrr|r rr=r=Qs44n!M222 &&I ( (X ($$$x [11HI+SSSSj666! ! ! F   """""" J J J,C,C,C\ # # #D,    8 8 8%%%N.----(+++"#"#"#H ; ; ; ;/3/4V*V*V*V*pAAA""""$ C C C/3@E^E^E^E^E@/// 0 0 0888666 L L L,,,,,,%%%%%r r=) metaclassc$eZdZeZdZdZdZdS)NotLoggedMixincdSrOr|rGs rrizNotLoggedMixin._g_log_createu r cdSrOr|rs rrzNotLoggedMixin._g_log_movexrr c2|||dSrO)r)rrrs rrz NotLoggedMixin._g_remove_and_log{s y%(((((r N)rrr9rrFrirrr|r rrrosH*M      )))))r r)r:rr!rrr exceptionsrrrr pathr r r utilsr undoredor attributesetrr __docformat__r#r)r%r=rr|r rrs}44444444------------6666666666$$$$$$========# 9*&)&)&)&)&)t&)&)&)RY %Y %Y %Y %Y %XY %Y %Y %Y %| ) ) ) ) ) ) ) ) ) )r