lewati_repositori

Laporkan masalah Lihat sumber Nightly · 7.4 . 7,3 · 7,2 · 7,1 · 7,0 · 6,5

Konteks aturan repositori yang berisi fungsi bantuan dan informasi tentang atribut. Anda mendapatkan objek repository_ctx sebagai argumen untuk fungsi implementation saat membuat aturan repositori.

Anggota

attr

struct repository_ctx.attr

Sebuah struct untuk mengakses nilai-nilai atribut. Nilai diberikan oleh pengguna (jika tidak, nilai default akan digunakan).

hapus

bool repository_ctx.delete(path)

Menghapus file atau direktori. Menampilkan bool, yang menunjukkan apakah file atau direktori benar-benar dihapus oleh panggilan ini.

Parameter

Parameter Deskripsi
path string; atau path; wajib
Jalur file yang akan dihapus, relatif terhadap direktori repositori, atau absolut. Dapat berupa jalur atau string.

download

unknown repository_ctx.download(url, output='', sha256='', executable=False, allow_fail=False, canonical_id='', auth={}, headers={}, *, integrity='', block=True)

Mendownload file ke jalur output untuk URL yang diberikan dan menampilkan struct yang berisi success, flag yang merupakan true jika download berhasil diselesaikan, dan jika berhasil, hash file dengan kolom sha256 dan integrity.

Parameter

Parameter Deskripsi
url string; atau Iterable string; wajib
Daftar URL hasil duplikasi yang merujuk pada file yang sama.
output string; atau Label; atau path; default-nya adalah ''
jalur ke file output, relatif terhadap direktori repositori.
sha256 default adalah ''
{i>hash<i} SHA-256 yang diharapkan dari file yang didownload. Hash ini harus cocok dengan hash SHA-256 file yang didownload. Menghilangkan SHA-256 karena file jarak jauh dapat berubah merupakan risiko keamanan. Sebaiknya menghilangkan kolom ini akan membuat build Anda menjadi non-hermetik. Hal ini bersifat opsional untuk mempermudah pengembangan, tetapi harus ditetapkan sebelum pengiriman.
executable default adalah False
mengatur penanda yang dapat dieksekusi pada file yang dibuat, {i>false<i} secara {i>default<i}.
allow_fail default-nya adalah False
Jika ditetapkan, tunjukkan error dalam nilai yang ditampilkan, bukan menampilkan error untuk download yang gagal
canonical_id default adalah ''
Jika ditetapkan, batasi hit cache ke kasus ketika file ditambahkan ke cache dengan ID kanonis yang sama
auth default adalah {}
Dict opsional yang menentukan informasi autentikasi untuk beberapa URL.
headers default adalah {}
Dikte opsional yang menentukan header http untuk semua URL.
integrity default adalah ''
Checksum yang diharapkan dari file yang didownload, dalam format Integritas Subresource. Ini harus cocok dengan checksum file yang didownload. Menghilangkan checksum karena file jarak jauh dapat berubah merupakan risiko keamanan. Sebaiknya menghilangkan kolom ini akan membuat build Anda menjadi non-hermetik. Ini bersifat opsional untuk mempermudah pengembangan, tetapi harus ditetapkan sebelum pengiriman.
block default adalah True
Jika ditetapkan ke false, panggilan akan segera ditampilkan dan, bukan nilai hasil reguler, akan menampilkan token dengan satu metode tunggal, wait(), yang memblokir hingga download selesai dan menampilkan nilai hasil biasa atau menampilkan seperti biasa.

download_and_extract

struct repository_ctx.download_and_extract(url, output='', sha256='', type='', stripPrefix='', allow_fail=False, canonical_id='', auth={}, headers={}, *, integrity='', rename_files={})

Mendownload file ke jalur output untuk URL yang diberikan, mengekstraknya, dan menampilkan struct yang berisi success, flag berupa true jika download berhasil diselesaikan, dan jika berhasil, hash file dengan kolom sha256 dan integrity.

Parameter

Parameter Deskripsi
url string; atau Iterable dari string; wajib
Daftar URL mirror yang mereferensikan file yang sama.
output string; atau Label; atau path; default adalah ''
jalur ke direktori tempat arsip akan diekstrak, relatif terhadap direktori repositori.
sha256 defaultnya adalah ''
hash SHA-256 yang diharapkan dari file yang didownload. Hash ini harus cocok dengan hash SHA-256 file yang didownload. Menghapus SHA-256 merupakan risiko keamanan karena file jarak jauh dapat berubah. Paling tidak, menghapus kolom ini akan membuat build Anda tidak hermetis. Ini bersifat opsional untuk mempermudah pengembangan, tetapi harus ditetapkan sebelum pengiriman. Jika disediakan, cache repositori akan diperiksa terlebih dahulu untuk menemukan file dengan hash yang diberikan; download hanya akan dicoba jika file tidak ditemukan dalam cache. Setelah berhasil didownload, file akan ditambahkan ke cache.
type default adalah ''
jenis arsip file yang didownload. Secara default, jenis arsip ditentukan dari ekstensi file URL. Jika file tidak memiliki ekstensi, Anda dapat menentukan "zip", "jar", "war", "aar", "tar", "tar.gz", "tgz", "tar.xz", "txz", ".tar.zst", ".tzst", "tar.bz2", ".tbz", ".ar", atau ".deb" secara eksplisit di sini.
stripPrefix default adalah ''
awalan direktori yang akan dihapus dari file yang diekstrak. Banyak arsip berisi direktori tingkat teratas yang berisi semua file dalam arsip. Daripada harus menentukan awalan ini berulang kali di build_file, kolom ini dapat digunakan untuk menghapusnya dari file yang diekstrak.
allow_fail default adalah False
Jika ditetapkan, tunjukkan error dalam nilai yang ditampilkan, bukan menampilkan error untuk download yang gagal
canonical_id default adalah ''
Jika ditetapkan, batasi hit cache ke kasus ketika file ditambahkan ke cache dengan ID kanonis yang sama
auth default adalah {}
Dict opsional yang menentukan informasi autentikasi untuk beberapa URL.
headers default adalah {}
Dikte opsional yang menentukan header http untuk semua URL.
integrity default adalah ''
Checksum yang diharapkan dari file yang didownload, dalam format Integritas Subresource. Ini harus cocok dengan checksum file yang didownload. Menghapus checksum merupakan risiko keamanan karena file jarak jauh dapat berubah. Sebaiknya menghilangkan kolom ini akan membuat build Anda menjadi non-hermetik. Ini bersifat opsional untuk mempermudah pengembangan, tetapi harus ditetapkan sebelum pengiriman.
rename_files default adalah {}
Dict opsional yang menentukan file yang akan diganti namanya selama ekstraksi. Entri arsip dengan nama yang sama persis dengan kunci akan diganti namanya menjadi nilai sebelum penyesuaian awalan direktori apa pun. Ini dapat digunakan untuk mengekstrak arsip yang berisi nama file non-Unicode, atau yang memiliki file yang akan diekstrak ke jalur yang sama pada sistem file yang tidak peka huruf besar/kecil.

execute

exec_result repository_ctx.execute(arguments, timeout=600, environment={}, quiet=True, working_directory="")

Menjalankan perintah yang diberikan oleh daftar argumen. Waktu eksekusi perintah dibatasi oleh timeout (dalam detik, default 600 detik). Metode ini menampilkan struktur exec_result yang berisi output perintah. Peta environment dapat digunakan untuk mengganti beberapa variabel lingkungan yang akan diteruskan ke proses.

Parameter

Parameter Deskripsi
arguments wajib
Daftar argumen, elemen pertama harus berupa jalur ke program yang akan dieksekusi.
timeout default adalah 600
durasi maksimum perintah dalam detik (default adalah 600 detik).
environment default adalah {}
memaksa beberapa variabel lingkungan diatur untuk diteruskan ke proses.
quiet default adalah True
Jika stdout dan stderr harus dicetak ke terminal.
working_directory default adalah ""
Direktori kerja untuk eksekusi perintah. Dapat bersifat relatif terhadap root repositori atau absolut.

ekstrak

None repository_ctx.extract(archive, output='', stripPrefix='', *, rename_files={}, watch_archive='auto')

Ekstrak arsip ke direktori repositori.

Parameter

Parameter Deskripsi
archive string; atau Label; atau path; wajib
jalur ke arsip yang akan dibuka, relatif terhadap direktori repositori.
output string; atau Label; atau path; default-nya adalah ''
jalur ke direktori tempat arsip akan dibongkar, relatif terhadap direktori repositori.
stripPrefix default adalah ''
awalan direktori yang akan dihapus dari file yang diekstrak. Banyak arsip berisi direktori tingkat teratas yang berisi semua file dalam arsip. Daripada harus menentukan awalan ini berulang kali di build_file, kolom ini dapat digunakan untuk menghapusnya dari file yang diekstrak.
rename_files default adalah {}
Dict opsional yang menentukan file yang akan diganti namanya selama ekstraksi. Entri arsip dengan nama yang sama persis dengan kunci akan diganti namanya menjadi nilai, sebelum penyesuaian awalan direktori. Ini dapat digunakan untuk mengekstrak arsip yang berisi nama file non-Unicode, atau yang memiliki file yang akan diekstrak ke jalur yang sama pada sistem file yang tidak peka huruf besar/kecil.
watch_archive defaultnya adalah 'auto'
apakah akan memantau file arsip. Dapat berupa string 'yes', 'no', atau 'auto'. Lulus 'ya' setara dengan segera memanggil metode watch(); memberikan jawaban 'tidak' tidak mencoba untuk melihat file; lewat 'auto' hanya akan mencoba melihat file jika hal tersebut sah untuk dilakukan (lihat dokumen watch() untuk informasi selengkapnya.

file

None repository_ctx.file(path, content='', executable=True, legacy_utf8=True)

Menghasilkan file di direktori repositori dengan konten yang disediakan.

Parameter

Parameter Deskripsi
path string; atau Label; atau path; wajib
jalur file yang akan dibuat, relatif terhadap direktori repositori.
content default adalah ''
isi file yang akan dibuat, kosong secara {i>default<i}.
executable default adalah True
mengatur penanda yang dapat dieksekusi pada file yang dibuat, {i>true<i} secara {i>default<i}.
legacy_utf8 default adalah True
mengenkode konten file ke UTF-8, true secara default. Versi mendatang akan mengubah default dan menghapus parameter ini.

getenv

string repository_ctx.getenv(name, default=None)

Menampilkan nilai variabel lingkungan name sebagai string jika ada, atau default jika tidak ada.

Saat mem-build secara bertahap, setiap perubahan pada nilai variabel yang dinamai oleh name akan menyebabkan repositori ini diambil ulang.

Parameter

Parameter Deskripsi
name string; wajib
nama variabel lingkungan yang diinginkan
default string; atau None; default adalah None
Nilai default yang akan ditampilkan jika `name` tidak ditemukan
Mungkin menampilkan None.

nama

string repository_ctx.name

Nama repositori eksternal yang dibuat oleh aturan ini.

os

repository_os repository_ctx.os

Struktur untuk mengakses informasi dari sistem.

patch

None repository_ctx.patch(patch_file, strip=0, *, watch_patch='auto')

Terapkan file patch ke direktori root repositori eksternal. File patch harus berupa file format diff terpadu standar. Implementasi {i>patch<i} asli Bazel tidak mendukung pencocokan {i>fuzz<i} dan {i>biner patch<i} seperti alat baris perintah {i>patch<i}.

Parameter

Parameter Deskripsi
patch_file string; atau Label; atau path; wajib
File patch yang akan diterapkan, dapat berupa label, jalur relatif, atau jalur absolut. Jika ini adalah jalur relatif, ini akan merujuk ke direktori repositori.
strip default adalah 0
menghilangkan sejumlah komponen utama yang ditentukan dari nama file.
watch_patch defaultnya adalah 'auto'
apakah akan memantau file patch. Dapat berupa string 'yes', 'no', atau 'auto'. Lulus 'ya' setara dengan segera memanggil metode watch(); memberikan jawaban 'tidak' tidak mencoba untuk melihat file; lewat 'auto' hanya akan mencoba melihat file jika hal tersebut sah untuk dilakukan (lihat dokumen watch() untuk informasi selengkapnya.

jalur

path repository_ctx.path(path)

Menampilkan jalur dari string, label, atau jalur. Jika jalur bersifat relatif, jalur tersebut akan di-resolve secara relatif terhadap direktori repositori. Jika jalur adalah label, jalur itu akan menjadi jalur file yang sesuai. Perhatikan bahwa repositori jarak jauh dieksekusi selama fase analisis sehingga tidak dapat bergantung pada hasil target (label harus mengarah ke file yang tidak dibuat). Jika jalur adalah jalur, ini akan mengembalikan jalur tersebut sebagaimana adanya.

Parameter

Parameter Deskripsi
path string; atau Label; atau path; wajib
string, label, atau jalur yang akan digunakan untuk membuat jalur

baca

string repository_ctx.read(path, *, watch='auto')

Membaca isi file pada sistem file.

Parameter

Parameter Deskripsi
path string; atau Label; atau path; wajib
jalur file yang akan dibaca.
watch default-nya adalah 'auto'
apakah akan memantau file. Dapat berupa string 'yes', 'no', atau 'auto'. Meneruskan 'yes' sama dengan langsung memanggil metode watch(); meneruskan 'no' tidak akan mencoba menonton file; meneruskan 'auto' hanya akan mencoba menonton file jika diizinkan (lihat dokumen watch() untuk informasi selengkapnya.

report_progress

None repository_ctx.report_progress(status='')

Memperbarui status progres untuk pengambilan ekstensi modul atau repositori ini

Parameter

Parameter Deskripsi
status string; default adalah ''
string yang menjelaskan status progres pengambilan saat ini 

None repository_ctx.symlink(target, link_name)

Membuat symlink di sistem file.

Parameter

Parameter Deskripsi
target string; atau Label; atau path; required
Jalur yang akan dituju oleh symlink.
string; atau Label; atau path; wajib
Jalur symlink yang akan dibuat.

template

None repository_ctx.template(path, template, substitutions={}, executable=True, *, watch_template='auto')

Menghasilkan file baru menggunakan template. Setiap kemunculan di template dari kunci substitutions akan diganti dengan nilai yang sesuai. Hasilnya ditulis dalam bahasa path. Argumen executable opsional (default ke benar) dapat disetel untuk mengaktifkan atau menonaktifkan bit yang dapat dieksekusi.

Parameter

Parameter Deskripsi
path string; atau Label; atau path; wajib
jalur file yang akan dibuat, relatif terhadap direktori repositori.
template string; atau Label; atau path; wajib
jalur ke file template.
substitutions default adalah {}
substitusi yang harus dibuat saat memperluas {i>template<i}.
executable default adalah True
mengatur penanda yang dapat dieksekusi pada file yang dibuat, {i>true<i} secara {i>default<i}.
watch_template defaultnya adalah 'auto'
apakah akan memantau file template. Dapat berupa string 'yes', 'no', atau 'auto'. Meneruskan 'yes' sama dengan langsung memanggil metode watch(); meneruskan 'no' tidak akan mencoba menonton file; meneruskan 'auto' hanya akan mencoba menonton file jika diizinkan (lihat dokumen watch() untuk informasi selengkapnya.

jam tangan

None repository_ctx.watch(path)

Memberi tahu Bazel untuk memantau perubahan pada jalur yang diberikan, baik jalur tersebut ada maupun tidak, atau apakah jalur tersebut berupa file atau direktori. Setiap perubahan pada file atau direktori akan membatalkan repositori atau ekstensi modul ini, dan menyebabkannya diambil ulang atau dievaluasi ulang di lain waktu.

"Perubahan" mencakup perubahan pada konten file (jika jalurnya adalah file); jika jalurnya adalah file, tetapi sekarang menjadi direktori, atau sebaliknya; dan jika jalur mulai atau berhenti ada. Secara khusus, hal ini tidak mencakup perubahan pada file apa pun pada direktori jika jalurnya adalah direktori. Untuk itu, gunakan path.readdir().

Perhatikan bahwa mencoba memantau jalur di dalam repo yang sedang diambil, atau di dalam direktori kerja ekstensi modul saat ini, akan menyebabkan error. Ekstensi modul yang mencoba mengawasi jalur di luar ruang kerja Bazel saat ini juga akan menghasilkan error.

Parameter

Parameter Deskripsi
path string; atau Label; atau path;
jalur file yang diperlukan untuk ditonton.

watch_tree

None repository_ctx.watch_tree(path)

Memberi tahu Bazel untuk mengawasi perubahan pada file atau direktori secara transitif pada jalur yang ditentukan. Setiap perubahan pada konten file, keberadaan file atau direktori, nama file atau nama direktori, akan menyebabkan repo ini diambil ulang.

Perhatikan bahwa mencoba memantau jalur di dalam repo yang sedang diambil akan mengakibatkan error.

Parameter

Parameter Deskripsi
path string; atau Label; atau path; wajib
jalur pohon direktori yang akan dipantau.

yang mana

path repository_ctx.which(program)

Menampilkan jalur program yang sesuai atau Tidak Ada jika tidak ada program semacam itu di jalur.

Parameter

Parameter Deskripsi
program required
Program yang akan ditemukan di jalur.
Mungkin menampilkan None.

workspace_root

path repository_ctx.workspace_root

Jalur ke ruang kerja root pemanggilan bazel.