如何上传Python库至Github仓库并通过pip命令安装

现有安装异常问题修复 #

你当前安装仅能下载信息文件，核心原因是打包配置未正确包含源码文件，按以下步骤排查即可：

• 检查setup.py的packages配置，必须正确声明要打包的代码目录，推荐直接用find_packages自动识别，参考配置：

from setuptools import setup, find_packages

setup(
    name="oauth2clientz",
    version="0.1.0",
    author="你的名称",
    description="库的描述信息",
    packages=find_packages(),
    install_requires=[
        # 这里填你的库依赖的其他包，比如 requests 等
    ]
)

• 检查Manifest.in文件，不要出现排除源码的规则，至少要包含以下配置确保必要文件被打包：

include Licence.txt
include README.md
recursive-include oauth2clientz *.py

• 本地验证打包效果：在项目根目录执行python setup.py sdist，找到生成的dist文件夹，解压其中的.tar.gz文件，确认内部包含你的所有.py源码文件，没有缺失即可。

实现pip安装的两种方案 #

方案1：直接从Github仓库安装 #

无需额外上传到其他平台，配置修复完成后，用户可直接通过以下命令安装你的库：
pip install git+https://github.com/zieadshabkalieh/oauth2clientz.git

方案2：上传PyPI实现pip install oauth2clientz直接安装 #

如果要支持用户直接输入包名安装，需要把包上传到PyPI平台，操作步骤如下：

• 注册PyPI平台账号，本地安装打包上传工具：pip install twine build
• 项目根目录执行打包命令：python -m build，会在dist目录生成.tar.gz源码包和.whl编译包
• 执行上传命令：twine upload dist/*，按提示输入PyPI的账号密码即可完成上传
• 上传成功后，所有用户都可以通过pip install oauth2clientz直接安装你的库

内容的提问来源于stack exchange，提问作者sukan