Google Git
Sign in
chromium / infra / luci / recipes-py / 428eeaebf2e1de58ed1c7cae50daba3384d730cd
commit428eeaebf2e1de58ed1c7cae50daba3384d730cd[log] [tgz]
authorRobert Iannucci <iannucci@chromium.org>Fri Jul 15 19:28:01 2022
committerLUCI CQ <infra-scoped@luci-project-accounts.iam.gserviceaccount.com>Fri Jul 15 19:28:01 2022
tree8598dec95380488af798b5faa492987f37c2038f
parentf2ff4699652ca80cd66c9b99f129d4dcf591a253 [diff]
Update buildbucket protos.

This will require multiple downstream manual changes, as this includes
the rename of 'builder.proto' to 'builder_common.proto', which will
break both python imports as well as in-proto-file imports.

Bug: 1329911
Recipe-Manual-Change: build
Recipe-Manual-Change: build_limited
Recipe-Manual-Change: chrome_release
Recipe-Manual-Change: chromiumos
Recipe-Manual-Change: fuchsia
Change-Id: I7c5b468337414b2afc85678222922bddad89704a
Reviewed-on: https://chromium-review.googlesource.com/c/infra/luci/recipes-py/+/3761450
Reviewed-by: Yiwei Zhang <yiwzhang@google.com>
Commit-Queue: Robbie Iannucci <iannucci@chromium.org>
18 files changed
tree: 8598dec95380488af798b5faa492987f37c2038f
  1. doc/
  2. infra/
  3. misc/
  4. recipe_engine/
  5. recipe_modules/
  6. recipe_proto/
  7. recipes/
  8. unittests/
  9. .gitattributes
  10. .gitignore
  11. .style.yapf
  12. .vpython
  13. .vpython3
  14. .vpython3_dev
  15. AUTHORS
  16. codereview.settings
  17. CONTRIBUTORS
  18. LICENSE
  19. OWNERS
  20. PRESUBMIT.py
  21. README.md
  22. README.recipes.md
  23. recipe.warnings
  24. recipes.py
README.md

Recipes

Recipes are a domain-specific language (embedded in Python) for specifying sequences of subprocess calls in a cross-platform and testable way.

They allow writing build flows which integrate with the rest of LUCI.

Documentation for the recipe engine (including this file!). Take a look at the user guide for some hints on how to get started. See the implementation details doc for more detailed implementation information about the recipe engine.

Contributing

  • Sign the Google CLA.
  • Make sure your user.email and user.name are configured in git config.

Run the following to setup the code review tool and create your first review:

# Get `depot_tools` in $PATH if you don't have it
git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git $HOME/src/depot_tools
export PATH="$PATH:$HOME/src/depot_tools"

# Check out the recipe engine repo
git clone https://chromium.googlesource.com/infra/luci/recipes-py $HOME/src/recipes-py

# make your change
cd $HOME/src/recipes-py
git new-branch cool_feature
# hack hack
git commit -a -m "This is awesome"

# This will ask for your Google Account credentials.
git cl upload -s -r joe@example.com
# Wait for approval over email.
# Click "Submit to CQ" button or ask reviewer to do it for you.
# Wait for the change to be tested and landed automatically.

Use git cl help and git cl help <cmd> for more details.