加入收藏 | 设为首页 | 会员中心 | 我要投稿 辽源站长网 (https://www.0437zz.com/)- 云专线、云连接、智能数据、边缘计算、数据安全!
当前位置: 首页 > 运营中心 > 建站资源 > 优化 > 正文

六个步骤,封装你喜爱的Python代码包

发布时间:2019-10-13 09:44:32 所属栏目:优化 来源:读芯术
导读:假设你很喜欢用同一段Python代码,里面有几个相关的小型函数,或者是含有几百行代码的中型模块。程序员可能会把它复制到不同的项目或存储库中,或者从特别设置的实用工具代码文件夹中导入这段代码。 这很正常。程序员在编写代码的过程中都会不断积累这些个

建议从以下几个开始:

  • “Development Status :: 3 — Alpha”
  • “License :: OSI Approved :: MIT License”
  • “ Programming Language :: Python”
  • “ Programming Language :: Python :: 3.5”
  • “ Programming Language :: Python :: 3.6”
  • “ Programming Language :: Python :: 3.7”
  • “Topic :: Software Development :: Libraries”
  • “Topic :: Software Development :: Libraries :: Python Modules”
  • “Intended Audience :: Developers”

以上就是这一环节的全部内容。

六个步骤,封装你喜爱的Python代码包

图2:选择trove分类器后的艾斯·文图拉

步骤五:建立发行文件

Python包位于发行文件中,这些文件会统一被上传到一个服务器中(通常是PyPI全局服务器),供公众下载。

本文不会详细介绍发行格式。笔者将使用标准方法(https://packaging.python.org/tutorials/packaging-projects/)构建两个文件:源发行文件(基本上包含了代码包)和wheel发行文件(wheel build distribution file)。

首先,确保安装了最新版本的setuptools 以及 wheel:

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

要构建发行文件,只需在setup.py所在的存储库的根目录中运行以下命令:

python setup.py sdist bdist_wheel

在这一步,需要Python运行setup.py这个脚本,并向它发送两个参数,生成源文件(参数sdist),以及wheel工具来构建发行文件(参数bdist_wheel)。

运行此命令时,将在调用目录中创建三个文件夹: build, dist 和 chocobo.egg-info。对于.gitignore 文件来说,这三个可以忽略不计。如果这些目录已经存在(例如,该命令之前已经运行过了,最好用rm -rf build dist将这些目录删除掉,因为dist 下的任何有效代码包文件都将被上传。

要上传的两个文件位于dist 文件夹中:分别为chocobo-0.0.3-py-none.any.whl (构建发行;是一个wheel 文件)和chocobo-0.0.3.tar.gz (源发行;是一个压缩的tar 文件)。创建成功后,我们继续上传的步骤!

步骤六:上传

剩下的步骤就是将代码包上传到PyPI全局服务器!然而,用户必须先在PyPI网站上注册。按照注册的步骤填写用户名和密码。

如果想在上传到PyPI全局服务器之前测试包,程序员也可以在测试PyPI网站上注册一个用户。

现在,用于上传的Python包将在.pypirc文本文件中查找PyPI用户名和密码(通过PyPI服务器进行验证),该文件通常位于主文件夹中。创建后按如下所示进行填写(testpypi 部分视具体情况而定):

  1. [distutils] 
  2. index-servers = 
  3.  pypi 
  4.  testpypi 
  5. [pypi] 
  6. username: teapot48 
  7. password: myPYPIpassword 
  8. [testpypi] 
  9. repository: https://test.pypi.org/legacy/ 
  10. username: teapot48 
  11. password: MYtestPYPIpassword 

本文依照最新的方法将文件上传到PyPI服务器中,并使用twine(上传Python包的实用工具),而不是使用过时的python setup.py upload 。只需运行:

twine upload dist/*

如果想在PyPI服务器上进行测试,只需运行 twine upload — repository testpypi dist/*

不论如何,上传.whl 文件时都应该能看到一个进度条,上传.tar.gz 文档时应该也能看到一个进度条,然后上传就完成了。

现在可以在PyPI官方网站上看到自己的Python包页面了,大家也都能看到!

示例:https://pypi.org/project/birch/

六个步骤,封装你喜爱的Python代码包

图3:PyPI网站上包页面的示例

大功告成!

(编辑:辽源站长网)

【声明】本站内容均来自网络,其相关言论仅代表作者个人观点,不代表本站立场。若无意侵犯到您的权利,请及时与联系站长删除相关内容!

推荐文章
    热点阅读