Provide "python -m trio" to drop into trio based REPL

[decentral1se]

Just like "python -m asyncio" so we can use things like "await foo" straight out of the box.

[dhirschfeld]

In case you're using IPython you can use the %autoawait trio magic command to await things at the interactive prompt - it works great and is very cool!

...doesn't mean that python -m trio wouldn't also be useful for those who don't want to drag in all the IPython deps.

[mikenerone]

In case you're using IPython you can use the %autoawait trio magic command to await things at the interactive prompt - it works great and is very cool!

Related tip: Adding this to your IPython profile will automatically turn on Trio mode if it's installed in your current environment. If not, it will try applying nest_asyncio (if it's installed) in case you want to do asyncio stuff without breaking IPython. It pretty much means you don't have to think about setting up your async IPython mode anymore.

~/.ipython/profile_default/startup/10-async.py

msgs = [""]

try:
    import trio
    get_ipython().run_line_magic("autoawait", "trio")
    msgs.append("Trio-mode %autoawait")
except ImportError:
    try:
        import nest_asyncio
        nest_asyncio.apply()
        msgs.append("(nest-asyncio patch applied)")
    except ImportError:
        pass

print("\n".join(msgs))

[jakkdl]

that sounds like something super useful that should be added to the docs somewhere

[mikenerone]

that sounds like something super useful that should be added to the docs somewhere

Happy to add it - I think it would make sense as a paragraph or sidebar in the Interactive Debugging section that's already part of #2972. If we think that's going to land, I can add a commit to that branch. wdyt?

Also, would you agree that I should remove the nest-asyncio support for the purpose of Trio docs?

[clint-lawrence]

@mikenerone I saw you comment here and have added a reference to IPython in the docs on #2972

trio/docs/source/reference-core.rst

Line 1951 in 2551d04

If you are an IPython user, you can use IPython's `autoawait

[mikenerone]

@mikenerone I saw you comment here and have added a reference to IPython in the docs on #2972

Awesome, thanks much!