Getting Started With Python's ABC

Originally Published on GeekPython.in

What is the ABC of Python? It stands for the abstract base class and is a concept in Python classes based on abstraction. Abstraction is an integral part of object-oriented programming.

Abstraction is what we call hiding the internal process of the program from the users. Take the example of the computer mouse where we click the left or right button and something respective of it happens or scroll the mouse wheel and a specific task happens. We are unaware of the internal functionality but we do know that clicking this button will do our job.

In abstraction, users are unaware of the internal functionality but are familiar with the purpose of the method. If we take an example of a datetime module, we do know that running the datetime.now() function will return the current date and time but are unaware of how this happens.

ABC in Python

Python is not a fully object-oriented programming language but it supports the features like abstract classes and abstraction. We cannot create abstract classes directly in Python, so Python provides a module called abc that provides the infrastructure for defining the base of Abstract Base Classes(ABC).

What are abstract base classes? They provide a blueprint for concrete classes. They are just defined but not implemented rather they require subclasses for implementation.

Defining ABC

Let's understand with an example how we can define an abstract class with an abstract method inside it.

from abc import ABC, abstractmethod

class Friend(ABC):

    @abstractmethod
    def role(self):
        pass

The class Friend derived from the ABC class from the abc module that makes it an abstract class and then within the class, a decorator @abstractmethod is defined to indicate that the function role is an abstract method.

abc module has another class ABCMeta which is used to create abstract classes.

from abc import ABCMeta, abstractmethod

class Friend(metaclass=ABCMeta):

    @abstractmethod
    def role(self):
        pass

ABC in action

Now we'll see how to make an abstract class and abstract method and then implement it inside the concrete classes through inheritance.

from abc import ABC, abstractmethod


# Defining abstract class
class Friends(ABC):
    """abstract method decorator to indicate that the
    method right below is an abstract method."""

    @abstractmethod
    def role(self):
        pass


# Concrete derived class inheriting from abstract class
class Sachin(Friends):
    # Implementing abstract method
    def role(self):
        print('Python Developer')


# Concrete derived class inheriting from abstract class
class Rishu(Friends):
    # Implementing abstract method
    def role(self):
        print('C++ Developer')


# Concrete derived class inheriting from abstract class
class Yashwant(Friends):
    # Implementing abstract method
    def role(self):
        print('C++ Developer')


# Instantiating concrete derived class
roles = Sachin()
roles.role()
# Instantiating concrete derived class
roles = Rishu()
roles.role()
# Instantiating concrete derived class
roles = Yashwant()
roles.role()

In the above code, we created an abstract class called Friends and defined the abstract method role within the class using the @abstractmethod decorator.

Then we created three concrete derived classes, Sachin, Rishu, and Yashwant, that inherits from the class Friends and implemented the abstract method role within them.

Then we instantiated the derived classes and called the role using the instance of the classes to display the result.

Python Developer
C++ Developer
C++ Developer

As we discussed earlier, abstract classes provide a blueprint for implementing methods into concrete subclasses.

from abc import ABC, abstractmethod

class Details(ABC):
    @abstractmethod
    def getname(self):
        return self.name

    @abstractmethod
    def getrole(self):
        return self.role

    @abstractmethod
    def gethobby(self):
        return self.hobby


class Sachin(Details):
    def __init__(self, name="Sachin"):
        self.name = name
        self.role = "Python Dev"
        self.hobby = "Fuseball spielen"

    def getname(self):
        return self.name

    def getrole(self):
        return self.role

    def gethobby(self):
        return self.hobby


detail = Sachin()
print(detail.getname())
print(detail.getrole())
print(detail.gethobby())

In the above code, we created a blueprint for the class Details. Then we created a class called Sachin that inherits from Details, and we implemented the methods according to the blueprint.

Then we instantiated the class Sachin and then printed the values of getname, getrole and gethobby.

Sachin
Python Dev
Fuseball spielen

What if we create a class that doesn't follow the abstract class blueprint?

from abc import ABC, abstractmethod

class Details(ABC):
    @abstractmethod
    def getname(self):
        return self.name

    @abstractmethod
    def getrole(self):
        return self.role

    @abstractmethod
    def gethobby(self):
        return self.hobby


class Sachin(Details):
    def __init__(self, name="Sachin"):
        self.name = name
        self.role = "Python Dev"
        self.hobby = "Fuseball spielen"

    def getname(self):
        return self.name

    def getrole(self):
        return self.role


detail = Sachin()
print(detail.getname())
print(detail.getrole())

Python will raise an error upon executing the above code because the class Sachin doesn't follow the class Details blueprint.

Traceback (most recent call last):
  ....
TypeError: Can't instantiate abstract class Sachin with abstract method gethobby

Use of ABC

As we saw in the above example that if a derived class doesn't follow the blueprint of the abstract class, then the error will be raised.

That's where ABC(Abstract Base Class) plays an important role in making sure that the subclasses must follow that blueprint. Thus we can say that the subclasses inherited from the abstract class must follow the same structure and implements the abstract methods.

Concrete methods inside ABC

We can also define concrete methods within the abstract classes. The concrete method is the normal method that has a complete definition.

from abc import ABC, abstractmethod

# Abstract class
class Demo(ABC):
    # Defining a concrete method
    def concrete_method(self):
        print("Calling concrete method")

    @abstractmethod
    def data(self):
        pass

# Derived class
class Test(Demo):

    def data(self):
        pass

# Instantiating the class
data = Test()
# Calling the concrete method
data.concrete_method()

In the above code, concrete_method is a concrete method defined within the abstract class and the method was invoked using the instance of the class Test.

Calling concrete method

Abstract class instantiation

An abstract class can only be defined but cannot be instantiated because of the fact that they are not a concrete class. Python doesn't allow creating objects for abstract classes because there is no actual implementation to invoke rather they require subclasses for implementation.

from abc import ABC, abstractmethod

class Details(ABC):
    @abstractmethod
    def getname(self):
        return self.name

    @abstractmethod
    def getrole(self):
        return self.role

class Sachin(Details):
    def __init__(self, name="Sachin"):
        self.name = name
        self.role = "Python Dev"

    def getname(self):
        return self.name

    def getrole(self):
        return self.role

# Instantiating the abstract class
abstract_class = Details()

Output

Traceback (most recent call last):
  ....
TypeError: Can't instantiate abstract class Details with abstract methods getname, getrole

We got the error stating that we cannot instantiate the abstract class Details with abstract methods called getname and getrole.

Abstract property

Just as the abc module allows us to define abstract methods using the @abstractmethod decorator, it also allows us to define abstract properties using the @abstractproperty decorator.

from abc import ABC, abstractproperty

# Abstract class
class Hero(ABC):

    @abstractproperty
    def hero_name(self):
        return self.hname

    @abstractproperty
    def reel_name(self):
        return self.rname

# Derived class
class RDJ(Hero):

    def __init__(self):
        self.hname = "IronMan"
        self.rname = "Tony Stark"

    @property
    def hero_name(self):
        return self.hname
    @property
    def reel_name(self):
        return self.rname

data = RDJ()
print(f'The hero name is: {data.hero_name}')
print(f'The reel name is: {data.reel_name}')

We created an abstract class Hero and defined two abstract properties called hero_name and reel_name using @abstractproperty. Then, within the derived class RDJ, we used the @property decorator to implement them that will make them a getter method.

Then we instantiated the class RDJ and used the class instance to access the values of hero_name and reel_name.

The hero name is: IronMan
The reel name is: Tony Stark

If we had not placed the @property decorator inside the class RDJ, we would have had to call the hero_name and reel_name.

from abc import ABC, abstractproperty

# Abstract class
class Hero(ABC):
    @abstractproperty
    def hero_name(self):
        return self.hname

    @abstractproperty
    def reel_name(self):
        return self.rname

# Derived class
class RDJ(Hero):

    def __init__(self):
        self.hname = "IronMan"
        self.rname = "Tony Stark"

    def hero_name(self):
        return self.hname

    def reel_name(self):
        return self.rname

data = RDJ()
print(f'The hero name is: {data.hero_name()}')
print(f'The reel name is: {data.reel_name()}')

----------
The hero name is: IronMan
The reel name is: Tony Stark

Note: abstractproperty is a deprecated class, instead we can use @property with @abstractmethod to define an abstract property. Pycharm IDE gives a warning upon using the abstractproperty class.

The above code will look like the following if we modify it.

# Abstract class
class Hero(ABC):
    @property
    @abstractmethod
    def hero_name(self):
        return self.hname

    @property
    @abstractmethod
    def reel_name(self):
        return self.rname

Just apply the modifications as shown in the above code within the abstract class and run the code. The code will run without any error as earlier.

Conclusion

We've covered the fundamentals of abstract classes, abstract methods, and abstract properties in this article. Python has an abc module that provides infrastructure for defining abstract base classes.

The ABC class from the abc module can be used to create an abstract class. ABC is a helper class that has ABCMeta as its metaclass, and we can also define abstract classes by passing the metaclass keyword and using ABCMeta. The only difference between the two classes is that ABCMeta has additional functionality.

After creating the abstract class, we used the @abstractmethod and (@property with @abstractmethod) decorators to define the abstract methods and abstract properties within the class.

To understand the theory, we've coded the examples alongside the explanation.

🏆Other articles you might be interested in if you liked this one

✅What are class inheritance and different types of inheritance in Python?

✅Learn the use cases of the super() function in Python classes.

✅How underscores modify accessing the attributes and methods in Python.

✅What are init and call in Python.

✅Implement a custom deep learning model into the Flask app for image recognition.

✅Train a custom deep learning model using the transfer learning technique.

✅How to augment data using the existing data in Python.

That's all for now

Keep Coding✌✌