A high-throughput and memory-efficient inference and serving engine for LLMs
Mirrored from https://github.com/tduncan-lum/Nvidia-Optimization-Stack---VLLM.git
Synced Nov 4, 02:30 UTC
Make docs environment deterministic (#41926)
Signed-off-by: Harry Mellor <19981378+hmellor@users.noreply.github.com>
Harry Mellor committed
May 8, 2026 at 11:13 UTC
630820a59b94eb31e2797349085b5a64113660ce
5 files changed
+209
-42
.pre-commit-config.yaml
+10
@@ -131,6 +131,16 @@ repos:
131
--python-version, "3.12",
132
]
133
files: ^requirements/(common|xpu|test/xpu)\.(in|txt)$
134
+ - id: pip-compile
135
+ alias: pip-compile-docs
136
+ name: pip-compile-docs
137
+ args: [
138
+ requirements/docs.in,
139
+ -o, requirements/docs.txt,
140
+ --python-platform, x86_64-manylinux_2_28,
141
+ --python-version, "3.12",
142
+ ]
143
+ files: ^requirements/docs\.(in|txt)$
144
- repo: local
145
hooks:
146
- id: format-torch-nightly-test
.readthedocs.yaml
-1
@@ -9,7 +9,6 @@ build:
9
python: "3.12"
10
jobs:
11
post_checkout:
12
- # - bash docs/maybe_skip_pr_build.sh
12
- git fetch origin main --unshallow --no-tags --filter=blob:none || true
13
pre_create_environment:
14
- pip install uv
docs/maybe_skip_pr_build.sh
deleted
-24
@@ -1,24 +0,0 @@
1
-#!/bin/bash
2
-# SPDX-License-Identifier: Apache-2.0
3
-# Skip PR builds unless the PR has the "documentation" or "ready" label.
4
-# Used by Read the Docs (see .readthedocs.yaml).
5
-
6
-if [[ "$READTHEDOCS_VERSION_TYPE" != "external" ]]; then
7
- exit 0
8
-fi
9
-
10
-PR_URL="https://api.github.com/repos/vllm-project/vllm/pulls/${READTHEDOCS_VERSION}"
11
-CURL_ARGS=(-s -o /tmp/pr_response.json -w "%{http_code}")
12
-if [[ -n "$GITHUB_TOKEN" ]]; then
13
- CURL_ARGS+=(-H "Authorization: token ${GITHUB_TOKEN}")
14
-fi
15
-HTTP_CODE=$(curl "${CURL_ARGS[@]}" "$PR_URL")
16
-
17
-if [[ "$HTTP_CODE" -ne 200 ]]; then
18
- echo "GitHub API returned HTTP ${HTTP_CODE}, proceeding with build."
19
-elif grep -qE '"name": *"(documentation|ready)"' /tmp/pr_response.json; then
20
- echo "Found required label, proceeding with build."
21
-else
22
- echo "PR #${READTHEDOCS_VERSION} lacks 'documentation' or 'ready' label, cancelling build."
23
- exit 1
24
-fi
requirements/docs.in
new
+17
@@ -0,0 +1,17 @@
1
+mkdocs<2.0.0
2
+mkdocs-api-autonav
3
+mkdocs-material
4
+mkdocstrings-python
5
+mkdocs-gen-files
6
+mkdocs-awesome-nav
7
+mkdocs-glightbox
8
+mkdocs-git-revision-date-localized-plugin
9
+mkdocs-minify-plugin
10
+mkdocs-redirects
11
+regex
12
+ruff
13
+pydantic
14
+
15
+# For generating argparse docs.
16
+# Adding requirements here should only be used as a last resort.
17
+msgspec # Need for multiple inheritance involving msgspec.Struct
\ No newline at end of file
requirements/docs.txt
+182
-17
@@ -1,17 +1,182 @@
1
-mkdocs<2.0.0
2
-mkdocs-api-autonav
3
-mkdocs-material
4
-mkdocstrings-python
5
-mkdocs-gen-files
6
-mkdocs-awesome-nav
7
-mkdocs-glightbox
8
-mkdocs-git-revision-date-localized-plugin
9
-mkdocs-minify-plugin
10
-mkdocs-redirects
11
-regex
12
-ruff
13
-pydantic
14
-
15
-# For generating argparse docs.
16
-# Adding requirements here should only be used as a last resort.
17
-msgspec # Need for multiple inheritance involving msgspec.Struct
\ No newline at end of file
1
+# This file was autogenerated by uv via the following command:
2
+# uv pip compile requirements/docs.in -o requirements/docs.txt --python-platform x86_64-manylinux_2_28 --python-version 3.12
3
+annotated-types==0.7.0
4
+ # via pydantic
5
+babel==2.18.0
6
+ # via
7
+ # mkdocs-git-revision-date-localized-plugin
8
+ # mkdocs-material
9
+backrefs==7.0
10
+ # via mkdocs-material
11
+bracex==2.6
12
+ # via wcmatch
13
+certifi==2026.4.22
14
+ # via requests
15
+charset-normalizer==3.4.7
16
+ # via requests
17
+click==8.3.3
18
+ # via
19
+ # mkdocs
20
+ # properdocs
21
+colorama==0.4.6
22
+ # via mkdocs-material
23
+csscompressor==0.9.5
24
+ # via mkdocs-minify-plugin
25
+ghp-import==2.1.0
26
+ # via
27
+ # mkdocs
28
+ # properdocs
29
+gitdb==4.0.12
30
+ # via gitpython
31
+gitpython==3.1.50
32
+ # via mkdocs-git-revision-date-localized-plugin
33
+griffelib==2.0.2
34
+ # via mkdocstrings-python
35
+htmlmin2==0.1.13
36
+ # via mkdocs-minify-plugin
37
+idna==3.13
38
+ # via requests
39
+jinja2==3.1.6
40
+ # via
41
+ # mkdocs
42
+ # mkdocs-material
43
+ # mkdocstrings
44
+ # properdocs
45
+jsmin==3.0.1
46
+ # via mkdocs-minify-plugin
47
+markdown==3.10.2
48
+ # via
49
+ # mkdocs
50
+ # mkdocs-autorefs
51
+ # mkdocs-material
52
+ # mkdocstrings
53
+ # properdocs
54
+ # pymdown-extensions
55
+markupsafe==3.0.3
56
+ # via
57
+ # jinja2
58
+ # mkdocs
59
+ # mkdocs-autorefs
60
+ # mkdocstrings
61
+ # properdocs
62
+mergedeep==1.3.4
63
+ # via
64
+ # mkdocs
65
+ # mkdocs-get-deps
66
+mkdocs==1.6.1
67
+ # via
68
+ # -r requirements/docs.in
69
+ # mkdocs-api-autonav
70
+ # mkdocs-autorefs
71
+ # mkdocs-awesome-nav
72
+ # mkdocs-gen-files
73
+ # mkdocs-git-revision-date-localized-plugin
74
+ # mkdocs-material
75
+ # mkdocs-minify-plugin
76
+ # mkdocs-redirects
77
+ # mkdocstrings
78
+mkdocs-api-autonav==0.4.0
79
+ # via -r requirements/docs.in
80
+mkdocs-autorefs==1.4.4
81
+ # via
82
+ # mkdocstrings
83
+ # mkdocstrings-python
84
+mkdocs-awesome-nav==3.3.0
85
+ # via -r requirements/docs.in
86
+mkdocs-gen-files==0.6.1
87
+ # via -r requirements/docs.in
88
+mkdocs-get-deps==0.2.2
89
+ # via mkdocs
90
+mkdocs-git-revision-date-localized-plugin==1.5.1
91
+ # via -r requirements/docs.in
92
+mkdocs-glightbox==0.5.2
93
+ # via -r requirements/docs.in
94
+mkdocs-material==9.7.6
95
+ # via -r requirements/docs.in
96
+mkdocs-material-extensions==1.3.1
97
+ # via mkdocs-material
98
+mkdocs-minify-plugin==0.8.0
99
+ # via -r requirements/docs.in
100
+mkdocs-redirects==1.2.3
101
+ # via -r requirements/docs.in
102
+mkdocstrings==1.0.4
103
+ # via mkdocstrings-python
104
+mkdocstrings-python==2.0.3
105
+ # via
106
+ # -r requirements/docs.in
107
+ # mkdocs-api-autonav
108
+msgspec==0.21.1
109
+ # via -r requirements/docs.in
110
+natsort==8.4.0
111
+ # via mkdocs-awesome-nav
112
+packaging==26.2
113
+ # via
114
+ # mkdocs
115
+ # properdocs
116
+paginate==0.5.7
117
+ # via mkdocs-material
118
+pathspec==1.1.1
119
+ # via
120
+ # mkdocs
121
+ # properdocs
122
+platformdirs==4.9.6
123
+ # via
124
+ # mkdocs-get-deps
125
+ # properdocs
126
+properdocs==1.6.7
127
+ # via
128
+ # mkdocs-gen-files
129
+ # mkdocs-redirects
130
+pydantic==2.13.4
131
+ # via
132
+ # -r requirements/docs.in
133
+ # mkdocs-awesome-nav
134
+pydantic-core==2.46.4
135
+ # via pydantic
136
+pygments==2.20.0
137
+ # via mkdocs-material
138
+pymdown-extensions==10.21.2
139
+ # via
140
+ # mkdocs-material
141
+ # mkdocstrings
142
+python-dateutil==2.9.0.post0
143
+ # via ghp-import
144
+pyyaml==6.0.3
145
+ # via
146
+ # mkdocs
147
+ # mkdocs-api-autonav
148
+ # mkdocs-get-deps
149
+ # properdocs
150
+ # pymdown-extensions
151
+ # pyyaml-env-tag
152
+pyyaml-env-tag==1.1
153
+ # via
154
+ # mkdocs
155
+ # properdocs
156
+regex==2026.4.4
157
+ # via -r requirements/docs.in
158
+requests==2.33.1
159
+ # via mkdocs-material
160
+ruff==0.15.12
161
+ # via -r requirements/docs.in
162
+selectolax==0.4.8
163
+ # via mkdocs-glightbox
164
+six==1.17.0
165
+ # via python-dateutil
166
+smmap==5.0.3
167
+ # via gitdb
168
+typing-extensions==4.15.0
169
+ # via
170
+ # pydantic
171
+ # pydantic-core
172
+ # typing-inspection
173
+typing-inspection==0.4.2
174
+ # via pydantic
175
+urllib3==2.6.3
176
+ # via requests
177
+watchdog==6.0.0
178
+ # via
179
+ # mkdocs
180
+ # properdocs
181
+wcmatch==10.1
182
+ # via mkdocs-awesome-nav