ton-devtools-pytest

pytest plugin for declarative ICP integration testing.

Part of the ton-devtools monorepo.

What it does

Auto-registered pytest plugin that hides all ICP authentication boilerplate behind declarative fixtures:

• icp_harness — generates wallets, signs proofs, issues JWTs in one call
• icp_strict_mode — enforces TRMC security policies, fails on violations
• MockWallet — real ed25519 keypair, produces valid TON Connect 2.0 proofs

Installation

pip install ton-devtools-pytest

The plugin registers automatically via the pytest11 entry point. No conftest.py configuration required.

Quick Start

from ton_devtools_pytest.asserts import assert_authenticated

async def test_profile_read(icp_harness):
    user = icp_harness.create_mock_user(roles=["user"])
    resp = await icp_harness.client.get("/me/profile")
    assert resp.status_code == 200

async def test_high_risk_blocked(icp_strict_mode):
    user = icp_strict_mode.create_mock_user(risk_score="high")
    resp = await icp_strict_mode.client.post("/proposals", json={...})
    icp_strict_mode.assert_no_high_risk_pass(resp)

CLI options

pytest --icp-base-url=http://localhost:8000 --icp-jwt-secret=your-secret

Or via environment variables: ICP_BASE_URL, ICP_JWT_SECRET.

License

MIT