{"id":1182182,"date":"2025-01-15T19:00:17","date_gmt":"2025-01-15T11:00:17","guid":{"rendered":"https:\/\/docs.pingcode.com\/ask\/ask-ask\/1182182.html"},"modified":"2025-01-15T19:00:19","modified_gmt":"2025-01-15T11:00:19","slug":"python%e5%a6%82%e4%bd%95%e5%bb%ba%e7%ab%8b%e8%bd%af%e4%bb%b6%e5%8c%85","status":"publish","type":"post","link":"https:\/\/docs.pingcode.com\/ask\/1182182.html","title":{"rendered":"python\u5982\u4f55\u5efa\u7acb\u8f6f\u4ef6\u5305"},"content":{"rendered":"

\"python\u5982\u4f55\u5efa\u7acb\u8f6f\u4ef6\u5305\"<\/p>\n

Python\u5efa\u7acb\u8f6f\u4ef6\u5305\u7684\u4e3b\u8981\u6b65\u9aa4\u5305\u62ec\u521b\u5efa\u9879\u76ee\u76ee\u5f55\u3001\u7f16\u5199\u4ee3\u7801\u3001\u6dfb\u52a0\u5fc5\u8981\u7684\u914d\u7f6e\u6587\u4ef6\u3001\u7f16\u5199\u6d4b\u8bd5\u3001\u751f\u6210\u5206\u53d1\u5305\u548c\u53d1\u5e03\u5230PyPI\u7b49\u3002<\/strong>\u4e0b\u9762\u8be6\u7ec6\u4ecb\u7ecd\u8fd9\u4e9b\u6b65\u9aa4\uff1a<\/p>\n<\/p>\n

\u4e00\u3001\u521b\u5efa\u9879\u76ee\u76ee\u5f55<\/h3>\n<\/p>\n

\u9996\u5148\uff0c\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u9879\u76ee\u76ee\u5f55\u5e76\u8fdb\u5165\u8be5\u76ee\u5f55\u3002\u8fd9\u4e2a\u76ee\u5f55\u5c06\u5305\u542b\u4f60\u7684\u5305\u7684\u6240\u6709\u6587\u4ef6\u3002<\/p>\n<\/p>\n

mkdir my_package<\/p>\n
cd my_package<\/p>\n
<\/code><\/pre>\n<\/p>\n
\u5728\u8fd9\u4e2a\u76ee\u5f55\u4e0b\u521b\u5efa\u4e00\u4e2a\u5b50\u76ee\u5f55\uff0c\u7528\u4e8e\u5b58\u653e\u4f60\u7684\u5305\u7684\u4ee3\u7801\uff1a<\/p>\n<\/p>\n
mkdir my_package<\/p>\n
<\/code><\/pre>\n<\/p>\n
\u4e8c\u3001\u7f16\u5199\u4ee3\u7801<\/h3>\n<\/p>\n
\u5728\u5305\u7684\u76ee\u5f55\u4e0b\u521b\u5efa\u4e00\u4e2a__init__.py<\/code>\u6587\u4ef6\uff0c\u8fd9\u4e2a\u6587\u4ef6\u53ef\u4ee5\u662f\u7a7a\u7684\uff0c\u4f46\u5b83\u7684\u5b58\u5728\u544a\u8bc9Python\u8fd9\u4e2a\u76ee\u5f55\u5e94\u8be5\u88ab\u89c6\u4e3a\u4e00\u4e2a\u5305\u3002<\/p>\n<\/p>\n
touch my_package\/__init__.py<\/p>\n
<\/code><\/pre>\n<\/p>\n
\u7136\u540e\uff0c\u4f60\u53ef\u4ee5\u5728\u8fd9\u4e2a\u76ee\u5f55\u4e2d\u6dfb\u52a0\u4f60\u7684\u6a21\u5757\u3002\u4f8b\u5982\uff0c\u521b\u5efa\u4e00\u4e2a\u540d\u4e3amodule.py<\/code>\u7684\u6587\u4ef6\uff1a<\/p>\n<\/p>\n
# my_package\/module.py<\/p>\n
def hello():<\/p>\n
    print("Hello, world!")<\/p>\n
<\/code><\/pre>\n<\/p>\n
\u4e09\u3001\u6dfb\u52a0\u5fc5\u8981\u7684\u914d\u7f6e\u6587\u4ef6<\/h3>\n<\/p>\n
1. setup.py<\/code><\/h4>\n<\/p>\n
\u8fd9\u662f\u6700\u91cd\u8981\u7684\u914d\u7f6e\u6587\u4ef6\uff0c\u5b83\u5305\u542b\u4e86\u5173\u4e8e\u4f60\u7684\u5305\u7684\u6240\u6709\u4fe1\u606f\u3002\u521b\u5efa\u4e00\u4e2asetup.py<\/code>\u6587\u4ef6\uff0c\u5e76\u6dfb\u52a0\u4ee5\u4e0b\u5185\u5bb9\uff1a<\/p>\n<\/p>\n
from setuptools import setup, find_packages<\/p>\n
setup(<\/p>\n
    name="my_package",<\/p>\n
    version="0.1.0",<\/p>\n
    packages=find_packages(),<\/p>\n
    install_requires=[<\/p>\n
        # \u5728\u8fd9\u91cc\u5217\u51fa\u4f60\u7684\u4f9d\u8d56\u5305<\/p>\n
    ],<\/p>\n
    entry_points={<\/p>\n
        'console_scripts': [<\/p>\n
            # \u5728\u8fd9\u91cc\u5b9a\u4e49\u4f60\u7684\u547d\u4ee4\u884c\u5de5\u5177<\/p>\n
        ],<\/p>\n
    },<\/p>\n
    author="\u4f60\u7684\u540d\u5b57",<\/p>\n
    author_emAI<\/a>l="\u4f60\u7684\u90ae\u7bb1",<\/p>\n
    description="\u8fd9\u662f\u4e00\u4e2a\u793a\u4f8bPython\u5305",<\/p>\n
    long_description=open('README.md').read(),<\/p>\n
    long_description_content_type='text\/markdown',<\/p>\n
    url="https:\/\/github.com\/\u4f60\u7684\u7528\u6237\u540d\/\u4f60\u7684\u4ed3\u5e93\u540d",<\/p>\n
    classifiers=[<\/p>\n
        "Programming Language :: Python :: 3",<\/p>\n
        "License :: OSI Approved :: MIT License",<\/p>\n
        "Operating System :: OS Independent",<\/p>\n
    ],<\/p>\n
    python_requires='>=3.6',<\/p>\n
)<\/p>\n
<\/code><\/pre>\n<\/p>\n
2. README.md<\/code><\/h4>\n<\/p>\n
\u8fd9\u662f\u4f60\u7684\u5305\u7684\u8bf4\u660e\u6587\u4ef6\uff0c\u5305\u542b\u6709\u5173\u5982\u4f55\u5b89\u88c5\u548c\u4f7f\u7528\u4f60\u7684\u5305\u7684\u4fe1\u606f\u3002\u521b\u5efa\u4e00\u4e2aREADME.md<\/code>\u6587\u4ef6\uff1a<\/p>\n<\/p>\n
# My Package<\/p>\n
\u8fd9\u662f\u4e00\u4e2a\u793a\u4f8bPython\u5305\u3002<\/p>\n
## \u5b89\u88c5<\/p>\n
```bash<\/p>\n
pip install my_package<\/p>\n
<\/code><\/pre>\n<\/p>\n
\u4f7f\u7528<\/h2>\n<\/p>\n
from my_package.module import hello<\/p>\n
hello()<\/p>\n
<\/code><\/pre>\n<\/p>\n
<\/p>\n
#### 3. `MANIFEST.in`<\/p>\n
\u8fd9\u4e2a\u6587\u4ef6\u6307\u5b9a\u4e86\u54ea\u4e9b\u6587\u4ef6\u5e94\u8be5\u5305\u542b\u5728\u5206\u53d1\u5305\u4e2d\u3002\u521b\u5efa\u4e00\u4e2a`MANIFEST.in`\u6587\u4ef6\uff1a<\/p>\n
```text<\/p>\n
include README.md<\/p>\n
<\/code><\/pre>\n<\/p>\n
\u56db\u3001\u7f16\u5199\u6d4b\u8bd5<\/h3>\n<\/p>\n
\u4e3a\u4f60\u7684\u5305\u7f16\u5199\u6d4b\u8bd5\u662f\u4e00\u4e2a\u597d\u4e60\u60ef\u3002\u4f60\u53ef\u4ee5\u5728\u9879\u76ee\u76ee\u5f55\u4e0b\u521b\u5efa\u4e00\u4e2atests<\/code>\u76ee\u5f55\uff0c\u5e76\u5728\u5176\u4e2d\u6dfb\u52a0\u6d4b\u8bd5\u6587\u4ef6\u3002\u4f8b\u5982\uff0c\u521b\u5efa\u4e00\u4e2atest_module.py<\/code>\u6587\u4ef6\uff1a<\/p>\n<\/p>\n
# tests\/test_module.py<\/p>\n
import unittest<\/p>\n
from my_package.module import hello<\/p>\n
class TestModule(unittest.TestCase):<\/p>\n
    def test_hello(self):<\/p>\n
        self.assertEqual(hello(), "Hello, world!")<\/p>\n
if __name__ == '__main__':<\/p>\n
    unittest.main()<\/p>\n
<\/code><\/pre>\n<\/p>\n
\u4e94\u3001\u751f\u6210\u5206\u53d1\u5305<\/h3>\n<\/p>\n
\u5728\u751f\u6210\u5206\u53d1\u5305\u4e4b\u524d\uff0c\u786e\u4fdd\u4f60\u5df2\u7ecf\u5b89\u88c5\u4e86setuptools<\/code>\u548cwheel<\/code>\uff1a<\/p>\n<\/p>\n
pip install setuptools wheel<\/p>\n
<\/code><\/pre>\n<\/p>\n
\u7136\u540e\uff0c\u8fd0\u884c\u4ee5\u4e0b\u547d\u4ee4\u751f\u6210\u5206\u53d1\u5305\uff1a<\/p>\n<\/p>\n
python setup.py sdist bdist_wheel<\/p>\n
<\/code><\/pre>\n<\/p>\n
\u8fd9\u5c06\u5728dist<\/code>\u76ee\u5f55\u4e0b\u751f\u6210\u4f60\u7684\u5206\u53d1\u5305\u3002<\/p>\n<\/p>\n
\u516d\u3001\u53d1\u5e03\u5230PyPI<\/h3>\n<\/p>\n
1. \u6ce8\u518cPyPI\u8d26\u6237<\/h4>\n<\/p>\n
\u5982\u679c\u4f60\u8fd8\u6ca1\u6709PyPI\u8d26\u6237\uff0c\u9996\u5148\u9700\u8981\u6ce8\u518c\u4e00\u4e2a\uff1ahttps:\/\/pypi.org\/account\/register\/<\/a><\/p>\n<\/p>\n
2. \u5b89\u88c5Twine<\/h4>\n<\/p>\n
Twine\u662f\u7528\u4e8e\u53d1\u5e03Python\u5305\u7684\u5de5\u5177\u3002\u5b89\u88c5Twine\uff1a<\/p>\n<\/p>\n
pip install twine<\/p>\n
<\/code><\/pre>\n<\/p>\n
3. \u4e0a\u4f20\u5305\u5230PyPI<\/h4>\n<\/p>\n
\u4f7f\u7528Twine\u5c06\u4f60\u7684\u5305\u4e0a\u4f20\u5230PyPI\uff1a<\/p>\n<\/p>\n
twine upload dist\/*<\/p>\n
<\/code><\/pre>\n<\/p>\n
\u4f60\u5c06\u9700\u8981\u8f93\u5165\u4f60\u7684PyPI\u8d26\u6237\u7684\u7528\u6237\u540d\u548c\u5bc6\u7801\u3002<\/p>\n<\/p>\n
\u4e03\u3001\u5305\u7684\u7248\u672c\u63a7\u5236<\/h3>\n<\/p>\n
\u7248\u672c\u63a7\u5236<\/strong>\u662f\u8f6f\u4ef6\u5f00\u53d1\u4e2d\u7684\u4e00\u4e2a\u91cd\u8981\u90e8\u5206\u3002\u5728\u5f00\u53d1\u8fc7\u7a0b\u4e2d\uff0c\u4f60\u53ef\u80fd\u4f1a\u4e0d\u65ad\u5730\u5bf9\u4ee3\u7801\u8fdb\u884c\u4fee\u6539\u548c\u6539\u8fdb\uff0c\u6bcf\u6b21\u4fee\u6539\u540e\uff0c\u4f60\u9700\u8981\u66f4\u65b0\u5305\u7684\u7248\u672c\u53f7\u3002\u5e38\u89c1\u7684\u7248\u672c\u53f7\u683c\u5f0f\u662fMAJOR.MINOR.PATCH<\/code>\uff0c\u5176\u4e2d\uff1a<\/p>\n<\/p>\n