将python代码打包成pip包(可以pip install)

python代码包的用途

当你想打包一个目录时，需要现在目录中放一个_init_.py，该文件叫包初始化文件，文件可以为空，也可以放一些代码。举例：

目录hello
		——  __init__.py
		——  代码1.py
		——  代码2.py
		......

为什么这样做？
如果你想import任何有_init_.py文件的目录下的任何python代码，python都会先运行_init_.py，再运行代码文件。
添加_init_.py还有一个好处，就是在写python代码的时候不用担心python解释器找不到这个目录，不用担心你import时pycharm给你的包划红线了。
以前写代码是，如果你想导入其他项目的python代码，往往会报错，解决方法有三种：

1. 将别人的代码打成pip包，用pip安装到自己的项目
2. 在自己的代码中写sys.path.append(“别人代码的目录的路径”)
3. 在别人代码目录中创建一个__init__py

你也可以在包中添加一些全局变量或者全局类，供包中的其他代码使用，举例：

目录hello
_init_.py

class birds:
	legs = 2
	wings = 2
	head = 1

然后项目中其他任意位置的代码都可以使用init中的包全局变量和类
格式是 from 目录 import 类/变量

from hello import birds

编写setup.py

和_init_.py同级目录中创建一个setup.py，这个就是pip包安装的脚本。
setup.py

from setuptools import setup find_packages
setup(name='birds',
      version='0.0.1',
      description='birds atttributes and functions',
      author='megnet',
      author_email='[email protected]',
      requires= ['numpy','matplotlib'], # 定义依赖哪些模块
      packages=find_packages(),  # 系统自动从当前目录开始找包
      # 如果有的文件不用打包，则只能指定需要打包的文件
      #packages=['代码1','代码2','__init__']  #指定目录中需要打包的py文件，注意不要.py后缀
      license="apache 3.0"
      )

'''
name : 打包后包的文件名
version : 版本号
author : 作者
author_email : 作者的邮箱
py_modules : 要打包的.py文件
packages: 打包的python文件夹
include_package_data : 项目里会有一些非py文件,比如html和js等,这时候就要靠include_package_data 和 package_data 来指定了。package_data:一般写成{
     ‘your_package_name’: [“files”]}, include_package_data还没完,还需要修改MANIFEST.in文件.MANIFEST.in文件的语法为: include xxx/xxx/xxx/.ini/(所有以.ini结尾的文件,也可以直接指定文件名)
license : 支持的开源协议
description : 对项目简短的一个形容
ext_modules : 是一个包含Extension实例的列表,Extension的定义也有一些参数。
ext_package : 定义extension的相对路径
requires : 定义依赖哪些模块
provides : 定义可以为哪些模块提供依赖
data_files :指定其他的一些文件(如配置文件),规定了哪些文件被安装到哪些目录中。如果目录名是相对路径,则是相对于sys.prefix或sys.exec_prefix的路径。如果没有提供模板,会被添加到MANIFEST文件中。

生成whl和tar.gz文件包

python setup.py bdist_wheel # 打包为whl文件
python setup.py sdist # 打包为tar.gz文件

在和_init_.py同级目录下有一个dist目录，打包好的文件就在里面。