楔子
我们在安装第三方包的时候,直接一个pip install xxx命令就搞定了,然后pip会去pypi上寻找我们要安装的包,然后下载下来。
而pypi(python package index )你可以看成是官方维护的一个大仓库,专门用来存储世界各地的程序员编写的第三方模块。我们使用pip进行安装的时候就会去这个仓库里面找,找到了进行下载,找不到就提示不存在。
当然我们在安装的时候还可以指定清华源、豆瓣源,因为pypi在国外,下载有时候比较慢,而一旦指定了国内的源,那么就不会去pypi上下载了,所以你可以看成国内也有仓库,专门负责搬运pypi里面的内容。
上传模块至pypi
总共分为三步:编写模块、编译模块、上传模块。
编写模块
我们看一下要上传到pypi的模块长什么样子。
- hanser-module-upload:项目的根目录
- hanser:模块名,我们后面可以使用from hanser import xxx,或者import hanser
- hanser下面的两个py文件:相应的代码
- license:开源的 license,如:apache license 2.0,mit license 等等
- readme.md:关于项目的描述,描述如何安装、使用等情况
- setup.py:setuptools 的构建脚本
然后我们看看代码长什么样子。
# calc.py def add(x: int, y: int) -> int: return x + y def sub(x: int, y: int) -> int: return x - y # __init__.py from .calc import add, sub
然后最重要的就是编写setup.py。
# setup.py 是一个 setuptools 的构建脚本,其中包含了项目和代码文件的信息 # 如果没有需要先安装,pip install setuptools import setuptools setuptools.setup( # 项目的名称 name="anser-module-upload", #项目的版本 version="0.0.1", # 项目的作者 author="布诺妮亚", # 作者的邮箱 author_email="hanser@baka.com", # 项目描述 description="简单的加减运算上传测试", # 项目的长描述 long_description="简单的加减运算上传测试", # 以哪种文本格式显示长描述 long_description_content_type="text/markdown", # 所需要的依赖 install_requires=[], # 比如["flask>=0.10"] # 项目主页 url="https://www.baidu.com", # 项目中包含的子包,find_packages() 是自动发现根目录中的所有的子包。 packages=setuptools.find_packages(), # 其他信息,这里写了使用 python3,mit license许可证,不依赖操作系统。 classifiers=[ "programming language :: python :: 3", "license :: osi approved :: mit license", "operating system :: os independent", ], )
编译
在上传代码之前,我们需要将代码编译。除了setuptools之外,我们还需要一个模块wheel,如果没有则需要安装。
pip install --user --upgrade setuptools wheel
然后对我们的setup.py进行编译。
python setup.py sdist bdist_wheel
编译成功之后会在项目中生成多个目录,其中有一个dist目录是我们需要上传的。
上传
然后就是上传了,我们需要前往()注册一个账号,然后再安装一个模块:twine,因为上传需要使用到它。
pip install --user --upgrade twine
安装完成之后,就可以使用如下命令上传 dist 文件夹里面的文件。
python -m twine upload --repository pypi dist/*
我们看到上传成功,下面去页面看一下。
注意:这里为了区分,我们把根目录名和模块名取得不一样,我们需要pip install hanser-module-upload,然后在site-packages下面会有一个hanser目录,也就是我们所使用的模块。但是一般情况下,这两者都是一样的。比如:我们安装pandas,那么得到的模块也叫做pandas。
下面就来试一试吧:
成功安装,当然也是可以使用的。
以后如果我们自己写了一个比较不错的模块的时候,就可以发布到pypi上面。
以上就是如何将自己写的模块上传到pypi的详细内容,更多关于模块上传到pypi的资料请关注www.887551.com其它相关文章!