skip to navigation
skip to content

qualname 0.1.0

__qualname__ emulation for older Python versions

Python module to emulate the __qualname__ attribute for classes and methods (Python 3.3+) in older Python versions. See PEP 3155 for details.


pip install qualname


Assume these definitions:

class C:
    def f():

    class D:
        def g():

In Python 3.3+, classes have a __qualname__ property:

>>> C.__qualname__
>>> C.f.__qualname__
>>> C.D.__qualname__
>>> C.D.g.__qualname__

Unfortunately, Python 2 and early Python 3 versions do not have an (obvious) equivalent. qualname to the rescue:

from qualname import qualname

>>> qualname(C)
>>> qualname(C.f)
>>> qualname(C.D)
>>> qualname(C.D.g)


How does it work?

Glad you ask.

This module uses source code inspection to figure out how (nested) classes and functions are defined in order to determine the qualified names for them. That means parsing the source file, and traversing the AST (abstract syntax tree). This sounds very hacky, and it is, but the Python interpreter itself does not have the necessary information, so this justifies extreme measures.

Now that you know how it works, you’ll also understand that this module only works when the source file is available. Fortunately this is the case in most circumstances.



File Type Py Version Uploaded on Size
qualname-0.1.0.tar.gz (md5) Source 2015-04-11 3KB