trollius2asyncio

A tool based on lib2to3 for converting code using trollius to use asyncio. After installation, run trollius2asyncio. It works in the same way as 2to3.

For example, it will transform this:

import trollius
from trollius import From, Return

@trollius.coroutine
def double_future(future):
    value = yield From(future)
    raise Return(2 * value)

into

import asyncio


@asyncio.coroutine
def double_future(future):
    value = yield from(future)
    return (2 * value)

Usage

After installation, run trollius2asyncio as you would 2to3. It takes the same command-line arguments, including -h for help.

Limitations

It is not perfect, and can possibly be improved in future. In particular, it recognises From, trollius.From, Return and trollius.Return, without taking the imports into consideration. Thus, importing trollius as a different name will confuse it, and from tornado.gen import Return will cause the returns from Tornado to also be rewritten (which should still be a legal transformation).

The resulting code is not necessarily well-styled e.g., the extra blank line and extra parentheses in the example above. These are limitations of lib2to3 and won't be easy to fix without risking breaking code in corner cases.