@@ -430,87 +430,6 @@ def docfx(session):
430430 session .skip ("docfx builds are not yet supported" )
431431
432432
433- # @nox.session(python="3.10")
434- # def docs(session):
435- # """Build the docs for this library."""
436-
437- # session.install("-e", ".")
438- # session.install(
439- # # We need to pin to specific versions of the `sphinxcontrib-*` packages
440- # # which still support sphinx 4.x.
441- # # See https://github.com/googleapis/sphinx-docfx-yaml/issues/344
442- # # and https://github.com/googleapis/sphinx-docfx-yaml/issues/345.
443- # "sphinxcontrib-applehelp==1.0.4",
444- # "sphinxcontrib-devhelp==1.0.2",
445- # "sphinxcontrib-htmlhelp==2.0.1",
446- # "sphinxcontrib-qthelp==1.0.3",
447- # "sphinxcontrib-serializinghtml==1.1.5",
448- # "sphinx==4.5.0",
449- # "alabaster",
450- # "recommonmark",
451- # )
452-
453- # shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
454- # session.run(
455- # "sphinx-build",
456- # "-W", # warnings as errors
457- # "-T", # show full traceback on exception
458- # "-N", # no colors
459- # "-b",
460- # "html",
461- # "-d",
462- # os.path.join("docs", "_build", "doctrees", ""),
463- # os.path.join("docs", ""),
464- # os.path.join("docs", "_build", "html", ""),
465- # )
466-
467-
468- # @nox.session(python="3.10")
469- # def docfx(session):
470- # """Build the docfx yaml files for this library."""
471-
472- # session.install("-e", ".")
473- # session.install(
474- # # We need to pin to specific versions of the `sphinxcontrib-*` packages
475- # # which still support sphinx 4.x.
476- # # See https://github.com/googleapis/sphinx-docfx-yaml/issues/344
477- # # and https://github.com/googleapis/sphinx-docfx-yaml/issues/345.
478- # "sphinxcontrib-applehelp==1.0.4",
479- # "sphinxcontrib-devhelp==1.0.2",
480- # "sphinxcontrib-htmlhelp==2.0.1",
481- # "sphinxcontrib-qthelp==1.0.3",
482- # "sphinxcontrib-serializinghtml==1.1.5",
483- # "gcp-sphinx-docfx-yaml",
484- # "alabaster",
485- # "recommonmark",
486- # )
487-
488- # shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True)
489- # session.run(
490- # "sphinx-build",
491- # "-T", # show full traceback on exception
492- # "-N", # no colors
493- # "-D",
494- # (
495- # "extensions=sphinx.ext.autodoc,"
496- # "sphinx.ext.autosummary,"
497- # "docfx_yaml.extension,"
498- # "sphinx.ext.intersphinx,"
499- # "sphinx.ext.coverage,"
500- # "sphinx.ext.napoleon,"
501- # "sphinx.ext.todo,"
502- # "sphinx.ext.viewcode,"
503- # "recommonmark"
504- # ),
505- # "-b",
506- # "html",
507- # "-d",
508- # os.path.join("docs", "_build", "doctrees", ""),
509- # os.path.join("docs", ""),
510- # os.path.join("docs", "_build", "html", ""),
511- # )
512-
513-
514433@nox .session
515434def format (session : nox .sessions .Session ) -> None :
516435 session .install (BLACK_VERSION , ISORT_VERSION )
0 commit comments