用途:这是 Scenescape 项目的 Python 编码规范,用于统一代码风格与工程约定。
主要能力与约定:导入按标准库、第三方、本地应用(scene_common、manager、controller 等)顺序组织;类用 PascalCase,函数与方法用 snake_case,常量用 UPPER_SNAKE_CASE,私有成员加单下划线前缀。缩进用 2 个空格(禁用制表符),行宽目标 100 字符、硬上限 120 字符,类与公共方法需写 docstring。
工具与命令:使用 pylint 和 flake8(两者都须通过),格式化用 autopep8,命令为 make lint-python、make format-python,缩进检查用 make indent-check。
框架与库模式:Django 模型从 scene_common 导入共享几何/相机类,列表存储用 manager.fields 的 ListField,并实现 str;视图用类视图与 @login_required,AJAX 返回 JsonResponse;DRF 接口使用 manager.serializers 序列化器与自定义权限。scene_common 提供 MQTT/PubSub、SchemaValidation、RESTClient 等。日志用 f-string,不用 printf 占位符。函数签名加类型提示,错误处理使用具体异常并记录日志。性能上避免不必要的深拷贝,优先列表推导。
环境与依赖:开发用项目根目录 .venv,命令为 python3 -m venv .venv、source .venv/bin/activate、pip install -r requirements-runtime.txt;运行时依赖写入 requirements-runtime.txt,构建依赖写入 requirements-build.txt,依赖变更后需重建 Docker 镜像。
限制:资料未提供具体版本要求、完整配置细节及适用范围之外的信息。