偷偷摘套内射激情视频,久久精品99国产国产精,中文字幕无线乱码人妻,中文在线中文a,性爽19p

Python打包,setuptools打包六步法

開(kāi)發(fā) 前端
今天,我們就來(lái)學(xué)習(xí)如何使用Python中最常用的打包工具——setuptools,通過(guò)六個(gè)簡(jiǎn)單步驟,讓你的模塊從本地走向世界!

引言:為什么要學(xué)習(xí)Python模塊打包與分發(fā)

在Python的世界里,模塊化開(kāi)發(fā)是提高代碼復(fù)用性和協(xié)作效率的關(guān)鍵。當(dāng)你精心打造了一個(gè)功能完備、設(shè)計(jì)優(yōu)雅的模塊,自然希望它不僅能服務(wù)于當(dāng)前項(xiàng)目,還能在其他場(chǎng)景中大放異彩。這時(shí),打包與分發(fā)你的模塊就顯得尤為重要。通過(guò)打包,你可以將模塊整理成符合標(biāo)準(zhǔn)的文件結(jié)構(gòu),方便他人安裝和使用。而分發(fā),則能讓全世界的Python開(kāi)發(fā)者在PyPI(Python Package Index)這樣的平臺(tái)上找到并下載你的模塊。

今天,我們就來(lái)學(xué)習(xí)如何使用Python中最常用的打包工具——setuptools,通過(guò)六個(gè)簡(jiǎn)單步驟,讓你的模塊從本地走向世界!

第一步:理解setuptools及其作用

setuptools是Python生態(tài)中用于創(chuàng)建和管理軟件包的神器。它提供了一套標(biāo)準(zhǔn)流程,幫助我們將源代碼、依賴項(xiàng)、文檔等打包成符合Python打包規(guī)范(如wheel或tar.gz格式)的文件。同時(shí),setuptools還支持生成易于安裝的腳本,使得用戶只需一條簡(jiǎn)單的命令,就能在自己的環(huán)境中安裝你的模塊。

第二步:初始化項(xiàng)目與編寫setup.py

(1) 創(chuàng)建項(xiàng)目目錄結(jié)構(gòu)

首先,我們需要為模塊創(chuàng)建一個(gè)整潔的目錄結(jié)構(gòu)。一個(gè)典型的Python打包項(xiàng)目通常包含如下部分:

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目錄存放單元測(cè)試代碼,setup.py是打包配置腳本,setup.cfg和MANIFEST.in用于輔助打包過(guò)程。

(2) 編寫setup.py文件

接下來(lái),我們來(lái)編寫setup.py。這個(gè)腳本是setuptools的核心入口,定義了模塊的基本信息和打包規(guī)則。

from setuptools import setup

setup(
    name='your_package',  # 模塊名稱
    version='0.1.0',      # 版本號(hào)
    packages=['your_package'],  # 包含的Python包
    python_requires='>=3.9',  # 支持的Python版本
    install_requires=[],  # 依賴的外部庫(kù)
    author='Your Name',  # 作者信息
    author_email='you@example.com',
    description='A fantastic Python module!',  # 簡(jiǎn)短描述
    long_description=open('README.md', 'r').read(),  # 長(zhǎng)描述(通常讀取自README文件)
    long_description_content_type='text/markdown',  # 長(zhǎng)描述類型
    url='https://github.com/your_username/your_package',  # 項(xiàng)目主頁(yè)
    classifiers=[  # 項(xiàng)目分類標(biāo)簽
        'Programming Language :: Python :: 3',
        'License :: OSI Approved :: MIT License',
        'Operating System :: OS Independent',
    ],
)

(3) 解析setup()函數(shù)參數(shù)

上述setup()函數(shù)的參數(shù)意義如下:

  • name:模塊的名稱,應(yīng)遵循PEP8命名規(guī)范。
  • version:模塊的版本號(hào),遵循語(yǔ)義化版本控制規(guī)范(如1.2.3)。
  • packages:包含的Python包列表,這里指your_package目錄。
  • python_requires:模塊支持的Python版本范圍。
  • install_requires:模塊運(yùn)行所需的外部庫(kù)列表,以字符串形式給出。
  • author、author_email:作者信息。
  • description:簡(jiǎn)短的模塊描述,展示在PyPI頁(yè)面上。
  • long_description、long_description_content_type:詳細(xì)的模塊介紹,通常從README文件讀取。內(nèi)容類型標(biāo)明為Markdown。
  • url:項(xiàng)目的GitHub或其他托管平臺(tái)鏈接。
  • classifiers:模塊所屬的類別和標(biāo)簽,便于在PyPI上搜索和篩選。

第三步:定義setup.cfg與MANIFEST.in

(1) setup.cfg的作用與內(nèi)容

setup.cfg是一個(gè)INI格式的配置文件,用于存儲(chǔ)一些常見(jiàn)且不太可能頻繁變動(dòng)的設(shè)置。例如,我們可以將setup.py中的install_requires移到這里:

[options]
install_requires =
    dependency1 >= 1.0
    dependency2 == 2.5

這樣做可以使setup.py更簡(jiǎn)潔,也方便持續(xù)集成等自動(dòng)化流程直接讀取依賴關(guān)系。

(2) MANIFEST.in的作用與示例配置

MANIFEST.in用于指定哪些非.py文件(如數(shù)據(jù)文件、LICENSE、README等)應(yīng)包含在打包結(jié)果中。例如:

include README.md
include LICENSE
recursive-include your_package/data *.csv

這表示將README.md、LICENSE文件以及your_package/data目錄下所有的.csv文件納入打包范圍。

第四步:編寫模塊與測(cè)試代碼

(1) 模塊代碼結(jié)構(gòu)與規(guī)范

在your_package目錄下編寫你的模塊代碼。確保每個(gè)子模塊都有一個(gè)__init__.py文件,以便它們被視為Python包。遵循PEP8編碼規(guī)范,編寫清晰的函數(shù)和類,添加必要的文檔字符串。

(2) 編寫單元測(cè)試用例

在tests目錄下編寫單元測(cè)試,使用如unittest、pytest等測(cè)試框架。確保覆蓋模塊的主要功能,為用戶提供高質(zhì)量、可信賴的代碼。

第五步:打包與安裝

() 使用python setup.py sdist命令打包

在項(xiàng)目根目錄下執(zhí)行:

python setup.py sdist

這將生成一個(gè).tar.gz文件(如dist/your_package-0.1.0.tar.gz),包含了項(xiàng)目的所有源碼、配置文件和指定的額外文件。

(2) 使用pip install dist/your_package.tar.gz安裝

在另一臺(tái)機(jī)器或虛擬環(huán)境中,通過(guò)以下命令安裝打包好的模塊:

pip install dist/your_package-0.1.0.tar.gz

安裝成功后,即可在該環(huán)境中導(dǎo)入并使用你的模塊。

第六步:發(fā)布到PyPI

(1) 注冊(cè)PyPI賬號(hào)

訪問(wèn)https://pypi.org/,使用郵箱注冊(cè)一個(gè)賬號(hào)。記住用戶名和密碼,后續(xù)會(huì)用到。

(2) 配置twine工具

twine是一個(gè)安全、便捷的Python包上傳工具。在終端中安裝:

pip install twine

(3) 使用twine upload dist/*上傳包

登錄PyPI賬號(hào)后,回到項(xiàng)目根目錄,執(zhí)行以下命令上傳打包好的模塊:

twine upload dist/*

按照提示輸入PyPI用戶名和密碼(或使用API令牌)。上傳成功后,你的模塊就會(huì)出現(xiàn)在PyPI倉(cāng)庫(kù)中,全球的Python開(kāi)發(fā)者都可以通過(guò)pip install your_package來(lái)安裝它了!

結(jié)語(yǔ):總結(jié)與進(jìn)階學(xué)習(xí)建議

恭喜你!通過(guò)以上六個(gè)步驟,你已經(jīng)掌握了使用setuptools打包和分發(fā)Python模塊的全過(guò)程。繼續(xù)探索Python打包的更多高級(jí)特性,如 wheel 文件、版本控制、自動(dòng)化部署等,讓你的模塊在開(kāi)源社區(qū)中更具影響力。

責(zé)任編輯:趙寧寧 來(lái)源: 手把手PythonAI編程
相關(guān)推薦

2009-09-09 09:46:00

MyEclipse配置

2010-07-09 12:08:36

設(shè)置SNMP協(xié)議

2010-02-22 09:38:22

WCF開(kāi)發(fā)

2013-08-23 09:30:56

BYOD方案BYODMDM

2010-11-19 10:18:11

網(wǎng)絡(luò)連接故障

2009-10-27 17:40:35

Oracle表空間狀態(tài)

2010-06-29 19:23:20

UML活動(dòng)圖

2011-03-03 10:55:07

2009-12-11 13:31:31

策略路由配置

2011-07-30 13:28:03

2021-09-04 23:27:58

Axios源碼流程

2020-11-02 10:51:17

Express源碼Web

2010-09-13 10:39:43

CSSCSS文件

2023-04-11 11:22:13

2020-01-19 11:10:44

機(jī)器學(xué)習(xí)人工智能數(shù)據(jù)科學(xué)

2009-02-06 13:01:00

綠色數(shù)據(jù)中心數(shù)據(jù)中心

2010-06-09 17:58:14

UML活動(dòng)圖

2012-03-29 09:50:17

2012-03-09 15:32:48

華為管理服務(wù)

2022-05-10 11:31:44

經(jīng)營(yíng)分析財(cái)務(wù)指標(biāo)
點(diǎn)贊
收藏

51CTO技術(shù)棧公眾號(hào)