企业官网建设流程全解析

企业网站的设计与实现论文,做基网站,中小企业微信网站建设,温州建设集团官方网站本教程将带你一步步打包一个简单的 Python 项目。你将学习如何添加必要的文件和目录结构来创建一个可发布的包#xff0c;如何构建这个包#xff0c;并将其上传到 Python Package Index (PyPI)。 部分命令需要较新版本的 pip#xff0c;因此请先确保你已安装最新版#xf…本教程将带你一步步打包一个简单的 Python 项目。你将学习如何添加必要的文件和目录结构来创建一个可发布的包如何构建这个包并将其上传到 Python Package Index (PyPI)。部分命令需要较新版本的 pip因此请先确保你已安装最新版# Windows 用户python-m pip install--upgrade pip一个简单的项目本教程使用一个名为 example_package_YOUR_USERNAME_HERE 的示例项目。例如如果你的用户名是 me那么包名就是 example_package_me。这样可以确保你的包名是唯一的不会与其他学习者上传的包冲突。我们建议你先完整地按照本教程操作一遍这个示例项目之后再尝试打包自己的项目。在本地创建如下目录结构packaging_tutorial/ └── src/ └── example_package_YOUR_USERNAME_HERE/ ├── __init__.py └── example.py 说明包含 Python 模块的目录名称应与项目名一致。这不仅简化了配置也更便于用户理解。init.py 文件的存在使得该目录能被当作一个标准的 Python 包导入即使它是空的。example.py 是包中的一个模块用于存放你的核心逻辑如函数、类、常量等。打开它并写入以下内容defadd_one(number):returnnumber1创建好上述结构后请确保后续所有命令都在 packaging_tutorial/ 目录下执行。添加打包所需的文件接下来你需要添加一些用于准备发布项目的文件。完成后项目结构应如下所示packaging_tutorial/├── LICENSE ├── pyproject.toml ├── README.md ├── src/│ └── example_package_YOUR_USERNAME_HERE/│ ├── __init__.py │ └── example.py └── tests/创建测试目录tests/ 是预留的测试文件目录目前可以留空。选择构建后端Build Backend像 pip 和 build 这样的工具本身并不负责将源代码打包成分发格式例如 wheel 文件这项工作由 构建后端build backend 完成。构建后端决定了你的项目如何声明元数据如包名、版本、作者、PyPI 上显示的信息等以及哪些文件需要被打包。不同的后端功能略有差异例如是否支持编译 C 扩展模块你可以根据需求选择合适的工具。常见的构建后端包括Hatchling本教程默认使用SetuptoolsFlitPDMuv-build⚠️ 注意某些构建工具如 PDM、Hatch还提供了额外功能比如项目初始化、版本管理、上传等。但本教程仅使用独立的、单一用途的工具如 build 和 twine。构建后端的选择通过 pyproject.toml 文件中的 [build-system] 部分指定。以下是几个常见后端的配置示例Hatchling推荐[build-system]requires[hatchling 1.26]build-backendhatchling.buildSetuptools[build-system]requires[setuptools 61.0,wheel]build-backendsetuptools.build_meta 说明requires 列出了构建包所必需的依赖项通常包括构建后端本身。前端工具如 build会在隔离环境中自动安装这些依赖。build-backend 指定了用于执行构建的 Python 对象路径。这两个字段通常由你选择的构建工具文档提供一般无需手动修改。配置项目元数据打开 pyproject.toml填入以下内容。记得将包名中的 YOUR_USERNAME_HERE 替换为你的实际用户名以确保唯一性[project] name example_package_your_username_here version 0.0.1 authors [ { name Example Author, email authorexample.com }, ] description 一个简单的示例包 readme README.md requires-python 3.9 classifiers [ Programming Language :: Python :: 3, Operating System :: OS Independent, ] license { text MIT } license-files [LICENSE] [project.urls] Homepage https://github.com/pypa/sampleproject Issues https://github.com/pypa/sampleproject/issues字段说明name包的分发名称。只能包含字母、数字、.、_、-且不能与 PyPI 上已有包重名。version包的版本号某些后端支持从 Git 标签或文件中自动读取。authors作者信息可包含姓名和邮箱。也可用相同格式列出维护者maintainers。description简短的一句话描述。readme指向 README 文件的路径内容会显示在 PyPI 项目页面上。requires-python指定项目兼容的 Python 版本范围。pip 会据此选择合适的包版本。classifiers提供额外元数据帮助用户和索引系统理解你的包。至少应包含 Python 版本和操作系统兼容性。完整分类列表见 PyPI 分类器页面。license使用 SPDX 许可证标识符如 “MIT”。license-files许可证文件的路径相对于 pyproject.toml 所在目录。注意原文中的 [“LICEN[CS]E*”] 是一种 glob 写法但为了清晰和兼容性建议直接写 [“LICENSE”]。urls可在 PyPI 页面上显示的额外链接如源码、文档、问题追踪等。更多字段如 keywords、dependencies可参考 pyproject.toml 官方指南。编写 README.md创建 README.md 文件内容如下可自行修改# 示例包这是一个简单的示例包。你可以使用[GitHub 风格的 Markdown](https://guides.github.com/features/mastering-markdown/)来撰写内容。添加 LICENSE许可证每个上传到 PyPI 的包都必须包含许可证以告知用户他们可以如何使用你的代码。推荐访问 choosealicense.com 选择合适的许可证。例如选择 MIT 许可证则 LICENSE 文件内容如下Copyright (c) 2026 Your Name 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.✅ 大多数现代构建后端会自动将 LICENSE 文件包含进最终的分发包中前提是它在 license-files 中正确声明。生成分发包Distribution Archives下一步是生成可上传到 PyPI 的分发包。这些包可以被 pip 安装。首先确保已安装最新版的 build 工具# Windowspython-m pip install--upgrade build然后在 pyproject.toml 所在目录运行# Windowspython-m build成功后会在 dist/ 目录下生成两个文件dist/ ├── example_package_your_username-0.0.1-py3-none-any.whl └── example_package_your_username-0.0.1.tar.gz.tar.gz 是 源码分发包source distribution.whl 是 构建好的 wheel 包built distribution 现代 pip 优先安装 wheel 包若不可用则回退到源码包。建议始终同时提供源码包和适用于目标平台的 wheel 包。本例中包是纯 Python 且跨平台因此只需一个 wheel。上传到 PyPI现在将你的包上传到 TestPyPIPyPI 的测试环境专用于实验不会影响正式索引。步骤 1注册 TestPyPI 账号前往 https://test.pypi.org/account/register/ 注册账号并验证邮箱。步骤 2创建 API Token登录后进入 API Tokens 页面创建一个作用域为 “Entire account” 的 Token。务必在关闭页面前复制保存——你之后无法再次查看明文 Token。步骤 3使用 Twine 上传安装 twine# Windowspy-m pip install--upgrade twine上传所有分发包# Windowspy-m twine upload--repository testpypi dist/*系统会提示你输入 API Token格式如 pypi-xxxxx粘贴即可输入时不可见请确保准确。成功后你会看到类似输出Uploading example_package_your_username_here-0.0.1-py3-none-any.whl 100% ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 8.2/8.2 kB • 00:01 • ? Uploading example_package_your_username_here-0.0.1.tar.gz 100% ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 6.8/6.8 kB • 00:00 • ?上传完成后你的包将在 TestPyPI 上可见。安装并测试你的包使用 pip 从 TestPyPI 安装你的包进行验证# Windowspy-m pip install--index-url https://test.pypi.org/simple/--no-deps example-package-your-username 注意使用 --index-url 指定 TestPyPI使用 --no-deps 避免因 TestPyPI 缺少依赖而导致安装失败虽然本例无依赖但这是良好实践。安装成功后启动 Python 并测试fromexample_package_your_usernameimportexampleprint(example.add_one(2))# 输出3下一步 恭喜你已经成功打包并发布了你的第一个 Python 项目接下来你可以将真实项目按此流程打包添加单元测试放入 tests/配置 CI/CD 自动构建和发布上传到正式 PyPI需注册 pypi.org 账号。祝你打包顺利✨✨参考文献https://packaging.python.org/en/latest/tutorials/packaging-projects/