{"record":{"id":"3902c3e6500c69ef","repo":"apache/beam","slug":"this-version-of-apache-beam-has-not-been-sufficiently-tested","errorCode":null,"errorMessage":"This version of Apache Beam has not been sufficiently tested on Python %s.%s. You may encounter bugs or missing features.","messagePattern":"This version of Apache Beam has not been sufficiently tested on Python (.+?)\\.(.+?)\\. You may encounter bugs or missing features\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"sdks/python/apache_beam/__init__.py","lineNumber":74,"sourceCode":"  :class:`beam.Pipeline <apache_beam.pipeline.Pipeline>`\n* Text read/write transforms are available as\n  :class:`beam.io.ReadFromText <apache_beam.io.textio.ReadFromText>`,\n  :class:`beam.io.WriteToText <apache_beam.io.textio.WriteToText>`.\n\nExamples\n--------\nThe `examples subdirectory\n<https://github.com/apache/beam/tree/master/sdks/python/apache_beam/examples>`_\nhas some examples.\n\n\"\"\"\n\nimport sys\nimport warnings\n\nif sys.version_info.major == 3:\n  if sys.version_info.minor <= 9 or sys.version_info.minor >= 15:\n    warnings.warn(\n        'This version of Apache Beam has not been sufficiently tested on '\n        'Python %s.%s. You may encounter bugs or missing features.' %\n        (sys.version_info.major, sys.version_info.minor))\n  pass\nelse:\n  raise RuntimeError(\n      'The Apache Beam SDK for Python is only supported on Python 3. '\n      'It is not supported on Python [' + str(sys.version_info) + '].')\n\n# pylint: disable=wrong-import-position\nimport apache_beam.internal.pickler\nfrom apache_beam import coders\nfrom apache_beam import io\nfrom apache_beam import metrics\nfrom apache_beam import typehints\nfrom apache_beam import version\nfrom apache_beam.pipeline import *\nfrom apache_beam.pvalue import PCollection","sourceCodeStart":56,"sourceCodeEnd":92,"githubUrl":"https://github.com/apache/beam/blob/12126d8942aaf848030c478b4c6a28c6af861c66/sdks/python/apache_beam/__init__.py#L56-L92","documentation":"On import, apache_beam/__init__.py emits a UserWarning when the running interpreter is Python 3.9 or earlier, or 3.15 or later — versions outside the officially tested support window. The pipeline still runs but features/behavior may be broken. Python 2 raises RuntimeError instead.","triggerScenarios":"import apache_beam with sys.version_info.minor <= 9 or >= 15 (e.g. Python 3.9 EOL interpreters or brand-new 3.15 betas).","commonSituations":"Running Beam on an OS default Python that lags or leads supported versions; CI images with outdated Python; trying a just-released Python version before Beam supports it.","solutions":["Upgrade (or downgrade) to a supported Python version, e.g. 3.10–3.14.","Create a virtualenv/conda env pinned to a supported interpreter: `python3.12 -m venv env`.","Pin python_version in CI/requirements tooling (pyenv, tox, setup.py classifiers).","If you must proceed on an unsupported version, test thoroughly — the warning is non-fatal."],"exampleFix":"# before (3.9 default)\n$ python -m pip install apache-beam\n# after\n$ python3.12 -m venv env && source env/bin/activate\n$ pip install apache-beam","handlingStrategy":"validation","validationCode":"import sys\nmin_major, min_minor, max_minor = 3, 10, 14\nif not (min_minor <= sys.version_info.minor <= max_minor and sys.version_info.major == 3):\n    raise SystemExit(f\"Use Python 3.{min_minor}-{max_minor}; found {sys.version}\")","typeGuard":"def is_supported_python() -> bool:\n  import sys\n  return sys.version_info[:2] in [(3,10),(3,11),(3,12),(3,13),(3,14)]","tryCatchPattern":null,"preventionTips":["Pin the interpreter via pyenv/tox/.python-version in every project.","Check the Beam supported-versions table before upgrading Python.","Use virtualenvs so the system Python version never leaks in.","Run the pipeline on the same interpreter version in CI as in production."],"tags":["python","version-compatibility","beam","environment"],"backgroundTag":"unsupported-platform","analyzedSha":"12126d8942aaf848030c478b4c6a28c6af861c66","analyzedAt":"2026-09-13T01:50:10.254Z","contentChangedAt":"2026-09-13T01:50:10.254Z","schemaVersion":2},"datasetVersion":"2026-09-20T03:17:13.778Z"}