From 85d574ae467a6eeabeaa53ed6af07321680a2b3b Mon Sep 17 00:00:00 2001 From: Facebook GitHub Bot Date: Tue, 28 Nov 2023 10:32:54 -0800 Subject: [PATCH] Re-sync with internal repository The internal and external repositories are out of sync. This Pull Request attempts to brings them back in sync by patching the GitHub repository. Please carefully review this patch. You must disable ShipIt for your project in order to merge this pull request. DO NOT IMPORT this pull request. Instead, merge it directly on GitHub using the MERGE BUTTON. Re-enable ShipIt after merging. --- fbcode/buck2/starlark-rust/README.fb.md | 57 ------------------------- 1 file changed, 57 deletions(-) delete mode 100644 fbcode/buck2/starlark-rust/README.fb.md diff --git a/fbcode/buck2/starlark-rust/README.fb.md b/fbcode/buck2/starlark-rust/README.fb.md deleted file mode 100644 index 2dd0d816b..000000000 --- a/fbcode/buck2/starlark-rust/README.fb.md +++ /dev/null @@ -1,57 +0,0 @@ -# starlark-rust and starlark in Meta - -If something is missing here or outdated, -we appreciate if you submit a diff with the corrections. - -## Projects using starlark-rust - -When something changes in starlark-rust, -these projects may break. - -* [buck2](https://www.internalfb.com/code/buck2) - uses starlark as - * a language for targets (`BUCK`, `TARGETS`) - and macros and rules (`*.bzl`) - * scripting language (BXL, `*.bxl`) -* antlir uses starlark to generate serialization code - with shared definitions from bzl and python/rust -* metalos uses starlark to evaluate `HostConfig` generators -* netos (using it how?) -* codehub (using it how?) -* ai_productivity/promptlark - [uses starlark in interative sessions](https://fburl.com/workplace/3um0vn1j) -* chronozl (cron jobs in fbcode described in starlark, - [`*.chronos.bzl`](https://fburl.com/code/kzx3p477)) -* flite (authoring ML features; where are the source files?) -* [JetBrains CLI](https://fburl.com/code/hetua4cx) - (what it does with starlark?) -* [Grid 2 Jobclass definitions for ASIC](https://www.internalfb.com/intern/wiki/ESE/SPEAR/ASIC/User_Documentation/EDA/GridCLI_-_a_compute_job_scheduling_tool/User_Documentation/Grid_2_Jobclasses/) - * files deployed and managed by chef [ARVR](https://www.internalfb.com/code/opsfiles/chef/itchef/cookbooks/other/fbit_arvredamgmt/files/default/)[FB](https://www.internalfb.com/code/opsfiles/chef/itchef/cookbooks/other/fbit_fbedamgmt/files/default/) - * [all files matching pattern (*.star) : example link](https://www.internalfb.com/code/opsfiles/chef/itchef/cookbooks/other/fbit_arvredamgmt/files/default/snc/prod/jobconfigs/) -## Tools working with starlark-rust sources - -When something changes in starlark-rust, -these tools may break. - -* fork of Google's buildifier is used to - [lint and format buck files](https://fburl.com/code/gnje3elg) -* [tools/build/buck/parser.py](https://fburl.com/code/w2j2nazt) - starlark file parser written in Python, which parses `TARGETS` files - by evaluating them, so modifications of starlark-rust - break this parser - * it is used by autodeps, which is a tooling to manage - `TARGETS` files, in particular, manage deps - * also used in [lionhead](https://fburl.com/code/sp6wv67n) - to get a list of buck targets, and then generate new buck target - that compile the same sources/dependencies with a different rule - to obtain fuzz tests for the given code. - Lionhead is part of product security. - You can reach out to the oncall @dynamic_analysis for questions. - -## Other starlark uses in Meta - -* buck1 has a - [starlark implementation in Java](https://www.internalfb.com/code/fbsource/xplat/build_infra/buck_client/starlark/) - which is a fork of Bazel's starlark implementation. -* UTD and Skycastle define jobs using starlark (`*.td`, `*.sky`). - They use a fork of buck1 fork of starlark.