implementation
saat membuat ekstensi modul.
Anggota
- download
- download_and_extract
- execute
- extension_metadata
- file
- is_dev_dependency
- module
- os
- path
- baca
- report_progress
- root_module_has_non_dev_dependency
- yang
download
struct module_ctx.download(url, output='', sha256='', executable=False, allow_fail=False, canonical_id='', auth={}, *, integrity='')Mendownload file ke jalur output untuk URL yang diberikan dan menampilkan struct yang berisi
success
, tanda berupa 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 duplikat yang merujuk pada file yang sama. |
output
|
string; atau Label; atau path; defaultnya adalah '' jalur ke file output, relatif terhadap direktori repositori. |
sha256
|
defaultnya adalah '' hash SHA-256 yang diharapkan dari file yang didownload. 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
|
defaultnya adalah False menetapkan flag yang dapat dieksekusi pada file yang dibuat, dan menjadi false 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
|
Defaultnya adalah {} Dikte 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. Hal ini bersifat opsional untuk mempermudah pengembangan, tetapi harus ditetapkan sebelum pengiriman. |
download_and_extract
struct module_ctx.download_and_extract(url, output='', sha256='', type='', stripPrefix='', allow_fail=False, canonical_id='', auth={}, *, 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 string;
wajib Daftar URL duplikat yang merujuk pada 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. 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. 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 download berhasil, file akan ditambahkan ke cache. |
type
|
defaultnya adalah '' jenis arsip file yang didownload. Secara default, jenis arsip ditentukan dari ekstensi file URL. Jika file tidak memiliki ekstensi, Anda dapat secara eksplisit menentukan "zip", "jar", "war", "aar", "tar", "tar.gz", "tgz", "tar.xz", "txz", ".tar.zst", ".tzst", "tar.bz2", ".tbz", ".ar", atau ".deb" 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
|
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
|
Defaultnya adalah {} Dikte 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. Hal ini bersifat opsional untuk mempermudah pengembangan, tetapi harus ditetapkan sebelum pengiriman. |
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. |
execute
exec_result module_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 merupakan jalur ke program yang akan dieksekusi. |
timeout
|
default-nya adalah 600 durasi maksimum perintah dalam detik (defaultnya adalah 600 detik). |
environment
|
defaultnya adalah {} memaksa beberapa variabel lingkungan ditetapkan untuk diteruskan ke proses. |
quiet
|
defaultnya adalah True Jika stdout dan stderr harus dicetak ke terminal. |
working_directory
|
defaultnya adalah "" Direktori kerja untuk eksekusi perintah. Dapat relatif terhadap root repositori atau absolut. |
extension_metadata
extension_metadata module_ctx.extension_metadata(root_module_direct_deps=None, root_module_direct_dev_deps=None)Membuat objek buram yang dapat ditampilkan dari fungsi implementasi ekstensi modul untuk menyediakan metadata tentang repositori yang dihasilkan oleh ekstensi ke Bazel.
Parameter
Parameter | Deskripsi |
---|---|
root_module_direct_deps
|
Urutan string; atau string; atau None ;
defaultnya adalah None Nama repositori yang dianggap ekstensi sebagai dependensi langsung dari modul root. Jika modul root mengimpor repositori tambahan atau tidak mengimpor semua repositori ini melalui use_repo , Bazel akan mencetak peringatan dan perintah perbaikan saat ekstensi dievaluasi.Jika salah satu dari Salah satu dari |
root_module_direct_dev_deps
|
Urutan string; atau string; atau None ;
default-nya adalah None Nama repositori yang dianggap ekstensi sebagai dependensi dev langsung dari modul root. Jika modul root mengimpor repositori tambahan atau tidak mengimpor semua repositori ini melalui use_repo pada proxy ekstensi yang dibuat dengan use_extension(..., dev_dependency = True) , Bazel akan mencetak peringatan dan perintah perbaikan saat ekstensi dievaluasi.Jika salah satu dari Salah satu dari |
file
None
module_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;
diperlukan jalur file yang akan dibuat, relatif terhadap direktori repositori. |
content
|
defaultnya adalah '' konten file yang akan dibuat, kosong secara default. |
executable
|
defaultnya adalah True menetapkan flag yang dapat dieksekusi pada file yang dibuat, true (benar) secara default. |
legacy_utf8
|
default-nya adalah True mengenkode konten file ke UTF-8, benar secara default. Versi mendatang akan mengubah default dan menghapus parameter ini. |
is_dev_dependency
bool module_ctx.is_dev_dependency(tag)Menampilkan apakah tag yang ditentukan ditentukan pada hasil panggilan use_extension dengan
devDependency = True
.
Parameter
Parameter | Deskripsi |
---|---|
tag
|
bazel_module_tag;
wajib Tag yang diperoleh dari bazel_module.tags. |
modul
list module_ctx.modulesDaftar semua modul Bazel dalam grafik dependensi eksternal yang menggunakan ekstensi modul ini, yang masing-masing merupakan objek bazel_module yang mengekspos semua tag yang ditentukan untuk ekstensi ini. Urutan iterasi kamus ini dijamin akan sama dengan penelusuran luas-pertama yang dimulai dari modul root.
os
repository_os module_ctx.osSebuah struct untuk mengakses informasi dari sistem.
jalur
path module_ctx.path(path)Menampilkan jalur dari string, label, atau jalur. Jika jalur bersifat relatif, jalur tersebut akan diselesaikan secara relatif terhadap direktori repositori. Jika jalur adalah label, jalur itu akan menjadi jalur file yang sesuai. Perlu diperhatikan bahwa repositori jarak jauh dijalankan selama fase analisis sehingga tidak dapat bergantung pada hasil target (label harus mengarah ke file yang tidak dihasilkan). Jika jalur berupa jalur, jalur tersebut akan menampilkan jalur tersebut apa adanya.
Parameter
Parameter | Deskripsi |
---|---|
path
|
string; atau Label; atau path; wajib string, label, atau jalur yang digunakan untuk membuat jalur |
read
string module_ctx.read(path)Membaca isi file pada sistem file.
Parameter
Parameter | Deskripsi |
---|---|
path
|
string; atau Label; atau path;
wajib jalur file yang akan dibaca. |
report_progress
None
module_ctx.report_progress(status='')
Memperbarui status progres untuk pengambilan repositori atau ekstensi modul ini
Parameter
Parameter | Deskripsi |
---|---|
status
|
string;
defaultnya adalah string '' yang menjelaskan status progres pengambilan saat ini |
root_module_has_non_dev_dependency
bool module_ctx.root_module_has_non_dev_dependencyApakah modul root menggunakan ekstensi ini sebagai dependensi non-dev.
yang mana
path module_ctx.which(program)Menampilkan jalur program yang sesuai atau Tidak ada jika tidak ada program semacam itu di jalur.
Parameter
Parameter | Deskripsi |
---|---|
program
|
diperlukan Program untuk ditemukan di jalur. |
None
.