saspytest 0.1.3

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.11+
• 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).

---

Testing

• Unit tests, no live SAS required: pytest -c pytest.unit.ini
• Integration tests, live SAS required: pytest tests/integration/ -v

The unit-test config disables the saspytest plugin so pytest does not try to open a SAS session during local mock-based runs.

---

Quickstart

When saspytest is installed, pytest auto-loads the package's fixture plugin, so the sas_session fixture is available in your tests without importing it.

from saspytest import (
    assert_no_errors,
    assert_dataset_exists,
    assert_record_count,
)

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

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

---

Documentation

• User Guide – How to use saspytest: session management, assertions, file utilities, and examples
• API Reference – Complete function and fixture reference
• Development Setup – Getting started as a contributor
• Development Guidelines – Code style and conventions

---

License

MIT License. See LICENSE for details.