config

Sorun bildir Kaynağı göster Nightly · 8.0 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

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şaretlenir. Daha açık belirtmek gerekirse, int türündeki bir derleme ayarı ve flag değerine sahip bir ayardır. Bu, derleme ayarının komut satırından ç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 ayar 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.