How-To-Build-Your-Own-Library
本库由在 3.15.0 版本之后由 poetry 改为 uv 管理和构建,任何修改本库后自定义打包等需求请以 uv 官方文档为准。
前言
本库是把 Scrapy 的一些常用功能(扩展功能和开发中常用方法)封装成了一个库,方便大家快速使用。
但在使用本库的过程中,你可能会遇到一些问题:
比如模板中某些配置不符合你的项目需求;
不喜欢项目结构的设计;
依赖库的版本不适合你的需求。
像这些可能包含非常个性化的定制,无法适配所有人的喜好,也无法通过 Pull Requests 合并来优雅地解决此类问题,这时候你可能会想要修改一些东西,那么你可以参考本文档,来快速构建你自己的专属库。
构建方法
你可以 clone 源码后,修改任意方法,修改完成后 make build 即可打包并内部使用。
具体的构建流程如下:
Prepare: clone 项目并准备开发环境
将项目克隆到本地,配置好 uv 工具,然后在项目根目录运行 make start 即可初始化项目开发环境。
Make your changes: 自定义更改的内容
修改你所关注的部分,比如你的项目场景下可能需要其它的日志配置默认值,或添加其它的项目结构模板,更改库名等。
Run tests & Rebuild: 测试功能并重打包
- 修改完毕并测试可用后,即可通过 make build 打包即可使用。当然使用其他方式也都是可以的,比如:
python -m build 或 uv build。
补充
若你自定义的方法对大多数人都合适的话,可以尝试将此功能添加到本项目,但是在此之前请先提交相关的 ISSUES 确认可行后再开发和提交对应 PULL REQUESTS,以免浪费了你做出的贡献。