mod कमांड, Bazel 6.3.0 में जोड़ा गया था. यह कई टूल उपलब्ध कराता है, ताकि उपयोगकर्ता Bzlmod चालू होने पर, अपने बाहरी डिपेंडेंसी ग्राफ़ को समझ सके. इसकी मदद से, डिपेंडेंसी ग्राफ़ को विज़ुअलाइज़ किया जा सकता है, यह पता लगाया जा सकता है कि ग्राफ़ में कोई मॉड्यूल या मॉड्यूल का वर्शन क्यों मौजूद है, रेपो की परिभाषाएं बैकिंग मॉड्यूल देखें, मॉड्यूल एक्सटेंशन के इस्तेमाल की जांच करें, और उनसे जनरेट किए गए रेपो की जानकारी पाएं.
सिंटैक्स
bazel mod <subcommand> [<options>] [<arg> [<arg>...]]
उपलब्ध सब-कमांड और उनके ज़रूरी आर्ग्युमेंट ये हैं:
graph: यह रूट मॉड्यूल से शुरू होकर, प्रोजेक्ट का पूरा डिपेंडेंसी ग्राफ़ दिखाता है. अगर--fromमें एक या उससे ज़्यादा मॉड्यूल दिए गए हैं, तो ये मॉड्यूल सीधे रूट के नीचे दिखाए जाते हैं और ग्राफ़ को सिर्फ़ इनकी मदद से बड़ा किया जाता है (उदाहरण देखें).deps <arg>...: यहgraphकी तरह ही, हर खास मॉड्यूल की रिज़ॉल्व की गई डायरेक्ट डिपेंडेंसी दिखाता है.all_paths <arg>...: रूट से लेकर तय किए गए<arg>...तक के सभी मौजूदा पाथ दिखाता है. अगर--fromमें एक या उससे ज़्यादा मॉड्यूल तय किए गए हैं, तो ये मॉड्यूल सीधे रूट में दिखाए जाते हैं. साथ ही, ग्राफ़ में--fromमॉड्यूल से लेकर आर्ग्युमेंट मॉड्यूल तक का कोई भी मौजूदा पाथ होता है (उदाहरण देखें).path <arg>...: इसका सेमेंटेटिक्सall_pathsजैसा ही होता है. हालांकि, यह--fromमॉड्यूल में से किसी एक से, आर्ग्युमेंट मॉड्यूल में से किसी एक तक सिर्फ़ एक पाथ दिखाता है.explain <arg>...: इसमें डिपेंडेंसी ग्राफ़ में वे सभी जगहें दिखती हैं जहां तय किए गए मॉड्यूल दिखते हैं. साथ ही, वे मॉड्यूल भी दिखाए जाते हैं जो सीधे तौर पर उन पर निर्भर करते हैं.explainकमांड का आउटपुट, असल मेंall_pathsकमांड का छोटा वर्शन होता है. इसमें ये चीज़ें शामिल होती हैं: 1) रूट मॉड्यूल; 2) रूट मॉड्यूल की डायरेक्ट डिपेंडेंसी, जो आर्ग्युमेंट मॉड्यूल पर ले जाती हैं; 3) आर्ग्युमेंट मॉड्यूल की डायरेक्ट डिपेंडेंसी; और 4) आर्ग्युमेंट मॉड्यूल (उदाहरण देखें).show_repo <arg>...: यह बताता है कि किसी खास रिपॉज़िटरी में क्या है. उदाहरण देखें.show_extension <extension>...: यह टेंप्लेट, बताए गए हर एक्सटेंशन के बारे में जानकारी दिखाता है: जनरेट किए गए रिपॉज़िटरी की सूची के साथ-साथ, उन मॉड्यूल की सूची जोuse_repoका इस्तेमाल करके उन्हें इंपोर्ट करते हैं. साथ ही, यह उन सभी मॉड्यूल में उस एक्सटेंशन के इस्तेमाल की सूची दिखाता है जहां उसका इस्तेमाल किया जाता है. इसमें बताए गए टैग औरuse_repoकॉल शामिल होते हैं (उदाहरण देखें).
<arg> से एक या उससे ज़्यादा मॉड्यूल या रिपॉज़िटरी का पता चलता है. यह इनमें से कोई एक हो सकता है:
लिटरल स्ट्रिंग
<root>: यह आपके मौजूदा प्रोजेक्ट को दिखाने वाला रूट मॉड्यूल है.<name>@<version>: मॉड्यूल<name>का वर्शन<version>. ऐसे मॉड्यूल के लिए जिसमें रजिस्ट्री बदलाव नहीं किया गया है,<version>के तौर पर अंडरस्कोर (_) का इस्तेमाल करें.<name>:<name>मॉड्यूल के सभी मौजूदा वर्शन.@<repo_name>:--base_moduleके संदर्भ में, साफ़ तौर पर दिखने वाला नाम वाला रिपॉज़िटरी.@@<repo_name>: वह रिपॉज़िटरी जिसका कैननिकल नाम दिया गया है.
अगर किसी कॉन्टेक्स्ट में मॉड्यूल की जानकारी देनी है, तो मॉड्यूल से जुड़े रीपो के रेफ़रंस के तौर पर <arg> का इस्तेमाल भी किया जा सकता है. यह रेफ़रंस, एक्सटेंशन से जनरेट किए गए रीपो के रेफ़रंस के बजाय होता है. वहीं, अगर मामले में रेपो की जानकारी देना ज़रूरी है, तो मॉड्यूल के बारे में बताने वाले <arg> उसी तरह के रेपो के लिए काम कर सकते हैं.
<extension>, <arg><label_to_bzl_file>%<extension_name> फ़ॉर्मैट में होना चाहिए.
<label_to_bzl_file> वाला हिस्सा, रिपो-रिलेटिव लेबल होना चाहिए (उदाहरण के लिए,
//pkg/path:file.bzl).
नीचे दिए गए विकल्प, सिर्फ़ उन सब-कमांड पर असर डालते हैं जो ग्राफ़ प्रिंट करते हैं (graph,
deps, all_paths, path, और explain):
--from <arg>[,<arg>[,...]]डिफ़ॉल्ट:<root>: वह मॉड्यूल जिससे ग्राफ़ कोgraph,all_paths,path, औरexplainमें बड़ा किया जाता है. ज़्यादा जानकारी के लिए, सब-कमांड के ब्यौरे देखें.--verboseडिफ़ॉल्ट: "गलत": आउटपुट ग्राफ़ में, हर मॉड्यूल के वर्शन रिज़ॉल्यूशन के बारे में ज़्यादा जानकारी शामिल करें. अगर रिज़ॉल्यूशन के दौरान मॉड्यूल का वर्शन बदला है, तो दिखाएं कि इसे किस वर्शन से बदला गया है या मूल वर्शन क्या था, इसकी वजह क्या थी, और अगर वजह कम से कम वर्शन चुनना था, तो कौनसे मॉड्यूल ने नए वर्शन के लिए अनुरोध किया.--include_unusedडिफ़ॉल्ट: "गलत": आउटपुट ग्राफ़ में वे मॉड्यूल शामिल करें जो मूल रूप से डिपेंडेंसी ग्राफ़ में मौजूद थे, लेकिन मॉड्यूल रिज़ॉल्यूशन के बाद उनका इस्तेमाल नहीं किया गया.--extension_info <mode>: आउटपुट ग्राफ़ में, मॉड्यूल एक्सटेंशन के इस्तेमाल के बारे में जानकारी शामिल करें (उदाहरण देखें).<mode>इनमें से कोई एक हो सकता है:hidden(डिफ़ॉल्ट): एक्सटेंशन के बारे में कुछ भी न दिखाएं.usages: हर मॉड्यूल के नीचे एक्सटेंशन दिखाएं जहां उनका इस्तेमाल किया जाता है. इन्हें$<extension>के तौर पर प्रिंट किया जाता है.repos:usagesके अलावा, हर एक्सटेंशन के इस्तेमाल के नीचे,use_repoका इस्तेमाल करके इंपोर्ट किया गया रिपॉज़िटरी दिखाएं.all:usagesऔरreposके अलावा, एक्सटेंशन से जनरेट किए गए ऐसे रिपॉज़िटरी भी दिखाएं जिन्हें किसी मॉड्यूल से इंपोर्ट नहीं किया गया है. ये अतिरिक्त रिपॉज़िटरी, आउटपुट में एक्सटेंशन जनरेट होने की पहली शुरुआत में दिखाए जाते हैं. साथ ही, इन्हें बिंदु वाले किनारे से जोड़ा जाता है.
--extension_filter <extension>[,<extension>[,...]]: अगर यह एट्रिब्यूट तय किया गया है, तो आउटपुट ग्राफ़ में सिर्फ़ वे मॉड्यूल शामिल होंगे जो तय किए गए एक्सटेंशन का इस्तेमाल करते हैं. साथ ही, उन मॉड्यूल पर ले जाने वाले पाथ भी शामिल होंगे.--extension_filter=में बताई गई तरह से, एक्सटेंशन की खाली सूची देना, डिपेंडेंसी ग्राफ़ में किसी भी मॉड्यूल के इस्तेमाल किए गए सभी एक्सटेंशन की जानकारी देने के बराबर है.--depth <N>: आउटपुट ग्राफ़ की डेप्थ. 1 की डेप्थ सिर्फ़ रूट और उसकी डायरेक्ट डिपेंडेंसी दिखाती है. डिफ़ॉल्ट रूप से,explainके लिए 1,depsके लिए 2 और अन्य के लिए अनंत होता है.--cyclesडिफ़ॉल्ट: "गलत": आउटपुट ग्राफ़ में साइकल के किनारों को शामिल करें.--include_builtinडिफ़ॉल्ट: "गलत": आउटपुट ग्राफ़ में, पहले से मौजूद मॉड्यूल (जैसे कि@bazel_tools) शामिल करें. यह फ़्लैग डिफ़ॉल्ट रूप से बंद होता है, क्योंकि पहले से मौजूद मॉड्यूल, हर दूसरे मॉड्यूल पर निर्भर होते हैं. इससे आउटपुट बहुत ही गड़बड़ा हो जाता है.--charset <charset>डिफ़ॉल्ट: utf8: टेक्स्ट आउटपुट के लिए इस्तेमाल किए जाने वाले charset की जानकारी दें. मान्य वैल्यू"utf8"और"ascii"हैं."text"आउटपुट फ़ॉर्मैट में ग्राफ़ को ड्रॉ करने के लिए इस्तेमाल किए गए खास वर्णों में ही काफ़ी फ़र्क़ है. ये वर्ण"ascii"चेरसेट में मौजूद नहीं हैं. इसलिए,"ascii"charset मौजूद है, ताकि उन लेगसी प्लैटफ़ॉर्म पर भी इसका इस्तेमाल किया जा सके जो यूनिकोड का इस्तेमाल नहीं कर सकते.--output <mode>: आउटपुट ग्राफ़ के हिस्से के तौर पर, मॉड्यूल एक्सटेंशन के इस्तेमाल के बारे में जानकारी शामिल करें.<mode> इनमें से कोई एक हो सकता है:text(डिफ़ॉल्ट): आउटपुट ग्राफ़ का ऐसा वर्शन जिसे कोई भी व्यक्ति पढ़ सकता है (ट्री के तौर पर फ़्लैट किया गया).json: यह ग्राफ़ को JSON ऑब्जेक्ट (पेड़ के तौर पर फ़्लैट किए गए) के तौर पर दिखाता है.graph: ग्राफ़ को Graphviz dot फ़ॉर्मैट में दिखाता है.
bazel mod graph --output graph | dot -Tsvg > /tmp/graph.svg
दूसरे विकल्पों में ये शामिल हैं:
--base_module <arg>डिफ़ॉल्ट:<root>: वह मॉड्यूल बताएं जिसके आधार पर, आर्ग्युमेंट में मौजूद रिपॉज़िटरी के नामों का विश्लेषण किया जाता है. ध्यान दें कि यह तर्क@<repo_name>के रूप में हो सकता है. इसका मतलब, हमेशा रूट मॉड्यूल के हिसाब से किया जाता है.--extension_usages <arg>[,<arg>[,...]]:show_extensionफ़िल्टर, सिर्फ़ तय किए गए मॉड्यूल से एक्सटेंशन के इस्तेमाल को दिखाता है.
उदाहरण
यहां किसी असल Bazel प्रोजेक्ट पर mod कमांड के इस्तेमाल के कुछ उदाहरण दिए गए हैं. इससे आपको यह पता चलेगा कि अपने प्रोजेक्ट की बाहरी डिपेंडेंसी की जांच करने के लिए, इसका इस्तेमाल कैसे किया जा सकता है.
MODULE.bazel फ़ाइल:
module(
name = "my_project",
version = "1.0",
)
bazel_dep(name = "bazel_skylib", version = "1.1.1", repo_name = "skylib1")
bazel_dep(name = "bazel_skylib", version = "1.2.0", repo_name = "skylib2")
multiple_version_override(module_name = "bazel_skylib", versions = ["1.1.1", "1.2.0"])
bazel_dep(name = "stardoc", version = "0.5.0")
bazel_dep(name = "rules_java", version = "5.0.0")
toolchains = use_extension("@rules_java//java:extensions.bzl", "toolchains")
use_repo(toolchains, my_jdk="remotejdk17_linux")
|
|
अपने प्रोजेक्ट का पूरा डिपेंडेंसी ग्राफ़ दिखाएं.
bazel mod graph<root> (my_project@1.0) ├───bazel_skylib@1.1.1 │ └───platforms@0.0.4 ├───bazel_skylib@1.2.0 │ └───platforms@0.0.4 ... ├───rules_java@5.0.0 │ ├───platforms@0.0.4 ... │ ├───rules_cc@0.0.1 │ │ ├───bazel_skylib@1.1.1 ... │ │ └───platforms@0.0.4 ... │ └───rules_proto@4.0.0 │ ├───bazel_skylib@1.1.1 ... │ └───rules_cc@0.0.1 ... └───stardoc@0.5.0 ├───bazel_skylib@1.1.1 ... └───rules_java@5.0.0 ...डिपेंडेंसी का पूरा ग्राफ़ दिखाएं (इसमें इस्तेमाल नहीं किए गए मॉड्यूल और वर्शन के रिज़ॉल्यूशन के बारे में ज़्यादा जानकारी शामिल है).
bazel mod graph --include_unused --verbose<root> (my_project@1.0) ├───bazel_skylib@1.1.1 │ └───platforms@0.0.4 ├───bazel_skylib@1.2.0 │ └───platforms@0.0.4 ... ├───rules_java@5.0.0 │ ├───platforms@0.0.4 ... │ ├───rules_cc@0.0.1 │ │ ├───bazel_skylib@1.0.3 ... (to 1.1.1, cause multiple_version_override) │ │ ├───bazel_skylib@1.1.1 ... (was 1.0.3, cause multiple_version_override) │ │ └───platforms@0.0.4 ... │ └───rules_proto@4.0.0 │ ├───bazel_skylib@1.0.3 ... (to 1.1.1, cause multiple_version_override) │ ├───bazel_skylib@1.1.1 ... (was 1.0.3, cause multiple_version_override) │ └───rules_cc@0.0.1 ... └───stardoc@0.5.0 ├───bazel_skylib@1.1.1 ... (was 1.0.3, cause multiple_version_override) ├───rules_java@5.0.0 ... (was 4.0.0, cause <root>, bazel_tools@_) ├───bazel_skylib@1.0.3 (to 1.1.1, cause multiple_version_override) │ └───platforms@0.0.4 ... └───rules_java@4.0.0 (to 5.0.0, cause <root>, bazel_tools@_) ├───bazel_skylib@1.0.3 ... (to 1.1.1, cause multiple_version_override) └───bazel_skylib@1.1.1 ... (was 1.0.3, cause multiple_version_override)कुछ खास मॉड्यूल से बड़ा किया गया डिपेंडेंसी ग्राफ़ दिखाएं.
bazel mod graph --from rules_java --include_unused<root> (my_project@1.0) ├───rules_java@5.0.0 │ ├───platforms@0.0.4 │ ├───rules_cc@0.0.1 │ │ ├───bazel_skylib@1.0.3 ... (unused) │ │ ├───bazel_skylib@1.1.1 ... │ │ └───platforms@0.0.4 ... │ └───rules_proto@4.0.0 │ ├───bazel_skylib@1.0.3 ... (unused) │ ├───bazel_skylib@1.1.1 ... │ └───rules_cc@0.0.1 ... └╌╌rules_java@4.0.0 (unused) ├───bazel_skylib@1.0.3 (unused) │ └───platforms@0.0.4 ... └───bazel_skylib@1.1.1 └───platforms@0.0.4 ...अपने दो मॉड्यूल के बीच के सभी पाथ दिखाएं.
bazel mod all_paths bazel_skylib@1.1.1 --from rules_proto<root> (my_project@1.0) └╌╌rules_proto@4.0.0 ├───bazel_skylib@1.1.1 └───rules_cc@0.0.1 └───bazel_skylib@1.1.1 ...देखें कि आपका प्रोजेक्ट, कुछ मॉड्यूल पर क्यों और कैसे निर्भर करता है.
bazel mod explain @skylib1 --verbose --include_unused<root> (my_project@1.0) ├───bazel_skylib@1.1.1 ├───rules_java@5.0.0 │ ├───rules_cc@0.0.1 │ │ └───bazel_skylib@1.1.1 ... (was 1.0.3, cause multiple_version_override) │ └───rules_proto@4.0.0 │ ├───bazel_skylib@1.1.1 ... (was 1.0.3, cause multiple_version_override) │ └───rules_cc@0.0.1 ... └───stardoc@0.5.0 ├───bazel_skylib@1.1.1 ... (was 1.0.3, cause multiple_version_override) ├╌╌rules_cc@0.0.1 │ └───bazel_skylib@1.1.1 ... (was 1.0.3, cause multiple_version_override) └╌╌rules_proto@4.0.0 ├───bazel_skylib@1.1.1 ... (was 1.0.3, cause multiple_version_override) └───rules_cc@0.0.1 ...अपने कुछ मॉड्यूल के रिपोज़ का बुनियादी नियम देखें.
bazel mod show_repo rules_cc stardoc## rules_cc@0.0.1: # <builtin> http_archive( name = "rules_cc~", urls = ["https://bcr.bazel.build/test-mirror/github.com/bazelbuild/rules_cc/releases/download/0.0.1/rules_cc-0.0.1.tar.gz", "https://github.com/bazelbuild/rules_cc/releases/download/0.0.1/rules_cc-0.0.1.tar.gz"], integrity = "sha256-Tcy/0iwN7xZMj0dFi9UODHFI89kgAs20WcKpamhJgkE=", strip_prefix = "", remote_patches = {"https://bcr.bazel.build/modules/rules_cc/0.0.1/patches/add_module_extension.patch": "sha256-g3+zmGs0YT2HKOVevZpN0Jet89Ylw90Cp9XsIAY8QqU="}, remote_patch_strip = 1, ) # Rule http_archive defined at (most recent call last): # /home/user/.cache/bazel/_bazel_user/6e893e0f5a92cc4cf5909a6e4b2770f9/external/bazel_tools/tools/build_defs/repo/http.bzl:355:31 in <toplevel> ## stardoc: # <builtin> http_archive( name = "stardoc~", urls = ["https://bcr.bazel.build/test-mirror/github.com/bazelbuild/stardoc/releases/download/0.5.0/stardoc-0.5.0.tar.gz", "https://github.com/bazelbuild/stardoc/releases/download/0.5.0/stardoc-0.5.0.tar.gz"], integrity = "sha256-yXlNzIAmow/2fPfPkeviRcopSyCwcYRdEsGSr+JDrXI=", strip_prefix = "", remote_patches = {}, remote_patch_strip = 0, ) # Rule http_archive defined at (most recent call last): # /home/user/.cache/bazel/_bazel_user/6e893e0f5a92cc4cf5909a6e4b2770f9/external/bazel_tools/tools/build_defs/repo/http.bzl:355:31 in <toplevel>देखें कि आपके डिपेंडेंसी ग्राफ़ में किन मॉड्यूल एक्सटेंशन का इस्तेमाल किया गया है.
bazel mod graph --extension_info=usages --extension_filter=all<root> (my_project@1.0) ├───$@@rules_java.5.0.0//java:extensions.bzl%toolchains ├───rules_java@5.0.0 # │ ├───$@@rules_java.5.0.0//java:extensions.bzl%toolchains │ ├───rules_cc@0.0.1 # │ │ └───$@@rules_cc.0.0.1//bzlmod:extensions.bzl%cc_configure │ └───rules_proto@4.0.0 │ └───rules_cc@0.0.1 ... └───stardoc@0.5.0 └───rules_java@5.0.0 ...देखें कि डिपेंडेंसी ग्राफ़ के हिस्से के तौर पर, किसी खास एक्सटेंशन से कौनसी रिपॉज़िटरी जनरेट और इंपोर्ट की गई हैं.
bazel mod show_extension @@rules_java~5.0.0//java:extensions.bzl%toolchains<root> (my_project@1.0) ├───$@@rules_java.5.0.0//java:extensions.bzl%toolchains │ ├───remotejdk17_linux │ ├╌╌remotejdk11_linux │ ├╌╌remotejdk11_linux_aarch64 │ ├╌╌remotejdk11_linux_ppc64le │ ├╌╌remotejdk11_linux_s390x ...(some lines omitted)... ├───rules_java@5.0.0 # │ └───$@@rules_java.5.0.0//java:extensions.bzl%toolchains ... │ ├───local_jdk │ ├───remote_java_tools │ ├───remote_java_tools_darwin │ ├───remote_java_tools_linux │ ├───remote_java_tools_windows │ ├───remotejdk11_linux_aarch64_toolchain_config_repo │ ├───remotejdk11_linux_ppc64le_toolchain_config_repo ...(some lines omitted)... └───stardoc@0.5.0 └───rules_java@5.0.0 ...किसी एक्सटेंशन के जनरेट किए गए डेटा स्टोर की सूची देखें. साथ ही, यह भी देखें कि हर मॉड्यूल में उस एक्सटेंशन का इस्तेमाल कैसे किया जाता है.
bazel mod graph --extension_info=all --extension_filter=@rules_java//java:extensions.bzl%toolchains## @@rules_java.5.0.0//java:extensions.bzl%toolchains: Fetched repositories: - local_jdk (imported by bazel_tools@_, rules_java@5.0.0) - remote_java_tools (imported by bazel_tools@_, rules_java@5.0.0) - remote_java_tools_darwin (imported by bazel_tools@_, rules_java@5.0.0) - remote_java_tools_linux (imported by bazel_tools@_, rules_java@5.0.0) - remote_java_tools_windows (imported by bazel_tools@_, rules_java@5.0.0) - remotejdk11_linux_aarch64_toolchain_config_repo (imported by rules_java@5.0.0) - remotejdk11_linux_ppc64le_toolchain_config_repo (imported by rules_java@5.0.0) ...(some lines omitted)... - remotejdk17_linux (imported by <root>) - remotejdk11_linux - remotejdk11_linux_aarch64 - remotejdk11_linux_ppc64le - remotejdk11_linux_s390x - remotejdk11_macos ...(some lines omitted)... # Usage in <root> at <root>/MODULE.bazel:14:27 with the specified attributes: use_repo( toolchains, my_jdk="remotejdk17_linux", ) # Usage in bazel_tools@_ at bazel_tools@_/MODULE.bazel:23:32 with the specified attributes: use_repo( toolchains, "local_jdk", "remote_java_tools", "remote_java_tools_linux", "remote_java_tools_windows", "remote_java_tools_darwin", ) # Usage in rules_java@5.0.0 at rules_java@5.0.0/MODULE.bazel:30:27 with the specified attributes: use_repo( toolchains, "remote_java_tools", "remote_java_tools_linux", "remote_java_tools_windows", "remote_java_tools_darwin", "local_jdk", "remotejdk11_linux_toolchain_config_repo", "remotejdk11_macos_toolchain_config_repo", "remotejdk11_macos_aarch64_toolchain_config_repo", ...(some lines omitted)... )एक्सटेंशन जनरेट करने वाले कुछ डेटा स्टोर करने की जगहों का बुनियादी नियम देखें.
bazel mod show_repo --base_module=rules_java @remote_java_tools## @remote_java_tools: # <builtin> http_archive( name = "rules_java~~toolchains~remote_java_tools", urls = ["https://mirror.bazel.build/bazel_java_tools/releases/java/v11.5/java_tools-v11.5.zip", "https://github.com/bazelbuild/java_tools/releases/download/java_v11.5/java_tools-v11.5.zip"], sha256 = "b763ee80e5754e593fd6d5be6d7343f905bc8b73d661d36d842b024ca11b6793", ) # Rule http_archive defined at (most recent call last): # /home/user/.cache/bazel/_bazel_user/6e893e0f5a92cc4cf5909a6e4b2770f9/external/bazel_tools/tools/build_defs/repo/http.bzl:355:31 in <toplevel>