@owenlamont/ryl-win32-arm64-msvc 0.25.0 → 0.26.0

package/README.md

@@ -28,6 +28,9 @@ remove it, so prefer `ryl check`.
 # Using uv (Python)
 uvx ryl check --enable ALL .
 
+# Omit selected rules and files without writing a config
+uvx ryl check --enable ALL --disable line-length,truthy,document-start --exclude pnpm-lock.yaml .
+
 # Using npx (Node.js)
 npx @owenlamont/ryl check --enable ALL .
 
@@ -91,9 +94,17 @@ newer. The prebuilt wheels, npm, conda-forge and winget packages do not.
 - `--list-files` prints the files ryl would lint (after ignores and
   config discovery) and exits, without running rules. `--no-warnings`
   suppresses warning-level diagnostics in the output. `--strict` turns a
-  warning-only run into exit code `2`. `--enable <RULES>` runs exactly the
+  warning-only run into exit code `2`; TOML `[lint] strict = true` enables the
+  same behavior for a project, and `--no-strict` overrides the config.
+  `--enable <RULES>` runs exactly the
   listed rules (comma-separated IDs, or `ALL`) in place of the config's
-  selection, and needs no config file.
+  selection, and needs no config file. `--disable <RULES>` subtracts from the
+  selected lint rules. `--exclude <GLOBS>` replaces config file exclusions;
+  globs use the current directory and also exclude explicitly named files.
+  Both new flags accept comma-separated values and may appear once per command.
+- `ryl check` and `ryl format` cache results by content and configuration.
+  Use `--no-cache` to bypass the cache or `--cache-dir PATH` to place it elsewhere.
+  See [caching](docs/getting-started/quickstart.md#caching).
 - Pass `-` as the input to read YAML from stdin (ruff convention). Add
   `--stdin-filename <PATH>` so diagnostics, project-config discovery,
   and path-based filtering (`yaml-files`, per-file-ignores, per-rule
@@ -116,13 +127,40 @@ documentation, see the docs site.
 
 ## Performance
 
-The figure below times ryl and yamllint over a 5x5 file-count × file-size
-matrix with 5 runs per point:
+The chart compares lint and format times on real-world YAML sampled from pinned
+repositories: 20–100 files × 1–9 KiB, with five runs per point.
+
+![Lint and format benchmark on real-world YAML](https://raw.githubusercontent.com/owenlamont/ryl/main/img/benchmark-cold-5x5-5runs.svg)
+
+The [benchmark script](scripts/benchmark_yaml_tools.py) also offers a generated stress dataset with `--datasets stress`.
+
+| Tool | Mode | Real-world mean, 100 × 9 KiB (s) |
+| --- | --- | ---: |
+| ryl | Lint | 0.050 |
+| yamllint | Lint | 2.304 |
+| ryl | Format | 0.056 |
+| yamlfmt | Format | 0.113 |
+| Prettier | Format | 1.140 |
+| dprint | Format | 0.105 |
+
+| Tool | Mode | Version |
+| --- | --- | --- |
+| ryl | Lint, format | 0.26.0 |
+| yamllint | Lint | 1.38.0 |
+| yamlfmt | Format | 0.21.0 |
+| Prettier | Format | 3.9.10 |
+| dprint + pretty_yaml plugin | Format | 0.63.0 + 0.6.0 |
+
+Result caches are cold; install artifacts are warm. The
+[benchmark script](scripts/benchmark_yaml_tools.py) records the commands and
+cache checks. On the real-world dataset, ryl format is faster than dprint and yamlfmt
+while still verifying value preservation and convergence
+([formatter guarantees](docs/formatter.md#guarantees)).
 
-![Benchmark: ryl vs yamllint scaling (5x5 matrix, 5 runs per point)](https://raw.githubusercontent.com/owenlamont/ryl/main/img/benchmark-5x5-5runs.svg)
+Run the benchmark with `--warm` to also record second-run timings with each
+tool's result cache enabled. Its warm view is separate from the cold chart above.
 
-The benchmark script is in `scripts/benchmark_perf_vs_yamllint.py`; run
-it with `--help` for the full option set.
+![Warm second-run benchmark on real-world YAML](https://raw.githubusercontent.com/owenlamont/ryl/main/img/benchmark-warm-5x5-5runs.svg)
 
 ## Acknowledgements
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owenlamont/ryl-win32-arm64-msvc",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "description": "Fast YAML linter and formatter",
   "author": "Owen Lamont",
   "license": "MIT",