Merge branch 'master' into fastapi

Author: brendaweles

python-repl-314/.pythonstartup

@@ -0,0 +1,18 @@
+try:
+    from dataclasses import replace
+
+    from _colorize import ANSIColors, default_theme, set_theme
+except Exception:
+    # Running on an older Python or environment without _colorize
+    pass
+else:
+    theme = default_theme.copy_with(
+        syntax=replace(
+            default_theme.syntax,
+            keyword=ANSIColors.BOLD_YELLOW,
+            string=ANSIColors.INTENSE_BLUE,
+            number=ANSIColors.RED,
+            comment=ANSIColors.GREY,
+        ),
+    )
+    set_theme(theme)

python-repl-314/README.md

@@ -0,0 +1,3 @@
+# Python 3.14 Preview: REPL Autocompletion and Highlighting
+
+This folder provides the code examples for the Real Python tutorial [Python 3.14 Preview: REPL Autocompletion and Highlighting](https://realpython.com/python-repl-autocompletion-highlighting/).

python-repl-314/syntax_highlighting_sample.py

@@ -0,0 +1,21 @@
+import pathlib
+
+BASE_DIR = pathlib.Path(".")
+number = 42
+fruits = ["apple", "grape", "orange"]
+
+
+def func(value):
+    """A sample docstring."""
+    return f"The input value is: {value}"
+
+
+def main():
+    # A sample comment
+    func(number)
+    for fruit in fruits:
+        print(fruit)
+
+
+if __name__ == "__main__":
+    main()

python-ty/README.md

@@ -0,0 +1,3 @@
+# Astral's ty: A New Blazing-Fast Type Checker for Python
+
+This folder contains sample code for the Real Python tutorial [Astral's ty: A New Blazing-Fast Type Checker for Python](https://realpython.com/python-ty/).

python-ty/adder.py

@@ -0,0 +1,28 @@
+# fmt:off
+
+import warnings
+
+type Number = int | float
+
+
+def new_adder(x: Number, y: Number) -> Number:
+    return x + y
+
+
+@warnings.deprecated("Use the new_adder() instead")
+def legacy_adder(x, y):
+    return x + y
+
+
+if __name__ == "__main__":
+    legacy_adder(  # ty: ignore
+        42,
+        555
+    )
+
+    legacy_adder(
+        42,
+        555
+    )  # ty: ignore
+
+    new_adder(a=42, b=555)  # ty: ignore[unknown-argument, missing-argument]

python-ty/cross_platform.py

@@ -0,0 +1,9 @@
+from sys import platform
+from typing import reveal_type
+
+if platform == "win32":
+    x = "Windows"
+else:
+    x = "macOS or Linux"
+
+reveal_type(x)

python-ty/python_version.py

@@ -0,0 +1,3 @@
+from typing import Literal
+
+type Size = Literal["S", "M", "L", "XL"]