iris-devtester 1.8.0

Battle-tested InterSystems IRIS infrastructure utilities for Python development

IRIS DevTester

Battle-tested InterSystems IRIS infrastructure utilities for Python development

What is This?

IRIS DevTester is a comprehensive Python package that provides automatic, reliable, production-tested infrastructure for InterSystems IRIS development. It handles connectivity, container lifecycles, and test data management, codifying years of experience into a reusable toolkit.

The Problem It Solves

• ❌ Auto-Remediation: Fixes "Password change required" and expired accounts automatically.
• ❌ Port Management: Eliminates conflicts when running tests in parallel.
• ❌ Isolation: Ensures every test gets a clean, isolated database instance.
• ❌ Performance: DBAPI-first connection pooling is 3x faster than traditional JDBC.
• ❌ Data Refresh: High-speed DAT fixture loading (10-100x faster than SQL inserts).

Quick Start

1. Install

pip install iris-devtester[all]

2. Start a Container

iris-devtester container up

3. Write and Run a Test

from iris_devtester.containers import IRISContainer

def test_connection():
    with IRISContainer.community() as iris:
        conn = iris.get_connection()
        cursor = conn.cursor()
        cursor.execute("SELECT 1")
        assert cursor.fetchone()[0] == 1

Key Features

• 🔐 Automatic Password Management: Remediates security flags using official system APIs.
• 🐳 Container Lifecycle: CLI and Python API for IRIS container management (up, start, stop).
• 📦 DAT Fixture Management: Create and load reproducible test fixtures in seconds.
• ⚡ DBAPI-First Performance: Automatically selects the fastest available driver.
• 📊 Resource Monitoring: Resource-aware performance tracking.

AI-Assisted Development

This project is optimized for AI coding assistants:

• Agent Skill Manifest - Hierarchical guidance for Claude, Cursor, and Copilot.
• AGENTS.md - Common build and test commands.

Documentation

• Getting Started
• Troubleshooting Guide
• Examples
• Codified Learnings

License

MIT License - See LICENSE