Django: what’s new in 6.0

Django 6.0 – 主要変更点

---

django‑upgrade を使ったアップグレード

Django 5.2以前からプロジェクトを移行する場合は django-upgrade を試してみてください。
自動的に古い Django コードを新機能に合わせて更新し、非推奨警告も修正します。Django 6.0 には 5 つのファイザーが含まれています。

---

1. テンプレートパーシャル

Django はテンプレート内で再利用できる小さな名前付きフラグメント、template partials をサポートします。別個にレンダリングすることも可能です。

{% partialdef filter_controls %}
    <form>
        {{ filter_form }}
    </form>
{% endpartialdef %}

{% partial filter_controls %}

定義自体を表示したい場合は

inline

を使います。

---

2. タスクフレームワーク

組み込みのバックグラウンドタスクシステムが追加されました。

from django.tasks import task

@task
def resize_video(video_id):
    ...

resize_video.enqueue(video.id)

開発時に利用できるバックエンドは以下です：

• ImmediateBackend – 同期で実行。
• DummyBackend – 何もしない。テスト向け。

本番環境では、例えば django-tasks の

DatabaseBackend

などサードパーティ製を使用してください。

---

3. コンテンツセキュリティポリシー（CSP）対応

ミドルウェアを追加します：

MIDDLEWARE = [
    # …
    "django.middleware.csp.ContentSecurityPolicyMiddleware",
]

設定は次のように行います。

SECURE_CSP_REPORT_ONLY = {
    "script-src": [CSP.NONCE, CSP.STRICT_DYNAMIC],
    "object-src": [CSP.NONE],
    "base-uri": [CSP.NONE],
}

Nonce の生成は組み込みで、タグに

nonce="{{ csp_nonce }}"

を付与します。

---

4. メール API の更新

Django は Python のモダンなメール API (

email.message.EmailMessage

) を採用しました。既存の使い方はそのままです。

from django.core.mail import EmailMessage

email = EmailMessage(
    subject="🐼 Need more bamboo",
    body="…",
    from_email="zookeeper@example.com",
    to=["supplies@example.com"],
)
email.attach_file("/media/bamboo_cupboard.jpg")
email.send()

インライン添付

from email.message import MIMEPart
import email.utils

cid = email.utils.make_msgid()
inline_image = MIMEPart()
inline_image.set_content(
    panda_jpeg,
    maintype="image",
    subtype="jpeg",
    disposition="inline",
    cid=cid,
)
message.attach(inline_image)

---

5.

django.core.mail

API の位置引数

あまり使われないパラメータはキーワード引数で渡す必要があります。

send_mail(
    subject="🐼 Panda of the week",
    body="…",
    from_email="updates@example.com",
    ["adam@example.com"],
    fail_silently=True,
)

---

6. 自動シェルインポートの拡張

./manage.py shell

は次のユーティリティを自動でインポートします：

• settings

• connection

  ,

  reset_queries

• models

  ,

  functions

• timezone

必要に応じてドキュメントからリストをカスタマイズできます。

---

7.

save()

時の動的フィールド更新

以下で定義されたフィールドは、

save()

後に SQL の

RETURNING

句を使って自動更新されます（SQLite, PostgreSQL, Oracle）。

• db_default

• GeneratedField

• 式による代入

MySQL/MariaDB では遅延処理としてマークされ、後で自動更新されます。

---

8. ユニバーサルな

StringAgg

集約

すべてのバックエンドで利用可能です：

from django.db.models import StringAgg, Value

videos = Video.objects.annotate(
    chapter_ids=StringAgg("chapter", delimiter=Value(","))
)

---

9. デフォルト PK 型を

BigAutoField

に変更

DEFAULT_AUTO_FIELD

はデフォルトで

django.db.models.BigAutoField

が設定されます。
新規プロジェクトでは追加の設定が不要です。

---

10. テンプレート変数

forloop.length

ループ内で

{{ forloop.length }}

を使用できます：

{% for goose in geese %}
    <li>{{ forloop.counter }}/{{ forloop.length }}: {{ goose.name }}</li>
{% endfor %}

---

11. クエリストリングテンプレートタグの拡張

1. 一貫した

   ?

   プレフィックス – 空の場合でもクエリパラメータをクリアします。
2. 複数位置引数 – 複数マッピングを統合できます。

<a href="{% querystring request.GET super_search_params %}">Super search</a>

---

まとめ

Django 6.0 は、テンプレートパーシャルや組み込みタスクフレームワーク、CSP サポート、モダンメール処理などの強力な新機能と改善を提供しつつ、後方互換性も維持しています。
今日からアップグレードして、新しい機能をぜひ体験してください。