feat: Modify the user API of skore to respect "what you put is what you get" principle

[thomass-dev]

Closes #1045
Closes #734

Refactor the user API to hide all notions of Item, View, and to respect "what you put is what you get" from a user's point of view.
Among others:

• Hide item classes in sub-directory to be less visible by users
• All @cached_property in items have been removed, because items are not used anymore directly by users
• Remove the ability to store anything other than strings in MediaItem
• Explode MediaItem in new item classes
• Add PickleItem class which can persist any object when it cannot be otherwise
• Add display_as parameter to project.put to control how a string is displayed in the frontend
• Remove project.put_item in such way user need only to use project.put
• The project.get function always returns what the user has put
• The project.get and project.get_item_versions have been merged
• The CrossValidationItem has been replaced by a CrossValidationReporterItem based on pickle
  • To go fast, and because a report is composed of complex objects, such as estimator, X and y, i've made the choice to persist the report as a pickle. That way, we can get a report from the persistency without effort. In a next iteration, we should think about how to persist more efficiencly and env-independently a report which can be rebuilt entirely from the persistency.

---

• hide item API
  • hide put_item
  • hide get_item
  • change get_item_versions to be item agnostic
  • change the constructor of the Project to hide repositories -> postponed feat: Refine the constructor of Project to be user-friendly #1160
• update each item classes to return their original objects
  • cross validation reporter
  • pillow image
  • plotly figure
  •  altair figure
  • matplotlib figure
  • media item, to only accept str with display_as
  • primitive -> already 🆗
  • pandas dataframe -> already 🆗
  • polars dataframe -> already 🆗
  • pandas series -> already 🆗
  • polars series -> already 🆗
  • numpy array -> already 🆗
  •  scikit-learn estimator -> already 🆗
• set note in each factory
• update put to allow the new parameter display_as
• hide view API
• move repr_html to reporters -> feat: Move (or remove) the repr feature of Item class #1161
• change the way numpy array are serialized -> postponed feat: Change the way NumPy array are persisted #1159

[glemaitre]

I think that this PR will also close:

• DOC difference between get and get_item #734

@thomass-dev I let you amend your summary if it is the case.

[github-actions]

Coverage Report for backend

File	Stmts	Miss	Cover	Missing
venv/lib/python3.12/site-packages/skore
__init__.py	14	0	100%
__main__.py	8	1	80%	19
exceptions.py	3	0	100%
venv/lib/python3.12/site-packages/skore/cli
__init__.py	5	0	100%
cli.py	33	3	85%	104, 111, 117
color_format.py	43	3	90%	35–>40, 41–43
launch_dashboard.py	26	15	39%	36–57
quickstart_command.py	14	7	50%	37–51
venv/lib/python3.12/site-packages/skore/persistence
__init__.py	0	0	100%
venv/lib/python3.12/site-packages/skore/persistence/item
__init__.py	59	4	91%	89, 100–103
altair_chart_item.py	24	1	93%	14
cross_validation_reporter_item.py	105	12	88%	28–41, 125–126, 254, 257
item.py	41	13	68%	90, 93, 97–117
matplotlib_figure_item.py	30	1	94%	18
media_item.py	24	0	100%
numpy_array_item.py	22	1	92%	14
pandas_dataframe_item.py	31	1	94%	14
pandas_series_item.py	31	1	94%	14
pickle_item.py	29	0	100%
pillow_image_item.py	29	1	94%	14
plotly_figure_item.py	25	1	93%	14
polars_dataframe_item.py	29	1	94%	14
polars_series_item.py	24	1	93%	14
primitive_item.py	25	2	91%	13–15
sklearn_base_estimator_item.py	28	1	94%	14
skrub_table_report_item.py	10	1	86%	11
venv/lib/python3.12/site-packages/skore/persistence/repository
__init__.py	3	0	100%
item_repository.py	59	5	91%	15–16, 202–203, 226
view_repository.py	19	3	81%	9–10, 76
venv/lib/python3.12/site-packages/skore/persistence/storage
__init__.py	4	0	100%
abstract_storage.py	22	0	100%
disk_cache_storage.py	33	1	95%	44
in_memory_storage.py	20	0	100%
venv/lib/python3.12/site-packages/skore/persistence/view
__init__.py	0	0	100%
view.py	5	0	100%
venv/lib/python3.12/site-packages/skore/project
__init__.py	3	0	100%
create.py	52	8	88%	116–122, 132–133, 140–141
load.py	22	3	88%	45–47
open.py	14	0	100%
project.py	39	2	94%	12, 159
venv/lib/python3.12/site-packages/skore/sklearn
__init__.py	5	0	100%
_base.py	140	4	97%	91, 94, 168–>173, 183–184
find_ml_task.py	45	1	95%	71–>87, 80–>87, 86
types.py	2	0	100%
venv/lib/python3.12/site-packages/skore/sklearn/_cross_validation
__init__.py	6	0	100%
metrics_accessor.py	163	0	100%
report.py	87	0	100%
venv/lib/python3.12/site-packages/skore/sklearn/_estimator
__init__.py	6	0	100%
metrics_accessor.py	265	4	97%	149–158, 183–>236, 191, 434–>437, 783–>786
report.py	121	0	99%	216–>222, 224–>226
utils.py	11	11	0%	1–19
venv/lib/python3.12/site-packages/skore/sklearn/_plot
__init__.py	4	0	100%
precision_recall_curve.py	121	1	98%	229–>246, 317
prediction_error.py	97	0	100%
roc_curve.py	128	0	100%
utils.py	88	0	100%
venv/lib/python3.12/site-packages/skore/sklearn/cross_validation
__init__.py	2	0	100%
cross_validation_helpers.py	47	4	90%	104–>136, 123–126
cross_validation_reporter.py	35	1	95%	177
venv/lib/python3.12/site-packages/skore/sklearn/cross_validation/plots
__init__.py	0	0	100%
compare_scores_plot.py	29	24	16%	10, 28–116
timing_plot.py	29	24	17%	10, 26–123
venv/lib/python3.12/site-packages/skore/sklearn/train_test_split
__init__.py	0	0	100%
train_test_split.py	36	2	94%	16–17
venv/lib/python3.12/site-packages/skore/sklearn/train_test_split/warning
__init__.py	8	0	100%
high_class_imbalance_too_few_examples_warning.py	17	3	78%	16–18, 80
high_class_imbalance_warning.py	18	2	88%	16–18
random_state_unset_warning.py	11	1	87%	15
shuffle_true_warning.py	9	0	91%	44–>exit
stratify_is_set_warning.py	11	1	87%	15
time_based_column_warning.py	22	1	89%	17, 69–>exit
train_test_split_warning.py	5	1	80%	21
venv/lib/python3.12/site-packages/skore/ui
__init__.py	0	0	100%
app.py	32	8	68%	26, 55–60, 72–74
dependencies.py	7	1	86%	12
project_routes.py	61	0	100%
venv/lib/python3.12/site-packages/skore/utils
__init__.py	0	0	100%
_accessor.py	7	0	100%
_logger.py	21	4	84%	14–18
_patch.py	11	5	46%	19–35
_progress_bar.py	28	0	100%
_show_versions.py	31	0	100%
TOTAL	2773	196	92%

Tests	Skipped	Failures	Errors	Time
609	3 💤	0 ❌	0 🔥	3m 24s ⏱️

[MarieS-WiMLDS]

I'm really happy with what I tested so far :D.
I have to go, I'll do further tests on monday, but so far so good!!

I have 2 questions, not blocking:

• did you think of a way to fetch a version "in the middle"? The lastest parameter in get is a bit weak imo, maybe version, like in set_note, could be better.
• why did you choose to ask for capital strings in display_as? it feels a bit weird to me, i'd prefer lower case.

[thomass-dev]

@glemaitre

@thomass-dev I don't see put and get in the api.rst. Maybe we could add these two functions there?

Fixed 087fcaf .

[augustebaum]

Awesome work!

[auguste-probabl]

The Project docstring needs to be updated

[glemaitre]

Approved upon the point that we discussed earlier.

[thomass-dev]

The Project docstring needs to be updated

Fixed in e465440.

[MarieS-WiMLDS]

youhou!