Google Git
Sign in
chromium / infra / luci / recipes-py / c4e6ba917aeaebb96b0b94a28881bfe7d6f2943d
commitc4e6ba917aeaebb96b0b94a28881bfe7d6f2943d[log] [tgz]
authorRobert Iannucci <iannucci@chromium.org>Wed Dec 16 00:14:14 2020
committerLUCI CQ <infra-scoped@luci-project-accounts.iam.gserviceaccount.com>Wed Dec 16 00:14:14 2020
tree6694ea779e14db06615c5afdc028f566a56f7fec
parent63a8f6a6dde18c243490d88a41628a8ad2cb79ce [diff]
[engine] Detect incomplete deps and circular dependencies.

First check ensures that recipes.cfg is the transitive set, second check
prevents circular dependencies (given that the first check is in place,
the second check is trivial).

R=tandrii, vadimsh, yiwzhang

Bug: 1158469
Change-Id: I0fbe73e78d0f731bea3115e8e8709180dea48ef9
Reviewed-on: https://chromium-review.googlesource.com/c/infra/luci/recipes-py/+/2594258
Reviewed-by: Yiwei Zhang <yiwzhang@google.com>
Commit-Queue: Robbie Iannucci <iannucci@chromium.org>
3 files changed
tree: 6694ea779e14db06615c5afdc028f566a56f7fec
  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. AUTHORS
  14. codereview.settings
  15. CONTRIBUTORS
  16. LICENSE
  17. OWNERS
  18. PRESUBMIT.py
  19. README.md
  20. README.recipes.md
  21. 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.