chore: Use dedicated sklearn directory for wrappers of sklearn functions (#693)

Closes #696

Author: thomass-dev

examples/plot_03_cross_validate.py

@@ -10,7 +10,6 @@
 ML/DS projects.
 """
 
-
 # %%
 import subprocess
 
@@ -21,8 +20,7 @@
 from sklearn import svm
 from sklearn.model_selection import cross_validate as sklearn_cross_validate
 
-from skore import load
-import skore.cross_validate
+import skore
 
 
 # %%
@@ -39,7 +37,7 @@
 
 
 # %%
-my_project_gs = load("my_project_cv.skore")
+my_project_gs = skore.load("my_project_cv.skore")
 
 # %%
 # Cross-validation in scikit-learn
@@ -61,25 +59,28 @@
 
 # %%
 X, y = datasets.load_iris(return_X_y=True)
-clf = svm.SVC(kernel='linear', C=1, random_state=0)
+clf = svm.SVC(kernel="linear", C=1, random_state=0)
 
 # %%
 # Single metric evaluation using ``cross_validate``:
 
 # %%
 cv_results = sklearn_cross_validate(clf, X, y, cv=5)
-cv_results['test_score']
+cv_results["test_score"]
 
 # %%
 # Multiple metric evaluation using ``cross_validate``:
 
 # %%
 scores = sklearn_cross_validate(
-    clf, X, y, cv=5,
-    scoring=['accuracy', 'precision_macro'],
+    clf,
+    X,
+    y,
+    cv=5,
+    scoring=["accuracy", "precision_macro"],
 )
-print(scores['test_accuracy'])
-print(scores['test_precision_macro'])
+print(scores["test_accuracy"])
+print(scores["test_precision_macro"])
 
 # %%
 # In scikit-learn, why do we recommend using ``cross_validate`` over ``cross_val_score``?

skore/src/skore/__init__.py

@@ -4,16 +4,15 @@
 
 import rich.logging
 
-from skore.cross_validate import cross_validate
 from skore.project import Project, load
-
-from .utils._show_versions import show_versions
+from skore.sklearn import cross_validate
+from skore.utils._show_versions import show_versions
 
 __all__ = [
+    "Project",
     "cross_validate",
     "load",
     "show_versions",
-    "Project",
 ]
 
 

skore/src/skore/sklearn/__init__.py

@@ -0,0 +1,7 @@
+"""Enhance `sklearn` functions."""
+
+from skore.sklearn.cross_validate import cross_validate
+
+__all__ = [
+    "cross_validate",
+]

skore/src/skore/cross_validate.py renamed to skore/src/skore/sklearn/cross_validate.py

@@ -8,7 +8,7 @@
 from sklearn.ensemble import RandomForestClassifier
 from sklearn.multiclass import OneVsOneClassifier
 from sklearn.svm import SVC
-from skore.cross_validate import cross_validate
+from skore import cross_validate
 from skore.item.cross_validation_item import (
     CrossValidationAggregationItem,
     CrossValidationItem,