Merge remote-tracking branch 'upstream/hotfixes' into release

Author: fit-alessandro-berti

docs/source/api.rst

@@ -28,6 +28,8 @@ Importing object-centric event logs is possible given the following formats:
 
 Importing object-centric event logs (OCEL2.0) is possible given the following formats:
 
+  * bundled ``.ocel.zip`` CSV/Parquet specification :meth:`pm4py.read.read_ocel2_bundle`
+  * compact ``.csv`` specification :meth:`pm4py.read.read_ocel2_csv`
   * ``.xmlocel`` specification :meth:`pm4py.read.read_ocel2_xml`
   * ``.sqlite`` specification :meth:`pm4py.read.read_ocel2_sqlite`
   * ``.jsonocel`` specification :meth:`pm4py.read.read_ocel2_json`
@@ -52,6 +54,8 @@ Exporting object-centric event logs is possible to the following formats:
 
 Exporting object-centric event logs (OCEL2.0) is possible to the following formats:
 
+  * bundled ``.ocel.zip`` CSV/Parquet specification :meth:`pm4py.write.write_ocel2_bundle`
+  * compact ``.csv`` specification :meth:`pm4py.write.write_ocel2_csv`
   * ``.xmlocel`` specification :meth:`pm4py.write.write_ocel2_xml`
   * ``.sqlite`` specification :meth:`pm4py.write.write_ocel2_sqlite`
   * ``.jsonocel`` specification :meth:`pm4py.write.write_ocel2_json`
@@ -429,6 +433,8 @@ List of Methods
    pm4py.read.read_ocel_json
    pm4py.read.read_ocel_xml
    pm4py.read.read_ocel_sqlite
+   pm4py.read.read_ocel2_bundle
+   pm4py.read.read_ocel2_csv
    pm4py.read.read_ocel2_xml
    pm4py.read.read_ocel2_sqlite
    pm4py.read.read_ocel2_json
@@ -442,6 +448,8 @@ List of Methods
    pm4py.write.write_ocel_json
    pm4py.write.write_ocel_xml
    pm4py.write.write_ocel_sqlite
+   pm4py.write.write_ocel2_bundle
+   pm4py.write.write_ocel2_csv
    pm4py.write.write_ocel2_xml
    pm4py.write.write_ocel2_sqlite
    pm4py.write.write_ocel2_json

pm4py/__init__.py

@@ -59,6 +59,7 @@
     read_ocel_json,
     read_ocel_sqlite,
     read_ocel2,
+    read_ocel2_bundle,
     read_ocel2_csv,
     read_ocel2_sqlite,
     read_ocel2_json,
@@ -76,6 +77,7 @@
     write_ocel_xml,
     write_ocel_sqlite,
     write_ocel2,
+    write_ocel2_bundle,
     write_ocel2_csv,
     write_ocel2_sqlite,
     write_ocel2_xml,

pm4py/objects/ocel/exporter/__init__.py

@@ -1,25 +1,4 @@
-'''
-PM4Py – A Process Mining Library for Python
-Copyright (C) 2026 Process Intelligence Solutions GmbH
-
-This program is free software: you can redistribute it and/or modify
-it under the terms of the GNU Affero General Public License as
-published by the Free Software Foundation, either version 3 of the
-License, or any later version.
-
-This program is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU Affero General Public License for more details.
-
-You should have received a copy of the GNU Affero General Public License
-along with this program.  If not, see this software project's root or
-visit <https://www.gnu.org/licenses/>.
-
-Website: https://processintelligence.solutions
-Contact: info@processintelligence.solutions
-'''
-from pm4py.objects.ocel.exporter import util, csv, jsonocel
+from pm4py.objects.ocel.exporter import bundled, util, csv, jsonocel
 import importlib.util
 
 if importlib.util.find_spec("lxml"):

pm4py/objects/ocel/exporter/bundled/__init__.py

@@ -0,0 +1 @@
+from pm4py.objects.ocel.exporter.bundled import exporter, variants

pm4py/objects/ocel/exporter/bundled/exporter.py

@@ -0,0 +1,24 @@
+from enum import Enum
+from typing import Optional, Dict, Any
+
+from pm4py.objects.ocel.exporter.bundled.variants import ocel20
+from pm4py.objects.ocel.obj import OCEL
+from pm4py.util import exec_utils
+
+
+class Variants(Enum):
+    OCEL20 = ocel20
+
+
+def apply(
+    ocel: OCEL,
+    target_path: str,
+    variant=Variants.OCEL20,
+    parameters: Optional[Dict[Any, Any]] = None,
+):
+    """
+    Exports an OCEL 2.0 log to the bundled CSV/Parquet format.
+    """
+    return exec_utils.get_variant(variant).apply(
+        ocel, target_path, parameters=parameters
+    )

pm4py/objects/ocel/exporter/bundled/variants/__init__.py

@@ -0,0 +1 @@
+from pm4py.objects.ocel.exporter.bundled.variants import ocel20