Repository navigation
Releases
0.0.104
Release Notes
Released on 2026-11-13.
Bug fixes
- Narrow class objects in equality and membership checks (#30393)
- Preserve literals outside a protocol when simplifying unions (#30398)
- Respect implicit
__hash__ = Nonewhen a class defines__eq__(#30145)
LSP server
- Fix completion after an alias in a parenthesized import (#30394)
- Suppress completions while typing multiline import aliases (#30397)
Contributors
Install ty 0.0.104
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ty/releases/download/0.0.104/ty-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ty/releases/download/0.0.104/ty-installer.ps1 | iex"Download ty 0.0.104
Verifying GitHub Artifact Attestations
The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:
gh attestation verify <file-path of downloaded artifact> --repo astral-sh/tyYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>0.0.103
Release Notes
Released on 2026-11-13.
Bug fixes
- Avoid spurious syntax warnings when applying fixes (#30404)
- Fix a panic checking class decorators with inferred return types (#30399)
- Infer nested classes as read-only attributes (#29346)
- Infer value types for bare
FinalandClassVar(#30293) - Preserve excluded types when inferring type variable upper bounds (#30237)
- Preserve inherited value types on repeated bare ClassVar annotations (#30396)
- Respect return constraints when promoting literal arguments (#30153)
LSP server
- Resolve pytest fixtures registered through pytest_plugins (#29588)
Contributors
Install ty 0.0.103
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ty/releases/download/0.0.103/ty-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ty/releases/download/0.0.103/ty-installer.ps1 | iex"Download ty 0.0.103
Verifying GitHub Artifact Attestations
The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:
gh attestation verify <file-path of downloaded artifact> --repo astral-sh/tyYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>0.0.102
Release Notes
Released on 2026-11-12.
Breaking changes
- Split
invalid-return-typeinto 3 focussed rules; renameempty-bodyandunsound-return(#29947)
Bug fixes
- Avoid runaway inference for nested calls with union parameters (#30220)
- Fix a panic when simplifying recursive wide unions (#30141)
- Fix a stack overflow when inferring calls that return recursive aliases (#30149)
- Keep callable-local type variables out of enclosing constraints (#30241)
- Preserve Self for unary operators on bounded type variables (#30242)
- Preserve descriptor write contracts in overrides and protocols (#30252)
Diagnostic improvements
- Rename
call-abstract-methodtoabstract-method-call(#30287) - Rename
call-non-callabletonot-callable(#30284) - Rename
call-top-callabletocall-to-function-with-unknown-signature(#30285) - Rename
dataclass-field-ordertoinvalid-dataclass-field-order(#30289) - Rename
implicit-concatenated-string-type-annotationtoimplicit-string-concatenation-in-annotation; improve documentation (#30286) - Warn by default for a single overload (#30214)
Memory usage improvements
- Check unused stub parameters in the surrounding inference (#30251)
Other changes
- Cache alias-preserving binary unions (#30094)
- Share use-def layouts for stub function parameters (#30248)
- Skip unused parameter bindings in stub bodies (#30330)
Contributors
Install ty 0.0.102
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ty/releases/download/0.0.102/ty-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ty/releases/download/0.0.102/ty-installer.ps1 | iex"Download ty 0.0.102
Verifying GitHub Artifact Attestations
The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:
gh attestation verify <file-path of downloaded artifact> --repo astral-sh/tyYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>0.0.101
Release Notes
Released on 2026-11-11.
Bug fixes
- Avoid a panic on unions of recursive named tuples (#30222)
- Avoid repeatedly normalizing nested partials (#30234)
- Preserve Pydantic strictness through PEP 695 type aliases (#30210)
- Preserve the element type when passing tuple as a callback (#30152)
- Record exception checkpoints for nested unpacking targets (#30206)
LSP server
- Fall back to a workspace-wide watch when file watcher registration fails (#30120)
Other changes
- Do not narrow
Field[..]specializations to expanded unions (#30264)
Contributors
Install ty 0.0.101
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ty/releases/download/0.0.101/ty-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ty/releases/download/0.0.101/ty-installer.ps1 | iex"Download ty 0.0.101
Verifying GitHub Artifact Attestations
The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:
gh attestation verify <file-path of downloaded artifact> --repo astral-sh/tyYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>0.0.100
Release Notes
Released on 2026-11-09.
Breaking changes
- Distinguish attributes missing from some union members (#29944)
- Give abstract class instantiation its own diagnostic rule (#29948)
- Separate missing and inconsistent overload implementation diagnostics (#29953)
- Split
invalid-keyinto three TypedDict diagnostic rules (#29955) - Split out
lost-keyword-for-regular-parameterfromincompatible-method-override(#30143)
Bug fixes
- Fix partial application of ParamSpec decorators (#30150)
- Offer inlay hint edits only for valid annotation targets (#30208)
- Preserve distinct bytes keys during narrowing (#30207)
Diagnostic improvements
- Explain why a rule was removed in configuration and ignore comments (#30128)
- Rename incompatible override rules (#30142)
Memory usage improvements
- Avoid caching bundled stub source during parsing (#30181)
- Defer formatting details for suppressed diagnostics (#30169)
Other changes
- Avoid repeated scans when merging class MROs (#30095)
- Cache context-free specialized alias values (#30099)
- Cache raw signatures for overload declarations (#30106)
- Cache the previous declaration in an overload set (#30110)
- Check constraint equivalence by searching for counterexamples (#30093)
- Collect namespace members once per metaclass (#30165)
- Index lazy enclosing snapshots by symbol name (#30088)
- Reduce redundant work in structural recursive type inference (#29975)
- Reject incompatible fixed tuple contexts as elements are inferred (#30183)
- Reuse the incoming flow after boolean expressions without assignments (#30097)
- Skip repeated type constraints for collection literals (#30089)
- Skip union checks for incomparable types (#30102)
Contributors
Install ty 0.0.100
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ty/releases/download/0.0.100/ty-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ty/releases/download/0.0.100/ty-installer.ps1 | iex"Download ty 0.0.100
Verifying GitHub Artifact Attestations
The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:
gh attestation verify <file-path of downloaded artifact> --repo astral-sh/tyYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>0.0.99
Release Notes
Released on 2026-11-06.
Bug fixes
- Handle output errors when generating shell completions (#29997)
- Invalidate aliased conditions across loop iterations (#30074)
LSP server
- Add support for
workspace/willRenameFilesLSP request (#28330)
Other changes
- Bound comparisons of wide builtin literal unions (#30052)
- Fix call argument validation for variadic parameters (#30086)
- Freshen method typevars before owner specialization (#29543)
- Inform call specializations compatibility through type context (#29932)
- Keep source place IDs out of the use-def map (#30077)
- Preserve type structure during typevar freshening (#29803)
- Preserve typevars when mapping leaves their bounds unchanged (#29547)
- Preserve unions inferred during fixpoint iteration (#29927)
- Record lexical place IDs with their uses (#29956)
- Skip existing release artifacts when retrying mirror uploads (#4937)
- Skip fixpoint iteration for simple generic calls (#30054)
- Solve generic call type context through constraint sets (#26680)
Contributors
Install ty 0.0.99
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ty/releases/download/0.0.99/ty-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ty/releases/download/0.0.99/ty-installer.ps1 | iex"Download ty 0.0.99
Verifying GitHub Artifact Attestations
The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:
gh attestation verify <file-path of downloaded artifact> --repo astral-sh/tyYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>0.0.98
Release Notes
Released on 2026-11-05.
Bug fixes
- Avoid cubic narrowing for enum OR patterns (#30019)
- Avoid duplicate warnings for unknown rules and override sections (#30028)
- Fix class-pattern exhaustiveness after class identity checks (#30045)
- Fix conditional type and tuple annotations (#29987)
- Prefer active unnamed Conda and Pixi environments (#29974)
- Preserve baseline matches when a rule is renamed (#30040)
- Preserve exception types after tuple truthiness checks (#30018)
- Report invalid module globs once per override pattern (#30031)
- Skip active Conda and Pixi environments during discovery if the environment doesn't contain Python (#30066)
Configuration changes
- Don't fail configuration deserialization on conflicting rule names (#30023)
- Inherit project settings and overrides for PEP 723 scripts (#29793)
- Warn when configuration uses a renamed rule (#30024)
Memory usage improvements
- Reuse callable signatures in function definition checks (#30042)
Other changes
- Retain all successful generic call narrowing attempts (#29666)
- Reuse specialized ancestors in class relations (#29881)
- Support shadowing methods on instances (#29482)
- Warn about renamed rules in ignore comments (#30026)
Contributors
Install ty 0.0.98
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ty/releases/download/0.0.98/ty-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ty/releases/download/0.0.98/ty-installer.ps1 | iex"Download ty 0.0.98
Verifying GitHub Artifact Attestations
The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:
gh attestation verify <file-path of downloaded artifact> --repo astral-sh/tyYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>0.0.97
Release Notes
Released on 2026-11-04.
Bug fixes
- Apply a cycle iteration cutoff across type inference (#30010)
- Cap the size of inferred bytes literals during concatenation (#29942)
- Django: support ForeignKey and OneToOneField as primary keys (#29785)
- Fix a call hierarchy panic when expanding outgoing calls (#29964)
- Handle decorators that replace overrides of final methods (#29961)
- Ignore an empty
VIRTUAL_ENV(#29973) - Preserve narrowed type variables in union inference (#29989)
Diagnostic improvements
- Lower severity of diagnostics on recoverable invalid globs (#29946)
- Rename
unresolved-importtoimport-not-found(#29960)
Other changes
- Document baseline support (#4897)
- Document third-party library support. (#4879)
- Pydantic: Respect extra-field configuration on settings models (#29902)
- Reuse matching constraints at branch joins (#29875)
- Reuse normalization of wide unions (#29874)
- Skip empty diagnostic context for overloaded callables (#29959)
- Speed up comparisons of deeply nested tuples (#29933)
- Update PyCharm setup instructions for 2026.2 (#4914)
Contributors
Install ty 0.0.97
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ty/releases/download/0.0.97/ty-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ty/releases/download/0.0.97/ty-installer.ps1 | iex"Download ty 0.0.97
Verifying GitHub Artifact Attestations
The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:
gh attestation verify <file-path of downloaded artifact> --repo astral-sh/tyYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>0.0.96
Release Notes
Released on 2026-11-03.
Bug fixes
- Fix a panic when checking protocols involving runtime type aliases (#29840)
- Preserve Pydantic field metadata in quoted annotations (#29851)
- Resolve class-local names in generic type aliases (#29915)
LSP server
- Keep argument name hints display-only before later positional arguments or
*args(#29801) - Keep argument name hints display-only when they would insert duplicate or invalid keywords (#29806)
- Show field docstrings on hover for constructor keyword arguments (#29907)
CLI
- Give
NO_COLORprecedence overFORCE_COLORandCLICOLOR_FORCEin diagnostics (#29898) - Honor color overrides in progress bars (#29891)
- Respect
FORCE_COLORinty checkeven when output is piped (#29830)
Diagnostic improvements
- Avoid false
redundant-castdiagnostics when casting the result of a generic call (#29835)
Core type checking
- Infer type arguments for union parameters using constraints from the whole call (#29236)
- Infer type arguments from generic
TypedDictvalues passed to functions (#29903) - Sync vendored typeshed stubs (#29869). Typeshed diff
Performance
- Avoid constraint solving when checking overlap between type variables in invariant positions (#29878)
- Cache subscript method resolution (#29824)
- Cache substitutions for generic type aliases (#29861)
- Defer member lookup when checking overrides (#29866)
- Find existing imports without scanning nested scopes (#29882)
- Reuse class metadata during member lookup (#29864)
- Reuse constructor bindings and defer looking up enclosing type variables (#29897)
- Reuse generic argument contexts across calls (#29877)
- Reuse inferred annotations when checking function returns (#29879)
- Reuse inherited override checks across subclasses (#29867)
- Reuse parameter unions when filtering overloads (#29823)
- Short-circuit equivalence checks against
Never(#29862) - Skip generic call inference when only a concrete receiver's
Selfneeds binding (#29747) - Skip unrelated statement calls when checking a single condition (#29826)
- Stop scanning package initializers once a legacy namespace declaration is found (#29885)
Memory usage improvements
- Prevent exponential memory growth when narrowing unions of intersections by equality (#29904)
Contributors
Install ty 0.0.96
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ty/releases/download/0.0.96/ty-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ty/releases/download/0.0.96/ty-installer.ps1 | iex"Download ty 0.0.96
Verifying GitHub Artifact Attestations
The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:
gh attestation verify <file-path of downloaded artifact> --repo astral-sh/tyYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>0.0.95
Release Notes
Released on 2026-10-29.
Bug fixes
- Accept another unpacked TypeVarTuple as a default (#29752)
- Accept keyword arguments for
TypeAliasTypename and value (#29802) - Detect traversal budget exhaustion in products of lower bounds (#29679)
- Fix recursive protocol materialization self-comparison (#29809)
- Reject out-of-scope type variables in PEP 695 pack defaults (#29805)
- Use a trailing ParamSpec default after a TypeVarTuple (#29755)
LSP server
- Parenthesize assignment and generator expressions in argument hint edits (#29797)
- Place argument name inlay hints before grouping parentheses (#29794)
- Place variable type inlay hints after grouping parentheses (#29795)
Contributors
Install ty 0.0.95
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://releases.astral.sh/github/ty/releases/download/0.0.95/ty-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://releases.astral.sh/github/ty/releases/download/0.0.95/ty-installer.ps1 | iex"Download ty 0.0.95
Verifying GitHub Artifact Attestations
The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:
gh attestation verify <file-path of downloaded artifact> --repo astral-sh/tyYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>