0Pricing
Python Academy · Lekcja

Niestandardowe klasy wyjątków

Proszę definiować własne typy wyjątków, aby klarowniej przekazywać informacje o błędach.

Niestandardowe klasy wyjątków to bezpłatna lekcja Python Academy na CoddyKit. To lekcja 4 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Python Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Python Academy zawiera 4 lekcji w sumie.

Wprowadzenie

Niestandardowe klasy wyjątków sprawiają, że obsługa błędów jest jawna, samodokumentująca się i ułatwia precyzyjną obsługę wyjątków przez kod wywołujący.

Dlaczego niestandardowe wyjątki?

Wbudowane wyjątki są zbyt ogólne. Niestandardowe wyjątki pozwalają kodowi wywołującemu przechwytywać wyłącznie błędy własnej biblioteki, bez przechwytywania niezwiązanych z nią wyjątków.
class AppError(Exception):
    pass
raise AppError('something went wrong')

Dziedziczenie po Exception

class MyError(Exception): pass to wszystko, czego potrzeba. Należy zawsze dziedziczyć po Exception, a nie po BaseException.
class ValidationError(Exception):
    pass
try:
    raise ValidationError('email is invalid')
except ValidationError as e:
    print(e)

Dodawanie niestandardowych atrybutów

class APIError(Exception): def __init__(self, status, message): self.status = status; super().__init__(message)
class APIError(Exception):
    def __init__(self, status, message):
        self.status = status
        super().__init__(message)
try:
    raise APIError(404, 'Not found')
except APIError as e:
    print(e.status, e)

Hierarchia wyjątków

Należy zbudować hierarchię: class DBError(AppError): pass — kod wywołujący może przechwycić AppError dla dowolnego błędu aplikacji albo konkretnie DBError.
class AppError(Exception): pass
class DBError(AppError): pass
class NetworkError(AppError): pass
try:
    raise DBError('timeout')
except AppError as e:
    print('app error:', e)

Niestandardowa metoda __str__

Należy przesłonić __str__, aby określić wygląd komunikatu wyjątku podczas jego wyświetlania.
class RangeError(ValueError):
    def __init__(self, val, lo, hi):
        self.val, self.lo, self.hi = val, lo, hi
    def __str__(self):
        return f'{self.val} not in [{self.lo}, {self.hi}]'
print(RangeError(15, 0, 10))

Zgłaszanie niestandardowych wyjątków

Należy używać raise w funkcjach do sygnalizowania błędów charakterystycznych dla danej dziedziny. Tworzy to przejrzysty interfejs API dla kodu wywołującego.
class InsufficientFundsError(Exception):
    def __init__(self, needed, available):
        super().__init__(f'Need {needed}, have {available}')
def withdraw(balance, amount):
    if amount > balance:
        raise InsufficientFundsError(amount, balance)
    return balance - amount
try:
    withdraw(100, 200)
except InsufficientFundsError as e:
    print(e)

Przechwytywanie według klasy bazowej

except AppError przechwytuje wszystkie klasy pochodne: DBError, NetworkError itd. Hierarchia pozwala kodowi wywołującemu wybrać poziom szczegółowości.
class AppError(Exception): pass
class DBError(AppError): pass
try:
    raise DBError('conn failed')
except AppError:
    print('any app error')

Wyjątek z menedżerem kontekstu

Niestandardowe wyjątki współpracują z menedżerami kontekstu: class suppressed: __exit__ zwraca True, aby ukryć wyjątek.
class SuppressValue(Exception): pass
try:
    raise SuppressValue('ignored')
except SuppressValue:
    pass  # suppress silently
print('continued')

Dokumentowanie niestandardowych wyjątków

Należy opisać, KIEDY zgłaszać wyjątek i CO oznaczają jego atrybuty. Dobre docstringi ułatwiają korzystanie z niestandardowych wyjątków.
class ConfigError(Exception):
    """Raised when configuration is invalid.
    Attributes:
        key: The invalid config key
    """
    def __init__(self, key, msg):
        super().__init__(msg)
        self.key = key

Najlepsze praktyki

Hierarchia powinna być płytka (2–3 poziomy). Należy zawsze dziedziczyć po Exception. Należy używać opisowych nazw kończących się na Error. Wyjątki należy umieścić w dedykowanym module exceptions.py.
# Good structure:
class AppError(Exception): pass
class ValidationError(AppError): pass
class NotFoundError(AppError): pass
print('hierarchy demo')

Szybkie sprawdzenie

Po jakiej klasie powinny dziedziczyć niestandardowe wyjątki, aby uniknąć przechwytywania zdarzeń kończących działanie systemu?

Podsumowanie

Niestandardowe wyjątki: dziedziczą po Exception, dodają atrybuty w __init__ i przesłaniają __str__. Hierarchie ułatwiają ich przechwytywanie. Wyjątki należy umieścić w module exceptions.py.

Kontynuuj naukę

Świetna praca! Przejdź do następnej lekcji, aby kontynuować naukę.

Często zadawane pytania

Czy lekcja „Niestandardowe klasy wyjątków” jest bezpłatna?

Tak — pełny tekst „Niestandardowe klasy wyjątków” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Python Academy, przejdź na CoddyKit PRO. Kurs Python Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Niestandardowe klasy wyjątków”?

Proszę definiować własne typy wyjątków, aby klarowniej przekazywać informacje o błędach. Ćwiczysz Python Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Python Academy?

Nie wymagamy żadnego doświadczenia. Python Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 4 z 4.

Ile czasu zajmuje lekcja „Niestandardowe klasy wyjątków”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Python Academy?

Tak. Każda lekcja Python Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

  1. Zrozumienie wyjątków
  2. try / except / else / finally
  3. Zgłaszanie i ponowne zgłaszanie wyjątków
  4. Niestandardowe klasy wyjątków
← Powrót do Python Academy