文件夹|封装Python代码包的六个步骤!现在就记住( 三 )
(2) 如果读者使用的是Python3 , 那么任何Python版本都大于或等于用来开发代码包的版本 。 以此类推 , 如果使用的是Python3.5 , 那么应该设置成“>=3.5” 。
· install_requires: 此处列出的是所有非标准库代码包的使用前提 。 例如 , 如果chocobo 需要requests和 pytz 才能运行的话 , 那么该参数应设置为:[“ requests” , “pytz”] 。
· classifiers: 连同其他成千上万个代码包一起 , 你的代码包也会很快PyPI上线 。 为了进行区分 , 作者可以向PyPI提供一个列表 , 列出trove分类器来对每个版本进行分类 , 描述其用途、支持的系统和开发进度 。 然后 , 社区成员可以使用这些标准化的分类器 , 根据自己的需求来查找项目(尽管不确定谁会进行这项操作) 。
这里有所有可能用到的分类器:
建议从以下几个开始:
- “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”
以上就是这一环节的全部内容 。
文章插图
图2:选择trove分类器后的艾斯·文图拉
步骤五:建立发行文件
Python包位于发行文件中 , 这些文件会统一被上传到一个服务器中(通常是PyPI全局服务器) , 供公众下载 。
本文不会详细介绍发行格式 。 笔者将使用标准方法()构建两个文件:源发行文件(基本上包含了代码包)和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 部分视具体情况而定):
[distutils]index-servers = pypi testpypi[pypi]username: teapot48password: myPYPIpassword[testpypi]repository: username: teapot48password: MYtestPYPIpassword本文依照最新的方法将文件上传到PyPI服务器中 , 并使用twine(上传Python包的实用工具) , 而不是使用过时的python setup.py upload。 只需运行:
twine upload dist/*
如果想在PyPI服务器上进行测试 , 只需运行 twine upload — repository testpypi dist/*
不论如何 , 上传.whl 文件时都应该能看到一个进度条 , 上传.tar.gz 文档时应该也能看到一个进度条 , 然后上传就完成了 。
现在可以在PyPI官方网站上看到自己的Python包页面了 , 大家也都能看到!
示例:
文章插图
图3:PyPI网站上包页面的示例
大功告成!
文章插图
留言 点赞 关注
我们一起分享AI学习与发展的干货
编译组:杨月、翁梦徽
相关链接:
如需转载 , 请后台留言 , 遵守转载规范
- 5D封装|EDA365:先进IC封装,你需要知道的几大技术
- 告诉|阿里大佬告诉你如何一分钟利用Python在家告别会员看电影
- 封测|芯片封装或成半导体行业下一个竞技场!
- Python源码阅读-基础1
- Python调用时使用*和**
- 如何基于Python实现自动化控制鼠标和键盘操作
- 解决多版本的python冲突问题
- 手机|手机文件夹都是英文,占空间还不敢删除,教你一招省下10G内存
- 学习python第二弹
- Python中文速查表-Pandas 基础