使用 Python Typing 实现泛型类型依赖

使用 python typing 实现泛型类型依赖

本文介绍了如何使用 Python 的 typing 模块来实现泛型类型之间的依赖关系。通过使用 Protocol 和 TypeVar,我们可以更精确地定义类的类型约束,从而提高代码的可读性和健壮性。本文提供了一个具体的例子,展示了如何将 to 参数的类型与 data 参数的类型绑定在一起,并提供了详细的代码示例和使用方法。

在 Python 中,类型提示可以显著提高代码的可读性和可维护性。然而,当涉及到泛型类型时,特别是当这些类型之间存在依赖关系时,类型提示可能会变得复杂。本文将介绍如何使用 typing 模块中的 Protocol 和 TypeVar 来解决这类问题。

使用 Protocol 定义索引类型

当我们需要定义一个类型,它必须支持某种索引操作(例如,__getitem__ 和 __setitem__),但我们不关心它的具体类型是 MutableMapping 还是 MutableSequence 时,可以使用 Protocol。

以下是一个 Indexable 协议的定义,它要求类型必须支持使用键 K 进行索引,并且可以设置对应的值:

立即学习“Python免费学习笔记(深入)”;

import typingK = typing.TypeVar('K', contravariant=True)class Indexable(typing.Protocol[K]):    def __getitem__(self, key: K):        pass    def __setitem__(self, key: K, value: typing.Any):        pass

这里,K 是一个 TypeVar,它表示键的类型。contravariant=True 表明 K 是逆变的,这意味着 Indexable[int] 可以赋值给 Indexable[typing.Hashable]。

使用 TypeVar 约束泛型类型

TypeVar 可以用来定义泛型类型变量,并可以对这些变量进行约束。例如,我们可以定义一个 TypeVar,它必须是 typing.Hashable 的子类型:

H = typing.TypeVar('H', bound=typing.Hashable)

这表示 H 可以是任何可哈希的类型,例如 int、str 等。

将 to 和 data 类型绑定

现在,我们可以使用 Protocol 和 TypeVar 来定义 ApplyTo 类,并将 to 参数的类型与 data 参数的类型绑定在一起:

import typingDispatchType = typing.Literal['separate', 'joint']# `P` must be declared with `contravariant=True`, otherwise it errors with# 'Invariant type variable "P" used in protocol where contravariant one is expected'K = typing.TypeVar('K', contravariant=True)class Indexable(typing.Protocol[K]):    def __getitem__(self, key: K):        pass    def __setitem__(self, key: K, value: typing.Any):        pass# Accepts only hashable types (including `int`s)H = typing.TypeVar('H', bound=typing.Hashable)class ApplyTo(typing.Generic[H]):    _to: typing.Sequence[H]    _dispatch: DispatchType    _transform: typing.Callable[..., typing.Any]  # TODO Initialize `_transform`    def __init__(self, to: typing.Sequence[H] | H, dispatch: DispatchType = 'separate') -> None:        self._dispatch = dispatch        self._to = to if isinstance(to, typing.Sequence) else [to]    def __call__(self, data: Indexable[H]) -> typing.Any:        if self._dispatch == 'separate':            for key in self._to:                data[key] = self._transform(data[key])            return data        if self._dispatch == 'joint':            args = [data[key] for key in self._to]            return self._transform(*args)        assert False

在这个例子中,ApplyTo 类接受一个泛型类型 H,它必须是 typing.Hashable 的子类型。_to 属性的类型是 typing.Sequence[H],表示它是一个包含 H 类型元素的序列。__call__ 方法接受一个 Indexable[H] 类型的参数 data,这意味着 data 必须支持使用 H 类型的键进行索引。

使用示例

以下是一些使用 ApplyTo 类的示例:

def main() -> None:    r0 = ApplyTo(to=0)([1, 2, 3])    # typechecks    r0 = ApplyTo(to=0)({1: 'a', 2: 'b', 3: 'c'})    # typechecks    r1 = ApplyTo(to='a')(['b', 'c', 'd'])    # does not typecheck: Argument 1 to "__call__" of "Applier" has incompatible type "list[str]"; expected "Indexable[str]"    r1 = ApplyTo(to='a')({'b': 1, 'c': 2, 'd': 3})     # typechecks

可以看到,当 to 是 int 类型时,data 可以是 list 或 dict,但当 to 是 str 类型时,data 必须是 dict。这是因为 list 只支持使用 int 类型的索引,而 dict 支持使用 Hashable 类型的索引。

总结

通过使用 Protocol 和 TypeVar,我们可以更精确地定义泛型类型之间的依赖关系,从而提高代码的可读性和健壮性。在设计泛型类时,应该仔细考虑类型之间的约束关系,并使用 typing 模块提供的工具来表达这些约束。这有助于在编译时发现类型错误,并减少运行时错误的发生。

以上就是使用 Python Typing 实现泛型类型依赖的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1363312.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年12月14日 03:20:12
下一篇 2025年12月14日 03:20:24

相关推荐

  • 使用 Python Typing 实现泛型类型依赖的组合

    本文旨在解决 Python 中泛型类型依赖组合的问题,通过使用 Protocol 协议定义可索引类型,并结合 TypeVar 约束泛型类型,从而实现对 MutableMapping 和 MutableSequence 等类型的灵活约束。本文将提供代码示例和详细解释,帮助读者理解如何在 Python …

    好文分享 2025年12月14日
    000
  • Python泛型类型约束:实现依赖类型的组合

    本文介绍了如何在Python中使用泛型和协议(Protocol)来实现更精确的类型提示,特别是当泛型类型之间存在依赖关系时。通过定义一个Indexable协议,并结合TypeVar和Generic,可以约束ApplyTo类,使其能够根据to参数的类型,正确地推断出data参数的类型,从而提高代码的类…

    2025年12月14日
    000
  • Python csv.writer 写入数据时额外引号问题的解析与解决方案

    本文旨在解决使用 Python csv 模块的 csv.writer 写入数据时,因数据源结构不当导致输出字段被额外引号包裹的问题。当从数据库(如 MySQL)获取的数据集每行是一个包含预先逗号分隔字符串的单元素元组时,csv.writer 会将其视为单个字段并添加引号。教程将详细分析问题成因,并提…

    2025年12月14日
    000
  • 使用 csv.writer 避免记录周围出现引号

    在使用 Python 的 csv.writer 模块时,有时会遇到生成的 CSV 文件中,数据记录被额外的引号包裹的情况,例如 “item1,item2,item3″,而期望的结果是 item1,item2,item3。 这个问题通常出现在从数据库或其他数据源获取数据时,数据…

    2025年12月14日
    000
  • 计算DataFrame每行商的教程

    本文将介绍如何使用Python的pandas库计算DataFrame中每行的商。我们将通过移位操作和除法运算,创建一个新的列,其中包含DataFrame中相邻两行数据的商。 在数据分析和处理中,经常需要对DataFrame中的行进行计算,例如计算相邻两行数据的商。pandas库提供了强大的功能来实现…

    2025年12月14日
    000
  • Python中如何转换日期格式?datetime高效处理方法

    python处理日期格式转换的核心方法是使用datetime模块的strptime()和strftime()。1. strptime()用于将日期字符串解析为datetime对象,关键在于格式字符串必须与输入完全匹配;2. strftime()则用于将datetime对象格式化为指定样式的字符串,提…

    2025年12月14日 好文分享
    000
  • Python中如何使用装饰器?语法糖原理与应用实例

    python中的装饰器本质上是一个接收函数并返回新函数的特殊函数,它通过@符号实现语法糖机制,使得在不修改原函数代码的前提下扩展其行为。装饰器的执行顺序遵循从下往上的原则,但调用时最外层装饰器先执行;使用functools.wraps可保留原函数元数据,确保装饰后函数信息完整;带参数的装饰器通过三层…

    2025年12月14日 好文分享
    000
  • 如何用Python开发API接口?FastAPI教程

    使用python开发api接口可通过fastapi实现,步骤包括:1. 安装fastapi和uvicorn包;2. 创建python文件并编写简单接口示例;3. 通过uvicorn启动服务访问测试;4. 使用路径参数或查询参数接收输入;5. 利用pydantic定义数据模型进行自动校验;6. 自动生…

    2025年12月14日 好文分享
    000
  • 怎样用Python处理地理数据—GeoPandas空间分析

    geopandas是python中用于处理地理数据的强大工具,它扩展了pandas以支持几何对象。1. 可通过pip或conda安装geopandas并读取shapefile文件;2. 支持创建缓冲区、空间交集和合并等操作;3. 提供空间连接功能以便按地理位置关联属性信息;4. 内置绘图功能可用于快…

    2025年12月14日 好文分享
    000
  • Python如何进行网络测速?speedtest-cli教程

    要使用python进行网络测速,最直接的方法是通过speedtest-cli库。1. 首先安装speedtest-cli:使用pip install speedtest-cli命令进行安装;2. 在python脚本中导入speedtest模块并创建speedtest对象;3. 调用get_best_…

    2025年12月14日 好文分享
    000
  • 怎样用Python处理正则匹配数据?str.extract方法

    str.extract是pandas中用于从字符串中提取结构化信息的方法,它通过正则表达式定义的捕获组来匹配和提取数据,并返回dataframe;1. 使用str.extract可按正则表达式提取文本中的多个部分,如单词和数字;2. 若匹配失败,默认返回nan,可用fillna或dropna处理;3…

    2025年12月14日 好文分享
    000
  • 如何使用Python发送HTTP请求?urllib3使用指南

    urllib3 是 python 中一个强大且易用的 http 请求库,适合频繁发起网络请求的场景。安装方法为:pip install urllib3。发送 get 请求的关键步骤包括:导入库、创建 poolmanager 实例、调用 request() 方法获取响应,并通过 .status 和 .…

    2025年12月14日 好文分享
    000
  • Python如何进行文本分类?Scikit-learn实践

    文本分类是让计算机理解并自动给文字打标签的过程,scikit-learn提供了完整的解决方案。1. 数据预处理:清理原始数据,包括分词、大小写转换、移除标点符号和停用词、词形还原等步骤;2. 特征提取:使用countvectorizer或tfidfvectorizer将文本转化为数值向量,前者统计词…

    2025年12月14日 好文分享
    000
  • Python中如何处理缺失时序—插值与向前填充策略

    处理时间序列缺失值时,选择插值还是向前填充取决于数据特性。1. 插值适用于变化平滑的数据(如温度),常用方法包括线性、时间、多项式和样条插值;2. 向前填充适合状态型数据(如用户登录状态),使用 .ffill() 方法填充,但无法填补开头缺失;3. 可组合使用插值与填充策略,并设置最大填充长度以提升…

    2025年12月14日 好文分享
    000
  • 如何用Python实现数据加密?AES算法

    aes是常见的对称加密算法,python可通过pycryptodome库实现,需理解其原理并掌握使用方法。1. aes使用相同密钥进行加密和解密,支持128、192、256位密钥长度,常用128位;2. 工作模式如ecb、cbc等,推荐使用cbc而非简单但不安全的ecb;3. python中安装py…

    2025年12月14日
    000
  • 如何使用Python实现自动化报表?Jinja2模板

    使用python结合jinja2模板实现自动化报表的核心流程分为三步:数据处理、模板设计、数据渲染。首先,从数据库、api或csv等来源获取原始数据,并用pandas等工具清洗、整合为结构化数据(如字典或列表);其次,设计带有占位符和逻辑控制(如循环、条件判断)的jinja2模板文件(如html),…

    2025年12月14日 好文分享
    000
  • 如何用Python开发API接口?FastAPI快速入门

    fastapi成为python api开发首选框架的原因包括高性能、出色的开发者体验和现代化设计。它基于starlette和pydantic,支持异步处理,配合uvicorn服务器提升吞吐量;通过python类型提示自动完成数据验证、序列化及交互式文档生成,极大简化开发流程;其pythonic设计和…

    2025年12月14日 好文分享
    000
  • 如何使用Python开发爬虫框架?Scrapy扩展

    scrapy扩展是插入到引擎中的组件,用于增强爬虫行为。编写扩展需创建模块、定义类并实现如from_crawler等方法,再在settings中启用。常见用途包括控制速率、记录状态、处理异常、集成监控。扩展区别于中间件和管道,侧重全局控制。调试时可用print确认加载,并合理设置优先级与配置依赖。 …

    2025年12月14日 好文分享
    000
  • Python中如何优化数据查询—pandas索引加速技巧

    优化pandas查询性能的关键在于合理使用索引。1. 设置合适索引列,如唯一且常用筛选字段;2. 使用.loc和.at提升访问效率;3. 对非唯一索引排序以加快查找速度;4. 合理利用multiindex处理多维数据。掌握这些技巧可显著提升大数据处理效率。 在Python的数据处理中,pandas …

    2025年12月14日
    000
  • 怎样用Python实现进度条?tqdm库使用指南

    python实现进度条推荐使用tqdm库,1.安装:pip install tqdm;2.基础用法是将可迭代对象用tqdm()包装;3.提供示例如循环、trange、列表处理及手动更新方式;4.进度条通过视觉反馈缓解等待焦虑,提升用户体验;5.命令行与jupyter自动适配显示,也可显式导入对应模块…

    2025年12月14日 好文分享
    000

发表回复

登录后才能评论
关注微信