Pyautoscoper type validator

[NicerNewerCar]

• Closes Improve robustness of PyAutoscoper introducing validator #171
• Introduces validator classes to validate types within PyAutoscoper before sending them off to the Autoscoper server
• Introduces unit tests for the validators and enum types

[jcfr]

Before adding validation, I suggest to add the missing annotation types by fixing the errors reported after enabling the ANN checks associated with ruff linting introduced in:

• Update pre commit adding ruff linter #190

[NicerNewerCar]

Before adding validation, I suggest to add the missing annotation types by fixing the errors reported after enabling the ANN checks associated with ruff linting introduced in:

• Update pre commit adding ruff linter #190

See #192

[jcfr]

Relevant documentation:

• Python Type Hints - How to Type a Descriptor: https://adamj.eu/tech/2021/10/18/python-type-hints-how-to-type-a-descriptor/

[jcfr]

We should also look into typeguard. See https://typeguard.readthedocs.io/en/latest/extending.html

It seems like we could specify custom types as annotation and have these used at runtime when the function is called.

Also relevant:

• PEP 647 – User-Defined Type Guards: https://peps.python.org/pep-0647/
• https://mypy.readthedocs.io/en/stable/type_narrowing.html#user-defined-type-guards

[NicerNewerCar]

@jcfr The only errors in ruff now are a couple of ANN401 Dynamically typed expressions (typing.Any) are disallowed in value related to the any typing within the abstract Validator class:

Autoscoper/scripts/python/PyAutoscoper/validators.py

Lines 8 to 24 in 7513ea9

	class Validator(ABC):
	"""Abstract base class for validators."""
	def __set_name__(self, owner: type[object], name: str) -> None:
	self.private_name = f"_{name}"
	def __get__(self, obj: object, objtype: type[object] | None = None) -> Any:
	return getattr(obj, self.private_name)
	def __set__(self, obj: object, value: Any) -> None:
	self.validate(value)
	setattr(obj, self.private_name, value)
	@abstractmethod
	def validate(self, value: Any) -> None:
	"""Validate the value."""
	pass