common.py

Go to the documentation of this file.

"""
    sphinxcontrib.autohttp.common
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
    The common functions for web framework reflection.
 
    :copyright: Copyright 2011 by Hong Minhee
    :license: BSD, see LICENSE for details.
 
"""
import six
from six.moves import builtins
from six.moves import reduce
 
def import_object(import_name):
    module_name, expr = import_name.split(':', 1)
    mod = __import__(module_name)
    mod = reduce(getattr, module_name.split('.')[1:], mod)
    globals = builtins
    if not isinstance(globals, dict):
        globals = globals.__dict__
    return eval(expr, globals, mod.__dict__)
 
 
def http_directive(method, path, content):
    method = method.lower().strip()
    if isinstance(content, six.string_types):
        content = content.splitlines()
    yield ''
    paths = [path] if isinstance(path, six.string_types) else path
    for path in paths:
        yield '.. http:{method}:: {path}'.format(**locals())
    yield ''
    for line in content:
        yield '   ' + line
    yield ''