Какое исключение для рейза, если данная строка не соответствует некоторому формату?

Question

Это продолжение до older question.

Учитывая номер ISBN, например. 3-528-03851-5 Какой тип исключения следует поднять, если переданная строка не соответствует формату X-XXX-XXXXX-X?

Answer 1

Поднять ValueError.

Это довольно стандартный способ сказать: «Ты дал мне значение, которое не имеет смысла». Например:

 
>>> int("a") 
Traceback (most recent call last): 
    File "", line 1, in 
ValueError: invalid literal for int() with base 10: 'a' 
>>> import shlex; shlex.split("'") 
Traceback (most recent call last): 
    ... 
ValueError: No closing quotation 

Контраст этого с TypeError, которая возникает, когда тип неверен:

 
>>> d = {} 
>>> d[{}] 
Traceback (most recent call last): 
    File "", line 1, in 
TypeError: unhashable type: 'dict' 

Answer 2

ValueError может быть наиболее подходящим выбором. Согласно его документам, это значение, когда значение имеет правильный тип, но несоответствующее значение.

http://docs.python.org/library/exceptions.html#exceptions.ValueError

Answer 3

Я думаю, что я хотел бы сделать класс исключения, чтобы поднять в этом случае, так как его очень специфический тип исключения. Вы можете легко расширить класс ValueError:

class ISBNFormatException(ValueError): 
    """Raised when an invalid ISBN format is found""" 
    pass