将 pyparamvalidate 项目,发布至 pypi

简介: 将 pyparamvalidate 项目,发布至 pypi

一、前置说明


1、本节目标

  • 了解发布至 pypi 的基本流程。
  • pyparamvalidate 项目,发布至 pypi


2、相关回顾


二、操作步骤


1、项目目录


  • atme : @me 用于存放临时的代码片断或其它内容。
  • pyparamvalidate : 新建一个与项目名称同名的package,为了方便发布至 pypi
  • core : 用于存放核心代码。
  • tests : 用于存放测试代码。
  • utils : 用于存放一些工具类或方法。
  • LICENSE : 描述许可证内容。
  • pyproject.toml : 描述打包信息。
  • README.md : 描述项目说明文档。


2、编写 pyproject.toml 文件

# 指定构建后端
[build-system]
# 指定构建所依赖的包,在构建时自动安装依赖包
requires = ["hatchling"]
# 指定构建后端为 hatchling.build
build-backend = "hatchling.build"
[project]
# 项目名称
name = "pyparamvalidate"
# 版本号
version = "0.3.2"
# 作者
authors = [
    { name = "kindtester", email = "kindtester@foxmail.com" },
]
# 项目描述
description = "一个简单易用的 Python 函数参数校验装饰器。提供多种内置验证器,支持自定义验证规则,帮助开发者轻松进行函数参数校验。"
# 说明文档: 该说明文档的内容将展示在 pypi 项目首页的 Project description, 此 README.md 就是同级目录下的 README.md 文档
readme = "README.md"
# python 版本要求
requires-python = ">=3.9"
# 分类器描述,用于说明包的元数据信息,以便开发者和用户能够更容易地了解该包的特性、兼容性和用途
# 下面是一个典型的分类器,描述了该项目适用于 Python 3,采用 MIT 许可证,且独立于操作系统
classifiers = [
    "Programming Language :: Python :: 3",
    "License :: OSI Approved :: MIT License",
    "Operating System :: OS Independent",
]
# 项目的依赖包:在 pip install pyparamvalidate 时,会自动安装这些依赖包
dependencies = [
    'pytest',
    'schema',
]
# 相关链接:指定之后可以在 pypi 项目首页的 Project links 显示该链接
[project.urls]
homepage = "https://github.com/xyouwen/pyparamvalidate"
# github 仓库:指定之后可以在 pypi 项目首页使用 GitHub statistics
[project.github]
repository = "https://github.com/xyouwen/pyparamvalidate"
# 指定要打包的目录
[tool.hatch.build.targets.wheel]
# 此处只打包 pyparamvalidate 及其所有子目录
packages = ["pyparamvalidate"]


3、编写 LICENSE 文件

此处使用 MIT 许可协议,它是一种宽松的、自由的许可协议,允许软件的自由使用、修改、分发和私有化。

MIT License
Copyright (c) 2024 kindtester
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.


4、编写 README.md 文件

请参考 github 中的 README.md 文档,顺便帮忙点个小星星。


5、升级 pip、build、twine 工具

某些命令需要较新版本的工具,因此需要对工具进行升级:

pip install --upgrade pip
pip install --upgrade build
pip install --upgrade twine


6、打包发布的版本

python -m build


打包过程需要一定时间,打包完成后,在项目目录中会新增 dist 目录:


7、测试发布至 TestPyPI

TestPyPI 上,可以测试的 Python 软件包的发布和分发流程,而不会影响到真正的 PyPI 上的软件包。


1) 在 TestPyPI 上注册一个帐户: https://test.pypi.org/account/register/

2)完成 Two factor authentication (2FA) 验证

安装谷歌浏览器插件 身份验证器 :

https://chrome.google.com/webstore/detail/authenticator/bhghoamapcdpbohphigoooaddinpkbai


安装后点击扫描,选中网页提供的二维码,插件会生成一个code,粘贴到网页需要输入code的地方。


3)生成 API token

复制这个 token:


4)上传至 testpypi

twine upload --repository testpypi dist/*

username: __token__

password刚才复制的 token


8、创建测试项目,测试发布结果

点击上传至 test.pypi 之后的 View at 链接跳转:



复制 pip install 内容:

pip install -i https://test.pypi.org/simple/ pyparamvalidate==0.3.3


在测试项目中安装后测试功能是否正常:

在 Lib 目录下的 sitepackage 目录查看包是否正常:


9、正式发布至 PyPI

PyPI(Python Package Index)是Python的官方软件包索引,用于存储和分发 Python 软件包。


1)在 pypi 上注册一个账户: https://pypi.org

2)完成 Two factor authentication (2FA) 验证,过程与第 7 步 相同

3)生成 API token,过程与第 7 步 相同

4)上传至 pypi

twine upload dist/*


10、测试正式发布结果

测试过程与第 8 步骤相同。

测试通过后,发布完成。


三、后置说明


1、要点小结


2、下节准备

  • 连载完。

点击进入《Python装饰器从入门到进阶》总目录

目录
相关文章
|
Python
项目依赖的python包requirements.txt文件的生成与安装
项目依赖的python包requirements.txt文件的生成与安装
426 0
|
API Python
pypi发布问题
我最经在发布我的更新包的时候遇到了ERROR HTTPError: 403 Forbidden from https://upload.pypi.org/legacy/ Invalid or non-existent authentication information. See https://pypi.org/help/#invalid-auth for more information.这样的问题。
|
4月前
|
项目管理 数据安全/隐私保护 Python
使用poetry来更优雅的管理 python 包
Poetry 的优势在于它提供了一个统一的工具来处理 Python 项目的整个生命周期,从依赖管理到打包和发布。它的依赖解析器非常强大,能够有效地处理复杂的依赖关系。此外,Poetry 还提供了一个直观的命令行界面,使得项目管理变得更加简单。 对于团队协作和项目部署来说,Poetry 的依赖锁定功能(通过 poetry.lock 文件)特别有用,因为它确保了所有环境中使用相同版本的依赖。
|
4月前
|
Unix API Apache
一站式解决 python打包代码,发布到pypi
本文是一份全面的Python项目打包并发布到PyPI的教程,涵盖了从PyPI账户注册、配置双因素认证、生成API Token,到准备代码、编写setup.py、选择LICENSE、构建包、上传包至PyPI,以及上传后的测试和库更新的详细步骤。
|
4月前
github下载的.ipynb文件报错unreadable Notebook NotJSONError
【8月更文挑战第2天】文章提供了解决GitHub下载的Jupyter Notebook文件打开时报错的方法,包括端口冲突和文件加载错误。
93 0
github下载的.ipynb文件报错unreadable Notebook NotJSONError
|
4月前
|
JavaScript
GitHub——自动发布NPM包
GitHub——自动发布NPM包
33 0
|
7月前
|
IDE 开发工具 Python
发布Package到PyPI
发布Package到PyPI
40 0
|
Python
Python实战:GitHub Actions自动构建pypa/gh-action-pypi-publish自动发布新版本到pypi
Python实战:GitHub Actions自动构建pypa/gh-action-pypi-publish自动发布新版本到pypi
231 0
|
Python
Python项目requirements.txt依赖包如何生成?
Python项目requirements.txt依赖包如何生成?
221 0
Python项目requirements.txt依赖包如何生成?
|
Apache 网络架构 Python