summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorIsis Lovecruft <isis@torproject.org>2015-05-10 23:13:42 +0000
committerIsis Lovecruft <isis@torproject.org>2015-05-12 06:50:48 +0000
commit62701b3c3673ad474831363827bcb2a22580bef6 (patch)
tree0748d049edcefb4d55d0d9c4476c0066b5ea137b
parent31a6b5a18ba9b5319d1c32a1fda147f502b52827 (diff)
Cleanup bridgedb.Stability module docstring and add file header.
-rw-r--r--lib/bridgedb/Stability.py34
1 files changed, 26 insertions, 8 deletions
diff --git a/lib/bridgedb/Stability.py b/lib/bridgedb/Stability.py
index 981e005..ad6fd0c 100644
--- a/lib/bridgedb/Stability.py
+++ b/lib/bridgedb/Stability.py
@@ -1,13 +1,30 @@
+# -*- coding: utf-8 ; test-case-name: bridgedb.test.test_Stability -*-
+#
+# This file is part of BridgeDB, a Tor bridge distribution system.
+#
+# :authors: please see the AUTHORS file for attributions
+# :copyright: (c) 2013-2015, Isis Lovecruft
+# (c) 2013-2015, Matthew Finkel
+# (c) 2012-2015, Aaron Gibson
+# (c) 2007-2015, Nick Mathewson
+# (c) 2007-2015, The Tor Project, Inc.
+# :license: see LICENSE for licensing information
+
+"""This module provides functionality for tracking bridge stability metrics.
+
+Bridge stability metrics are calculated using the model introduced in
+`"An Analysis of Tor Bridge Stability"`_ and
+`implemented in the Tor Metrics library`_.
+
+.. An Analysis of Tor Bridge Stability:
+ https://metrics.torproject.org/papers/bridge-stability-2011-10-31.pdf
+ Karsten Loesing, An Analysis of Tor Bridge Stability. Technical Report.
+ The Tor Project, October 2011.
+
+.. implemented in the Tor Metrics library:
+ https://gitweb.torproject.org/metrics-tasks/task-4255/SimulateBridgeStability.java
"""
-This module provides functionality for tracking bridge stability metrics, using
-the model introduced in [1] and implemented in [2].
-[1] Karsten Loesing, An Analysis of Tor Bridge Stability. Technical Report.
-The Tor Project, October 2011.
-https://metrics.torproject.org/papers/bridge-stability-2011-10-31.pdf
-
-[2] https://gitweb.torproject.org/metrics-tasks/task-4255/SimulateBridgeStability.java
-"""
import logging
import bridgedb.Storage
@@ -15,6 +32,7 @@ import bridgedb.Storage
weighting_factor = float(19)/float(20)
discountIntervalMillis = long(60*60*12*1000)
+
class BridgeHistory(object):
""" Record Class that tracks a single Bridge
The fields stored are: