Python上传模块

### 如何将Python模块发布至PyPI

#### 准备工作
为了能够顺利地将创建好的Python包上传到PyPI，开发者需先确保已安装必要的工具并配置好环境。通常情况下，`setuptools` 和 `twine` 是两个不可或缺的库。前者用于构建和分发软件包；后者则提供了安全可靠的上传机制。

#### 创建项目结构
合理的目录布局有助于简化后续操作流程。一个典型的Python包应该至少包含以下几个部分：

- **setup.py**: 这是一个非常重要的文件，它定义了关于要发布的包的各种元数据信息以及依赖关系等[^1]。

- **README.md** 及 **LICENSE**: 虽然这些文档不是打包过程中的必需品，但对于潜在使用者来说却是极其宝贵的资源，因为它们能提供有关项目的背景介绍和技术细节说明[^5]。

#### 编写 setup.py 文件
此脚本负责描述即将被分享出去的内容及其属性。下面给出了一段简单的模板作为参考：

from setuptools import setup, find_packages

setup(
    name='your_module_name',
    version='0.1',  # 版本号对于更新至关重要，每次修改都需要调整该数值[^3].
    description='A brief summary.',
    long_description=open('README.md').read(),
    author='Your Name',
    url='https://github.com/user/repo',
    packages=find_packages(),  # 自动查找所有子包.
    install_requires=[
        'numpy>=1.8.0,<2.0'  # 列出运行时所需的第三方库版本范围.
    ],
)

#### 构建与测试发行版
完成上述准备工作之后，就可以着手制作可供分发的形式了。通过命令行执行如下指令来生成`.tar.gz`压缩包形式的源码分布档案（source distribution），还有wheel格式二进制分发文件：

python setup.py sdist bdist_wheel

#### 使用 Twine 发布
最后一步就是借助Twine把刚刚做好的制品推送到官方仓库里去啦！在此之前记得注册账号获取API Token哦～接着按照提示输入用户名密码即可成功提交新作品咯！

pip install twine
twine upload dist/*