{"record":{"id":"0b45442af0cdac1c","repo":"apache/beam","slug":"please-run-python-m-apache-beam-yaml-generate-yaml-docs","errorCode":null,"errorMessage":"\"Please run python -m apache_beam.yaml.generate_yaml_docs --schema_file='{transform_schemas_path}' to run with transform-specific validation.\"","messagePattern":"\"Please run python -m apache_beam\\.yaml\\.generate_yaml_docs --schema_file='(.+?)' to run with transform-specific validation\\.\"","errorType":"exception","errorClass":"RuntimeError","httpStatus":null,"severity":"error","filePath":"sdks/python/apache_beam/yaml/yaml_transform.py","lineNumber":67,"sourceCode":"\n_LOGGER = logging.getLogger(__name__)\nyaml_provider.fix_pycallable()\n\ntry:\n  import jsonschema\nexcept ImportError:\n  jsonschema = None\n\n\n@functools.lru_cache\ndef pipeline_schema(strictness):\n  with open(yaml_utils.locate_data_file('pipeline.schema.yaml')) as yaml_file:\n    pipeline_schema = yaml.safe_load(yaml_file)\n  if strictness == 'per_transform':\n    transform_schemas_path = yaml_utils.locate_data_file(\n        'transforms.schema.yaml')\n    if not os.path.exists(transform_schemas_path):\n      raise RuntimeError(\n          \"Please run \"\n          \"python -m apache_beam.yaml.generate_yaml_docs \"\n          f\"--schema_file='{transform_schemas_path}' \"\n          \"to run with transform-specific validation.\")\n    with open(transform_schemas_path) as fin:\n      pipeline_schema['$defs']['transform']['allOf'].extend(yaml.safe_load(fin))\n  return pipeline_schema\n\n\ndef _closest_line(o, path):\n  best_line = SafeLineLoader.get_line(o)\n  for step in path:\n    o = o[step]\n    maybe_line = SafeLineLoader.get_line(o)\n    if maybe_line != 'unknown':\n      best_line = maybe_line\n  return best_line\n","sourceCodeStart":49,"sourceCodeEnd":85,"githubUrl":"https://github.com/apache/beam/blob/12126d8942aaf848030c478b4c6a28c6af861c66/sdks/python/apache_beam/yaml/yaml_transform.py#L49-L85","documentation":"Raised by the cached pipeline_schema helper when strictness is 'per_transform' but the generated transforms.schema.yaml file does not exist next to pipeline.schema.yaml. That file is produced by a code-generation step, not shipped; the error tells the user to run the generate_yaml_docs module with --schema_file pointing at the located path. The input at fault is the environment/checkout state, not user pipeline code.","triggerScenarios":"Thrown at sdks/python/apache_beam/yaml/yaml_transform.py:67 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Run: python -m apache_beam.yaml.generate_yaml_docs --schema_file=<the path printed in the error> to generate the missing schema","Use a different strictness level (e.g. 'basic') that does not require the per-transform schema"],"exampleFix":null,"handlingStrategy":"fallback","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"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"}