feat: Convert between Excel file and Table

pyproject.toml

@@ -21,6 +21,7 @@ pillow = "^9.5.0"
 scikit-learn = "^1.2.0"
 seaborn = "^0.12.2"
 polars = {extras = ["pandas", "pyarrow", "xlsx2csv"], version = "^0.17.5"}
+openpyxl = "^3.1.2"
 
 [tool.poetry.group.dev.dependencies]
 pytest = "^7.2.1"

src/safeds/data/tabular/containers/_table.py

@@ -84,6 +84,33 @@ def from_csv_file(path: str) -> Table:
         except FileNotFoundError as exception:
             raise FileNotFoundError(f'File "{path}" does not exist') from exception
 
+    @staticmethod
+    def from_excel_file(path: str) -> Table:
+        """
+        Read data from an Excel file into a table.
+
+        Parameters
+        ----------
+        path : str
+            The path to the Excel file.
+
+        Returns
+        -------
+        table : Table
+            The table created from the Excel file.
+
+        Raises
+        ------
+        FileNotFoundError
+            If the specified file does not exist.
+        ValueError
+            If the file could not be read.
+        """
+        try:
+            return Table(pd.read_excel(path, engine="openpyxl", usecols=lambda colname: "Unnamed" not in colname))
+        except FileNotFoundError as exception:
+            raise FileNotFoundError(f'File "{path}" does not exist') from exception
+
     @staticmethod
     def from_json_file(path: str) -> Table:
         """
@@ -1141,6 +1168,23 @@ def to_csv_file(self, path: str) -> None:
         data_to_csv.columns = self._schema.column_names
         data_to_csv.to_csv(path, index=False)
 
+    def to_excel_file(self, path: str) -> None:
+        """
+        Write the data from the table into a Excel file.
+
+        If the file and/or the directories do not exist, they will be created. If the file already exists it will be
+        overwritten.
+
+        Parameters
+        ----------
+        path : str
+            The path to the output file.
+        """
+        Path(path).parent.mkdir(parents=True, exist_ok=True)
+        data_to_excel = self._data.copy()
+        data_to_excel.columns = self._schema.column_names
+        data_to_excel.to_excel(path)
+
     def to_json_file(self, path: str) -> None:
         """
         Write the data from the table into a JSON file.

tests/safeds/data/tabular/containers/_table/test_from_excel_file.py

@@ -0,0 +1,27 @@
+from pathlib import Path
+
+import openpyxl
+import pytest
+from safeds.data.tabular.containers import Table
+
+from tests.helpers import resolve_resource_path
+
+
+def test_from_excel_file_valid() -> None:
+    path = "./test.xlsx"
+    table = Table.from_dict({"A": ["1"], "B": ["2"]})
+    tmp_table_file = openpyxl.Workbook()
+    tmp_table_file.save(path)
+    try:
+        with Path(path).open("w", encoding="utf-8") as _:
+            table.to_excel_file(path)
+        table = Table.from_excel_file(path)
+        assert table.get_column("A").get_value(0) == 1
+        assert table.get_column("B").get_value(0) == 2
+    finally:
+        Path(path).unlink()
+
+
+def test_from_excel_file_invalid() -> None:
+    with pytest.raises(FileNotFoundError):
+        Table.from_excel_file(resolve_resource_path("test_table_from_excel_file_invalid.xls"))

tests/safeds/data/tabular/containers/_table/test_to_excel_file.py

@@ -0,0 +1,20 @@
+from pathlib import Path
+
+import openpyxl
+from safeds.data.tabular.containers import Table
+
+
+def test_to_excel_file() -> None:
+    table = Table.from_dict({"col1": ["col1_1"], "col2": ["col2_1"]})
+    path = "./test.xlsx"
+
+    tmp_table_file = openpyxl.Workbook()
+    tmp_table_file.save(path)
+    try:
+        with Path(path).open("w", encoding="utf-8") as _:
+            table.to_excel_file(path)
+        with Path(path).open("r", encoding="utf-8") as _:
+            table_r = Table.from_excel_file(path)
+        assert table == table_r
+    finally:
+        Path(path).unlink()