{"id":1978,"library":"dagster-shared","title":"Dagster Shared Utilities","description":"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.","status":"active","version":"1.12.22","language":"en","source_language":"en","source_url":"https://github.com/dagster-io/dagster/tree/master/python_modules/libraries/dagster-shared","tags":["dagster","etl","orchestration","internal-utility"],"install":[{"cmd":"pip install dagster-shared","lang":"bash","label":"Install dagster-shared"}],"dependencies":[],"imports":[{"note":"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.","wrong":"from dagster_shared.some_module import AnyDagsterSymbol","symbol":"AnyDagsterSymbol","correct":"from dagster import AnyDagsterSymbol"}],"quickstart":{"code":"from dagster import Definitions, asset\n\n@asset\ndef my_first_asset():\n    return 123\n\ndefs = Definitions(assets=[my_first_asset])\n\n# To run this, you would typically use the `dagster` CLI, e.g., `dagster dev`\n# and load the Definitions from a Python file or module.\n# dagster-shared itself does not have a direct user-facing quickstart as it's an internal utility.","lang":"python","description":"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`."},"warnings":[{"fix":"Always prefer importing Dagster-related symbols directly from the top-level `dagster` package (e.g., `from dagster import ...`) instead of `dagster_shared`.","message":"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.","severity":"gotcha","affected_versions":"All versions"},{"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.","message":"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.","severity":"breaking","affected_versions":"All versions"}],"env_vars":null,"last_verified":"2026-04-09T00:00:00.000Z","next_check":"2026-07-08T00:00:00.000Z"}