Python打包发布

python打包分发
==================

打包工具:setuptools,wheel
------------------


###操作顺序：
####1. 项目配置准备，主要是在项目根目录下添加一个文件，其中setup.py是必有的，其他按需配置，下面给出例子
>import setuptools

>with open("README.md", "r",encoding="UTF-8") as fh:
    long_description = fh.read()

>setuptools.setup(
    name="ownmodule",
    version="0.0.1",
    author="jumprn",
    author_email="author@example.com",
    description="A small example package",
    long_description=long_description,
    long_description_content_type="text/markdown",
    url="",
    packages=setuptools.find_packages(),
    classifiers=[
        "Programming Language :: Python :: 3",
        "License :: OSI Approved :: MIT License",
        "Operating System :: OS Independent",
    ],
)

其中含义看名字其实也很清楚了，比较重要的几个讲一下，name是项目的wheel名称，version也很重要，升级的时候会涉及到，其次是packages是你那些包要打包:setuptools.find_packages()则是表明获取当前目录下的所有包，当然你可能会不需要一些包，可以通过给find_packages(exclude=['',''])方式传参过滤。
然后还会有一个README文件，就是介绍项目的，可有可不有，还有LICENSE，申明版权的，一样可有可不有


2. 安装wheel
    pip install --upgrade wheel

3. 使用wheel执行打包命令
    >切换目录到你要打包的顶层目录（与setup.py同级别）执行:python setup.py bdist_wheel。如果你要打包源代码可以在后面再加上:sdist  sdist代表源代码打包，bdist_wheel代表构建包，默认会打包成.tar.gz文件
    
此时，我们的打包工作已经做完了，如果只是本地想用，那么，只需要到你想要引入此包的项目下执行：pip install 目录/包名  即可，跟安装第三方模块差不多。

####2. 发布打包到pypi
添加配置文件(.pypirc)：

    [distutils]
    index-servers = local
    [local]
    repository: 你的私仓地址
    username: <USERNAME>
    password: <PASSWORD>
windows下将此文件放置在用户目录空间下。我的是:C:\users\80306803并将文件名字设置成:.pypirc.  
如果不设置上述文件，在执行下面命令时会报错AssertionError("unsupported scheme "" +schema)。
>2，打包发布，在要打包的项目根目录下（跟上述的setup.py是同一级），执行命令：python setup.py sdist upload -r local(发布python Egg包)  命令:python setup.py bdist_wheel upload -r local(发布python wheel包)

那么整个打包流程就算结束了。