Merge branch 'master' into python-docstrings

Author: brendaweles

python-annotations/README.md

@@ -0,0 +1,3 @@
+# Python 3.14 Preview: Lazy Annotations
+
+This folder contains sample code for the Real Python tutorial [Python 3.14 Preview: Lazy Annotations](https://realpython.com/python-annotations/).

python-annotations/calculator.pyi

@@ -0,0 +1,9 @@
+type Number = int | float
+
+class Calculator:
+    history: list[Number]
+
+    def __init__(self) -> None: ...
+    def add(self, a: Number, b: Number) -> Number: ...
+
+def add(a: Number, b: Number) -> Number: ...

python-annotations/fib.py

@@ -0,0 +1,9 @@
+from typing import Annotated
+
+
+def fib(n: int) -> int:
+    return n if n < 2 else fib(n - 2) + fib(n - 1)
+
+
+def increment(x: Annotated[int, fib(35)]) -> int:
+    return x + 1

python-annotations/forward_references_future.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Any, Optional
+
+
+@dataclass
+class LinkedList:
+    head: Node
+
+
+@dataclass
+class Node:
+    value: Any
+    next: Optional[Node] = None

python-annotations/forward_references_strings.py

@@ -0,0 +1,13 @@
+from dataclasses import dataclass
+from typing import Any, Optional
+
+
+@dataclass
+class LinkedList:
+    head: "Node"
+
+
+@dataclass
+class Node:
+    value: Any
+    next: Optional["Node"] = None

python-annotations/linked_list.py

@@ -0,0 +1,13 @@
+from dataclasses import dataclass
+from typing import Any, Optional
+
+
+@dataclass
+class LinkedList:
+    head: Node  # noqa
+
+
+@dataclass
+class Node:
+    value: Any
+    next: Optional[Node] = None  # noqa

python-annotations/models.py

@@ -0,0 +1,12 @@
+from dataclasses import dataclass
+
+from validators import validate_email
+
+
+@dataclass
+class User:
+    email: str
+    password: str
+
+    def __post_init__(self):
+        validate_email(self)

python-annotations/requirements.txt

@@ -0,0 +1,10 @@
+annotated-types==0.7.0
+dnspython==2.7.0
+email_validator==2.2.0
+idna==3.10
+polars==1.31.0
+pydantic==2.11.7
+pydantic_core==2.33.2
+typeguard==4.4.4
+typing-inspection==0.4.1
+typing_extensions==4.14.1

python-annotations/rtti.py

@@ -0,0 +1,6 @@
+from typeguard import typechecked
+
+
+@typechecked
+def add(a: int, b: int) -> int:
+    return a + b

python-annotations/validators.py

@@ -0,0 +1,11 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from models import User
+
+
+def validate_email(user: User):
+    if user.email is None:
+        raise ValueError("email is required")