Metadata-Version: 1.1
Name: qualname
Version: 0.1.0
Summary: __qualname__ emulation for older Python versions
Home-page: https://github.com/wbolster/qualname
Author: Wouter Bolsterlee
Author-email: uws@xs4all.nl
License: BSD
Description: ========
        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 name for it. 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
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
