Creates a coroutine function based on the composition of the passed
    coroutine functions.

    Each function consumes the yielded result of the coroutine that follows.

    Composing coroutine functions f(), g(), and h() would produce
    the result of f(g(h())).

    Arguments:
        *coros (coroutinefunction): variadic coroutine functions to compose.

    Raises:
        RuntimeError: if cannot execute a coroutine function.

    Returns:
        coroutinefunction

    Usage::

        async def sum_1(num):
            return num + 1

        async def mul_2(num):
            return num * 2

        coro = paco.compose(sum_1, mul_2, sum_1)
        await coro(2)
        # => 7

def compose(*coros):
    """
    Creates a coroutine function based on the composition of the passed
    coroutine functions.

    Each function consumes the yielded result of the coroutine that follows.

    Composing coroutine functions f(), g(), and h() would produce
    the result of f(g(h())).

    Arguments:
        *coros (coroutinefunction): variadic coroutine functions to compose.

    Raises:
        RuntimeError: if cannot execute a coroutine function.

    Returns:
        coroutinefunction

    Usage::

        async def sum_1(num):
            return num + 1

        async def mul_2(num):
            return num * 2

        coro = paco.compose(sum_1, mul_2, sum_1)
        await coro(2)
        # => 7

    """
    # Make list to inherit built-in type methods
    coros = list(coros)

    @asyncio.coroutine
    def reducer(acc, coro):
        return (yield from coro(acc))

    @asyncio.coroutine
    def wrapper(acc):
        return (yield from reduce(reducer, coros,
                                  initializer=acc, right=True))

    return wrapper