开发者

一文详解python如何将编写的模块打包上传至pypi

目录
  • 什么是pypi
  • 注册pypi
  • python打包格式
  • 打包上传至pypi
    • 基本工具安装
    • 使用build进行打包
    • 使用twine上传至pypi
  • 从pypi下载包测试代码
    • 总结

      本文所依赖的环境为:

      一文详解python如何将编写的模块打包上传至pypi

      这里你http://www.devze.com可能会好奇,为啥和之前版本不一样了呢?因为我在学习打包的时候,发现我们此前的python 3.68只支持到Setuptools 59.6.0,没办法安装到Setuptools 61.0,所以我重新源码安装了一下python 3.7。 如果你和我一样,是在Centos 7上面学习的,注意也要升级一下python版本哦!

      这里还有一点需要注意,如果我们是第一次将python进行打包上传到pypi或者说只是为了测试,建议一开始不直接上传pypi.org,而是上传至test.pypi.org,这是python提供的一个测试系统,环境和pypi.org一致,所以,我们本篇文章所上传的库为test.pypi.org。

      什么是pypi

      python除了系统默认模块,如osretime等等,还有众多的第三方模块,如大名鼎鼎的flaskwsgiref等等。

      我们通常想要使用第三方模块的时候,需要先使用pip进行安装,例如:

      pip3 install flask

      这个命令,会向软件存储库下载第三方模块包,这个软件存储库就是Pypi也称之为包索引。默认如果不指定源,则会向 pypi.org/ ,也python可以在pip中使用-i选项指定源,例如清华pypi源等等。

      用一句话概括,pypi就是存储python开发者编写的第三方模块的地方。

      此外还有众多的源,如果不是作为私有库的话,几乎都是同步的python官方pypi

      注册pypi

      如果你想注册真实的pypi,则使用的url为: pypi.org/account/register/。

      这里还是要提醒,请不要将测试的项目上传至pypi,那样对使用者很不友好。

      打开pypi注册页面,填上电子邮件等信息,进行注册,pypi注册网址: test.pypi.org/account/register/

      一文详解python如何将编写的模块打包上传至pypi

      填写完毕后,点击【Create account】即可创建账号。而后pypi会给注册的邮箱发送一个校验url,点击后,即可注册成功。

      注册成功后,我们需要生成token用于上传pypi,注册成功登录后,需要从用户名点击,选择【Account Settings】

      一文详解python如何将编写的模块打包上传至pypi

      往下滑,找到【API tokens】

      一文详解python如何将编写的模块打包上传至pypi

      点击后,输入Token名称,和选择Token范围

      一文详解python如何将编写的模块打包上传至pypi

      完成后,点击【Add token】 就可以了。

      一文详解python如何将编写的模块打包上传至pypi

      完成后,会得到一个很长的以pypi-开头的token请记住它,后面要用

      至此,注册pypi,生成token已经结束了。

      python打包格式

      这里我将整个目录都放到了gitee上,相关格式的话,可以看编程客栈一下,地址: gitee.com/pdudo/golearn/tree/master/python/PackagingTesting/JuejinPdudoProject

      在进行打包之前,我们需要创建符合pypi包格式的文件,其包的格式为:

      一文详解python如何将编写的模块打包上传至pypi

      其中,目录和文件的含义分别为:

      • LICENSE: 包的许可证。
      • pyproject.toml: python项目配置文件。
      • README.md:项目说明文件。
      • src: 存放源码的目录。
      • src.juejinPduDOSampleWeb:是一个目录,包名为: juejinPdudoSampleWeb
      • src.juejinPdudoSampleWeb.*:python源文件,注意__init__.py为入口文件,可以为空。
      • tests:测试程序目录。

      在该目录下,pyproject.toml尤其重要,这里贴一下我们本次打包文件的内容为:

      [build-system]
      requires = ["setuptools>=61.0"]
      build-backend = "setuptools.build_meta"
      
      [project]
      name = "JuejinPdudoProject"
      version = "0.0.2"
      authors = [
        { name="pdudo", email="1052558+pdudo@user.noreply.gitee.com" },
      ]
      description = "A simple WSGI-compliant web application layer framework"
      编程客栈readme = "README.md"
      requires-python = ">=3.7"
      classifiers = [
          "Programming Language :: Python :: 3",
          "License :: OSI Approved :: MIT License",
      ]
      
      [project.urls]
      "Homepage" = "https://gitee.com/pdudo/golearn/blob/master/python/PackagingTesting"
      "Bug Tracker" = "https://gitee.com/pdudo/golearn/issues"

      其中,有三个大项,分为为:

      • build-system:包的依赖环境。
      • project:项目内容。
      • project.urls:项目URL

      build-system是构建包所需的列表信息。

      project下,其中nameversionauthorsdescription是包的基本信息,包括名称、版本、作者 以及 包的简介等。

      readme是指定项目的说明文件,一般而言是README.mdrequires-python是该包所依赖的python版本,classifierspython包的元数据。

      最后是project.urls,它将在pypi上显示输入的额外链接。

      打包上传至pypi

      如果将pypi包的格式做好了,那么恭喜你,就可以开始打包了,在进行正式打包之前,我们需要安装相关依赖:

      基本工具安装

      安装打包工具build

      pip3 install build

      如果网络很差的时候,可以考虑下使用第三方源,例如清华,安装build命令为:

      pip3 install build -i https://pypi.tuna.tsinghua.edu.cn/simple

      使用build进行打包

      开始打包的时候,需要进入JuejinPdudoProject,和pyproject.toml处于同一目录,使用如下命令进行打包:

      python3 -m build

      在此过程中,它会常见虚拟环境,安装构建依赖,而后开始按照文件内容,进行打包。

      如果成功的话,会出现Successfully built juejinPdudoProject-0.0.2.tar.gz and juejinPdudoProject-0.0.2-py3-none-any.whl类似的信息:

      一文详解python如何将编写的模块打包上传至pypi

      如果此时我们再使用tree命令查看当前目录下结构:

      一文详解python如何将编写的模块打包上传至pypi

      我们会发现,此时多了一个目录dist,里面正是我们打包的包。

      使用twine上传至pypi

      在当前目录下,使用命令

      python3 -m twine upload --repository testpypi dist/* --verbose

      就可以将包上传至pypi了,在此过程中,会让我们输入用户名和密码,还记得我们注册pypi的时候生成过一个API tokens,上传的时候会用到此信息。

      一文详解python如何将编写的模块打包上传至pypi

      这个就证明上传pypi成功了。此时再打开页面,就可以看到相关内容了:

      此时打开pypi网页,就可以看到我们创建的项目了:

      一文详解python如何将编写的模块打包上传至pypi

      从pypi下载包测试代码

      这里,我们根据网站提示下载包:

      一文详解python如何将编写的模块打包上传至pypi

      我们这次在Windows终端下安装该包:

      一文详解python如何将编写的模块打包上传至pypi

      我们这次在windows终端下安装该包:

      一文详解python如何将编写的模块打包上传至pypi

      在浏览器进行测试后,可得

      一文详解python如何将编写的模块打包上传至pypi

      由此证明上传的包没有问题。

      总结

      本篇文章介绍了什么是pypi,以及打包的格式,最后打包完毕后,将包上传至pypi。这里有几个细节可以注意一下,当我们打包后,会得到一个dist目录,在该目录下,有一个结尾为.whl的文件,我们可以直接通过pip install 跟上文件名来安装一下包,若包没问题后,我们就可以上传到pypi开发者_Go开发了。还有pypi有一个很严格的措施编程客栈,为了安全,pypi不允许重复使用项目,即使该项目被删除了并再次上传也不行,这是要方式项目被恶意更改,所以删除就再也不存在该项目了,还有一点,如果只是测试上传pypi,请使用test.pypi.org。

      以上就是一文详解python如何将编写的模块打包上传至pypi的详细内容,更多关于python模块打包上传至pypi的资料请关注我们其它相关文章!

      0

      上一篇:

      下一篇:

      精彩评论

      暂无评论...
      验证码 换一张
      取 消

      最新开发

      开发排行榜