תצורה

זהו מודול ברמה העליונה ליצירת מעברי תצורה והסברים להגדרת גרסאות, שמתארים את סוג ההגדרה (אם יש) כלל.

לדוגמה: הכלל הבא מסומן כהגדרת build על ידי הגדרת הפרמטר build_setting של הפונקציה rule(). באופן ספציפי, זו הגדרת build מסוג int, והיא flag שמשמעותה ניתן לקבוע את הגדרת ה-build באמצעות שורת הפקודה.

  my_rule = rule(
    implementation = _impl,
    build_setting = config.int(flag = True),
    ...
  )

חברי מועדון

• בוליאני
• exec
• int
• מחרוזת
• string_list

בוליאני

BuildSetting config.bool(flag=False)

הגדרת build בוליאנית

פרמטרים

פרמטר	תיאור
flag	ברירת מחדל = False מציין אם ניתן ליצור את הגדרת ה-build הזו בשורת הפקודה.

exe

ExecTransitionFactory config.exec(exec_group=None)

יצירת מעבר לביצוע.

פרמטרים

פרמטר	תיאור
exec_group	string; or None; ברירת מחדל = ללא השם של קבוצת ה-exeC שפלטפורמת הביצוע שלה תשתמש בה. אם לא תצוין, העברת ה-exec הזו תשתמש בפלטפורמת ברירת המחדל של יעד הביצוע.

int

BuildSetting config.int(flag=False)

הגדרת build של מספר שלם.

פרמטרים

פרמטר	תיאור
flag	ברירת מחדל = False מציין אם ניתן ליצור את הגדרת ה-build הזו בשורת הפקודה.

string

BuildSetting config.string(flag=False, allow_multiple=False)

הגדרת build של סוג מחרוזת

פרמטרים

פרמטר	תיאור
flag	ברירת מחדל = False מציין אם ניתן ליצור את הגדרת ה-build הזו בשורת הפקודה.
allow_multiple	ברירת מחדל = False הוצא משימוש, יש להשתמש בהגדרה string_list עם repeatable = True. אם היא מוגדרת, אפשר להגדיר את הסימון הזה כמה פעמים בשורת הפקודה. הערך של הדגל, שאליו ניתן לגשת במעברים ובפונקציית ההטמעה של הגדרת build, הוא רשימה של מחרוזות. סדר ההכנסה והערכים החוזרים נשמרים יחד. אפשר לעבד את הרשימה הזו לאחר העיבוד של פונקציית ההטמעה של הגדרת ה-build אם רוצים התנהגות אחרת.

string_list

BuildSetting config.string_list(flag=False, repeatable=False)

הגדרת build של סוג מחרוזת. בשורת הפקודה להעביר רשימה באמצעות ערך מופרד באמצעות פסיק כמו '--//my/setting=foo,bar'.

פרמטרים

פרמטר	תיאור
flag	ברירת מחדל = False מציין אם ניתן ליצור את הגדרת ה-build הזו בשורת הפקודה.
repeatable	ברירת מחדל = False אם היא מוגדרת, במקום לצפות לערך מופרד בפסיקים, ניתן להגדיר את הסימון הזה מספר פעמים בשורת הפקודה כאשר כל ערך בנפרד מטופל כמחרוזת יחידה כדי להוסיף לערך הרשימה. סדר ההכנסה והערכים החוזרים נשמרים יחד. אפשר לעבד את הרשימה הזו לאחר העיבוד של פונקציית ההטמעה של הגדרת ה-build אם רוצים התנהגות אחרת.