Files

T

cdesouza-chromium 8d3cd8a564 [brockit] Add update-rust-wasm-toolchain command (#37021 )

This PR adds a command to `brockit` to be used to update the Rust/WASM
toolchain. This command will take care of determining which version we
should be using, and going ahead and fetching whatever is available in
the bucket, based on the available indexes.

Bug: https://github.com/brave/brave-browser/issues/55812

2026-06-05 14:35:16 +01:00

alias

[docs] Format README.md (#36844 )

2026-06-01 16:00:04 +01:00

iwyu

[docs] Format README.md (#36844 )

2026-06-01 16:00:04 +01:00

test

…

toolchains

[brockit] Add update-rust-wasm-toolchain command (#37021 )

2026-06-05 14:35:16 +01:00

.vpython3

[plaster] Introducing a 🩹 YAML frontend (#36651 )

2026-05-22 15:20:51 +01:00

brockit_test.py

…

brockit.py

[brockit] Add update-rust-wasm-toolchain command (#37021 )

2026-06-05 14:35:16 +01:00

fake_chromium_repo_test.py

…

find_rebase_commits.py

…

gen_rust_toolchain_integration_test.py

[brockit] Kick out Rust/WASM CI jobs (#36903 )

2026-06-01 22:50:42 +01:00

gen_rust_toolchain_test.py

[brockit] Kick out Rust/WASM CI jobs (#36903 )

2026-06-01 22:50:42 +01:00

git_status_test.py

…

git_status.py

…

patchfile_test.py

…

patchfile.py

[plaster] Introducing a 🩹 YAML frontend (#36651 )

2026-05-22 15:20:51 +01:00

plaster_test.py

[plaster] Introducing a 🩹 YAML frontend (#36651 )

2026-05-22 15:20:51 +01:00

plaster.py

[plaster] Introducing a 🩹 YAML frontend (#36651 )

2026-05-22 15:20:51 +01:00

post_presubmit.py

…

PRESUBMIT.py

…

prune_test_filters_test.py

…

prune_test_filters.py

…

python_dos_and_donts.md

[brockit] Adding a section about classes to dos and donts (#36671 )

2026-05-24 00:46:42 +01:00

README.md

[docs] Format README.md (#36844 )

2026-06-01 16:00:04 +01:00

rebase_test.py

…

rebase_v2_test.py

…

rebase_v2.py

…

repository_test.py

…

repository.py

…

terminal.py

[brockit] Kick out Rust/WASM CI jobs (#36903 )

2026-06-01 22:50:42 +01:00

update_rust_wasm_toolchain_test.py

[brockit] Add update-rust-wasm-toolchain command (#37021 )

2026-06-05 14:35:16 +01:00

update_xcode_toolchain_test.py

[toolchain] tools/cr/toolchain => tools/cr/toolchains (#36813 )

2026-05-28 15:07:46 +01:00

versioning_test.py

…

versioning.py

…

vpython_utils.py

…

vscode_test.py

…

vscode.py

…

README.md

`tools/cr`

Python tooling maintained by the Chromium Rebase team to support upgrading brave-core to new Chromium versions and to manage the patches and shadow files that live on top of upstream.

All scripts here are intended to run via vpython3; the .vpython3 spec in this directory pulls in rich, requests, and the other wheels they need. Most scripts accept --verbose to switch logging to DEBUG.

Important

Before adding or editing Python in this directory, read Python dos and donts.

Entry points

These are the user-facing scripts in this directory:

🚀Brockit — End-to-end rebase orchestration. Updates the Chromium version, regenerates patches and strings, and walks the rebase forward.
🩹Plaster — Applies and regenerates "plaster" files: semantic patches against upstream Chromium sources.
post_presubmit.py — Posts and refreshes GitHub PR comments from a npm run presubmit JSON dump.
find_rebase_commits.py — Resolves a Chromium rebase tag (e.g. cr148) to an oldest..newest git commit range.
prune_test_filters.py — Detects and (optionally) removes obsolete entries from the current platform's test-filter files.

Library modules

Shared abstractions used by the entry points and tests:

repository.py — Repository instances (repository.brave, repository.chromium) for paths and for running git commands at any repo.
terminal.py — Rich console, baseline logging config, and subprocess utilities.
vpython_utils.py — Provides vpython3 path.
patchfile.py — Patch file abstraction handling patches that failed to apply.
git_status.py — Parser for git status --porcelain output.
versioning.py — Chromium version number parsing.
vscode.py — IPC for opening files in VS Code in the integrated terminal.

Subdirectories

alias/ — git cr git-alias subcommands (commit, mv, follow-renames, ...). See alias/README.md.
test/ — Shared test fixtures, including FakeChromiumRepo.
toolchain/ — Scripts to build platform-specific toolchains when rebasing Chromium.

Tests

Every module of interest ships a *_test.py next to it. Tests should always have a vpython3 shebang line, and +x mode, so they can be run as their own utilities from the repo root.

Tests should keep mock use to a minimum. Make sure to always use FakeChromiumRepo to provide a test enviroment. Scripts tested with FakeChromiumRepo should rely always on relative paths derived from Repository.brave.root to permit tests to be run in integration with the repository sandbox provided with FakeChromiumRepo.