Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/asyncio-docs/asyncio-doc

Asyncio documentation
https://github.com/asyncio-docs/asyncio-doc

Last synced: 24 days ago
JSON representation

Asyncio documentation

Awesome Lists containing this project

README

        

Asyncio documentation
=====================

* Online doc: https://asyncio.readthedocs.io/
* GitHub: https://github.com/asyncio-docs/asyncio-doc
* AsyncIO documentation is written with `Sphinx `_.

Notes to writers
================

Tutorials should use Python 3.5 ``async`` and ``await`` keywords rather than
``@asyncio.coroutine`` and ``yield from``.

Ideas
=====

* Advanced section:

- protocols and transports: as least point to good implementations
- explain how to *test* asyncio applications. `Twisted documentation example
`_

How to install Sphinx
=====================

Firstly, you need to install the Sphinx tool using the Linux package manager
like apt-get or dnf for example.

But if you want to install it via `pip `_ , you
can create a virtual environment with the `venv` module of Python 3 ::

python3 -m venv env
source env/bin/activate
pip install -r requirements.txt

Once you have installed Sphinx, you can build the documentation.

How to build the documentation
==============================

Install Sphinx using the Linux package manager like apt-get or dnf for example.
Then build the documentation using::

make html

See also
========

* https://docs.python.org/3/library/asyncio.html
* http://krondo.com/an-introduction-to-asynchronous-programming-and-twisted/
* https://curio.readthedocs.io/en/latest/tutorial.html

License
=======

All of the code examples in this site are licensed under the `Creative Commons Zero
(CC0) `_ license.

All other content of this site is licensed under the `Creative Commons Attribution
Share Alike 4.0 (CC-BY-SA) `_ license.