NeoAnd/netbox
1
0
Fork 0
mirror of https://github.com/netbox-community/netbox.git synced 2025-08-13 19:18:16 -06:00
Code Issues Actions 6 Packages Projects Releases Wiki Activity

Improve comments to help understand the code

Browse Source
This commit is contained in:
Sander Steffann 2019-10-09 16:34:09 +02:00
parent 0dc01681b1
commit 857f27c370
1 changed files with 5 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
netbox/dcim/models.py
View File

@ -129,7 +129,8 @@ class CableTermination(models.Model):
peer_port = far_end.get_peer_port()
if isinstance(far_end, RearPort) and far_end.positions > 1:
# We don't want to start tracing from a front port here, that is handled separately (see below)
# When we end up here we have a rear port with multiple front ports, and we don't know which front port
# to continue with. So this is the end of the line
return path
while peer_port:
@ -2937,6 +2938,9 @@ class Cable(ChangeLoggedModel):
Traverse both ends of a cable path and return its connected endpoints. Note that one or both endpoints may be
None.
"""
# Termination points trace from themselves, through the cable and beyond. Tracing from the B termination
# therefore traces in the direction of A [(termination_b, cable, termination_a), (...)] and vice versa.
# Every path therefore also has at least one segment (the current cable).
a_path = self.termination_b.trace()
b_path = self.termination_a.trace()