.
Özelliklerle ilgili yardımcı işlevleri ve bilgileri içeren depo kuralının bağlamı. Bir depo kuralı oluşturduğunuzda, implementation
işlevinin bağımsız değişkeni olarak bir repository_ctx nesnesi alırsınız.
Üyeler
- attr
- sil
- indirin
- download_and_extract
- yürütme
- çıkar
- dosya
- name
- işletim sistemi
- yama
- path
- oku
- report_progress
- sembolik bağlantı
- şablonu
- hangi
- workspace_root
attr
struct repository_ctx.attr
delete
bool repository_ctx.delete(path)
Parametreler
Parametre | Açıklama |
---|---|
path
|
string; veya path (yol)
gerekli Silinecek dosyanın yolu (depo dizinine göre) veya mutlaktır. Bir yol veya dize olabilir. |
indirme
struct repository_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; veya dizeler yinelenebilir;
gerekli Aynı dosyaya referansta bulunan yansıtma URL'lerinin listesi. |
output
|
string; veya Etiket; veya yol;
varsayılan ayar '' yolunu işaret eder. |
sha256
|
varsayılan değer '' İ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 değer False oluşturulan dosyada yürütülebilir bayrağı varsayılan olarak false (yanlış) değerine ayarlayın. |
allow_fail
|
varsayılan değer False 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 değer '' Ayarlanırsa önbellek isabetlerini, dosyanın önbelleğe aynı standart kimlikle eklendiği durumlarla sınırlandırın |
auth
|
varsayılan değer {} Bazı URL'lerin kimlik doğrulama bilgilerini belirten isteğe bağlı bir metin. |
integrity
|
varsayılan değer '' İ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 repository_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; veya dizeler yinelenebilir;
gerekli Aynı dosyaya referansta bulunan yansıtma URL'lerinin listesi. |
output
|
string; veya Etiket; veya yol;
varsayılan ayar '' arşivin paketten çıkarılacağı dizine giden yol. |
sha256
|
varsayılan değer '' İ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 değer '' 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, açık bir şekilde "zip", "jar", "war", "aar", "tar", "tar.gz", "tgz", "tar.xz", "txz", ".tar.zst", ".tzst", "tar.bz2", ".tbz", ".deb" veya ".debz" değerlerini belirtebilirsiniz. burayı tıklayın. |
stripPrefix
|
varsayılan değer '' 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 değer False 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 değer '' Ayarlanırsa önbellek isabetlerini, dosyanın önbelleğe aynı standart kimlikle eklendiği durumlarla sınırlandırın |
auth
|
varsayılan değer {} Bazı URL'lerin kimlik doğrulama bilgilerini belirten isteğe bağlı bir metin. |
integrity
|
varsayılan değer '' İ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
|
varsayılan değer {} 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 repository_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 değer 600 komutun saniye cinsinden maksimum süresi (varsayılan değer 600 saniyedir). |
environment
|
varsayılan değer {} işleme tabi tutulması için bazı ortam değişkenlerinin ayarlanmasını zorunlu kılar. |
quiet
|
varsayılan değer True stdout ve stderr'in terminale yazdırılması gerekiyorsa. |
working_directory
|
varsayılan değer "" Komut yürütme için çalışma dizini. Depo kökü veya mutlak ile göreli olabilir. |
ayıklama
None
repository_ctx.extract(archive, output='', stripPrefix='', *, rename_files={})
Parametreler
Parametre | Açıklama |
---|---|
archive
|
string; veya Etiket; veya yol;
gerekli yolu. |
output
|
string; veya Etiket; veya yol;
varsayılan ayar '' arşivin paketten çıkarılacağı dizine giden yol. |
stripPrefix
|
varsayılan değer '' 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.
|
rename_files
|
varsayılan değer {} 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. |
dosya
None
repository_ctx.file(path, content='', executable=True, legacy_utf8=True)
Parametreler
Parametre | Açıklama |
---|---|
path
|
string; veya Etiket; veya yol;
gerekli depo dizininize göre belirlenecek dosyanın yolu. |
content
|
varsayılan değer '' dosyanın içeriği varsayılan olarak boştur. |
executable
|
varsayılan değer True oluşturulan dosyada yürütülebilir işareti varsayılan olarak true olarak ayarlayın. |
legacy_utf8
|
varsayılan değer True 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. |
ad
string repository_ctx.name
işletim sistemi
repository_os repository_ctx.os
patch
None
repository_ctx.patch(patch_file, strip=0)
Parametreler
Parametre | Açıklama |
---|---|
patch_file
|
string; veya Etiket; veya yol;
gerekli Uygulanacak yama dosyası; etiket, göreli yol veya mutlak yol olabilir. Göreli bir yolsa, kod deposu dizinine çözümlenir. |
strip
|
varsayılan değer 0 belirtilen sayıda önde gelen bileşeni dosya adlarından ayırır. |
yol
path repository_ctx.path(path)
Parametreler
Parametre | Açıklama |
---|---|
path
|
string; veya Etiket; veya yol;
gerekli içinden yol oluşturacağınız dize, etiket veya yol |
okuma
string repository_ctx.read(path)
Parametreler
Parametre | Açıklama |
---|---|
path
|
string; veya Etiket; veya yol;
gerekli dosyanın yolunu ekler. |
report_progress
None
repository_ctx.report_progress(status='')
Parametreler
Parametre | Açıklama |
---|---|
status
|
string;
varsayılan değer: '' getirme işleminin mevcut durumunu açıklayan dize |
sembolik bağlantı
None
repository_ctx.symlink(target, link_name)
Parametreler
Parametre | Açıklama |
---|---|
target
|
string; veya Etiket; veya yol;
gerekli Sembolik bağlantının işaret etmesi gereken yol. |
link_name
|
string; veya Etiket; veya yol;
gerekli Oluşturulacak sembolik bağlantının yolu (kod deposu dizinine göre). |
şablon
None
repository_ctx.template(path, template, substitutions={}, executable=True)
template
kullanarak yeni bir dosya oluşturur. substitutions
anahtarının template
politikasında her geçtiği yer, ilgili değerle değiştirilecek. Sonuç path
dilinde yazılır. Yürütülebilir biti açmak veya kapatmak için isteğe bağlı executable
bağımsız değişkeni (varsayılan olarak true değerine ayarlanır) ayarlanabilir.
Parametreler
Parametre | Açıklama |
---|---|
path
|
string; veya Etiket; veya yol;
gerekli depo dizininize göre belirlenecek dosyanın yolu. |
template
|
string; veya Etiket; veya yol;
gerekli şablon dosyasının yoludur. |
substitutions
|
varsayılan değer {} temel öğeleri içerir. |
executable
|
varsayılan değer True oluşturulan dosyada yürütülebilir işareti varsayılan olarak true olarak ayarlayın. |
hangi
path repository_ctx.which(program)
Parametreler
Parametre | Açıklama |
---|---|
program
|
zorunlu programda bulabilirsiniz. |
None
sonucunu döndürebilir.
workspace_root
path repository_ctx.workspace_root