Baklavalar

Genellikle bir işlem, geçişli bağımlılıklardan toplanan değerleri içeren büyük bir komut satırı gerektirir. Örneğin, bir bağlayıcı komut satırı, bağlanmakta olan tüm kitaplıkların ihtiyaç duyduğu her nesne dosyasını listeleyebilir. Bu tür geçişli verileri birden fazla hedefle paylaşabilmek için depset'lerde depolamanız önerilir. Ancak kuralı yazan kişi, bir işlem komut satırı oluşturmak için bu bağımlılık kümelerini dize listelerine dönüştürmek zorunda kalırsa bu bellek paylaşımı optimizasyonu bozulur.

Bu nedenle, işlem oluşturma işlevleri dizelerin yanı sıra Args nesnelerini de kabul eder. Her Args nesnesi, dizelerin ve bağımlılık kümelerinin birleştirilmesini temsil eder. Verileri işlemek için isteğe bağlı dönüşümler kullanılabilir. Args nesneleri, komut satırını hesaplama zamanı geldiğinde yürütme aşamasına kadar kapsadıkları bağımlılık kümelerini işlemez. Bu sayede, analiz aşaması tamamlanana kadar maliyetli kopyalama işlemleri ertelenir. Daha fazla bilgi için Performansı Optimize Etme sayfasına bakın.

Args, ctx.actions.args() aranarak oluşturulur. Bunlar, ctx.actions.run() veya ctx.actions.run_shell() parametresi olarak iletilebilir.arguments Args nesnesinin her mutasyonu, değerleri nihai komut satırına ekler.

map_each özelliği, öğelerin dizelere nasıl dönüştürüleceğini özelleştirmenize olanak tanır. map_each işlevi sağlamazsanız standart dönüşüm şu şekilde olur:

• Zaten dize olan değerler olduğu gibi bırakılır.
• File nesneleri, File.path değerlerine dönüştürülür.
• Label nesneleri, ana depo bağlamında çözümlendiğinde aynı nesneye geri dönen bir dize gösterimine dönüştürülür. Mümkünse dize gösterimi, BUILD dosyalarında kullanıma uygun hale getirmek için, deponun kanonik adı yerine deponun görünen adını kullanır. Temsilin tam şekli garanti edilmese de tipik örnekler //foo:bar, @repo//foo:bar ve @@canonical_name+//foo:bar.bzl'dir.
• Diğer tüm türler belirtilmemiş şekilde dizelere dönüştürülür. Bu nedenle, add() işlevine dize veya File türünde olmayan değerler aktarmaktan kaçınmalısınız. Bu değerleri add_all() veya add_joined() işlevlerine aktarırsanız map_each işlevi sağlamanız gerekir.

Dize biçimlendirmesi (format, format_each ve format_joined parametreleri add*() yöntemleri) kullanılırken biçim şablonu, dizelerde % yerine koyma işlemiyle aynı şekilde yorumlanır. Ancak şablonda tam olarak bir yerine koyma yer tutucusu olmalı ve bu yer tutucu %s olmalıdır. Değişmez yüzdeler %% olarak çıkış yapılabilir. Biçimlendirme, değer yukarıdaki gibi bir dizeye dönüştürüldükten sonra uygulanır.

add*() yöntemlerinin her birinin, ek bir konumsal parametre kabul eden alternatif bir biçimi vardır. Bu biçimde, bağımsız değişkenlerin geri kalanından önce eklenecek bir "arg name" dizesi bulunur. add_all ve add_joined için dizi boş çıkarsa ek dize eklenmez. Örneğin, aynı kullanım, verilen dizinin val1..val3 içerip içermemesine veya boş olup olmamasına bağlı olarak komut satırına --foo val1 val2 val3 --bar ya da yalnızca --bar ekleyebilir.

Komut satırının boyutu, sistemin izin verdiği maksimum boyuttan daha uzun olabilirse bağımsız değişkenler parametre dosyalarına taşabilir. use_param_file() ve set_param_file_format() hükümlerini inceleyin.

Örnek: Şu komut satırını oluşturmak istediğimizi varsayalım:

--foo foo1.txt foo2.txt ... fooN.txt --bar bar1.txt,bar2.txt,...,barM.txt --baz

# foo_deps and bar_deps are depsets containing
# File objects for the foo and bar .txt files.
args = ctx.actions.args()
args.add_all("--foo", foo_deps)
args.add_joined("--bar", bar_deps, join_with=",")
args.add("--baz")
ctx.actions.run(
  ...
  arguments = [args],
  ...
)

Üyeler

• ekle
• add_all
• add_joined
• set_param_file_format
• use_param_file

add

Args Args.add(arg_name_or_value, value=unbound, *, format=None)

Parametreler

add_all

Args Args.add_all(arg_name_or_values, values=unbound, *, map_each=None, format_each=None, before_each=None, omit_if_empty=True, uniquify=False, expand_directories=True, terminate_with=None, allow_closure=False)

İşlemin çoğu, aşağıdaki adımlarda belirtildiği gibi eklenecek bir bağımsız değişkenler listesi üzerinden gerçekleşir:

1. Her dizin File öğesi, o dizinde yinelemeli olarak bulunan tüm File'lerle değiştirilir.
2. map_each verilirse her öğeye uygulanır ve ortaya çıkan dizeler listeleri, ilk bağımsız değişken listesini oluşturmak için birleştirilir. Aksi takdirde, ilk bağımsız değişken listesi her öğeye standart dönüştürme uygulanarak elde edilen sonuçtur.
3. Listede varsa her bağımsız değişken format_each ile biçimlendirilir.
4. uniquify doğruysa yinelenen bağımsız değişkenler kaldırılır. İlk oluşum kalır.
5. Bir before_each dizesi verilirse listedeki her mevcut bağımsız değişkenden önce yeni bir bağımsız değişken olarak eklenir. Bu, bu noktaya kadar eklenecek bağımsız değişkenlerin sayısını ikiye katlar.
6. Liste boş olmadığı ve omit_if_empty doğru (varsayılan) olmadığı sürece, arg adı ve terminate_with, sırasıyla ilk ve son bağımsız değişken olarak eklenir.

Parametreler

add_joined

Args Args.add_joined(arg_name_or_values, values=unbound, *, join_with, map_each=None, format_each=None, format_joined=None, omit_if_empty=True, uniquify=False, expand_directories=True, allow_closure=False)

İşleme, add_all() işlevine benzer ancak values işlevinden türetilen bağımsız değişkenler listesi, join_with.join(...) işleviyle birleştirilmiş gibi tek bir bağımsız değişkende birleştirilir ve ardından verilen format_joined dize şablonu kullanılarak biçimlendirilir. add_all()'dan farklı olarak, öğeler tek bir bağımsız değişkende birleştirildiğinde genellikle yararlı olmadıkları için before_each veya terminate_with parametresi yoktur.

Filtrelemeden sonra bir bağımsız değişkene birleştirilecek dize yoksa ve omit_if_empty doğruysa (varsayılan) herhangi bir işlem yapılmaz. Aksi takdirde, birleştirilecek dize yoksa ancak omit_if_empty yanlışsa birleştirilen dize boş bir dize olur.

Parametreler

set_param_file_format

Args Args.set_param_file_format(format)

Parametreler

use_param_file

Args Args.use_param_file(param_file_arg, *, use_always=False)

Bazel, verimlilik için yürütme sırasında parametreler dosyasını çıkış ağacına yazmayı atlamayı seçebilir. İşlemlerde hata ayıklıyorsanız ve param dosyasını incelemek istiyorsanız derlemenize --materialize_param_files iletin.

Parametreler