The **pkginfo** module
======================

.. module:: draxoft.tools.pkginfo

.. testsetup::
   
   from draxoft.tools.pkginfo import *

.. class:: PackageMetadata
   
   Base classes: :class:`dict`.
   
   .. classmethod:: parse_setup(source) -> PackageMetadata
                    parse_setup_file(path) -> PackageMetadata

.. function:: parse_setup(source) -> PackageMetadata
              parse_setup_file(path) -> PackageMetadata


.. testcode::
   
   setup = '''
   from distutils.core import setup
   setup(name='ParrotTester',
         version='0.1',
         author='John Cleese',
         author_email='jcleese@python.org',
         provides=['ParrotTester'],
         packages=['ParrotTester']
        )
   '''

.. doctest::
   
   >>> from draxoft.tools import pkginfo
   >>> metadata = pkginfo.parse_setup(setup)
   >>> print metadata['author']
   John Cleese
   >>> for pkg in metadata['provides']:
   ...     print pkg
   ...
   ParrotTester
   >>> type(metadata)
   <class 'draxoft.tools.pkginfo.PackageMetadata'>