Alex Waygood c0f22928bd [ty] Add a note to the diagnostic if a new builtin is used on an old Python version (#18068) ...

## Summary

If the user tries to use a new builtin on an old Python version, tell
them what Python version the builtin was added on, what our inferred
Python version is for their project, and what configuration settings
they can tweak to fix the error.

## Test Plan

Snapshots and screenshots:


![image](https://github.com/user-attachments/assets/767d570e-7af1-4e1f-98cf-50e4311db511)

2025-05-13 10:08:04 -04:00

..

assert_never.md_-_`assert_never`_-_Basic_functionality.snap

[ty] Improve diagnostics for assert_type and assert_never (#18050)

2025-05-13 13:00:20 +00:00

assert_type.md_-_`assert_type`_-_Basic.snap

[ty] Improve diagnostics for assert_type and assert_never (#18050)

2025-05-13 13:00:20 +00:00

attribute_assignment.md_-_Attribute_assignment_-_`ClassVar`s.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

attribute_assignment.md_-_Attribute_assignment_-_Data_descriptors_-_Invalid_`__set__`_method_signature.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

attribute_assignment.md_-_Attribute_assignment_-_Data_descriptors_-_Invalid_argument_type.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

attribute_assignment.md_-_Attribute_assignment_-_Instance_attributes_with_class-level_defaults.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

attribute_assignment.md_-_Attribute_assignment_-_Possibly-unbound_attributes.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

attribute_assignment.md_-_Attribute_assignment_-_Pure_instance_attributes.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

attribute_assignment.md_-_Attribute_assignment_-_Setting_attributes_on_union_types.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

attribute_assignment.md_-_Attribute_assignment_-_Unknown_attributes.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

basic.md_-_Structures_-_Multiple_objects_imported_from_an_unresolved_module.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

basic.md_-_Structures_-_Unresolvable_module_import.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

basic.md_-_Structures_-_Unresolvable_submodule_imports.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

for.md_-_For_loops_-_`__iter__`_does_not_return_an_iterator.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

for.md_-_For_loops_-_`__iter__`_method_with_a_bad_signature.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

for.md_-_For_loops_-_`__iter__`_returns_an_iterator_with_an_invalid_`__next__`_method.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

for.md_-_For_loops_-_Bad_`__getitem__`_method.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

for.md_-_For_loops_-_Invalid_iterable.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

for.md_-_For_loops_-_New_over_old_style_iteration_protocol.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

for.md_-_For_loops_-_No_`__iter__`_method_and_`__getitem__`_is_not_callable.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

for.md_-_For_loops_-_Possibly_invalid_`__getitem__`_methods.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

for.md_-_For_loops_-_Possibly_invalid_`__iter__`_methods.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

for.md_-_For_loops_-_Possibly_invalid_`__next__`_method.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

for.md_-_For_loops_-_Possibly_unbound_`__iter__`_and_bad_`__getitem__`_method.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

for.md_-_For_loops_-_Possibly_unbound_`__iter__`_and_possibly_invalid_`__getitem__`.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

for.md_-_For_loops_-_Possibly_unbound_`__iter__`_and_possibly_unbound_`__getitem__`.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

for.md_-_For_loops_-_Possibly-not-callable_`__getitem__`_method.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

for.md_-_For_loops_-_Union_type_as_iterable_where_one_union_element_has_invalid_`__iter__`_method.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

for.md_-_For_loops_-_Union_type_as_iterable_where_one_union_element_has_no_`__iter__`_method.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

for.md_-_For_loops_-_With_non-callable_iterator.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

functions.md_-_Generic_functions___Legacy_syntax_-_Inferring_a_bound_typevar.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

functions.md_-_Generic_functions___Legacy_syntax_-_Inferring_a_constrained_typevar.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

functions.md_-_Generic_functions___PEP_695_syntax_-_Inferring_a_bound_typevar.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

functions.md_-_Generic_functions___PEP_695_syntax_-_Inferring_a_constrained_typevar.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

instances.md_-_Binary_operations_on_instances_-_Operations_involving_types_with_invalid_`__bool__`_methods.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

invalid_argument_type.md_-_Invalid_argument_type_diagnostics_-_Basic.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

invalid_argument_type.md_-_Invalid_argument_type_diagnostics_-_Calls_to_methods.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

invalid_argument_type.md_-_Invalid_argument_type_diagnostics_-_Different_files.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

invalid_argument_type.md_-_Invalid_argument_type_diagnostics_-_Different_source_order.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

invalid_argument_type.md_-_Invalid_argument_type_diagnostics_-_Many_parameters_across_multiple_lines.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

invalid_argument_type.md_-_Invalid_argument_type_diagnostics_-_Many_parameters_with_multiple_invalid_arguments.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

invalid_argument_type.md_-_Invalid_argument_type_diagnostics_-_Many_parameters.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

invalid_argument_type.md_-_Invalid_argument_type_diagnostics_-_Test_calling_a_function_whose_type_is_vendored_from_`typeshed`.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

invalid_argument_type.md_-_Invalid_argument_type_diagnostics_-_Tests_for_a_variety_of_argument_types_-_Keyword_only_arguments.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

invalid_argument_type.md_-_Invalid_argument_type_diagnostics_-_Tests_for_a_variety_of_argument_types_-_Mix_of_arguments.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

invalid_argument_type.md_-_Invalid_argument_type_diagnostics_-_Tests_for_a_variety_of_argument_types_-_One_keyword_argument.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

invalid_argument_type.md_-_Invalid_argument_type_diagnostics_-_Tests_for_a_variety_of_argument_types_-_Only_positional.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

invalid_argument_type.md_-_Invalid_argument_type_diagnostics_-_Tests_for_a_variety_of_argument_types_-_Synthetic_arguments.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

invalid_argument_type.md_-_Invalid_argument_type_diagnostics_-_Tests_for_a_variety_of_argument_types_-_Variadic_arguments.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

invalid_argument_type.md_-_Invalid_argument_type_diagnostics_-_Tests_for_a_variety_of_argument_types_-_Variadic_keyword_arguments.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

membership_test.md_-_Comparison___Membership_Test_-_Return_type_that_doesn't_implement_`__bool__`_correctly.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

mro.md_-_Method_Resolution_Order_tests_-_`__bases__`_lists_with_duplicate_bases.snap

[ty] Allow classes to inherit from type[Any] or type[Unknown] (#18060)

2025-05-12 20:30:21 -04:00

no_matching_overload.md_-_No_matching_overload_diagnostics_-_Calls_to_overloaded_functions.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

not.md_-_Unary_not_-_Object_that_implements_`__bool__`_incorrectly.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

overloads.md_-_Overloads_-_Invalid_-_At_least_two_overloads.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

overloads.md_-_Overloads_-_Invalid_-_Inconsistent_decorators_-_`@classmethod`.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

overloads.md_-_Overloads_-_Invalid_-_Inconsistent_decorators_-_`@final`.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

overloads.md_-_Overloads_-_Invalid_-_Inconsistent_decorators_-_`@override`.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

overloads.md_-_Overloads_-_Invalid_-_Overload_without_an_implementation_-_Regular_modules.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

protocols.md_-_Protocols_-_Calls_to_protocol_classes.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

protocols.md_-_Protocols_-_Invalid_calls_to_`get_protocol_members()`.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

protocols.md_-_Protocols_-_Narrowing_of_protocols.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

return_type.md_-_Function_return_type_-_Generator_functions.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

return_type.md_-_Function_return_type_-_Invalid_conditional_return_type.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

return_type.md_-_Function_return_type_-_Invalid_implicit_return_type.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

return_type.md_-_Function_return_type_-_Invalid_return_type_in_stub_file.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

return_type.md_-_Function_return_type_-_Invalid_return_type.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

rich_comparison.md_-_Comparison___Rich_Comparison_-_Chained_comparisons_with_objects_that_don't_implement_`__bool__`_correctly.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

semantic_syntax_errors.md_-_Semantic_syntax_error_diagnostics_-_`async`_comprehensions_in_synchronous_comprehensions_-_Python_3.10.snap

ty: switch to use annotate-snippets ID functionality

2025-05-09 12:42:14 -04:00

shadowing.md_-_Shadowing_-_Implicit_class_shadowing.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

shadowing.md_-_Shadowing_-_Implicit_function_shadowing.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

tuples.md_-_Comparison___Tuples_-_Chained_comparisons_with_elements_that_incorrectly_implement_`__bool__`.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

tuples.md_-_Comparison___Tuples_-_Equality_with_elements_that_incorrectly_implement_`__bool__`.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

union_call.md_-_Calling_a_union_of_function_types_-_A_smaller_scale_example.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

union_call.md_-_Calling_a_union_of_function_types_-_Multiple_variants_but_only_one_is_invalid.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

union_call.md_-_Calling_a_union_of_function_types_-_Try_to_cover_all_possible_reasons_-_Cover_keyword_argument_related_reasons.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

union_call.md_-_Calling_a_union_of_function_types_-_Try_to_cover_all_possible_reasons_-_Cover_non-keyword_related_reasons.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

unpacking.md_-_Unpacking_-_Exactly_too_few_values_to_unpack.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

unpacking.md_-_Unpacking_-_Exactly_too_many_values_to_unpack.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

unpacking.md_-_Unpacking_-_Right_hand_side_not_iterable.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

unpacking.md_-_Unpacking_-_Too_few_values_to_unpack.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

unresolved_import.md_-_Unresolved_import_diagnostics_-_An_unresolvable_import_that_does_not_use_`from`.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

unresolved_import.md_-_Unresolved_import_diagnostics_-_Using_`from`_with_a_resolvable_module_but_unresolvable_item.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

unresolved_import.md_-_Unresolved_import_diagnostics_-_Using_`from`_with_an_unknown_current_module.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

unresolved_import.md_-_Unresolved_import_diagnostics_-_Using_`from`_with_an_unknown_nested_module.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

unresolved_import.md_-_Unresolved_import_diagnostics_-_Using_`from`_with_an_unresolvable_module.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

unresolved_import.md_-_Unresolved_import_diagnostics_-_Using_`from`_with_too_many_leading_dots.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

unresolved_reference.md_-_Diagnostics_for_unresolved_references_-_New_builtin_used_on_old_Python_version.snap

[ty] Add a note to the diagnostic if a new builtin is used on an old Python version (#18068)

2025-05-13 10:08:04 -04:00

unsupported_bool_conversion.md_-_Different_ways_that_`unsupported-bool-conversion`_can_occur_-_Has_a_`__bool__`_attribute,_but_it's_not_callable.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

unsupported_bool_conversion.md_-_Different_ways_that_`unsupported-bool-conversion`_can_occur_-_Has_a_`__bool__`_method,_but_has_an_incorrect_return_type.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

unsupported_bool_conversion.md_-_Different_ways_that_`unsupported-bool-conversion`_can_occur_-_Has_a_`__bool__`_method,_but_has_incorrect_parameters.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

unsupported_bool_conversion.md_-_Different_ways_that_`unsupported-bool-conversion`_can_occur_-_Part_of_a_union_where_at_least_one_member_has_incorrect_`__bool__`_method.snap

[ty] Refine message for why a rule is enabled (#18038)

2025-05-12 13:31:42 +02:00

version_related_syntax_errors.md_-_Version-related_syntax_error_diagnostics_-_`match`_statement_-_Before_3.10.snap

ty: switch to use annotate-snippets ID functionality

2025-05-09 12:42:14 -04:00