1、模块与包管理

>>> import builtins
>>> builtins.print("cce")
cce
>>> print("cce")         
cce

# 应用程序层级
[cce@doorta py] tree                
├── main.py
└── mod
    ├── __init__.py
    ├── core1.py
    ├── core2.py
    └── core3.py
[cce@doorta py] cat mod/core1.py
num=1
[cce@doorta py] cat mod/core2.py
num=2
[cce@doorta py] cat mod/core3.py
num=3
# 初始化文件
[cce@doorta py] cat mod/__init__.py 
__all__ = [ "core1" , "core2" ]
# 主程
[cce@doorta py] cat main.py
from mod import *

print(core1.num)
print(core2.num)
print(core3.num)
# 可以看到，包内部的模块，如果没有加入__all__的话，在外部使用from mod import *是导入不成功的
[cce@doorta py] python3.5 main.py
1
2
Traceback (most recent call last):
  File "main.py", line 5, in <module>
    print(core3.num)
NameError: name 'core3' is not defined

单文件模块：直接复制到指定的模块搜索路径即可；
多文件包：基于distutils工具发布，包含setup.py文件；
egg格式：直接使用setuptools提供的easy_install进行安装，安装时可能会出现下载以来包都情况；
whl格式：本质是zip，主要是用来代替egg，使用pip进行安装，安装时可能会出现下载以来包都情况；
在线安装：pip和easy_install都可以通过安装源自动下载并安装，常见的国内源有阿里、豆瓣、清华大学等；

# build
--build-base：指定build目录，build会创建build目录，如果说期望在别的地方进行build，保持源码的整洁程度，可以使用此参数，build完成之后会生成一个lib目录，此文件用于保存即将安装的模块文件的，其中lib模块用于保存纯Python语言所研发的模块，因为它的跨平台的，如果说Python代码有一些非Python代码，比如C++等，那么编译完成之后会是lib.platform里面；

# install
--user：将模块安装到用户的家目录的相关目录当作；
--prefix：自定义安装路径，指定Python文件的安装路径；
--exe-prefix：指定与Python无关的，由其他语言所实现的，和平台有关的，已经编译好的相关文件安装路径；

setup.py：主要用来描述包的信息，比如包的名称，作者名称，版本信息等；
    name：包的名称(必须)；
    version：包的版本号(必须)；
    author：作者名称；
    author_email：作者电子邮箱；
    maintainer：维护者名称；
    maintainer_email：维护者邮箱；
    url：包的主页；
    description：包的简短描述；
    long_description：包的详细描述；
    download_url：包的下载位置；   
    py_modules：打包的工程里面可能存在独立的模块文件，那么此时我们就需要将打包的模块名字写进来，不写默认不会一起打包，这个参数是各独立的模块名称组成的列表，此模块可能位于包根目录下(modname)；
    packages：打包的工程里面可能存在多个子包，那么此时，我们也需要将这个要打包的子包名写入到该参数中，该参数也是一个列表，直接写入子包名即可；
    license：许可证；
    platforms：适用的平台列表；
    data_files：需要打包的数据文件列表；
README.rst：主要是对long_description进行修饰的；
LICENSE.txt：声明库对使用责任等等，比如所有权归属，是否可进行商业用途等；
MANIFEST.in：配置是否包含打包文件，类似nginx的include，可忽略；

# setup.py
from distutils.core import setup

setup(
    name="testmod",
    version="0.0.1",
    author="cce",
    author_email="mail0426@163.com",
    py_modules=["testmod"],
    url="blog.doorta.com",
    description="A simple module"
)

[root@node1 cce]# python3.5 setup.py --help-formats # 获取帮助；
[root@node1 cce]# python3.5 setup.py --help-commands # 获取所有可使用的命令；
[root@node1 cce]# python3.5 setup.py bdist COMMAND --help # 获取特定命令的帮助；
[root@node1 cce]# python3.5 setup.py bdist COMMAND --help-formats # 获取特定命令的格式；

# 共有参数
    sdist：源码打包
        zip：将源码打包为一个zip文件，不进行编译；
        gztar：将源码打包为一个tar.gz文件，不进行编译；
        bztar：将源码打包为一个tar.bz2文件，不进行编译；
        ztar：将源码打包为一个tar.z文件，不进行编译；
        tar：将源码打包为一个tar文件，不进行编译；
    bdist：打包格式类型
        gztar：将源码编译，并打包成tar.gz的自解压格式的压缩包；
        bztar：将模块编译，并打包成一个tar.bz2自解压格式的压缩包；
        ztar：将源码编译，并打包成一个tar.z自解压格式的压缩包；
        zip：将源码编译，并打包成一个zip自解压格式的压缩包；
        rpm：将源码编译，并打包成rpm自解压格式的包；
        pkgtool：将源码编译，并打包成Solaris的自解压格式的压缩包；
        wininst：将源码编译，并打包成windows上能够自解压的zip格式的包；
        msi：将源码编译，并打包成Microsoft Installer，windows上的可安装程序；
# distutils独有参数
    bdist_dumb：将源码编译，并打包成自解压格式的tar、tar.gz、tar.bz2等格式的包，格式通过--fromat指定；
    bdist_rpm：将源码编译，并打包成自解压格式的rpm包；
    bdist_wininst：将源码编译，并打包成windows上能够自解压的zip格式的包；
    bdist_msi：将源码编译，并打包成自解压格式的Microsoft Installer程序，在windows上的可直接安装解压；
# setuptools独有参数
    bdist_egg：将源码编译，并打包成支持easy_install支持的egg格式的包；
    bdist_wheel：将源码编译，并打包成支持pip和easy_install支持的whl格式的包；

# 创建一个容器
[root@node1 containers]# mkdir containers
# 创建一个包
[root@node1 containers]# mkdir cce
# 创建初始化文件
[root@node1 containers]# touch cce/__init__.py
# 创建核心程序
[root@node1 containers]# cat >> cce/getcce.py << EOF
def getinfo():
    return "cce"
EOF
# 创建README文件
[root@node1 containers]# echo "testmod" > cce/README.txt
# 创建setup.py文件
[root@node1 containers]# cat >> cce/setup.py << EOF
from distutils.core import setup

setup(
    name=          "cce",
    version=       "0.0.1",
    author=        "caichangen",
    author_email=  "mail0426@163.com",
    py_modules=    ["getcce"],
    url=           "http://blog.doorta.com",
    description=   "A simple module"
)
EOF
# 开始打包
[root@node1 containers]# python3.5 setup.py sdist
[cce@doorta cce] ls dist 
cce-0.0.1.tar.gz
# 使用bdist打包
[root@node1 cce]# python3.5 setup.py bdist
[root@node1 dist]# ls
cce-0.0.1.linux-x86_64.tar.gz
[root@node1 dist]# tar xf cce-0.0.1.linux-x86_64.tar.gz 
[root@node1 dist]# tree 
├── cce-0.0.1.linux-x86_64.tar.gz
└── usr
    └── local
        └── python352
            └── lib
                └── python3.5
                    └── site-packages
                        ├── cce-0.0.1-py3.5.egg-info
                        ├── getcce.py
                        └── __pycache__
                            └── getcce.cpython-35.pyc
# 使用bdist打包成rpm格式
[root@node1 cce]# python3.5 setup.py bdist --formats=rpm
[root@node1 cce]# ls dist/
cce-0.0.1-1.noarch.rpm  cce-0.0.1-1.src.rpm  cce-0.0.1.tar.gz
[root@node1 cce]# rpm -qpl dist/cce-0.0.1-1.noarch.rpm 
/usr/local/python352/lib/python3.5/site-packages/__pycache__/getcce.cpython-35.opt-1.pyc
/usr/local/python352/lib/python3.5/site-packages/__pycache__/getcce.cpython-35.pyc
/usr/local/python352/lib/python3.5/site-packages/cce-0.0.1-py3.5.egg-info
/usr/local/python352/lib/python3.5/site-packages/getcce.py
[root@node1 cce]# rpm -qpi dist/cce-0.0.1-1.noarch.rpm 
Name        : cce
Version     : 0.0.1
Release     : 1
Architecture: noarch
Install Date: (not installed)
Group       : Development/Libraries
Size        : 1264
License     : UNKNOWN
Signature   : (none)
Source RPM  : cce-0.0.1-1.src.rpm
Build Date  : Wed 06 Jan 2021 12:52:51 PM CST
Build Host  : node1.doorta.com
Relocations : /usr 
Vendor      : caichangen <mail0426@163.com>
URL         : http://blog.doorta.com
Summary     : A simple module
Description :
UNKNOWN
# 安装模块
[root@node1 dist]# rpm -ivh cce-0.0.1-1.noarch.rpm
# 测试模块
[root@node1 dist]# python
>>> import getcce
>>> getcce.getinfo()
'cce'

# 常见一个与项目同名的打包目录(重要)
[cce@doorta study] mkdir ccelib
[cce@doorta study] cd ccelib
# 在打包目录创建一个项目
[cce@doorta ccelib] mkdir -p ccelib/tools
[cce@doorta ccelib] touch ccelib/{main.py,tools/{__init__.py,sumdata.py}}
[cce@doorta ccelib] tree
└── ccelib
    ├── main.py
    └── tools
        ├── __init__.py
        └── sumdata.py
[cce@doorta ccelib] cat ccelib/tools/sumdata.py     
data=1
[cce@doorta ccelib] cat ccelib/main.py 
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
from ccelib.tools import sumdata
def ret():
    return sumdata.data
# 准备setup.py描述文件
[cce@doorta ccelib] cat setup.py 
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
from setuptools import setup

setup(
    name="ccelib",
    version="1.0.3",
    description="test mode",
    packages=["ccelib","ccelib.tools"],  # 需要打包的子包
    py_modules=["ccelib.main"],  # 需要打包的单文件模块
    author="BrYan",
    author_email="mail0426@163.com",
    long_description="this is test module"
)

# 打包成tar格式文件
[cce@doorta ccelib] python3.5 setup.py sdist --formats=gztar
# 安装ccelib模块
[cce@doorta ccelib] pip3 install dist/ccelib-1.0.0.tar.gz
# 使用ccelib模块
>>> from ccelib import main
>>> main.ret()
1
# 打包egg格式文件
[cce@doorta ccelib] python3.5 setup.py bdist_egg
# 安装egg格式
[cce@doorta dist] easy_install-3.5 ccelib-1.0.0-py3.5.egg
# 打包whl格式
[cce@doorta ccelib] python3.5 setup.py bdist_wheel
# 安装whl格式
[cce@doorta dist] pip install ccelib-1.0.0-py3-none-any.whl 
[cce@doorta dist] easy_install ccelib-1.0.0-py3-none-any.whl

# windows平台
# 分别打包三种格式
[cce@doorta ccelib] python3.5 setup.py sdist --formats=gztar
[cce@doorta ccelib] python3.5 setup.py bdist_egg 
[cce@doorta ccelib] python3.5 setup.py bdist_wheel  
[cce@doorta ccelib] ls dist 
ccelib-1.0.0-py3-none-any.whl   ccelib-1.0.0-py3.5.egg          ccelib-1.0.0.tar.gz
# windows上使用使用twine将包上传到pypi，twine即可上传

# macos平台
# mac上传首先需要准备一个配置文件，然后直接使用python命令上传
[cce@doorta ccelib] cat ~/.pypirc  
[distutils]
index-servers=pypi
[pypi]
repository = https://upload.pypi.org/legacy/
username = caichangen
password = cai19960426cce
# 打包并上传tar格式
[cce@doorta ccelib] python setup.py sdist --formats=tar upload -r pypi
# 打包并上传egg格式
[cce@doorta ccelib] python3.5 setup.py bdist_wheel upload -r pypi
# 安装上传的包
[cce@doorta ccelib] pip3 install ccelib -i https://pypi.python.org/simple

# 安装pipreqs
[cce@doorta ccelib] pip3 install pipreqs
# 进行项目的根目录将所使用的模块导出
[cce@doorta ccelib] pipreqs               
INFO: Successfully saved requirements file in /usr/local/Project/study/ccelib/requirements.txt
# 当项目拿到新环境的时候就可以直接使用pip进行安装了
[cce@doorta ccelib] pip3 install -r requirements.txt