Shorten split helper function import path

.github/workflows/api-docs.yml

@@ -53,6 +53,7 @@ jobs:
         with:
           repository: khiopsml/khiops-python-tutorial
           path: doc/khiops-python-tutorial
+          ref: shorten-helpers-path
       - name: Add pip scripts directory to path
         run: echo PATH="$PATH:/github/home/.local/bin" >> "$GITHUB_ENV"
       - name: Install doc build requirements

doc/create-doc

@@ -79,6 +79,7 @@ fi
 
 # Convert tutorials to reST
 tutorials_dir="./tutorials"
+tutorials_dir="$(realpath $tutorials_dir)"
 mkdir -p "$tutorials_dir"
 if [[ $TRANSFORM_NOTEBOOKS ]]
 then
@@ -100,8 +101,8 @@ python create-coursework.py
 cd coursework
 mkdir -p exercises
 touch exercises/.dummy # Create a dummy so the "exercises" directory is created on unzip
-zip "../../$tutorials_dir/core_tutorials.zip" Core*.ipynb data/*/* exercises/.dummy
-zip "../../$tutorials_dir/sklearn_tutorials.zip" Sklearn*.ipynb data/*/* exercises/.dummy
+zip "$tutorials_dir/core_tutorials.zip" Core*.ipynb data/*/* exercises/.dummy
+zip "$tutorials_dir/sklearn_tutorials.zip" Sklearn*.ipynb data/*/* exercises/.dummy
 cd "../.."
 
 # Create the documentation with Sphinx

doc/internal/index.rst

@@ -3,7 +3,7 @@ Internals
 These are internal modules with no "data science" functionality. Their documentation is available
 for completeness.
 
-.. currentmodule:: khiops.utils
+.. currentmodule:: khiops.sklearn
 .. autosummary::
   :nosignatures:
   :toctree: generated

doc/samples/samples_sklearn.rst

@@ -155,8 +155,7 @@ Samples
     import os
     import pandas as pd
     from khiops import core as kh
-    from khiops.sklearn import KhiopsClassifier
-    from khiops.utils.helpers import train_test_split_dataset
+    from khiops.sklearn import KhiopsClassifier, train_test_split_dataset
     from sklearn import metrics
 
     # Load the dataset into pandas dataframes
@@ -211,8 +210,7 @@ Samples
     import os
     import pandas as pd
     from khiops import core as kh
-    from khiops.sklearn import KhiopsClassifier
-    from khiops.utils.helpers import train_test_split_dataset
+    from khiops.sklearn import KhiopsClassifier, train_test_split_dataset
     from sklearn import metrics
 
     # Load the dataset tables into dataframes

doc/tools/index.rst

@@ -7,5 +7,4 @@ These are auxiliary tools for the Khiops Python library.
   :toctree: generated
   :nosignatures:
 
-  utils.helpers
   tools

khiops/samples/samples_sklearn.ipynb

@@ -167,8 +167,7 @@
     "import os\n",
     "import pandas as pd\n",
     "from khiops import core as kh\n",
-    "from khiops.sklearn import KhiopsClassifier\n",
-    "from khiops.utils.helpers import train_test_split_dataset\n",
+    "from khiops.sklearn import KhiopsClassifier, train_test_split_dataset\n",
     "from sklearn import metrics\n",
     "\n",
     "# Load the dataset into pandas dataframes\n",
@@ -236,8 +235,7 @@
     "import os\n",
     "import pandas as pd\n",
     "from khiops import core as kh\n",
-    "from khiops.sklearn import KhiopsClassifier\n",
-    "from khiops.utils.helpers import train_test_split_dataset\n",
+    "from khiops.sklearn import KhiopsClassifier, train_test_split_dataset\n",
     "from sklearn import metrics\n",
     "\n",
     "# Load the dataset tables into dataframes\n",

khiops/samples/samples_sklearn.py

@@ -148,8 +148,7 @@ def khiops_classifier_multitable_star():
     import os
     import pandas as pd
     from khiops import core as kh
-    from khiops.sklearn import KhiopsClassifier
-    from khiops.utils.helpers import train_test_split_dataset
+    from khiops.sklearn import KhiopsClassifier, train_test_split_dataset
     from sklearn import metrics
 
     # Load the dataset into pandas dataframes
@@ -207,8 +206,7 @@ def khiops_classifier_multitable_snowflake():
     import os
     import pandas as pd
     from khiops import core as kh
-    from khiops.sklearn import KhiopsClassifier
-    from khiops.utils.helpers import train_test_split_dataset
+    from khiops.sklearn import KhiopsClassifier, train_test_split_dataset
     from sklearn import metrics
 
     # Load the dataset tables into dataframes

khiops/sklearn/__init__.py

@@ -11,3 +11,4 @@
     KhiopsEncoder,
     KhiopsRegressor,
 )
+from khiops.sklearn.helpers import train_test_split_dataset

khiops/sklearn/estimators.py

@@ -50,7 +50,7 @@
     is_list_like,
     type_error_message,
 )
-from khiops.utils.dataset import (
+from khiops.sklearn.dataset import (
     Dataset,
     FileTable,
     get_khiops_variable_name,

khiops/utils/helpers.py → khiops/sklearn/helpers.py

@@ -5,7 +5,7 @@
 from sklearn.model_selection import train_test_split
 
 from khiops.core.internals.common import is_dict_like, type_error_message
-from khiops.utils.dataset import Dataset, FileTable
+from khiops.sklearn.dataset import Dataset, FileTable
 
 # Note: We build the splits with lists and itertools.chain avoid pylint warning about
 # unbalanced-tuple-unpacking. See issue https://github.com/pylint-dev/pylint/issues/5671

tests/test_dataset_class.py

@@ -17,7 +17,7 @@
 from pandas.testing import assert_frame_equal
 from sklearn import datasets
 
-from khiops.utils.dataset import Dataset
+from khiops.sklearn.dataset import Dataset
 
 
 class DatasetInputOutputConsistencyTests(unittest.TestCase):

tests/test_dataset_errors.py

@@ -14,7 +14,7 @@
 import pandas as pd
 
 from khiops.core.internals.common import type_error_message
-from khiops.utils.dataset import Dataset, FileTable, PandasTable
+from khiops.sklearn.dataset import Dataset, FileTable, PandasTable
 
 
 # Disable PEP8 variable names because of scikit-learn X,y conventions

tests/test_helper_functions.py

@@ -16,7 +16,7 @@
 
 from khiops.core.dictionary import DictionaryDomain
 from khiops.core.helpers import build_multi_table_dictionary_domain, visualize_report
-from khiops.utils.helpers import train_test_split_dataset
+from khiops.sklearn.helpers import train_test_split_dataset
 
 
 class KhiopsHelperFunctions(unittest.TestCase):