email.errors: کلاس‌های استثنا و نقص (Defect)¶

کد منبع: Lib/email/errors.py

کلاس‌های استثنای زیر در ماژول email.errors تعریف شده‌اند:

exception email.errors.MessageError¶

این کلاس، کلاس پایه برای تمام استثناهایی است که بسته‌ی email می‌تواند پرتاب کند. این کلاس از کلاس استاندارد Exception مشتق شده است و هیچ متد اضافه‌ای تعریف نمی‌کند.

exception email.errors.MessageParseError¶

این کلاس پایه‌ای برای استثناهای پرتاب‌شده توسط کلاس Parser است. این کلاس از MessageError مشتق شده است. این کلاس همچنین به‌صورت داخلی توسط پارسری که headerregistry از آن استفاده می‌کند، به کار می‌رود.

exception email.errors.HeaderParseError¶

این کلاس که تحت برخی شرایط خطا هنگام تجزیه سرآیندهای RFC 5322 یک پیام پرتاب می‌شود، از MessageParseError مشتق شده است. متد set_boundary() این خطا را در صورتی پرتاب می‌کند که نوع محتوا هنگام فراخوانی متد ناشناخته باشد. Header ممکن است این خطا را برای برخی خطاهای کدگشایی base64، و همچنین هنگامی که تلاشی برای ایجاد سرآیندی انجام شود که به نظر می‌رسد حاوی یک سرآیند تعبیه‌شده است (یعنی سطری که قرار است خط ادامه باشد، فضای سفید پیشرو ندارد و شبیه یک سرآیند است)، پرتاب کند.

exception email.errors.BoundaryError¶

منسوخ شده و دیگر استفاده نمی‌شود.

exception email.errors.MultipartConversionError¶

در صورتی پرتاب می‌شود که متد attach() روی نمونه‌ای از کلاسی مشتق‌شده از MIMENonMultipart فراخوانی شود (برای مثال MIMEImage). MultipartConversionError به‌صورت چندگانه از MessageError و استثنای توکار TypeError ارث می‌برد.

exception email.errors.HeaderWriteError¶

هنگامی پرتاب می‌شود که هنگام خروجی‌دادن سرآیندها توسط generator خطایی رخ دهد.

exception email.errors.MessageDefect¶

این کلاس، کلاس پایه برای تمام نقص‌های یافت‌شده هنگام تجزیه پیام‌های ایمیل است. این کلاس از ValueError مشتق شده است.

exception email.errors.HeaderDefect¶

این کلاس، کلاس پایه برای همه نقص‌های یافت‌شده هنگام تجزیه سرآیندهای ایمیل است. این کلاس از MessageDefect مشتق شده است.

در اینجا فهرستی از نقص‌هایی آمده است که FeedParser می‌تواند هنگام تجزیه پیام‌ها پیدا کند. توجه داشته باشید که نقص‌ها به پیامی اضافه می‌شوند که مشکل در آن یافت شده است؛ بنابراین برای مثال، اگر پیامی که درون یک multipart/alternative تودرتو شده است سرآیند با قالب نادرست داشته باشد، آن شیء پیام تودرتو نقص خواهد داشت، اما پیام‌های حاوی آن نقص نخواهند داشت.

همه‌ی کلاس‌های نقص، زیرکلاس‌های email.errors.MessageDefect هستند.

exception email.errors.NoBoundaryInMultipartDefect¶

پیامی ادعا کرده بود که چندبخشی (multipart) است، اما پارامتر boundary نداشت.

exception email.errors.StartBoundaryNotFoundDefect¶

مرز آغازین اعلام‌شده در سرآیند Content-Type هرگز پیدا نشد.

exception email.errors.CloseBoundaryNotFoundDefect¶

یک مرز آغازین یافت شد، اما هرگز مرز پایانی متناظری یافت نشد.

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

exception email.errors.FirstHeaderLineIsContinuationDefect¶

پیام دارای یک خط ادامه به‌عنوان نخستین خط سرآیند خود بود.

exception email.errors.MisplacedEnvelopeHeaderDefect¶

یک سرآیند «Unix From» در میانه‌ی یک بلوک سرآیند یافت شد.

exception email.errors.MissingHeaderBodySeparatorDefect¶

در هنگام تجزیه سرآیندها، سطری یافت شد که فضای سفید پیشرو نداشت اما شامل «:» نبود. تجزیه با این فرض ادامه می‌یابد که این خط، نشان‌دهنده نخستین خط بدنه است.

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

exception email.errors.MalformedHeaderDefect¶

سرآیندی یافت شد که فاقد علامت دونقطه بود یا به شکل دیگری نامعتبر بود.

منسوخ شده از نسخه‌ی 3.3: این نقص برای چندین نسخه پایتون استفاده نشده است.

exception email.errors.MultipartInvariantViolationDefect¶

پیامی ادعا می‌کرد که multipart است، اما هیچ زیربخشی یافت نشد. توجه داشته باشید که هنگامی که پیامی این نقص را دارد، ممکن است متد is_multipart() آن False را برگرداند، حتی اگر نوع محتوای آن ادعا کند که multipart است.

exception email.errors.InvalidBase64PaddingDefect¶

هنگام کدگشایی بلوکی از بایت‌های کدگذاری‌شده با base64، پرکننده (padding) صحیح نبود. پرکننده‌ی کافی برای انجام کدگشایی اضافه می‌شود، اما بایت‌های حاصل از کدگشایی ممکن است نامعتبر باشند.

exception email.errors.InvalidBase64CharactersDefect¶

هنگام کدگشایی یک بلوک از بایت‌های کدگذاری‌شده‌ی base64، نویسه‌هایی خارج از الفبای base64 مشاهده شدند. این نویسه‌ها نادیده گرفته می‌شوند، اما بایت‌های کدگشایی‌شده‌ی حاصل ممکن است نامعتبر باشند.

exception email.errors.InvalidBase64LengthDefect¶

هنگام کدگشایی یک بلوک از بایت‌های کدگذاری‌شده به base64، تعداد نویسه‌های base64 غیر از پرکننده (padding) نامعتبر بود (۱ بیشتر از مضربی از ۴). بلوک کدگذاری‌شده بدون تغییر نگه داشته شد.

exception email.errors.InvalidDateDefect¶

هنگام کدگشایی یک فیلد تاریخ نامعتبر یا غیرقابل‌تجزیه. مقدار اصلی همان‌طور که هست نگه داشته می‌شود.