init

Author: stacklens

.gitignore

@@ -0,0 +1,21 @@
+.idea/
+__pycache__/
+*.py[cod]
+*$py.class
+
+*.log
+local_settings.py
+db.sqlite3-journal
+
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+.idea/
+collectstatic/
+
+.DS_Store

drf_vue_blog/__init__.py

@@ -0,0 +1,16 @@
+"""
+ASGI config for drf_vue_blog project.
+
+It exposes the ASGI callable as a module-level variable named ``application``.
+
+For more information on this file, see
+https://docs.djangoproject.com/en/3.0/howto/deployment/asgi/
+"""
+
+import os
+
+from django.core.asgi import get_asgi_application
+
+os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'drf_vue_blog.settings')
+
+application = get_asgi_application()

drf_vue_blog/asgi.py

@@ -0,0 +1,123 @@
+"""
+Django settings for drf_vue_blog project.
+
+Generated by 'django-admin startproject' using Django 3.0.7.
+
+For more information on this file, see
+https://docs.djangoproject.com/en/3.0/topics/settings/
+
+For the full list of settings and their values, see
+https://docs.djangoproject.com/en/3.0/ref/settings/
+"""
+
+import os
+
+# Build paths inside the project like this: os.path.join(BASE_DIR, ...)
+BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+
+
+# Quick-start development settings - unsuitable for production
+# See https://docs.djangoproject.com/en/3.0/howto/deployment/checklist/
+
+# SECURITY WARNING: keep the secret key used in production secret!
+SECRET_KEY = '-1(gw4h!_=o2@@-3-p9jj62y=9k#*^3(5*!i-$yhblsckxw!=1'
+
+# SECURITY WARNING: don't run with debug turned on in production!
+DEBUG = True
+
+ALLOWED_HOSTS = []
+
+
+# Application definition
+
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+
+    'rest_framework',
+]
+
+MIDDLEWARE = [
+    'django.middleware.security.SecurityMiddleware',
+    'django.contrib.sessions.middleware.SessionMiddleware',
+    'django.middleware.common.CommonMiddleware',
+    'django.middleware.csrf.CsrfViewMiddleware',
+    'django.contrib.auth.middleware.AuthenticationMiddleware',
+    'django.contrib.messages.middleware.MessageMiddleware',
+    'django.middleware.clickjacking.XFrameOptionsMiddleware',
+]
+
+ROOT_URLCONF = 'drf_vue_blog.urls'
+
+TEMPLATES = [
+    {
+        'BACKEND': 'django.template.backends.django.DjangoTemplates',
+        'DIRS': [os.path.join(BASE_DIR, 'templates')]
+        ,
+        'APP_DIRS': True,
+        'OPTIONS': {
+            'context_processors': [
+                'django.template.context_processors.debug',
+                'django.template.context_processors.request',
+                'django.contrib.auth.context_processors.auth',
+                'django.contrib.messages.context_processors.messages',
+            ],
+        },
+    },
+]
+
+WSGI_APPLICATION = 'drf_vue_blog.wsgi.application'
+
+
+# Database
+# https://docs.djangoproject.com/en/3.0/ref/settings/#databases
+
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
+    }
+}
+
+
+# Password validation
+# https://docs.djangoproject.com/en/3.0/ref/settings/#auth-password-validators
+
+AUTH_PASSWORD_VALIDATORS = [
+    {
+        'NAME': 'django.contrib.auth.password_validation.UserAttributeSimilarityValidator',
+    },
+    {
+        'NAME': 'django.contrib.auth.password_validation.MinimumLengthValidator',
+    },
+    {
+        'NAME': 'django.contrib.auth.password_validation.CommonPasswordValidator',
+    },
+    {
+        'NAME': 'django.contrib.auth.password_validation.NumericPasswordValidator',
+    },
+]
+
+
+# Internationalization
+# https://docs.djangoproject.com/en/3.0/topics/i18n/
+
+LANGUAGE_CODE = 'en-us'
+
+TIME_ZONE = 'UTC'
+
+USE_I18N = True
+
+USE_L10N = True
+
+USE_TZ = True
+
+
+# Static files (CSS, JavaScript, Images)
+# https://docs.djangoproject.com/en/3.0/howto/static-files/
+
+STATIC_URL = '/static/'

drf_vue_blog/settings.py

@@ -0,0 +1,21 @@
+"""drf_vue_blog URL Configuration
+
+The `urlpatterns` list routes URLs to views. For more information please see:
+    https://docs.djangoproject.com/en/3.0/topics/http/urls/
+Examples:
+Function views
+    1. Add an import:  from my_app import views
+    2. Add a URL to urlpatterns:  path('', views.home, name='home')
+Class-based views
+    1. Add an import:  from other_app.views import Home
+    2. Add a URL to urlpatterns:  path('', Home.as_view(), name='home')
+Including another URLconf
+    1. Import the include() function: from django.urls import include, path
+    2. Add a URL to urlpatterns:  path('blog/', include('blog.urls'))
+"""
+from django.contrib import admin
+from django.urls import path
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+]

drf_vue_blog/urls.py

@@ -0,0 +1,16 @@
+"""
+WSGI config for drf_vue_blog project.
+
+It exposes the WSGI callable as a module-level variable named ``application``.
+
+For more information on this file, see
+https://docs.djangoproject.com/en/3.0/howto/deployment/wsgi/
+"""
+
+import os
+
+from django.core.wsgi import get_wsgi_application
+
+os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'drf_vue_blog.settings')
+
+application = get_wsgi_application()

drf_vue_blog/wsgi.py

@@ -0,0 +1,21 @@
+#!/usr/bin/env python
+"""Django's command-line utility for administrative tasks."""
+import os
+import sys
+
+
+def main():
+    os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'drf_vue_blog.settings')
+    try:
+        from django.core.management import execute_from_command_line
+    except ImportError as exc:
+        raise ImportError(
+            "Couldn't import Django. Are you sure it's installed and "
+            "available on your PYTHONPATH environment variable? Did you "
+            "forget to activate a virtual environment?"
+        ) from exc
+    execute_from_command_line(sys.argv)
+
+
+if __name__ == '__main__':
+    main()

manage.py

@@ -0,0 +1,163 @@
+已经掌握如何搭建 Django 项目的同学，请往下翻到 **drf 开发预备** 的小节开始阅读。
+
+## 教程的开发环境
+
+本教程的开发环境为：
+
+- **Win 10（64位）**
+- **Python 3.8.2**
+- **Django 3.0.7**
+
+为了避免开发环境不同而导致的错误，建议读者使用相同的版本。
+
+## 安装Python
+
+python的安装为比较简单，首先找到[Python官方网站](https://www.python.org/)，选择 python 3.8.2 的 windows 版本，下载并安装。
+
+**安装时注意勾选添加python到环境变量中。**如果没有或者漏掉这一步，请安装完毕后自行添加。
+
+安装完成后打开[命令行](https://jingyan.baidu.com/article/046a7b3e83a505f9c27fa9a2.html)，输入`python -V`，系统打印出python的版本号，说明安装成功了：
+
+```python
+C:\Users\dusai> python -V
+Python 3.8.2
+```
+
+## 配置虚拟环境
+
+**虚拟环境（virtualenv，或venv ）**是 Python 多版本管理的利器，可以使每个项目环境与其他项目独立开来，保持环境的干净，解决包冲突问题。你可以将虚拟环境理解为一个隔绝的小系统。
+
+**从 Python 3.3 版本开始就自带了虚拟环境，不需要安装，配置一下就可以用了。**
+
+新建一个文件夹，教程中为`drf`。进入此文件夹：
+
+```python
+E:\>cd drf
+E:\drf>
+```
+
+输入配置 venv 的命令，其中的`venv`为虚拟环境的目录：
+
+```
+E:\drf> python -m venv venv  
+```
+
+创建完成后，输入`venv\Scripts\activate.bat`，即可进入虚拟环境：
+
+```
+E:\drf> venv\Scripts\activate.bat
+(venv) E:\drf>
+```
+
+**盘符前有`(venv)`标识说明进入venv成功。**
+
+## 安装Django
+
+**在虚拟环境下**，输入命令 `pip install django==3.0.7`：
+
+```python
+(env) E:\drf> pip install django==3.0.7
+
+Collecting django==3.0.7
+  Using cached 
+  ...
+  ...
+Successfully installed django-3.0.7
+
+(env) E:\drf>
+```
+
+系统打印出以上文字表示Django安装成功了。
+
+> 由于国内复杂的网络环境， Pip 的下载可能非常缓慢甚至失败。国内用户请更换国内的镜像下载源，方法请自行了解。
+
+## 创建Django项目
+
+还是在**虚拟环境**下，在`drf`文件夹中创建Django项目：
+
+```
+(env) E:\drf> django-admin startproject drf_vue_blog
+```
+
+查看`drf`文件夹，发现多了`drf_vue_blog`文件夹，其结构应该是这样：
+
+```
+drf_vue_blog
+│  db.sqlite3
+│  manage.py
+│
+└─drf_vue_blog
+    │  settings.py
+    │  urls.py
+    │  wsgi.py
+    └─ __init__.py
+```
+
+这就是我们刚创建出来的项目了。
+
+## 运行Django服务器
+
+Django 自带一个轻量的 Web 开发服务器，也被叫做 runserver。
+
+开发服务器是为了让你快速开发Web程序，通过它可以避开配置生产环境的服务器的繁琐环节。
+
+开发服务器会自动的检测代码的改变，并且自动加载它，因此在修改代码后不需要手动去重启服务器，非常的方便。
+
+要运行这个服务器，首先要进入`drf_vue_blog`文件夹，即含有`manage.py`文件的那个：
+
+```
+(env) E:\drf> cd drf_vue_blog
+(env) E:\drf\drf_vue_blog>
+```
+
+输入命令`python manage.py runserver`：
+
+```
+(env) E:\drf\drf_vue_blog> python manage.py runserver
+Performing system checks...
+...
+Django version 3.0.7, using settings 'drf_vue_blog.settings'
+Starting development server at http://127.0.0.1:8000/
+Quit the server with CTRL-BREAK.
+```
+
+系统打印出这些信息，说明服务器启动成功了，打开chrome浏览器，输入http://127.0.0.1:8000/ ，网页中看到一个绿色的小火箭，恭喜你，项目已经正常运行了。
+
+## 代码编辑器
+
+django 运行起来后，我们还需要一款**代码编辑器**或者**集成开发环境（IDE）**来编辑python文件，以达到开发需求。
+
+市面上有很多Python的代码编辑器或者集成开发环境可以选择。
+
+新手我推荐 [Pycharm](https://www.jetbrains.com/pycharm/)，虽然第一次用时需要熟悉软件的使用方法，但是它提供的各项强大的功能，比如代码提示、拼写提示等，可以帮助你避免很多基本的错误（比如打错字）。
+
+如果你想要一个纯粹的文本编辑器，那么可以用 **Sublime Text 3**。它不是免费的，但是可以无限期试用，所以你不需要掏腰包。
+
+进入[Sublime Text 3官网](https://www.sublimetext.com/3)，下载对应版本的安装文件安装即可使用了。
+
+## 浏览器
+
+作为一个正经的 web 开发者，你的眼中应该只有[Chrome](https://www.google.com/chrome/)。
+
+## drf 开发预备
+
+学习 drf 需要以 Django 的基础知识作为支撑，因此下面关于 Django 基础部分就不会展开讲解了。如果你感觉下面的代码理解起来非常困难，磨刀不误砍柴工，那么建议先阅读我的 Django 基础教程：
+
+- [博客版](https://www.dusaiphoto.com/article/detail/2/)
+- [GitHub版](https://github.com/stacklens/django_blog_tutorial)
+
+首先安装 drf 及其扩展：
+
+```python
+pip install djangorestframework==3.11.0
+pip install markdown==3.2.2
+pip install django-filter==2.3.0
+```
+
+
+
+## 总结
+
+经过以上一番折腾，总算是把趁手的工具都准备齐了。
+
+准备好迎接正式的挑战吧。