========
qualname

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

__ https://www.python.org/dev/peps/pep-3155/

.. image:: https://travis-ci.org/wbolster/qualname.svg?branch=master
:target: https://travis-ci.org/wbolster/qualname

.. image:: https://pypip.in/download/qualname/badge.svg
:target: https://pypi.python.org/pypi/qualname/
:alt: Downloads

.. image:: https://pypip.in/version/qualname/badge.svg
:target: https://pypi.python.org/pypi/qualname/
:alt: Latest Version

.. image:: https://pypip.in/py_versions/qualname/badge.svg
:target: https://pypi.python.org/pypi/qualname/
:alt: Supported Python versions

.. image:: https://pypip.in/status/qualname/badge.svg
:target: https://pypi.python.org/pypi/qualname/
:alt: Development Status

.. image:: https://pypip.in/license/qualname/badge.svg
:target: https://pypi.python.org/pypi/qualname/
:alt: License

Installation

::

pip install qualname

Usage

Assume these definitions:

::

class C:
def f():
pass

  class D:
      def g():
          pass

In Python 3.3+, classes have a __qualname__ property::

C.qualname
'C'

C.f.qualname
'C.f'

C.D.qualname
'C.D'

C.D.g.qualname
'C.D.g'

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

from qualname import qualname

qualname(C)
'C'

qualname(C.f)
'C.f'

qualname(C.D)
'C.D'

qualname(C.D.g)
'C.D.g'

Victory!

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.

License

BSD.

Feedback? Issues?

https://github.com/wbolster/qualname

Package profile

qualname

Releases

Release table

PyPI Downloads

Dependencies

Details

Project URLs

Dependencies

Package description