学习笔记:发布自己的python模块安装包

版权声明:本文为博主原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。
本文链接: https://blog.csdn.net/xufive/article/details/88640229

0. 前言

发布自己的python模块安装包,首先得把自己的模块做成 .whl 格式的文件,然后再找个地儿存放它,接下来就是在 pip 命令中使用 -i 参数指定这个地儿(下载源)。Just so sooooooooo

1. 准备工作

(1) 注册 pypi.org 用户

我原本就是 pypi 的注册用户,但当我上传 .whl 格式的文件时,却被提示无权限。仔细阅读相关文档才发现,还需要在https://test.pypi.org/account/register/ 注册。我不确定是不是仅在这里注册就可用了。

(2) 使用 pip 安装或升级几个必备工具

生成和上传 .whl 格式的文件需要几个特殊工具,好在这几个工具使用 pip 就可以轻松搞定。

py -3 -m pip install --user --upgrade setuptools wheel 
py -3 -m pip install --user --upgrade twine

2. 规划文件目录

假定要发布的模块名称为 wxgl,包含 scene.py, region.py, colorbar.py 等三个文件。文件目录结构如下:

/wxgl_pkg
	wxgl
		__init__.py
		colorbar.py
		 region.py
		scene.py
	README.md
	setup.py

(1) init.py

该文件其内容可以为空。我的 init.py文件如下:

-*- coding: utf-8 -*-

name = 'wxgl'
version = "0.3.0"
version_info = (0, 3, 0, 0)

(2) README.md

关于安装和使用的说明,文本文件,不能使用中文。

(3) setup.py

# -*- coding: utf-8 -*-
import setuptools

with open("README.md", "r") as fh:
    long_description = fh.read()

setuptools.setup(
    name="wxgl",
    version="0.3.0",
    author="xufive",
    author_email="[email protected]",
    description="A 3d library based pyOpenGL.",
    long_description=long_description,
    long_description_content_type="text/markdown",
    url="https://github.com/xufie/wxgl",
    packages=setuptools.find_packages(),
    classifiers=[
        "Programming Language :: Python :: 3",
        "License :: OSI Approved :: MIT License",
        "Operating System :: OS Independent",
    ],
)

提醒一点:License 很重要,pipy 检查很严格,不可乱写。最初是我使用 GPL,检查失败,后改用 MIT 才通过。

3. 生成安装包文件

运行 setup.py 脚本,生成安装包文件

py -3 setup.py sdist bdist_wheel

顺利的话,你可以看到 dist 文件夹:

/wxgl_pkg
	dist
		wxgl-0.3.0-py3-none-any.whl
		wxgl-0.0.1.tar.gz
	wxgl
		__init__.py
		colorbar.py
		 region.py
		scene.py
	README.md
	setup.py

如果只需要 .whl 文件,就运行:

py -3 setup.py bdist_wheel

4. 上传安装包文件

切换到 dist 路径下,运行:

py -3 -m twine upload --repository-url https://test.pypi.org/legacy/ dist/*

根据提示输入用户名、密码,稍等片刻,即可完成。

5. 安装

使用 -i 参数,指定安装源为https://test.pypi.org/simple/,其他参数不变:

py -3 -m pip install -i https://test.pypi.org/simple/ wxgl

猜你喜欢

转载自blog.csdn.net/xufive/article/details/88640229