Konteks aturan repositori yang berisi fungsi bantuan dan informasi tentang atribut. Anda mendapatkan objek repository_ctx sebagai argumen ke fungsi implementation
saat membuat aturan repositori.
Anggota
- attr
- hapus
- download
- download_and_extract
- eksekusi
- extract
- file
- name
- os
- patch
- path
- read
- report_progress
- symlink
- template
- yang
- workspace_root
attr
struct repository_ctx.attr
hapus
bool repository_ctx.delete(path)
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
struct repository_ctx.download(url, output='', sha256='', executable=False, allow_fail=False, canonical_id='', auth={}, *, integrity='')
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 dari string;
wajib Daftar URL mirror yang mereferensikan file yang sama. |
output
|
string; atau Label; atau path;
default adalah '' jalur ke file output, 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. Sebaiknya menghilangkan kolom ini akan membuat build Anda menjadi non-hermetik. Ini bersifat opsional untuk mempermudah pengembangan, tetapi harus ditetapkan sebelum pengiriman. |
executable
|
defaultnya adalah False menetapkan flag yang dapat dieksekusi pada file yang dibuat, salah secara default. |
allow_fail
|
defaultnya adalah False Jika ditetapkan, tunjukkan error dalam nilai yang ditampilkan, bukan menampilkan error untuk download yang gagal |
canonical_id
|
defaultnya 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. |
integrity
|
defaultnya 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. Paling tidak, menghapus kolom ini akan membuat build Anda tidak hermetis. Hal ini bersifat opsional untuk mempermudah pengembangan, tetapi harus ditetapkan sebelum pengiriman. |
download_and_extract
struct repository_ctx.download_and_extract(url, output='', sha256='', type='', stripPrefix='', allow_fail=False, canonical_id='', auth={}, *, integrity='', rename_files={})
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 dari string;
wajib Daftar URL mirror yang mereferensikan file yang sama. |
output
|
string; atau Label; atau path; default-nya adalah '' jalur ke direktori tempat arsip akan diekstrak, sesuai dengan direktori repositori. |
sha256
|
defaultnya adalah '' hash SHA-256 yang diharapkan dari file yang didownload. 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 terlebih dahulu diperiksa untuk file dengan hash yang diberikan; download hanya akan dicoba jika file tidak ditemukan di 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
|
defaultnya adalah '' awalan direktori yang akan dihapus dari file yang diekstrak. Banyak arsip berisi direktori tingkat atas 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-nya adalah False Jika ditetapkan, tunjukkan error dalam nilai yang ditampilkan, bukan menampilkan error untuk download yang gagal |
canonical_id
|
defaultnya 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. |
integrity
|
defaultnya 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. |
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. |
execute
exec_result repository_ctx.execute(arguments, timeout=600, environment={}, quiet=True, working_directory="")
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 merupakan jalur ke program yang akan dieksekusi. |
timeout
|
default adalah 600 durasi maksimum perintah dalam detik (defaultnya adalah 600 detik). |
environment
|
default adalah {} memaksa beberapa variabel lingkungan ditetapkan untuk diteruskan ke proses. |
quiet
|
defaultnya 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={})
Parameter
Parameter | Deskripsi |
---|---|
archive
|
string; atau Label; atau path;
jalur yang diperlukan ke arsip yang akan diekstrak, relatif terhadap direktori repositori. |
output
|
string; atau Label; atau path;
default adalah '' jalur ke direktori tempat arsip akan diekstrak, 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
|
defaultnya adalah {} Dikte 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. |
file
None
repository_ctx.file(path, content='', executable=True, legacy_utf8=True)
Parameter
Parameter | Deskripsi |
---|---|
path
|
string; atau Label; atau path;
wajib jalur file yang akan dibuat, relatif terhadap direktori repositori. |
content
|
defaultnya adalah '' isi file yang akan dibuat, kosong secara default. |
executable
|
defaultnya adalah True menetapkan tanda yang dapat dieksekusi pada file yang dibuat, benar secara default. |
legacy_utf8
|
defaultnya adalah True mengenkode konten file ke UTF-8, true secara default. Versi mendatang akan mengubah default dan menghapus parameter ini. |
nama
string repository_ctx.name
os
repository_os repository_ctx.os
patch
None
repository_ctx.patch(patch_file, strip=0)
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 merupakan jalur relatif, jalur tersebut akan di-resolve ke direktori repositori. |
strip
|
default adalah 0 menghapus jumlah komponen awal yang ditentukan dari nama file. |
jalur
path repository_ctx.path(path)
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)
Parameter
Parameter | Deskripsi |
---|---|
path
|
string; atau Label; atau path;
wajib jalur file yang akan dibaca. |
report_progress
None
repository_ctx.report_progress(status='')
Parameter
Parameter | Deskripsi |
---|---|
status
|
string;
defaultnya adalah string '' yang menjelaskan status progres pengambilan saat ini |
symlink
None
repository_ctx.symlink(target, link_name)
Parameter
Parameter | Deskripsi |
---|---|
target
|
string; atau Label; atau path;
required Jalur yang akan dituju oleh symlink. |
link_name
|
string; atau Label; atau path;
wajib Jalur symlink yang akan dibuat, relatif terhadap direktori repositori. |
template
None
repository_ctx.template(path, template, substitutions={}, executable=True)
template
. Setiap kemunculan kunci substitutions
di template
akan diganti dengan nilai yang sesuai. Hasilnya ditulis dalam path
. Argumenexecutable
opsional (defaultnya true) 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;
jalur yang diperlukan ke file template. |
substitutions
|
defaultnya adalah {} substitusi yang akan dibuat saat meluaskan template. |
executable
|
defaultnya adalah True menetapkan flag yang dapat dieksekusi pada file yang dibuat, true (benar) secara default. |
yang mana
path repository_ctx.which(program)
Parameter
Parameter | Deskripsi |
---|---|
program
|
required Program yang akan ditemukan di jalur. |
None
.
workspace_root
path repository_ctx.workspace_root