intersystems-community/iris-agentic-dev/iris-devtester

from iris_devtester import IRISContainer
# Community — default, auto-detects ARM64 vs x86
with IRISContainer.community() as iris:
    conn = iris.get_connection()
# Light — CI/CD, 580MB, no web server
with IRISContainer.light() as iris: ...
# Enterprise — needs IRIS_LICENSE_KEY env var or license_key= kwarg
with IRISContainer.enterprise(license_key="~/iris.key") as iris: ...
# Health — irishealth-community + FHIR R4 pre-installed (see irishealth-container skill)
with IRISContainer.health() as iris:
    h = iris.fhir_health_check()
# AI Hub — %AI.Agent, VECTOR SQL, ISC internal registry (see irishealth-container skill)
with IRISContainer.ai_hub(build="159") as iris: ...
# Attach — reconnect to existing container (e.g. started by idt container up)
iris = IRISContainer.attach("container-name")
conn = iris.get_connection()

idt test-connection --auto-fix          # detect + reset + retry
idt container reset-password <name> --timeout 30

from iris_devtester.utils import reset_password_if_needed
reset_password_if_needed(e, container_name="iris_db", username="_SYSTEM")

IRISContainer.community().__enter__()
  → start()
    → with_cpf_merge(SECURE_DEFAULTS)  # ChangePassword=0 via ISC_CPF_MERGE_FILE
    → super().start()                  # IRIS reads CPF, opens port 1972
    → _password_handled = True
 
iris.get_connection()
  → enable_callin_service()            # docker exec once
  → get_connection(config)             # iris.connect() — optimistic
  → on ChangePassword error:
      unexpire_all_passwords()         # fallback, once
      retry iris.connect()

from iris_devtester import probe_connection, ContainerHealth, ConnectionProbe
# Inspect connection state (schemas, IRIS version, latency)
result = probe_connection(conn)
print(result.report())
# Health check from container (includes schema visibility)
health = iris.health_check()
print(health.tables_visible)   # False if schema not seeded
print(health.report())

from iris_devtester import (
    IRISContainer,
    get_connection,
    probe_connection,
    ContainerHealth,
    ConnectionProbe,
    ConnectionDiagnosticError,
    IRISConfig,
)

def test_example(iris_db):           # function-scoped, fresh container
def test_example(iris_db_shared):    # module-scoped, shared container
def test_example(iris_container):    # raw IRISContainer access

idt container up --port 11972          # exact port mapping
idt container up --auto-port           # auto-assign from 1972-2000
idt container exec iris_db --objectscript "Write $ZVERSION"
idt container reset-password iris_db --timeout 30
idt test-connection --container iris_db --auto-fix -v
idt fixture load --name my-data