使用Python函数的轻量级流水线
项目描述
joblib的主页和用户文档位于
获取最新代码
要使用git获取最新代码,请输入
git clone https://github.com/joblib/joblib.git
如果您未安装git,可以下载最新代码的zip文件:https://github.com/joblib/joblib/archive/refs/heads/main.zip
安装
您可以使用pip来安装joblib
pip install joblib
在任何目录下或
python setup.py install
在源目录下。
依赖项
除了Python(支持版本为3.8+)外,joblib没有强制依赖项。
joblib对Numpy(至少版本1.6.1)有可选依赖,用于数组操作。
joblib包括用于进程管理的loky的源代码副本。
joblib可以高效地转储和加载numpy数组,但不需要安装numpy。
joblib有一个可选依赖项python-lz4,作为zlib和gzip的压缩序列化的更快的替代品。
joblib有一个可选依赖项psutil,用于缓解并行工作进程中的内存泄漏。
某些示例需要外部依赖项,如pandas。有关详细信息,请参阅构建文档部分的说明。
贡献流程
要为joblib做出贡献,首先在github上创建一个账户。完成后,将joblib存储库进行分叉以拥有自己的存储库,然后在您希望工作的计算机上使用‘git clone’克隆它。在您的克隆中做出更改,将其推送到您的github账户,在多台计算机上测试它们,当您对它们满意时,向主存储库发送拉取请求。
运行测试套件
要运行测试套件,您需要pytest(版本>= 3)和覆盖率模块。从项目根目录运行测试套件
pytest joblib
。
构建文档
要构建文档,您需要安装sphinx(>=1.4)和一些依赖项
pip install -U -r .readthedocs-requirements.txt
然后可以使用以下命令构建文档
make doc
HTML文档位于doc/_build/html目录。
创建源tar包
要创建源tar包,例如用于打包或分发,请运行以下命令
python setup.py sdist
tar包将创建在dist目录中。此命令将编译文档,生成的tar包可以不带额外依赖项(仅Python标准库)安装。您需要setuptool和sphinx。
发布版本并上传到PyPI
此命令仅由项目管理员运行,以创建版本并上传到PyPI
python setup.py sdist bdist_wheel twine upload dist/*
请注意,每次git推送时,文档应自动更新。如果不是这样,请尝试在本地构建文档并解决任何文档构建错误(尤其是运行示例时)。
更新变更日志
更改列在CHANGES.rst文件中。它们必须手动更新,但可以使用以下git命令生成行
git log --abbrev-commit --date=short --no-merges --sparse
项目详情
下载文件
下载适合您平台的文件。如果您不确定选择哪个,请了解更多关于 安装包 的信息。