Python开发实践经验

这是我在公司项目中写下的约定, 该项目使用Python3开发, 分享出来, 希望对大家也会有一些帮助

  • 项目杜绝循环引用, 包之间的引用关系为(-> 表示被引用)

    models -> controllers -> application
       ^            ^
        \          / \
           utils       service
    
  • 包内相对引用,包外绝对引用

  • controllers, models, utils 都是 package ,使用 __all__ 来管控其下面的成员, 所有代码使用如下方式导入:

    from itachi.models import Base 而不是 from itachi.models.base import Base

    单元测试除外, 单元测试可能需要mock包内成员, 所以可能需要跳过 __all__ 的限制

  • 每个单元测试用例必须自己清理自己创建的数据

  • 单元测试必须继承 tests/base.py -> BaseCase, 使用 prehookposthook 替代 setUptearDown, 因为base中处理的app的context顺序会影响单元测试(因为这个项目用的是flask,所以这一点比较蛋疼)

  • 每次修改完数据库,必须显示commit session.commit()

  • 禁止使用 lazy import 这种方式来规避循环引用,正确的方式是合理的规划代码组织, 参见第一条

  • 推送使用接口来定义, 见 itachi/services/push/base.py, 由于python没有明确声明接口的方式, 所以还请人为遵守

  • 异步任务task应当是可重入的, 会配置为重试

  • 显示优于隐式, 所以不要用各种trick

  • requirements.txtrequirements-dev.txt 分别对应正式和开发环境的依赖, 其中后者仅包含前者的增量部分

  • 严禁for循环查数据库,请使用连表代替,连表时请把一次性能过滤最多的条件放在上面(即区分度最大的条件)

  • 请求第三方接口一定要设置超时

  • 使用Docker容器部署,必须设置CPU和内存上限,且不得与所在机器内存大小相同或非常接近.

  • 数据库(MySQL)使用 utf8mb4(而不是utf8)作为默认的字符集, 因为MySQL的utf8不是我们平日里所说的utf8,它只能利用 最多三个字节,因此无法使用存储emoji

目前发现的可以改善的地方

  • [x] session可以和request脱离,手动 session = Session() 而非 app.before_request

  • [ ] constants 可以使用 Enum


微信公众号
关注公众号,获得及时更新

更多文章
  • 服务器IP被ban学到的经验
  • socks5 协议详解
  • 开启HSTS(HTTP Strict Transport Security)
  • 网络乞讨之合并支付宝和微信的收款二维码
  • 从Chrome切换到Firefox
  • nomad简明教程
  • Linux下当笔记本合上盖子之后只使用扩展显示器
  • Ubuntu 18.04 dhcp更换新IP
  • Python中的新式类(new style class)和老式类(old style class)
  • Python Requests 简明教程
  • 密码技术简明教程(三):证书和TLS
  • 密码技术简明教程(二):散列、消息认证码和数字签名
  • SEO学习笔记
  • 密码技术简明教程(一):对称加密和非对称加密
  • Kubernetes 笔记