{"id":3878,"library":"apify-shared","title":"Apify Shared Python","description":"The `apify-shared-python` library (current version 2.2.0) provides constants and utilities shared internally across Apify's other Python projects, such as `apify-client-python` and `apify-sdk-python`. It is not intended for direct public consumption, and its internal API is subject to change without deprecation warnings. The library maintains an active development status as it supports other core Apify libraries.","status":"active","version":"2.2.0","language":"en","source_language":"en","source_url":"https://github.com/apify/apify-shared-python","tags":["apify","utility","constants","internal"],"install":[{"cmd":"pip install apify-shared","lang":"bash","label":"Install stable version"}],"dependencies":[{"reason":"Required runtime environment.","package":"python","optional":false}],"imports":[{"note":"This is an example of importing a constant. Users are strongly advised against directly importing from `apify_shared` as it is an internal library with no stable public API.","symbol":"ActorExitCodes","correct":"from apify_shared.consts import ActorExitCodes"}],"quickstart":{"code":"from apify_shared.consts import ActorExitCodes\n\n# Accessing an internal constant (example)\nprint(f\"Actor OK exit code: {ActorExitCodes.SUCCESS}\")","lang":"python","description":"This quickstart demonstrates a minimal import from `apify-shared`. However, this library is strictly for internal Apify use. Direct consumption is discouraged, and users should typically use `apify-sdk` or `apify-client` for developing Apify Actors or interacting with the Apify API."},"warnings":[{"fix":"Use `apify-sdk` for developing Apify Actors or `apify-client` for interacting with the Apify API, which provide stable public APIs. Only use `apify-shared` if explicitly instructed by Apify for development within their ecosystem.","message":"This library is for internal use by Apify projects only. Its public API is not stable and may introduce breaking changes at any time without prior deprecation warnings. Users should avoid direct usage.","severity":"breaking","affected_versions":"All versions"},{"fix":"As advised, refrain from building applications directly on `apify-shared`. Rely on the stable APIs provided by `apify-sdk` or `apify-client` which manage their internal dependencies on `apify-shared` appropriately.","message":"There is no guaranteed backward compatibility for `apify-shared`. Functions, classes, and constants may be renamed, moved, or removed without notice, leading to unexpected errors or behavior in applications directly dependent on it.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"last_verified":"2026-04-11T00:00:00.000Z","next_check":"2026-07-10T00:00:00.000Z"}