diff --git a/google/api_core/path_template.py b/google/api_core/path_template.py index bb549356..f202d40f 100644 --- a/google/api_core/path_template.py +++ b/google/api_core/path_template.py @@ -104,7 +104,7 @@ def _expand_variable_match(positional_vars, named_vars, match): def expand(tmpl, *args, **kwargs): """Expand a path template with the given variables. - ..code-block:: python + .. code-block:: python >>> expand('users/*/messages/*', 'me', '123') users/me/messages/123 diff --git a/noxfile.py b/noxfile.py index 10a92efb..25609920 100644 --- a/noxfile.py +++ b/noxfile.py @@ -159,13 +159,13 @@ def cover(session): session.run("coverage", "erase") -@nox.session(python="3.7") +@nox.session(python="3.8") def docs(session): """Build the docs for this library.""" session.install(".", "grpcio >= 1.8.2", "grpcio-gcp >= 0.2.2") session.install("-e", ".") - session.install("sphinx < 3.0", "alabaster", "recommonmark") + session.install("sphinx==4.0.1", "alabaster", "recommonmark") shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True) session.run( @@ -182,14 +182,14 @@ def docs(session): ) -@nox.session(python="3.7") +@nox.session(python="3.8") def docfx(session): """Build the docfx yaml files for this library.""" session.install("-e", ".") - # sphinx-docfx-yaml supports up to sphinx version 1.5.5. - # https://github.com/docascode/sphinx-docfx-yaml/issues/97 - session.install("sphinx==1.5.5", "alabaster", "recommonmark", "sphinx-docfx-yaml") + session.install( + "sphinx==4.0.1", "alabaster", "recommonmark", "gcp-sphinx-docfx-yaml" + ) shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True) session.run(