升级开发环境的时候把python从2.7升级到了3.7,同时把django从1.11直接升级到了2.1.5
原文地址http://www.wantchalk.com/c/language/python/2019/01/31/update-django1.11-to-django2.1.5.html
昨天升级系统和开发环境,从zsh vim 到mysql, 从ruby 到java 到python,从sublime到pycharm,xcode,从jenkins到docker,nexus, 几乎所有在用的开发环境,编辑器,系统包,软件包,框架等等全部升级了一遍, 几乎所有在用的全部没有放过,连带的把生产环境也一起升级,所以包括docker的镜像也全部从新编译.
这一顿操作用了我足足两天时间.搞干净了好过年哈!
项目用的比较多的就是django了,之前一直是python2.7 +django1.11(好像是去年升级到django1.11的), 今天一咬牙直接把升级python 3.7.2, django2.1.5,于是就有非常多的痛苦的事情了.
拿重要的说吧
1.配置文件
(1).中间件配置
原来的
MIDDLEWARE_CLASSES = (
...
)
改成
MIDDLEWARE = (
...
)
(2).SessionAuthenticationMiddleware不再支持
直接注释掉
# 'django.contrib.auth.middleware.SessionAuthenticationMiddleware', remove from django2
(3).AUTHENTICATION_BACKENDS的配置从tuple变成array
我不记得是不是必要的了
AUTHENTICATION_BACKENDS = (
...
)
改成
AUTHENTICATION_BACKENDS = [
...
]
(4).djangorestframework的配置(非必要,如果没有使用的话)
'DEFAULT_FILTER_BACKENDS': ('rest_framework.filters.DjangoFilterBackend',
'rest_framework.filters.OrderingFilter'),
改为
'DEFAULT_FILTER_BACKENDS': ('django_filters.rest_framework.DjangoFilterBackend',
'django_filters.rest_framework.OrderingFilter'),
oauth相关的DEFAULT_PERMISSION_CLASSES,下面这些好像都用不了了
# 'oauth2_provider.contrib.rest_framework.IsAuthenticatedOrTokenHasScope',
# 'rest_framework.permissions.TokenAuthentication',
# 'rest_framework.permissions.IsAuthenticatedOrReadOnly',
# 读写都必须经过认证
# 'rest_framework.permissions.IsAuthenticated',
改成
'DEFAULT_PERMISSION_CLASSES': (
'oauth2_provider.contrib.rest_framework.TokenHasReadWriteScope',
)
2.django的辅助类变更
(1).url里的include
现在要从django.url来import include, 过去是django.conf.url
(2).url里添加app_name
如果在urls.py里使用了namespace, 那么请在相应的urls文件的前面添加app_name
# 视频
url(r'^videos/', include('applications.videos.urls', namespace='videos')),
那么要在applications.videos.urls里添加
app_name = 'videos'
如果不这样就会报如下错误
'Specifying a namespace in include() without providing an app_name '
django.core.exceptions.ImproperlyConfigured: Specifying a namespace in include() without providing an app_name is not supported. Set the app_name attribute in the included module, or pass a 2-tuple containing the list of patterns and app_name instead.
(3).如果自己实现了AUTHENTICATION_BACKENDS
那么authenticate方法做如下变化
def authenticate(self, username=None, password=None):
改为
def authenticate(self, request, username=None, password=None, **kwars):
(4) reverse移动了位置
from django.core.urlresolvers import reverse
改为
from django.urls import reverse
(5).django.contrib.auth里的视图做了变更
如果使用django auth里的login logout等视图,那么在url里原来你是这么写
from django.contrib.auth import views as django_auth_view
url(r'^logout/$', django_auth_view.logout,
现在改成
url(r'^logout/$', django_auth_view.LogoutView.as_view(),
另外如果使用了自定义模板,原来你是这么写的
url(r'^login/$',
auth_views.login,
{'template_name': 'registration/v2/login.html'},
name='login'),
现在要改成
url(r'^login/$',
auth_views.LoginView.as_view(template_name="registration/v2/login.html"),
name='login'),
(6) unquote 和quote 这是python范畴的,我也就写这了
# 过去
from urllib import unquote
# 现在
from urllib.parse import unquote
(7)自定义标签
# 过去
@register.assignment_tag
# 现在
@register.simple_tag
3.model变化
on_delete加入强制要求
升级完很多人会遇到这个错误
TypeError: __init__() missing 1 required positional argument: 'on_delete'
过去在model定义的时候OneToOneField和ForeignKey没有强制要求, 现在强制要求要加上on_delete属性.为了快速的解决问题,我全部加上了如下代码
on_delete=models.SET_NULL
# 相应的需要把 null=True 加上
其实项目本来就应该这样去设计,我们在设计数据库的时候就应该解耦去掉关联性,另外不要轻易的删除数据. 特别是在做微服务的时候,表与表之间最好零关联
4.djangorestframework
视图里的filter_backend
过去是
filter_backends = (filters.DjangoFilterBackend,)
现在filter做了变化
from django_filters.rest_framework.backends import DjangoFilterBackend
# 然后
filter_backends = (DjangoFilterBackend,)
如果在settings里设置了默认的filter,可以在ViewSet里省去此属性
