"""

这里案例项目名叫luffy

为luffy项目创建一个虚拟环境

>: mkvirtualenv luffy

"""

"""

按装基础环境依赖(在cmd中执行)

>: pip install django==2.0.7

>: pip install djangorestframework

>: pip install pymysql

"""

"""

1.一般会为项目创建一个文件夹:

>:cd Desktop  # 切到桌面

>:mkdir luffy  # 在桌面创建存放项目的文件夹

2.进入项目文件夹

>: cd luffy

3.在项目文件夹下创建项目,这里项目名叫luffyapi

>: django-admin startproject luffyapi

开发：用pycharm打开项目，并选择提前备好的虚拟环境

"""

"""

├── luffyapi

    ├── logs/                # 项目运行时/开发时日志目录 - 文件夹

    ├── manage.py            # 脚本文件

    ├── luffyapi/              # 项目主应用，开发时的代码保存 - 包

        ├── apps/              # 开发者的代码保存目录，以模块[子应用]为目录保存 - 包

        ├── libs/              # 第三方类库的保存目录[第三方组件、模块] - 包

        ├── settings/          # 配置目录 - 包

            ├── dev.py       # 项目开发时的本地配置

            └── prod.py      # 项目上线时的运行配置

        ├── urls.py            # 总路由

        └── utils/             # 多个模块[子应用]的公共函数类库[自己开发的组件]

    └── scripts/               # 保存项目运营时的脚本文件 - 文件夹

"""

"""

1.修改 wsgi.py 与 manage.py 两个文件：

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'luffyapi.settings.dev')

2.将settings.py删除或改名，内容拷贝到settings/dev.py中

3.修改dev.py文件内容

LANGUAGE_CODE = 'zh-hans'

TIME_ZONE = 'Asia/Shanghai'

USE_TZ = False

4.修改启动配置：见下面插图

5.测试测试默认配置文件是否是dev.py文件:

    - 方法1:在任何一个__init__.py文件中测试默认配置文件是否是dev.py文件

from django.conf import settings

print(settings)

    - 方法2:在测试文件夹 scripts中创建t_dg.py测试文件(详情测试代码见下方)

"""

import os, django

os.environ.setdefault("DJANGO_SETTINGS_MODULE", "luffyapi.settings.dev")

django.setup()

from django.conf import settings

print(settings) # <Settings "luffyapi.settings.dev">  成功配置

LOGGING = {

    'version': 1,

    'disable_existing_loggers': False,

    'formatters': {

        'verbose': {

            'format': '%(levelname)s %(asctime)s %(module)s %(lineno)d %(message)s'

        },

        'simple': {

            'format': '%(levelname)s %(module)s %(lineno)d %(message)s'

        },

    },

    'filters': {

        'require_debug_true': {

            '()': 'django.utils.log.RequireDebugTrue',

        },

    },

    'handlers': {

        'console': {

            'level': 'DEBUG',

            'filters': ['require_debug_true'],

            'class': 'logging.StreamHandler',

            'formatter': 'simple'

        },

        'file': {

            # 实际开发建议使用WARNING

            'level': 'INFO',

            'class': 'logging.handlers.RotatingFileHandler',

            # 日志位置,日志文件名,日志保存目录必须手动创建，注：这里的文件路径要注意BASE_DIR代表的是小luffyapi

            'filename': os.path.join(os.path.dirname(BASE_DIR), "logs", "luffy.log"),

            # 日志文件的最大值,这里我们设置300M

            'maxBytes': 300 * 1024 * 1024,

            # 日志文件的数量,设置最大日志数量为10

            'backupCount': 10,

            # 日志格式:详细格式

            'formatter': 'verbose',

            # 文件内容编码

            'encoding': 'utf-8'

        },

    },

    # 日志对象

    'loggers': {

        'django': {

            'handlers': ['console', 'file'],

            'propagate': True, # 是否让日志信息继续冒泡给其他的日志处理系统

        },

    }

}

# 环境变量操作：小luffyapi BASE_DIR与apps文件夹都要添加到环境变量

import sys

sys.path.insert(0, BASE_DIR)

APPS_DIR = os.path.join(BASE_DIR, 'apps')  # 拿到apps的绝对路径

sys.path.insert(1, APPS_DIR)

import logging

logger = logging.getLogger('django')

from rest_framework.views import exception_handler as drf_exception_handler

from rest_framework.views import Response

from rest_framework import status

from utils.logging import logger

def exception_handler(exc, context):

    response = drf_exception_handler(exc, context)

    if response is None:

        logger.error('%s - %s - %s' % (context['view'], context['request'].method, exc))

        return Response({

            'detail': '服务器错误'

        }, status=status.HTTP_500_INTERNAL_SERVER_ERROR, exception=True)

    return response

REST_FRAMEWORK = {

    # 异常配置

    'EXCEPTION_HANDLER': 'utils.exception.exception_handler',

}

from rest_framework.response import Response

class APIResponse(Response):

    def __init__(self, data_status=0, data_msg='ok', results=None, http_status=None, headers=None, exception=False, **kwargs):

        data = {

            'status': data_status,

            'msg': data_msg,

        }

        if results is not None:

            data['results'] = results

        data.update(kwargs)

        super().__init__(data=data, status=http_status, headers=headers, exception=exception)