(docs_json: Path)
| 356 | |
| 357 | |
| 358 | def migrate(docs_json: Path) -> tuple[int, int, int, int]: |
| 359 | data = json.loads(docs_json.read_text(encoding="utf-8")) |
| 360 | languages = data["navigation"]["languages"] |
| 361 | docs_root = docs_json.parent |
| 362 | |
| 363 | edge_inserted = 0 |
| 364 | versions_prefixed = 0 |
| 365 | versions_dropped = 0 |
| 366 | for i, block in enumerate(languages): |
| 367 | before_versions = block.get("versions", []) |
| 368 | new_block = _migrate_language_block(block, docs_root) |
| 369 | languages[i] = new_block |
| 370 | |
| 371 | after_versions = new_block.get("versions", []) |
| 372 | if any(v.get("version") == EDGE_VERSION for v in after_versions) and not any( |
| 373 | v.get("version") == EDGE_VERSION for v in before_versions |
| 374 | ): |
| 375 | edge_inserted += 1 |
| 376 | versions_prefixed += sum( |
| 377 | 1 for v in after_versions if _is_version_slug(v.get("version", "")) |
| 378 | ) |
| 379 | kept_versioned = sum( |
| 380 | 1 for v in after_versions if _is_version_slug(v.get("version", "")) |
| 381 | ) |
| 382 | before_versioned = sum( |
| 383 | 1 for v in before_versions if _is_version_slug(v.get("version", "")) |
| 384 | ) |
| 385 | versions_dropped += before_versioned - kept_versioned |
| 386 | |
| 387 | redirects_upserted = _update_redirects(data, LATEST_DEFAULT_VERSION) |
| 388 | |
| 389 | docs_json.write_text( |
| 390 | json.dumps(data, indent=2, ensure_ascii=False) + "\n", |
| 391 | encoding="utf-8", |
| 392 | ) |
| 393 | return edge_inserted, versions_prefixed, versions_dropped, redirects_upserted |
| 394 | |
| 395 | |
| 396 | def main() -> int: |
no test coverage detected