list_runs()

Python package: neptune-fetcher

Returns a list of runs in a project.

This function targets all runs in the project.

Related

• list_experiments()
• List project contents via API

Parameters

runs

str | list[str] | Filter

required

A filter specifying which runs to include:

• a regex that the run ID must match, or
• a list of specific run IDs, or
• a Filter object.

context

Context

optional

default: None

Which project and API token to use for the fetching operation. Useful for switching projects.

Examples

List all runs in a project:

from neptune_fetcher.alpha import runs


runs.list_runs()

Search a different project than the current global context and list only runs whose ID match a certain regex pattern:

my_secondary_project = npt.get_context().with_project("team-beta/project-y")

runs.list_runs(
    runs=r"kittiwake_02.*25$",
    context=my_secondary_project,
)

Output

['onerous-kittiwake_0287625', 'spurious-kittiwake_025c425']