Merge branch 'master' into update-mcp-client-sdk-v2

Author: realpython-bot

celery-async-tasks/README.md

@@ -3,17 +3,28 @@
 Example project for integrating Celery and Redis into a Django application.
 This repository holds the code for the Real Python [Asynchronous Tasks With Django and Celery](https://realpython.com/asynchronous-tasks-with-django-and-celery/) tutorial.
 
-## Setup (macOS)
+## Setup
 
-To try the project, set up a virtual environment and install the listed dependencies:
+The project targets Linux and macOS. Celery doesn't support Windows.
+
+To try the project, set up a virtual environment with Python 3.12 or newer and install the listed dependencies:
 
 ```sh
 $ python -m venv venv
 $ source venv/bin/activate
 (venv) $ python -m pip install -r requirements.txt
 ```
 
-You'll also need to install Redis on your system:
+You'll also need to install Redis on your system.
+
+On Linux (Debian or Ubuntu):
+
+```sh
+$ sudo apt update
+$ sudo apt install redis
+```
+
+On macOS with [Homebrew](https://brew.sh/):
 
 ```sh
 $ brew install redis
@@ -46,4 +57,4 @@ $ redis-server
 (venv) $ python -m celery -A django_celery worker -l info
 ```
 
-When all three processes are running, you can go to `localhost:8000/` and submit a feedback response. Celery will simulate a work-intensive process and send an email at the end of it. You'll see the email message show up in the log stream on the terminal window where the Celery worker is running.
+When all three processes are running, you can go to `http://localhost:8000/` and submit a feedback response. Celery will simulate a work-intensive process and send an email at the end of it. You'll see the email message show up in the log stream on the terminal window where the Celery worker is running.

celery-async-tasks/source_code_final/requirements.txt

@@ -1,18 +1,21 @@
-amqp==5.3.1
-asgiref==3.8.1
-billiard==4.2.1
-celery==5.4.0
-click==8.1.7
+amqp==5.4.0
+asgiref==3.12.1
+billiard==4.3.0
+celery==5.6.3
+click==8.5.0
 click-didyoumean==0.3.1
-click-plugins==1.1.1
-click-repl==0.3.0
-Django==5.1.3
-kombu==5.4.2
-prompt_toolkit==3.0.48
+click-plugins==1.1.1.2
+click-repl==0.4.0
+Django==6.1.1
+kombu==5.6.2
+packaging==26.3
+prompt_toolkit==3.0.53
 python-dateutil==2.9.0.post0
-redis==5.2.0
-six==1.16.0
-sqlparse==0.5.2
-tzdata==2024.2
+redis==8.1.0
+six==1.17.0
+sqlparse==0.6.0
+typing_extensions==4.16.0
+tzdata==2026.4
+tzlocal==5.4.4
 vine==5.1.0
-wcwidth==0.2.13
+wcwidth==0.9.1

celery-async-tasks/source_code_initial/requirements.txt

@@ -1,18 +1,21 @@
-amqp==5.3.1
-asgiref==3.8.1
-billiard==4.2.1
-celery==5.4.0
-click==8.1.7
+amqp==5.4.0
+asgiref==3.12.1
+billiard==4.3.0
+celery==5.6.3
+click==8.5.0
 click-didyoumean==0.3.1
-click-plugins==1.1.1
-click-repl==0.3.0
-Django==5.1.3
-kombu==5.4.2
-prompt_toolkit==3.0.48
+click-plugins==1.1.1.2
+click-repl==0.4.0
+Django==6.1.1
+kombu==5.6.2
+packaging==26.3
+prompt_toolkit==3.0.53
 python-dateutil==2.9.0.post0
-redis==5.2.0
-six==1.16.0
-sqlparse==0.5.2
-tzdata==2024.2
+redis==8.1.0
+six==1.17.0
+sqlparse==0.6.0
+typing_extensions==4.16.0
+tzdata==2026.4
+tzlocal==5.4.4
 vine==5.1.0
-wcwidth==0.2.13
+wcwidth==0.9.1

hello-jev/README.md

@@ -0,0 +1,67 @@
+# Hello Jev: Getting Started With Jev in Python
+
+This folder provides the code examples for *Get Started With Jev in Python*,
+a video on the [Real Python YouTube channel](https://www.youtube.com/@realpython).
+
+Both scripts run the same train-station info desk. The desk asks a visitor
+whether they lost something and then points them at the lost-and-found counter
+or asks what else it can help with. The difference is how the answer is read:
+
+- **`plain_python.py`** handles the input by hand. It only accepts an uppercase
+  `Y` or `N`, so anything else sends the visitor back around the loop.
+- **`jev_noul.py`** replaces that branching with a single `Noul` question. Jev
+  scores how affirmative the answer is on a scale from `0` to `1`, so the script
+  compares thresholds instead of strings and understands replies like
+  `yeah, I've lost something`.
+
+## Setup
+
+Install [uv](https://docs.astral.sh/uv/), then create the virtual environment.
+Because `pyproject.toml` pins `requires-python = ">=3.14"`, uv downloads
+CPython 3.14 for you if you don't have it yet:
+
+```sh
+$ uv sync
+```
+
+`jev_noul.py` reaches Jev through [OpenRouter](https://openrouter.ai/), which
+lets you try the model without opening an account with TypeSafe AI. Grab an
+OpenRouter API key, then create a `.env` file next to the scripts and add it:
+
+```dotenv
+OPENROUTER_API_KEY=<YOUR-OPENROUTER-KEY>
+```
+
+Keep `.env` out of version control. An API key belongs in your environment, not
+in your repository.
+
+## Running the Examples
+
+Start with the plain script to see where hand-written input handling gives up:
+
+```sh
+$ uv run plain_python.py
+Did you lose something? (Y/N)
+```
+
+Only an uppercase `Y` or `N` gets you past the prompt. Try `yes` or `y` and the
+script asks again.
+
+Now run the Jev version. The `--env-file` flag tells uv to load your API key
+from `.env` before it starts the script:
+
+```sh
+$ uv run --env-file .env jev_noul.py
+Did you lose something?
+```
+
+Answer in your own words. `jev_noul.py` treats a Noul above `0.8` as a yes and
+below `0.2` as a no, and asks again for anything in between.
+
+## Where to Go Next
+
+`Noul` is one of three Jev primitives. `Score` rates something on a scale, and
+`Choice` picks from a list of options. The
+[TypeSafe SDK on PyPI](https://pypi.org/project/typesafe-sdk/) documents all
+three, and the TypeSafe AI blog explains the idea behind them in
+[Introducing System One Models and Jev](https://typesafe.ai/blog/introducing-system-one-models-and-jev).

hello-jev/jev_noul.py

@@ -0,0 +1,43 @@
+import os
+
+from typesafe_sdk import Noul, TypeSafeClient
+
+client = TypeSafeClient(
+    api_key=os.environ["OPENROUTER_API_KEY"],
+    base_url="https://openrouter.ai/api",
+)
+
+
+def respond(lost_something):
+    if lost_something:
+        print("You can find the lost and found counter on the right.")
+    else:
+        print("What can I help you with?")
+
+
+def ask():
+    while True:
+        answer = input("Did you lose something? ")
+        r = client.system_one(
+            state=f"{answer}",
+            questions={
+                "lost_something": Noul(
+                    instructions="Is the answer from the user affirmative?"
+                ),
+            },
+        )
+        lost_something = r.answers["lost_something"].noul
+        if lost_something > 0.8:
+            return True
+        if lost_something < 0.2:
+            return False
+        print("Sorry, I didn't get that.")
+
+
+def main():
+    lost_something = ask()
+    respond(lost_something)
+
+
+if __name__ == "__main__":
+    main()

hello-jev/plain_python.py

@@ -0,0 +1,24 @@
+def respond(lost_something):
+    if lost_something:
+        print("You can find the lost and found counter on the right.")
+    else:
+        print("What can I help you with?")
+
+
+def ask():
+    while True:
+        answer = input("Did you lose something? (Y/N) ")
+        if answer == "Y":
+            return True
+        if answer == "N":
+            return False
+        print("Please answer with Y or N.")
+
+
+def main():
+    lost_something = ask()
+    respond(lost_something)
+
+
+if __name__ == "__main__":
+    main()

hello-jev/pyproject.toml

@@ -0,0 +1,8 @@
+[project]
+name = "hello-jev"
+version = "0.1.0"
+description = "Hello Jev: a train station info desk that routes visitors with a Choice, a Score, and a Noul."
+requires-python = ">=3.14"
+dependencies = [
+    "typesafe-sdk>=0.7.0",
+]