fix(utils): 🐛 format typed dict attribute docs

Author: adrianhdezm

src/utils/json-schema-to-typed-dict.ts

@@ -60,7 +60,12 @@ export function convertToTypedDict(name: string, schema: OpenAPI.SchemaObject |
         fields.push(`    ${key}: ${typeStr}`);
       }
       if (desc) {
-        attrLines.push(`${key}: ${desc.replace(/\n/g, ' ')}`);
+        const descLines = String(desc).split('\n');
+        attrLines.push(`${key}:`);
+        for (const dl of descLines) {
+          attrLines.push(`    ${dl}`);
+        }
+        attrLines.push('');
       }
     }
     if (fields.length === 0) {
@@ -73,6 +78,7 @@ export function convertToTypedDict(name: string, schema: OpenAPI.SchemaObject |
       docLines.push((flat.description as string).replace(/\n/g, ' '));
     }
     if (attrLines.length > 0) {
+      if (attrLines[attrLines.length - 1] === '') attrLines.pop();
       if (flat.description) docLines.push('');
       docLines.push('Attributes:');
       for (const line of attrLines) {
@@ -172,7 +178,12 @@ export function convertToTypedDict(name: string, schema: OpenAPI.SchemaObject |
         fields.push(`    ${key}: ${typeStr}`);
       }
       if (desc) {
-        attrLines.push(`${key}: ${desc.replace(/\n/g, ' ')}`);
+        const descLines = String(desc).split('\n');
+        attrLines.push(`${key}:`);
+        for (const dl of descLines) {
+          attrLines.push(`    ${dl}`);
+        }
+        attrLines.push('');
       }
     }
     if (fields.length === 0) {
@@ -185,6 +196,7 @@ export function convertToTypedDict(name: string, schema: OpenAPI.SchemaObject |
       docLines.push((flat.description as string).replace(/\n/g, ' '));
     }
     if (attrLines.length > 0) {
+      if (attrLines[attrLines.length - 1] === '') attrLines.pop();
       if (flat.description) docLines.push('');
       docLines.push('Attributes:');
       for (const line of attrLines) {

tests/__snapshots__/json-schema-to-typed-dict.spec.ts.snap

@@ -6,11 +6,29 @@ exports[`generate-python-dict > adds descriptions as comments 1`] = `
     User object
     
     Attributes:
-        id: identifier
+        id:
+            identifier
     """
     id: Required[str]"
 `;
 
+exports[`generate-python-dict > formats multiline attribute descriptions 1`] = `
+"class Multi(TypedDict, total=False):
+    """
+    Multi attr example
+    
+    Attributes:
+        id:
+            identifier
+            first line
+        
+        name:
+            the name
+    """
+    id: str
+    name: str"
+`;
+
 exports[`generate-python-dict > generates a simple object schema 1`] = `
 "from typing import TypedDict, Required
 class User(TypedDict, total=False):

tests/json-schema-to-typed-dict.spec.ts

@@ -74,6 +74,29 @@ describe('generate-python-dict', () => {
     expect(definition).toMatchSnapshot();
   });
 
+  it('formats multiline attribute descriptions', () => {
+    const doc: OpenAPI.Document = {
+      openapi: '3.1.0',
+      info: { title: 't', version: '1' },
+      paths: {},
+      components: {
+        schemas: {
+          Multi: {
+            type: 'object',
+            description: 'Multi attr example',
+            properties: {
+              id: { type: 'string', description: 'identifier\nfirst line' },
+              name: { type: 'string', description: 'the name' }
+            }
+          }
+        }
+      }
+    };
+    const schemas = extractSchemas(doc, null);
+    const { definition } = convertToTypedDict('Multi', schemas.Multi as OpenAPI.SchemaObject);
+    expect(definition).toMatchSnapshot();
+  });
+
   it('handles allOf with refs and properties', () => {
     const doc: OpenAPI.Document = {
       openapi: '3.1.0',