make link
进入对应目录,使用 poetry 安装依赖
cd api/
poetry install本地开发需要创建两个文件:
bkuser_core/config/common/.env
bkuser_core/config/overlays/dev.py
前者包含了项目启动的必须环境变量,我们已经默认为你创建了一个示例 .env-tmpl,它可能不能直接用于你的本地环境,你需要自行修改其中某些值(相信我,很简单的)。
后者我们同样提供了一个 dev.tmpl,你需要阅读它,并创建属于自己的 dev.py。
由于 dev.py 已经被添加到了 .gitignore,所以它不会被提交到版本仓库(也不应该)。
进入对应目录,启动测试脚本
bin/start_dev.sh
# 如果需要测试后台相关功能
bin/start_celery.sh
bin/start_beat.sh当项目运行起来之后,访问 /redoc 或 /swagger 路径获得所有 API 的详细说明。
同时当你修改了对应代码后,请运行 make generate-sdk 生成新的 SDK 文件,保证 SaaS 调用正常。
你需要确保在 dev.py 中已添加 LDAP mock 配置
LDAP_CONNECTION_EXTRAS_PARAMS = {"client_strategy": ldap3.MOCK_SYNC}运行单元测试
pytest bkuser_core/tests --disable-pytest-warnings --reuse-db针对数据同步和登陆,目录提供了一个插件能力,可以接受按照一定协议的用户自定义插件,具体内容请查阅 数据源插件开发
每次添加新的字符串提示后,需要生成新的 .po 文件
python manage.py makemessages --all修改 .po 文件内的翻译内容后,编译 .mo
python manage.py compilemessages -l en
python manage.py compilemessages -l zh-hans