Update sphinx configuration

doc/python/sphinx/_static/custom.css

@@ -0,0 +1,3 @@
+dl.field-list > dt {
+    word-break: keep-all !important;
+}

doc/python/sphinx/conf.py

@@ -16,8 +16,8 @@
 
 import os
 import sys
-PYTHON_FOLDER = os.path.join(os.path.dirname(os.path.realpath(__file__)),
-                             '..', '..', '..', 'src', 'python')
+PYTHON_FOLDER = os.path.join(os.path.dirname(os.path.realpath(__file__)), '..',
+                             '..', '..', 'src', 'python')
 sys.path.insert(0, os.path.join(PYTHON_FOLDER, 'grpcio'))
 sys.path.insert(0, os.path.join(PYTHON_FOLDER, 'grpcio_channelz'))
 sys.path.insert(0, os.path.join(PYTHON_FOLDER, 'grpcio_health_checking'))
@@ -53,6 +53,7 @@ extensions = [
     'sphinx.ext.todo',
     'sphinx.ext.napoleon',
     'sphinx.ext.coverage',
+    'sphinx.ext.autodoc.typehints',
 ]
 
 napoleon_google_docstring = True
@@ -64,7 +65,7 @@ autodoc_default_options = {
 }
 
 autodoc_mock_imports = [
-    'grpc._cython',
+    # 'grpc._cython.cygrpc',
     'grpc_channelz.v1.channelz_pb2',
     'grpc_channelz.v1.channelz_pb2_grpc',
     'grpc_health.v1.health_pb2',
@@ -73,6 +74,8 @@ autodoc_mock_imports = [
     'grpc_reflection.v1alpha.reflection_pb2_grpc',
 ]
 
+autodoc_typehints = 'description'
+
 # -- HTML Configuration -------------------------------------------------
 
 html_theme = 'alabaster'
@@ -84,6 +87,7 @@ html_theme_options = {
     'description': grpc_version.VERSION,
     'show_powered_by': False,
 }
+html_static_path = ["_static"]
 
 # -- Options for manual page output ------------------------------------------
 

doc/python/sphinx/grpc_asyncio.rst

@@ -0,0 +1,107 @@
+gRPC AsyncIO API
+================
+
+.. module:: grpc.experimental.aio
+
+Overview
+--------
+
+gRPC AsyncIO API is a new version of gRPC Python whose architecture is
+tailored to AsyncIO. Underlying, it is using C-Core's callback API, and
+replaced all IO operations with methods provided by the AsyncIO library.
+
+This stack currently is under active development. Feel free to offer
+suggestions by opening issues on `grpc/grpc <https://github.com/grpc/grpc>`_.
+
+The design doc can be found here as `gRFC <https://github.com/grpc/proposal/pull/155>`_.
+
+
+Module Contents
+---------------
+
+
+Create Client
+^^^^^^^^^^^^^
+
+.. autofunction:: insecure_channel
+.. autofunction:: secure_channel
+
+
+Create Server
+^^^^^^^^^^^^^
+
+.. autofunction:: server
+
+
+Channel Object
+^^^^^^^^^^^^^^
+
+.. autoclass:: Channel
+
+
+Server Object
+^^^^^^^^^^^^^
+
+.. autoclass:: Server
+
+
+gRPC Exceptions
+^^^^^^^^^^^^^^^
+
+.. autoexception:: BaseError
+.. autoexception:: AioRpcError
+.. autoexception:: UsageError
+.. autoexception:: AbortError
+.. autoexception:: InternalError
+
+
+Client-Side Context
+^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: Call
+.. autoclass:: UnaryUnaryCall
+.. autoclass:: UnaryStreamCall
+.. autoclass:: StreamUnaryCall
+.. autoclass:: StreamStreamCall
+
+
+Client-Side Interceptor
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: ClientCallDetails
+.. autoclass:: InterceptedUnaryUnaryCall
+.. autoclass:: UnaryUnaryClientInterceptor
+
+.. Service-Side Context
+.. ^^^^^^^^^^^^^^^^^^^^
+
+.. .. autoclass:: ServicerContext
+
+
+.. Service-Side Interceptor
+.. ^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. .. autoclass:: ServerInterceptor
+
+
+Multi-Callable Interfaces
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: UnaryUnaryMultiCallable()
+.. autoclass:: UnaryStreamMultiCallable()
+.. autoclass:: StreamUnaryMultiCallable()
+.. autoclass:: StreamStreamMultiCallable()
+
+
+.. Future Interfaces
+.. ^^^^^^^^^^^^^^^^^
+
+.. .. autoexception:: FutureTimeoutError
+.. .. autoexception:: FutureCancelledError
+.. .. autoclass:: Future
+
+
+.. Compression
+.. ^^^^^^^^^^^
+
+.. .. autoclass:: Compression

doc/python/sphinx/index.rst

@@ -10,6 +10,7 @@ API Reference
    :caption: Contents:
 
    grpc
+   grpc_asyncio
    grpc_channelz
    grpc_health_checking
    grpc_reflection