Skip to content

Package pipestat Documentation

Package Overview

The pipestat package standardizes reporting of pipeline results and pipeline status management. It provides a formal way for pipeline developers and downstream tools to communicate pipeline outputs and status.

Key Features

  • Results Reporting: Standardized API for reporting pipeline results
  • Status Management: Track pipeline execution status
  • Backend Flexibility: Store results in YAML files or databases
  • Schema Validation: Validate results against defined schemas
  • Multi-pipeline Support: Manage results from multiple pipelines

Installation

pip install pipestat

Quick Example

from pipestat import SamplePipestatManager

# Initialize with a schema and results file
psm = SamplePipestatManager(
    schema_path="output_schema.yaml",
    results_file_path="results.yaml"
)

# Report a result
psm.report(record_identifier="sample1", values={"result_name": 42})

API Reference

SamplePipestatManager Class

The main class for managing sample-level pipeline results:

SamplePipestatManager

SamplePipestatManager(**kwargs)

Bases: PipestatManager

Source code in pipestat/pipestat.py
1166
1167
1168
def __init__(self, **kwargs):
    PipestatManager.__init__(self, pipeline_type="sample", **kwargs)
    _LOGGER.warning("Initialize PipestatMgrSample")

ProjectPipestatManager Class

ProjectPipestatManager

ProjectPipestatManager(**kwargs)

Bases: PipestatManager

Source code in pipestat/pipestat.py
1172
1173
1174
def __init__(self, **kwargs):
    PipestatManager.__init__(self, pipeline_type="project", **kwargs)
    _LOGGER.warning("Initialize PipestatMgrProject")

Exceptions

PipestatError

Bases: Exception

Base exception type for this package