{"id":28150,"library":"roastcoffea","title":"roastcoffea","description":"A performance monitoring and metrics collection library for Coffea-based High Energy Physics analysis workflows. Current version 0.1.2, actively maintained with monthly releases.","status":"active","version":"0.1.2","language":"python","source_language":"en","source_url":"https://github.com/MoAly98/roastcoffea","tags":["physics","high-energy-physics","coffea","performance-monitoring","metrics"],"install":[{"cmd":"pip install roastcoffea","lang":"bash","label":"pip install"}],"dependencies":[{"reason":"Primary dependency; roastcoffea wraps Coffea processors and events.","package":"coffea","optional":true}],"imports":[{"note":"MetricsProcessor is exposed at the package level; the old submodule path no longer works in 0.1.0+.","wrong":"from roastcoffea.processor import MetricsProcessor","symbol":"MetricsProcessor","correct":"from roastcoffea import MetricsProcessor"},{"note":"Correct import; no common mistake.","wrong":"","symbol":"setup_metrics","correct":"from roastcoffea import setup_metrics"}],"quickstart":{"code":"from coffea.processor import Runner\nfrom roastcoffea import MetricsProcessor\n\nrunner = Runner.executor(\n    executor='iterative',\n    schema='nanomaker',\n    savemetrics=True,\n    metrics={\n        'processor': MetricsProcessor.\n    }\n)","lang":"python","description":"Basic usage integrating MetricsProcessor into a Coffea Runner."},"warnings":[{"fix":"Update import to 'from roastcoffea import MetricsProcessor'.","message":"In version 0.1.0, the import path for MetricsProcessor changed from roastcoffea.processor to roastcoffea, breaking existing code using the old import.","severity":"breaking","affected_versions":"<0.1.0"},{"fix":"Access file handle via events.attrs[\"@events.factory\"].","message":"The attribute 'file_handle' on events is misspelled; use 'events.attrs[\"@events.factory\"]' instead.","severity":"deprecated","affected_versions":"0.1.1+"},{"fix":"Ensure Python version is 3.12 or 3.13.","message":"Requires Python >=3.12 and <3.14; using Python 3.11 or lower will fail to install.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Use 'from roastcoffea import MetricsProcessor'.","cause":"MetricsProcessor was moved from roastcoffea.processor to roastcoffea in version 0.1.0.","error":"ImportError: cannot import name 'MetricsProcessor' from 'roastcoffea.processor'"},{"fix":"Use events.attrs['@events.factory'] to get the file handle.","cause":"The attribute was misspelled; correct access is via events.attrs['@events.factory'].","error":"AttributeError: 'EventFile' object has no attribute 'file_handle'"},{"fix":"Upgrade/downgrade Python to version 3.12 or 3.13 and reinstall.","cause":"roastcoffea requires Python 3.12 or 3.13.","error":"RuntimeError: This environment is not supported (requires Python >=3.12 and <3.14)"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}