initial HTML rendering for Series

pandas/core/series.py

@@ -1586,6 +1586,129 @@ def __repr__(self):
 
         return result
 
+    def _repr_html_(self) -> Optional[str]:
+        """
+        Return a html representation for a particular DataFrame.
+
+        Mainly for IPython notebook.
+        """
+        if get_option("display.notebook_repr_html"):
+            max_rows = get_option("display.max_rows")
+            min_rows = get_option("display.min_rows")
+            max_cols = get_option("display.max_columns")
+            show_dimensions = get_option("display.show_dimensions")
+
+            formatter = fmt.SeriesFormatter(
+                self,
+                name=self.name,
+                length=show_dimensions,
+                header=True,
+                index=True,
+                dtype=True,
+                na_rep="NaN",
+                float_format=None,
+                min_rows=min_rows,
+                max_rows=max_rows,
+                show_dimensions=show_dimensions,
+                decimal=".",
+                series_id=None,
+                render_links=False,
+            )
+            return formatter.to_html(notebook=True)
+        else:
+            return None
+
+    @Substitution(
+        header_type="bool",
+        header="Whether to print column labels, default True",
+        col_space_type="str or int",
+        col_space="The minimum width of each column in CSS length "
+        "units.  An int is assumed to be px units.\n\n"
+        "            .. versionadded:: 0.25.0\n"
+        "                Ability to use str",
+    )
+    @Substitution(shared_params=fmt.common_docstring, returns=fmt.return_docstring)
+    def to_html(
+        self,
+        buf=None,
+        col_space=None,
+        header=True,
+        index=True,
+        na_rep="NaN",
+        formatters=None,
+        float_format=None,
+        sparsify=None,
+        index_names=True,
+        justify=None,
+        max_rows=None,
+        show_dimensions=False,
+        decimal=".",
+        bold_rows=True,
+        classes=None,
+        escape=True,
+        notebook=False,
+        border=None,
+        series_id=None,
+        render_links=False,
+        encoding=None,
+    ):
+        """
+        Render a Series as a single-column HTML table.
+        %(shared_params)s
+        bold_rows : bool, default True
+            Make the row labels bold in the output.
+        classes : str or list or tuple, default None
+            CSS class(es) to apply to the resulting html table.
+        escape : bool, default True
+            Convert the characters <, >, and & to HTML-safe sequences.
+        notebook : {True, False}, default False
+            Whether the generated HTML is for IPython Notebook.
+        border : int
+            A ``border=border`` attribute is included in the opening
+            `<table>` tag. Default ``pd.options.display.html.border``.
+        encoding : str, default "utf-8"
+            Set character encoding
+        series_id : str, optional
+            A css id is included in the opening `<table>` tag if specified.
+        render_links : bool, default False
+            Convert URLs to HTML links.
+        %(returns)s
+        See Also
+        --------
+        to_string : Convert Series to a string.
+        """
+
+        if justify is not None and justify not in fmt._VALID_JUSTIFY_PARAMETERS:
+            raise ValueError("Invalid value for justify parameter")
+
+        formatter = fmt.SeriesFormatter(
+            self,
+            col_space=col_space,
+            na_rep=na_rep,
+            formatters=formatters,
+            float_format=float_format,
+            sparsify=sparsify,
+            justify=justify,
+            index_names=index_names,
+            header=header,
+            index=index,
+            bold_rows=bold_rows,
+            escape=escape,
+            max_rows=max_rows,
+            show_dimensions=show_dimensions,
+            decimal=decimal,
+            series_id=series_id,
+            render_links=render_links,
+        )
+        return formatter.to_html(
+            buf=buf,
+            classes=classes,
+            notebook=notebook,
+            border=border,
+            encoding=encoding,
+        )
+
+
     def to_string(
         self,
         buf=None,