472,353 Members | 1,682 Online
Bytes | Software Development & Data Engineering Community
+ Post

Home Posts Topics Members FAQ

Join Bytes to post your question to a community of 472,353 software developers and data experts.

module to implement Abstract Base Class

I had a need recently to check if my subclasses properly implemented
the desired interface and wished that I could use something like an
abstract base class in python. After reading up on metaclass magic, I
wrote the following module. It is mainly useful as a light weight tool
to help programmers catch mistakes at definition time (e.g., forgetting
to implement a method required by the given interface). This is handy
when unit tests or running the actual program take a while.

Comments and suggestions are welcome.

############### Abstract Base Class Module

This module provides the AbstractBaseClass class and the Abstract
to allow you to define abstract base classes in python. See the
for AbstractBaseClass for instructions.

class _AbstractMetaClass(type):
This is a metaclass designed to act as an AbstractBaseClass.
You should rarely need to use this directly. Inheret from
the class (not metaclass) AbstractBaseClass instead.

Feel free to skip reading this metaclass and go on to the
documentation for AbstractBaseClass.

def __init__(cls, name, bases, dict):
"""Initialize the class if Abstract requirements are met.

If the class is supposed to be abstract or it is concrete and
implements all @Abstract methods, then instantiate it.
Otherwise, an
AssertionError is raised.

Alternatively, if cls.__allow_abstract__ is True, then the
class is instantiated and no checks are done.

if (__debug__ and not getattr(cls,'__allow_abstract__',False)
and not _AbstractMetaClass._IsSupposedToBeAbstract(cls)):
abstractMethods = _AbstractMetaClass._GetAbstractMethods(
for name in abstractMethods:
if ( getattr(getattr(cls,name),'__abstract__',False)):
klasses =
if (len(klasses)==0):
klasses = '(Unknown); all parents are %s.' % (
klasses = str(klasses)
raise AssertionError(
'Class %s must override %s to implement:\n%s.'
% (cls,name,klasses))

super(_AbstractMetaClass,cls).__init__(name,bases, dict)

def __call__(self, *args, **kw):
"""Only allow instantiation if Abstract requirements are met.

If there are methods that are still abstract and
is not set to True, raise an assertion error. Otherwise,
instantiate the class.
if (__debug__):
stillAbstract = [
name for name in
if (getattr(getattr(self,name),'__abstract__',False))]
assert (getattr(self,'__allow_abstract__',False)
or len(stillAbstract) == 0), (
"""Cannot instantiate abstract base class %s
because the follwoing methods are still abstract:\n%s""" %
return type.__call__(self,*args,**kw)

def _IsSupposedToBeAbstract(cls):
"""Return true if cls is supposed to be an abstract class.

A class which is ''supposed to be abstract'' is one which
directly inherits from AbstractBaseClass. Due to metaclass
magic, the easiest way to check this is to look for the
__intended_abstract__ attribute which only AbstractBaseClass
should have.
for parent in cls.__bases__:
if (parent.__dict__.get('__intended_abstract__',False )):
return True

def _GetAbstractMethods(classList,abstractMethods=None ):
"""Returns all abstract methods in a list of classes.

Takes classList which is a list of classes to look through and
optinally takes abstractMethods which is a dict containing
of abstract methods already found.
if (None == abstractMethods):
abstractMethods = {}
for cls in classList:
for name in cls.__dict__:
method = getattr(cls,name)
if (callable(method) and
abstractMethods[name] = True
_AbstractMetaClass._GetAbstractMethods(cls.__bases __,
return abstractMethods.keys()

def _GetParentsRequiring(methodName,cls):
"""Return list of parents that have a method defined as

Arguments are methodName (string representing name of method to
and cls (the class whose parents should be checked).
result = []
for parent in cls.__bases__:
if (getattr(parent,methodName,False) and

getattr(getattr(parent,methodName),'__abstract__', False)):
return result
class AbstractBaseClass(object):
The AbstractBaseClass represents a class that defines some methods
which must be implemented by non-abstract children. To use it, have
class inhereit from AbstractBaseClass and use the @Abstract
on the methods you want to be abstract. You can have many
of abstract base classes inheriting from each other and adding
methods as long as they all inherit from AbstractBaseClass.

If any class which does not DIRECTLY inherit from
AbstractBaseClass, but
does INDIRECTLY inherit from AbstractBaseClass must override all
abstract methods. Otherwise, an AssertionError will be raised when
the offending class is defined.

What if you decide you want to turn of all checking and really do
want to
instantiate an abstract class? Just do klass.__allow_abstract__ =
and klass will no longer enforce the Abstract limitations.

The following is an example of how this pattern can be used:
>>class abstract(AbstractBaseClass): # this will be the AbstractBaseClass
.... @Abstract
.... def foo(self,x): pass # declared abstract even though we def it
>>try: # illustrate what happens when you don't implement @Abstract methods
.... class fails(abstract): # an erroneous implementation of
.... pass # since it doesn't implment foo
.... except AssertionError, e:
.... print e
Class <class '__main__.fails'must override foo to implement:
[<class '__main__.abstract'>].
>>class concrete(abstract): # will be a concrete class implementing abstract
.... def foo(self,x):
.... return x+2

You can even create abstract classes that inherit from
abstract classes to gradually build up abstractions as
shown below:
>>class AbstractCar(AbstractBaseClass):
.... @Abstract
.... def Drive(self): pass
>>class AbstractFastCar(AbstractCar,AbstractBaseClass):# inherit from ABC
.... @Abstract # so that
.... def DriveFast(self): pass # doesn't
worry about
.... # Drive being
>># Note that children of AbstractFastCar which are not abstract, must
# implement both DriveFast as requied by AbstractFastCar as well as
# Drive as required by AbstractCar.
try: # breaks since you don't implement Drive as requiered by AbstractCar
.... class BadCar(AbstractFastCar):
.... def DriveFast(self): pass
.... except AssertionError, e:
.... print str(e)
Class <class '__main__.BadCar'must override Drive to implement:
[<class '__main__.AbstractFastCar'>].
>>try:#breaks since you don't implement DriveFast required by AbstractFastCar
.... class BadCar(AbstractFastCar):
.... def Drive(self): pass
.... except AssertionError, e:
.... print str(e)
Class <class '__main__.BadCar'must override DriveFast to implement:
[<class '__main__.AbstractFastCar'>].
>>class FastCar(AbstractFastCar): # this works since you implement both
.... def Drive(self): pass
.... def DriveFast(self): pass
>>c = FastCar()
If you don't like someone elses abstraction requirements, you
easily turn checking of the @Abstract requirements on and off.
>>class abstract(AbstractBaseClass):
.... @Abstract
.... def foo(self,x): pass
>>abstract.__allow_abstract__ = True # turn of all checking
class fails(abstract): pass # define a class failing requirements
fails().foo('ignore') # call its abstract method
abstract.__allow_abstract__ = False # turn checking back on
.... class bad(abstract): pass
.... except AssertionError, e:
.... print str(e)
Class <class '__main__.bad'must override foo to implement:
[<class '__main__.abstract'>].
You can even use multiple inheritence to combine abstractions:
>>class AbstractCar(AbstractBaseClass):
.... @Abstract
.... def Drive(self): pass
>>class AbstractPlane(AbstractBaseClass):
.... @Abstract
.... def Fly(self): pass
>>class AbstractFlyingCar(AbstractCar,AbstractPlane,Abstra ctBaseClass): pass
.... class Car(AbstractFlyingCar):
.... def Drive(self): pass
.... except AssertionError, e:
.... print 'not right'
not right
>>class FlyingCar(AbstractFlyingCar):
.... def Fly(self): pass
.... def Drive(self): pass
>># You can also define something which inherits both the car and plane
# abstractions without the extra layer of AbstractFlyingCar.
class FlyingCar(AbstractCar,AbstractPlane):
.... def Fly(self): pass
.... def Drive(self): pass

__metaclass__ = _AbstractMetaClass
__intended_abstract__ = True

def Abstract(func):
This is a function decorator that adds the attribute __abstract__
a method function with the attribute having the value True.
See documentation for AbstractBaseClass for how to use this
if (__debug__):
def wrapper(*_args,**_kw):
result = func(*_args,**_kw)
assert getattr(_args[0],'__allow_abstract__',False), (
'Called Abstract method %s. Override %s; %s.' % (
func.__name__,func.__name__,"don't call it directly"))
return result
wrapper.__dict__ = func.__dict__
wrapper.__name__ = func.__name__
wrapper.__doc__ = func.__doc__
wrapper.__abstract__ = True
return wrapper
return func

def _regr_test_children():
Regression test to make sure things work properly with more
complicated inheritence for AbstractBaseClass.
>>class abstract(AbstractBaseClass): # this will be the AbstractBaseClass
.... @Abstract
.... def foo(self,x): # this is declared abstract even though we def
it here
.... raise Exception('You must override this method.')
.... @Abstract
.... def bar(self,x): # this is declared abstract even though we def
it here
.... raise Exception('You must override this method.')
>>class partial: # will be a partial implementation so don't inherit
.... def foo(self,x):
.... return x+2
>>class concrete(partial,abstract): #provides concrete implementation
.... def bar(self,y):
.... return y+3
.... class switch(abstract,partial): # order matters!
.... pass
.... except AssertionError, a:
.... print 'order matters!'
order matters!

def _regr_test_wrapping():
Regression test to make sure that @Abstract decorator works
>>class abstract(AbstractBaseClass):
.... @Abstract
.... def foo(self,x):
.... 'docstring for foo'
>>assert abstract.foo.__doc__ == 'docstring for foo'
assert abstract.foo.__name__ == 'foo'
try: # verify that you can't instantiate an abstract class
.... a = abstract()
.... except AssertionError, e:
.... print str(e)
Cannot instantiate abstract base class <class '__main__.abstract'>
because the follwoing methods are still abstract:
>>try: # even if programmer instantiate abstract, can't call abstract methods
.... a = object.__new__(abstract)
.... a.foo(1)
.... except AssertionError, e:
.... print str(e)
Called Abstract method foo. Override foo; don't call it directly.
>>abstract.__allow_abstract__ = True # turn of all checking
class x(abstract): pass
y = x()
def _test():
import doctest

if __name__ == "__main__":
print 'Test finished.'

Dec 22 '06 #1
0 2685

This thread has been closed and replies have been disabled. Please start a new discussion.

Similar topics

by: Medi Montaseri | last post by:
Hi, I think my problem is indeed "how to implement something like java's final in C++" The long version.... I have an abstract base class...
by: Chris Capel | last post by:
What is the rationale behind the decision not to allow abstract static class members? It doesn't seem like it's a logically contradictory concept,...
by: Chuck Bowling | last post by:
I am using CodeDOM to generate source files. The classes being generated have a const string member. This member is referenced in an abstract base...
by: Jinsong Liu | last post by:
I have a class which serve as a base class. I want to focuses all the classes derived from it implement a interface. Make it a abstract class is...
by: Frank | last post by:
I'm running into trouble and I hope someone can help. I have two assemblies. The first defines a base class and a series of distinct classes...
by: jason | last post by:
In the microsoft starter kit Time Tracker application, the data access layer code consist of three cs files. DataAccessHelper.cs DataAcess.cs...
by: Ben Voigt [C++ MVP] | last post by:
I get C:\Programming\LTM\devtools\UselessJunkForDissassembly\Class1.cs(360,27): error CS0535: 'UselessJunkForDissassembly.InvocableInternals' does...
by: Tony Johansson | last post by:
Hello! Below I have a working program. I have one generic class called Farm<T> with this header definition public class Farm<T:...
by: Rafe | last post by:
Hi, I am in a situation where I feel I am being forced to abandon a clean module structure in favor of a large single module. If anyone can save...
by: Kemmylinns12 | last post by:
Blockchain technology has emerged as a transformative force in the business world, offering unprecedented opportunities for innovation and...
by: Naresh1 | last post by:
What is WebLogic Admin Training? WebLogic Admin Training is a specialized program designed to equip individuals with the skills and knowledge...
by: antdb | last post by:
Ⅰ. Advantage of AntDB: hyper-convergence + streaming processing engine In the overall architecture, a new "hyper-convergence" concept was...
by: AndyPSV | last post by:
HOW CAN I CREATE AN AI with an .executable file that would suck all files in the folder and on my computerHOW CAN I CREATE AN AI with an .executable...
by: WisdomUfot | last post by:
It's an interesting question you've got about how Gmail hides the HTTP referrer when a link in an email is clicked. While I don't have the specific...
by: Matthew3360 | last post by:
Hi, I have been trying to connect to a local host using php curl. But I am finding it hard to do this. I am doing the curl get request from my web...
by: Oralloy | last post by:
Hello Folks, I am trying to hook up a CPU which I designed using SystemC to I/O pins on an FPGA. My problem (spelled failure) is with the...
by: Carina712 | last post by:
Setting background colors for Excel documents can help to improve the visual appeal of the document and make it easier to read and understand....
by: Rahul1995seven | last post by:
Introduction: In the realm of programming languages, Python has emerged as a powerhouse. With its simplicity, versatility, and robustness, Python...

By using Bytes.com and it's services, you agree to our Privacy Policy and Terms of Use.

To disable or enable advertisements and analytics tracking please visit the manage ads & tracking page.