<返回更多

怎么样发布你的 Python 代码给别人 “pip install”

2020-03-31    
加入收藏

【文章来源】知乎:学习Python的正确姿势

​参考:
https://zhuanlan.zhihu.com/p/73199573

学习Python的朋友应该都知道,当我们需要使用某些功能的时候,都会去安装一些第三方的模块,比如 “pip install requests”,感觉都被别人装了,你有没有想过,自己搞一个模块,给别人直接 pip install 到他的电脑里面直接使用呢?是不是突然就很厉害!

这操作厉害:怎么样发布你的 Python 代码给别人 “pip install”

 

我们思考着,如果打包自己的代码呢?然后给别人用,pipi呢?

我们进入主题:

先要打一个 Python 包到 pypi 上,是需要一定的目录结构的,首先我们可以创建一个目录,作为演示,我在这里创建一个包:

mkdir shuaib_package

接着我们就进入这个包:

cd shuaib_package/

接着我们在这个目录下创建一个存放你代码的目录,这里就叫 xiaoshuaib 好了:

mkdir xiaoshuaib

我们进入这个目录:

cd xiaoshuaib/

创建你的代码,这里为了演示,我就创建一个 xiaoshuaib.py 好了 :

touch xiaoshuaib.py

在这个 py 里面就简单写一个输出的方法好了:

插一句:想要Python资料的可以关注小编,并在后台私信小编:“01”即可领取。

这操作厉害:怎么样发布你的 Python 代码给别人 “pip install”

 

在这个 xiaoshuaib 目录下还必须要创建一个 __init__.py 来告诉别人你的模块是啥:

touch __init__.py

在这个 __init__.py 写下你的 name 和导入你的代码模块:

这操作厉害:怎么样发布你的 Python 代码给别人 “pip install”

 

ok,此时此刻,你的文件目录是这样的:

这操作厉害:怎么样发布你的 Python 代码给别人 “pip install”

 

只有这几个文件还是不够的,我们还要再创建几个必要的文件,分别是 setup.py、LICENSE、READEME.md, 至于创建这几个文件有什么鸟用,等会帅b给你细细地道来,废话不要那么多,先创建再说:

cd shuaib_package/
touch setup.py
touch LICENSE
touch README.md

那么到现在这个时候,你的文件目录应该是这样的:

这操作厉害:怎么样发布你的 Python 代码给别人 “pip install”

 

接下啦就跟你说说这几个文件分别有什么鸟用。

1、setup.py

这个文件主要是要告诉 setuptools ,我们的包里面的一些信息,比如名称啊,版本号啊,作者,邮箱等等...

我们来编辑一些这个文件:

这操作厉害:怎么样发布你的 Python 代码给别人 “pip install”

 

这里面对应的意思应该不用我多说了吧,就是一些你的模块信息,像我这样填入你自己的就好了。

2、README.md

在这里就可以对你的模块进一步各种吹了,刚我们写的 setup 文件里面也引用到了这个文件,主要是怕你吹的太多,所以直接用 markdown 让你吹个够,我们打开这个 README 文件吹一波:

这操作厉害:怎么样发布你的 Python 代码给别人 “pip install”

 

好吧,我这里作为演示就只吹这么一点点够了...

这操作厉害:怎么样发布你的 Python 代码给别人 “pip install”

 

3、LICENSE

在开源的世界里, LICENSE 是必不可少的,我们可以在这里声明:你要免费用我的代码是吧?可以,但是你得署名一下啊,要让别人知道这是我搞出来的啊,老子不要钱,但不能说这是你自己搞出来的好吧?

LICENSE 有好几种不同的声明,以后有机会帅b再跟你说说,这次就用 MIT 的 LICENSE ,我们编辑一下我们刚刚创建的 LICENSE:

这操作厉害:怎么样发布你的 Python 代码给别人 “pip install”

 

好了,现在我们所需的文件就弄好了,接下来就可以将我们的东西给生成可分发的文件,在此之前我们要安装并且更新好 setuptools 和 wheel 模块:

python3 -m pip install --user --upgrade setuptools wheel

安装完成之后,你就可以在你刚刚创建的目录执行以下命令生成啦:

python3 setup.py sdist bdist_wheel

这时候你就会发现,你的目录下会多了一个 dist 的目录,这正是 pypi 所需要的

这操作厉害:怎么样发布你的 Python 代码给别人 “pip install”

 

万事具备,就差 tm 的上传了啊,那么你现在就要有一个 pypi 的账号,你可以到以下链接注册一个账号:

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

如果说你只想自己试着小打小闹一下,可以到这里注册一个测试版的:

https://test.pypi.org/account/register/
这操作厉害:怎么样发布你的 Python 代码给别人 “pip install”

 

不管咋地,反正你迟早会注册好一个账号的对吧?值得注意的是,你要验证下你的邮箱,代表你不是机器人注册的账号:

这操作厉害:怎么样发布你的 Python 代码给别人 “pip install”

 

那么此时此刻,你所需的文件也有了,账号也有了,这次就真的只差上传一个动作了,我们需要 twine 这个模块来进行上传操作,先安装一下:

python3 -m pip install --user --upgrade twine

安装好了之后,相信我,一点也不复杂,一个命令就能搞定上传,进入你的目录,然后执行以下命令把你刚刚生成的 dist 上传上去:

twine upload dist/*
这操作厉害:怎么样发布你的 Python 代码给别人 “pip install”

 

这样,我们就将我们的模块上传上去了!!

去官网搜一下 xiaoshuaib 先:

这操作厉害:怎么样发布你的 Python 代码给别人 “pip install”

 

哈哈哈哈,有了,我们来安装一波吧:

pip install xiaoshuaib
这操作厉害:怎么样发布你的 Python 代码给别人 “pip install”

 

安装成功,来使用一波:

这操作厉害:怎么样发布你的 Python 代码给别人 “pip install”

 

哈哈哈,完美使用。

ok,以上就是从 0 到 发布一个 pypi 包的完整流程,希望对你有帮助,记得点“赞”。那么我们下回见,peace!

声明:本站部分内容来自互联网,如有版权侵犯或其他问题请与我们联系,我们将立即删除或处理。
▍相关推荐
更多资讯 >>>