saspytest 0.1.2

pytest support library for SAS testing with saspy

saspytest

pytest support library for SAS testing with saspy.

saspytest provides utility functions and pytest-style assertions for testing SAS programs through the saspy Python interface. It is inspired by SASUnit assertion macros.

---

Features

• Session management – Shared or isolated SAS sessions with automatic setup and teardown
• Log assertions – Validate SAS logs for errors, warnings, or custom patterns
• Dataset assertions – Check dataset existence, record counts, columns, and equality
• Macro assertions – Verify SAS macro variable values and existence
• File utilities – Upload/download files and submit local .sas scripts

---

Installation

pip install saspytest

Prerequisites

• Python 3.9+
• A working saspy configuration that can connect to your SAS deployment
• Java (required by saspy for IOM connections)

Note: saspytest does not bundle proprietary SAS JARs. You must provide your own SAS deployment and configure saspy accordingly (e.g. sascfg_personal.py or environment variables).

---

Quickstart

from saspytest import (
    assert_no_errors,
    assert_dataset_exists,
    assert_record_count,
)

def test_sas_program(sas_session):
    result = sas_session.submit("""
        data test;
            do i = 1 to 5;
                output;
            end;
        run;
    """)

    assert_no_errors(result["LOG"])
    assert_dataset_exists(sas_session, "test")
    assert_record_count(sas_session, "test", 5)

---

Documentation

• Full API reference: see docs/API_REFERENCE.md
• Development guidelines: see docs/DEVELOPMENT_GUIDELINES.md

---

License

MIT License. See LICENSE for details.