Add `explode_split` to documentation

[etc/vim.git] / tests / comments.py

diff --git a/tests/comments.py b/tests/comments.py
index e661ba642af52b4c3e9149e1444886ad0d5ffeff..8ce9ffee49af68759a7605cceea6779c5b70515b 100644 (file)
--- a/tests/comments.py
+++ b/tests/comments.py
@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+# fmt: on
 # Some license here.
 #
 # Has many lines. Many, many lines.
@@ -21,6 +22,8 @@ except ImportError:
 
 
 # Some comment before a function.
+
+
 def function(default=None):
     """Docstring comes first.
 
@@ -40,17 +43,40 @@ def function(default=None):
 
 
 # Explains why we use global state.
-GLOBAL_STATE = {'a': a(1), 'b': a(2), 'c': a(3)}
+GLOBAL_STATE = {"a": a(1), "b": a(2), "c": a(3)}
+
+
+# Another comment!
+# This time two lines.
+
+
+class Foo:
+    """Docstring for class Foo.  Example from Sphinx docs."""
+
+    #: Doc comment for class attribute Foo.bar.
+    #: It can have multiple lines.
+    bar = 1
+
+    flox = 1.5  #: Doc comment for Foo.flox. One line only.
+
+    baz = 2
+    """Docstring for class attribute Foo.baz."""
+
+    def __init__(self):
+        #: Doc comment for instance attribute qux.
+        self.qux = 3
+
+        self.spam = 4
+        """Docstring for instance attribute spam."""
 
 
-# Another comment
 @fast(really=True)
 async def wat():
     async with X.open_async() as x:  # Some more comments
         result = await x.method1()
     # Comment after ending a block.
     if result:
-        print('A OK', file=sys.stdout)
+        print("A OK", file=sys.stdout)
         # Comment between things.
         print()