你把你的代码写完了,是不是要给别人使用下,怎么打包你的项目代码呢?
喂,开源么?

python 打包 发布--mini run - 图1

接下来小帅b就跟你说说,如何打包你的代码。

仅限100名!3.9元入门python。游戏闯关式教学,小白也能轻松学会!

就拿我们上次演示的 todo 为例,写完代码之后,代码的目录是这样的:

python 打包 发布--mini run - 图2

在 todo 这个目录里面,文件都放在一起了,我们可以这样简单划分一下:

python 打包 发布--mini run - 图3

这里创建了一个 package 目录,将源码文件放进去,然后把模板文件和数据库文件分门别类的安排好。
在 package 中,还创建了一个init.py仪式感一下。
为了让别人知道你是认真对待这个项目的,你可以在项目文件中创建一个 tests 目录,在里面测试你的代码:

python 打包 发布--mini run - 图4

接着可以创建一个LICENSE,用来说明你的这个项目可以被怎么使用?是不是需要声明来源,是不是可以商用?别人用你的项目去搞事情如何避免被抓去吃牢饭等。

现成的开源协议有好几种,不太了解的可以看看我之前写的这个:那些 GitHub 所声明的开源协议都是什么意思

python 打包 发布--mini run - 图5

接着再创建一个 README 文件,来说明你这个项目是干什么的,如何使用等描述。

python 打包 发布--mini run - 图6

现在你的项目文件目录就有点人模人样了:

python 打包 发布--mini run - 图7

接下来要创建一个比较重要的文件了 ——setup.py,这个文件主要用来描述你的项目信息,好让 setuptools 打包工具来帮你打包项目。
在根目录下创建一个 setup.py 文件,按以下的方式来写你的项目信息:

python 打包 发布--mini run - 图8

setup.cfg 参数说明

每个参数都是什么意思呢?我来给你说明一下:

long_description:对项目比较长的描述,我们可以直接从 你刚刚写的 README 文件读取。

python 打包 发布--mini run - 图9

name: 你定义的包名,可以用字母、数字、下划线,需要确保唯一性。
version: 项目的版本号。

author: 你(作者)的名称。
author_email: 你(作者) 的邮箱。
description: 项目的简要描述。
long_description_content_type:长描述内容的使用的标记类型,一般为 markdown 或者 rst。
url: 你这个项目的主页地址,也可以直接链接到你这个项目的Github 地址上面去。
include_package_data: 是否添加 py 以外的文件。
package_data: 需要添加 Python 的额外文件列表。
packages: 直接用 setuptool 找到你项目所有相关的包列表。
classifiers: 附加说明,比如这里写的就是使用于 Python3 版本,使用的是 MIT 协议,独立于 OS。
python_requires: python 版本要求。
那么现在,你的项目目录应该是这样子的:

python 打包 发布--mini run - 图10

python setup.py 函数各参数详解:

>>python setup.py —help
—name 包名称
—version (-V) 包版本
—author 程序的作者
—author_email 程序的作者的邮箱地址
—maintainer 维护者
—maintainer_email 维护者的邮箱地址
—url 程序的官网地址
—license 程序的授权信息
—description 程序的简单描述
—long_description 程序的详细描述
—platforms 程序适用的软件平台列表
—classifiers 程序的所属分类列表
—keywords 程序的关键字列表
—packages 需要打包的目录列表
—py_modules 需要打包的python文件列表
—download_url 程序的下载地址
—cmdclass
—data_files 打包时需要打包的数据文件,如图片,配置文件等
—scripts 安装时需要执行的脚步列表

setup.py打包命令各参数详解:

python setup.py —help-commands
—python setup.py build # 仅编译不安装
—python setup.py install #安装到python安装目录的lib下
—python setup.py sdist #生成压缩包(zip/tar.gz)
—python setup.py bdist_wininst #生成NT平台安装包(.exe)
—python setup.py bdist_rpm #生成rpm包
作者:爬虫标本
链接:https://www.imooc.com/article/253042
来源:慕课网

接下来就可以打包了。

如果你之前没有安装过 setuptools 和 wheel 可以先安装一波:

python3 -m pip install —upgrade setuptools wheel

python 打包 发布--mini run - 图11

然后在你的项目根目录下,使用如下命令打包:

python3 setup.py sdist bdist_wheel

python 打包 发布--mini run - 图12

这时候你的目录会增加这么些文件:

python 打包 发布--mini run - 图13

这样就算打包好了,在 dist 目录中,以 tar.gz 结尾的是你项目的源文件,而以 .whl 结尾的就是构建好了给别人使用的发行版。

那么如何将你打包好的项目发布出来,给别人使用呢?
其实之前有说过了,这里再简单的说一下吧:
先安装一下 twine:
python3 -m pip install twine
接着使用 twine 将你打包好的文件上传到 pypi 上面去:
twine upload dist/*
这时候它会提示你输入 pypi 的账号密码:

python 打包 发布--mini run - 图14

没有怎么办?去注册一个呗,到以下链接注册:https://pypi.org/account/register/
接着输入你的账号密码,就可以上传上去了:

python 打包 发布--mini run - 图15

这时候别人就可以通过 pip 来安装你的项目了:

python 打包 发布--mini run - 图16

python 打包 发布--mini run - 图17

像这样:

python 打包 发布--mini run - 图18

然后就可以给别人使用你的包了:

python 打包 发布--mini run - 图19

你在 pip install 的时候,其实就是下载你上传的 whl 文件然后安装:

python 打包 发布--mini run - 图20

如果你不想开源,只想给你朋友使用的话,你也可以直接把 dist 这个目录下的文件发给他,让他自行安装一波就可以使用了:

python 打包 发布--mini run - 图21

python 打包 发布--mini run - 图22

daiyi instance

  1. python3 -m pip install --upgrade setuptools wheel ## 安装工具
  2. python3 setup.py sdist bdist_wheel ## 打包
  3. twine upload dist/* ## 上传 daiyi1 Fuck-pd1
  4. pip install dist/lico_core_accounting-1.1.1-py3-none-any.whl ## 本地安装
  5. pip3 install lico-core-accounting ## 远程安装

在本地

  1. >>> from todo_pkg.todolist import yy
  2. >>> a=yy()
  3. ###### this is a test /home/daiyi/todo/todo_pkg/todolist.py
  4. >>> a
  5. '###### this is a test /home/daiyi/todo/todo_pkg/todolist.py '
  6. >>> a
  7. '###### this is a test /home/daiyi/todo/todo_pkg/todolist.py

安装后

  1. >>> from todo_pkg.todolist import yy
  2. >>> aa = yy()
  3. ###### this is a test /usr/local/lib/python3.6/site-packages/todo_pkg/todolist.py
  4. >>> aa
  5. '###### this is a test /usr/local/lib/python3.6/site-packages/todo_pkg/todolist.py '
  6. >>>
  1. pip install dist/lico_core_accounting-1.1.1-py3-none-any.whl -U
  2. [root@head todo]# tree
  3. .
  4. ├── build
  5. ├── bdist.linux-x86_64
  6. └── lib
  7. └── todo_pkg
  8. ├── data
  9. └── todo.db
  10. ├── __init__.py
  11. ├── template
  12. └── edit_tash.tpl
  13. └── todolist.py
  14. ├── dist
  15. ├── lico_core_accounting-1.1.1-py3-none-any.whl
  16. └── lico-core-accounting-1.1.1.tar.gz
  17. ├── LICENSE
  18. ├── lico_core_accounting.egg-info
  19. ├── dependency_links.txt
  20. ├── PKG-INFO
  21. ├── SOURCES.txt
  22. └── top_level.txt
  23. ├── README.md
  24. ├── setup.py
  25. ├── test
  26. └── todo_pkg
  27. ├── data
  28. └── todo.db
  29. ├── __init__.py
  30. ├── __pycache__
  31. ├── __init__.cpython-36.pyc
  32. └── todolist.cpython-36.pyc
  33. ├── template
  34. └── edit_tash.tpl
  35. └── todolist.py
  36. 13 directories, 19 files
  37. [root@head todo]# cat todo_pkg/todolist.py
  38. import os
  39. def yy():
  40. print("###### this is a test %s " % __file__)
  41. return "###### this is a test %s " % __file__
  42. [root@head todo]# cat setup.py
  43. # Copyright 2020-present Lenovo
  44. # Confidential and Proprietary
  45. import setuptools
  46. with open("README.md", 'r') as f:
  47. long_description = f.read()
  48. setuptools.setup(
  49. name="lico-core-accounting",
  50. version="1.1.01",
  51. author="daiyi",
  52. long_description=long_description,
  53. long_description_content_type="text/markdown",
  54. include_package_data=True,
  55. package_data={"todo_pkg": ['template/*.tpl', 'data/*.db']},
  56. packages=setuptools.find_packages(),
  57. classifiers=[
  58. "Development Status :: 5 - Production/Stable",
  59. "Programming Language :: Python :: 3",
  60. "Programming Language :: Python :: 3.6",
  61. "Operating System :: POSIX",
  62. "Operating System :: POSIX :: Linux",
  63. ],
  64. python_requires='>=3.6',
  65. )
  66. [root@head todo]#

todo_test.tar.gz