Merge pull request github#11193 from github/redsun82/swift-avoid-doc-instead-of-desc

Swift: avoid wrongly using `doc` instead of `desc` for properties

Author: AlexDenisov

swift/codegen/lib/schema/defs.py

@@ -16,6 +16,8 @@ class _DocModifier(_schema.PropertyModifier):
     doc: str
 
     def modify(self, prop: _schema.Property):
+        if "\n" in self.doc or self.doc[-1] == ".":
+            raise _schema.Error("No newlines or trailing dots are allowed in doc, did you intend to use desc?")
         prop.doc = self.doc
 
 

swift/codegen/test/test_schema.py

@@ -559,6 +559,22 @@ class A:
     }
 
 
+def test_property_doc_override_no_newlines():
+    with pytest.raises(schema.Error):
+        @schema.load
+        class data:
+            class A:
+                x: int | defs.doc("no multiple\nlines")
+
+
+def test_property_doc_override_no_trailing_dot():
+    with pytest.raises(schema.Error):
+        @schema.load
+        class data:
+            class A:
+                x: int | defs.doc("no dots please.")
+
+
 def test_class_default_doc_name():
     @schema.load
     class data: