Skip to content

Commit c822f4f

Browse files
authored
fixup! test(@angular/build): add library builder scaling benchmark suite
1 parent 25e62c9 commit c822f4f

1 file changed

Lines changed: 9 additions & 7 deletions

File tree

‎scripts/benchmarks/library-builder/README.md‎

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@ This benchmark measures build time metrics for Angular libraries.
66

77
Angular CLI is in the process of transitioning from `ng-packagr` to Angular CLI's native library builder.
88
Both library build systems are registered Architect builders:
9+
910
- `@angular/build:ng-packagr`: runs library builds through the legacy `ng-packagr` build pipeline.
1011
- `@angular/build:library`: runs library builds through Angular CLI's native library builder.
1112

@@ -22,6 +23,7 @@ as the number of entry points scale past a certain N (in the test runs N=200+).
2223
[Landing Angular CLI's native `@angular/build:library` builder](https://github.com/angular/angular-cli/pull/34106#issuecomment-5744311681),
2324
indicated very favourable performance metrics for the new library builder that can be explained by number of
2425
architectural changes in the library build pipeline:
26+
2527
- Shared Stylesheet Bundling
2628
- Public API Invalidation via Declaration Hashing
2729
- Dedicated Worker Pool for Production Builds
@@ -83,13 +85,13 @@ pnpm admin benchmark library-builder [options]
8385

8486
### Options
8587

86-
| Option | Description | Default |
87-
| :--------------------- | :----------------------------------------------- | :---------------------------------------- |
88-
| `--layout=<flat\|deep>` | Fixture layout | `flat` |
89-
| `--count=<n,n,...>` | Entry-point count targets, drives both layouts | `10,20,50,100,200,300,400,500,1000,2000` |
90-
| `--depth=<n,n,...>` | **`layout=deep` only.** Explicit tree depths, overriding the depths otherwise derived from `--count` | derived from `--count` |
91-
| `--iterations=<n>` | Measured iterations per size | `3` |
92-
| `--json` | Output raw measurements as JSON | N/A |
88+
| Option | Description | Default |
89+
| :---------------------- | :--------------------------------------------------------------------------------------------------- | :--------------------------------------- |
90+
| `--layout=<flat\|deep>` | Fixture layout | `flat` |
91+
| `--count=<n,n,...>` | Entry-point count targets, drives both layouts | `10,20,50,100,200,300,400,500,1000,2000` |
92+
| `--depth=<n,n,...>` | **`layout=deep` only.** Explicit tree depths, overriding the depths otherwise derived from `--count` | derived from `--count` |
93+
| `--iterations=<n>` | Measured iterations per size | `3` |
94+
| `--json` | Output raw measurements as JSON | N/A |
9395

9496
> `--count` and `--depth` are not independent sweep axes for `layout=deep`: `--count` is translated
9597
> into depths (smallest `depth` with `2^depth >= n` per target, de-duplicated); `--depth` only

0 commit comments

Comments
 (0)