>TfxpddlZddlmZddlmZddlmZddlmZddl m Z ddl m Z ddl mZdd lmZdd lmZdd lTdd lTdd lmZdd lmZmZddlmZmZddlmZddl m!Z!ddl"m#Z#ddl$m%Z%ddl&m'Z'm(Z(m)Z)dZ*e Z+GddeZ,GddeZ-Gddej.Z/dS)N) defaultdict)GenericForeignKey)ValidationError)models)Sum)Signal)reverse) gettext_lazy) ObjectType)*) PathField)decompile_path_nodeobject_to_path_node)ChangeLoggedModel PrimaryModel) to_meters) ColorField)RestrictedQuerySet) WirelessLink) FrontPortRearPort PathEndpoint)Cable CablePathCableTerminationceZdZdZejeddedZejedde e j Z ej dej d dd Zejed d d ZeeddZejedddddZejeddedZejddddZdZGddZdddfd ZdZdZed Zejd!Zed"Zejd#Zfd$Z fd%Z!d&Z"xZ#S)'rz6 A physical connection between two endpoints. type2T) verbose_name max_lengthchoicesblankstatus)r r!r"defaultztenancy.Tenantcables)to on_delete related_namer#nulllabeld)r r!r#color)r r#length)r max_digitsdecimal_placesr#r*z length unit )r1r2r#r*)tenantrc>eZdZdZedZedZdS) Cable.Metapkcabler&N)__name__ __module__ __qualname__ordering_r verbose_name_plural7/var/www/html/netbox-4.1.3/netbox/dcim/models/cables.pyMetar7]s0qzz akkrBrDN)a_terminationsb_terminationsctj|i||jd|_|jd|_d|_|r||_|r ||_dSdS)Nidr$F) super__init____dict__get_pk _orig_status_terminations_modifiedrErF)selfrErFargskwargs __class__s rCrJzCable.__init__bs$)&)))=$$T**!M--h77&+#  1"0D   1"0D    1 1rBc6|jp|j}|jpd|S)N#)r9rMr+)rPr9s rC__str__z Cable.__str__ss# W z%XXX%rBc0td|jgS)Nz dcim:cable)rQ)r r9rPs rCget_absolute_urlzCable.get_absolute_urlws|47)4444rBct|dr|jS|jsgSd|jDS)N_a_terminationscFg|]}|jtjk|jSrA) cable_endCableEndChoicesSIDE_A termination.0cts rC z(Cable.a_terminations..1   ! P_Pf@f@fBN@f@f@frB)hasattrr[r9 terminationsallrXs rCrEzCable.a_terminationsz] 4* + + (' 'w I  %)%6%:%:%<%<    rBc`|jr|jt|krd|_||_dSNT)r9rElistrOr[rPvalues rCrEzCable.a_terminations5w /$-e<<*.D '$rBct|dr|jS|jsgSd|jDS)N_b_terminationscFg|]}|jtjk|jSrA)r]r^SIDE_Br`ras rCrdz(Cable.b_terminations..rerB)rfrqr9rgrhrXs rCrFzCable.b_terminationsrirBc`|jr|jt|krd|_||_dSrk)r9rFrlrOrqrms rCrFzCable.b_terminationsrorBctt|j#|jst t d|jjr*|jr|j st t d|j r|j|j fD]Ttdkr?tfdddDst t dU|jr|j r|jdj j}|j dj j}|t|vr1t t d||||kr]t%d |jD}t%d |j D}||zrt t d |jD]&}t'|d | '|j D](}t'|d| 'dSdS)Nz/Must specify a unit when setting a cable lengthz;Must define A and B terminations when creating a new cable.rc3^K|]'}t|tdV(dSrN isinstancer)rbttermss rC zCable.clean..s8-_-_PQjDqNN.K.K-_-_-_-_-_-_rBz@Cannot connect different termination types to same end of cable.rz5Incompatible termination types: {type_a} and {type_b})type_atype_bc32K|]}|j |jVdSNr8rbobjs rCr|zCable.clean..+PP3PPPPPPPrBc32K|]}|j |jVdSrr8rs rCr|zCable.clean..rrBz7A and B terminations cannot connect to the same object.Ar:r]r`B)rIcleanr. length_unitrr?_stateaddingrErFrOlenrh_meta model_nameCOMPATIBLE_TERMINATION_TYPESrLformatsetr)rPa_typeb_typea_pksb_pksr`r{rSs @rCrz Cable.cleans   ; "4+; "!!$U"V"VWW W ;  dt': d$BU d!!$a"b"bcc c  & ]-t/BC q qu::>>#-_-_-_-_UZ[\[][]U^-_-_-_*_*_>)!,n*o*oppp" t': ,Q/5@,Q/5@!=!A!A&!I!III)QRRYYagpvYwwV## PP$2EPPPPPEPP$2EPPPPPE -WXX $2 ] ]  ts TTTZZ\\\\#2 ] ]  ts TTTZZ\\\\= ] ]: ] ]rBc|jdu}|j'|jr t|j|j|_nd|_|jd|_t j|i||j|_d|j dD}d|j dD}|j r|| D])\}}|jr||j vr| *| D])\}}|jr||jvr| *|j rr|j D]1}|jr||vr$t|d|2|jD]1}|jr||vr$t|d|2t t$||dS) Nci|] }|j| SrAr`ras rC zCable.save..___"."___rBr)r]ci|] }|j| SrArras rCrzCable.save..rrBrr)instancecreated)r9r.rr _abs_lengthrIsaverMrgfilterrOitemsrEdeleterFr trace_pathssendr) rPrQrR_createdrErFr`rcrSs rCrz Cable.saves'7d? ; "t'7 "(d6FGGD  #D  ; !D  d%f%%%7`_t7H7O7OZ]7O7^7^_____t7H7O7OZ]7O7^7^___  & #1#7#7#9#9   R> k9L&L&LIIKKK#1#7#7#9#9   R> k9L&L&LIIKKK  & `#2 ` ` "~`N)J)J$43KXXX]]___#2 ` ` "~`N)J)J$43KXXX]]___x@@@@@rBcJtj|jSr)LinkStatusChoicescolorsrLr$rXs rCget_status_colorzCable.get_status_colors '++DK888rB)$r;r<r=__doc__r CharFieldr?CableTypeChoicesrrSTATUS_CONNECTEDr$ ForeignKeyPROTECTr5r+rr- DecimalFieldr.CableLengthUnitChoicesrr clone_fieldsrDrJrVrYpropertyrEsetterrFrrr __classcell__rSs@rCrr&s 6 QvYY     D V Qx[[!!2 F V  .  F F QwZZ   E JQwZZ   E!V Qx[[  F#&"Q}%%& K&&%  K'L******** .2$1111111"&&&555   X  %%%    X  %%% (](](](](]T(A(A(A(A(AT9999999rBrc,eZdZdZejdejdZejde e dZ ejde ej d ZejZed d ZejdejddZejdejddZejdejddZejdejddZejZGddZdZfdZfdZfdZdZde_ fdZ!xZ"S)rzv A mapping between side A or B of a Cable and a terminating object (e.g. an Interface or CircuitTermination). z dcim.Cablerg)r'r(r)rend)r!r"r zcontenttypes.ContentType+)r'limit_choices_tor(r)termination_typetermination_id)ct_fieldfk_fieldz dcim.DeviceT)r'r(r#r*z dcim.Rackz dcim.Locationz dcim.SiteceZdZdZejdfZejddfZe dZ e dZ dS) CableTermination.Meta)r:r]r9rr)fieldsz*%(app_label)s_%(class)s_unique_termination)rnamezcable terminationzcable terminationsN) r;r<r=r>rIndexindexesUniqueConstraint constraintsr?r r@rArBrCrDr.sx/ FL F G G G  $F #=A    q,-- a 455rBrDc&d|jd|jS)NzCable z to )r:r`rXs rCrVzCableTermination.__str__<s: ::(8:::rBc  ttj|j|j}|jjr| |j}| }|Vttd |jj|jj|j|jj|jjdkrZ|jjt$vrGttd |j|jjdkr(|jjttd dSdS) Nr)r:zVDuplicate termination found for {app_label}.{model} {termination_id}: cable {cable_pk}) app_labelmodelrcable_pk interfacez8Cables cannot be terminated to {type_display} interfaces) type_displaycircuitterminationzFCircuit terminations attached to a provider network may not be cabled.)rIrrobjectsrrrr:r9excludefirstrr?rrrr`rNONCONNECTABLE_IFACE_TYPESget_type_displayprovider_network)rPqsexisting_terminationrSs rCrzCableTermination.clean?s}   % , ,!2.-   := .$*--B!xxzz  +!jqq"3=/5#'#617: r   &+ 5 5$:J:OSm:m:m!LMMTT!%!1!B!B!D!DU   &*> > >4CSCdCp!!$l"m"mnn n ? >CpCprBc@|tj|i||jjjj|j}| |j |_ |j |_ |dS)Nr8) cache_related_objectsrIrr`rrrrLrsnapshotr:r]rPrQrRr`rSs rCrzCableTermination.save`s ""$$$ d%f%%%&,2:>>$BU>VV  J  $ rBc|jjjj|j}|d|_d|_| tj |i|dS)Nr8r) r`rrrrLrrr:r]rrIrrs rCrzCableTermination.deletens&,2:>>$BU>VV   " ''''''rBc|jJt|jddrU|jj|_|jjj|_|jjj|_|jjj|_ dSt|jddr?|jj|_|jjj|_|jjj|_ dSt|jddr|jj|_ dSdS)z Cache objects related to the termination (e.g. device, rack, site) directly on the object to enable efficient filtering. Ndeviceracksite) r`getattrr_devicer_racklocation _locationr_siterXs rCrz&CableTermination.cache_related_objectsys +++ 4#Xt 4 4 /+2DL)05DJ!-4=DN)05DJJJT%vt 4 4 /).DJ!-2;DN).3DJJJT%vt 4 4 /).DJJJ / /rBcbt|}|j|_|Sr)rIto_objectchanger`related_object)rPaction objectchangerSs rCrz CableTermination.to_objectchanges+ww..v66 &*&6 #rB)#r;r<r=rrrCASCADEr:rr^r?r]CABLE_TERMINATION_MODELSrrPositiveBigIntegerFieldrrr`rrrrr as_managerrrDrVrrrr alters_datarrrs@rCrrsF F  .#   E ! QuXXI )v( %1.  4V355N###!K  f .  G F  .     E "! .  I F  .     E, +--G 6 6 6 6 6 6 6 6;;;oooooB      ( ( ( ( (///.)-%rBrceZdZdZejedeZej eddZ ej eddZ ej eddZ e ZdZGd d Zd Zfd Zed ZedZedZedZedZedZedZdZde_dZdZdZ dZ!dZ"xZ#S)raH A CablePath instance represents the physical path from a set of origin nodes to a set of destination nodes, including all intermediate elements. `path` contains the ordered set of nodes, arranged in lists of (type, ID) tuples. (Each cable in the path can terminate to one or more objects.) For example, consider the following topology: A B C Interface 1 --- Front Port 1 | Rear Port 1 --- Rear Port 2 | Front Port 3 --- Interface 2 Front Port 2 Front Port 4 This path would be expressed as: CablePath( path = [ [Interface 1], [Cable A], [Front Port 1, Front Port 2], [Rear Port 1], [Cable B], [Rear Port 2], [Front Port 3, Front Port 4], [Cable C], [Interface 2], ] ) `is_active` is set to True only if every Cable within the path has a status of "connected". `is_complete` is True if the instance represents a complete end-to-end path from origin(s) to destination(s). `is_split` is True if the path diverges across multiple cables. `_nodes` retains a flattened list of all nodes within the path to enable simple filtering. path)r r%z is activeFz is completezis splitTc:eZdZedZedZdS)CablePath.Metaz cable pathz cable pathsN)r;r<r=r?r r@rArBrCrDrs-q a ..rBrDcBd|jdt|jdS)NzPath #z: z hops)r9rrrXs rCrVzCablePath.__str__s%8883ty>>8888rBcLttj|j|_t j|i||j}d|jdD}|j | |j dS)Nc8g|]}t|dS)r)rrbnodes rCrdz"CablePath.save..s&LLLt)$//2LLLrBrpk__in)_path) rl itertoolschainr_nodesrIr origin_type model_classrrupdater9)rPrQrR origin_model origin_idsrSs rCrzCablePath.saves9?DI677  d%f%%%'3355 LLty|LLL ##:#66==DG=LLLLLrBc|jrBt|jdd\}}tj|SdS)Nr)rrr r get_for_idrPct_idr?s rCrzCablePath.origin_typesH 9 8*49Q<?;;HE1%0077 7 8 8rBc|jrBt|jdd\}}tj|SdS)Nr) is_completerrr rrrs rCdestination_typezCablePath.destination_typesJ   8*49R=+;<>A%&&&rBc ddlm}sdStdkr%tfdddDsJg}g}d}d}d}r~tfdddDsJt dt sJtfd ddDsJtfd ddDsJtt d Ddkr,|r*tt|d krd}n|d DdDtdkrt|dkrdSnItdDsJtfdDsJdD}t|dkrd}d}g} D]5} t| | vr"| t| 6|| dD} td| Drd}t dtrtj d} tj | dD} t!}| D]*}|jdkrdnd}|t!|j|z}+tj |}d|DnfdDtfdddDsd}d}no|dDsnLt dt&rqt(j dD}t|dks|djdkr|dD|nt dt(rWtdkr>djdkr-t&j d Dd!}ntdkr|r|}tt|ksJt!}D]/}|}|t!|j|"z}0|t!usJt&j |}nE|r?t&j dj|#}nd}nQ|nJt d|rtdkrd}n |j djdjdkrd$nd%}|n|jr;|t|gt|jggd}n|jr@|js9|t|gt|jggnH|gnAtfd&ddDrd}ntdkrd}nd}d}n~|||||'S)(a> Create a new CablePath instance as traced from the given termination objects. These can be any object to which a Cable or WirelessLink connects (interfaces, console ports, circuit termination, etc.). All terminations must be of the same type and must belong to the same parent object. rCircuitTerminationNrc3DK|]}|jdjkVdSrwlinkrbrzrgs rCr|z(CablePath.from_origin..s1PP!qva!55PPPPPPrBFTc3^K|]'}t|tdV(dSrwrxr s rCr|z(CablePath.from_origin..$s9VVz!T,q/%:%:;;VVVVVVrBc3^K|]'}t|tdV(dSrwrxr s rCr|z(CablePath.from_origin..(s9ZZA:al1o)>)>??ZZZZZZrBc3DK|]}|jdjkVdSrw) parent_objectr s rCr|z(CablePath.from_origin..)s2ffPQ1?l1o.KKffffffrBc3$K|] }|jV dSrrrbrzs rCr|z(CablePath.from_origin..-s$44!qv444444rBr c,g|]}t|SrArr&s rCrdz)CablePath.from_origin..4s.+,#A&&rBc*g|]}|j |jSrrrbr`s rCrdz)CablePath.from_origin..9s#fff+IYIe[%IeIeIerBc3PK|]!}t|ttfvV"dSr)rrrrbrs rCr|z(CablePath.from_origin..@s2MMttDzze\%::MMMMMMrBc3^K|]'}t|tdV(dSrwrx)rbrlinkss rCr|z(CablePath.from_origin..As7JJDz$U1X77JJJJJJrBc*g|]}|j |jSrrr*s rCrdz)CablePath.from_origin..Ds$)w)w)w{^i^n^v+*:^v^v^vrBcFg|]}|jtjk|jSrA)r$rrr,s rCrdz)CablePath.from_origin..Qs*oooDT[L]Ln=n=nDK=n=n=nrBc.g|]}|tjkSrA)rr)rbr$s rCrdz)CablePath.from_origin..Rs!\\\VF/@@\\\rBcg|] }|j SrAr8r&s rCrdz)CablePath.from_origin..Zs'C'C'C'C'C'CrB)rtermination_id__inrr)r:r]cg|] }|j SrArras rCrdz)CablePath.from_origin..cs&Z&Z&Z"r~&Z&Z&ZrBcJg|]}|jdur|jn|j S)r) interface_a interface_b)rbrrgs rCrdz)CablePath.from_origin..fsC'''fj(8LO(K(KD$$QUQa'''rBc3^K|]'}t|tdV(dSrwrxrbrzremote_terminationss rCr|z(CablePath.from_origin..k;ddqz!T*=a*@%A%ABBddddddrBc0g|]}|t|Srr(r&s rCrdz)CablePath.from_origin..qs)+,q}#A&&}}}rBcg|] }|j SrA rear_port_idr&s rCrdz)CablePath.from_origin..|sHHHqANHHHrBrcg|] }|j SrA)rear_port_positionrbfps rCrdz)CablePath.from_origin..s*_*_*_R2+@*_*_*_rBcg|] }|j SrAr8)rbrps rCrdz)CablePath.from_origin..s)N)N)NB"%)N)N)NrB)rear_port_id__inrA)r?rA)r?rear_port_position__inZ)circuit term_sidec3^K|]'}t|tdV(dSrwrxr9s rCr|z(CablePath.from_origin..r;rB)rr  is_activeis_split)circuits.modelsrrrhryrrappendranyrr r get_for_modelrrQr]r:rr positionspopr9rIrJrrextendr)clsrgrrposition_stackr rLrMnot_connected_terminationsr&r links_statusrlocal_cable_terminationsq_filterlctr]remote_cable_terminations rear_ports front_portsrSrtpositioncircuit_terminationr.r:s ` @@rC from_originzCablePath.from_origin s 766666 4 |  q PPPP|ABB?OPPPPP P P P  j VVVV\RSRTRTEUVVVVV V V Vl1o|<< gZZZZVWVXVXIYZZZZZZZZffffUabcbdbdUeffffffff344|444445599":'*<'8'8Cr@R>4MMuMMMMM M M MJJJJEJJJJJ J J J*x)wl)w)w)w &-..22# F = =&t,,F::MM"5d";";<<< KK   poEoooL\\|\\\]] "! %(E** #-#5#C#CLQRO#T#T +;+C+J+J%5'C'Cl'C'C'C,K,,( 333HHC'*}';';I Y G G GGHH,<,D,K,KH,U,U)&Z&Z@Y&Z&Z&Z##''''ns'''# ddddL_`a`b`bLcddddd #  KK0C    ' -a0)<<R %-44HH4GHHH5 z??Q&&*Q-*AA*E*E"))*_*_K^*_*_*_```) /2H==H *++q005H5K5UYZ5Z5Z"+"3":":)N)N:M)N)N)N+,#;##KK ,--11n1 . 2 2 4 4I233s9~~EEEE !ssH1WW#,==?? A25X$V$V$VV#133...."+"3":":8"D"DKK#"+"3":":%8%;%>/=/A/A/C/C#;##KK $H* /24FGG' *++a//#H&8&@&G&G/2:%8%;%E%L%LccRU'H''%''$'.(9KK,-@AAB,-@-QRRS!#'K(-6I6OKK,-@AAB,-@-EFFG! 34 ddddL_`a`b`bLcddddd$"&KK,--22"'KK#(K#HUj Xs#     rBc||j}|rF|j|_|j|_|j|_|j|_|dS|dS)zX Retrace the path from the currently-defined originating termination(s) N)rcrrr rLrMrr)rP_news rCretracezCablePath.retracesi --   DI#/D !^DN MDM IIKKKKK KKMMMMMrBctt}|jD]/}t|\}}|||0i}|D]\}}t j| }|j |}t|dr| d}d|D||<g} |j D]b} g} | D]F}t|\}} | |||7#t$rYCwxYw| | c| S)zB Return the path as a list of prefetched objects. rrci|] }|j| SrA)rHrs rCrz'CablePath._get_path..s)!!! #!!!rB)rrlrrrOrr rrrrrfprefetch_relatedrKeyError) rP to_prefetchrr  object_id prefetched object_idsrquerysetrstepnodess rCrzCablePath._get_paths "$'' K 1 1D2488 E9   % %i 0 0 0 0 !,!2!2!4!4   E:$,77>>JJLLK"*111DDH{H-- ?#44X>>!!'/!!!Ju   I  DE  #6t#<#< yLLE!29!=>>>>D KK     s !D.. D;:D;ctjtj}g}|jD]/}t |\}}||kr||0|S)z7 Return all Cable IDs within the path. )r rrQrr9rrrO)rPcable_ct cable_idsrrcrHs rC get_cable_idszCablePath.get_cable_idssh%33E::= K % %D(..FBX~~  $$$rBc|}tj|d}|t dd}t |t |k}||fS)z Return a tuple containing the sum of the length of each cable in the path and a flag indicating whether the length is definitive. F)id__in_abs_length__isnullr)totalry)rurrr aggregaterr)rPrtr& total_length is_definitives rCget_total_lengthzCablePath.get_total_lengthss &&(( %%YE%RR''c-.@.@'AA'J F s9~~5 ]**rBcvddlm}|jd}t|dtur t j|St|dt ur*tjd|DSt|d|ur d|DSdS) K Return all available next segments in a split cable path. rrr ) rear_port__incg|] }|j SrAr>rBs rCrdz-CablePath.get_split_nodes...s2S2S2Sr2?2S2S2SrBrc6g|]}|SrA)get_peer_terminationras rCrdz-CablePath.get_split_nodes..1s1.0''))rBN)rNrrrrrrr)rPrrqs rCget_split_nodeszCablePath.get_split_nodes!s 766666!"% a>>X % %$++%+@@ @%(^^y ( (#**2S2SU2S2S2S*TT T %(^^1 1 149 2 1rBcddlm}g}|jD]E}t|dtt |fvr|d|DF|S)rrrc g|] }|j | Srrrs rCrdz2CablePath.get_asymmetric_nodes..=s(U(U(U$49CTCTCTCTrB)rNrrrrrrU)rPrasymmetric_nodesrqs rCget_asymmetric_nodeszCablePath.get_asymmetric_nodes5sw 766666& W WEE!H~~(I7I!JJJ ''(U(U%(U(U(UVVVrB)$r;r<r=rr JSONFieldr?rlr BooleanFieldrLr rMr r_netbox_privaterDrVrrrr rrrr classmethodrcrfrrrur}rrrrs@rCrrs]!!D 6 QvYY   D$#Q{^^I&&%Q}%%K#v"Qz]]HY[[FO////////999 M M M M M88X8 88X8 ""X"$$X$ %%X%''X'F F [F P   G"""H    + + +(        rBr)0r collectionsr"django.contrib.contenttypes.fieldsrdjango.core.exceptionsr django.dbrdjango.db.modelsrdjango.dispatchr django.urlsr django.utils.translationr r? core.modelsr dcim.choicesdcim.constants dcim.fieldsr dcim.utilsrr netbox.modelsrrutilities.conversionrutilities.fieldsrutilities.querysetsrwireless.modelsrdevice_componentsrrr__all__rrrModelrrArBrCrs.######@@@@@@222222 """"""666666""""""!!!!!!????????99999999******''''''222222((((((@@@@@@@@@@ fhh O9O9O9O9O9LO9O9O9d]]]]](]]]@g g g g g  g g g g g rB