Python开发者们,虚拟环境的掌控者们,以及偶尔在凌晨3点吃披萨的夜猫子们!如果您想创建自己的私有Python包(谁不想体验一下成为包开发者的快感呢?),本文将手把手教您如何使用Poetry和pypiserver完成整个过程。最终,您不仅拥有了自己的私有包,还能在解决KeyError后收获满满的成就感。
什么是Poetry?(不是诗歌)
在您开始想象自己像月光下的诗人一样创作诗歌之前,让我澄清一下:这里的Poetry是一个用于管理Python项目的。它简化了依赖项管理、包版本控制和发布流程。可以把它想象成您Python项目的私人助理——它井然有序地管理一切,让您可以专注于编写代码(以及搜索Stack Overflow)。Poetry的关键特性包括:
- 依赖项管理:在一个地方指定、解析和管理项目的依赖项。
- 虚拟环境集成:自动为您的项目创建虚拟环境。
- 简化打包流程:以最小的努力构建和发布Python包——无需与setup.py苦战。
简单来说,Poetry就像一个总是保持桌面整洁并记得每个人生日的同事。
什么是pypiserver?(提示:这可不是什么甜点)
现在,让我们谈谈pypiserver:一个简单、轻量级的PyPI(Python包索引)服务器,您可以自己托管。要用它?也许您正在构建专有软件,或者只是想体验一下拥有私有包的乐趣。无论哪种方式,pypiserver都能让您安全地托管和分发自己的包,而无需依赖公共仓库,如PyPI。pypiserver的关键特性包括:
- 私有包托管:在本地或私有服务器上存储您的包。
- 轻量级:设置和资源使用最少,非常适合小型托管。
- 兼容性:与pip和其他Python工具无缝工作。
本质上,它就像运行您自己的私有PyPI,而无需服务器管理方面的专业知识。
为什么要创建私有包?
好问题!以下是一些常见原因:
- 您有不想与世界分享的专有代码。
- 您正在构建可在组织内部重复使用的模块。
- 您只想炫耀一下:“看,我有自己的PyPI服务器!”
现在我们已经掌握了基础知识,让我们开始创建私有包并在pypiserver上部署它吧!
步骤1:安装Poetry
首先,安装Poetry。如果您还没有安装,请运行以下命令:
curl -sSL https://install.python-poetry.org | python3 -
安装后,检查版本:
poetry --version
如果您看到类似Poetry 1.6.0的输出,恭喜您!如果没有,请仔细检查安装步骤。
步骤2:创建您的Python包
让我们创建一个私有包。在这个例子中,我们将创建一个名为my_private_package的包。运行以下命令:
poetry new my_private_package
这将创建一个新目录,其结构如下:
my_private_package/ ├── my_private_package/ │ └── __init__.py ├── tests/ │ └── __init__.py ├── pyproject.toml
pyproject.toml文件是Poetry的配置文件,定义了项目的所有信息,从依赖项到版本号。tests/目录是您编写测试的地方。
步骤3:编写一些代码
现在,让我们在包中添加一些代码。打开my_private_package/__init__.py并添加以下内容:
def greet(name: str) -> str: return f"Hello, {name}! Welcome to your private package."
很简单,但它能工作!
步骤4:构建包
要构建包,导航到项目的根目录并运行:
poetry build
这将创建一个dist/目录,其中包含.tar.gz和.whl文件。这些文件将上传到您的私有PyPI服务器。
步骤5:设置pypiserver
安装pypiserver:
pip install pypiserver
为您的包创建一个目录:
mkdir ~/private_packages
使用htpasswd添加安全性:创建一个用户并设置密码:
htpasswd -sc ~/private_packages/htpasswd.txt admin
启动服务器:
pypi-server run -p 8060 ~/private-packages -a ~/private-packages/htpasswd.txt --hash-algo=sha256
这将在端口8060启动服务器,您可以上传和分发该目录中的包。
步骤6:将您的包部署到pypiserver
回到my_private_package项目目录,在pyproject.toml中添加您的私有PyPI服务器:http://localhost:8060。
[[tool.poetry.source]] name = "treasure_chest" url = "http://localhost:8060/simple/" priority = "supplemental"
配置Poetry:
poetry config repositories.treasure_chest http://localhost:8060/ poetry config http-basic.treasure_chest admin "<your_password>"
上传包:
poetry publish --repository treasure_chest
这将把您的包上传到您的私有PyPI服务器。
步骤7:安装您的私有包
使用:
pip install --extra-index-url http://localhost:8060/simple/ my_private_package
或使用Poetry安装: (前提是您已在pyproject.toml中添加了私有PyPI服务器配置)
poetry add --source treasure_chest my_private_package
如果您看到my_private_package成功安装,恭喜您!您已经成功创建并部署了私有Python包。
总结
您已经成功地使用Poetry创建了一个私有Python包,并将其部署到pypiserver上。无论您是构建专有模块的帝国,还是只是想炫耀一下,您现在都有了工具!记住,能力越大,责任越大。明智地使用您的私有PyPI服务器,并且别忘了分享这篇文章!或者别分享——毕竟,这是您的秘密宝藏。
以上就是使用诗歌创建软件包,然后在私人PYPI服务器上部署的详细内容,更多请关注php中文网其它相关文章!