Protocols as code

import replicatescience as rs

# Search protocols by keyword + species
results = rs.search("fear conditioning", species="mouse")
for p in results.protocols:
    print(f"{p.slug}: {p.name} ({p.step_count} steps)")

# Compare two protocols — see exactly what differs
a = rs.get("smith-fear-conditioning-2024")
b = rs.get("jones-fear-conditioning-2023")

diff = rs.diff(a, b)
print(diff.summary)     # "8 changes across 3 sections"
print(diff.to_markdown())

# Export to YAML — version protocols like code
protocol = rs.get("smith-fear-conditioning-2024")
rs.save(protocol, "protocols/fear-conditioning.yaml")

# Compare your actual procedure against the canonical one
canonical = rs.load("protocols/fear-conditioning.yaml")
actual = rs.load("my-run-2026-03-12.yaml")
deviations = rs.diff(canonical, actual)