Python 项目代码写完了,然后怎么打包和发布?

本文详细指导了如何在Python项目完成后进行打包,包括创建package结构、编写setup.py文件,以及如何使用setuptools和twine进行发布。同时讨论了开源选择和版权问题。
摘要由CSDN通过智能技术生成

你把你的代码写完了,是不是要给别人使用下,怎么打包你的项目代码呢?

喂,开源么?

接下来小帅b就跟你说说,如何打包你的代码。

就拿我们上次演示的 todo 为例,写完代码之后,代码的目录是这样的:

在 todo 这个目录里面,文件都放在一起了,我们可以这样简单划分一下:

这里创建了一个 package 目录,将源码文件放进去,然后把模板文件和数据库文件分门别类的安排好。

在 package 中,还创建了一个 __init__.py 仪式感一下。

为了让别人知道你是认真对待这个项目的,你可以在项目文件中创建一个 tests 目录,在里面测试你的代码:

接着可以创建一个 LICENSE ,用来说明你的这个项目可以被怎么使用?是不是需要声明来源,是不是可以商用?别人用你的项目去搞事情如何避免被抓去吃牢饭等。

现成的开源协议有好几种,不太了解的可以看看我之前写的这个:那些 GitHub 所声明的开源协议都是什么意思

接着再创建一个 README 文件,来说明你这个项目是干什么的,如何使用等描述。

现在你的项目文件目录就有点人模人样了:

接下来要创建一个比较重要的文件了 —— setup.py,这个文件主要用来描述你的项目信息,好让 setuptools 打包工具来帮你打包项目。

在根目录下创建一个 setup.py 文件,按以下的方式来写你的项目信息:

每个参数都是什么意思呢?我来给你说明一下:

long_description:对项目比较长的描述,我们可以直接从 你刚刚写的 README 文件读取。

name: 你定义的包名,可以用字母、数字、下划线,需要确保唯一性。

version: 项目的版本号。

author: 你(作者)的名称。

author_email: 你(作者) 的邮箱。

description: 项目的简要描述。

long_description_content_type:长描述内容的使用的标记类型,一般为 markdown 或者 rst。

url: 你这个项目的主页地址,也可以直接链接到你这个项目的Github 地址上面去。

include_package_data: 是否添加 py 以外的文件。

package_data: 需要添加 Python 的额外文件列表。

packages: 直接用 setuptool 找到你项目所有相关的包列表。

classifiers: 附加说明,比如这里写的就是使用于 Python3 版本,使用的是 MIT 协议,独立于 OS。

python_requires: python 版本要求。

那么现在,你的项目目录应该是这样子的:

接下来就可以打包了。

如果你之前没有安装过 setuptools 和 wheel 可以先安装一波:

python3 -m pip install --upgrade setuptools wheel

然后在你的项目根目录下,使用如下命令打包:

python3 setup.py sdist bdist_wheel

这时候你的目录会增加这么些文件:

这样就算打包好了,在 dist 目录中,以 tar.gz 结尾的是你项目的源文件,而以 .whl 结尾的就是构建好了给别人使用的发行版。

那么如何将你打包好的项目发布出来,给别人使用呢?

其实之前有说过了,这里再简单的说一下吧:

先安装一下 twine:

python3 -m pip install twine

接着使用 twine 将你打包好的文件上传到 pypi 上面去:

twine upload dist/*

这时候它会提示你输入 pypi 的账号密码:

没有怎么办?去注册一个呗,到以下链接注册:

https://pypi.org/account/register/

接着输入你的账号密码,就可以上传上去了:

这时候别人就可以通过 pip 来安装你的项目了:

像这样:

然后就可以给别人使用你的包了:

你在 pip install 的时候,其实就是下载你上传的 whl 文件然后安装:

如果你不想开源,只想给你朋友使用的话,你也可以直接把 dist 这个目录下的文件发给他,让他自行安装一波就可以使用了:

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

以上就是“Python 项目代码写完了,然后怎么打包和发布?”的全部内容,希望对你有所帮助。

关于Python技术储备

学好 Python 不论是就业还是做副业赚钱都不错,但要学会 Python 还是要有一个学习规划。最后大家分享一份全套的 Python 学习资料,给那些想学习 Python 的小伙伴们一点帮助!

一、Python所有方向的学习路线

Python所有方向的技术点做的整理,形成各个领域的知识点汇总,它的用处就在于,你可以按照上面的知识点去找对应的学习资源,保证自己学得较为全面。

在这里插入图片描述

二、Python必备开发工具

img

三、Python视频合集

观看零基础学习视频,看视频学习是最快捷也是最有效果的方式,跟着视频中老师的思路,从基础到深入,还是很容易入门的。

img

四、实战案例

光学理论是没用的,要学会跟着一起敲,要动手实操,才能将自己的所学运用到实际当中去,这时候可以搞点实战案例来学习。

img

五、Python练习题

检查学习结果。

img

六、面试资料

我们学习Python必然是为了找到高薪的工作,下面这些面试题是来自阿里、腾讯、字节等一线互联网大厂最新的面试资料,并且有阿里大佬给出了权威的解答,刷完这一套面试资料相信大家都能找到满意的工作。

img

最后祝大家天天进步!!

上面这份完整版的Python全套学习资料已经上传至CSDN官方,朋友如果需要可以直接微信扫描下方CSDN官方认证二维码免费领取【保证100%免费】。

  • 20
    点赞
  • 24
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值