Metadata-Version: 1.1
Name: aio.core
Version: 0.0.5
Summary: Aio core utils
Home-page: http://github.com/phlax/aio.core
Author: Ryan Northey
Author-email: ryan@3ca.org.uk
License: GPL
Description: Detailed documentation
        **********************
        
        
        aio.core
        ========
        
        Core definitions and utilities for the aio_ asyncio framework
        
        .. _aio: https://github.com/phlax/aio
        
        
        Installation
        ------------
        
        Install with:
        
        .. code:: bash
        
        	  pip install aio.core
        
        
        aio.core.exceptions usage
        =========================
        
        
        MissingConfiguration
        --------------------
        
        >>> from configparser import ConfigParser
        >>> from aio.core.exceptions import MissingConfiguration
        
        >>> def get_configuration(conf, section, option):
        ...     try:
        ...         conf[section][option]
        ...     except KeyError:
        ...         raise MissingConfiguration(
        ...             "Configuration option is missing: %s:%s" % (
        ...                 section, option))
          
        >>> try:
        ...     get_configuration(ConfigParser(), "foo", "bar")
        ... except MissingConfiguration as e:
        ...     print(e)
        Configuration option is missing: foo:bar
        
        
        BadConfiguration
        --------------------  
          
        >>> from aio.core.exceptions import BadConfiguration  
        
        >>> def get_configuration(conf, section, option, option_type):
        ...     option_value = conf[section][option]
        ...     try:
        ...         option_type(option_value)
        ...     except ValueError:
        ...         raise BadConfiguration(
        ...             'Configuration is bad: %s:%s expected type %s, but got "%s"' % (
        ...                 section, option, option_type.__name__, option_value))
        
        >>> config = ConfigParser()
        >>> config.read_dict({"foo": {"bar": "baz"}})
        
        >>> try:
        ...     get_configuration(config, "foo", "bar", int)
        ... except BadConfiguration as e:
        ...     print(e)
        Configuration is bad: foo:bar expected type int, but got "baz"
        
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3.4
Classifier: Topic :: Software Development :: Libraries :: Python Modules
