Python项目打包发布到pypi

小詹学Python

共 2532字,需浏览 6分钟

 ·

2020-08-19 16:48

最近心血来潮,想把自己的写的python项目打包到pypi,也让广大朋友能够通过pip来安装我的python包。
第一次尝试,中间遇到了一些问题,记录下来,方便其他感兴趣的朋友。

项目组织架构

  1. # tree

  2. .

  3. ├── LICENSE

  4. ├── pg_client

  5. │   ├── __init__.py

  6. │   └── pg_operator.py

  7. ├── README.md

  8. └── setup.py

  • LICENSE:可以通过github创建项目的时候选择,选择“MIT License”,后面需要添加对应的License版本

  • README.md:项目的介绍

  • setup.py:打包时用到的元数据信息

  • pg_client: 项目主要代码目录,名字可以根据项目需要定义

setup.py文件

  1. import setuptools


  2. with open("README.md", "r") as fh:

  3. long_description = fh.read()


  4. setuptools.setup(

  5. name="pypostgrestool",

  6. version="0.1",

  7. author="zhangjx",

  8. author_email="xxx@qq.com",

  9. description="SDK about postgres",

  10. long_description=long_description,

  11. long_description_content_type="text/markdown",

  12. url="https://github.com/ThinkBlue1991/pgpool",

  13. packages=setuptools.find_packages(),

  14. install_requires=['psycopg2==2.8.5'],

  15. classifiers=[

  16. "Programming Language :: Python :: 3",

  17. "License :: OSI Approved :: MIT License",

  18. "Operating System :: OS Independent",

  19. ],

  20. )

  • name : 软件包的名称。该名称由字母,数字,_和-组成。并且不能与其他已经上传至pypi.org的项目相同

  • version: 软件包的版本

  • author: 作者

  • author_email : 作者邮箱地址

  • description :软件包的描述信息

  • long_description : 软件包的长描述信息

  • url :软件包的主页链接,常见的github路径较多

  • classifiers :当前软件包的其他元数据信息(metadata)。例如兼容的python版本和操作系统;提供的功能的类型及许可证等等。应当总是至少包括当前软件包所支持的python版本,操作系统和许可证信息

  • packages :包含在发布软件包文件中的可被import的python包文件。我们可以手动罗列所有文件。或者使用函数setuptools.find_packages()自动包含所有的python包文件以及子包文件

  • install_requires:指定了当前软件包所依赖的其他python类库。这些指定的python类库将会在本package被安装的时候一并被安装

__init__.py文件

填写import导入,这样在安装之后,就能够直接通过import到自己的项目中使用,比如:

  1. # cat pg_client/__init__.py

  2. from pg_client.pg_operator importPostgresDB

安装完成之后,通过 frompg_clientimportPostgresDB来使用 PostgresDB这个类对象

打包

  • 安装打包工具

  1. pip3 install whell -y

  2. pip3 install twine -y

  • 打包

  1. python3 setup.py sdist bdist_wheel

输出结果

  1. # tree

  2. .

  3. ├── build

  4. │   ├── bdist.linux-x86_64

  5. │   └── lib

  6. │   └── pg_client

  7. │   ├── __init__.py

  8. │   └── pg_operator.py

  9. ├── dist

  10. │   ├── pypostgrestool-0.1-py3-none-any.whl

  11. │   └── pypostgrestool-0.1.tar.gz

  12. ├── LICENSE

  13. ├── pg_client

  14. │   ├── __init__.py

  15. │   └── pg_operator.py

  16. ├── pypostgrestool.egg-info

  17. │   ├── dependency_links.txt

  18. │   ├── PKG-INFO

  19. │   ├── SOURCES.txt

  20. │   └── top_level.txt

  21. ├── README.md

  22. └── setup.py

dist下的文件是需要上传到pypi下的

上传pypi

  • 注册

通过pypi注册页面进行pypi用户注册

  • 上传

  1. # twine upload dist/*

  2. Uploading distributions to https://upload.pypi.org/legacy/

  3. Enter your username:

输入用户名和密码就能够上传到pypi下。

  • 登陆到pypi查看自己的项目

- End -


由于微信平台算法改版,公号内容将不再以时间排序展示,如果大家想第一时间看到我们的推送,强烈建议星标我们和给我们多点点【在看】。星标具体步骤为:


(1)点击页面最上方“小詹学Python”,进入公众号主页。


(2)点击右上角的小点点,在弹出页面点击“设为星标”,就可以啦。


感谢支持,比心。


浏览 32
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报
评论
图片
表情
推荐
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报