fixes #778

Author: jph00

fastcore/_modidx.py

@@ -271,6 +271,8 @@
                                    'fastcore.docments.DocmentText._ret_str': ('docments.html#docmenttext._ret_str', 'fastcore/docments.py'),
                                    'fastcore.docments.DocmentText.params': ('docments.html#docmenttext.params', 'fastcore/docments.py'),
                                    'fastcore.docments.MarkdownRenderer': ('docments.html#markdownrenderer', 'fastcore/docments.py'),
+                                   'fastcore.docments.MarkdownRenderer.__repr__': ( 'docments.html#markdownrenderer.__repr__',
+                                                                                    'fastcore/docments.py'),
                                    'fastcore.docments.MarkdownRenderer._repr_markdown_': ( 'docments.html#markdownrenderer._repr_markdown_',
                                                                                            'fastcore/docments.py'),
                                    'fastcore.docments.ShowDocRenderer': ('docments.html#showdocrenderer', 'fastcore/docments.py'),

fastcore/docments.py

@@ -429,4 +429,9 @@ def _repr_markdown_(self):
         doc = f'```python\n\n{self.dm}\n\n```'
         if self.docs: doc += f"\n\n{_ital_first(self.docs)}"
         return doc
-    __repr__=__str__=_repr_markdown_
+
+    def __repr__(self):
+        doc = str(self.dm)
+        if self.docs: doc += f'"""\n{self.docs}\n"""'
+        return doc
+    __str__=__repr__

nbs/04_docments.ipynb

@@ -2485,7 +2485,12 @@
     "        doc = f'```python\\n\\n{self.dm}\\n\\n```'\n",
     "        if self.docs: doc += f\"\\n\\n{_ital_first(self.docs)}\"\n",
     "        return doc\n",
-    "    __repr__=__str__=_repr_markdown_"
+    "\n",
+    "    def __repr__(self):\n",
+    "        doc = str(self.dm)\n",
+    "        if self.docs: doc += f'\"\"\"\\n{self.docs}\\n\"\"\"'\n",
+    "        return doc\n",
+    "    __str__=__repr__"
    ]
   },
   {
@@ -2510,17 +2515,13 @@
        "*Do a thing*"
       ],
       "text/plain": [
-       "```python\n",
-       "\n",
        "def _f(\n",
        "    a, b:callable=print, # param b\n",
        "    c:str='foo', # param c\n",
        ")->str: # Result of doing it\n",
-       "\n",
-       "\n",
-       "```\n",
-       "\n",
-       "*Do a thing*"
+       "\"\"\"\n",
+       "Do a thing\n",
+       "\"\"\""
       ]
      },
      "execution_count": null,
@@ -2539,6 +2540,30 @@
     "MarkdownRenderer(_f)"
    ]
   },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "0c739d71",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "def _f(\n",
+      "    a, b:callable=print, # param b\n",
+      "    c:str='foo', # param c\n",
+      ")->str: # Result of doing it\n",
+      "\"\"\"\n",
+      "Do a thing\n",
+      "\"\"\"\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(MarkdownRenderer(_f))"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": null,