Fix #312: Rework Usage section

tomschr · tomschr · commit 539d72336b23 · 2020-11-03T23:34:05.000+01:00
* Correct :class: directive and use :class:`~semver.version.Version`
* Mention the rename of VersionInfo -&gt; Version class
* Remove semver. prefix in doctests to make examples shorter
* Correct some references to dunder methods like __getitem__, __gt__ etc.
* Use :py:exec: reference to Python exceptions.
* Remove inconsistencies and mention module level function as
  deprecated and discouraged from using
* Make empty super() call in semverwithvprefix.py example
* Add changelog.d file
diff --git a/changelog.d/312.doc.rst b/changelog.d/312.doc.rst
@@ -0,0 +1 @@
+Correct Usage section.
diff --git a/docs/semverwithvprefix.py b/docs/semverwithvprefix.py
@@ -7,25 +7,22 @@ class SemVerWithVPrefix(Version):
     """
 
     @classmethod
-    def parse(cls, version):
+    def parse(cls, version: str) -> "SemVerWithVPrefix":
         """
         Parse version string to a Version instance.
 
         :param version: version string with "v" or "V" prefix
-        :type version: str
         :raises ValueError: when version does not start with "v" or "V"
         :return: a new instance
-        :rtype: :class:`SemVerWithVPrefix`
         """
         if not version[0] in ("v", "V"):
             raise ValueError(
                 "{v!r}: not a valid semantic version tag. Must start with 'v' or 'V'".format(
                     v=version
                 )
             )
-        self = super(SemVerWithVPrefix, cls).parse(version[1:])
-        return self
+        return super().parse(version[1:])
 
-    def __str__(self):
+    def __str__(self) -> str:
         # Reconstruct the tag
-        return "v" + super(SemVerWithVPrefix, self).__str__()
+        return "v" + super().__str__()
diff --git a/docs/usage.rst b/docs/usage.rst
