Django 1.11 リリースノート¶

クラスベースモデルのインデックス¶

新しい django.db.models.indexes モジュールはデータベースインデックスの作成を簡単にするクラスを含んでいます。インデックスは Meta.indexes オプションを使ってモデルに追加されます。

The Index class creates a b-tree index, as if you used db_index on the model field or index_together on the model Meta class. It can be subclassed to support different index types, such as GinIndex. It also allows defining the order (ASC/DESC) for the columns of the index.

テンプレートベースのウィジェット表示¶

ウィジェットのカスタマイズを簡単にするため、フォームウィジェットの表示が Python 内ではなくテンプレートシステムを使って行われるようになりました。The form rendering API を参照してください。

いくつかの 後方互換性のない変更 のため、実装済みのカスタムウィジェットを調整する必要があるかもしれません。

Subquery 表現¶

新たな Subquery と Exists データベース表現によって、明示的なサブクエリを作成することができます。サブクエリは、OuterRef を使って外部のクエリセットからフィールドを参照することができます。

マイナーな機能¶

django.contrib.gis¶

• To simplify the codebase and because it’s easier to install than when contrib.gis was first released, GDAL is now a required dependency for GeoDjango. In older versions, it’s only required for SQLite.
• contrib.gis.maps is removed as it interfaces with a retired version of the Google Maps API and seems to be unmaintained. If you’re using it, let us know.
• The GEOSGeometry equality operator now also compares SRID.
• The OpenLayers-based form widgets now use OpenLayers 3, and the gis/openlayers.html and gis/openlayers-osm.html templates have been updated. Check your project if you subclass these widgets or extend the templates. Also, the new widgets work a bit differently than the old ones. Instead of using a toolbar in the widget, you click to draw, click and drag to move the map, and click and drag a point/vertex/corner to move it.
• Support for SpatiaLite < 4.0 is dropped.
• Support for GDAL 1.7 and 1.8 is dropped.
• The widgets in contrib.gis.forms.widgets and the admin’s OpenLayersWidget use the form rendering API rather than loader.render_to_string(). If you’re using a custom widget template, you’ll need to be sure your form renderer can locate it. For example, you could use the TemplatesSetting renderer.

django.contrib.staticfiles¶

• collectstatic may now fail during post-processing when using a hashed static files storage if a reference loop exists (e.g. 'foo.css' references 'bar.css' which itself references 'foo.css') or if the chain of files referencing other files is too deep to resolve in several passes. In the latter case, increase the number of passes using ManifestStaticFilesStorage.max_post_process_passes.
• When using ManifestStaticFilesStorage, static files not found in the manifest at runtime now raise a ValueError instead of returning an unchanged path. You can revert to the old behavior by setting ManifestStaticFilesStorage.manifest_strict to False.

データベースバックエンド API¶

• The DatabaseOperations.time_trunc_sql() method is added to support TimeField truncation. It accepts a lookup_type and field_name arguments and returns the appropriate SQL to truncate the given time field field_name to a time object with only the given specificity. The lookup_type argument can be either 'hour', 'minute', or 'second'.
• The DatabaseOperations.datetime_cast_time_sql() method is added to support the time lookup. It accepts a field_name and tzname arguments and returns the SQL necessary to cast a datetime value to time value.
• To enable FOR UPDATE SKIP LOCKED support, set DatabaseFeatures.has_select_for_update_skip_locked = True.
• The new DatabaseFeatures.supports_index_column_ordering attribute specifies if a database allows defining ordering for columns in indexes. The default value is True and the DatabaseIntrospection.get_constraints() method should include an 'orders' key in each of the returned dictionaries with a list of 'ASC' and/or 'DESC' values corresponding to the the ordering of each column in the index.
• inspectdb no longer calls DatabaseIntrospection.get_indexes() which is deprecated. Custom database backends should ensure all types of indexes are returned by DatabaseIntrospection.get_constraints().
• Renamed the ignores_quoted_identifier_case feature to ignores_table_name_case to more accurately reflect how it is used.
• The name keyword argument is added to the DatabaseWrapper.create_cursor(self, name=None) method to allow usage of server-side cursors on backends that support it.

Dropped support for PostgreSQL 9.2 and PostGIS 2.0¶

Upstream support for PostgreSQL 9.2 ends in September 2017. As a consequence, Django 1.11 sets PostgreSQL 9.3 as the minimum version it officially supports.

Support for PostGIS 2.0 is also removed as PostgreSQL 9.2 is the last version to support it.

Also, the minimum supported version of psycopg2 is increased from 2.4.5 to 2.5.4.

LiveServerTestCase binds to port zero¶

Rather than taking a port range and iterating to find a free port, LiveServerTestCase binds to port zero and relies on the operating system to assign a free port. The DJANGO_LIVE_TEST_SERVER_ADDRESS environment variable is no longer used, and as it’s also no longer used, the manage.py test --liveserver option is removed.

If you need to bind LiveServerTestCase to a specific port, use the port attribute added in Django 1.11.2.

django.contrib.auth や i18n ビューでの安全でないリダイレクトに対する保護¶

LoginView、LogoutView (廃止される関数ベースのビュー) および set_language() は、アプリケーションが HTTPS で動作しているとき、非 HTTPS の next URL へのリダイレクトからユーザを保護します。

QuerySet.get_or_create() と update_or_create() の引数の検証¶

警告なしに引数を渡すことでタイポが発生するのを防ぐため、get_or_create() と update_or_create() が、引数がモデルフィールドかどうかをチェックするようになりました。これはプロジェクト内のバグを顕在化するので、後方互換性がないと言えます。

pytz は必須の依存となり、settings.TIME_ZONE = None のサポートは削除されました。¶

Django のタイムゾーン処理をシンプルにするため、pytz が必須の依存となりました。Django とともに自動的にインストールされます。

動作が一般的でなく、また有用性が不確かなので、settings.TIME_ZONE = None は削除されました。システムのタイムゾーンに基づいたタイムゾーンを自動的に検知したい場合、tzlocal を使用できます:

from tzlocal import get_localzone

TIME_ZONE = get_localzone().zone

os.environ['TZ'] もセットすることを除いて、settings.TIME_ZONE = None と同じように動作します。TIME_ZONE をセットするコードを適応できないことを見つけた事例がある場合は、私たちに教えてください <https://groups.google.com/d/topic/django-developers/OAV3FChfuPM/discussion>。

admin テンプレート内の HTML の変更¶

<p class="help"> が <div> タグに置き換えられ、ヘルプテキスト内にリストを含められるようになりました。

読み取り専用のフィールドが <p>...</p> ではなく <div class="readonly">...</div> でラップされるようになり、どんな種類の HTML でもフィールドのコンテンツとして使えるようになりました。

テンプレートベースのウィジェットレンダリングの導入による変更¶

django.forms.widgets 内の、ドキュメント化されていないいくつかのクラスが削除されました:

• SubWidget
• RendererMixin、ChoiceFieldRenderer、RadioFieldRenderer、CheckboxFieldRenderer
• ChoiceInput、RadioChoiceInput、CheckboxChoiceInput

The undocumented Select.render_option() method is removed.

Widget.format_output() メソッドは削除されました。代わりにカスタムウィジェットテンプレートを使用してください。

いくつかのウィジェット値 (例えば <select> オプション) が、settings.USE_L10N=True の場合にローカル化されるようになりました。ローカル化を無効にする localize テンプレートタグを使ったカスタムウィジェットテンプレートを使用すれば、旧来の動作に戻すことができます。

django.template.backends.django.Template.render() prohibits non-dict context¶

For compatibility with multiple template engines, django.template.backends.django.Template.render() (returned from high-level template loader APIs such as loader.get_template()) must receive a dictionary of context rather than Context or RequestContext. If you were passing either of the two classes, pass a dictionary instead – doing so is backwards-compatible with older versions of Django.

マイグレーション処理でのモデル状態の変更¶

マイグレーション適用のスピードを改善するため、処理が必要とするまで関連モデルのレンダリングを送らせるようになりました (例: RunPython)。database_forwards() や database_backwards() の from_state 引数からモデルクラスやモデルインスタンスを操作するような独自の処理を作成していた場合、独自のマイグレーション処理を記述する で説明しているように、clear_delayed_apps_cache() メソッドを使ってモデル状態をレンダリングする必要があります。

その他¶

• フィードのアイテムが pubdate や updateddate 属性を持たない場合、SyndicationFeed.latest_post_date() がタイムゾーン情報を持たない日時ではなく現在の UTC 日/時を返すようになりました。

• CSRF の失敗が django.request ではなく django.security.csrf ロガーに記録されるようになりました。

• ALLOWED_HOSTS バリデーションが、テスト時に無効化されないようになりました。アプリケーションが独自のホスト名でのテストを含む場合、そのホスト名を ALLOWED_HOSTS に含める必要があります。Tests and multiple host names を参照してください。

• ModelAdmin.list_display で外部キーの ID (e.g. 'field_id') を使用すると関連オブジェクトの ID を表示するようになりました。旧来の動作であるオブジェクトの文字列表現を使いたい場合は、_id サフィックスを削除してください。

• モデルフォーム内で、null=True の CharField が、ブランク値に対して空の文字列ではなく``NULL`` を保存するようになりました。

• Oracleでは、データベースが値を NULL として解釈するため、Model.validate_unique() が一意性に対する空の文字列をチェックしなくなりました。

• AbstractUser をサブクラス化して clean() をオーバーライドする場合、super() を呼ぶようにしてください。モデルフォームバリデーションのような場合に標準化が適用されるよう、新たな AbstractUser.clean() メソッド内で BaseUserManager.normalize_email() が呼ばれます。

• EmailField と URLField が 裸の キーワード引数を受け付けなくなりました。これらのフィールドは常に空白を取り除き、古いバージョンの Django では効果がないので削除してください。

• フォームウィジェットでレンダリングされる checked と selected 属性が、XHTML の checked='checked' や selected='selected' ではなく HTML5 ブール値シンタックスを使用するようになりました。

• RelatedManager.add()、remove()、clear()、set() が prefetch_related() キャッシュをクリアするようになりました。

• 保存した値を失わないように、teardown_test_environment() を呼び出す前に 2 度めの呼び出しをした場合、setup_test_environment() がエラーを投げるようになりました。

• DjangoJSONEncoder (Django 1.0 でリネームされました) に対する、ドキュメント化していない DateTimeAwareJSONEncoder エイリアスが削除されました。

• DEBUG が False かつ OPTIONS['loaders'] を指定していないとき、cached template loader が有効化されるようになりました。スレッドセーフではないテンプレートタグ がある場合、後方互換性がない可能性があります。

• 古いコンテンツタイプ削除のプロンプトが、 migrate コマンド後に表示されなくなりました。代わりに、新たな remove_stale_contenttypes コマンドを使用してください。

• IntegerField に対する admin のウィジェットが type="text" ではなく type="number" を使うようになりました。

• 条件付き HTTP ヘッダが、古い RFC 2616 ではなく RFC 7232 条件付きリクエストの仕様によって解析および比較されるようになりました。

• patch_response_headers() が Last-Modified ヘッダを追加しないようになりました。RFC 7234#section-4.2.2 によると、明示的な有効期限を提供する他のキャッシングヘッダ (例えば Expires や Cache-Control) とともに無用となりました。UpdateCacheMiddleware および add_never_cache_headers() は patch_response_headers() を呼び出すため、この変更の影響を受けます。

• admin テンプレート内で、<p class="help"> が <div> タグに置き換えられ、ヘルプテキスト内にリストを含められるようになりました。

• ConditionalGetMiddleware が Date ヘッダをセットしなくなりました。ウェブサーバがこのヘッダをセットするからです。また、Content-Length ヘッダもセットしなくなりました。これは、CommonMiddleware がこのヘッダをセットするようになったからです。

  If you have a middleware that modifies a response’s content and appears before CommonMiddleware in the MIDDLEWARE or MIDDLEWARE_CLASSES settings, you must reorder your middleware so that responses aren’t modified after Content-Length is set, or have the response modifying middleware reset the Content-Length header.

• すべてのアプリケーションのモデルが読み込まれる前に呼び出された場合、get_model() および get_models() が AppRegistryNotReady を投げるようになりました。以前は対象のアプリケーションのモデルが読み込まれることのみが必須で、リレーションシップのセットアップなしでモデルを返すことができました。get_model() の旧来の動作が必要な場合は、require_ready 引数を False にセットしてください。

• 無用な BaseCommand.can_import_settings 属性が削除されました。

• ドキュメント化されていなかった django.utils.functional.lazy_property が削除されました。

• 非マルチパートのリクエストとの整合性のため、MultiPartParser.parse() が request.POST を不変のままにするようになりました。したがってこの QueryDict を修正する場合は、まずコピーする必要があります (例: request.POST.copy())。

• cx_Oracle 5.2 未満へのサポートが削除されました。

• IPython 1.0 未満へのサポートが shell コマンドから削除されました。

• The signature of private API Widget.build_attrs() changed from extra_attrs=None, **kwargs to base_attrs, extra_attrs=None.

• File-like objects (e.g., StringIO and BytesIO) uploaded to an ImageField using the test client now require a name attribute with a value that passes the validate_image_file_extension validator. See the note in Client.post().

models.permalink() デコレータ¶

代わりに django.urls.reverse() を使用してください。例えば:

from django.db import models

class MyModel(models.Model):
    ...

    @models.permalink
    def url(self):
        return ('guitarist_detail', [self.slug])

は、以下のようになります:

from django.db import models
from django.urls import reverse

class MyModel(models.Model):
    ...

    def url(self):
        return reverse('guitarist_detail', args=[self.slug])

その他¶

• 新たなクラスベースビュー LoginView と LogoutView が採用されたため、contrib.auth の login() および logout() 関数ベースビューは非推奨となりました。
• contrib.auth.views.logout_then_login() の無用の extra_context パラメータが非推奨となりました。
• 新たなクラスベースビュー PasswordChangeView、PasswordChangeDoneView、PasswordResetView、PasswordResetDoneView、PasswordResetConfirmView、PasswordResetCompleteView が採用されたため、contrib.auth の password_change()、password_change_done()、password_reset()、password_reset_done()、password_reset_confirm()、password_reset_complete() は非推奨となりました。
• django.test.runner.setup_databases() が django.test.utils.setup_databases() に移動しました。旧来の場所は非推奨となります。
• django.utils.text.format_lazy() が採用されたため、django.utils.translation.string_concat() は非推奨となりました。string_concat(*strings) は format_lazy('{}' * len(strings), *strings) で置き換えることができます。
• PyLibMCCache キャッシュバックエンドに対して、pylibmc 動作設定を OPTIONS のトップレベル属性として渡すことは非推奨となりました。代わりに、OPTIONS 内の behaviors キー下にセットしてください。
• 新たな allowed_hosts が採用されたため、django.utils.http.is_safe_url() の host は非推奨となりました。
• 有用性よりも混乱の原因になることが多いため、{% include %} テンプレートタグをレンダリングするときに投げられる例外を無効化することは非推奨となりました。Django 2.1 で、この例外は投げられるようになります。
• DatabaseIntrospection.get_constraints() が採用されたため、DatabaseIntrospection.get_indexes() は非推奨となりました。
• authenticate() が認証バックエンドの authenticate() メソッドに request 引数を渡すようになりました。request を第 1 省略可能引数として受け取らないメソッドへのサポートは Django 2.1 で削除されます。
• 設定にかかわらず ETag ヘッダをレスポンスに追加するようになった ConditionalGetMiddleware が採用されたため、USE_ETAGS 設定は非推奨となりました。 CommonMiddleware および django.utils.cache.patch_response_headers() は非推奨が終了するときに ETags をセットしなくなります。
• Model._meta.auto_field が None かどうか をチェックする方法が採用されたので、Model._meta.has_auto_field は非推奨となりました。
• url() 内で iLmsu# で正規表現グループを使用することは非推奨となりました。大文字と小文字を区別しない URL に対して有用なグループは (?i) のみとなりますが、大文字と小文字を区別しない URL は、例えば検索エンジン用に複数のエントリを作成するため、適切ではありません。 代わりの解決方法として、URL 内で大文字を検索して小文字の同等の URL にリダイレクトするような handler404 を作成する方法があります。
• Widget.render() メソッドに renderer 引数が追加されました。廃止されるまでは、この引数を受け取らないメソッドも動作します。