Python: Modernise raise-not-implemented query

[joefarebrother]

Straightforward port away from pointsTo, and documentation updates

[Copilot]

Pull Request Overview

This PR modernizes the "raise-not-implemented" query by migrating away from the pointsTo API to use the newer ApiGraphs framework, along with updating documentation for clarity.

• Replaces the deprecated pointsTo-based implementation with ApiGraphs API for detecting NotImplemented usage
• Updates query name and description to be more descriptive
• Improves documentation with clearer explanations and additional references

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File	Description
NotImplementedIsNotAnException.ql	Modernizes query implementation using ApiGraphs instead of pointsTo
NotImplementedIsNotAnException.qhelp	Updates documentation with clearer explanations and additional reference links

[github-actions]

QHelp previews:

python/ql/src/Exceptions/NotImplementedIsNotAnException.qhelp

Raising NotImplemented

The constant NotImplemented is not an Exception, but is often confused for NotImplementedError. If it is used as an exception, such as in raise NotImplemented or raise NotImplemented("message"), a TypeError will be raised rather than the expected NotImplemented. This may make debugging more difficult.

NotImplemented should only be used as a special return value for implementing special methods such as __lt__. Code that is not intended to be called should raise NotImplementedError.

Recommendation

If a NotImplementedError is intended to be raised, replace the use of NotImplemented with that. If NotImplemented is intended to be returned rather than raised, replace the raise with return NotImplemented

Example

In the following example, the method wrong will incorrectly raise a TypeError when called. The method right will raise a NotImplementedError.

class Abstract(object):

    def wrong(self):
        # Will raise a TypeError
        raise NotImplemented()

    def right(self):
        raise NotImplementedError()

References

• Python Language Reference: The NotImplementedError exception.
• Python Language Reference: The NotImplemented constant.
• Python Language Reference: Emulating numeric types.