คู่มือการค้นหา

รายงานปัญหา ดูแหล่งที่มา /3} /4} {3/4} {3/4} {3/4} {3/4} /4.

หน้านี้จะพูดถึงวิธีเริ่มต้นใช้งานภาษาการค้นหาของ Bazel เพื่อติดตามการขึ้นต่อกันในโค้ด

โปรดดูรายละเอียดภาษาและรายละเอียดการแจ้งว่าไม่เหมาะสม--outputในคู่มือข้อมูลอ้างอิง ข้อมูลอ้างอิงคำค้นหาของ Bazel และข้อมูลอ้างอิงคำค้นหาของ Bazel คุณรับความช่วยเหลือได้โดยพิมพ์ bazel help query หรือ bazel help cquery ในบรรทัดคำสั่ง

หากต้องการดำเนินการค้นหาโดยไม่สนใจข้อผิดพลาด เช่น เป้าหมายที่หายไป ให้ใช้ Flag --keep_going

การหาทรัพยากร Dependency ของกฎ

หากต้องการดูทรัพยากร Dependency ของ //foo ให้ใช้ฟังก์ชัน deps ในคำค้นหา Bazel

$ bazel query "deps(//foo)"
//foo:foo
//foo:foo-dep
...

นี่คือชุดของเป้าหมายทั้งหมดที่จำเป็นในการสร้าง //foo

การติดตามห่วงโซ่ทรัพยากร Dependency ระหว่าง 2 แพ็กเกจ

ไลบรารี //third_party/zlib:zlibonly ไม่ได้อยู่ในไฟล์ BUILD สำหรับ //foo แต่เป็นทรัพยากร Dependency โดยอ้อม เราจะติดตามเส้นทางการขึ้นต่อกันนี้ได้อย่างไร ฟังก์ชันนี้มี 2 ฟังก์ชันที่เป็นประโยชน์ ได้แก่ allpaths และ somepath นอกจากนี้ คุณอาจต้องยกเว้นทรัพยากร Dependency ของเครื่องมือด้วย --notool_deps หากคุณสนใจเฉพาะสิ่งที่รวมอยู่ในอาร์ติแฟกต์ที่สร้างขึ้น ไม่ใช่ทุกงานที่เป็นไปได้

หากต้องการดูกราฟของทรัพยากร Dependency ทั้งหมด ให้แมปเอาต์พุตของการค้นหา Bazel ผ่านเครื่องมือบรรทัดคำสั่ง dot ดังนี้

$ bazel query "allpaths(//foo, third_party/...)" --notool_deps --output graph | dot -Tsvg > /tmp/deps.svg

หมายเหตุ: dot รองรับรูปภาพรูปแบบอื่นๆ เพียงแทนที่ svg ด้วยตัวระบุรูปแบบ เช่น png

เมื่อกราฟทรัพยากร Dependency มีขนาดใหญ่และซับซ้อน การเริ่มต้นด้วยเส้นทางเดียวก็อาจมีประโยชน์ดังนี้

$ bazel query "somepath(//foo:foo, third_party/zlib:zlibonly)"
//foo:foo
//translations/tools:translator
//translations/base:base
//third_party/py/MySQL:MySQL
//third_party/py/MySQL:_MySQL.so
//third_party/mysql:mysql
//third_party/zlib:zlibonly

หากไม่ระบุ --output graph ด้วย allpaths คุณจะเห็นรายการกราฟทรัพยากร Dependency ที่แบ่งออกเป็นหลายส่วน

$ bazel query "allpaths(//foo, third_party/...)"
  ...many errors detected in BUILD files...
//foo:foo
//translations/tools:translator
//translations/tools:aggregator
//translations/base:base
//tools/pkg:pex
//tools/pkg:pex_phase_one
//tools/pkg:pex_lib
//third_party/python:python_lib
//translations/tools:messages
//third_party/py/xml:xml
//third_party/py/xml:utils/boolean.so
//third_party/py/xml:parsers/sgmlop.so
//third_party/py/xml:parsers/pyexpat.so
//third_party/py/MySQL:MySQL
//third_party/py/MySQL:_MySQL.so
//third_party/mysql:mysql
//third_party/openssl:openssl
//third_party/zlib:zlibonly
//third_party/zlib:zlibonly_v1_2_3
//third_party/python:headers
//third_party/openssl:crypto

หมายเหตุ: ทรัพยากร Dependency โดยนัย

ไฟล์ BUILD สำหรับ //foo ไม่เคยอ้างอิง //translations/tools:aggregator แล้วทรัพยากร Dependency โดยตรงอยู่ที่ไหน

กฎบางข้อมีการขึ้นต่อกันโดยนัยในไลบรารีหรือเครื่องมือเพิ่มเติม เช่น หากต้องการสร้างกฎ genproto คุณต้องสร้างคอมไพเลอร์โปรโตคอลก่อน เพื่อให้กฎ genproto ทุกกฎมีการขึ้นต่อกันโดยนัยในคอมไพเลอร์โปรโตคอล ทรัพยากร Dependency เหล่านี้ไม่ได้ระบุไว้ในไฟล์บิลด์ แต่เพิ่มโดยเครื่องมือสร้างบิลด์ ขณะนี้ยังไม่มีการบันทึกทรัพยากร Dependency โดยนัยทั้งชุด การใช้ --noimplicit_deps จะช่วยให้คุณกรองการลดจำนวนเหล่านี้ออกจากผลการค้นหาได้ สำหรับ cquery ระบบจะรวม Toolchain ที่มีการแก้ปัญหาไว้ด้วย

การขึ้นต่อกันแบบย้อนกลับ

คุณอาจต้องการทราบชุดของเป้าหมายที่อยู่ภายใต้บางเป้าหมาย ตัวอย่างเช่น หากคุณกำลังจะเปลี่ยนแปลงโค้ดบางอย่าง คุณอาจต้องการทราบโค้ดอื่นๆ ที่คุณ กำลังจะเสียหาย คุณสามารถใช้ rdeps(u, x) เพื่อค้นหาทรัพยากร Dependency แบบย้อนกลับของเป้าหมายใน x ภายในการปิดแบบทรานซิทีฟของ u

Sky Query ของ Bazel รองรับฟังก์ชัน allrdeps ซึ่งช่วยให้คุณค้นหาทรัพยากร Dependency แบบย้อนกลับในจักรวาลที่คุณระบุได้

การใช้งานเบ็ดเตล็ด

คุณใช้ bazel query เพื่อวิเคราะห์ความสัมพันธ์ของทรัพยากร Dependency ได้หลายรายการ

สิ่งที่มีอยู่ ...

มีแพ็กเกจใดอยู่ใต้ foo

bazel query 'foo/...' --output package

มีการกำหนดกฎใดในแพ็กเกจ foo

bazel query 'kind(rule, foo:*)' --output label_kind

ไฟล์ใดสร้างขึ้นตามกฎในแพ็กเกจ foo

bazel query 'kind("generated file", //foo:*)'

มาโคร Starlark foo สร้างเป้าหมายใด

bazel query 'attr(generator_function, foo, //path/to/search/...)'

ชุดไฟล์ BUILD ที่จำเป็นสำหรับการสร้าง //foo คือชุดใด

bazel query 'buildfiles(deps(//foo))' | cut -f1 -d:

การทดสอบแต่ละรายการที่ test_suite ขยายไปถึงคืออะไร

bazel query 'tests(//foo:smoke_tests)'

ข้อใดต่อไปนี้คือการทดสอบ C++

bazel query 'kind(cc_.*, tests(//foo:smoke_tests))'

ข้อใดต่อไปนี้มีขนาดเล็ก ปานกลาง ขนาดใหญ่

bazel query 'attr(size, small, tests(//foo:smoke_tests))'

bazel query 'attr(size, medium, tests(//foo:smoke_tests))'

bazel query 'attr(size, large, tests(//foo:smoke_tests))'

การทดสอบภายใต้ foo ที่ตรงกับรูปแบบคืออะไร

bazel query 'filter("pa?t", kind(".*_test rule", //foo/...))'

รูปแบบนี้คือนิพจน์ทั่วไปและใช้กับชื่อเต็มของกฎ คล้ายกับการลงมือ

bazel query 'kind(".*_test rule", //foo/...)' | grep -E 'pa?t'

แพ็กเกจใดที่มีไฟล์ path/to/file/bar.java

 bazel query path/to/file/bar.java --output=package

ป้ายกำกับบิลด์สำหรับ path/to/file/bar.java? คืออะไร

bazel query path/to/file/bar.java

กฎเป้าหมายใดมีไฟล์ path/to/file/bar.java เป็นแหล่งที่มา

fullname=$(bazel query path/to/file/bar.java)
bazel query "attr('srcs', $fullname, ${fullname//:*/}:*)"

ทรัพยากร Dependency ของแพ็กเกจมีอะไรบ้าง ...

foo ใช้แพ็กเกจใด (ฉันต้องชำระเงินอะไรบ้างเพื่อสร้าง foo)

bazel query 'buildfiles(deps(//foo:foo))' --output package

หมายเหตุ: ต้องใช้ buildfiles เพื่อให้ได้รับไฟล์ทั้งหมดที่อ้างอิงโดย subinclude อย่างถูกต้อง โปรดดูรายละเอียดในคู่มืออ้างอิง

แผนผัง foo อ้างอิงแพ็กเกจใด ยกเว้น foo/contrib

bazel query 'deps(foo/... except foo/contrib/...)' --output package

ทรัพยากร Dependency ของกฎใดมีอยู่ ...

แถบอ้างอิงกฎ Genprof ในข้อใด

bazel query 'kind(genproto, deps(bar/...))'

ค้นหาคำจำกัดความของไลบรารี JNI (C++) บางส่วนที่ขึ้นอยู่กับกฎไบนารีของ Java ในโครงสร้างเซิร์ฟเล็ต

bazel query 'some(kind(cc_.*library, deps(kind(java_binary, //java/com/example/frontend/...))))' --output location

...ตอนนี้ค้นหาคำนิยามของไบนารีของ Java ทั้งหมดที่พึ่งพิงอยู่

bazel query 'let jbs = kind(java_binary, //java/com/example/frontend/...) in
  let cls = kind(cc_.*library, deps($jbs)) in
    $jbs intersect allpaths($jbs, $cls)'

การอ้างอิงไฟล์ใดที่มีอยู่ ...

ไฟล์ต้นฉบับ Java ทั้งหมดที่ต้องใช้ในการสร้าง foo คืออะไรบ้าง

ไฟล์ต้นฉบับ:

bazel query 'kind("source file", deps(//path/to/target/foo/...))' | grep java$

ไฟล์ที่สร้างขึ้น:

bazel query 'kind("generated file", deps(//path/to/target/foo/...))' | grep java$

ชุดไฟล์แหล่งที่มา Java ทั้งหมดที่ต้องใช้ในการสร้างการทดสอบของ QUX คืออะไรบ้าง

ไฟล์ต้นฉบับ:

bazel query 'kind("source file", deps(kind(".*_test rule", javatests/com/example/qux/...)))' | grep java$

ไฟล์ที่สร้างขึ้น:

bazel query 'kind("generated file", deps(kind(".*_test rule", javatests/com/example/qux/...)))' | grep java$

ทรัพยากร Dependency ระหว่าง X และ Y แตกต่างกันอย่างไร ...

เป้าหมายใดที่ //foo ขึ้นอยู่กับ //foo:foolib นั้น

bazel query 'deps(//foo) except deps(//foo:foolib)'

การทดสอบ foo ไลบรารี C++ ใดจะขึ้นอยู่กับไบนารีที่ใช้งานจริงของ //foo ไม่ได้อ้างอิง

bazel query 'kind("cc_library", deps(kind(".*test rule", foo/...)) except deps(//foo))'

เหตุใดจึงมีทรัพยากร Dependency นี้ ...

ทำไม bar จึงต้องใช้ groups2

bazel query 'somepath(bar/...,groups2/...:*)'

เมื่อได้ผลลัพธ์ของคำค้นหานี้แล้ว คุณมักจะพบว่าเป้าหมายเดียวนั้นเห็นได้ชัดเจนว่าเป็นการขึ้นต่อกันของ bar โดยไม่คาดคิดหรือร้ายแรงและไม่พึงประสงค์ จากนั้นสามารถปรับแต่งข้อความค้นหาเพิ่มเติมเพื่อ:

แสดงเส้นทางจาก docker/updater:updater_systest (py_test) ไปยัง cc_library ที่จำเป็นต้องใช้:

bazel query 'let cc = kind(cc_library, deps(docker/updater:updater_systest)) in
  somepath(docker/updater:updater_systest, $cc)'

เหตุใดไลบรารี //photos/frontend:lib จึงต้องใช้ตัวแปร 2 ตัวของไลบรารีเดียวกัน //third_party/jpeglib และ //third_party/jpeg

คำค้นหานี้มุ่งเน้นไปที่ "แสดงกราฟย่อยของ //photos/frontend:lib ที่ขึ้นอยู่กับไลบรารีทั้ง 2 รายการ" เมื่อแสดงโดยเรียงตามลำดับโทโพโลยี องค์ประกอบสุดท้ายของผลลัพธ์ น่าจะเป็นสาเหตุของปัญหา

bazel query 'allpaths(//photos/frontend:lib, //third_party/jpeglib)
                intersect
               allpaths(//photos/frontend:lib, //third_party/jpeg)'
//photos/frontend:lib
//photos/frontend:lib_impl
//photos/frontend:lib_dispatcher
//photos/frontend:icons
//photos/frontend/modules/gadgets:gadget_icon
//photos/thumbnailer:thumbnail_lib
//third_party/jpeg/img:renderer

สิ่งที่ขึ้นอยู่กับ ...

กฎใดใต้แถบที่ขึ้นอยู่กับ Y

bazel query 'bar/... intersect allpaths(bar/..., Y)'

หมายเหตุ: X intersect allpaths(X, Y) เป็นสำนวนทั่วไปสำหรับคำค้นหา "X ไหนขึ้นอยู่กับ Y" หากนิพจน์ X ไม่ใช่ชื่อหลัก การผูกชื่อกับนิพจน์โดยใช้ let อาจสะดวกต่อการหลีกเลี่ยงการทำซ้ำ

เป้าหมายใดที่ขึ้นอยู่กับ T โดยตรงในแพ็กเกจของ T

bazel query 'same_pkg_direct_rdeps(T)'

ฉันจะหยุดทรัพยากร Dependency ได้อย่างไร ...

ฉันต้องแยกเส้นทางทรัพยากร Dependency ใดเพื่อให้ bar ไม่ใช้ X อีกต่อไป

วิธีเอาต์พุตกราฟเป็นไฟล์ svg

bazel query 'allpaths(bar/...,X)' --output graph | dot -Tsvg > /tmp/dep.svg

อื่นๆ

บิลด์ //foo-tests มีขั้นตอนตามลำดับกี่ขั้นตอน

น่าเสียดายที่ขณะนี้ภาษาในการค้นหาไม่สามารถบอกเส้นทางที่ยาวที่สุดจาก x ไป y ได้ แต่ก็สามารถหาโหนด (หรือ a) ที่อยู่ไกลที่สุดจากจุดเริ่มต้น หรือแสดงความยาวของเส้นทางที่ยาวที่สุดจาก x ไปทุก y ที่ต้องอาศัย ใช้ maxrank:

bazel query 'deps(//foo-tests)' --output maxrank | tail -1
85 //third_party/zlib:zutil.c

ผลลัพธ์ระบุว่ามีเส้นทางที่มีความยาว 85 ซึ่งต้องเกิดขึ้นตามลำดับในบิลด์นี้