Skip to content

Commit ac78128

Browse files
committed
ref(debug-files): rename prepare command to wasm-upload
1 parent 0ac2043 commit ac78128

8 files changed

Lines changed: 580 additions & 33 deletions

File tree

‎apps/cli-docs/src/content/docs/contributing.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ cli/
6060
│ │ ├── code-mappings/# upload
6161
│ │ ├── dart-symbol-map/# upload
6262
│ │ ├── dashboard/ # add, create, delete, edit, list, restore, revisions, view
63-
│ │ ├── debug-files/ # bundle-jvm, bundle-sources, check, find, prepare, print-sources, upload
63+
│ │ ├── debug-files/ # bundle-jvm, bundle-sources, check, find, print-sources, upload, wasm-upload
6464
│ │ ├── docs/ # list, query
6565
│ │ ├── event/ # list, send, view
6666
│ │ ├── feedback/ # list, view

‎apps/cli-docs/src/fragments/commands/debug-files.md‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -51,19 +51,19 @@ sentry debug-files upload ./build --il2cpp-mapping --include-sources
5151
sentry debug-files upload ./build --no-upload
5252

5353
# Split WebAssembly debug info and upload it (scans directories recursively)
54-
sentry debug-files prepare ./dist
54+
sentry debug-files wasm-upload ./dist
5555

5656
# Preview the split without writing or uploading anything
57-
sentry debug-files prepare ./dist --dry-run
57+
sentry debug-files wasm-upload ./dist --dry-run
5858

5959
# Split only, keeping the companions local
60-
sentry debug-files prepare ./dist --no-upload
60+
sentry debug-files wasm-upload ./dist --no-upload
6161

6262
# Write companions elsewhere; modules are still stripped in place
63-
sentry debug-files prepare ./dist --out-dir ./symbols
63+
sentry debug-files wasm-upload ./dist --out-dir ./symbols
6464

6565
# Fail the build if any module was compiled without DWARF
66-
sentry debug-files prepare ./dist --require-dwarf
66+
sentry debug-files wasm-upload ./dist --require-dwarf
6767
```
6868

6969
## Notes on `prepare`

‎packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -479,8 +479,8 @@ Work with debug information files
479479

480480
- `sentry debug-files check <path>` — Inspect a debug information file
481481
- `sentry debug-files find <id...>` — Locate debug files for given debug identifiers
482-
- `sentry debug-files prepare <path...>` — Split WebAssembly debug info and upload it to Sentry
483482
- `sentry debug-files upload <path...>` — Upload debug information files to Sentry
483+
- `sentry debug-files wasm-upload <path...>` — Split WebAssembly debug info and upload it to Sentry
484484
- `sentry debug-files print-sources <path>` — List the source files a debug file references
485485
- `sentry debug-files bundle-sources <path>` — Bundle a debug file's source files for source context
486486
- `sentry debug-files bundle-jvm <path>` — Create a JVM source bundle for source context

‎packages/cli/plugins/sentry-cli/skills/sentry-cli/references/debug-files.md‎

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -25,23 +25,6 @@ Locate debug files for given debug identifiers
2525
- `--no-cwd - Do not look for debug files in the current directory`
2626
- `-p, --path <value>... - Add a directory to search recursively (repeatable)`
2727

28-
### `sentry debug-files prepare <path...>`
29-
30-
Split WebAssembly debug info and upload it to Sentry
31-
32-
**Flags:**
33-
- `--dry-run - Classify modules without writing or uploading anything`
34-
- `--no-upload - Split modules but do not upload the companions`
35-
- `--require-dwarf - Fail if any scanned module lacks DWARF debug info`
36-
- `--out-dir <value> - Directory for *.debug.wasm companions (modules are stripped in place)`
37-
- `--strip-names - Also drop the name section from split modules (companion keeps it)`
38-
- `--build-id <value> - Use this UUID as the build id instead of a random one (one .wasm file only)`
39-
- `--include-sources - Also upload a source bundle for each companion`
40-
- `--ignore <value>... - Skip files and folders matching this glob (repeatable)`
41-
- `--ignore-file <value> - Skip files and folders listed in this ignore file`
42-
- `--wait - Wait for server-side processing and report any errors`
43-
- `--wait-for <value> - Wait up to this many seconds for server-side processing`
44-
4528
### `sentry debug-files upload <path...>`
4629

4730
Upload debug information files to Sentry
@@ -61,6 +44,23 @@ Upload debug information files to Sentry
6144
- `--wait - Wait for server-side processing and report any errors`
6245
- `--wait-for <value> - Wait up to this many seconds for server-side processing`
6346

47+
### `sentry debug-files wasm-upload <path...>`
48+
49+
Split WebAssembly debug info and upload it to Sentry
50+
51+
**Flags:**
52+
- `--dry-run - Classify modules without writing or uploading anything`
53+
- `--no-upload - Split modules but do not upload the companions`
54+
- `--require-dwarf - Fail if any scanned module lacks DWARF debug info`
55+
- `--out-dir <value> - Directory for *.debug.wasm companions (modules are stripped in place)`
56+
- `--strip-names - Also drop the name section from split modules (companion keeps it)`
57+
- `--build-id <value> - Use this UUID as the build id instead of a random one (one .wasm file only)`
58+
- `--include-sources - Also upload a source bundle for each companion`
59+
- `--ignore <value>... - Skip files and folders matching this glob (repeatable)`
60+
- `--ignore-file <value> - Skip files and folders listed in this ignore file`
61+
- `--wait - Wait for server-side processing and report any errors`
62+
- `--wait-for <value> - Wait up to this many seconds for server-side processing`
63+
6464
### `sentry debug-files print-sources <path>`
6565

6666
List the source files a debug file references
@@ -131,19 +131,19 @@ sentry debug-files upload ./build --il2cpp-mapping --include-sources
131131
sentry debug-files upload ./build --no-upload
132132

133133
# Split WebAssembly debug info and upload it (scans directories recursively)
134-
sentry debug-files prepare ./dist
134+
sentry debug-files wasm-upload ./dist
135135

136136
# Preview the split without writing or uploading anything
137-
sentry debug-files prepare ./dist --dry-run
137+
sentry debug-files wasm-upload ./dist --dry-run
138138

139139
# Split only, keeping the companions local
140-
sentry debug-files prepare ./dist --no-upload
140+
sentry debug-files wasm-upload ./dist --no-upload
141141

142142
# Write companions elsewhere; modules are still stripped in place
143-
sentry debug-files prepare ./dist --out-dir ./symbols
143+
sentry debug-files wasm-upload ./dist --out-dir ./symbols
144144

145145
# Fail the build if any module was compiled without DWARF
146-
sentry debug-files prepare ./dist --require-dwarf
146+
sentry debug-files wasm-upload ./dist --require-dwarf
147147
```
148148

149149
All commands also support `--json`, `--fields`, `--help`, `--log-level`, and `--verbose` flags.

‎packages/cli/src/commands/debug-files/index.ts‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,16 +9,16 @@ import { bundleJvmCommand } from "./bundle-jvm.js";
99
import { bundleSourcesCommand } from "./bundle-sources.js";
1010
import { checkCommand } from "./check.js";
1111
import { findCommand } from "./find.js";
12-
import { prepareCommand } from "./prepare.js";
1312
import { printSourcesCommand } from "./print-sources.js";
1413
import { uploadCommand } from "./upload.js";
14+
import { wasmUploadCommand } from "./wasm-upload.js";
1515

1616
export const debugFilesRoute = buildRouteMap({
1717
routes: {
1818
check: checkCommand,
1919
find: findCommand,
20-
prepare: prepareCommand,
2120
upload: uploadCommand,
21+
"wasm-upload": wasmUploadCommand,
2222
"print-sources": printSourcesCommand,
2323
"bundle-sources": bundleSourcesCommand,
2424
"bundle-jvm": bundleJvmCommand,

0 commit comments

Comments
 (0)