(session: nox.Session)
| 121 | |
| 122 | @nox.session |
| 123 | def docs(session: nox.Session) -> None: |
| 124 | install(session, ".[ssh]") |
| 125 | install( |
| 126 | session, |
| 127 | "--group", |
| 128 | "docs", |
| 129 | "--group", |
| 130 | "docstest", |
| 131 | "--group", |
| 132 | "sdist", |
| 133 | ) |
| 134 | |
| 135 | temp_dir = session.create_tmp() |
| 136 | session.run( |
| 137 | "sphinx-build", |
| 138 | "-T", |
| 139 | "-W", |
| 140 | "-b", |
| 141 | "html", |
| 142 | "-d", |
| 143 | f"{temp_dir}/doctrees", |
| 144 | "docs", |
| 145 | "docs/_build/html", |
| 146 | ) |
| 147 | session.run( |
| 148 | "sphinx-build", |
| 149 | "-T", |
| 150 | "-W", |
| 151 | "-b", |
| 152 | "latex", |
| 153 | "-d", |
| 154 | f"{temp_dir}/doctrees", |
| 155 | "docs", |
| 156 | "docs/_build/latex", |
| 157 | ) |
| 158 | |
| 159 | session.run( |
| 160 | "sphinx-build", |
| 161 | "-T", |
| 162 | "-W", |
| 163 | "-b", |
| 164 | "doctest", |
| 165 | "-d", |
| 166 | f"{temp_dir}/doctrees", |
| 167 | "docs", |
| 168 | "docs/_build/html", |
| 169 | ) |
| 170 | session.run( |
| 171 | "sphinx-build", |
| 172 | "-T", |
| 173 | "-W", |
| 174 | "-b", |
| 175 | "spelling", |
| 176 | "docs", |
| 177 | "docs/_build/html", |
| 178 | ) |
| 179 | |
| 180 | session.run( |