abcmeta
Python meta class and abstract method library with restrictions.
This library provides a restricted way to validate abstract methods. The Python's default abstract method library only validates the methods that exist in the derived classes and nothing else. What this library provides is apart from that validation it provides validations over the method's signature. All you need is to import ABCMeta and abstractmethod from this library.
It works on both annotations and without annotations methods.
Installation
You can install the package by pip:
$ pip install abcmeta
Note: abcmeta supports Python3.6+.
Quick start
from typing import Dict, Text
from abcmeta import ABCMeta, abstractmethod
class Base(ABCMeta):
@abstractmethod
def method_2(self, name: Text, age: int) -> Dict[Text, Text]:
"""Abstract method."""
@abstractmethod
def method_3(self, name, age):
"""Abstract method."""
class Drived(Base):
def method_2(self, name: Text, age: int) -> Dict[Text, Text]:
return {"name": "test"}
def method_3(self, name, age):
pass
If you put a different signature, it will raise an error with 'diff' format with hints about what you've missed:
class Drived(Base):
def method_2(self, name: Text, age: int) -> List[Text]:
return {"name": "test"}
And it will raise:
Traceback (most recent call last):
File "/Workspaces/test.py", line 41, in <module>
class Drived(Base):
File "/usr/lib/python3.9/abc.py", line 85, in __new__
cls = super().__new__(mcls, name, bases, namespace, **kwargs)
File "/abcmeta/__init__.py", line 179, in __init_subclass__
raise AttributeError(
AttributeError: Signature of the derived method is not the same as parent class:
- method_2(self, name: str, age: int) -> Dict[str, str]
? ^ ^ -----
+ method_2(self, name: str, age: int) -> List[str]
? ^ ^
Derived method expected to return in 'typing.Dict[str, str]' type, but returns 'typing.List[str]'
For different parameter names:
class Drived(Base):
def method_2(self, username: Text, age: int) -> List[Text]:
return {"name": "test"}
And it will raise:
Traceback (most recent call last):
File "/Workspaces/test.py", line 41, in <module>
class Drived(Base):
File "/usr/lib/python3.9/abc.py", line 85, in __new__
cls = super().__new__(mcls, name, bases, namespace, **kwargs)
File "/abcmeta/__init__.py", line 180, in __init_subclass__
raise AttributeError(
AttributeError: Signature of the derived method is not the same as parent class:
- method_2(self, name: str, age: int) -> Dict[str, str]
+ method_2(self, username: str, age: int) -> Dict[str, str]
? ++++
Derived method expected to get name paramter, but gets username
Issue
If you're faced with a problem, please file an issue on Github.
Contribute
You're always welcome to contribute to the project! Please file an issue and send your great PR.
License
Please read the LICENSE file.
3 Apr 18, 2022
1 Feb 2, 2022
16 Aug 8, 2022
8 Mar 23, 2022
3 Oct 24, 2022
6 Sep 9, 2022
2 Feb 3, 2022
5 May 30, 2022
1 Dec 18, 2021
1 Dec 15, 2021
9 Nov 27, 2022
1 Oct 08, 2022
2 Jan 09, 2022
17 Nov 24, 2022
1 Nov 27, 2021
7 Sep 15, 2021
12.5k Jan 07, 2023
3 Jan 16, 2022
4 Mar 02, 2022
3 Jan 06, 2022
13 Dec 23, 2022
64 Dec 23, 2022
1.8k Jan 06, 2023
301 Dec 28, 2022
10 Oct 11, 2022
14 Nov 20, 2022
1 Feb 10, 2021
6 Nov 27, 2022
2 Mar 19, 2022