Dagster Shared Utilities

1.12.22 · active · verified Thu Apr 09

dagster-shared is an internal utility library providing common code, constants, and data structures shared between the core `dagster` package and other `dagster-` prefixed libraries (e.g., `dagster-dg-core`). It is not intended for direct use by end-users. The current version is 1.12.22, and it typically releases weekly or bi-weekly, synchronized with `dagster` core releases.

Warnings

gotcha Direct imports from `dagster_shared` are generally discouraged. This library provides internal utilities and its API is not considered stable for public consumption. Symbols you might expect to find here are usually re-exported through the main `dagster` package.
Fix: Always prefer importing Dagster-related symbols directly from the top-level `dagster` package (e.g., `from dagster import ...`) instead of `dagster_shared`.
breaking As an internal library, `dagster-shared` does not guarantee API stability for direct users. Breaking changes may occur without specific deprecation cycles or warnings in minor releases if you are importing directly from it.
Fix: Avoid direct imports from `dagster_shared`. Rely on the stable APIs provided by `dagster` and other user-facing `dagster-*` libraries. If a specific utility is needed, check if it's available via a stable `dagster` import path.

Install

pip install dagster-shared Install dagster-shared

Imports

AnyDagsterSymbol
```
from dagster import AnyDagsterSymbol
```
Most symbols intended for user consumption, even if originating in `dagster-shared`, are re-exported through the main `dagster` package. Direct imports from `dagster_shared` are discouraged as its internal API is not stable or guaranteed for public use.

Quickstart

dagster-shared is an internal dependency and does not offer a direct quickstart for end-users. User code should typically interact with the `dagster` library directly. This example shows a basic Dagster asset definition, which internally leverages components from `dagster-shared`.

from dagster import Definitions, asset

@asset
def my_first_asset():
    return 123

defs = Definitions(assets=[my_first_asset])

# To run this, you would typically use the `dagster` CLI, e.g., `dagster dev`
# and load the Definitions from a Python file or module.
# dagster-shared itself does not have a direct user-facing quickstart as it's an internal utility.

view raw JSON →