[tor-commits] [bridgedb/master] Fix type specifiers on b.p.versions.Version class attr docstrings.

isis at torproject.org isis at torproject.org
Fri May 16 18:52:51 UTC 2014


commit 27ad2ee9f4695c11ba25445c9ba31b87fb78f4da
Author: Isis Lovecruft <isis at torproject.org>
Date:   Tue Apr 22 21:04:04 2014 +0000

    Fix type specifiers on b.p.versions.Version class attr docstrings.
    
    Also add more information on the potential attribute values.
---
 lib/bridgedb/parse/versions.py |   15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/lib/bridgedb/parse/versions.py b/lib/bridgedb/parse/versions.py
index 99944f4..e5e4ab5 100644
--- a/lib/bridgedb/parse/versions.py
+++ b/lib/bridgedb/parse/versions.py
@@ -28,11 +28,16 @@ from twisted.python import util as txutil
 class Version(txutil.Version):
     """Holds, parses, and does comparison operations for version numbers.
 
-    :attr string major: The major version number.
-    :attr string minor: The minor version number.
-    :attr string micro: The micro version number.
-    :attr string prerelease: Sometime, another number, though often suffixed
-        with a `-`, `+`, or `#`.
+    :attr str package: The package name, if available.
+    :attr int major: The major version number.
+    :attr int minor: The minor version number.
+    :attr int micro: The micro version number.
+    :attr str prerelease: The **prerelease** specifier isn't always present,
+        though when it is, it's usually separated from the main
+        ``major.minor.micro`` part of the version string with a ``-``, ``+``,
+        or ``#`` character. Sometimes the **prerelease** is another number,
+        although often it can be a word specifying the release state,
+        i.e. ``+alpha``, ``-rc2``, etc.
     """
 
     def __init__(self, version, package=None):





More information about the tor-commits mailing list