55import os
66import re
77import sys
8- from contextlib import contextmanager
9- from importlib .metadata import version as pkgversion
108from pathlib import Path
119from typing import TYPE_CHECKING
1210
1311from duty import duty , tools
1412
1513if TYPE_CHECKING :
16- from collections .abc import Iterator
17-
1814 from duty .context import Context
1915
2016
@@ -36,18 +32,6 @@ def pyprefix(title: str) -> str:
3632 return title
3733
3834
39- @contextmanager
40- def material_insiders () -> Iterator [bool ]:
41- if "+insiders" in pkgversion ("mkdocs-material" ):
42- os .environ ["MATERIAL_INSIDERS" ] = "true"
43- try :
44- yield True
45- finally :
46- os .environ .pop ("MATERIAL_INSIDERS" )
47- else :
48- yield False
49-
50-
5135def _get_changelog_version () -> str :
5236 changelog_version_re = re .compile (r"^## \[(\d+\.\d+\.\d+)\].*$" )
5337 with Path (__file__ ).parent .joinpath ("CHANGELOG.md" ).open ("r" , encoding = "utf8" ) as file :
@@ -88,11 +72,10 @@ def check_docs(ctx: Context) -> None:
8872 """Check if the documentation builds correctly."""
8973 Path ("htmlcov" ).mkdir (parents = True , exist_ok = True )
9074 Path ("htmlcov/index.html" ).touch (exist_ok = True )
91- with material_insiders ():
92- ctx .run (
93- tools .mkdocs .build (strict = True , verbose = True ),
94- title = pyprefix ("Building documentation" ),
95- )
75+ ctx .run (
76+ tools .mkdocs .build (strict = True , verbose = True ),
77+ title = pyprefix ("Building documentation" ),
78+ )
9679
9780
9881@duty (nofail = PY_VERSION == PY_DEV )
@@ -126,22 +109,18 @@ def docs(ctx: Context, *cli_args: str, host: str = "127.0.0.1", port: int = 8000
126109 host: The host to serve the docs from.
127110 port: The port to serve the docs on.
128111 """
129- with material_insiders ():
130- ctx .run (
131- tools .mkdocs .serve (dev_addr = f"{ host } :{ port } " ).add_args (* cli_args ),
132- title = "Serving documentation" ,
133- capture = False ,
134- )
112+ ctx .run (
113+ tools .mkdocs .serve (dev_addr = f"{ host } :{ port } " ).add_args (* cli_args ),
114+ title = "Serving documentation" ,
115+ capture = False ,
116+ )
135117
136118
137119@duty (skip_if = sys .version_info < (3 , 13 ), skip_reason = pyprefix ("Skipped: docs require modern generics syntax" ))
138120def docs_deploy (ctx : Context ) -> None :
139121 """Deploy the documentation to GitHub pages."""
140122 os .environ ["DEPLOY" ] = "true"
141- with material_insiders () as insiders :
142- if not insiders :
143- ctx .run (lambda : False , title = "Not deploying docs without Material for MkDocs Insiders!" )
144- ctx .run (tools .mkdocs .gh_deploy (force = True ), title = "Deploying documentation" )
123+ ctx .run (tools .mkdocs .gh_deploy (force = True ), title = "Deploying documentation" )
145124
146125
147126@duty
0 commit comments