上传自己的pip模块

对于模块开发者本质上需要做3件事：

• 编写模块
• 将模块进行打包
• 上传到PyPI（需要先注册PyPI账号）
  • 注册PyPI账号
  • 安装上传工具
  • 基于工具进行上传

对于模块的使用者来说，只需要做2件事：

• 通过pip install 模块去安装模块
• 调用模块

假设，现在我们要做一个名称叫 zyf_timer 的模块，跟着下面的步骤一步一步的操作。

第一步 项目文件夹

根据要求创建如下文件，并填写内容

zyf_timer
├── LICENSE # 声明，给模块使用者看，说白了就是使用者是否可以免费用于商业用途等。
├── README.md # 模块介绍
├── demos # 使用案例
├── zyf_timer # 模块代码目录
│ └── __init__.py
└── setup.py # 给setuptools提供信息的脚本(名称、版本等)    

1.1 License

LICENSE文件就是咱们模块的许可证，给模块使用者看，说白了就是使用者是否可以免费用于商业用途等。一般开源的软件会选择相对宽泛许可证 MIT，即：作者保留版权，无其他任何限制。

Copyright (c) 2021 The Python Packaging Authority

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

更多其他许可证参见：https://choosealicense.com/

1.2 READNE.md

readme就是对于当前模块的描述信息，一般用于markdown格式编写，如：

### 计时器-zyf_timer

#### 安装

> pip install zyf_timer

#### 使用

```python
from zyf_timer import timeit

@timeit
def main():
    time.sleep(1)
    ...
```

设置保留位数，默认保留两位小数

```python
from zyf_timer import timeit_with_digit

@timeit_with_digit(digit=4)
def main():
    time.sleep(1)
    ...
```

此文件也可以写模块的简单使用手册，如果手册太复杂建议再创建一个doc文件夹存放使用手册。

1.3 demos目录

demos一般会写一些该模块使用的示例，用于使用者快速可以将模块应用到生成中。get-pip.py [1]

注意：已安装用户，如要更新setuptools和wheel两个工具，可通过如下命令：

python -m pip install --upgrade setuptools wheel

2.2 打包代码

python setup.py sdist bdist_wheel

zyf_timer
│  LICENSE
│  README.md
│  setup.py
│
├─build
│  ├─bdist.win-amd64
│  └─lib
│      └─zyf_timer
│              __init__.py
│
├─demos
├─dist
│      zyf_timer-2.0-py3-none-any.whl
│      zyf_timer-2.0.tar.gz
│
├─zyf_timer
│      timer.py
│      __init__.py
│
└─zyf_timer.egg-info
        dependency_links.txt
        PKG-INFO
        SOURCES.txt
        top_level.txt

2.3 发布模块（上传）

文件打包完毕后，需要将打包之后的文件上传到PyPI，如果想要上传是需要先去 https://pypi.org/ 注册一个账号。

• 安装用于发布模块的工具：twine 【已安装无需重复安装】

python -m pip install --upgrade twine
或
pip install --upgrade twine
# 提示：python -m 的作用是 run library module as a script (terminates option list)

• 发布（上传）

python -m twine upload --repository-url https://upload.pypi.org/legacy/ dist/*
或
twine upload --repository-url https://upload.pypi.org/legacy/ dist/*

• 上传时，提示需要输入PyPI的用户名和密码.

第三步 安装使用

3.1 安装

pip install zyf_timer

如果提示找不到对应的版本，可能是因为你使用的是国内镜像，刚发布的包还未同步，这时可以指明使用官方源下载。

pip install zyf_timer -i https://pypi.python.org/simple

3.2 应用

import time
from zyf_timer.timer import timeit


@timeit
def main():
    time.sleep(1)


if __name__ == '__main__':
    main()