prisma-flowchart

prisma-flowchart is the PyPI distribution for the Python library that generates PRISMA 2020 flow diagrams from the existing PRISMA template CSV or from Python objects.

The current R implementation remains in PRISMA2020-main/, and this package reimplements the core public-library workflow in Python:

• load the PRISMA template CSV
• validate and normalize the data
• render an interactive HTML or SVG diagram
• export static PNG or PDF assets
• automate the same workflow from a CLI

Install

pip install prisma-flowchart

Quickstart

from prisma_flow_diagram import load_prisma_csv, render_prisma

data = load_prisma_csv("PRISMA.csv")
diagram = render_prisma(data, interactive=True, previous=False, other=True)
diagram.save("prisma.html")
diagram.save("prisma.svg")
diagram.save("prisma.png")

CLI

prisma-flow render PRISMA.csv prisma.html --interactive --no-previous

Python Import

The distribution name is prisma-flowchart, but the import package remains:

import prisma_flow_diagram

Included Template

from prisma_flow_diagram import get_template_csv_path

template_path = get_template_csv_path()

Scope

Version 0.1.0 intentionally targets the core workflow:

• CSV ingestion compatible with the shipped PRISMA template
• programmatic construction through FlowData
• interactive HTML/SVG output with links and tooltips
• static SVG/PNG/PDF export

The following are intentionally deferred:

• Shiny-equivalent web UI
• ZIP, PS, or WEBP export parity
• deprecated R compatibility aliases
• every style knob exposed by the R package

Release Automation

Trusted Publisher workflows are included for both TestPyPI and PyPI:

• .github/workflows/publish-testpypi.yml
• .github/workflows/publish-pypi.yml

The exact setup steps are documented in docs/publishing.md.