MySQLdb バージョンの制約¶

MySQLdb モジュール (Django が MySQL データベースにアクセスするために使っ ているバックエンド) の古いバージョンのバグを回避するため、 Django の MySQL バックエンドはバージョン 1.2.1p2 またはそれ以降の MySQLdb を要求するよ うになり、それ以前のバージョンを使おうとすると例外を送出するようになりまし た。

現状でこの制約に適合するように MySQLdb のバージョンを上げられない場合、 以前のバージョンと互換性のあるバックエンド mysql_old を使ってください。 このバックエンドを使うには、 DATABASE_ENGINE の設定を、これまで の:

DATABASE_ENGINE = "mysql"

から:

DATABASE_ENGINE = "mysql_old"

に変更してください。

とはいえ、　MySQL ユーザにはできるだけ最新の MySQLdb にアップグレードす るよう強く勧めます。 mysql_old バックエンドは移行を簡単にするだけのため に存在しており、撤廃対象とみなされています。必要なセキュリティフィクスを除 き、ほとんどメンテナンスされることはなく、将来のバージョンで削除される予定 です。

また、 DATABASE_OPTIONS のような設定 (詳細は データベースのドキュメント を参照してください) は、 "mysql" バックエンド でのみ利用でき、 "mysql_old" では使えません。

データベース名の制約に関する変更¶

Django が外部キー参照を生成するときに使う制約名が少し変更されました。 通常、制約名はカラムに対する参照を直接行えない場合にのみ使われるので、 ユーザの目に触れることはありません。

この変更の影響として、 manage.py reset や同様のコマンドを既存のデータベー スに対して実行すると、新たな制約名の形式で SQL を生成する一方、データベース 本体には以前の形式の制約名が存在するという問題が生じ、このためにデータベー スサーバが実在しない制約に対する変更が行われたというエラーメッセージを送出 する場合があります。

この問題を回避するには 2 通りの方法があります:

1. manage.py * の出力をファイルにリダイレクトし、生成された SQL を編集して正しい制約名に直してから実行します。
2. manage.py sqlall の出力から新たな制約名がどうなっているかを調べ て、データベース上の既存の制約名を変更する手がかりにします。

manage.py のオプション名変更¶

フィクスチャのサポートのために、 manage.py のオプションのうち、いくつか を変更しました:

• dumpdata および loaddata コマンドが追加されました。これらのコ マンドは、それぞれデータベースに対してデータをダンプしたりロードした りするためのコマンドです。このコマンドは、 Django のサポートする全て のシリアライズ形式を扱えます。
• sqlinitialdata コマンドは、 sqlcustom に名称変更しました。こ れは、データ関係の操作は loaddata を使うべきであることを強調する 意味もあります (sqlcustom はビューやストアドプロシジャなどのカ スタム SQL 定義に使ってください)。
• 以前のバージョンの名残であった install コマンドを除去しました。 アプリケーションのインストールには syncdb を使ってください。

バックスラッシュのエスケープに関する変更¶

Django のデータベース API はクエリパラメタとして渡されたバックスラッシュを エスケープするようになりました。既存のデータベース API まわりのコードにバッ クスラッシュが入っていて、これまでは (エスケープがなくても) ちゃんと動作し ていたのなら、 1 レベル分「エスケープを外し」ておかねばなりません。

例えば、以前は以下のコードがちゃんと動作していたとします:

# Find text containing a single backslash
MyModel.objects.filter(text__contains='\\\\')

このコードは、今後は以下のように書かねばなりません:

# Find text containing a single backslash
MyModel.objects.filter(text__contains='\\')

ENABLE_PSYCO 設定の除去¶

ENABLE_PSYCO 設定はなくなりました。設定ファイルに ENABLE_PSYCO を加 えても、何も起きません。 Psyco を有効にしたければ、ミドルウェアクラスを自作 してください。

新しいフォームライブラリ¶

新たなフォーム処理ライブラリ django.newforms が導入されました。このライ ブラリは旧来のフォーム/マニピュレータ/バリデーションフレームワークである django.forms への置き換えにあたります。 0.96 ではどちらの API も使えま すが、今後の 2 バージョンのリリースの中で新たなフォームシステムに完全に移行 し、旧来のシステムは撤廃、除去する予定です。

新たなフォームライブラリへの移行のポイントは 3 つあります:

• 現在の django.forms の実体は django.oldforms にコピーしました。 これで、互換性のない変更を座して待つことなく、 今すぐ コードの修正 に取り掛かれます。修正は、各アプリケーションのコードを以下のように書 き換えるだけです:

  from django import forms             # 0.95 スタイル
  from django import oldforms as forms # 0.96 スタイル
  

• 次の Django の公式リリースで、現在の django.newforms を django.forms に移動します。これは互換性のない変更なので、以前の django.forms を使い続けたい人は、上記に従って import 文を変更する 必要があります。

• さらに次のリリースで、 django.oldforms を完全に除去します。

newforms ライブラリは現在も改良が続いていますが、すでに一般的な利用に耐 える状態です。Django でのフォーム処理に入門する人は、旧来のフォームを学ぶの はやめて、新たなフォームから学び始めましょう。

django.newforms の詳細は newforms のドキュメント を参照してください。

URLconf の改良¶

URLconf のコールバックに呼出し可能オブジェクトを使えるようになりました (以 前は呼出し可能オブジェクトの Python パス表記名を表す文字列しか指定できませ んでした)。この改良により、URLconf をより直感的に書けるようになりました。 例えば、以下の URLconf:

from django.conf.urls.defaults import *

urlpatterns = patterns('',
    ('^myview/$', 'mysite.myapp.views.myview')
)

は、以下のように書けるようになりました:

from django.conf.urls.defaults import *
from mysite.myapp.views import myview

urlpatterns = patterns('',
    ('^myview/$', myview)
)

呼出し可能オブジェクトを指定できるようになった利点の一つに、デコレータを使 えるようになったことがあります。 URLconf の中で ビューにデコレータを適用 できるのです。これを使えば、ログインの必要な汎用ビューをとても簡単に書けま す:

from django.conf.urls.defaults import *
from django.contrib.auth.decorators import login_required
from django.views.generic.list_detail import object_list
from mysite.myapp.models import MyModel

info = {
    "queryset" : MyModel.objects.all(),
}

urlpatterns = patterns('',
    ('^myview/$', login_required(object_list), info)
)

どちらの表記方法 (文字列と呼出し可能オブジェクト) も指定方法としては有効で、 当面は混在して利用できます。

テストフレームワーク¶

ついに Django にテストフレームワークが導入されました。 (テストファーストの 推進者 Kent Beck には悪いですが) これで、「心配を退屈な作業に」変えられます。 テストは doctest か unittest を使って作成でき、簡単なテストクライアントを使った ビューのテストもできます。

また、「フィクスチャ」のサポートも追加されました。フィクスチャは Django の サポートする シリアライゼーション形式 で保存された初 期データで、テストの開始時に自動的にデータベースにロードされます。フィクス チャによって、実際のデータを使ったテストが一層簡単になります。

詳しくは テストのドキュメント を参照してください。

admin インタフェースの改良¶

ユーザの追加や更新のための専用のビューが admin インタフェースに追加されまし た。これはちょっとした、でもとても素晴らしい変更です。というのも、 admin で ハッシュパスワードを扱わなくてよくなったからです。