Python/Django编程实践指南

2024-09-05 22:04

本文主要是介绍Python/Django编程实践指南,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

Python/Django编程实践指南

####Python/Django代码风格
PEP8是Python官方推荐的代码风格指南标准。

  • 使用4个空格作为缩进
  • 最外层函数和类使用两个空行分隔
  • 类中的方法使用一个空行分隔

PEP8建议按如下三种方式分组导入包

  • 标准库导入
  • 第三方相关包导入
  • 本地应用或库导入

比如:一个Django项目,包导入看起来应该是:

#标准库
from math import sqrt
from os.path import abspath#Django导入
from django.db import models
from django.utils.translation import ugettext_lazy as _#第三方应用导入
from django_extensions.db.models import TimeStampedModel#导入自己的应用
from splits.models import BananaSplit

(当然这里的注释只是对本例的说明,实际代码中并不需要写这些注释)

####使用相对导入
使用相对导入,更易于app的移植、重用、重命名。比如:下面的cones app,在view中使用硬编码使用cones 包,

# cones/views.py
# Hard coding of package name
from django.views.generic import CreateView
# DON’T DO THIS: Hardcoding of the 'cones' package
from cones.models import WaffleCone
from cones.forms import WaffleConeForm
class WaffleConeCreateView(CreateView):model = WaffleConeform_class = WaffleConeForm 
  • 现在假如你想在其他project重用这个cones app,但是刚好这个project中已经有一个叫cones 的app了,这样就会造成名字的冲突。
  • 如果想像把cones改名,你又得在多次更改cones。

推荐的方式应该是:

# cones/views.py
from django.views.generic import CreateView
# Hard coding of the 'cones' package
from .models import WaffleCone
from .forms import WaffleConeForm
class WaffleConeCreateView(CreateView):model = WaffleConeform_class = WaffleConeForm 

####避免使用 import *
在99%的情况下都因该明确import具体的模块名字

from django import forms
from django.db import models

绝对不要这样干:

from django.form import *
from django.db.models import *

不要这样做的原因是避免隐含的加载其他Python模块的locals把当前的模块的命名空间覆盖了。那样做可能导致不可预见性灾难。

比如Django Froms 和 Django Models 包中都含有一个类叫CharField,隐含地加载两个库,Models库将覆盖Forms版本的CharField。

#####Django风格
在URL pattern名字中使用下划线"_“而不是破折号”-",注意只是指的是url()的name参数,而不是真正的URL地址,破折号在URL没问题。
使用下划线而不是破折号在模版 block 名字中。

####Python/Django最佳环境配置
本地测试环境和线上生产环境使用同样的数据库
有些童鞋喜欢在本地用SQLite作为测试数据库,生产环境才使用正式的数据库如MySQL/PostgreSQL,然而不同的数据库有不同的数据类型和约束,很多问题一旦跑到线上问题就来了。

#####使用Pip 和 Virtualenv
Pip 是 python 包安装管理工具,比easy_install更强大。
Virtualenv是用来创建完全独立的、隔离的Python环境的工具,这就意味着你可以在A 项目中使用Django1.4,B项目中使用1.5成为可能,互不影响。Virtualenvwrapper如其名就像咖啡伴侣,它为virtualenv提供了更便捷的操作。

使用virtualenv激活某个虚拟环境:

source ~/.virtualenvs/myproject/bin/activate

而使用virtualenvwrapper可以简单为:

workon myproject

####使用版本控制系统
Git 和 Mercurial 是 Django开发中最流行的版本控制工具,它不仅能使用你在本地有一份拷贝,而且还能使用代码托管服务用来备份,更重要的是可以多人协助编程。推荐大家使用 GitHub 或者 Bitbucket,后者可以建立免费的私有仓库。

####Django项目代码布局
运行:

$ django-admin.py startproject mysite
$ cd mysite
$ django-admin.py startapp my_app

Django1.5的默认布局:

mysite/manage.pymy_app/__init__.pymodels.pytests.pyviews.pymysite/__init__.pysettings.pyurls.pywsgi.py    

比较常用的一种布局格式是:

gongshare_project/   #<repository_root>/.gitignoreMakefiledocs/requirements.txtgongshare/          #<django_project_root>/manage.pymedia/products/profiles/ratings/static/templates/gongshare/      #<configuration_root>/__init__.pysettings/urls.pywsgi.py

这是一个三层结构的布局:
顶层是仓库根目录,它包含了第二层目录外还包括一些如:README, doc/ 目录,.gitignorerequirements 文件。

第二层是django项目的根目录,这层是通过 django-admin.py startproject 命令生成的。这个目录包含了第三层目录外还有mdedia、static(css,js等)、templates(模版)目录和app目录(比如:profiles、ratings、products)

第三层同样是通过django-admin.py startproject 生成,除了一个基础的URLConf(urls.py)外还有settings模块,settings模块方式不同环境下的项目配置文件。

####配置文件和必要文件

  • 所有配置文件都应该有版本控制。
  • 遵循DRP原则

这篇关于Python/Django编程实践指南的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1140189

相关文章

Python并行处理实战之如何使用ProcessPoolExecutor加速计算

《Python并行处理实战之如何使用ProcessPoolExecutor加速计算》Python提供了多种并行处理的方式,其中concurrent.futures模块的ProcessPoolExecu... 目录简介完整代码示例代码解释1. 导入必要的模块2. 定义处理函数3. 主函数4. 生成数字列表5.

Python中help()和dir()函数的使用

《Python中help()和dir()函数的使用》我们经常需要查看某个对象(如模块、类、函数等)的属性和方法,Python提供了两个内置函数help()和dir(),它们可以帮助我们快速了解代... 目录1. 引言2. help() 函数2.1 作用2.2 使用方法2.3 示例(1) 查看内置函数的帮助(

Python虚拟环境与Conda使用指南分享

《Python虚拟环境与Conda使用指南分享》:本文主要介绍Python虚拟环境与Conda使用指南,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、python 虚拟环境概述1.1 什么是虚拟环境1.2 为什么需要虚拟环境二、Python 内置的虚拟环境工具

Python实例题之pygame开发打飞机游戏实例代码

《Python实例题之pygame开发打飞机游戏实例代码》对于python的学习者,能够写出一个飞机大战的程序代码,是不是感觉到非常的开心,:本文主要介绍Python实例题之pygame开发打飞机... 目录题目pygame-aircraft-game使用 Pygame 开发的打飞机游戏脚本代码解释初始化部

Python pip下载包及所有依赖到指定文件夹的步骤说明

《Pythonpip下载包及所有依赖到指定文件夹的步骤说明》为了方便开发和部署,我们常常需要将Python项目所依赖的第三方包导出到本地文件夹中,:本文主要介绍Pythonpip下载包及所有依... 目录步骤说明命令格式示例参数说明离线安装方法注意事项总结要使用pip下载包及其所有依赖到指定文件夹,请按照以

Python实现精准提取 PDF中的文本,表格与图片

《Python实现精准提取PDF中的文本,表格与图片》在实际的系统开发中,处理PDF文件不仅限于读取整页文本,还有提取文档中的表格数据,图片或特定区域的内容,下面我们来看看如何使用Python实... 目录安装 python 库提取 PDF 文本内容:获取整页文本与指定区域内容获取页面上的所有文本内容获取

基于Python实现一个Windows Tree命令工具

《基于Python实现一个WindowsTree命令工具》今天想要在Windows平台的CMD命令终端窗口中使用像Linux下的tree命令,打印一下目录结构层级树,然而还真有tree命令,但是发现... 目录引言实现代码使用说明可用选项示例用法功能特点添加到环境变量方法一:创建批处理文件并添加到PATH1

Python包管理工具核心指令uvx举例详细解析

《Python包管理工具核心指令uvx举例详细解析》:本文主要介绍Python包管理工具核心指令uvx的相关资料,uvx是uv工具链中用于临时运行Python命令行工具的高效执行器,依托Rust实... 目录一、uvx 的定位与核心功能二、uvx 的典型应用场景三、uvx 与传统工具对比四、uvx 的技术实

Python中使用uv创建环境及原理举例详解

《Python中使用uv创建环境及原理举例详解》uv是Astral团队开发的高性能Python工具,整合包管理、虚拟环境、Python版本控制等功能,:本文主要介绍Python中使用uv创建环境及... 目录一、uv工具简介核心特点:二、安装uv1. 通过pip安装2. 通过脚本安装验证安装:配置镜像源(可

python判断文件是否存在常用的几种方式

《python判断文件是否存在常用的几种方式》在Python中我们在读写文件之前,首先要做的事情就是判断文件是否存在,否则很容易发生错误的情况,:本文主要介绍python判断文件是否存在常用的几种... 目录1. 使用 os.path.exists()2. 使用 os.path.isfile()3. 使用