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。如果您还没有安装，请运行以下命令：
<code class="bash">curl -sSL https://install.python-poetry.org | python3 -</code>
安装后，检查版本：
<code class="bash">poetry --version</code>
如果您看到类似Poetry 1.6.0的输出，恭喜您！如果没有，请仔细检查安装步骤。
步骤2：创建您的Python包
让我们创建一个私有包。在这个例子中，我们将创建一个名为my_private_package的包。运行以下命令：
<code class="bash">poetry new my_private_package</code>
这将创建一个新目录，其结构如下：
<code>my_private_package/ ├── my_private_package/ │ └── __init__.py ├── tests/ │ └── __init__.py ├── pyproject.toml</code>
pyproject.toml文件是Poetry的配置文件，定义了项目的所有信息，从依赖项到版本号。tests/目录是您编写测试的地方。
步骤3：编写一些代码
现在，让我们在包中添加一些代码。打开my_private_package/__init__.py并添加以下内容：
<code class="python">def greet(name: str) -> str:
return f"Hello, {name}! Welcome to your private package."</code>
很简单，但它能工作！
步骤4：构建包
要构建包，导航到项目的根目录并运行：
<code class="bash">poetry build</code>
这将创建一个dist/目录，其中包含.tar.gz和.whl文件。这些文件将上传到您的私有PyPI服务器。
步骤5：设置pypiserver
安装pypiserver：
<code class="bash">pip install pypiserver</code>
为您的包创建一个目录：
<code class="bash">mkdir ~/private_packages</code>
使用htpasswd添加安全性：创建一个用户并设置密码：
<code class="bash">htpasswd -sc ~/private_packages/htpasswd.txt admin</code>
启动服务器：
<code class="bash">pypi-server run -p 8060 ~/private-packages -a ~/private-packages/htpasswd.txt --hash-algo=sha256</code>
这将在端口8060启动服务器，您可以上传和分发该目录中的包。
步骤6：将您的包部署到pypiserver
回到my_private_package项目目录，在pyproject.toml中添加您的私有PyPI服务器：http://localhost:8060。
<code class="toml">[[tool.poetry.source]] name = "treasure_chest" url = "http://localhost:8060/simple/" priority = "supplemental"</code>
配置Poetry：
<code class="bash">poetry config repositories.treasure_chest http://localhost:8060/ poetry config http-basic.treasure_chest admin "<your_password>"</code>
上传包：
<code class="bash">poetry publish --repository treasure_chest</code>
这将把您的包上传到您的私有PyPI服务器。
步骤7：安装您的私有包
使用pip安装：
<code class="bash">pip install --extra-index-url http://localhost:8060/simple/ my_private_package</code>
或使用Poetry安装： (前提是您已在pyproject.toml中添加了私有PyPI服务器配置)
<code class="bash">poetry add --source treasure_chest my_private_package</code>
如果您看到my_private_package成功安装，恭喜您！您已经成功创建并部署了私有Python包。
总结
您已经成功地使用Poetry创建了一个私有Python包，并将其部署到pypiserver上。无论您是构建专有模块的帝国，还是只是想炫耀一下，您现在都有了工具！记住，能力越大，责任越大。明智地使用您的私有PyPI服务器，并且别忘了分享这篇文章！或者别分享——毕竟，这是您的秘密宝藏。
