feat(skore-mlflow-project): Add integration with MLflow (#2527)

Implements #2134

#### Initial interface proposition

#2134 (comment)
Not much has changed, as anyway, the current plugin interface
constraints the choices quite a lot (which is convenient for a first
implementation)

#### Remaining questions/TODOs:
- [X] handling of logging context: decide what do if there is already an
active run:
  - (selected behavior ✔️) crash
  - OR: log only artifacts (i.e. only plots and HTMLs) and ignore key.
  - OR: create a nested run
  - OR (initial behavior): ignore it and create a new independent run

- [x] Documentation/Examples: in PR
#2532.

#### Review guide

The diff is scary, but it mainly comes from CI things, the actual code
diff is something like +600 (excluding tests).

- `skore-mlflow-project/`: the main part of the implementation, it
mainly:
  - inspects report objects and call all the metrics/plots/...
  - logs those metrics/plots/... into MLFlow 
- @glemaitre tested this part, I think we can consider it
:heavy_check_mark:
- `skore/`: :heavy_check_mark: 
  - small changes to plug `skore.Project` with `skore-mlflow-project/`
- @thomass-dev has quickly reviewed this part, and I addressed his two
comments
- CI changes ✔️ 
- basic changes to run tests `skore-mlflow-project` => validated by
@thomass-dev
- more complex changes to cover many MLFlow versions are in a separate
PR: #2531
#### Coverage report from local coverage run:

```
Name                                      Stmts   Miss  Cover   Missing
-----------------------------------------------------------------------
src/skore_mlflow_project/__init__.py          5      0   100%
src/skore_mlflow_project/_matplotlib.py      15      0   100%
src/skore_mlflow_project/project.py         191      5    97%   200, 231-232, 377, 379
src/skore_mlflow_project/protocol.py         36      0   100%
src/skore_mlflow_project/reports.py         145      3    98%   203-204, 264
-----------------------------------------------------------------------
TOTAL                                       392      8    98%
```

---------

Co-authored-by: Auguste Baum <auguste@probabl.ai>

Author: cakedev0

.github/workflows/pr-display-code-coverage.yml

@@ -18,7 +18,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        package: ["skore", "skore-hub-project", "skore-local-project"]
+        package: ["skore", "skore-hub-project", "skore-local-project", "skore-mlflow-project"]
     permissions:
       actions: read
       contents: read

.github/workflows/pytest.yml

@@ -39,7 +39,7 @@ defaults:
     shell: bash
 
 env:
-  PACKAGES: '["skore","skore-hub-project","skore-local-project"]'
+  PACKAGES: '["skore","skore-hub-project","skore-local-project","skore-mlflow-project"]'
 
 jobs:
   pytest-changes:

.github/workflows/release.yml

@@ -32,7 +32,7 @@ jobs:
           version="${GITHUB_REF_NAME#*/}"
 
           [[ "${package}" == "${version}" ]] && { >&2 echo "Invalid tag: no package"; exit 1; }
-          [[ "${package}" =~ ^(skore|skore-(local|hub)-project)$ ]] || { >&2 echo "Invalid tag: invalid package"; exit 1; }
+          [[ "${package}" =~ ^(skore|skore-(local|hub|mlflow)-project)$ ]] || { >&2 echo "Invalid tag: invalid package"; exit 1; }
           [[ "${version}" =~ ^(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)(-rc\.(1|[1-9][0-9]*))?$ ]] || { >&2 echo "Invalid tag: invalid version"; exit 1; }
 
           echo "::group::Details"

.gitignore

@@ -198,4 +198,5 @@ sphinx/_templates/demo_report_help_generated.html
 skore/LICENSE
 skore-hub-project/LICENSE
 skore-local-project/LICENSE
+skore-mlflow-project/LICENSE
 .aider*

.pre-commit-config.yaml

@@ -20,11 +20,11 @@ repos:
     hooks:
 
       - id: ruff-check
-        files: ^((skore|skore-hub-project|skore-local-project)/(hatch|src|tests))|(examples)/
+        files: ^((skore|skore-hub-project|skore-local-project|skore-mlflow-project)/(hatch|src|tests))|(examples)/
         args: [--fix, --extend-select, I]
 
       - id: ruff-format
-        files: ^((skore|skore-hub-project|skore-local-project)/(hatch|src|tests))|(examples)/
+        files: ^((skore|skore-hub-project|skore-local-project|skore-mlflow-project)/(hatch|src|tests))|(examples)/
 
   - repo: https://github.com/pre-commit/mirrors-mypy
     rev: v1.19.1
@@ -70,3 +70,11 @@ repos:
         files: ^skore-local-project/
         args: [--config-file=skore-local-project/pyproject.toml, skore-local-project]
         additional_dependencies: [skore]
+
+      - id: mypy
+        pass_filenames: false
+        alias: mypy-skore-mlflow-project
+        name: mypy skore-mlflow-project/
+        files: ^skore-mlflow-project/
+        args: [--config-file=skore-mlflow-project/pyproject.toml, skore-mlflow-project]
+        additional_dependencies: [skore, mlflow]

README.md

@@ -60,6 +60,8 @@ Then, you can install skore by using `pip`:
 pip install -U skore
 # If you wish to interact with Skore Hub as well
 pip install -U skore[hub]
+# If you wish to log projects to MLflow
+pip install -U skore[mlflow]
 ```
 
 #### With conda

ci/pip-compile.sh

@@ -6,13 +6,13 @@
 #
 # You can pass any `uv pip compile` parameter:
 #
-#     $ bash pip-compile.sh --test-requirements <skore|skore-hub-project|skore-local-project> --upgrade
+#     $ bash pip-compile.sh --test-requirements <skore|skore-hub-project|skore-local-project|skore-mlflow-project> --upgrade
 #     $ bash pip-compile.sh --sphinx-requirements --upgrade
 #
 
 usage () {
     >&2 echo "Usage:"
-    >&2 echo "    $ bash pip-compile.sh --test-requirements <all|skore|skore-hub-project|skore-local-project> [option...]"
+    >&2 echo "    $ bash pip-compile.sh --test-requirements <all|skore|skore-hub-project|skore-local-project|skore-mlflow-project> [option...]"
     >&2 echo "    $ bash pip-compile.sh --sphinx-requirements [option...]"
 }
 
@@ -33,8 +33,9 @@ case $1 in
                 PACKAGES+=("skore")
                 PACKAGES+=("skore-hub-project")
                 PACKAGES+=("skore-local-project")
+                PACKAGES+=("skore-mlflow-project")
                 ;;
-            "skore"|"skore-hub-project"|"skore-local-project")
+            "skore"|"skore-hub-project"|"skore-local-project"|"skore-mlflow-project")
                 PACKAGES+=($2)
                 ;;
             *)

ci/requirements/skore-mlflow-project/python-3.10/.python-version

@@ -0,0 +1 @@
+3.10