[Author Prev][Author Next][Thread Prev][Thread Next][Author Index][Thread Index]
[tor-commits] [nyx/master] Revise Entry docs
commit 41c89b6f53e0146a2512fdef0a043041b63778ae
Author: Damian Johnson <atagar@xxxxxxxxxxxxxx>
Date: Sat Aug 29 14:36:06 2015 -0700
Revise Entry docs
Tidying up the docs a tad and noting parameter/return values.
---
nyx/connections/entries.py | 22 ++++++++++++++--------
1 file changed, 14 insertions(+), 8 deletions(-)
diff --git a/nyx/connections/entries.py b/nyx/connections/entries.py
index 579dd5c..8d1a0d4 100644
--- a/nyx/connections/entries.py
+++ b/nyx/connections/entries.py
@@ -72,8 +72,9 @@ class ConnectionPanelEntry(object):
def get_type(self):
"""
- Provides our best guess at the current type of the connection. This
- depends on consensus results, our current client circuits, etc.
+ Provides our best guess at the type of connection this is.
+
+ :returns: **Category** for the connection's type
"""
return self._connection_type
@@ -81,12 +82,11 @@ class ConnectionPanelEntry(object):
@lru_cache()
def is_private(self):
"""
- Returns true if the endpoint is private, possibly belonging to a client
- connection or exit traffic.
-
- This is used to scrub private information from the interface. Relaying
+ Checks if information about this endpoint should be scrubbed. Relaying
etiquette (and wiretapping laws) say these are bad things to look at so
DON'T CHANGE THIS UNLESS YOU HAVE A DAMN GOOD REASON!
+
+ :returns: **bool** indicating if connection information is sensive or not
"""
import nyx.connections.conn_entry
@@ -112,7 +112,9 @@ class ConnectionPanelEntry(object):
def get_lines(self):
"""
- Provides the individual lines in the connection listing.
+ Provides individual lines of connection information.
+
+ :returns: **list** of **ConnectionLine** concerning this entry
"""
return self.lines
@@ -120,7 +122,11 @@ class ConnectionPanelEntry(object):
@lru_cache()
def get_sort_value(self, attr):
"""
- Provides the value of a single attribute used for sorting purposes.
+ Value for sorting by a given attribute.
+
+ :param SortAtt attr: attribute to be sorted by
+
+ :returns: comparable object by the given attribute
"""
connection_line = self.lines[0]
_______________________________________________
tor-commits mailing list
tor-commits@xxxxxxxxxxxxxxxxxxxx
https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-commits