一、注冊一個 PyPI 賬號
如果還沒有在 PyPI 上注冊賬號,需要先注冊一個賬號。PyPI 官方網站:https://pypi.org/
二、創(chuàng)建和配置setup.py文件
在代碼文件夾中創(chuàng)建一個名為 setup.py 的文件。
setup.py 文件是用于定義庫的元數(shù)據(jù)和依賴項的腳本。
在setup.py 文件中,需要提供一些信息,如庫的名稱、版本、作者、描述、依賴項等。
以下是一個示例 setup.py 文件的模板:
from setuptools import setup
setup(
name='your-library-name',
version='1.0.0',
author='Your Name',
author_email='your-email@example.com',
description='A description of your library',
packages=['your_library_package'],
install_requires=[
'dependency1',
'dependency2',
],
)
我們可以根據(jù)實際情況修改以上模板中的信息。
三、打包庫
在命令行中進入庫代碼文件夾,并運行以下命令來打包庫:
python setup.py sdist bdist_wheel
這將生成一個 dist 文件夾,其中包含我們的庫的打包文件。
第一次執(zhí)行,可能會報如下錯:
error: invalid command 'bdist_wheel'
這個錯誤通常是因為沒有安裝wheel模塊。
bdist_wheel命令是用來創(chuàng)建wheel格式的庫文件的,而wheel模塊是用來支持wheel格式的庫文件的創(chuàng)建和安裝的。
可以通過以下命令安裝wheel模塊:
pip install wheel
安裝完成后,再次運行python setup.py sdist bdist_wheel就不會報錯了。
四、上傳至PyPI
使用 twine 工具將庫上傳到 PyPI。
如果是第一次使用,可以在命令行中運行以下命令來安裝 twine:
pip install twine
然后,進入 dist 文件夾,并運行以下命令來上傳庫:
twine upload dist/*
這將會將我們的庫發(fā)布到 PyPI 上,供其他人使用和安裝。
五、安裝和使用
其他人現(xiàn)在可以通過 pip install 命令來安裝你的庫。他們只需要運行以下命令:
pip install your-library-name
就可以在自己的項目中導入和使用我們的庫了。
如果是在pycharm
關于緩存更新的時效性
通常來說,PyPI 的同步時間是相對較短的,可能只需要幾分鐘到幾小時的時間。但是,由于網絡和服務器負載等因素的影響,有時同步可能需要更長的時間。
如果在發(fā)布后的一段時間內發(fā)現(xiàn)的庫在某些鏡像服務器上還不可見,可以耐心等待一段時間,或者嘗試刷新鏡像服務器緩存。