opera-eco 0.4.5__tar.gz

opera_eco-0.4.5/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bank of England
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

opera_eco-0.4.5/PKG-INFO

@@ -0,0 +1,140 @@
+Metadata-Version: 2.4
+Name: opera-eco
+Version: 0.4.5
+Summary: Dependency and skill manager for the OPERA ecosystem
+Author-email: Paul Labonne <Paul.Labonne@bankofengland.co.uk>, Diego Lopez <Diego.Lopez@bankofengland.co.uk>
+Maintainer-email: Paul Labonne <Paul.Labonne@bankofengland.co.uk>
+License-Expression: MIT
+Project-URL: Documentation, https://bank-of-england.github.io/opera-eco/
+Project-URL: Repository, https://github.com/bank-of-england/opera-eco
+Project-URL: Issues, https://github.com/bank-of-england/opera-eco/issues
+Keywords: time-series,forecasting,evaluation,backtesting,economics
+Classifier: Development Status :: 4 - Beta
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: pandas
+Provides-Extra: modules
+Requires-Dist: forecast_evaluation==0.1.13; extra == "modules"
+Requires-Dist: forecast_realtime[models]==0.5.4; extra == "modules"
+Requires-Dist: forecast_combo==0.1.1; extra == "modules"
+Requires-Dist: bvar==0.3.1; extra == "modules"
+Requires-Dist: nowcast-midas==0.0.1; extra == "modules"
+Requires-Dist: news_decomp==0.0.7; extra == "modules"
+Provides-Extra: test
+Requires-Dist: opera-eco[modules]; extra == "test"
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-xdist; extra == "test"
+Requires-Dist: pytest-timeout; extra == "test"
+Requires-Dist: pandera; extra == "test"
+Requires-Dist: syrupy; extra == "test"
+Provides-Extra: notebooks
+Requires-Dist: marimo==0.24.0; extra == "notebooks"
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: packaging; extra == "dev"
+Requires-Dist: pre-commit; extra == "dev"
+Requires-Dist: pydoclint; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocstrings[python]; extra == "docs"
+Requires-Dist: zensical; extra == "docs"
+Dynamic: license-file
+
+# OPERA: Open-Source Prediction Evaluation and Real-Time Analysis
+
+**[Documentation](https://bank-of-england.github.io/opera-eco/)**
+
+OPERA is a modular ecosystem aimed at streamlining forecasting tasks for economists and fostering open collaboration. Model logic - estimation, forecasting, forecast decomposition - is separated from the real-time workflow, making it easier to compare models in replicable environments and leverage open source contributions. The ecosystem is currently composed of seven blocks which cover the full pipeline from raw data to evaluation. Its architecture, interfaces and design principles reflect the specific constraints of macro analysis: data revision, ragged edge, mixed-frequency, conditional projections, uncertainty quantification, narrative accounting and nested models. By making these modules open-source, OPERA provides a platform for central bankers, academics and other forecasters to share infrastructure and collaborate.
+
+
+---
+
+## Architecture
+
+![Forecasting Ecosystem Architecture](docs/diagram.svg)
+
+---
+
+## Modules
+
+| Module | Package | Role |
+|---|---|---|
+| Model Libraries | `bvar`, `nowcast-midas` | Bayesian VARs; mixed-data sampling and SC-MIDAS combinations |
+| Forecast Evaluation | `forecast_evaluation` | Validate data, evaluate accuracy, run statistical tests, visualise |
+| Real-time Forecasting | `forecast_realtime` | Fit and forecast wrappers, backtesting, simulation, stress-testing, R/MATLAB/Julia adapters |
+| Forecast Combination | `forecast_combo` | Inverse-error, regression and hierarchical combination |
+| News Decomposition | `news_decomp` | Nowcast decomposition into level and revision; news/reestimation/interaction |
+
+Install all ecosystem packages with `pip install "opera-eco[modules]"`.
+
+## Authors
+
+The package authors listed in each repository's `pyproject.toml` are:
+
+| Package | Authors |
+|---|---|
+| `opera-eco` | Paul Labonne; Diego Lopez |
+| `forecast_evaluation` | James Hurley; Paul Labonne; Harry Li |
+| `forecast_realtime` | Paul Labonne; Sumer Singh; Harry Li; Nades Raviraj |
+| `bvar` | Paul Labonne; Andrea Renzetti; Joseph Oyegoke |
+| `nowcast-midas` | James Kensett; Paul Labonne; Andre Moreira |
+| `forecast_combo` | Filippo Busetto; Paul Labonne; James McConachie; Roshni Tara |
+| `news_decomp` | Guido Bonatti; Kensley Blaise; Paul Labonne; Nades Raviraj |
+
+---
+
+## Quick Start
+
+```bash
+pip install opera-eco              # Install the CLI and skills only.
+pip install "opera-eco[modules]"  # Install the CLI and all ecosystem packages.
+pip install "opera-eco[notebooks]" # Install Marimo notebook tooling.
+opera install skills               # Install AI skills in .claude/skills/.
+```
+
+Then ask Copilot or Claude to use an installed skill:
+
+```text
+Tell me about @opera and how I can use it with my model.
+```
+
+## OPERA Skills for Claude and Copilot
+
+The package includes seven skills for AI coding assistants:
+
+| Skill | Description |
+|---|---|
+| **opera** | Meta-skill covering the full ecosystem: architecture, modules, data flows, conventions, integration patterns |
+| **forecast-evaluation** | Data validation, accuracy metrics, statistical tests, visualisations, dashboards |
+| **forecast-realtime** | Real-time forecasting, backtesting, model wrapping, external language models (R, MATLAB, Julia) |
+| **bvar** | Bayesian VARs, conditional forecasting with hard/soft/skewed constraints, GIRFs |
+| **nowcast-midas** | MIDAS regressions, MultiMIDAS, SC-MIDAS combinations, monthly-to-quarterly nowcasting |
+| **forecast-combo** | Forecast combination methods, hierarchical pooling, weight analysis |
+| **forecast-decomp** | Nowcast decomposition: levels and revisions, news, reestimation, interaction, and New York Fed-style analysis |
+
+## Project Layout
+
+```
+docs/                            # Documentation site.
+examples/illustration.py        # Runnable end-to-end example.
+examples/illustration_marimo.py # Native Marimo version of the example.
+src/opera/                      # Package source, bundled skills, and tests.
+  cli.py                        # Command-line interface.
+  skills_manager.py             # Skill discovery and installation.
+  skills/                       # Bundled Markdown skill files.
+pyproject.toml                  # Python package configuration.
+zensical.toml                   # Documentation site configuration.
+```
+
+## Data Classification
+Bank of England Data Classification: OFFICIAL BLUE

opera_eco-0.4.5/README.md

@@ -0,0 +1,88 @@
+# OPERA: Open-Source Prediction Evaluation and Real-Time Analysis
+
+**[Documentation](https://bank-of-england.github.io/opera-eco/)**
+
+OPERA is a modular ecosystem aimed at streamlining forecasting tasks for economists and fostering open collaboration. Model logic - estimation, forecasting, forecast decomposition - is separated from the real-time workflow, making it easier to compare models in replicable environments and leverage open source contributions. The ecosystem is currently composed of seven blocks which cover the full pipeline from raw data to evaluation. Its architecture, interfaces and design principles reflect the specific constraints of macro analysis: data revision, ragged edge, mixed-frequency, conditional projections, uncertainty quantification, narrative accounting and nested models. By making these modules open-source, OPERA provides a platform for central bankers, academics and other forecasters to share infrastructure and collaborate.
+
+
+---
+
+## Architecture
+
+![Forecasting Ecosystem Architecture](docs/diagram.svg)
+
+---
+
+## Modules
+
+| Module | Package | Role |
+|---|---|---|
+| Model Libraries | `bvar`, `nowcast-midas` | Bayesian VARs; mixed-data sampling and SC-MIDAS combinations |
+| Forecast Evaluation | `forecast_evaluation` | Validate data, evaluate accuracy, run statistical tests, visualise |
+| Real-time Forecasting | `forecast_realtime` | Fit and forecast wrappers, backtesting, simulation, stress-testing, R/MATLAB/Julia adapters |
+| Forecast Combination | `forecast_combo` | Inverse-error, regression and hierarchical combination |
+| News Decomposition | `news_decomp` | Nowcast decomposition into level and revision; news/reestimation/interaction |
+
+Install all ecosystem packages with `pip install "opera-eco[modules]"`.
+
+## Authors
+
+The package authors listed in each repository's `pyproject.toml` are:
+
+| Package | Authors |
+|---|---|
+| `opera-eco` | Paul Labonne; Diego Lopez |
+| `forecast_evaluation` | James Hurley; Paul Labonne; Harry Li |
+| `forecast_realtime` | Paul Labonne; Sumer Singh; Harry Li; Nades Raviraj |
+| `bvar` | Paul Labonne; Andrea Renzetti; Joseph Oyegoke |
+| `nowcast-midas` | James Kensett; Paul Labonne; Andre Moreira |
+| `forecast_combo` | Filippo Busetto; Paul Labonne; James McConachie; Roshni Tara |
+| `news_decomp` | Guido Bonatti; Kensley Blaise; Paul Labonne; Nades Raviraj |
+
+---
+
+## Quick Start
+
+```bash
+pip install opera-eco              # Install the CLI and skills only.
+pip install "opera-eco[modules]"  # Install the CLI and all ecosystem packages.
+pip install "opera-eco[notebooks]" # Install Marimo notebook tooling.
+opera install skills               # Install AI skills in .claude/skills/.
+```
+
+Then ask Copilot or Claude to use an installed skill:
+
+```text
+Tell me about @opera and how I can use it with my model.
+```
+
+## OPERA Skills for Claude and Copilot
+
+The package includes seven skills for AI coding assistants:
+
+| Skill | Description |
+|---|---|
+| **opera** | Meta-skill covering the full ecosystem: architecture, modules, data flows, conventions, integration patterns |
+| **forecast-evaluation** | Data validation, accuracy metrics, statistical tests, visualisations, dashboards |
+| **forecast-realtime** | Real-time forecasting, backtesting, model wrapping, external language models (R, MATLAB, Julia) |
+| **bvar** | Bayesian VARs, conditional forecasting with hard/soft/skewed constraints, GIRFs |
+| **nowcast-midas** | MIDAS regressions, MultiMIDAS, SC-MIDAS combinations, monthly-to-quarterly nowcasting |
+| **forecast-combo** | Forecast combination methods, hierarchical pooling, weight analysis |
+| **forecast-decomp** | Nowcast decomposition: levels and revisions, news, reestimation, interaction, and New York Fed-style analysis |
+
+## Project Layout
+
+```
+docs/                            # Documentation site.
+examples/illustration.py        # Runnable end-to-end example.
+examples/illustration_marimo.py # Native Marimo version of the example.
+src/opera/                      # Package source, bundled skills, and tests.
+  cli.py                        # Command-line interface.
+  skills_manager.py             # Skill discovery and installation.
+  skills/                       # Bundled Markdown skill files.
+pyproject.toml                  # Python package configuration.
+zensical.toml                   # Documentation site configuration.
+```
+
+## Data Classification
+Bank of England Data Classification: OFFICIAL BLUE

opera_eco-0.4.5/pyproject.toml

@@ -0,0 +1,103 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "opera-eco"
+version = "0.4.5"
+description = "Dependency and skill manager for the OPERA ecosystem"
+readme = "README.md"
+requires-python = ">=3.11"
+authors = [
+    {name="Paul Labonne", email="Paul.Labonne@bankofengland.co.uk"},
+    {name="Diego Lopez", email="Diego.Lopez@bankofengland.co.uk"},
+]
+
+maintainers = [
+    {name="Paul Labonne", email="Paul.Labonne@bankofengland.co.uk"},
+]
+
+license = "MIT"
+keywords = ["time-series", "forecasting", "evaluation", "backtesting", "economics"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Scientific/Engineering",
+]
+
+dependencies = [
+    "numpy",
+    "pandas",
+]
+
+[project.urls]
+Documentation = "https://bank-of-england.github.io/opera-eco/"
+Repository = "https://github.com/bank-of-england/opera-eco"
+Issues = "https://github.com/bank-of-england/opera-eco/issues"
+
+# Integration manifest containing the pinned ecosystem versions.
+# Update these pins only after the contract and pipeline suites pass.
+[project.optional-dependencies]
+modules = [
+    "forecast_evaluation == 0.1.13",
+    "forecast_realtime[models]==0.5.4",
+    "forecast_combo==0.1.1",
+    "bvar==0.3.1",
+    "nowcast-midas==0.0.1",
+    "news_decomp==0.0.7",
+]
+
+test = [
+    "opera-eco[modules]",
+    "pytest",
+    "pytest-xdist",
+    "pytest-timeout",
+    "pandera",
+    "syrupy",
+]
+
+notebooks = [
+    "marimo==0.24.0",
+]
+
+dev = [
+    "build",
+    "packaging",
+    "pre-commit",
+    "pydoclint",
+    "ruff",
+    "twine",
+]
+
+docs = [
+    "mkdocstrings[python]",
+    "zensical",
+]
+
+[project.scripts]
+opera = "opera.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+"opera.skills" = ["*.md"]
+"opera.tests" = ["**/*.py", "**/__snapshots__/*.ambr"]
+
+[tool.pytest.ini_options]
+testpaths = ["src/opera/tests"]
+markers = [
+    "contract: shared-schema and interface contract tests (fast)",
+    "skill_snippet: isolated executable skill documentation snippets",
+    "pipeline: cross-module end-to-end tests (slow)",
+    "bvar: pipeline tests exercising the BVAR model",
+    "midas: pipeline tests exercising the MIDAS-family models (MIDAS, MultiMIDAS, SC-MIDAS)",
+    "news: pipeline tests exercising the news/decomposition pipeline",
+    "mixed_freq: pipeline tests exercising the real-time mixed-frequency pipeline",
+    "ecosystem: pipeline tests exercising the full OPERA ecosystem illustration",
+]

opera_eco-0.4.5/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

opera_eco-0.4.5/src/opera/__init__.py

@@ -0,0 +1,8 @@
+"""OPERA — Open-source Prediction, Evaluation and Real-time Analysis.
+
+Ecosystem CLI and skill manager for the Bank of England forecasting platform.
+"""
+
+__version__ = "0.4.4"
+
+__all__ = ["__version__"]

opera_eco-0.4.5/src/opera/cli.py

@@ -0,0 +1,174 @@
+"""Manage OPERA skills from the command line.
+
+Usage
+-----
+::
+
+    opera install skills [--target DIR] [--only name1,name2]
+    opera list   skills
+    opera show   skill <name>
+"""
+
+from __future__ import annotations
+
+import argparse
+import sys
+import textwrap
+
+from opera import __version__
+
+# Subcommands
+
+
+def _cmd_install_skills(args: argparse.Namespace) -> None:
+    """Install the selected bundled skills into the requested directory.
+
+    The parsed arguments provide the destination and an optional comma-separated
+    list of skill names. The command reports each skill after installation.
+    """
+    from opera.skills_manager import SKILL_FILES, install_skills
+
+    skills = None
+    if args.only:
+        skills = [s.strip() for s in args.only.split(",")]
+
+    target = install_skills(target=args.target, skills=skills)
+
+    installed = skills or list(SKILL_FILES)
+    print(f"Installed {len(installed)} skill(s) to {target}")
+    for name in installed:
+        print(f"  - {name}")
+
+
+def _cmd_list_skills(_args: argparse.Namespace) -> None:
+    """Print a table of bundled skills, files, and descriptions."""
+    from opera.skills_manager import list_skills
+
+    skills = list_skills()
+    header = f"{'Name':<25} {'File':<30} Description"
+    sep = f"{'-' * 25} {'-' * 30} {'-' * 50}"
+    print(header)
+    print(sep)
+    for s in skills:
+        desc = textwrap.shorten(s["description"], width=50, placeholder="…")
+        print(f"{s['name']:<25} {s['filename']:<30} {desc}")
+
+
+def _cmd_show_skill(args: argparse.Namespace) -> None:
+    """Write the named bundled skill to standard output as UTF-8 text.
+
+    An unknown skill name is reported on standard output and causes the command
+    to exit with status 1.
+    """
+    from opera.skills_manager import show_skill
+
+    try:
+        text = show_skill(args.name)
+        sys.stdout.buffer.write(text.encode("utf-8", errors="replace"))
+        sys.stdout.buffer.write(b"\n")
+    except KeyError as exc:
+        print(str(exc))
+        sys.exit(1)
+
+
+def _cmd_sync_api(_args: argparse.Namespace) -> None:
+    """Synchronise generated API sections in the bundled skill files.
+
+    The command reports changed files, or confirms that the generated sections
+    are current. Synchronisation errors are written to standard error and cause
+    the command to exit with status 1.
+    """
+    from opera.skill_api import sync_api_sections
+
+    try:
+        changed = sync_api_sections()
+    except Exception as exc:
+        print(f"opera skills sync-api: {exc}", file=sys.stderr)
+        raise SystemExit(1) from exc
+    for path in changed:
+        print(f"Updated {path}")
+    if not changed:
+        print("Skill API sections are current.")
+
+
+# Argument parser
+
+
+def build_parser() -> argparse.ArgumentParser:
+    """Build and return the parser for all OPERA CLI commands.
+
+    The parser registers skill installation, listing, display, and API
+    synchronisation commands and attaches each command's handler.
+    """
+    parser = argparse.ArgumentParser(
+        prog="opera",
+        description="OPERA ecosystem CLI — manage skills and dependencies.",
+    )
+    parser.add_argument(
+        "-V", "--version", action="version", version=f"%(prog)s {__version__}"
+    )
+
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    # Install skills or dependencies.
+    install_parser = sub.add_parser("install", help="Install skills or dependencies")
+    install_sub = install_parser.add_subparsers(dest="install_target", required=True)
+
+    # Install skills.
+    install_skills_parser = install_sub.add_parser(
+        "skills", help="Copy OPERA skill files to a target directory"
+    )
+    install_skills_parser.add_argument(
+        "--target",
+        default=None,
+        help="Destination directory (default: .claude/skills or .github/skills)",
+    )
+    install_skills_parser.add_argument(
+        "--only",
+        default=None,
+        help="Comma-separated list of skill names to install (default: all)",
+    )
+    install_skills_parser.set_defaults(func=_cmd_install_skills)
+
+    # Synchronise generated API sections in the repository checkout.
+    skills_command_parser = sub.add_parser(
+        "skills", help="Maintain bundled skill resources"
+    )
+    skills_sub = skills_command_parser.add_subparsers(
+        dest="skills_command", required=True
+    )
+    sync_api_parser = skills_sub.add_parser(
+        "sync-api", help="Update generated skill API sections"
+    )
+    sync_api_parser.set_defaults(func=_cmd_sync_api)
+
+    # List available resources.
+    list_parser = sub.add_parser("list", help="List available resources")
+    list_sub = list_parser.add_subparsers(dest="list_target", required=True)
+
+    list_skills_parser = list_sub.add_parser("skills", help="List bundled skills")
+    list_skills_parser.set_defaults(func=_cmd_list_skills)
+
+    # Show a resource.
+    show_parser = sub.add_parser("show", help="Show a resource")
+    show_sub = show_parser.add_subparsers(dest="show_target", required=True)
+
+    show_skill_parser = show_sub.add_parser("skill", help="Print a skill file")
+    show_skill_parser.add_argument("name", help="Skill short-name (e.g. opera, bvar)")
+    show_skill_parser.set_defaults(func=_cmd_show_skill)
+
+    return parser
+
+
+def main(argv: list[str] | None = None) -> None:
+    """Parse arguments and dispatch to the selected OPERA CLI command.
+
+    When ``argv`` is omitted, arguments are read from the process command line.
+    """
+    parser = build_parser()
+    args = parser.parse_args(argv)
+    args.func(args)
+
+
+if __name__ == "__main__":
+    main()