Google Git
Sign in
chromium / infra / luci / recipes-py.git / e1357f8065a5783494b9167d5762997c76ec9e02
commite1357f8065a5783494b9167d5762997c76ec9e02[log] [tgz]
authorBenjamin Shai <bshai@google.com>Thu Mar 23 22:22:45 2023
committerLUCI CQ <infra-scoped@luci-project-accounts.iam.gserviceaccount.com>Thu Mar 23 22:22:45 2023
tree3148b802b51752681399894cabbf1292eaba186d
parent5741ff028603b27ce5d331caccfdd7ef2d707c5a [diff]
recipes: add expected status to test command

Add status field to test command. Right now this is not being
enforced, just logged. Eventually we want want all tests to use this.

Change-Id: I250910dfc38a65444136391f3d5de1178046245c
Reviewed-on: https://chromium-review.googlesource.com/c/infra/luci/recipes-py/+/4355931
Reviewed-by: Robbie Iannucci <iannucci@chromium.org>
Commit-Queue: Benjamin Shai <bshai@google.com>
6 files changed
tree: 3148b802b51752681399894cabbf1292eaba186d
  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.