[ENH] Simplified Unified Get/List API

[Omswastik-11]

Redundant syntax for getters

In getters, syntax is repeated and redundant, mainly through
the submodule having to be imported or addressed.

import openml

# List all datasets and their properties
openml.datasets.list_datasets(output_format="dataframe")

# Get dataset by ID
dataset = openml.datasets.get_dataset(61)

# Get dataset by name
dataset = openml.datasets.get_dataset('Fashion-MNIST')

# This is similar for flows, runs, studies, such as

study = openml.studies.get_study(42)
flow = openml.flows.get_flows(42)

API implementation

import openml

# List all datasets
datasets_df = openml.list_all("dataset", output_format="dataframe")

# Get dataset by ID
dataset = openml.get("dataset", 61)

# Get dataset by name
dataset = openml.get("dataset", "Fashion-MNIST")

# Get task
task = openml.get("task", 31)

# Get flow
flow = openml.get("flow", 10)

# Get run
run = openml.get("run", 20)

# Shortcut: infer dataset from name when no type specified
dataset = openml.get("Fashion-MNIST")

Implementation Details

• Added openml.list_all(object_type: str, **kwargs) -> Any, a dispatcher that forwards to:

  • list_datasets
  • list_tasks
  • list_flows
  • list_runs

• Added openml.get(object_type_or_name, identifier=None, **kwargs) -> Any, a unified getter with support for:

  • Type-based lookup

    openml.get("dataset", 61)
    openml.get("dataset", "dataset_name")

  • Name-only shortcut for datasets

    openml.get("Fashion-MNIST")

• Exported both functions via __all__ and documented them with docstrings.

• Preserved full backward compatibility:

  • Existing submodule APIs (e.g., openml.datasets.get_dataset) remain unchanged.

• Added unit tests to validate dispatcher behavior without requiring network access.

[codecov-commenter]

Codecov Report

❌ Patch coverage is 33.33333% with 14 lines in your changes missing coverage. Please review.
✅ Project coverage is 64.11%. Comparing base (3380bbb) to head (dbb13b5).
⚠️ Report is 162 commits behind head on main.

Files with missing lines	Patch %	Lines
openml/__init__.py	33.33%	14 Missing ⚠️

❗ There is a different number of reports uploaded between BASE (3380bbb) and HEAD (dbb13b5). Click for more details.

HEAD has 1 upload less than BASE

Flag	BASE (3380bbb)	HEAD (dbb13b5)
	2	1

Additional details and impacted files

@@             Coverage Diff             @@
##             main    #1552       +/-   ##
===========================================
- Coverage   85.24%   64.11%   -21.14%     
===========================================
  Files          38       36        -2     
  Lines        5008     4372      -636     
===========================================
- Hits         4269     2803     -1466     
- Misses        739     1569      +830     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.