[Feature Request] Generalize @beartype to support `class` decoration

Apologies if this is a dup. This is interesting…

# test_case.py
from __future__ import annotations
from typing import Union
from beartype import beartype

class Test:
    @beartype
    def okay(self) -> Test:
        return Test()

    def okay_too(self, other: Union[int, str, Test]) -> Test:
        return Test()

    @beartype
    def also_okay(self, other: Union[int, str, "Test"]) -> Test:
        return Test()

    @beartype
    def also_also_okay(self, other: Union[int, str, "Test"]) -> "Test":
        return Test()

    # @beartype  # uncomment me for ...
    def a_kaboom(self, other: Union[int, str, Test]) -> Test:
        return Test()

    @beartype  # uncomment me for ...
    def another_kaboom(self, other: Union[int, str, Test]) -> "Test":
        return Test()

As-is:

% python --version  # also happens with 3.9.13
Python 3.10.5
% python -c 'import beartype ; print(beartype.__version__)'
0.10.4
% python test_case.py
[no output]

Now uncomment @beartype decorating a_kaboom:

% python test_case.py
Traceback (most recent call last):
  File "/…/lib/python3.10/site-packages/beartype/_decor/_pep/pep563.py", line 338, in resolve_hints_pep563_if_active
    func_hints_resolved[pith_name] = eval(
  File "<string>", line 1, in <module>
NameError: name 'Test' is not defined

The above exception was the direct cause of the following exception:

Traceback (most recent call last):
  File "/…/test_case.py", line 6, in <module>
    class Test:
  File "/…/test_case.py", line 23, in Test
    def a_kaboom(self, other: Union[int, str, Test]) -> Test:
  File "/…/lib/python3.10/site-packages/beartype/_decor/cache/cachedecor.py", line 77, in beartype
    return beartype_args_mandatory(obj, conf)
  File "/…/lib/python3.10/site-packages/beartype/_decor/_core.py", line 140, in beartype_args_mandatory
    return _beartype_func(func=obj, conf=conf)
  File "/…/lib/python3.10/site-packages/beartype/_decor/_core.py", line 168, in _beartype_func
    func_data.reinit(func, conf)
  File "/…/lib/python3.10/site-packages/beartype/_decor/_call.py", line 285, in reinit
    resolve_hints_pep563_if_active(self)
  File "/…/lib/python3.10/site-packages/beartype/_decor/_pep/pep563.py", line 375, in resolve_hints_pep563_if_active
    raise BeartypeDecorHintPep563Exception(
beartype.roar.BeartypeDecorHintPep563Exception: @beartyped Test.a_kaboom() parameter "other" PEP 563-postponed type hint 'Union[int, str, Test]' syntactically invalid (i.e., "name 'Test' is not defined") under:
~~~~[ GLOBAL SCOPE ]~~~~
{'__name__': '__main__', '__doc__': None, '__package__': None, '__loader__': <_frozen_importlib_external.SourceFileLoader object at 0x10c09d2a0>, '__spec__': None, '__annotations__': {}, '__builtins__': <module 'builtins' (built-in)>, '__file__': '/…/test_case.py', '__cached__': None, 'annotations': _Feature((3, 7, 0, 'beta', 1), (3, 11, 0, 'alpha', 0), 16777216), 'Union': typing.Union, 'beartype': <function beartype at 0x10c7a7250>}
~~~~[ LOCAL SCOPE  ]~~~~
{'__module__': '__main__', '__qualname__': 'Test', 'okay': <function Test.okay at 0x10c1284c0>, 'okay_too': <function Test.okay_too at 0x10c8c8e50>, 'also_okay': <function Test.also_okay at 0x10c8c9000>, 'also_also_okay': <function Test.also_also_okay at 0x10c8c9120>}

You’ll get something similar when uncommenting another_kaboom as well.

[posita]

If it’s convenient, I’m happy to pretend I never saw this. 😉

[leycec]

I feel it is my duty to declare your attempt to Locate Your Objective in your Delve of this Haunted Icereach as resolved with a Strong Hit. I also wish you luck in returning to your game of Call of Savage Dragon Worlds in the Dark Powered by Numenuma Fate™, 4th Edition by West Palladium Jackson Games®.

Holy dragon balls. I read that in the thick, gravel-throated intonation of Christopher Lee’s Saruman, who was also required by Jackson’s dubious legal counsel to slowly read out each of the ™ and ® Unicode symbols. Thanks so much for the morning chuckles. 😆