rename the render process in Styler (pandas-dev#41123)

Co-authored-by: JHM Darbyshire (iMac) <[email protected]>

asv_bench/benchmarks/io/style.py

@@ -17,19 +17,19 @@ def setup(self, cols, rows):
 
     def time_apply_render(self, cols, rows):
         self._style_apply()
-        self.st.render()
+        self.st._render_html()
 
     def peakmem_apply_render(self, cols, rows):
         self._style_apply()
-        self.st.render()
+        self.st._render_html()
 
     def time_classes_render(self, cols, rows):
         self._style_classes()
-        self.st.render()
+        self.st._render_html()
 
     def peakmem_classes_render(self, cols, rows):
         self._style_classes()
-        self.st.render()
+        self.st._render_html()
 
     def _style_apply(self):
         def _apply_func(s):

pandas/io/formats/style.py

@@ -200,7 +200,46 @@ def _repr_html_(self) -> str:
         """
         Hooks into Jupyter notebook rich display system.
         """
-        return self.render()
+        return self._render_html()
+
+    def render(self, **kwargs) -> str:
+        """
+        Render the ``Styler`` including all applied styles to HTML.
+
+        Parameters
+        ----------
+        **kwargs
+            Any additional keyword arguments are passed
+            through to ``self.template.render``.
+            This is useful when you need to provide
+            additional variables for a custom template.
+
+        Returns
+        -------
+        rendered : str
+            The rendered HTML.
+
+        Notes
+        -----
+        Styler objects have defined the ``_repr_html_`` method
+        which automatically calls ``self.render()`` when it's the
+        last item in a Notebook cell. When calling ``Styler.render()``
+        directly, wrap the result in ``IPython.display.HTML`` to view
+        the rendered HTML in the notebook.
+
+        Pandas uses the following keys in render. Arguments passed
+        in ``**kwargs`` take precedence, so think carefully if you want
+        to override them:
+
+        * head
+        * cellstyle
+        * body
+        * uuid
+        * table_styles
+        * caption
+        * table_attributes
+        """
+        return self._render_html(**kwargs)
 
     def set_tooltips(
         self,

pandas/io/formats/style_render.py

@@ -102,42 +102,10 @@ def __init__(
             tuple[int, int], Callable[[Any], str]
         ] = defaultdict(lambda: partial(_default_formatter, precision=def_precision))
 
-    def render(self, **kwargs) -> str:
+    def _render_html(self, **kwargs) -> str:
         """
-        Render the ``Styler`` including all applied styles to HTML.
-
-        Parameters
-        ----------
-        **kwargs
-            Any additional keyword arguments are passed
-            through to ``self.template.render``.
-            This is useful when you need to provide
-            additional variables for a custom template.
-
-        Returns
-        -------
-        rendered : str
-            The rendered HTML.
-
-        Notes
-        -----
-        Styler objects have defined the ``_repr_html_`` method
-        which automatically calls ``self.render()`` when it's the
-        last item in a Notebook cell. When calling ``Styler.render()``
-        directly, wrap the result in ``IPython.display.HTML`` to view
-        the rendered HTML in the notebook.
-
-        Pandas uses the following keys in render. Arguments passed
-        in ``**kwargs`` take precedence, so think carefully if you want
-        to override them:
-
-        * head
-        * cellstyle
-        * body
-        * uuid
-        * table_styles
-        * caption
-        * table_attributes
+        Renders the ``Styler`` including all applied styles to HTML.
+        Generates a dict with necessary kwargs passed to jinja2 template.
         """
         self._compute()
         # TODO: namespace all the pandas keys