Có phải là thông thường để nâng cao NotIm HiệnedError cho các phương thức mà việc triển khai đang chờ xử lý, nhưng không được lên kế hoạch trừu tượng?

Tôi muốn đưa ra một NotImplementedErrorphương pháp cho bất kỳ phương pháp nào tôi muốn thực hiện, nhưng tôi chưa có cơ hội để thực hiện nó. Tôi có thể đã thực hiện một phần, nhưng hãy chuẩn bị trước raise NotImplementedError()vì tôi chưa thích. Mặt khác, tôi cũng thích tuân theo các quy ước, bởi vì điều này sẽ giúp người khác dễ dàng duy trì mã của tôi hơn và các quy ước có thể tồn tại vì một lý do chính đáng.

Tuy nhiên, tài liệu của Pythons cho các trạng thái NotImcellenceedError :

Ngoại lệ này có nguồn gốc từ RuntimeError. Trong các lớp cơ sở do người dùng định nghĩa, các phương thức trừu tượng sẽ đưa ra ngoại lệ này khi chúng yêu cầu các lớp dẫn xuất ghi đè lên phương thức.

Đó là một trường hợp sử dụng chính thức, cụ thể hơn nhiều so với trường hợp tôi mô tả. Đây có phải là một phong cách thông thường, tốt để nêu lên một NotImplementedErrorcách đơn giản để chỉ ra rằng phần này của API đang trong quá trình thực hiện không? Nếu không, có một cách tiêu chuẩn hóa khác để chỉ ra điều này?

Điều đáng chú ý là, trong khi tài liệu Python cung cấp trường hợp sử dụng (và có thể là trường hợp chính tắc) cho ngoại lệ này, thì nó không loại trừ cụ thể việc sử dụng nó trong các tình huống khác.

Tôi sẽ xem xét nó có phù hợp để đưa ra một ngoại lệ NotIm HiệnedError nếu bạn chưa ghi đè một phương thức trong lớp cơ sở (để đáp ứng "giao diện").

Một kiểm tra chữ thảo trên Google cho thấy mọi người sẽ hiểu ý của bạn nếu bạn sử dụng ngoại lệ theo cách này. Không có tác dụng phụ hoặc hậu quả không lường trước mà tôi biết; phương thức sẽ đơn giản ném một ngoại lệ nếu nó được gọi và nó sẽ ném một ngoại lệ được mọi người hiểu rõ.

Các tài liệu cho Python 3 phản ánh việc sử dụng này chính xác:

Trong các lớp cơ sở do người dùng định nghĩa, các phương thức trừu tượng sẽ đưa ra ngoại lệ này khi chúng yêu cầu các lớp dẫn xuất ghi đè lên phương thức hoặc trong khi lớp đang được phát triển để chỉ ra rằng việc triển khai thực sự vẫn cần phải được thêm vào . [Nhấn mạnh thêm]

Điều này sẽ được hiểu, cho dù bạn làm điều đó hay không nên phụ thuộc vào các quy ước (nhóm hoặc công ty) địa phương. Lưu ý rằng điều đó có ý nghĩa ít hơn trong ngữ cảnh của TDD vì TEST phải là điều quyết định rằng phương thức này không được thực hiện.

Phiên bản ngắn là: sử dụng nếu bạn và nhóm của bạn cho rằng nó phù hợp.

Có vẻ như điều đó NotImplementedErrorthường được nêu ra cho chính sự phát triển tính năng của Python, như sau:

@classmethod
def fromkeys(cls, iterable, v=None):
    # There is no equivalent method for counters because setting v=1
    # means that no element can have a count greater than one.
    raise NotImplementedError(
        'Counter.fromkeys() is undefined.  Use Counter(iterable) instead.')

Tài liệu

từ khóa (lặp lại)

Phương thức lớp này không được thực hiện cho các đối tượng Counter.

Nguồn

Bộ sưu tập.Count.fromkeys