Add type stub for colour package

[absolutely-vivid]

This PR adds type stubs for the colour package.

There were a few small issues when writing the stubs that might need changes before merging:

• stubtest didn't like the type I wrote for colour.Color.set_hex_l, it said the runtime type was Callable[[Any], Any]. I think that's because set_hex_l isn't defined as a method, but as a class variable with a lambda. I added colour.COlor.set_hex_l to the allowlist
• colour.Color.__eq__'s implementation can return (not raise) NotImplemented. Mypy and pyright both disallow that, so I set a noqa
• Mypy complains about the colour.Color.hash_or_str overload, saying overload 1 is wider than overload 2. However Hashable is narrower than object (set is object but not hashable), so that shouldn't be the case. I ignored with a noqa comment

If there are more idiomatic ways to fix any of those, let me know and I can make the changes.

[absolutely-vivid]

colour.Color.__eq__'s implementation can return (not raise) NotImplemented. Mypy and pyright both disallow that, so I set a noqa

I discovered types.NotImplementedType and changed the stub to return that instead of type[NotImplemented]. That fixed the valid-type error from mypy and the reportInvalidTypeForm error from pyright.

[absolutely-vivid]

The failing tests are caused by numpy, not my changes.

[jorenham]

Colour already has typing support, so I don't really see the benefit of this?

Nevermind; different colour 😋

[srittau]

Sorry for the delay. I few remarks below.

Just using set_hex_l = set_hex in the hex directly below the def set_hex... statement should work. If it doesn't I need to have a look at the exact error.

[absolutely-vivid]

No worries, thanks for the review! I made all the requested changes.

It turns out the stubtest error was being caused by the signature for set_hex_l lacking a self parameter. I fixed the method signature and removed the allowlist entry.

[github-actions]

According to mypy_primer, this change has no effect on the checked open source code. 🤖🎉