Render front tooltips as help=

streamlitfront/elements/elements.py

@@ -110,7 +110,7 @@ def render_views(self):
 
 class View(FrontContainerBase):
     def render(self):
-        st.markdown(f"""## **{self.name}**""")
+        st.markdown(f"""## **{self.name}**""", help=self.tooltip)
         self._render_children()
 
 
@@ -150,6 +150,7 @@ def __init__(
         use_expander: bool = True,
         submit_button_label: str = "Submit",
         authentification: bool = False,
+        tooltip: str = None,
     ):
         super().__init__(
             obj=obj,
@@ -159,6 +160,7 @@ def __init__(
             display=display,
             auto_submit=auto_submit,
             on_submit=on_submit,
+            tooltip=tooltip,
         )
         self.use_expander = use_expander
         self.submit_button_label = submit_button_label
@@ -272,6 +274,7 @@ def _widget_on_change(self):
         label="name",
         key="view_key",
         value="view_value",
+        help="tooltip",
         on_change="_widget_on_change",
         **input_mapping,
     )

streamlitfront/spec_maker.py

@@ -35,6 +35,7 @@
             ELEMENT_KEY: App,
             Callable: {
                 ELEMENT_KEY: View,
+                "tooltips": True,
                 "description": {
                     ELEMENT_KEY: TextSection,
                 },

streamlitfront/tests/test_tooltips.py

@@ -0,0 +1,26 @@
+"""Docs of a function flow into streamlit's ``help=`` (streamlitfront#26)."""
+
+from streamlit.testing.v1 import AppTest
+
+_SCRIPT = '''
+from streamlitfront import mk_app
+
+def foo(a: int = 1, b: str = "x"):
+    """Summary line.
+
+    :param a: the a
+    :param b: the b
+    """
+    return a
+
+mk_app([foo])()
+'''
+
+
+def test_docs_become_help():
+    at = AppTest.from_string(_SCRIPT)
+    at.run()
+    assert not at.exception
+    assert at.number_input[0].help == "the a"
+    assert at.text_input[0].help == "the b"
+    assert any(m.help == "Summary line." for m in at.markdown)