docs: add build.rs materialize how-to#591
Conversation
Phase 4 task-first how-to for the build.rs materialize workflow. Walks through the uselesskey-fixtures.toml manifest, the build.rs call sites, the OUT_DIR usage pattern, and the shape-only vs runtime-rsa flavors.
|
Warning You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again! |
|
Warning Rate limit exceeded
You’ve run out of usage credits. Purchase more in the billing tab. ⌛ How to resolve this issue?After the wait time has elapsed, a review can be triggered using the We recommend that you space out your commits to avoid hitting the rate limit. 🚦 How do rate limits work?CodeRabbit enforces hourly rate limits for each developer per organization. Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout. Please see our FAQ for further information. ℹ️ Review info⚙️ Run configurationConfiguration used: Organization UI Review profile: ASSERTIVE Plan: Pro Run ID: 📒 Files selected for processing (1)
✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
Pure docs PR. Task-first how-to for materializing fixtures in build.rs. Part of the Phase 4 task-first user-paths sweep.
File added
docs/how-to/materialize-fixtures-in-build-rs.md— task-first walkthrough of theuselesskey-fixtures.tomlmanifest, thebuild.rscall sites (load_materialize_manifest,materialize_manifest_to_dir,emit_include_bytes_module), theOUT_DIRaccess pattern, and the two flavors (shape-only and runtime-rsa).References
crates/materialize-shape-buildrs-example/— shape-only manifest, build script, and consuminglib.rsused as the canonical shape-only template.crates/materialize-buildrs-example/— RSA-materialize manifest, build script, and consuminglib.rsused as the canonical runtime-rsa template.docs/how-to/choose-features.mdandexamples/scanner-safe-bundle/README.mdfrom the See Also section, and todocs/release/publish-recovery.mdfrom the scanner-safety boundary section.Test plan
cargo xtask docs-sync --checkpasses.cargo xtask typosclean on the new file.git diff --checkreports no whitespace issues.uselesskey_cli::MaterializeFixtureSpecand thebuild.rsexcerpt againstcrates/materialize-buildrs-example/build.rs.