ऑटोक्लस और इंस्टेंस गुण

Question

sphinx documentation के अनुसार, .. autoattribute निर्देश उदाहरण विशेषताओं को दस्तावेज़ करने में सक्षम होना चाहिए। हालांकि, अगर मैं ऐसा ::

.. currentmodule:: xml.etree.ElementTree 

.. autoclass:: ElementTree 

    .. autoattribute:: ElementTree._root 

फिर जब निर्माण मैं एक AttributeError मिलती है:

Traceback (most recent call last):etree.ElementTree.ElementTree     
    File "/Volumes/Raptor/Library/Python/2.7/lib/python/site-packages/sphinx/ext/autodoc.py", line 326, in import_object 
    obj = self.get_attr(obj, part) 
    File "/Volumes/Raptor/Library/Python/2.7/lib/python/site-packages/sphinx/ext/autodoc.py", line 232, in get_attr 
    return safe_getattr(obj, name, *defargs) 
    File "/Volumes/Raptor/Library/Python/2.7/lib/python/site-packages/sphinx/util/inspect.py", line 70, in safe_getattr 
    raise AttributeError(name) 
AttributeError: _root 

भले ही मैं ElementTree का दृष्टांत और कोशिश करते हैं और _root विशेषता का उपयोग हालांकि, यह ठीक काम करता है ::

>>> from xml.etree.ElementTree import ElementTree 
>>> e = ElementTree() 
>>> hasattr(e, '_root') 
True 

मैं क्या गलत कर रहा हूं?

(मैं वास्तव में मेरे अपने वर्गों में से एक के साथ इस समस्या हो रही है, लेकिन सिर्फ एक उदाहरण के रूप ElementTree वर्ग का उपयोग कर रहा है, क्योंकि यह मानक पुस्तकालय में है)

Answer 1

इस तरह में एक बग की तरह दिखता है गैर सार्वजनिक उदाहरण विशेषताओं को संभाला जाता है। स्फिंक्स instance attributes defined in __init__ को पहचानने में सक्षम होना चाहिए।

मैं नहीं कह सकता कि यह कैसे तय किया जाना चाहिए। एक खुली बग रिपोर्ट है जो संबंधित प्रतीत होती है: Non-public instance attributes are not documented without __slots__।

निम्न पंक्ति ElementTree.py में ElementTree वर्ग की परिभाषा के लिए जोड़ा जाता है,

__slots__ = ["_root"] 

तो AttributeError है कि आप प्राप्त कर चली जाती है।