ローカル リポジトリ ルール

問題を報告する ソースを表示 Nightly · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

次の関数は @bazel_tools//tools/build_defs/repo:local.bzl から読み込むことができます。

ローカル ファイル システムのディレクトリをリポジトリとして使用可能にするためのルール。

セットアップ

モジュール拡張機能でこれらのルールを使用するには、.bzl ファイルにルールを読み込んでから、拡張機能の実装関数からルールを呼び出します。たとえば、local_repository を使用するには、次のようにします。

load("@bazel_tools//tools/build_defs/repo:local.bzl", "local_repository")

def _my_extension_impl(mctx):
  local_repository(name = "foo", path = "foo")

my_extension = module_extension(implementation = _my_extension_impl)

または、use_repo_rule を使用して MODULE.bazel ファイルでこれらのリポジトリ ルールを直接呼び出すこともできます。

local_repository = use_repo_rule("@bazel_tools//tools/build_defs/repo:local.bzl", "local_repository")
local_repository(name = "foo", path = "foo")

local_repository

local_repository(name, path, repo_mapping)

Bazel ファイルがすでに含まれているローカル ディレクトリをリポジトリとして使用できるようにします。このディレクトリには、Bazel BUILD ファイルとリポジトリ境界ファイルがすでに含まれているはずです。これらのファイルが含まれていない場合は、代わりに <a href="#new_local_repository"><code>new_local_repository</code></a> の使用を検討してください。

属性

name 名前。必須

このリポジトリの一意の名前。
path 文字列。必須。

リポジトリとして使用可能にするディレクトリのパス。

パスは絶対パスにすることも、ワークスペースのルートからの相対パスにすることもできます。
repo_mapping ディクショナリ: String -> String。必須

ローカル リポジトリ名からグローバル リポジトリ名へのディクショナリ。これにより、このリポジトリの依存関係のワークスペース依存関係解決を制御できます。

たとえば、エントリ `"@foo": "@bar"` は、このリポジトリが `@foo` に依存するたびに（`@foo//some:target` への依存関係など）、グローバルに宣言された `@bar`（`@bar//some:target`）内でその依存関係を実際に解決することを宣言します。

new_local_repository

new_local_repository(name, build_file, build_file_content, path, repo_mapping)

Bazel ファイルを含まないローカル ディレクトリをリポジトリとして使用できるようにします。このディレクトリに Bazel BUILD ファイルやリポジトリ境界ファイルを含める必要はありません。これらはこのリポジトリルールによって作成されます。ディレクトリに Bazel ファイルがすでに含まれている場合は、代わりに <a href="#local_repository"><code>local_repository</code></a> の使用を検討してください。

属性

name 名前。必須

このリポジトリの一意の名前。
build_file ラベル（省略可）

このリポジトリの BUILD ファイルとして使用するファイル。

build_file と build_file_content のいずれか 1 つを指定する必要があります。

このラベルで指定されたファイルの名前は BUILD である必要はありませんが、BUILD にすることもできます。BUILD.new-repo-name のような名前を付けると、実際の BUILD ファイルと区別しやすくなります。
build_file_content 文字列。省略可

このリポジトリ用に作成される BUILD ファイルの内容。

build_file と build_file_content のいずれか 1 つを指定する必要があります。
path 文字列。必須。

リポジトリとして使用可能にするディレクトリのパス。

パスは絶対パスにすることも、ワークスペースのルートからの相対パスにすることもできます。
repo_mapping ディクショナリ: String -> String。必須

ローカル リポジトリ名からグローバル リポジトリ名へのディクショナリ。これにより、このリポジトリの依存関係のワークスペース依存関係解決を制御できます。

たとえば、エントリ `"@foo": "@bar"` は、このリポジトリが `@foo` に依存するたびに（`@foo//some:target` への依存関係など）、グローバルに宣言された `@bar`（`@bar//some:target`）内でその依存関係を実際に解決することを宣言します。