o 2cC@sddlZddlZddlZddlZddlZddlZddlZddlZddl ZGdddZ Gdddej j Z Gdddej j ZGdd d ej j ZGd d d ZdS) Nc@s6eZdZddZd ddZddZdd Zd d Zd S)TransactionManagercCt)zBegin a read-only transaction.NotImplementedErrorselfrE/var/www/html/gps/gps/lib/python3.10/site-packages/dns/transaction.pyreaderzTransactionManager.readerFcCr)aBegin a writable transaction. *replacement*, a ``bool``. If `True`, the content of the transaction completely replaces any prior content. If False, the default, then the content of the transaction updates the existing content. r)r replacementrrr writerszTransactionManager.writercCr)aqReturns a tuple (absolute_origin, relativize, effective_origin) giving the absolute name of the default origin for any relative domain names, the "effective origin", and whether names should be relativized. The "effective origin" is the absolute origin if relativize is False, and the empty name if relativize is true. (The effective origin is provided even though it can be computed from the absolute_origin and relativize setting because it avoids a lot of code duplication.) If the returned names are `None`, then no origin information is available. This information is used by code working with transactions to allow it to coordinate relativization. The transaction code itself takes what it gets (i.e. does not change name relativity). rrrrr origin_informationsz%TransactionManager.origin_informationcCr)z.The class of the transaction manager. rrrrr get_class7szTransactionManager.get_classcCs|\}}}|r |SdS)z,Origin to use in from_wire() calls. N)r)rabsolute_origin relativize_rrr from_wire_origin<sz#TransactionManager.from_wire_originN)F)__name__ __module__ __qualname__r r rrrrrrr rs    rc@eZdZdZdS)DeleteNotExactz>Existing data did not match data specified by an exact delete.Nrrr__doc__rrrr rFrc@r)ReadOnlyz*Tried to write to a read-only transaction.Nrrrrr rJrrc@r) AlreadyEndedz*Tried to use an already-ended transaction.Nrrrrr rNrrc@seZdZdAddZejjfddZddZdd Z d d Z d d Z ddZ ddZ ddejjfddZddZddZddZddZddZd d!Zd"d#Zd$d%Zd&d'Zd(d)Zd*d+Zd,d-Zd.d/Zd0d1Zd2d3Zd4d5Z d6d7Z!d8d9Z"d:d;Z#dd?Z%d@S)B TransactionFcCs||_||_||_d|_dSNF)managerr read_only_ended)rr r r!rrr __init__Ts zTransaction.__init__cCsb|t|trtj|d}tjj|}| |||}|dur/t|tj j s/tj |}|S)zReturn the rdataset associated with *name*, *rdtype*, and *covers*, or `None` if not found. Note that the returned rdataset is immutable. N) _check_ended isinstancestrdnsname from_text rdatatype RdataTypemake _get_rdatasetrdatasetImmutableRdataset)rr(rdtypecoversr.rrr get^s   zTransaction.getcC|jrtdSN)r!rrrrr _check_read_onlynzTransaction._check_read_onlycG|||d|S)zAdd records. The arguments may be: - rrset - name, rdataset... - name, ttl, rdata... Fr$r5_addrargsrrr addrs  zTransaction.addcGr7)aReplace the existing rdataset at the name with the specified rdataset, or add the specified rdataset if there was no existing rdataset. The arguments may be: - rrset - name, rdataset... - name, ttl, rdata... Note that if you want to replace the entire node, you should do a delete of the name followed by one or more calls to add() or replace(). Tr8r:rrr replaces zTransaction.replacecGr7)a,Delete records. It is not an error if some of the records are not in the existing set. The arguments may be: - rrset - name - name, rdataclass, rdatatype, [covers] - name, rdataset... - name, rdata... Fr$r5_deleter:rrr deletes zTransaction.deletecGr7)a@Delete records. The arguments may be: - rrset - name - name, rdataclass, rdatatype, [covers] - name, rdataset... - name, rdata... Raises dns.transaction.DeleteNotExact if some of the records are not in the existing set. Tr>r:rrr delete_exacts zTransaction.delete_exactcCs*|t|trtj|d}||S)zDoes the specified name exist?N)r$r%r&r'r(r) _name_existsrr(rrr name_existss  zTransaction.name_existsTcCs||dkr tdt|trtj|d}||tjj tjj }|dus-t |dkr/t |r=tj |dj |}ntj |}|j}|dkrLd}|dj|d}tj|j|}|||dS)aUpdate the serial number. *value*, an `int`, is an increment if *relative* is `True`, or the actual value to set if *relative* is `False`. Raises `KeyError` if there is no SOA rdataset at *name*. Raises `ValueError` if *value* is negative or if the increment is so large that it would cause the new serial to be less than the prior value. rznegative update_serial() valueNrE)serial)r$ ValueErrorr%r&r'r(r)r-r*SOANONElenKeyErrorrFSerialvaluer=r. from_rdatattl)rrMrelativer(r.rFrdata new_rdatasetrrr update_serials&    zTransaction.update_serialcC||Sr4)r$_iterate_rdatasetsrrrr __iter__szTransaction.__iter__cCrT)aHas this transaction changed anything? For read-only transactions, the result is always `False`. For writable transactions, the result is `True` if at some time during the life of the transaction, the content was changed. )r$_changedrrrr changedszTransaction.changedcC|ddS)aCommit the transaction. Normally transactions are used as context managers and commit or rollback automatically, but it may be done explicitly if needed. A ``dns.transaction.Ended`` exception will be raised if you try to use a transaction after it has been committed or rolled back. Raises an exception if the commit fails (in which case the transaction is also rolled back. TN_endrrrr commits zTransaction.commitcCrY)avRollback the transaction. Normally transactions are used as context managers and commit or rollback automatically, but it may be done explicitly if needed. A ``dns.transaction.AlreadyEnded`` exception will be raised if you try to use a transaction after it has been committed or rolled back. Rollback cannot otherwise fail. FNrZrrrr rollbacks zTransaction.rollbackcCst|dkr td|dS)Nrzextra parameters to )rJ TypeError)rmethodr;rrr _raise_if_not_emptys zTransaction._raise_if_not_emptycCsz[|}t|tjjr|}|WSt|tjjr|}|WS|r$d}n t|tr9|}|tj j kr8t |dnt |d|}t|tj jrUtj||}|WSt |dtyn|rgYdSt |dw)Nrz: TTL value too bigz: expected a TTLz: expected an Rdataz: expected more arguments)popleftr%r'rrsetRRset to_rdatasetr.RdatasetintrOMAX_TTLrGr^rQRdatarN IndexError)rr_deletingr;argr.rOrrr _rdataset_from_argss4   zTransaction._rdataset_from_argsc Csvzt|}|r d}nd}|}t|trtj|d}t|tjjr.|}| |d|}nt|tj j r?|}|j}| }n t |dd|j|jkrWt|d|jtjjkrq|j\}}} || krqt|d||||s|||j|j} | durt| tjjrtj| j| j| j} | | | } | |}|||WdStyt d|w) Nz replace()zadd()F requires a name or RRset as the first argument has objects of wrong RdataClassz has non-origin SOAnot enough parameters to ) collectionsdequerar%r&r'r(r)Namerlrbrcrdr^rdclassr rrGr0r*rHrr`r-r1r.r/reupdateunion _put_rdatasetri) rr=r;r_rkr(r.rbroriginexistingtrdsrrr r98sT          zTransaction._addc CsLzt|}|r d}nd}|}t|trtj|d}t|tjjr|}t |dkrt|dt s;t|dtrtj j |}t |dkrTtj j |}ntj j}|||||||}|duru|rrt|dWdS||||WdS||d|} nt|tjjr|} | j}n t|dd|||| r| j|jkrt|d||| j| j}|dur|r|| } | | krt|d || } t | dkr||| j| jWdS||| WdS|rt|dWdS|r| |st|d |!|WdSt"y%td |w) Nzdelete_exact()zdelete()rz: missing rdatasetTrmrnroz: missing rdatasz: name not knownrp)#rqrrrar%r&r'r(r)rsrJrfr*r+r,rIr`r-r_delete_rdatasetrlrbrcr^rtr rrGr0r1 intersection differencerwrB _delete_nameri) rexactr;r_rkr(r0r1ryr.r|rrr r?dsv             zTransaction._deletecCr3r4)r"rrrrr r$r6zTransaction._check_endedcCs2||jr tz ||Wd|_dSd|_w)NT)r$r"r_end_transactionrr\rrr r[s  zTransaction._endcCs|Sr4rrrrr __enter__szTransaction.__enter__cCs&|js|dur |dS|dSr)r"r\r])rexc_typeexc_valexc_tbrrr __exit__s zTransaction.__exit__cCr)zlReturn the rdataset associated with *name*, *rdtype*, and *covers*, or `None` if not found. rrr(r0r1rrr r-szTransaction._get_rdatasetcCr)zStore the rdataset.r)rr(r.rrr rwr zTransaction._put_rdatasetcCr)zlDelete all data associated with *name*. It is not an error if the rdataset does not exist. rrCrrr r~zTransaction._delete_namecCr)zDelete all data associated with *name*, *rdtype*, and *covers*. It is not an error if the rdataset does not exist. rrrrr r{rzTransaction._delete_rdatasetcCr)z2Does name exist? Returns a bool. rrCrrr rBrzTransaction._name_existscCr)z&Has this transaction changed anything?rrrrr rWr zTransaction._changedcCr)zEnd the transaction. *commit*, a bool. If ``True``, commit the transaction, otherwise roll it back. If committing adn the commit fails, then roll back and raise an exception. rrrrr rs zTransaction._end_transactioncCr)zSet the origin. This method is called when reading a possibly relativized source, and an origin setting operation occurs (e.g. $ORIGIN in a zone file). r)rrxrrr _set_originszTransaction._set_origincCr)zxReturn an iterator that yields (name, rdataset) tuples. Not all Transaction subclasses implement this. rrrrr rUrzTransaction._iterate_rdatasetsN)FF)&rrrr#r'r*rIr2r5r<r=r@rArDr(emptyrSrVrXr\r]r`rlr9r?r$r[rrr-rwr~r{rBrWrrrUrrrr rRs>     ,?   r)rq dns.exceptionr'dns.namedns.rdataclass dns.rdataset dns.rdatatype dns.rrset dns.serialdns.ttlr exception DNSExceptionrrrrrrrr s7