implementation
işlevinin bağımsız değişkeni olarak bir modül_ctx nesnesi alırsınız.
Üyeler
- indirin
- download_and_extract
- yürütme
- extension_metadata
- dosya
- is_dev_dependency
- is_isolated
- modül
- işletim sistemi
- path
- oku
- report_progress
- root_module_has_non_dev_dependency
- hangi
indirme
struct module_ctx.download(url, output='', sha256='', executable=False, allow_fail=False, canonical_id='', auth={}, *, integrity='')
success
öğesini içeren bir struct döndürür. Bu işaret, indirme işlemi başarıyla tamamlandıysa true
ve başarılıysa sha256
ile integrity
alanlarını içeren karma bir dosyadır.
Parametreler
Parametre | Açıklama |
---|---|
url
|
string; or Iterable of strings ;
gerekliAynı dosyaya referansta bulunan yansıtma URL'lerinin listesi. |
output
|
string; or Label; or path ;
varsayılan = ''yolunu işaret eder. |
sha256
|
varsayılan = '' İndirilen dosyanın beklenen SHA-256 karma değeri. Bu değer, indirilen dosyanın SHA-256 karmasıyla eşleşmelidir. Uzak dosyalar değişebileceğinden SHA-256'nın atlanması güvenlik riski oluşturur. Bu alanı atlamak, derlemenizi hermetik hale getirmez. Geliştirmeyi kolaylaştırmak isteğe bağlıdır ancak gönderimden önce ayarlanmalıdır. |
executable
|
varsayılan = Yanlış oluşturulan dosyada yürütülebilir bayrağı varsayılan olarak false (yanlış) değerine ayarlayın. |
allow_fail
|
varsayılan = Yanlış Ayarlanırsa, başarısız indirmeler için hata mesajı iletmek yerine döndürülen değerde hatayı belirtin |
canonical_id
|
varsayılan = '' Ayarlanırsa önbellek isabetlerini, dosyanın önbelleğe aynı standart kimlikle eklendiği durumlarla sınırlandırın |
auth
|
default = {} Bazı URL'lerin kimlik doğrulama bilgilerini belirten isteğe bağlı bir metin. |
integrity
|
varsayılan = '' İndirilen dosyanın, Alt Kaynak Bütünlüğü biçiminde beklenen sağlama toplamı. Bu değer, indirilen dosyanın sağlama toplamıyla eşleşmelidir. Uzak dosyalar değişebileceği için sağlama toplamının atlanması güvenlik riski oluşturur. Bu alanı atlamak, derlemenizi hermetik hale getirmez. Geliştirmeyi kolaylaştırmak isteğe bağlıdır ancak gönderimden önce ayarlanmalıdır. |
download_and_extract
struct module_ctx.download_and_extract(url, output='', sha256='', type='', stripPrefix='', allow_fail=False, canonical_id='', auth={}, *, integrity='', rename_files={})
success
içeren bir struct'ı döndürür. Bu işaret, indirme işlemi başarıyla tamamlandıysa true
ve başarılıysa sha256
ile integrity
alanlarında dosyanın karmasını oluşturur.
Parametreler
Parametre | Açıklama |
---|---|
url
|
string; or Iterable of strings ;
gerekliAynı dosyaya referansta bulunan yansıtma URL'lerinin listesi. |
output
|
string; or Label; or path ;
varsayılan = ''arşivin paketten çıkarılacağı dizine giden yol. |
sha256
|
varsayılan = '' İndirilen dosyanın beklenen SHA-256 karma değeri. Bu değer, indirilen dosyanın SHA-256 karmasıyla eşleşmelidir. Uzak dosyalar değişebileceğinden SHA-256'nın atlanması güvenlik riski oluşturur. Bu alanı atlamak, derlemenizi hermetik hale getirmez. Geliştirmeyi kolaylaştırmak isteğe bağlıdır ancak gönderimden önce ayarlanmalıdır. Kod deposu önbelleği, sağlanırsa öncelikle verilen karmaya sahip bir dosya için kontrol edilir. İndirme işlemi yalnızca dosya önbellekte bulunmazsa denenir. İndirme işlemi başarılı olduktan sonra dosya önbelleğe eklenir. |
type
|
varsayılan = '' indirilen dosyanın arşiv türü. Varsayılan olarak, arşiv türü URL'nin dosya uzantısına göre belirlenir. Dosyanın uzantısı yoksa, "zip", "jar", "war", "aar", "tar", "tar.gz", "tgz", "tar.xz", "txz", ".tar.zst", ".tzst", "tar.bz2", ".ar" veya ".deb" öğesini belirtebilirsiniz. burayı tıklayın. |
stripPrefix
|
varsayılan = '' ayıklanmış dosyalardan ayırmak için bir dizin öneki. Birçok arşiv, arşivdeki tüm dosyaları içeren üst düzey bir dizin içerir. Bu ön eki build_file içinde tekrar tekrar belirtmek yerine bu alan, ayıklanan dosyalardan onu ayırmak için kullanılabilir.
|
allow_fail
|
varsayılan = Yanlış Ayarlanırsa, başarısız indirmeler için hata mesajı iletmek yerine döndürülen değerde hatayı belirtin |
canonical_id
|
varsayılan = '' Ayarlanırsa önbellek isabetlerini, dosyanın önbelleğe aynı standart kimlikle eklendiği durumlarla sınırlandırın |
auth
|
default = {} Bazı URL'lerin kimlik doğrulama bilgilerini belirten isteğe bağlı bir metin. |
integrity
|
varsayılan = '' İndirilen dosyanın, Alt Kaynak Bütünlüğü biçiminde beklenen sağlama toplamı. Bu değer, indirilen dosyanın sağlama toplamıyla eşleşmelidir. Uzak dosyalar değişebileceği için sağlama toplamının atlanması güvenlik riski oluşturur. Bu alanı atlamak, derlemenizi hermetik hale getirmez. Geliştirmeyi kolaylaştırmak isteğe bağlıdır ancak gönderimden önce ayarlanmalıdır. |
rename_files
|
default = {} Ayıklama sırasında yeniden adlandırılacak dosyaları belirten isteğe bağlı bir dikt. Bir anahtarla tam olarak eşleşen adlara sahip arşiv girişleri, herhangi bir dizin öneki ayarlamasından önce değer olarak yeniden adlandırılır. Bu komut, Unicode olmayan dosya adları veya büyük/küçük harfe duyarlı olmayan dosya sistemlerinde aynı yola çıkarılacak dosyalara sahip arşivleri ayıklamak için kullanılabilir. |
execute
exec_result module_ctx.execute(arguments, timeout=600, environment={}, quiet=True, working_directory="")
timeout
ile sınırlıdır (saniye cinsinden, varsayılan 600 saniye). Bu yöntem, komut çıkışını içeren bir exec_result
yapısı döndürür. environment
eşlemesi, işleme iletilecek bazı ortam değişkenlerini geçersiz kılmak için kullanılabilir.
Parametreler
Parametre | Açıklama |
---|---|
arguments
|
zorunlu Bağımsız değişkenler listesi, ilk öğe yürütülecek programa giden yol olmalıdır. |
timeout
|
varsayılan = 600 komutun saniye cinsinden maksimum süresi (varsayılan değer 600 saniyedir). |
environment
|
default = {} işleme tabi tutulması için bazı ortam değişkenlerinin ayarlanmasını zorunlu kılar. |
quiet
|
varsayılan = Doğru stdout ve stderr'in terminale yazdırılması gerekiyorsa. |
working_directory
|
varsayılan = "" Komut yürütme için çalışma dizini. Depo kökü veya mutlak ile göreli olabilir. |
extension_metadata
extension_metadata module_ctx.extension_metadata(root_module_direct_deps=None, root_module_direct_dev_deps=None)
Parametreler
Parametre | Açıklama |
---|---|
root_module_direct_deps
|
sequence of strings; or string; or None ;
varsayılan = YokUzantının, kök modülün doğrudan bağımlılığı olarak kabul ettiği depoların adları. Kök modül ek depoları içe aktarırsa veya use_repo aracılığıyla bu depoların tümünü içe aktarmazsa Bazel uzantı değerlendirildiğinde bir uyarı ve düzeltme komutu yazdırır.
|
root_module_direct_dev_deps
|
sequence of strings; or string; or None ;
varsayılan = YokUzantının, kök modülün doğrudan geliştirici bağımlıları olarak kabul ettiği depoların adları. Kök modül ek depoları içe aktarırsa veya use_extension(..., dev_dependency = True) ile oluşturulan uzantı proxy'sinde use_repo aracılığıyla bu depoların tümünü içe aktarmazsa Bazel uzantı değerlendirildiğinde bir uyarı ve düzeltme komutu yazdırır.
|
dosya
None module_ctx.file(path, content='', executable=True, legacy_utf8=True)
Parametreler
Parametre | Açıklama |
---|---|
path
|
string; or Label; or path ;
gereklidepo dizininize göre belirlenecek dosyanın yolu. |
content
|
varsayılan = '' dosyanın içeriği varsayılan olarak boştur. |
executable
|
varsayılan = Doğru oluşturulan dosyada yürütülebilir işareti varsayılan olarak true olarak ayarlayın. |
legacy_utf8
|
varsayılan = Doğru dosya içeriğini varsayılan olarak true (doğru) olarak UTF-8 olarak kodlayın. Gelecekteki sürümlerde varsayılan ayar değiştirilecek ve bu parametre kaldırılacaktır. |
is_dev_dependency
bool module_ctx.is_dev_dependency(tag)
devDependency = True
ile bir use_extension çağrısının sonucunda belirtilip belirtilmeyeceğini döndürür.
Parametreler
Parametre | Açıklama |
---|---|
tag
|
bazel_module_tag ;
gereklibazel_module.tags adresinden alınan bir etiket. |
is_isolated
bool module_ctx.is_isolated
isolate = True
belirtip belirtmediği ve dolayısıyla diğer tüm kullanımlardan izole edilip edilmediği.
modüllerin
list module_ctx.modules
işletim sistemi
repository_os module_ctx.os
yol
path module_ctx.path(path)
Parametreler
Parametre | Açıklama |
---|---|
path
|
string; or Label; or path ;
gerekliiçinden yol oluşturacağınız dize, etiket veya yol |
okuma
string module_ctx.read(path)
Parametreler
Parametre | Açıklama |
---|---|
path
|
string; or Label; or path ;
gereklidosyanın yolunu ekler. |
report_progress
None module_ctx.report_progress(status='')
Parametreler
Parametre | Açıklama |
---|---|
status
|
string ;
varsayılan = ''getirme işleminin mevcut durumunu açıklayan dize |
root_module_has_non_dev_dependency
bool module_ctx.root_module_has_non_dev_dependency
hangi
path module_ctx.which(program)
Parametreler
Parametre | Açıklama |
---|---|
program
|
zorunlu programda bulabilirsiniz. |
None
sonucunu döndürebilir.