文章目录
1.环境搭建
1.1 换源
- 在pip安装时使用
-i
参数,可以指定源。以下有许多种国内源可以选择
https://pypi.tuna.tsinghua.edu.cn/simple
http://mirrors.aliyun.com/pypi/simple/
https://pypi.mirrors.ustc.edu.cn/simple/
http://pypi.hustunique.com/
http://pypi.sdutlinux.org/
http://pypi.douban.com/simple/
1.2 安装wheel
pip install wheel -i https://pypi.tuna.tsinghua.edu.cn/simple
1.3 安装twine
pip install twine -i https://pypi.tuna.tsinghua.edu.cn/simple
1.4 注册PyPI账号
去此网址注册一个即可
2.编写setup.py
2.1 项目文件树
- 你的项目可能是这样的…
2.2 编写setup.py文件
setup.py文件是用来打包和上传你的包的重要文件,它有固定的编写范式。下面我将给出我的demo并附上详细注释。
from setuptools import setup, find_packages
from os import path
this_directory = path.abspath(path.dirname(__file__))
with open(path.join(this_directory, 'README.md'), encoding='utf-8') as f:
long_description = f.read()
setup(
#关于classifiers的描述详见如下
#https://pypi.org/search/?q=&o=&c=Topic+%3A%3A+Software+Development+%3A%3A+Build+Tools
classifiers=[
# 属于什么类型
"Topic :: Software Development :: Libraries :: Python Modules",
# 发展时期,常见的如下
# Development Status:: 1 - Planning
# Development Status:: 2 - Pre - Alpha
# Development Status:: 3 - Alpha
# Development Status:: 4 - Beta
# Development Status:: 5 - Production / Stable
# Development Status:: 6 - Mature
# Development Status:: 7 - Inactive
"Development Status :: 4 - Beta",
# 许可证信息
"License :: OSI Approved :: MIT License",
# 目标编程语言
# Programming Language :: C
# Programming Language :: C++
# Programming Language :: Python :: 3.4
# Programming Language :: Python :: 3.5
# Programming Language :: Python :: 3.6
# Programming Language :: Python :: 3.7
# Programming Language :: Python :: 3.8
# Programming Language :: Python :: 3.9
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3.3",
"Programming Language :: Python :: 3.4",
"Programming Language :: Python :: 3.5",
"Programming Language :: Python :: 3.5",
"Programming Language :: Python :: 3.6",
"Programming Language :: Python :: 3.7",
"Programming Language :: Python :: 3.8",
"Programming Language :: Python :: 3.9",
#运行的操作系统
#"Operating System :: POSIX :: Linux"
"Operating System :: Microsoft :: Windows :: Windows 11"
#运行的环境
#"Environment :: GPU :: NVIDIA CUDA :: 12"
# 开发的目标用户
# Intended Audience :: Customer Service
# Intended Audience :: Developers
# Intended Audience :: Education
#...
# Intended Audience :: End Users/Desktop
# Intended Audience :: Financial and Insurance Industry
# Intended Audience :: Healthcare Industry
"Intended Audience :: End Users/Desktop",
#自然语言
#"Natural Language :: English"
"Natural Language :: Chinese (Simplified)"
],
#如果上传时出现ERROR:The user '' isn't allowed to upload to project '',换个名字,长一点无所谓,不能跟别人重复
name="projectTemplate",
version="1.0.0",
author="Han Xu",
author_email="[email protected]",
description="This is a project template.",
long_description=long_description,
#README.md文本的格式,如果希望使用markdown语言就需要下面这句话
long_description_content_type="text/markdown",
#存放源码的地址,填入gitee的源码网址即可
#url="",
packages=find_packages(),
# 安装过程中,需要安装的静态文件,如配置文件、service文件、图片等
# data_files=[
# ("", ["conf/*.conf"]),
# ("/usr/lib/systemd/system/", ["bin/*.service"]),
# ],
# 希望被打包的文件
# package_data={
# "":["*.txt"],
# "bandwidth_reporter":["*.txt"]
# },
# 不打包某些文件
# exclude_package_data={
# "bandwidth_reporter":["*.txt"]
# },
# 表明当前模块依赖哪些包,若环境中没有,则会从pypi中下载安装
#install_requires=["","",""],
# setup.py 本身要依赖的包,这通常是为一些setuptools的插件准备的配置
# 这里列出的包,不会自动安装。
# setup_requires=["",],
# 仅在测试时需要使用的依赖,在正常发布的代码中是没有用的。
# 在执行python setup.py test时,可以自动安装这三个库,确保测试的正常运行。
# tests_require=[
# "",
# ],
# 用于安装setup_requires或tests_require里的软件包
# 这些信息会写入egg的 metadata 信息中
# dependency_links=[
# "",
# ],
# install_requires 在安装模块时会自动安装依赖包
# 而 extras_require 不会,这里仅表示该模块会依赖这些包
# 但是这些包通常不会使用到,只有当你深度使用模块时,才会用到,这里需要你手动安装
# extras_require={
# "": [""],
# },
)
- 根据自己的需要更改即可
3.构建
- 在项目空间下执行如下指令:
python setup.py sdist bdist_wheel
- 可以看到项目文件树变成了这样
4.上传
- 在项目空间下执行如下指令:
twine upload -u <the usrname of your PyPI account> -p <the password of your PyPI account> dist/<the files you want to upload>
- 如果你更新了代码,记得更新setup.py中的版本号,重新构建你的代码,再次上传就好了。