Skip to content

livery-extensions-ty

ty as a step of the workshop: typecheck.ty type-checks the python packages' sources on every platform at once. A workspace turns it on by listing the extension:

[workspace]
extensions = ["ty"]

fm typecheck then runs it, and fm check runs it with the rest of the gate. A run checks what the configuration includes whatever the run reaches: a run costs seconds, and the configuration pins the platforms. fm typecheck.ty -- --output-format concise hands ty check the words after --.

The configuration

fm sync writes the root ty.toml, and a bare ty in the repository reads the same file the step does. It includes each python member's src directory, or tasks.py in a workspace without one, checks every platform at the python version the workspace supports, and reads the tool stubs in typings/.

The file is the extension's: an edit outside its region is drift, which fm check --fix puts back. The repository's own tables go inside the region at the end:

# -- workshop: region tables, yours to edit; the render keeps it --
[rules]
possibly-unresolved-reference = "warn"
# -- workshop: end tables --

A workspace that lists the extension recommends ty's editor extension, astral-sh.ty, in .vscode/extensions.json.