首页
学习
活动
专区
工具
TVP
发布
精选内容/技术社群/优惠产品,尽在小程序
立即前往

元类不起作用的Sphinx自动类

是指在Sphinx文档生成工具中,由于元类的特殊性质,无法对自动类(autoclass)起到预期的作用。

元类(metaclass)是Python中一种特殊的类,用于创建其他类。它可以控制类的创建过程,包括类的属性、方法等。在Sphinx中,自动类是指通过autoclass指令自动生成的类的文档。

然而,由于Sphinx的限制,元类无法对自动类起到作用。具体来说,元类定义的特殊行为无法被自动类继承或应用。这意味着,如果在自动类中使用了元类,元类定义的特性将不会被正确地应用到自动类中。

对于解决这个问题,可以考虑以下几种方法:

  1. 手动编写类文档:放弃使用自动类,手动编写类的文档,包括类的属性、方法等。这样可以确保元类的特性被正确地应用到类中。
  2. 使用Sphinx插件:有些第三方插件可以解决元类不起作用的问题。例如,sphinx-autodoc-typehints插件可以在自动类中正确应用元类定义的类型提示。
  3. 修改Sphinx源码:如果有必要,可以尝试修改Sphinx的源码,以支持元类在自动类中的应用。这需要对Sphinx的内部机制有一定的了解,并且需要谨慎处理,以免引入其他问题。

总结起来,元类不起作用的Sphinx自动类是指在Sphinx文档生成工具中,由于Sphinx的限制,无法对自动类应用元类定义的特殊行为。为了解决这个问题,可以考虑手动编写类文档、使用Sphinx插件或修改Sphinx源码。

页面内容是否对你有帮助?
有帮助
没帮助

相关·内容

探寻Python鼻祖——

当你使用class关键字时,Python解释器自动创建这个对象。但就和Python中大多数事情一样,Python仍然提供给你手动处理方法。 3....到底什么是(终于到主题了) 就是用来创建【东西】。你创建就是为了创建实例对象,不是吗?但是我们已经学习到了Python中也是对象。...就是用来创建这些(对象)就是,你可以这样理解为: MyClass = MetaClass() # 使用创建出一个对象,这个对象称为“” my_object = MyClass(...答案就是:可以创建一个东西。那么什么可以用来创建一个呢?type,或者任何使用到type或者子类化type都可以。 8. 自定义 主要目的就是为了当创建时能够自动地改变。...但就本身而言,它们其实是很简单: 拦截创建 修改 返回修改之后 究竟为什么要使用? 现在回到我们大主题上来,究竟是为什么你会去使用这样一种容易出错且晦涩特性?

82910

python

python 详解 小麦麦子 2016-09-06 11:11:00        今天在网上看到一篇关于python语言中(metaclass)一些讲解和简单运用,感觉对python...如果按照以前思维来想的话就是实例,而实例对象是实例。...就是type了 (二) 什么是以及简单运用 这一切介绍完之后我们总算可以进入正题 到底什么是?通俗就是说,就是创建。。。这样听起来是不是超级抽象?...什么是刚才说了,就是创建。也可以说他就是一个创建工厂。 上面的__metaclass__属性,相信愿意了解元细节盆友,都肯定见过这个东西,而且为之好奇。...答案是可以创建一个东西,type,或者任何用到type或子类化type东西都行。 (三) 自定义 自定义目的,我总结了一下就是拦截创建,然后修改一些特性,然后返回该类。

1.1K30

探寻Python鼻祖——

当你使用class关键字时,Python解释器自动创建这个对象。但就和Python中大多数事情一样,Python仍然提供给你手动处理方法。 3....到底什么是(终于到主题了) 就是用来创建【东西】。你创建就是为了创建实例对象,不是吗?但是我们已经学习到了Python中也是对象。...就是用来创建这些(对象)就是,你可以这样理解为: MyClass = MetaClass() # 使用创建出一个对象,这个对象称为“” my_object = MyClass(...答案就是:可以创建一个东西。那么什么可以用来创建一个呢?type,或者任何使用到type或者子类化type都可以。 8. 自定义 主要目的就是为了当创建时能够自动地改变。...但就本身而言,它们其实是很简单: 拦截创建 修改 返回修改之后 究竟为什么要使用? 现在回到我们大主题上来,究竟是为什么你会去使用这样一种容易出错且晦涩特性?

91400

python 通过控制创建

其实A这个也是一个对象,它是type对象,可以说type是用来创建对象,我们平常写都是type创建对象,再由创建对象再去创建我们平常使用对象,我们可以看看type官方文档...'}) 二、什么是编程?...我们已经知道,也是对象,那么我们在创建时候,可不可以控制创建过程?当然是可以,这就是编程。 三、如何实现编程? 1....a = A() # 输出 MetaClass __new__ MetaClass __init__ MetaClass __call__ A __new__ A __init__ 五、总结 使用编程可以让我们在创建时候...但编程是python中难以理解地方之一,而且工作中,大部分时候都是不会用到,我们普通定义方式就可以解决问题了,若果说有99%时候你需要控制创建过程,那就使用编程吧。

1.5K10

Python

仅供学习参考,转载请注明出处 什么是 我们知道,实例对象是由来创建,那么又是由什么来创建呢? 答案就是基本都不会用到,但是就算不用到,也应该去熟悉一下概念。...由于也是对象,所以它们必须是通过什么东西来生成才对。 当你使用class关键字时,Python解释器自动创建这个对象。...type就是Python内建元,当然了,你也可以创建自己。 __metaclass__属性 上面已经知道了如何使用type这个来创建,那么如何创建自己呢??...那么什么可以用来创建一个呢?type,或者任何使用到type或者子类化type都可以,反正最终还是需要type。 自定义 主要目的就是为了当创建时能够自动地改变。...在这是使用def 方法来作为类似做法,下面使用class来定义

1.6K30

和嵌套

函数用于扩展接口中,并非只能拥有友函数,也可以将作为友,该类称为友。...友所有方法都可以访问原始私有成员和保护成员,但也可以对其做更严格限制,使得特定成员函数成为另一个。...友和继承、包含关系 我们为什么要提供友这种接口呢,它既然可以从外部访问私有部分权限,是不是与我们面向对象编程思想相悖呢?...答案显然是否定,那我们举个例子分析一下,友存在意义。...这表明Remote应该作为TV一个友,这样就可以轻松调TV成员和成员函数,来完成自己接口实现。因此友不仅没有与面向对象编程思想相悖,而且提高了公有接口灵活性。

71240

【C++】友 ( 友简介 | 友声明 | 友单向性 | 友继承性 | 友作用 | 友和友函数由来 | Java 反射机制 | C C++ 编译过程 )

一、友简介 1、友引入 在 C++ 语言中 , " 友 " 是 一个 与 另外一个 特殊关系累 , 在 A " 友 " B 中 , 可以直接访问 A 私有成员...friend class StudentCaculate; } 3、友单向性 友单向性 : 友关系是单向 , 声明一个 B 是 另一个 A , B 可以访问 A 所有成员..., 但是 A 不是 B , A 不能访问 B 私有和保护成员 ; 4、友继承性 友 关系不具有继承性 , 即 子类不能直接继承父 ; 5、友作用 友主要作用 :...作为 某个 数据操作 辅助 ; 作为 多个 之间 传递信息 辅助 ; 二、友和友函数由来 1、友和友函数引入 友 和 友函数 会破坏 C++ 面向对象 封装性 , 那么为什么还会出现该机制呢...void fun() { cout << "age + height = " << student.age + student.height << endl; }; public: // 此处会<em>自动</em>调用默认<em>的</em>构造函数

79310

所有的方法都可以访问原始私有成员和保护成员 声明 friend class ClassName 友声明可以位于公有、私有或保护部分,其所在位置无关紧要。...由于Remote提到了Tv, 所以编译器必须了解Tv后才能处理Remote,为些最简单方法是首先定义Tv。...Tv成员是Remote方法是volup,其它方法不是真需要作为友。...因此它是唯一需要作为友方法 确实可以选择仅让特定成员成为另一个,需不必须让整个成为友,但这样稍微有点麻烦,必须小心排列各种声明和定义顺序。...让Remote::volup()成为Tv方法,在Tv声明中将其声明为友 class {   friend void Remote::set_chan(Tv & t,int c); };

56670

Python 中

注:本文是即将出版书籍草稿,此处先睹为快。更多其他内容点击【阅读原文】查看。 9.5.2 实例 什么是“”?...__class__ 下面将内容丰富起来,让所定义具有某种特殊功能。...中所定义 __call__() 方法会在实例( Painter )执行时候才被调用,即当Painter 实例化时执行 Meta 中方法 __call__() 。...再观察方法 __call__() 参数列表,第一个参数 cls 就是实例 Painter 。...因为是定义,如果巧妙应用,能让代码简洁紧凑,更优雅,调用某些时候非常方便。 但是,读者也不必担心没有完全掌握会影响自己工作。毕竟大多数情况下,不用本节知识照样能实现所需要功能。

62520

模板

具体说,为约束模板友作准备,要使每一个基体 化都获得与友匹配基体化。...,这样每种T类型都有自己函数count(); 非约束模板友所有具体化都是每一个具体化 上边说约束模板友函数是在外面声明模板具体化。...通过在内部声明模板,可以创建非约束友函数,即每个函数具体化都是每个具体化。...也可以通过让彼此成为对方来实现, 即除了Remote是Tv外,Tv还是Remote。...如果不希望buzz()是内联,则应在一个单独方法定义文件中定义它。 共同: 一个成员函数,它可以是一个成员,同时是另一个,但有时将函数作为两个更合理。

98670

Python中

在Python中,是通过来创建就是用来创建,如果类是一个机器,那么就是可以生产机器机器。...注意,这里说是所有,自定义,内置,还有Python标准库中一些我们不会直接使用其他,就连最基object也是,同时,Python为了避免无限回溯,创建type自己也是type。...type是自身实例这一点也很“神奇”,不过这是Python面向对象最初实现。 ? 四、自定义 除了type,在Python标准库中还有其他,也就是说不止一个。...不过,所有的都是从type继承了构建能力。也就是说,-这些既是type子类,也是type实例。 from abc import ABCMeta print(ABCMeta....功能强大,但是难以掌握。除非开发框架,否则不要编写。 当然,为了学习相关概念,可以这么做。

58520

C++this指针,静态成员,友函数友

相对于成员,必须在构造对象以后才会分配内存空间,只能通过对象名访问。而静态成员在无需构造对象情况下,可以使用名访问。...友函数友 所谓友函数,就是在中,用friend关键字声明一个函数,这个函数声明在中,但不作为成员函数,虽然友函数不属于成员函数,却可以访问成员,不论成员是public,pirvate...:在实现之间数据共享时,减少系统开销,提高效率,具体来说:为了使其他成员函数直接访问该类私有变量,同时也破坏了封装性,所以不到万不得已,还是不要用友函数。...因为是需要友来共享数据,那么大多数情况,友函数都是有参数, 因为友函数没有this指针,则参数要有三种情况: 要访问非static成员时,需要对象做参数; 要访问static成员或全局变量时...,则不需要对象做参数 如果做参数对象是全局对象,则不需要对象做参数 至于友,也是一样。

1.5K10

iOS_实例、、基之间关系+结构体

文章目录 isa指针 superClass 对象结构体 结构体 分类结构体 isa指针 OC中任何定义都是对象,任何对象都有isa指针。isa是一个Class类型指针。...实例isa指针,指向isa指针,指向isa指针,指向根; 父isa指针,也指向根!! 根isa指针,指向它自己!!...superClass superClass指向父; 父superClass指向根; 根superClass指向nil; superClass指向父; 父superClass...指向根; 根superClass指向根!!!!...中 objc_class 结构体定义: struct objc_class { Class _Nonnull isa; // 指向 // 以下 OBJC2_UNAVAILABLE Class

86210

Python和新型-对象是实例,那又是谁实例?

初始 ---- 在Python2.2之后,type特殊就是这样工厂,即所谓实例,对象是实例。...Python解释器自动完成。...那么怎么设置属性? 每个都有一个属性__metaclass__用来说明该类,该属性一般由解释器自动设置,不过用户也可以更改该属性来更改。...要实现AOP所说自动调用,有的语言使用AspectJ编译器,Python则使用。 小结 ---- 具有动态改变能力,给编程带来了更方便动态性和能力。...使用对象(实例)调用 使用对象调用时,自动实例对象作为第一个参数传给该方法,即报错给了两个参数。 方法不管是使用来调用还是使用对象(实例)来调用,都是将作为第一个参数传入。

1.1K10

exec()和

{'y': 20} 二、 2.1什么是作用是什么? 在Python当中万物皆对象,我们用class关键字定义本身也是一个对象,负责产生该对象称之为可以简称为。...主要目的是为了控制创建行为。 type是Python一个内建元,用来直接控制生成,在python当中任何class定义其实都是type实例化结果。...只有继承了type才能称之为一个,否则就是一个普通自定义,自定义可以控制产生过程,产生过程其实就是调用过程。...2.2自定义创建元 自定义一个,继承type,派生出自己属性和方法 需要使用通过metaclass指定自定义好。...# 模拟type内部做事情 # 触发__call__可以控制调用。

71420

Python (MetaClass)

(MetaClass) MetaClass,直译过来就是,顾名思义,就是,如果说class是object模板,那么MetaClass就是class模板(Java使用抽象或者接口来做模板...https://en.wikipedia.org/wiki/Metaclass 命名规则是 名字 + MetaClass #说明 python中双下划线加名字再加双下划线变量名是预先定义特殊类型...__new__(cls, name, bases, attrs) #使用来创建 class MyList(list, metaclass=ListMetaclass): pass l =...: http://blog.jobbole.com/21351/ “就是深度魔法,99%用户应该根本不必为此操心。...如果你想搞清楚究竟是否需要用到,那么你就不需要它。那些实际用到的人都非常清楚地知道他们需要做什么,而且根本不需要解释为什么要用。” —— Python界领袖 Tim Peters

1.1K80
领券