tryke 0.0.29

Tryke - A Python testing tool

Tryke

Highlights

• Fast Rust-powered test discovery
• Concurrent tests by default
• Pretty, per-assertion diagnostics
• Soft assertions (like pytest-check)
• Native async support — no plugin
• Watch mode
• Changed mode (like pytest-picked)
• Client/server mode for fast editor integrations
• Fixtures with setup / teardown and typed Depends() injection
• Parametrized tests via @test.cases
• Grouping with describe() blocks
• skip, skip_if, xfail, and todo markers
• In-source testing
• Support for doctests
• Filtering and marks
• Reporters — text, dot, json, junit, llm, nextest-style, and pytest-sugar-style

Getting started

For more information, see the documentation.

Write a test.

from typing import Annotated

import tryke as t


@t.fixture(per="scope")
def database():
    db = {}
    yield db
    db.clear()


with t.describe("users"):

    @t.fixture
    def users(database: Annotated[dict[str, dict[str, str]], t.Depends(database)]):
        database["users"] = {}

        return database["users"]

    with t.describe("get"):

        @t.test("returns a stored user")
        async def test_get(users: Annotated[dict[str, str], t.Depends(users)]):
            users["alice"] = "[e-mail]"

            t.expect(users["alice"], name="returns stored email").to_equal(
                "[e-mail]"
            )

    with t.describe("set"):

        @t.test("stores a new user")
        async def test_set(users: Annotated[dict[str, str], t.Depends(users)]):
            users["bob"] = "[e-mail]"

            t.expect(users["bob"], name="stores email under user key").to_equal(
                "[e-mail]"
            )

Run the tests:

uvx tryke test # run once
uvx tryke # watch mode

Coming from pytest?

The migration guide has a side-by-side cheat sheet and a copy-paste LLM prompt.

License

This repository is licensed under the MIT License.