俄羅斯：將審查iPhone等外國公司設備 保數據安全
iPhone和特斯拉都屬于在各自領域領頭羊的品牌，推出的產品也也都是數一數二的，但對于一些國家而言，它們的產品可靠性和安全性還是在限制范圍內。近日，俄羅斯聯邦通信、信息技術
在Python的世界里，模塊化開發是提高代碼復用性和協作效率的關鍵。當你精心打造了一個功能完備、設計優雅的模塊，自然希望它不僅能服務于當前項目，還能在其他場景中大放異彩。這時，打包與分發你的模塊就顯得尤為重要。通過打包，你可以將模塊整理成符合標準的文件結構，方便他人安裝和使用。而分發，則能讓全世界的Python開發者在PyPI（Python Package Index）這樣的平臺上找到并下載你的模塊。
今天，我們就來學習如何使用Python中最常用的打包工具——setuptools，通過六個簡單步驟，讓你的模塊從本地走向世界！
setuptools是Python生態中用于創建和管理軟件包的神器。它提供了一套標準流程，幫助我們將源代碼、依賴項、文檔等打包成符合Python打包規范（如wheel或tar.gz格式）的文件。同時，setuptools還支持生成易于安裝的腳本，使得用戶只需一條簡單的命令，就能在自己的環境中安裝你的模塊。
(1) 創建項目目錄結構
首先，我們需要為模塊創建一個整潔的目錄結構。一個典型的Python打包項目通常包含如下部分：
your_package/├── your_package/│ ├── __init__.py│ └── your_code.py├── tests/│ ├── __init__.py│ └── test_your_code.py├── setup.py├── setup.cfg└── MANIFEST.in其中，your_package目錄存放你的模塊代碼，tests目錄存放單元測試代碼，setup.py是打包配置腳本，setup.cfg和MANIFEST.in用于輔助打包過程。
(2) 編寫setup.py文件
接下來，我們來編寫setup.py。這個腳本是setuptools的核心入口，定義了模塊的基本信息和打包規則。
from setuptools import setupsetup( name='your_package', # 模塊名稱 version='0.1.0', # 版本號 packages=['your_package'], # 包含的Python包 python_requires='>=3.9', # 支持的Python版本 install_requires=[], # 依賴的外部庫 author='Your Name', # 作者信息 author_email='you@example.com', description='A fantastic Python module!', # 簡短描述 long_description=open('README.md', 'r').read(), # 長描述（通常讀取自README文件） long_description_content_type='text/markdown', # 長描述類型 url='https://github.com/your_username/your_package', # 項目主頁 classifiers=[ # 項目分類標簽 'Programming Language :: Python :: 3', 'License :: OSI Approved :: MIT License', 'Operating System :: OS Independent', ],)(3) 解析setup()函數參數
上述setup()函數的參數意義如下：
(1) setup.cfg的作用與內容
setup.cfg是一個INI格式的配置文件，用于存儲一些常見且不太可能頻繁變動的設置。例如，我們可以將setup.py中的install_requires移到這里：
[options]install_requires = dependency1 >= 1.0 dependency2 == 2.5這樣做可以使setup.py更簡潔，也方便持續集成等自動化流程直接讀取依賴關系。
(2) MANIFEST.in的作用與示例配置
MANIFEST.in用于指定哪些非.py文件（如數據文件、LICENSE、README等）應包含在打包結果中。例如：
include README.mdinclude LICENSErecursive-include your_package/data *.csv這表示將README.md、LICENSE文件以及your_package/data目錄下所有的.csv文件納入打包范圍。
(1) 模塊代碼結構與規范
在your_package目錄下編寫你的模塊代碼。確保每個子模塊都有一個__init__.py文件，以便它們被視為Python包。遵循PEP8編碼規范，編寫清晰的函數和類，添加必要的文檔字符串。
(2) 編寫單元測試用例
在tests目錄下編寫單元測試，使用如unittest、pytest等測試框架。確保覆蓋模塊的主要功能，為用戶提供高質量、可信賴的代碼。
() 使用python setup.py sdist命令打包
在項目根目錄下執行：
python setup.py sdist這將生成一個.tar.gz文件（如dist/your_package-0.1.0.tar.gz），包含了項目的所有源碼、配置文件和指定的額外文件。
(2) 使用pip install dist/your_package.tar.gz安裝
在另一臺機器或虛擬環境中，通過以下命令安裝打包好的模塊：
pip install dist/your_package-0.1.0.tar.gz安裝成功后，即可在該環境中導入并使用你的模塊。
(1) 注冊PyPI賬號
訪問https://pypi.org/，使用郵箱注冊一個賬號。記住用戶名和密碼，后續會用到。
(2) 配置twine工具
twine是一個安全、便捷的Python包上傳工具。在終端中安裝：
pip install twine(3) 使用twine upload dist/*上傳包
登錄PyPI賬號后，回到項目根目錄，執行以下命令上傳打包好的模塊：
twine upload dist/*按照提示輸入PyPI用戶名和密碼（或使用API令牌）。上傳成功后，你的模塊就會出現在PyPI倉庫中，全球的Python開發者都可以通過pip install your_package來安裝它了！
恭喜你！通過以上六個步驟，你已經掌握了使用setuptools打包和分發Python模塊的全過程。繼續探索Python打包的更多高級特性，如 wheel 文件、版本控制、自動化部署等，讓你的模塊在開源社區中更具影響力。
本文鏈接：http://www.tebozhan.com/showinfo-26-86992-0.htmlPython打包，setuptools打包六步法
聲明：本網頁內容旨在傳播知識，若有侵權等問題請及時與本網聯系，我們將在第一時間刪除處理。郵件：2376512515@qq.com
上一篇： 使用 Google Wire 在 Go 中進行依賴注入
下一篇： 遞歸反轉句子：C# 編程技術探究
Copyright ? 2016-2023 天津谷騏科技有限公司 版權所有 sitemap.xml
違法及侵權請聯系：2376512515@qq.com 津ICP備18001702號
津公網安備 12010102000574號