<div id="readability-page-1" class="page"><section>
        <p>사진 출처: <a href="https://www.flickr.com/photos/28744631@N06/8593971219/">Pinkie Pie by Daniel Chang</a></p>
<blockquote>
<p>Django 1.11이 드디어 출시되었습니다. 1.x에서는 마지막 버전인데요. 이 글에서는 Django 1.11에 추가된 기능과 바뀐점을 간략하게 알아보려 합니다. <a href="https://docs.djangoproject.com/en/stable/releases/1.11/">Django 공식 릴리스 노트</a>를 참고하였습니다. <strong>주의! 릴리스 노트를 모두 번역하지는 않았습니다.</strong></p>
</blockquote>
<blockquote>
<p>하위 버전들의 보안 업데이트도 함께 올라왔습니다. <a href="https://docs.djangoproject.com/en/dev/releases/1.10.7/">1.10.7</a>, <a href="https://docs.djangoproject.com/en/dev/releases/1.9.13/">1.9.13</a>, <a href="https://docs.djangoproject.com/en/dev/releases/1.8.18/">1.8.18</a></p>
</blockquote>
<hr>
<blockquote>
<p><strong>2017-05-11 수정 내역</strong></p>
</blockquote>
<blockquote>
<p><a href="https://github.com/raccoonyy/raccoonyy.github.com/issues/1">shlee322 님의 제보</a>로 include 태그와 관련된 내용을 수정하였습니다.</p>
</blockquote>
<hr>
<h2 id="">파이썬 호환성</h2>
<p>Django 1.11은 파이썬 <strong>2.7, 3.4, 3.5, 3.6에서 작동</strong>합니다. 3.6을 지원하는 첫 Django 버전입니다. 각 버전별 마지막 릴리스를 사용하기를 추천합니다.</p>
<p>Django 1.11.x는 파이썬 2를 지원하는 마지막 버전입니다. 다음 번 메이저 릴리스인 <strong>Django 2.0부터는 파이썬 3.5 이상만 지원</strong>할 예정입니다.</p>
<h2 id="">새 기능</h2>
<h3 id="index"><a href="https://docs.djangoproject.com/en/1.11/ref/models/indexes/#module-django.db.models.indexes">Index 클래스</a></h3>
<p><a href="https://docs.djangoproject.com/en/1.11/topics/db/models/#meta-options">Meta 클래스</a>의 <a href="https://docs.djangoproject.com/en/1.11/ref/models/options/#django.db.models.Options.indexes">indexes 항목에서 인덱스할 필드를 지정</a>할 수 있고, 이를 위한 <a href="https://docs.djangoproject.com/en/1.11/ref/models/indexes/">Index 클래스</a>도 추가되었습니다.</p>
<h3 id="">템플릿 기반의 폼 위젯 렌더링</h3>
<p><a href="https://docs.djangoproject.com/en/1.11/ref/forms/renderers/">폼 렌더링 API가 추가</a>되었고, 이를 활용하여 특정 폼 위젯을 커스터마이징할 수 있습니다.</p>
<h3 id="">하위 쿼리 표현식</h3>
<p>쿼리 결과를 다른 쿼리에서 참조할 수 있는 <a href="https://docs.djangoproject.com/en/1.11/ref/models/expressions/#subquery-expressions">Subquery 표현식</a>과 쿼리 결과가 존재할 때만 실행할 수 있는 <a href="https://docs.djangoproject.com/en/1.11/ref/models/expressions/#django.db.models.Exists">Exists 표현식</a>이 추가되었습니다.</p>
<h3 id="">자잘하게 추가된 기능</h3>
<ul>
<li><a href="https://docs.djangoproject.com/en/1.11/ref/settings/#std:setting-CSRF_USE_SESSIONS"><code>CSRF_USE_SESSIONS</code>을 설정</a>하여 CSRF 토큰을 쿠키가 아닌 세션에 저장할 수 있습니다(기본 값은 False).</li>
<li>PostgreSQL 하에서 <a href="https://docs.djangoproject.com/en/1.11/ref/models/querysets/#django.db.models.query.QuerySet.iterator"><code>QuerySet.iterator()</code> 메서드</a>가 <a href="http://initd.org/psycopg/docs/usage.html#server-side-cursors">서버 측 커서</a>를 사용하여 서버의 메모리 부담을 데이터베이스 메모리로 돌릴 수 있습니다.</li>
<li>Form에서 <a href="https://docs.djangoproject.com/en/1.11/ref/forms/api/#django.forms.Form.get_initial_for_field"><code>get_initial_for_field()</code> 메서드</a>를 사용하여, 필드의 초기 값을 지정할 수 있습니다.</li>
<li>loaddata 명령에 <a href="https://docs.djangoproject.com/en/1.11/ref/django-admin/#cmdoption-loaddata-exclude">--exclude 옵션이 추가</a>되었습니다. 특정 모델이나 앱을 제외하고 픽스처 데이터를 불러올 수 있습니다.</li>
<li>showmigrations 명령에서 <a href="https://docs.djangoproject.com/en/1.11/ref/django-admin/#cmdoption-showmigrations-plan">--plan 옵션</a>을 사용할 때도 app_label을 지정할 수 있습니다.</li>
<li><a href="https://docs.djangoproject.com/en/1.11/ref/models/querysets/#django.db.models.query.QuerySet.get_or_create"><code>get_or_create()</code> 메서드</a>와 <a href="https://docs.djangoproject.com/en/1.11/ref/models/querysets/#django.db.models.query.QuerySet.update_or_create"><code>update_or_create()</code> 메서드</a>에서 <code>defaults</code>의 값으로 함수 값(callable value)을 지정할 수 있습니다.</li>
<li><a href="https://docs.djangoproject.com/en/1.11/ref/models/database-functions/#django.db.models.functions.datetime.Trunc">DateTime이나 TimeField에 대해 Trunc 클래스를 적용</a>하면, 특정 부분 이하를 자를 수 있습니다.</li>
</ul>
<pre><code># 월 단위
2017-02-28 20:11:24.021458+09:00 =&gt; 2017-01-01 00:00:00.000000+09:00

# 일 단위
2017-02-28 20:11:24.021458+09:00 =&gt; 2017-02-01 00:00:00.000000+09:00

# 시 단위
2017-02-28 20:11:24.021458+09:00 =&gt; 2017-02-28 00:00:00.000000+09:00
</code></pre>
<ul>
<li>쿼리셋의 <a href="https://docs.djangoproject.com/en/1.11/ref/models/querysets/#django.db.models.query.QuerySet.values"><code>values()</code> 메서드</a>와 <a href="https://docs.djangoproject.com/en/1.11/ref/models/querysets/#django.db.models.query.QuerySet.values_list"><code>values_list()</code> 메서드</a>에서도 표현식을 사용할 수 있습니다.</li>
<li>쿼리 표현식에서 <a href="https://docs.djangoproject.com/en/1.11/ref/models/expressions/#django.db.models.Expression.asc">정렬시 null 값을 앞에 오거나 뒤에 오도록 지정</a>할 수 있습니다.</li>
<li>두 쿼리셋의 교집합과 합집합, 차집합을 만들 수 있는 <a href="https://docs.djangoproject.com/en/1.11/ref/models/querysets/#django.db.models.query.QuerySet.union"><code>union()</code> 메서드</a>, <a href="https://docs.djangoproject.com/en/1.11/ref/models/querysets/#django.db.models.query.QuerySet.intersection"><code>intersection()</code> 메서드</a>, <a href="https://docs.djangoproject.com/en/1.11/ref/models/querysets/#django.db.models.query.QuerySet.difference"><code>difference()</code> 메서드</a>가 추가되었습니다.</li>
</ul>
<h2 id="">바뀐 점</h2>
<h3 id="collectstatic">collectstatic 실행시 파일 간 순환 참조가 존재하면 오류 발생</h3>
<p>해시 값이 붙은 정적 파일 저장소를 사용하고 있을 때,<br>
<code>a.css</code>에서 <code>b.css</code>를 참조하고 <code>b.css</code>에서도 <code>a.css</code>를 참조한다면 collectstatic 명령이 실패합니다.</p>
<h3 id="datetimefield"><a href="https://docs.djangoproject.com/en/1.11/ref/models/fields/#django.db.models.DateTimeField">DateTimeField</a>에 대해 상세 <a href="https://docs.djangoproject.com/en/1.11/ref/models/querysets/#date">룩업</a> 지원</h3>
<ul>
<li><a href="https://docs.djangoproject.com/en/1.11/ref/models/fields/#django.db.models.DateField">DateField</a>에 대해 <a href="https://docs.djangoproject.com/en/1.11/ref/models/querysets/#week">week</a> 룩업을 지원합니다.</li>
<li><a href="https://docs.djangoproject.com/en/1.11/ref/models/fields/#django.db.models.DateTimeField">DateTimeField</a>에 대해 <a href="https://docs.djangoproject.com/en/1.11/ref/models/querysets/#time">time</a> 룩업을 지원합니다.</li>
<li><code>USE_TZ</code> 옵션이 <code>True</code>라면 필드의 값이 현지 시각으로 바뀌어 리턴됩니다.</li>
</ul>
<h3 id="postgresql92postgis20">PostgreSQL 9.2와 PostGIS 2.0 지원 중단</h3>
<p>PostgreSQL 9.2의 지원이 2017년 9월에 끝남에 따라, Django 1.11에서는 <strong>PostgreSQL 9.3을 최소 지원 버전으로 지정</strong>하였습니다.</p>
<h3 id="liveservertestcase0">LiveServerTestCase가 포트 0에 바인드</h3>
<p>아울러 <code>DJANGO_LIVE_TEST_SERVER_ADDRESS</code> 옵션이 사라지고, <code>manage.py test</code> 명령에 <code>--liveserver</code> 옵션도 삭제되었습니다.</p>
<h3 id="get_or_createupdate_or_create"><code>get_or_create()</code>와 <code>update_or_create()</code>에서 변수명 검사</h3>
<p>모델에 없는 필드를 지정할 경우 오류가 발생합니다. (이전에는 그냥 무시했기 때문에, 타이핑 실수를 찾기가 어려웠죠.)</p>
<h3 id="pytztime_zonenone">pytz 패키지 의존성이 추가되었고, <code>TIME_ZONE = None</code> 옵션이 사라집니다.</h3>
<p>자동으로 타임존을 설정할 때는 settings 파일에 <code>TIME_ZONE = None</code> 대신 다음처럼 하세요.</p>
<pre><code>from tzlocal import get_localzone

TIME_ZONE = get_localzone().zone
</code></pre>
<h3 id="">사소한 변경</h3>
<ul>
<li>테스트를 실행할 때도 <code>ALLOWED_HOSTS</code>를 검사합니다. 테스트용 호스트 이름을 사용하고 있다면 이 이름을 <code>ALLOWED_HOSTS</code>에도 넣어야 합니다.</li>
<li>모델 폼에서 CharField가 null=True인 경우, 빈 문자열 대신 NULL을 저장합니다.</li>
<li>체크박스와 셀렉트박스 폼을 렌더링할 때 <code>checked='checked'</code>, <code>selected='selected'</code> 대신 <code>checked</code>, <code>selected</code>만 넣습니다.</li>
</ul>
<h2 id="">삭제된 기능</h2>
<h3 id="modelspermalink">models.permalink 데코레이터</h3>
<p>대신 <a href="https://docs.djangoproject.com/en/1.11/ref/urlresolvers/#django.urls.reverse"><code>django.urls.reverse()</code></a>를 사용해야 합니다.</p>
<h3 id="contribauth">contrib.auth의 각종 함수 기반 뷰</h3>
<p>인증과 관련된 함수 기반 뷰들이 클래스 기반 뷰로 바뀌었습니다.</p>
<ul>
<li><code>login()</code> -&gt; <a href="https://docs.djangoproject.com/en/1.11/topics/auth/default/#django.contrib.auth.views.LoginView">LoginView</a></li>
<li><code>logout()</code> -&gt; <a href="https://docs.djangoproject.com/en/1.11/topics/auth/default/#django.contrib.auth.views.LogoutView">LogoutView</a></li>
<li><code>password_change()</code> -&gt; <a href="https://docs.djangoproject.com/en/1.11/topics/auth/default/#django.contrib.auth.views.PasswordChangeView">PasswordChangeView</a></li>
<li><code>password_change_done()</code> -&gt; <a href="https://docs.djangoproject.com/en/1.11/topics/auth/default/#django.contrib.auth.views.PasswordChangeDoneView">PasswordChangeDoneView</a></li>
<li><code>password_reset()</code> -&gt; <a href="https://docs.djangoproject.com/en/1.11/topics/auth/default/#django.contrib.auth.views.PasswordResetView">PasswordResetView</a></li>
<li><code>password_reset_done()</code> -&gt; <a href="https://docs.djangoproject.com/en/1.11/topics/auth/default/#django.contrib.auth.views.PasswordResetDoneView">PasswordResetDoneView</a></li>
<li><code>password_reset_confirm()</code> -&gt; <a href="https://docs.djangoproject.com/en/1.11/topics/auth/default/#django.contrib.auth.views.PasswordResetConfirmView">PasswordResetConfirmView</a></li>
<li><code>password_reset_complete()</code> -&gt; <a href="https://docs.djangoproject.com/en/1.11/topics/auth/default/#django.contrib.auth.views.PasswordResetCompleteView">PasswordResetCompleteView</a></li>
</ul>
<h3 id="include"><a href="https://docs.djangoproject.com/en/1.11/topics/auth/default/#django.contrib.auth.views.PasswordResetCompleteView"><code>{% include %}</code> 탬플릿 태그</a> 렌더링시 예외를 발생시키지 않았던 부분</h3>
<p><a href="https://docs.djangoproject.com/en/1.11/ref/templates/builtins/#std:templatetag-include">include</a> 태그를 렌더링하는 동안 예외가 발생하면 조용히 넘어갔는데, 이것이 꽤나 혼란을 주었나 봅니다. Django 2.1부터는 include 태그를 사용했을 때 예외가 발생합니다.</p>

    </section></div>

raccoony's cave

Seungho Kim

사진 출처: Pinkie Pie by Daniel Chang
Django 1.11이 드디어 출시되었습니다. 1.x에서는 마지막 버전인데요. 이 글에서는 Django 1.11에 추가된 기능과 바뀐점을 간략하게 알아보려 합니다. Django 공식 릴리스 노트를 참고하였습니다. 주의! 릴리스 노트를 모두 번역하지는 않았습니다.
하위 버전들의 보안 업데이트도 함께 올라왔습니다. 1.10.7, 1.9.13, 1.8.18
2017-05-11 수정 내역
shlee322 님의 제보로 include 태그와 관련된 내용을 수정하였습니다.
파이썬 호환성
Django 1.11은 파이썬 2.7, 3.4, 3.5, 3.6에서 작동합니다. 3.6을 지원하는 첫 Django 버전입니다. 각 버전별 마지막 릴리스를 사용하기를 추천합니다.
Django 1.11.x는 파이썬 2를 지원하는 마지막 버전입니다. 다음 번 메이저 릴리스인 Django 2.0부터는 파이썬 3.5 이상만 지원할 예정입니다.
새 기능
Index 클래스
Meta 클래스의 indexes 항목에서 인덱스할 필드를 지정할 수 있고, 이를 위한 Index 클래스도 추가되었습니다.
템플릿 기반의 폼 위젯 렌더링
폼 렌더링 API가 추가되었고, 이를 활용하여 특정 폼 위젯을 커스터마이징할 수 있습니다.
하위 쿼리 표현식
쿼리 결과를 다른 쿼리에서 참조할 수 있는 Subquery 표현식과 쿼리 결과가 존재할 때만 실행할 수 있는 Exists 표현식이 추가되었습니다.
자잘하게 추가된 기능
CSRF_USE_SESSIONS을 설정하여 CSRF 토큰을 쿠키가 아닌 세션에 저장할 수 있습니다(기본 값은 False).
PostgreSQL 하에서 QuerySet.iterator() 메서드가 서버 측 커서를 사용하여 서버의 메모리 부담을 데이터베이스 메모리로 돌릴 수 있습니다.
Form에서 get_initial_for_field() 메서드를 사용하여, 필드의 초기 값을 지정할 수 있습니다.
loaddata 명령에 --exclude 옵션이 추가되었습니다. 특정 모델이나 앱을 제외하고 픽스처 데이터를 불러올 수 있습니다.
showmigrations 명령에서 --plan 옵션을 사용할 때도 app_label을 지정할 수 있습니다.
get_or_create() 메서드와 update_or_create() 메서드에서 defaults의 값으로 함수 값(callable value)을 지정할 수 있습니다.
DateTime이나 TimeField에 대해 Trunc 클래스를 적용하면, 특정 부분 이하를 자를 수 있습니다.
# 월 단위
2017-02-28 20:11:24.021458+09:00 => 2017-01-01 00:00:00.000000+09:00
# 일 단위
2017-02-28 20:11:24.021458+09:00 => 2017-02-01 00:00:00.000000+09:00
# 시 단위
2017-02-28 20:11:24.021458+09:00 => 2017-02-28 00:00:00.000000+09:00
쿼리셋의 values() 메서드와 values_list() 메서드에서도 표현식을 사용할 수 있습니다.
쿼리 표현식에서 정렬시 null 값을 앞에 오거나 뒤에 오도록 지정할 수 있습니다.
두 쿼리셋의 교집합과 합집합, 차집합을 만들 수 있는 union() 메서드, intersection() 메서드, difference() 메서드가 추가되었습니다.
바뀐 점
collectstatic 실행시 파일 간 순환 참조가 존재하면 오류 발생
해시 값이 붙은 정적 파일 저장소를 사용하고 있을 때,
a.css에서 b.css를 참조하고 b.css에서도 a.css를 참조한다면 collectstatic 명령이 실패합니다.
DateTimeField에 대해 상세 룩업 지원
DateField에 대해 week 룩업을 지원합니다.
DateTimeField에 대해 time 룩업을 지원합니다.
USE_TZ 옵션이 True라면 필드의 값이 현지 시각으로 바뀌어 리턴됩니다.
PostgreSQL 9.2와 PostGIS 2.0 지원 중단
PostgreSQL 9.2의 지원이 2017년 9월에 끝남에 따라, Django 1.11에서는 PostgreSQL 9.3을 최소 지원 버전으로 지정하였습니다.
LiveServerTestCase가 포트 0에 바인드
아울러 DJANGO_LIVE_TEST_SERVER_ADDRESS 옵션이 사라지고, manage.py test 명령에 --liveserver 옵션도 삭제되었습니다.
get_or_create()와 update_or_create()에서 변수명 검사
모델에 없는 필드를 지정할 경우 오류가 발생합니다. (이전에는 그냥 무시했기 때문에, 타이핑 실수를 찾기가 어려웠죠.)
pytz 패키지 의존성이 추가되었고, TIME_ZONE = None 옵션이 사라집니다.
자동으로 타임존을 설정할 때는 settings 파일에 TIME_ZONE = None 대신 다음처럼 하세요.
from tzlocal import get_localzone
TIME_ZONE = get_localzone().zone
사소한 변경
테스트를 실행할 때도 ALLOWED_HOSTS를 검사합니다. 테스트용 호스트 이름을 사용하고 있다면 이 이름을 ALLOWED_HOSTS에도 넣어야 합니다.
모델 폼에서 CharField가 null=True인 경우, 빈 문자열 대신 NULL을 저장합니다.
체크박스와 셀렉트박스 폼을 렌더링할 때 checked='checked', selected='selected' 대신 checked, selected만 넣습니다.
삭제된 기능
models.permalink 데코레이터
대신 django.urls.reverse()를 사용해야 합니다.
contrib.auth의 각종 함수 기반 뷰
인증과 관련된 함수 기반 뷰들이 클래스 기반 뷰로 바뀌었습니다.
login() -> LoginView
logout() -> LogoutView
password_change() -> PasswordChangeView
password_change_done() -> PasswordChangeDoneView
password_reset() -> PasswordResetView
password_reset_done() -> PasswordResetDoneView
password_reset_confirm() -> PasswordResetConfirmView
password_reset_complete() -> PasswordResetCompleteView
{% include %} 탬플릿 태그 렌더링시 예외를 발생시키지 않았던 부분
include 태그를 렌더링하는 동안 예외가 발생하면 조용히 넘어갔는데, 이것이 꽤나 혼란을 주었나 봅니다. Django 2.1부터는 include 태그를 사용했을 때 예외가 발생합니다.

Django 1.11 릴리스와 주요 변경 사항

댓글