dch: Add doctests for snapshot_version

1 files changed, 9 insertions, 1 deletions

diff --git a/gbp/scripts/dch.py b/gbp/scripts/dch.py
index a7c3d994..8307b6cf 100644
--- a/gbp/scripts/dch.py
+++ b/gbp/scripts/dch.py
@@ -145,8 +145,16 @@ def fixup_trailer(repo, git_author, dch_options):
 
 def snapshot_version(version):
     """
-    get the current release and snapshot version
+    Get the current release and snapshot version.
+
     Format is <debian-version>~<release>.gbp<short-commit-id>
+
+    >>> snapshot_version('1.0-1')
+    ('1.0-1', 0)
+    >>> snapshot_version('1.0-1~1.test0')
+    ('1.0-1~1.test0', 0)
+    >>> snapshot_version('1.0-1~2.gbp1234')
+    ('1.0-1', 2)
     """
     try:
         (release, suffix) = version.rsplit('~', 1)