Создание пользовательской ошибки в модуле, предназначенном для импорта произвольными модулями (библиотека)

Question

Я строю библиотеку Python, которая реализует очередь задач. Если по какой-либо причине поток, который обрабатывает задачи, умирает, и опция перезапуска потока не установлена, мне нужно вызвать исключение.

Это то, что я должен просто бросить RuntimeException за? Я не хочу генерировать пользовательское исключение, так как им придется импортировать это, но я не уверен, как лучше реализовать выбросы для произвольного вызывающего кода.

Answer 1

Скинь пользовательское исключение. Если пользователь библиотеки должен перехватить это исключение, он может его импортировать.

Например, возьмите pickle.PicklingError:

>>> import pickle
>>> pickle.dumps(type(None))
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "C:\Python27\lib\pickle.py", line 1374, in dumps
    Pickler(file, protocol).dump(obj)
  File "C:\Python27\lib\pickle.py", line 224, in dump
    self.save(obj)
  File "C:\Python27\lib\pickle.py", line 286, in save
    f(self, obj) # Call unbound method with explicit self
  File "C:\Python27\lib\pickle.py", line 748, in save_global
    (obj, module, name))
pickle.PicklingError: Can't pickle <type 'NoneType'>: it's not found as __builtin__.NoneType
>>> try:
...     pickle.dumps(type(None))
... except pickle.PicklingError:
...     print 'Oops.'
...
Oops.