اشیای Repr¶

نمونه‌های Repr چندین ویژگی ارائه می‌دهند که می‌توانند برای تعیین محدودیت‌های اندازه برای بازنمایی انواع مختلف شیء استفاده شوند، و متدهایی که انواع خاص شیء را قالب‌بندی می‌کنند.

Repr.fillvalue¶

این رشته برای ارجاعات بازگشتی نمایش داده می‌شود. مقدار پیش‌فرض آن ... است.

اضافه شده در نسخه‌ی 3.11.

Repr.maxlevel¶

محدودیت عمق در ایجاد بازنمایی‌های بازگشتی. مقدار پیش‌فرض 6 است.

Repr.maxdict¶

Repr.maxlist¶

Repr.maxtuple¶

Repr.maxset¶

Repr.maxfrozenset¶

Repr.maxdeque¶

Repr.maxarray¶

محدودیت‌های تعداد آیتم‌های بازنمایی‌شده برای نوع شیء نام‌برده‌شده. مقدار پیش‌فرض برای maxdict برابر 4، برای maxarray برابر 5 و برای سایر موارد برابر 6 است.

Repr.maxlong¶

حداکثر تعداد نویسه‌ها در بازنمایی یک عدد صحیح. ارقام از میانه حذف می‌شوند. مقدار پیش‌فرض 40 است.

Repr.maxstring¶

محدودیت تعداد نویسه‌ها در بازنمایی رشته. توجه داشته باشید که بازنمایی «عادی» رشته به‌عنوان منبع نویسه‌ها استفاده می‌شود: اگر در بازنمایی به دنباله‌های خنثی‌سازی نیاز باشد، ممکن است این دنباله‌ها هنگام کوتاه‌شدن بازنمایی ناقص شوند. مقدار پیش‌فرض 30 است.

Repr.maxother¶

این محدودیت برای کنترل اندازه‌ی انواع شیءهایی به کار می‌رود که هیچ متد قالب‌بندی مشخصی برای آن‌ها در شیء Repr در دسترس نیست. این محدودیت به شیوه‌ای مشابه maxstring اعمال می‌شود. مقدار پیش‌فرض 20 است.

Repr.indent¶

اگر این ویژگی روی None تنظیم شده باشد (پیش‌فرض)، خروجی بدون شکست خط یا تورفتگی قالب‌بندی می‌شود، مانند repr() استاندارد. برای مثال:

>>> example = [
...     1, 'spam', {'a': 2, 'b': 'spam eggs', 'c': {3: 4.5, 6: []}}, 'ham']
>>> import reprlib
>>> aRepr = reprlib.Repr()
>>> print(aRepr.repr(example))
[1, 'spam', {'a': 2, 'b': 'spam eggs', 'c': {3: 4.5, 6: []}}, 'ham']

اگر indent روی یک رشته تنظیم شود، هر سطح بازگشت در خط خودش قرار می‌گیرد و با آن رشته تورفتگی داده می‌شود:

>>> aRepr.indent = '-->'
>>> print(aRepr.repr(example))
[
-->1,
-->'spam',
-->{
-->-->'a': 2,
-->-->'b': 'spam eggs',
-->-->'c': {
-->-->-->3: 4.5,
-->-->-->6: [],
-->-->},
-->},
-->'ham',
]

اگر indent را به یک مقدار عدد صحیح مثبت تنظیم کنید، به‌گونه‌ای رفتار می‌کند که گویی به رشته‌ای با آن تعداد فاصله تنظیم شده باشد:

>>> aRepr.indent = 4
>>> print(aRepr.repr(example))
[
    1,
    'spam',
    {
        'a': 2,
        'b': 'spam eggs',
        'c': {
            3: 4.5,
            6: [],
        },
    },
    'ham',
]

اضافه شده در نسخه‌ی 3.12.

Repr.repr(obj)¶

معادل تابع توکار repr() که از قالب‌بندی اعمال‌شده توسط نمونه استفاده می‌کند.

Repr.repr1(obj, level)¶

پیاده‌سازی بازگشتی که توسط repr() استفاده می‌شود. این پیاده‌سازی از نوع obj برای تعیین متد قالب‌بندی مناسب جهت فراخوانی استفاده می‌کند و obj و level را به آن منتقل می‌کند. متدهای مخصوص نوع باید برای انجام قالب‌بندی بازگشتی، repr1() را فراخوانی کنند و در فراخوانی بازگشتی، level - 1 را به‌عنوان مقدار level استفاده کنند.

Repr.repr_TYPE(obj, level)

متدهای قالب‌بندی برای انواع خاص به‌صورت متدهایی با نامی مبتنی بر نام نوع پیاده‌سازی شده‌اند. در نام متد، TYPE با '_'.join(type(obj).__name__.split()) جایگزین می‌شود. اعزام (dispatch) به این متدها توسط repr1() مدیریت می‌شود. متدهای مختص به نوعی که نیاز دارند یک مقدار را به‌صورت بازگشتی قالب‌بندی کنند، باید self.repr1(subobj, level - 1) را فراخوانی کنند.

زیرکلاس‌سازی اشیاء Repr¶

استفاده از اعزام پویا (dynamic dispatching) توسط Repr.repr1() به زیرکلاس‌های Repr اجازه می‌دهد پشتیبانی از انواع بیشتری از اشیای توکار را اضافه کنند یا مدیریت انواع از پیش پشتیبانی‌شده را تغییر دهند. این مثال نشان می‌دهد که چگونه می‌توان پشتیبانی ویژه‌ای برای اشیای پرونده اضافه کرد:

import reprlib
import sys

class MyRepr(reprlib.Repr):

    def repr_TextIOWrapper(self, obj, level):
        if obj.name in {'<stdin>', '<stdout>', '<stderr>'}:
            return obj.name
        return repr(obj)

aRepr = MyRepr()
print(aRepr.repr(sys.stdin))         # prints '<stdin>'

<stdin>