feat: allow rendering of tables to LaTeX

great_tables/_export.py

@@ -166,6 +166,30 @@
     return html_table
 
 
+def as_latex(self: GT) -> str:
+    """
+    Output a GT object as LaTeX
+
+    Get the LaTeX content from a GT object as a string.
+
+    Parameters
+    ----------
+    gt
+        A GT object.
+
+    Returns
+    -------
+    str
+        An LaTeX fragment containing a table.
+
+    """
+    built_table = self._build_data(context="latex")
+
+    latex_table = built_table._render_as_latex()
+
+    return latex_table
+
+
 # Create a list of all selenium webdrivers
 WebDrivers: TypeAlias = Literal[
     "chrome",

great_tables/_gt_data.py

@@ -1185,6 +1185,8 @@ class Options:
     # page_footer_height: OptionsInfo = OptionsInfo(False, "page", "value", "0.5in")
     quarto_disable_processing: OptionsInfo = OptionsInfo(False, "quarto", "logical", False)
     quarto_use_bootstrap: OptionsInfo = OptionsInfo(False, "quarto", "logical", False)
+    latex_use_longtable: OptionsInfo = OptionsInfo(False, "latex", "boolean", False)
+    latex_tbl_pos: OptionsInfo = OptionsInfo(False, "latex", "value", "!t")
 
     def _get_all_options_keys(self) -> list[str | None]:
         return [x.parameter for x in self._options.values()]

great_tables/_options.py

@@ -164,6 +164,8 @@ def tab_options(
     row_striping_background_color: str | None = None,
     row_striping_include_stub: bool | None = None,
     row_striping_include_table_body: bool | None = None,
+    latex_use_longtable: bool | None = None,
+    latex_tbl_pos: str | None = None,
 ) -> GTSelf:
     """
     Modify the table output options.
@@ -473,6 +475,13 @@ def tab_options(
         An option for whether to include the stub when striping rows.
     row_striping_include_table_body
         An option for whether to include the table body when striping rows.
+    latex_use_longtable
+        An option to use the `longtable` environment in LaTeX output. This is useful for tables that
+        span multiple pages.
+    latex_tbl_pos
+        The position of the table in the LaTeX output. The default value is `"!t"` which means that
+        the table is placed at the top of the page. Other valid values are `"!b"` (bottom of the
+        page), `"!h"` (here), `"!p"` (on a separate page), and `"!H"` (exactly here).
 
     Returns
     -------