You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: .github/skills/eng/next-version-update/SKILL.md
+15-52Lines changed: 15 additions & 52 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -16,7 +16,6 @@ The repository pins specific versions of pylint, mypy, and pyright and runs week
16
16
> **Required cross-repo check (do not skip):** After updating `azure-sdk-for-python`, you must also check whether matching updates are required in **both**[azure-sdk-tools](https://github.com/Azure/azure-sdk-tools) and [Microsoft/TypeSpec](https://github.com/microsoft/typespec). Treat the version bump as complete only after those repositories are reviewed and, when needed, PRs are opened.
17
17
18
18
Files updated in **azure-sdk-for-python**:
19
-
-`eng/tox/tox.ini` – pinned versions for `[testenv:pylint]`, `[testenv:mypy]`, `[testenv:pyright]`
@@ -55,9 +54,9 @@ Before promoting, confirm the next-* weekly analyze jobs have passed for the `ht
55
54
56
55
Check the Azure DevOps pipeline named **"python - corehttp - tests-weekly"** or similar weekly analyze pipelines. All three of the following jobs must pass (or only have pre-existing failures that are tracked):
Also verify via GitHub issues: the vnext issue creator creates/closes issues per-package. Check that there are no open `next-pylint`, `next-mypy`, or `next-pyright` issues for the core packages.
63
62
@@ -66,7 +65,7 @@ Also verify via GitHub issues: the vnext issue creator creates/closes issues per
66
65
Read the current next-* versions from `doc/analyze_check_versions.md`:
Replace `{YYYYMMDD}` with today's date (e.g., `bump-next-versions-20260420`).
111
110
112
-
### 6. Update `eng/tox/tox.ini`
113
-
114
-
**Promote next versions to current** (update the `[testenv:pylint]`, `[testenv:mypy]`, `[testenv:pyright]` sections):
115
-
116
-
In the `[testenv:pylint]` section:
117
-
```
118
-
pylint_version={OLD_NEXT_PYLINT_VERSION}
119
-
```
120
-
121
-
In the `[testenv:mypy]` section:
122
-
```
123
-
mypy_version={OLD_NEXT_MYPY_VERSION}
124
-
```
125
-
126
-
In the `[testenv:pyright]` section:
127
-
```
128
-
pyright_version={OLD_NEXT_PYRIGHT_VERSION}
129
-
```
130
-
131
-
**Set new next-* versions** (update the `[testenv:next-pylint]`, `[testenv:next-mypy]`, `[testenv:next-pyright]` sections):
132
-
133
-
In the `[testenv:next-pylint]` section:
134
-
```
135
-
pylint_version={NEW_NEXT_PYLINT_VERSION}
136
-
```
137
-
138
-
In the `[testenv:next-mypy]` section:
139
-
```
140
-
mypy_version={NEW_NEXT_MYPY_VERSION}
141
-
```
142
-
143
-
In the `[testenv:next-pyright]` section:
144
-
```
145
-
pyright_version={NEW_NEXT_PYRIGHT_VERSION}
146
-
```
147
-
148
-
### 7. Update `azpysdk` Python Constants
111
+
### 6. Update `azpysdk` Python Constants
149
112
150
113
Update the version constants used by the azpysdk CLI:
151
114
@@ -164,7 +127,7 @@ In `eng/tools/azure-sdk-tools/azpysdk/pyright.py`:
164
127
PYRIGHT_VERSION="{OLD_NEXT_PYRIGHT_VERSION}"
165
128
```
166
129
167
-
### 8. Update `pylintrc` Files
130
+
### 7. Update `pylintrc` Files
168
131
169
132
When pylint's **version** changes, the root `pylintrc` and `eng/pylintrc` may need to be updated to disable new warnings or enable newly-available rules.
170
133
@@ -182,10 +145,10 @@ When pylint's **version** changes, the root `pylintrc` and `eng/pylintrc` may ne
182
145
**For a minor/patch version bump:** Typically no pylintrc changes are needed, but verify by running:
183
146
```bash
184
147
cd sdk/core/corehttp
185
-
tox -e next-pylint
148
+
azpysdk next-pylint.
186
149
```
187
150
188
-
### 9. Update `doc/analyze_check_versions.md`
151
+
### 8. Update `doc/analyze_check_versions.md`
189
152
190
153
Update the version table to reflect the new pinned versions and next targets:
191
154
@@ -201,7 +164,7 @@ The `{TARGET_DATE}` should be approximately 12 weeks from today (the date when t
201
164
202
165
If there is no newer version available yet, use `N/A` for both **Next Version** and **Next Version Merge Date**.
203
166
204
-
### 10. Update `eng/apiview_reqs.txt`
167
+
### 9. Update `eng/apiview_reqs.txt`
205
168
206
169
Update the pylint version used by the apiview stub generator:
> **Note:** The `astroid` and related packages may also need version updates to be compatible with the new pylint version. Run the apistub check locally to verify:
> **Required review:** Always review this repo for every run of this skill. A PR is required whenever the version bump affects apiview parser dependencies/config.
256
219
@@ -285,7 +248,7 @@ For a pylint **version** bump, create a separate PR in the [azure-sdk-tools](htt
285
248
--body "Updates the pylint version used by the apiview stub generator from {OLD_PYLINT_VERSION} to {OLD_NEXT_PYLINT_VERSION}."
> **Required review:** Always review this repo for every run of this skill. A PR is required whenever TypeSpec pins or tooling references the bumped versions.
0 commit comments