Bu, yapılandırma geçişleri ve bir kuralın ne tür bir derleme ayarı olduğunu (varsa) açıklayan derleme ayarı tanımlayıcıları oluşturmaya yönelik üst düzey bir modüldür.
Ör. aşağıdaki kural, rule()
işlevinin build_setting
parametresi ayarlanarak derleme ayarı olarak işaretlenmiştir. Daha açık belirtmek gerekirse, int
türündeki bir derleme ayarı ve flag
'dır. Bu, derleme ayarının komut satırında çağrılabilir olduğu anlamına gelir.
my_rule = rule( implementation = _impl, build_setting = config.int(flag = True), ... )
Üyeler
bool
BuildSetting config.bool(flag=False)Boole türündeki bir derleme ayarı
Parametreler
Parametre | Açıklama |
---|---|
flag
|
bool;
varsayılan değer False Bu derleme ayarının komut satırında çağrılıp çağrılamayacağını belirtir. |
exec
ExecTransitionFactory config.exec(exec_group=None)Bir yürütme geçişi oluşturur.
Parametreler
Parametre | Açıklama |
---|---|
exec_group
|
dize; veya None ;
varsayılan değer None Bu geçişin yürütme platformunu kullanacağı yürütme grubunun adı. Sağlanmazsa bu yürütme geçişi, hedefin varsayılan yürütme platformunu kullanır. |
int
BuildSetting config.int(flag=False)Tam sayı türündeki bir derleme ayarı
Parametreler
Parametre | Açıklama |
---|---|
flag
|
bool;
varsayılan değer False Bu derleme ayarının komut satırında çağrılıp çağrılamayacağını belirtir. |
yok
transition config.none()Tüm yapılandırmaları kaldıran ve tüm işaretleri devre dışı bırakan bir geçiş oluşturur. Yalnızca veri içeren ve derlenmesi gereken kod içermeyen ancak yalnızca bir kez analiz edilmesi gereken bağımlılıklar için tasarlanmıştır.
dize
BuildSetting config.string(flag=False, allow_multiple=False)Dize türündeki bir derleme ayarı
Parametreler
Parametre | Açıklama |
---|---|
flag
|
bool;
varsayılan değer False Bu derleme ayarının komut satırında çağrılıp çağrılamayacağını belirtir. |
allow_multiple
|
bool;
varsayılan değer False Desteği sonlandırıldı. Bunun yerine repeatable = True ile string_list ayarını kullanın. Ayarlanırsa bu işaretin komut satırında birden çok kez ayarlanmasına izin verilir. Geçişler ve derleme ayarı uygulama işlevinde erişilen işaretin değeri bir dize listesi olacaktır. Hem kampanya siparişi hem de yinelenen değerler korunur. Farklı bir davranış istenirse bu liste, derleme ayarı uygulama işlevinde son işleme tabi tutulabilir.
|
string_list
BuildSetting config.string_list(flag=False, repeatable=False)Dize listesi türündeki bir derleme ayarı. Komut satırında,
--//my/setting=foo,bar
gibi virgülle ayrılmış bir değer kullanarak bir liste iletin.
Parametreler
Parametre | Açıklama |
---|---|
flag
|
bool;
varsayılan değer False Bu derleme ayarının komut satırında çağrılıp çağrılamayacağını belirtir. |
repeatable
|
bool;
varsayılan değer False Ayarlanırsa virgülle ayrılmış bir değer beklenmez. Bunun yerine, bu işaretin komut satırında birden çok kez ayarlanmasına izin verilir. Her bir değer, liste değerine eklenecek tek bir dize olarak değerlendirilir. Hem kampanya siparişi hem de yinelenen değerler korunur. Farklı bir davranış istenirse bu liste, derleme ayarı uygulama işlevinde son işleme tabi tutulabilir. |
hedef
transition config.target()Hedef geçiş oluşturur. Bu, geçiş nesnesi gerektiği ancak aslında hiçbir şeyin değiştirilmemesi gerektiği durumlar için tasarlanmış, işlemsiz bir geçiştir.
attr.label()
'daki cfg = "target"
etiketine eş değer.