如何使用 uv 构建 Python 包并本地安装
本文将逐步指导你创建一个简单的 Python 包,并将其本地安装到机器或云环境中。完成本教程后,你将拥有一个可复用的 Python 库,可直接通过 pip
安装或在项目中导入使用。
步骤详解
Step 0: 选择构建工具 - 使用 uv
-
推荐理由:
uv
是类似poetry
的现代打包工具,默认使用hatchling
作为构建后端,支持 PEP 517/518 标准。 -
安装方法:
# 通过 Homebrew 安装(MacOS) brew install uv # 或直接通过 PyPI pip install uv
Step 1: 创建包目录结构
使用 uv
快速初始化项目结构:
uv init --lib my-package
生成后的目录如下:
my_package/
├── src/
│ └── my_package/
│ ├── __init__.py # 标记为 Python 包
│ └── your_code.py # 存放核心代码
│ └── py.typed # 类型标注声明(可选)
├── pyproject.toml # 项目元数据和依赖配置
├── README.md # 项目文档
└── .python-version # 指定 Python 版本
Step 2: 编写包代码
在 src/my_package/your_code.py
中添加功能代码:
# my_package/your_code.py
def greet(name: str) -> str:"""返回问候语"""return f"Hello, {name}!"
Step 3: 配置 pyproject.toml
填写项目元数据和依赖项:
[project]
name = "my-package"
version = "0.1.0"
description = "一个简单的本地 Python 包示例"
readme = "README.md"
authors = [{ name = "Sarah Glasmacher", email = "sarah@example.com" }]
requires-python = ">=3.11"
dependencies = [][build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"
Step 4: 构建分发包
运行以下命令生成 .whl
或 .tar.gz
文件:
uv build
构建完成后,dist/
目录下会生成类似以下的文件:
dist/
├── my_package-0.1.0-py3-none-any.whl
└── my_package-0.1.0.tar.gz
Step 5: 本地安装包
方法 1:直接安装构建产物
pip install dist/my_package-0.1.0-py3-none-any.whl
方法 2:以编辑模式安装(实时同步代码)
pip install -e .
Step 6: 测试安装
打开 Python 终端验证:
from my_package.your_code import greetprint(greet("World")) # 输出:Hello, World!
关键注意事项
- 模块化设计:将代码按功能拆分为独立模块,便于维护和复用。
- 依赖管理:通过
dependencies
字段声明依赖,或使用uv add <package>
自动更新pyproject.toml
。 - 版本控制:每次发布新版本前更新
version
字段,避免冲突。
扩展应用场景
- 云部署:将打包后的代码上传至 Databricks 或 AWS Lambda,直接调用云端计算资源。
- 协作开发:通过 PyPI 发布包(需额外配置),团队成员可直接
pip install
同步代码。
通过本文,你已掌握 Python 包的基础构建和本地安装流程。下一阶段可尝试 将包发布到 PyPI,实现全球范围内的代码共享!
相关文章:
如何使用 uv 构建 Python 包并本地安装
本文将逐步指导你创建一个简单的 Python 包,并将其本地安装到机器或云环境中。完成本教程后,你将拥有一个可复用的 Python 库,可直接通过 pip 安装或在项目中导入使用。 步骤详解 Step 0: 选择构建工具 - 使用 uv 推荐理由:uv 是…...
集结号海螺捕鱼组件搭建教程与源码结构详解(第一篇)
本系列将基于 C Unity3D Java MySQL 构建的集结号海螺捕鱼平台,全面拆解组件架构、服务部署、客户端接入、数据库结构等内容,适合技术团队二次开发及运维部署。 一、整体架构说明 集结号海螺捕鱼平台采用三层结构: 客户端(Uni…...
RabbitMQ复习笔记
文章目录 MQ 概述同步调用拓展性差的问题性能下降的问题级联失败问题 异步调用举例 技术选型 RabbitMQRabbitMQ 安装RabbitMQ 收发消息交换机队列绑定关系模拟发送消息 RabbitMQ 数据隔离用户管理virtual host 授权 SpringAMOPSpringAMOP 快速入门消息发送消息接收 Work Queues…...
游戏开发核心技术解析——从引擎架构到攻防体系的完整技能树
游戏开发必备的7大技术体系,涵盖从Unity/Unreal引擎应用、C/C#编程范式到图形渲染管线构建等核心技术,特别剖析MMO游戏开发中的网络安全架构设计要点。通过2023年某头部游戏公司DDoS攻击事件,揭示实时防御策略与合规审计的关键作用。一、游戏…...
Execl 最佳字体和大小推荐[特殊字符]
文章目录 ✅ **通用推荐字体与字号**🔤 **字体说明**📊 场景推荐📁 办公文档(如财务报表、周报等)📈 数据可视表格📋 打印友好 🌐 多语言场景(中英文混排) ✅…...
JavaScript学习教程,从入门到精通,Ajax与Node.js Web服务器开发全面指南(24)
Ajax与Node.js Web服务器开发全面指南 一、初识Ajax 1.1 Ajax基本概念 语法知识点: Ajax (Asynchronous JavaScript and XML) 是一种无需重新加载整个网页的情况下,能够更新部分网页的技术核心对象:XMLHttpRequest工作原理: 创…...
VR 全景看车的独特优势
全方位沉浸式体验 VR 全景看车最显著的优势,就是为用户带来了全方位的沉浸式体验。通过 VR 技术,用户仿佛置身于真实的汽车展厅或试驾场景之中,能够 360 度无死角地观察车辆的外观、内饰、细节等各个方面 。无论是车辆的整体造型࿰…...
Kotlin高阶函数 vs Lambda表达式:关键区别与协作关系
先说结论: ✅ 高阶函数既可以用 Lambda 表达式,也可以用函数引用! 在 Kotlin 中,高阶函数(Higher-Order Function)和 Lambda 表达式密切相关,但它们是两个不同的概念: ✅ 简单理解…...
SQL技术终极指南:从内核原理到超大规模应用
一、DDL核心应用场景与最佳实践 1.1 表结构设计场景矩阵 业务场景核心语法要素典型实现案例电商用户画像JSON字段虚拟列索引CREATE TABLE users (id INT, profile JSON, AS (profile->>$.age) VIRTUAL, INDEX idx_age((profile->>$.age)))物联网时序数据分区表压…...
Qt实现语言切换的完整方案
在Qt中实现语言动态切换需要以下几个关键步骤,我将提供一个完整的实现方案: 一、准备工作 在代码中使用tr()标记所有需要翻译的字符串 cpp button->setText(tr("Submit")); 创建翻译文件 在.pro文件中添加: qmake TRANSLATION…...
消息中间件RabbitMQ02:账号的注册、点对点推送信息
一、默认用户登录和账号注册 1.登录 安装好了RMQ之后,我们可以访问如下地址: RabbitMQ Management 输入默认的管理员密码,4.1.0的管理员账号和密码是: guest guest 2.添加账号 consumer consumer 添加成功后: 角色…...
php 支付宝官方 Alipay Easy SDK
使用 Alipay Easy SDK。 打造最好用的支付宝开放平台服务端SDK,Alipay Easy SDK让您享受极简编程体验,快速访问支付宝开放平台开放的各项核心能力。 要求: PHP版本 > 7.0安装PHP cURL扩展安装PHP OpenSSL扩展安装PHP fileinfo扩展 使用…...
深入理解 java synchronized 关键字
🧑 博主简介:CSDN博客专家,历代文学网(PC端可以访问:https://literature.sinhy.com/#/literature?__c1000,移动端可微信小程序搜索“历代文学”)总架构师,15年工作经验,…...
即时角色:使用可扩展的扩散变换器框架个性化任何角色
Paper Title: InstantCharacter: Personalize Any Characters with a Scalable Diffusion Transformer Framework 论文发布于2025年4月16日 Abstract部分 U-Net架构的局限性:传统的基于U-Net架构的定制方法存在一些问题,如泛化能力不足和生成图像质量的损失。 U-Net模型需要…...
开源作业调度框架Quartz框架详细使用说明
Quartz框架详细使用说明 Quartz 是一个功能强大的开源作业调度框架,广泛用于在Java应用程序中执行定时任务。以下是Quartz框架的详细使用说明、完整代码示例、同类框架对比以及总结表格。 1. Quartz框架概述 特点: 灵活的调度:支持多种调度方…...
配置Spark历史服务器,轻松查看任务记录
在大数据处理中,Spark是一个强大的分布式计算框架。但当Spark服务重启后,之前的运行记录就会消失,给我们排查问题和分析任务执行情况带来不便。这时,配置Spark历史服务器就显得尤为重要,它能帮助我们保存和查看历史任务…...
身份证实名认证:通往数字安全与便捷生活的钥匙
在数字化日益深入我们生活的今天,信息安全和隐私保护成为了每个人关心的焦点。而身份证实名认证作为保障个人信息安全的重要环节,正扮演着越来越关键的角色。它不仅是连接现实世界与数字世界的桥梁,更是确保个人在线活动安全、可靠的基础。 什…...
0基础可以考MySQL OCP么?备考时间需要多久?
最近被问爆的 “0 基础能不能考 MySQL OCP”“备考要多久” 终于来答疑啦!作为过来人,负责任地说:0 基础完全能冲! 0 基础真的能考 MySQL OCP? 很多姐妹担心自己是数据库小白,连 SQL 都没摸过,…...
node.js 实战——(概念以及Buffer 知识点学习)
概念 node.js是一个开源的、跨平台的javascript运行环境;它可以开发服务器应用,可以开发工具类应用(webpack、vite、Babel),也可以开发桌面端应用(vscode、Figma、Postman) #mermaid-svg-0TkAt8LEFhyrVrsw {font-fami…...
论文阅读 | 大模型工具调用控制的策略优化
文章目录 I. 背景II. 方法细节2.1 问题定义2.2 工具集成RL2.3 PPO2.4 GRPO2.5 OTC-PO2.5.1 OTC-PPO2.5.2 OTC-GRPO2.5.3 工具集成奖励设计 III. 实验 题目: OTC: Optimal Tool Calls via Reinforcement Learning 论文地址: OTC: Optimal Tool Calls via…...
【论文阅读】Dual-branch Cross-Patch Attention Learning for Group Affect Recognition
【论文阅读】Dual-branch Cross-Patch Attention Learning for Group Affect Recognition 摘要1.介绍2.相关工作3.双分支交叉Patch注意力Transformer4.实验5.局限性 摘要 本篇博客参考IEEE 2022年收录的论文Dual-branch Cross-Patch Attention Learning for Group Affect Reco…...
centos stream 10 修改 metric
1. 查看当前网络连接 nmcli connection show 2. 查看当前网络连接的metric ip route show 3. 修改指定连接的 metric sudo nmcli connection modify "Wired connection 1" ipv4.route-metric 100 ipv6.route-metric 100 值越大,优先级越低ÿ…...
Java从入门到“放弃”(精通)之旅——String类⑩
Java从入门到“放弃”(精通)之旅🚀——String类⑩ 前言 在Java编程中,String类是最常用也是最重要的类之一。无论是日常开发还是面试,对String类的深入理解都是必不可少的。 1. String类的重要性 在C语言中…...
MVCWebAPI使用FromBody接受对象的方法
近期在做软件升级操作的时候突然想着需要的参数比较多,如果需要参数的话参数比较多,所有想着使用frombody来集合数据统一操作做了个样张希望对您有帮助 代码如下: /// <summary>/// 入口当前文件接口下的操作数据/// </summary>/…...
知识储备-DC综合相关
DC flow相关 要点描述命令区别DC基础版,使用wireloadmodelcompile_ultraDCT 含DC所有非冲突feature(如wlm),按照DC-prefloorplan-DCT流程获取布局信息更精确评估时序收敛 dc_shell -topoDCG含DCT所有feature,多了layer和congestion信息等 dc_…...
力扣-第645题《错误的集合》
一 . 问题描述 集合 s 包含从 1 到 n 的整数。不幸的是,因为数据错误,导致集合里面某一个数字复制了成了集合里面的另外一个数字的值,导致集合 丢失了一个数字 并且 有一个数字重复 。 给定一个数组 nums 代表了集合 S 发生错误后的结果。 …...
gem5教程第六章 为ARM扩展gem5 这也是改进gem5的一个基础
本章假设您已经使用gem5构建了一个基本的x86系统,并创建了一个简单的配置脚本。 下载ARM二进制文件 让我们从下载一些ARM基准测试二进制文件开始。从gem5文件夹的根目录开始: mkdir -p cpu_tests/benchmarks/bin/arm cd cpu_tests/benchmarks/bin/arm wget dist.gem5.org/…...
事关数据安全,ARM被爆不可修复漏洞
日前,ARM架构再次被爆出重大安全漏洞,影响波及ARMv8.3架构及以前的所有CPU。该漏洞为硬件级且无法完全修复,如被利用可能造成严重数据泄露风险。 ARM硬件级安全漏洞 来自ARM开发者官网的一项安全更新证实,存在一种名为PACMAN的新型…...
Unity中使用Cinemachine插件创建自由视角相机(freelookCamera)来实现第三人称漫游
1.安装下载Cinemachine插件 2.创建自由相机freelookCamera Follow:为我们的人物 LookAt:相机始终看向的地方,可以新建空物体,放在人物头上, invert:是反向,就是时鼠标移动方向与相机旋转方向一致 在组件最下面的…...
Python爬虫(2)Python爬虫入门:从HTTP协议解析到豆瓣电影数据抓取实战
目录 一、背景与需求二、 Web基础与HTTP协议核心解析2.1 HTTP协议:数据交互的基石2.2 为何爬虫需理解HTTP协议? 三、 Python爬虫实战:Requests库核心用法3.1 安装与环境配置3.2 案例1:GET请求抓取豆瓣电影Top2503.3…...
php基础
文章目录 基本语法基本数据类型:运算符?? 空合并 定义变量字符串操作内置变量\$_SESSION:会话信息\$_GET:获取URL参数 内置函数功能工具类的,utils网络通信类的会话管理类的 基本语法 每一个statement后面以;结尾,与C/C和Java一样注释用//,…...
蓝桥杯17. 机器人塔
机器人塔 原题目链接 题目描述 X 星球的机器人拉拉队有两种服装:A 和 B。 这次他们表演的是“搭机器人塔”,类似下图: AB BA B AA A B BB B B A BA B A B B A组塔规则: A 只能站在 AA 或 BB 的肩上;B 只能站在 AB…...
rpm包管理
1.介绍 rpm用于互联网下包的打包及安装工具,包含在某些Linux发布版中,它生成具有.RPM扩展名的文件.RPM是RedHat Package Manage (RedHat软件包管理公具)的编写 类似windows的setup.exe,这一文件格式名称虽然打上RedHat的标志,但理念是通用的. Linux的…...
es 自动补全
安装拼音分词器 选择es版本对应的pinyin分词器版本 下载后解压,放到es的插件目录下 重启es 自定义分词器 拼音分词器——可选配置 1. 首字母处理配置 keep_first_letter (默认: true) 解释:是否提取每个汉字的首字母组合,用于支持首字母…...
NLTK 文本分类与情感分析
在自然语言处理(NLP)的领域中,文本分类和情感分析是两个非常重要且具有广泛应用的任务。文本分类旨在将文本数据分配到预定义的类别中,而情感分析则专注于确定文本所表达的情感倾向,如积极、消极或中性。Python 的 Nat…...
Android开发常用外部组件及使用指南(上)
文章目录 一、前言二、外部组件的引入方式1. Gradle依赖管理1.1 项目级build.gradle1.2 模块级build.gradle 2. 本地库引入3. 模块化引入 三、网络请求组件1. Retrofit1.1 引入依赖1.2 基本使用1.3 高级特性 2. OkHttp2.1 基本使用2.2 拦截器 四、图片加载组件1. Glide1.1 基本…...
系统架构师2025年论文《系统架构风格》
论企软件架构风格 摘要: 我所在单位是某市主要医院,2017 年 1 月医院决定开发全新一代某市医院预约挂号系统,我担任本次系统的架构师,主要负责整个系统的架构设计工作。该系统旨在优化医院挂号流程,提高患者就医体验,是医院应对医疗信息化变革和提升服务质量的重要举措…...
Linux部署Redis主从
Linux部署Redis主从 1.下载2.安装2.1编译 & 安装 3.修改配置文件4.启动 1.下载 在Redis版本库:https://download.redis.io/releases/ 可根据自己的需求选择下载对应的版本,然后直接下载 2.安装 通过Xftp工具进行上传,选择指定的应用拖…...
【Python 学习笔记】 pip指令使用
系列文章目录 pip指令使用 文章目录 系列文章目录前言安装配置使用pip 管理Python包修改pip下载源 前言 提示:这里可以添加本文要记录的大概内容: 当前文章记录的是我在学习过程的一些笔记和思考,可能存在有误解的地方,仅供大家…...
Django DRF实现用户数据权限控制
在 Django DRF 中使用 ModelViewSet 时,若需实现用户仅能查看和操作自己的数据详情,同时允许所有认证用户访问列表,需结合权限类和动态权限分配。以下是具体步骤: 1. 自定义对象权限类 创建一个 IsOwner 权限类,检查…...
eplan许可证与防火墙安全软件冲突
在使用EPLAN电气设计软件时,有时会遇到许可证与防火墙或安全软件之间的冲突。这种冲突可能导致许可证无法激活或软件无法正常运行,给用户带来诸多不便。本文将为您解析EPLAN许可证与防火墙/安全软件冲突的原因,并提供解决方案,帮助…...
《多Agent架构VS千万字长文本VS深度推理引擎——拆解Coze、通义、Kimi的AI终局博弈密码》
Coze、通义和Kimi终局竞争深度分析 技术路线分野:多Agent协同 vs. 超长文本 vs. 结构化提示 架构差异:三者在技术路线上的侧重点各异,塑造了不同的市场边界。Coze(“扣子”)采用多Agent协同架构,强调插件工…...
《浔川代码编辑器v2.1.0预告》
《浔川代码编辑器v2.1.0预告》 尊敬的浔川代码编辑器用户: 我们很高兴向大家预告即将到来的v2.1.0版本更新计划。以下是各版本的发布时间安排: 版本发布计划 1. **v2.1.0公测版** - 发布时间:待v2.0测试版结束后两周 - 特点:包…...
Python jsonpath库终极指南:json数据挖掘的精准导航仪
Python jsonpath库终极指南:json数据挖掘的精准导航仪 对话实录 小白:(抓狂)这个 JSON 数据有好多层嵌套,怎么快速拿到最里面的值? 专家:(递上探测器)用jsonpath库&…...
QT软件安装(12)
文章目录 一、本章说明二、QT软件包资源三、软件安装教程 一、本章说明 注:本节为【基于STM的环境监测系统(节点云服务器存储QT界面设计)】项目第12篇文章,前面文章已经实现了气体传感数据的采集,并通过4G模块上传至云…...
【人工智能】DeepSeek 的开源生态:释放 AI 潜能的社区协同与技术突破
《Python OpenCV从菜鸟到高手》带你进入图像处理与计算机视觉的大门! 解锁Python编程的无限可能:《奇妙的Python》带你漫游代码世界 DeepSeek 作为中国 AI 领域的先锋,以其高效的混合专家模型(MoE)和彻底的开源策略,在全球 AI 社区掀起波澜。本文深入剖析 DeepSeek 的开…...
如何选择 Flask 和 Spring Boot
目录 一、选择 Flask 和 Spring Boot 的关键因素如何评价系统的性能1.RPSRPS 的重要性RPS 的评估标准RPS 的计算方法RPS 与并发用户数的关系性能测试中的RPS 2.TPSTPS 的定义TPS 的重要性TPS 与 RPS 的区别TPS 的常见范围计算 TPS 的公式如何提高 TPS 二、后期扩展优化方案Flas…...
在KEIL里C51和MDK兼容以及添加ARM compiler5 version编译器
前言 我们想在一个keil里面可以打开32和51的文件,这样就不需要两个keil了 还有就是现在的keil,比如我用的是5.41的,就没有5版本的处理器,所以要安装 本篇文章我们来详细讲解如何实现上面说的两个内容 准备的东西 1.ARM5编译器 …...
【源码分析】Linux内核ov13850.c
这里写自定义目录标题 1、入口函数:__init sensor_mod_init2、probe函数:ov13850_probe2.1、初始化前的一些准备2.2、设备初始化流程 源码如下 了解运行流程 1、入口函数:__init sensor_mod_init 驱动由 __init 开始 __exit 结束,…...
单片机与FPGA的核心差异、优缺点、编程差异、典型应用场景、选型等对比分析
1. 基本概念差异 单片机(MCU): 基于冯诺依曼/哈佛架构的微控制器,集成CPU、内存、外设接口(如ADC、UART、PWM等),通过软件指令顺序执行任务。 FPGA: 由可编程逻辑单元(…...