Merge branch 'master' into maintenance/python-itertools-20260918

Author: martin-martin

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

create-django-project/pyproject.toml

@@ -3,5 +3,5 @@ name = "django-setup"
 version = "0.1.0"
 requires-python = ">=3.12"
 dependencies = [
-    "django>=6.0",
+    "django>=6.1",
 ]

create-django-project/requirements.txt

@@ -1,3 +1,3 @@
-asgiref==3.11.0
-django==6.0
-sqlparse==0.5.4
+asgiref==3.12.1
+django==6.1.1
+sqlparse==0.6.0

create-django-project/setup/setup/asgi.py

@@ -4,7 +4,7 @@
 It exposes the ASGI callable as a module-level variable named ``application``.
 
 For more information on this file, see
-https://docs.djangoproject.com/en/6.0/howto/deployment/asgi/
+https://docs.djangoproject.com/en/6.1/howto/deployment/asgi/
 """
 
 import os

create-django-project/setup/setup/settings.py

@@ -1,13 +1,13 @@
 """
 Django settings for setup project.
 
-Generated by 'django-admin startproject' using Django 6.0.
+Generated by 'django-admin startproject' using Django 6.1.1.
 
 For more information on this file, see
-https://docs.djangoproject.com/en/6.0/topics/settings/
+https://docs.djangoproject.com/en/6.1/topics/settings/
 
 For the full list of settings and their values, see
-https://docs.djangoproject.com/en/6.0/ref/settings/
+https://docs.djangoproject.com/en/6.1/ref/settings/
 """
 
 from pathlib import Path
@@ -17,7 +17,7 @@
 
 
 # Quick-start development settings - unsuitable for production
-# See https://docs.djangoproject.com/en/6.0/howto/deployment/checklist/
+# See https://docs.djangoproject.com/en/6.1/howto/deployment/checklist/
 
 # SECURITY WARNING: keep the secret key used in production secret!
 SECRET_KEY = (
@@ -72,7 +72,7 @@
 
 
 # Database
-# https://docs.djangoproject.com/en/6.0/ref/settings/#databases
+# https://docs.djangoproject.com/en/6.1/ref/settings/#databases
 
 DATABASES = {
     "default": {
@@ -83,7 +83,7 @@
 
 
 # Password validation
-# https://docs.djangoproject.com/en/6.0/ref/settings/#auth-password-validators
+# https://docs.djangoproject.com/en/6.1/ref/settings/#auth-password-validators
 
 AUTH_PASSWORD_VALIDATORS = [
     {
@@ -102,7 +102,7 @@
 
 
 # Internationalization
-# https://docs.djangoproject.com/en/6.0/topics/i18n/
+# https://docs.djangoproject.com/en/6.1/topics/i18n/
 
 LANGUAGE_CODE = "en-us"
 
@@ -114,6 +114,16 @@
 
 
 # Static files (CSS, JavaScript, Images)
-# https://docs.djangoproject.com/en/6.0/howto/static-files/
+# https://docs.djangoproject.com/en/6.1/howto/static-files/
 
 STATIC_URL = "static/"
+
+
+# Email
+# https://docs.djangoproject.com/en/6.1/topics/email/#topic-email-configuration
+
+MAILERS = {
+    "default": {
+        "BACKEND": "django.core.mail.backends.console.EmailBackend",
+    },
+}

create-django-project/setup/setup/urls.py

@@ -2,7 +2,7 @@
 URL configuration for setup project.
 
 The `urlpatterns` list routes URLs to views. For more information please see:
-    https://docs.djangoproject.com/en/6.0/topics/http/urls/
+    https://docs.djangoproject.com/en/6.1/topics/http/urls/
 Examples:
 Function views
     1. Add an import:  from my_app import views

create-django-project/setup/setup/wsgi.py

@@ -4,7 +4,7 @@
 It exposes the WSGI callable as a module-level variable named ``application``.
 
 For more information on this file, see
-https://docs.djangoproject.com/en/6.0/howto/deployment/wsgi/
+https://docs.djangoproject.com/en/6.1/howto/deployment/wsgi/
 """
 
 import os

generate-images-openai/README.md

@@ -0,0 +1,44 @@
+# Generate Images in Python With OpenAI's GPT Image API
+
+Learn to use the OpenAI Python library to create images with the GPT Image models. In the associated tutorial on [generating images with the OpenAI API](https://realpython.com/generate-images-openai/), you'll create images from text prompts, tune the size and quality of your results, and edit an image with a follow-up prompt. You'll learn how to interact with the Images API and incorporate this functionality into your Python scripts.
+
+## Setup
+
+Create and activate a virtual environment, then install the `openai` package:
+
+```console
+$ python --version
+Python 3.14.6
+$ python -m venv venv
+$ source venv/bin/activate
+(venv) $ python -m pip install openai==3.13.0
+```
+
+You need to be on Python 3.10 or higher.
+
+The scripts read your API key from the `OPENAI_API_KEY` environment variable:
+
+```console
+(venv) $ export OPENAI_API_KEY="<your-key-value-here>"
+```
+
+## Create and Edit Images
+
+Follow the instructions in [the tutorial](https://realpython.com/generate-images-openai/) to create images from text prompts, edit an image with a follow-up prompt, and convert a Base64 JSON response to a PNG image file.
+
+You can find the code for each of these steps in dedicated scripts:
+
+- `create_png.py`: Create an image from a text prompt and write it straight to a PNG file.
+- `create.py`: Create an image from a text prompt and save the whole JSON response to a file.
+- `convert.py`: Convert a Base64-encoded PNG image delivered in a JSON response to a PNG image file.
+- `edit.py`: Read Base64-encoded image data and make an API request to edit that image with a prompt.
+
+In the tutorial, you'll walk through each of these scripts and their functionality and output in more detail.
+
+Note that `convert.py` and `edit.py` read a saved response from the `responses/` directory. Run `create.py` first, then update the `JSON_FILE` and `SOURCE_FILE` constants to match the filename that it wrote.
+
+## A Note on Models
+
+The GPT Image models replaced DALL·E, which OpenAI [retired on May 12, 2026](https://developers.openai.com/api/docs/deprecations) along with the image variations endpoint. These scripts call `gpt-image-2.5-flare`.
+
+OpenAI retires image models on a regular schedule, so if a script starts failing with a message like `The model 'gpt-image-2.5-flare' does not exist`, then check the deprecations page and swap the model name.